WireMock.Net.xUnit
1.6.8
Prefix Reserved
dotnet add package WireMock.Net.xUnit --version 1.6.8
NuGet\Install-Package WireMock.Net.xUnit -Version 1.6.8
<PackageReference Include="WireMock.Net.xUnit" Version="1.6.8" />
paket add WireMock.Net.xUnit --version 1.6.8
#r "nuget: WireMock.Net.xUnit, 1.6.8"
// Install WireMock.Net.xUnit as a Cake Addin #addin nuget:?package=WireMock.Net.xUnit&version=1.6.8 // Install WireMock.Net.xUnit as a Cake Tool #tool nuget:?package=WireMock.Net.xUnit&version=1.6.8
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 Wiki : Stubbing.
⭐ Request Matching
WireMock.Net support advanced request-matching logic, see Wiki : Request Matching.
⭐ Response Templating
The response which is returned WireMock.Net can be changed using templating. This is described here Wiki : Response Templating.
⭐ Admin API Reference
The WireMock admin API provides functionality to define the mappings via a http interface see Wiki : 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 Wiki : UnitTesting.
Unit/Integration Testing using Testcontainers.DotNet
See Wiki : 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 Wiki : 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 Wiki : dotnet tool.
As standalone process / console application
This is quite straight forward to launch a mock server within a console application, see Wiki : Standalone Process.
As a Windows Service
You can also run WireMock.Net as a Windows Service, follow this WireMock-as-a-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 Wiki : HTTPS
📚 Documentation
For more info, see also this WIKI 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. |
| .NET Core | netcoreapp1.0 was computed. netcoreapp1.1 was computed. netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard1.3 is compatible. netstandard1.4 was computed. netstandard1.5 was computed. netstandard1.6 was computed. netstandard2.0 is compatible. netstandard2.1 is compatible. |
| .NET Framework | net45 is compatible. net451 is compatible. net452 was computed. net46 was computed. 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 | tizen30 was computed. tizen40 was computed. tizen60 was computed. |
| Universal Windows Platform | uap was computed. uap10.0 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.5
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
- WireMock.Net.Abstractions (>= 1.6.8)
- xUnit.abstractions (>= 2.0.3)
-
.NETFramework 4.5.1
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
- WireMock.Net.Abstractions (>= 1.6.8)
- xUnit.abstractions (>= 2.0.3)
-
.NETStandard 1.3
- NETStandard.Library (>= 1.6.1)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
- WireMock.Net.Abstractions (>= 1.6.8)
- xUnit.abstractions (>= 2.0.3)
-
.NETStandard 2.0
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
- WireMock.Net.Abstractions (>= 1.6.8)
- xUnit.abstractions (>= 2.0.3)
-
.NETStandard 2.1
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
- WireMock.Net.Abstractions (>= 1.6.8)
- xUnit.abstractions (>= 2.0.3)
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.6.8 | 287 | 11/24/2024 |
| 1.6.7 | 1,608 | 10/17/2024 |
| 1.6.7-preview-02 | 83 | 10/6/2024 |
| 1.6.7-preview-01 | 87 | 10/2/2024 |
| 1.6.6 | 4,511 | 10/1/2024 |
| 1.6.5 | 317 | 9/28/2024 |
| 1.6.4 | 1,551 | 9/25/2024 |
| 1.6.3 | 2,658 | 9/7/2024 |
| 1.6.2 | 7,530 | 9/4/2024 |
| 1.6.1 | 7,211 | 8/22/2024 |
| 1.6.0 | 1,392 | 8/16/2024 |
| 1.5.62 | 4,742 | 7/27/2024 |
| 1.5.61 | 85 | 7/27/2024 |
| 1.5.60 | 18,078 | 7/9/2024 |
| 1.5.59 | 2,769 | 6/26/2024 |
| 1.5.58 | 3,581 | 6/8/2024 |
| 1.5.57 | 186 | 6/4/2024 |
| 1.5.56 | 313 | 6/3/2024 |
| 1.5.55 | 2,623 | 5/22/2024 |
| 1.5.54 | 205 | 5/18/2024 |
| 1.5.53 | 11,112 | 5/8/2024 |
| 1.5.52 | 6,243 | 4/6/2024 |
| 1.5.51 | 8,159 | 3/20/2024 |
| 1.5.50 | 125 | 3/20/2024 |
| 1.5.49 | 3,178 | 3/6/2024 |
| 1.5.48 | 1,418 | 2/17/2024 |
| 1.5.47 | 998 | 1/25/2024 |
| 1.5.46 | 8,389 | 12/23/2023 |
| 1.5.45 | 275 | 12/21/2023 |
| 1.5.44 | 580 | 12/14/2023 |
| 1.5.43 | 211 | 12/11/2023 |
| 1.5.42 | 166 | 12/9/2023 |
| 1.5.41 | 307 | 12/4/2023 |
| 1.5.40 | 1,099 | 11/7/2023 |
| 1.5.39 | 9,967 | 10/9/2023 |
| 1.5.38 | 147 | 10/9/2023 |
| 1.5.37 | 1,857 | 9/27/2023 |
| 1.5.36 | 234 | 9/21/2023 |
| 1.5.35 | 1,879 | 8/19/2023 |
| 1.5.34 | 1,419 | 8/4/2023 |
| 1.5.32 | 8,869 | 7/15/2023 |
| 1.5.31 | 5,319 | 7/8/2023 |
| 1.5.30 | 780 | 6/28/2023 |
| 1.5.29 | 841 | 6/22/2023 |
| 1.5.28 | 379 | 6/11/2023 |
| 1.5.27 | 26,274 | 6/3/2023 |
| 1.5.26 | 486 | 5/25/2023 |
| 1.5.25 | 2,099 | 5/13/2023 |
| 1.5.24 | 296 | 5/7/2023 |
| 1.5.23 | 308 | 4/23/2023 |
| 1.5.22 | 1,600 | 4/8/2023 |
| 1.5.21 | 828 | 3/22/2023 |
| 1.5.20 | 341 | 3/19/2023 |
| 1.5.19 | 298 | 3/17/2023 |
| 1.5.18 | 885 | 3/9/2023 |
| 1.5.17 | 839 | 2/25/2023 |
| 1.5.16 | 2,439 | 2/6/2023 |
| 1.5.15 | 1,158 | 1/29/2023 |
| 1.5.14 | 370 | 1/24/2023 |
| 1.5.13 | 5,709 | 12/11/2022 |
| 1.5.12 | 10,273 | 12/3/2022 |
| 1.5.11 | 412 | 11/24/2022 |
| 1.5.10 | 21,813 | 11/6/2022 |
| 1.5.9 | 656 | 10/29/2022 |
| 1.5.8 | 479 | 10/16/2022 |
| 1.5.7 | 461 | 10/11/2022 |
| 1.5.6 | 1,723 | 9/12/2022 |
| 1.5.5 | 456 | 9/3/2022 |
| 1.5.4 | 491 | 8/24/2022 |
| 1.5.3 | 3,694 | 7/29/2022 |
| 1.5.2 | 472 | 7/24/2022 |
| 1.5.1 | 511 | 7/8/2022 |
| 1.5.0 | 1,752 | 6/10/2022 |
| 1.4.43 | 856 | 5/21/2022 |
| 1.4.42-preview-01 | 175 | 5/21/2022 |
| 1.0.0 | 132 | 7/22/2024 |
# 1.6.8 (23 November 2024)
- #1202 Log exception when (static) mapping file cannot be read [feature]
- #1206 Fix security issues [bug]
- #1211 Use GraphQL 8.2.1 [feature]
- #1213 Fix HandlebarsContext ParseAndEvaluate method [bug]
- #1201 Mapping file parse errors are not logged to the console [feature]
- #1209 Upgrade of GraphQL libs to the latest [feature]
- #1212 Response Body Does Not Include Text After Path Segment [bug]
The full release notes can be found here: https://github.com/WireMock-Net/WireMock.Net/blob/master/CHANGELOG.md