WireMock.Net.Shared 1.16.0
WireMock.Net
Lightweight Http Mocking Server for .NET, inspired by WireMock.org (from the Java landscape).
:star: 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
:star: Stubbing
A core feature of WireMock.Net is the ability to return predefined HTTP responses for requests matching criteria. See Stubbing.
:star: Request Matching
WireMock.Net support advanced request-matching logic, see Request Matching.
:star: Response Templating
The response which is returned WireMock.Net can be changed using templating. This is described here Response Templating.
:star: Admin API Reference
The WireMock admin API provides functionality to define the mappings via a http interface see Admin API Reference.
:star: 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
:books: Documentation
For more info, see also this documentation page: What is WireMock.Net.
Showing the top 20 packages that depend on WireMock.Net.Shared.
| Packages | Downloads |
|---|---|
|
WireMock.Net.ProtoBuf
ProtoBuf and gRPC support for WireMock.Net
|
18 |
|
WireMock.Net.Minimal
Minimal version from the lightweight Http Mocking Server for .NET
|
16 |
|
WireMock.Net.OpenTelemetry
OpenTelemetry exporter support for WireMock.Net
|
15 |
|
WireMock.Net.Matchers.SystemTextJsonPath
A SystemTextJsonPathMatcher which can be used to match WireMock.Net Requests using JsonPath.Net.
|
15 |
|
WireMock.Net.GraphQL
GraphQL support for WireMock.Net
|
15 |
|
WireMock.Net.Minimal
Minimal version from the lightweight Http Mocking Server for .NET
|
15 |
|
WireMock.Net.Minimal
Minimal version from the lightweight Http Mocking Server for .NET
|
14 |
|
WireMock.Net.ProtoBuf
ProtoBuf and gRPC support for WireMock.Net
|
14 |
|
WireMock.Net.OpenTelemetry
OpenTelemetry exporter support for WireMock.Net
|
14 |
|
WireMock.Net.GraphQL
GraphQL support for WireMock.Net
|
14 |
1.16.0 (18 November 2025)
- #1366 WireMock.Net.OpenApiParser : support Examples [feature]
- #1375 Add WireMockHealthCheck in WireMock.Net.Aspire [feature]
- #1377 Check if the path is valid when using WithPath(...) [feature]
- #1380 Add WireMock.Net.xUnit.v3 project [feature]
- #1364 Choosing examples from open api specification for responses. [feature]
- #1376 AdminApiMappingBuilder
WithPathshould add the starting/if missing [feature] - #1379 xUnit v3 [feature]
The full release notes can be found here: https://github.com/wiremock/WireMock.Net/blob/master/CHANGELOG.md
.NET Framework 4.5.1
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
.NET Framework 4.5.2
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
.NET Framework 4.6
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
.NET Framework 4.6.1
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
.NET Standard 1.3
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- NETStandard.Library (>= 1.6.1)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Reflection.TypeExtensions (>= 4.7.0)
- System.Text.RegularExpressions (>= 4.3.1)
.NET Core 3.1
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
.NET 5.0
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
.NET 6.0
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
.NET 7.0
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
.NET 8.0
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
.NET Standard 2.0
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
.NET Standard 2.1
- WireMock.Net.Abstractions (>= 1.16.0)
- AnyOf (>= 0.4.0)
- Handlebars.Net.Helpers (>= 2.5.2)
- Handlebars.Net.Helpers.Humanizer (>= 2.5.2)
- Handlebars.Net.Helpers.Json (>= 2.5.2)
- Handlebars.Net.Helpers.Random (>= 2.5.2)
- Handlebars.Net.Helpers.XPath (>= 2.5.2)
- Handlebars.Net.Helpers.Xeger (>= 2.5.2)
- JsonConverter.Abstractions (>= 0.7.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 1.1.0)
- Newtonsoft.Json (>= 13.0.3)
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
| Version | Downloads | Last updated |
|---|---|---|
| 2.19.0 | 11 | 10/07/2026 |
| 2.18.0 | 12 | 10/01/2026 |
| 2.17.0 | 14 | 09/30/2026 |
| 2.16.0 | 12 | 10/01/2026 |
| 2.15.0 | 12 | 10/01/2026 |
| 2.14.0 | 14 | 10/01/2026 |
| 2.13.0 | 12 | 10/01/2026 |
| 2.12.0 | 12 | 10/01/2026 |
| 2.11.0 | 12 | 10/01/2026 |
| 2.10.0 | 14 | 10/01/2026 |
| 2.9.0 | 12 | 09/30/2026 |
| 2.8.0 | 9 | 10/01/2026 |
| 2.7.0 | 13 | 10/01/2026 |
| 2.6.0 | 13 | 10/01/2026 |
| 2.5.0 | 16 | 10/01/2026 |
| 2.4.0 | 10 | 10/01/2026 |
| 2.3.0 | 11 | 10/01/2026 |
| 2.2.0 | 15 | 10/01/2026 |
| 2.1.0 | 10 | 10/01/2026 |
| 2.0.0 | 12 | 10/01/2026 |
| 1.25.0 | 14 | 10/01/2026 |
| 1.24.0 | 11 | 10/01/2026 |
| 1.23.0 | 13 | 10/01/2026 |
| 1.22.0 | 9 | 10/01/2026 |
| 1.21.0 | 12 | 10/01/2026 |
| 1.20.0 | 12 | 10/01/2026 |
| 1.19.0 | 12 | 10/02/2026 |
| 1.18.0 | 13 | 10/01/2026 |
| 1.17.0 | 12 | 10/01/2026 |
| 1.16.0 | 10 | 10/01/2026 |
| 1.15.0 | 12 | 10/01/2026 |
| 1.14.0 | 9 | 10/02/2026 |
| 1.14.0-preview-01 | 14 | 10/02/2026 |
| 1.13.0 | 15 | 09/30/2026 |
| 1.12.0 | 12 | 10/01/2026 |
| 1.11.2 | 14 | 10/01/2026 |
| 1.11.1 | 12 | 10/01/2026 |
| 1.11.0 | 11 | 10/01/2026 |
| 1.10.1 | 13 | 10/01/2026 |
| 1.10.0 | 10 | 10/01/2026 |
| 1.9.1 | 13 | 10/01/2026 |
| 1.9.0 | 9 | 10/02/2026 |
| 1.8.18 | 12 | 10/01/2026 |
| 1.8.17 | 13 | 10/01/2026 |
| 1.8.16 | 10 | 10/01/2026 |
| 1.8.15 | 15 | 09/30/2026 |
| 1.8.14 | 12 | 10/01/2026 |
| 1.8.13 | 11 | 10/01/2026 |
| 1.8.13-preview-02 | 11 | 10/02/2026 |
| 1.8.13-preview-01 | 12 | 10/02/2026 |
| 1.8.12 | 12 | 10/01/2026 |
| 1.8.11 | 11 | 10/01/2026 |
| 1.8.10 | 13 | 10/01/2026 |
| 1.8.9 | 11 | 10/01/2026 |
| 1.8.8 | 17 | 10/01/2026 |
| 1.8.7 | 13 | 10/01/2026 |