WireMock.Net.Testcontainers
1.23.0
Prefix Reserved
dotnet add package WireMock.Net.Testcontainers --version 1.23.0
NuGet\Install-Package WireMock.Net.Testcontainers -Version 1.23.0
<PackageReference Include="WireMock.Net.Testcontainers" Version="1.23.0" />
<PackageVersion Include="WireMock.Net.Testcontainers" Version="1.23.0" />
<PackageReference Include="WireMock.Net.Testcontainers" />
paket add WireMock.Net.Testcontainers --version 1.23.0
#r "nuget: WireMock.Net.Testcontainers, 1.23.0"
#:package WireMock.Net.Testcontainers@1.23.0
#addin nuget:?package=WireMock.Net.Testcontainers&version=1.23.0
#tool nuget:?package=WireMock.Net.Testcontainers&version=1.23.0
WireMock.Net
Lightweight Http Mocking Server for .NET, inspired by WireMock.org (from the Java landscape).
⭐ Key Features
- HTTP response stubbing, matchable on URL/Path, headers, cookies and body content patterns
- Library can be used in unit tests and integration tests
- Runs as a standalone process, as windows service, as Azure/IIS or as docker
- Configurable via a fluent C# .NET API, JSON files and JSON over HTTP
- Record/playback of stubs (proxying)
- Per-request conditional proxying
- Stateful behaviour simulation
- Response templating / transformation using Handlebars and extensions
- Can be used locally or in CI/CD scenarios
- Can be used for Aspire Distributed Application testing
⭐ Stubbing
A core feature of WireMock.Net is the ability to return predefined HTTP responses for requests matching criteria. See Stubbing.
⭐ Request Matching
WireMock.Net support advanced request-matching logic, see Request Matching.
⭐ Response Templating
The response which is returned WireMock.Net can be changed using templating. This is described here Response Templating.
⭐ Admin API Reference
The WireMock admin API provides functionality to define the mappings via a http interface see Admin API Reference.
⭐ Using
WireMock.Net can be used in several ways:
UnitTesting
You can use your favorite test framework and use WireMock within your tests, see UnitTesting.
Unit/Integration Testing using Testcontainers.DotNet
See WireMock.Net.Testcontainers on how to build a WireMock.Net Docker container which can be used in Unit/Integration testing.
Unit/Integration Testing using an an Aspire Distributed Application
See WireMock.Net.Aspire on how to use WireMock.Net as an Aspire Hosted application to do Unit/Integration testing.
As a dotnet tool
It's simple to install WireMock.Net as (global) dotnet tool, see dotnet tool.
As standalone process / console application
This is quite straight forward to launch a mock server within a console application, see Standalone Process.
As a Windows Service
You can also run WireMock.Net as a Windows Service, follow this Windows Service.
As a Web Job in Azure or application in IIS
See this link WireMock-as-a-(Azure)-Web-App
In a docker container
There is also a Linux and Windows-Nano container available at hub.docker.com. For more details see also Docker.
HTTPS / SSL
More details on using HTTPS (SSL) can be found here HTTPS
📚 Documentation
For more info, see also this documentation page: What is WireMock.Net.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
- Testcontainers (>= 4.10.0)
- WireMock.Net.RestClient (>= 1.23.0)
-
.NETStandard 2.1
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
- Testcontainers (>= 4.10.0)
- WireMock.Net.RestClient (>= 1.23.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.23.0 | 693 | 1/5/2026 |
| 1.22.0 | 559 | 1/2/2026 |
| 1.21.0 | 1,357 | 12/25/2025 |
| 1.20.0 | 430 | 12/24/2025 |
| 1.19.0 | 5,647 | 12/12/2025 |
| 1.18.0 | 2,481 | 12/9/2025 |
| 1.17.0 | 2,408 | 12/7/2025 |
| 1.16.0 | 7,826 | 11/18/2025 |
| 1.15.0 | 29,693 | 10/22/2025 |
| 1.14.0 | 13,502 | 10/6/2025 |
| 1.14.0-preview-01 | 160 | 10/3/2025 |
| 1.13.0 | 5,468 | 9/28/2025 |
| 1.12.0 | 37,522 | 8/30/2025 |
| 1.11.2 | 1,310 | 8/27/2025 |
| 1.11.1 | 445 | 8/27/2025 |
| 1.11.0 | 4,315 | 8/26/2025 |
| 1.10.1 | 1,156 | 8/22/2025 |
| 1.10.0 | 5,553 | 8/18/2025 |
| 1.9.1 | 644 | 8/17/2025 |
| 1.9.0 | 8,212 | 8/10/2025 |
| 1.8.18 | 2,488 | 8/4/2025 |
| 1.8.17 | 17,085 | 7/23/2025 |
| 1.8.16 | 3,595 | 7/19/2025 |
| 1.8.15 | 608 | 7/18/2025 |
| 1.8.14 | 3,315 | 7/13/2025 |
| 1.8.13 | 60,451 | 6/23/2025 |
| 1.8.13-preview-02 | 172 | 6/21/2025 |
| 1.8.13-preview-01 | 195 | 6/20/2025 |
| 1.8.12 | 13,790 | 6/15/2025 |
| 1.8.11 | 4,655 | 6/11/2025 |
| 1.8.10 | 4,792 | 6/10/2025 |
| 1.8.9 | 19,811 | 5/28/2025 |
| 1.8.8 | 1,552 | 5/24/2025 |
| 1.8.7 | 651 | 5/22/2025 |
| 1.8.6 | 7,783 | 5/15/2025 |
| 1.8.5 | 3,341 | 5/14/2025 |
| 1.8.4 | 2,832 | 5/8/2025 |
| 1.8.3 | 5,541 | 5/6/2025 |
| 1.8.2 | 5,294 | 5/5/2025 |
| 1.8.1 | 574 | 5/2/2025 |
| 1.8.0 | 3,655 | 4/29/2025 |
| 1.8.0-prview-01 | 616 | 3/4/2025 |
| 1.7.5-preview-02 | 234 | 4/3/2025 |
| 1.7.5-preview-01 | 237 | 4/2/2025 |
| 1.7.4 | 92,202 | 2/27/2025 |
| 1.7.3 | 1,275 | 2/24/2025 |
| 1.7.2 | 21,998 | 2/12/2025 |
| 1.7.2-preview-01 | 161 | 2/7/2025 |
| 1.7.1 | 16,457 | 1/27/2025 |
| 1.7.0 | 2,472 | 1/22/2025 |
| 1.6.12 | 2,357 | 1/21/2025 |
| 1.6.11 | 10,746 | 1/2/2025 |
| 1.6.10 | 7,325 | 12/15/2024 |
| 1.6.9 | 9,397 | 12/6/2024 |
| 1.6.8 | 18,270 | 11/24/2024 |
| 1.6.7 | 57,176 | 10/17/2024 |
| 1.6.7-preview-02 | 227 | 10/6/2024 |
| 1.6.7-preview-01 | 161 | 10/2/2024 |
| 1.6.6 | 19,599 | 10/1/2024 |
| 1.6.5 | 618 | 9/28/2024 |
| 1.6.4 | 7,236 | 9/25/2024 |
| 1.6.3 | 19,823 | 9/7/2024 |
| 1.6.2 | 20,319 | 9/4/2024 |
| 1.6.1 | 3,558 | 8/22/2024 |
| 1.6.0 | 8,172 | 8/16/2024 |
| 1.5.62 | 11,697 | 7/27/2024 |
| 1.5.61 | 209 | 7/27/2024 |
| 1.5.60 | 35,509 | 7/9/2024 |
| 1.5.59 | 2,900 | 6/26/2024 |
| 1.5.58 | 5,322 | 6/8/2024 |
| 1.5.57 | 3,767 | 6/4/2024 |
| 1.5.56 | 328 | 6/3/2024 |
| 1.5.55 | 29,393 | 5/22/2024 |
| 1.5.54 | 1,612 | 5/18/2024 |
| 1.5.53 | 3,293 | 5/8/2024 |
| 1.5.52 | 29,268 | 4/6/2024 |
| 1.5.51 | 3,779 | 3/20/2024 |
| 1.5.50 | 240 | 3/20/2024 |
| 1.5.49 | 5,178 | 3/6/2024 |
| 1.5.48 | 3,378 | 2/17/2024 |
| 1.5.47 | 13,786 | 1/25/2024 |
| 1.5.46 | 17,824 | 12/23/2023 |
| 1.5.45 | 693 | 12/21/2023 |
| 1.5.44 | 835 | 12/14/2023 |
| 1.5.43 | 609 | 12/11/2023 |
| 1.5.42 | 321 | 12/9/2023 |
| 1.5.41 | 490 | 12/4/2023 |
| 1.5.40 | 7,901 | 11/7/2023 |
| 1.5.39 | 2,722 | 10/9/2023 |
| 1.5.38 | 246 | 10/9/2023 |
| 1.5.37 | 2,915 | 9/27/2023 |
| 1.5.36 | 756 | 9/21/2023 |
| 1.5.35 | 17,402 | 8/19/2023 |
| 1.5.34 | 5,517 | 8/4/2023 |
| 1.5.32 | 18,283 | 7/15/2023 |
| 1.5.31 | 393 | 7/8/2023 |
| 1.5.30 | 321 | 6/28/2023 |
| 1.5.29 | 361 | 6/22/2023 |
| 1.5.28 | 1,811 | 6/11/2023 |
| 1.0.0 | 720 | 7/22/2024 |
| 0.0.1-preview-01 | 267 | 6/7/2023 |
# 1.23.0 (05 January 2026)
- #1414 Pass the parameter matchOperator in Request.WithPath to its inner calls [bug]
- #1416 Fix: Pass AllowedHandlebarsHelpers configuration to Handlebars.Net.Helpers library
- #1413 Parameter `matchOperator` is not respected in the method Request.WithPath [bug]
- #1415 HandlebarsSettings AllowedHandlebarsHelpers Configuration Not Applied [bug]
The full release notes can be found here: https://github.com/wiremock/WireMock.Net/blob/master/CHANGELOG.md