WireMock.Net.Shared 2.5.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 |
2.5.0 (04 May 2026)
- #1451 Feature/early mismatch [feature]
- #1452 Bump log4net from 2.0.15 to 3.3.0 in example console app [dependencies, .NET]
- #1453 Fix CVE-2026-40021: upgrade log4net to 3.3.0 in examples/WireMock.Net.Service/packages.config [dependencies]
- #1442 Bug: [grpc] WithBodyAsProtoBuf exception on match [bug]
The full release notes can be found here: https://github.com/wiremock/WireMock.Net/blob/master/CHANGELOG.md
.NET 8.0
- WireMock.Net.Abstractions (>= 2.5.0)
- AnyOf (>= 0.5.0.1)
- 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)
- Handlebars.Net.Helpers.Xslt (>= 2.5.2)
- JsonConverter.Newtonsoft.Json (>= 0.9.0)
- Microsoft.AspNetCore.Http (>= 2.3.9)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Stef.Validation (>= 0.2.0)
.NET Standard 2.0
- WireMock.Net.Abstractions (>= 2.5.0)
- AnyOf (>= 0.5.0.1)
- 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)
- Handlebars.Net.Helpers.Xslt (>= 2.5.2)
- JsonConverter.Newtonsoft.Json (>= 0.9.0)
- Microsoft.AspNetCore.Http (>= 2.3.9)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Stef.Validation (>= 0.2.0)
.NET Standard 2.1
- WireMock.Net.Abstractions (>= 2.5.0)
- AnyOf (>= 0.5.0.1)
- 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)
- Handlebars.Net.Helpers.Xslt (>= 2.5.2)
- JsonConverter.Newtonsoft.Json (>= 0.9.0)
- Microsoft.AspNetCore.Http (>= 2.3.9)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Stef.Validation (>= 0.2.0)
| 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 |