dotnet-WireMock 1.8.13

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global dotnet-WireMock --version 1.8.13
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local dotnet-WireMock --version 1.8.13
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=dotnet-WireMock&version=1.8.13
                    
nuke :add-package dotnet-WireMock --version 1.8.13
                    

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 Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.8.17 6 7/23/2025
1.8.16 13 7/19/2025
1.8.15 92 7/18/2025
1.8.14 114 7/13/2025
1.8.13 220 6/23/2025
1.8.13-preview-02 96 6/21/2025
1.8.13-preview-01 116 6/20/2025
1.8.12 144 6/15/2025
1.8.11 291 6/11/2025
1.8.10 283 6/10/2025
1.8.9 184 5/28/2025
1.8.8 75 5/24/2025
1.8.7 151 5/22/2025
1.8.6 241 5/15/2025
1.8.5 233 5/14/2025
1.8.4 160 5/8/2025
1.8.3 164 5/6/2025
1.8.2 158 5/5/2025
1.8.1 157 5/2/2025
1.8.0 171 4/29/2025
1.8.0-prview-01 242 3/4/2025
1.7.5-preview-02 180 4/3/2025
1.7.5-preview-01 182 4/2/2025
1.7.4 3,599 2/27/2025
1.7.3 162 2/24/2025
1.7.2 326 2/12/2025
1.7.2-preview-01 123 2/7/2025
1.7.1 271 1/27/2025
1.7.0 150 1/22/2025
1.6.12 165 1/21/2025
1.6.11 259 1/2/2025
1.6.10 193 12/15/2024
1.6.9 317 12/6/2024
1.6.8 259 11/24/2024
1.6.7 382 10/17/2024
1.6.7-preview-02 125 10/6/2024
1.6.7-preview-01 126 10/2/2024
1.6.6 340 10/1/2024
1.6.5 168 9/28/2024
1.6.4 171 9/25/2024
1.6.3 499 9/7/2024
1.6.2 211 9/4/2024
1.6.1 575 8/22/2024
1.6.0 364 8/16/2024
1.5.62 471 7/27/2024
1.5.61 122 7/27/2024
1.5.60 421 7/9/2024
1.5.59 532 6/26/2024
1.5.58 837 6/8/2024
1.5.57 256 6/4/2024
1.5.56 196 6/3/2024
1.5.55 454 5/22/2024
1.5.54 283 5/18/2024
1.5.53 450 5/8/2024
1.5.52 919 4/6/2024
1.5.51 744 3/20/2024
1.5.50 235 3/20/2024
1.5.49 553 3/6/2024
1.5.48 679 2/17/2024
1.5.47 517 1/25/2024
1.5.46 3,625 12/23/2023
1.5.45 195 12/21/2023
1.5.44 230 12/14/2023
1.5.43 240 12/11/2023
1.5.42 246 12/9/2023
1.5.41 268 12/4/2023
1.5.40 2,181 11/7/2023
1.5.39 1,166 10/9/2023
1.5.38 256 10/9/2023
1.5.37 569 9/27/2023
1.5.36 416 9/21/2023
1.5.35 908 8/19/2023
1.5.34 1,348 8/4/2023
1.5.33 303 8/3/2023
1.5.32 1,238 7/15/2023
1.5.31 520 7/8/2023
1.5.30 597 6/28/2023
1.5.29 363 6/22/2023
1.5.28 546 6/11/2023
1.5.27 435 6/3/2023
1.5.26 382 5/25/2023
1.5.25 662 5/13/2023
1.5.24 430 5/7/2023
1.5.23 793 4/23/2023
1.5.22 821 4/8/2023
1.5.21 910 3/22/2023
1.5.20 399 3/19/2023
1.5.19 318 3/17/2023
1.5.18 570 3/9/2023
1.5.17 742 2/25/2023
1.5.16 698 2/6/2023
1.5.15 517 1/29/2023
1.5.14 419 1/24/2023
1.5.13 1,183 12/11/2022
1.5.12 518 12/3/2022
1.5.11 1,243 11/24/2022
1.5.10 827 11/6/2022
1.5.9 580 10/29/2022
1.5.8 693 10/16/2022
1.5.7 576 10/11/2022
1.5.6 745 9/12/2022
1.5.5 650 9/3/2022
1.5.4 597 8/24/2022
1.5.3 724 7/29/2022
1.5.2 550 7/24/2022
1.5.1 646 7/8/2022
1.5.0 974 6/10/2022
1.4.43 750 5/21/2022
1.4.42 606 5/13/2022
1.4.41 983 4/22/2022
1.4.40 659 3/26/2022
1.4.39 589 3/25/2022
1.4.38 621 3/12/2022
1.4.37 599 3/2/2022
1.4.36 611 2/25/2022
1.4.35 1,977 2/9/2022
1.4.34 816 1/27/2022
1.4.33 590 1/24/2022
1.4.32 628 1/17/2022
1.4.31 518 1/6/2022
1.4.30 540 12/25/2021
1.4.29 752 12/12/2021
1.4.28 987 12/1/2021
1.4.27 615 11/17/2021
1.4.26 586 11/4/2021
1.4.25 566 10/27/2021
1.4.24 579 10/20/2021
1.4.23 676 9/27/2021
1.4.22 490 9/22/2021
1.4.21 537 9/16/2021
1.4.21-preview-03 367 9/12/2021
1.4.20 1,050 8/6/2021
1.4.19 497 8/4/2021
1.4.18 795 7/10/2021
1.4.17 544 7/7/2021
1.4.16 947 6/5/2021
1.4.15 877 5/19/2021
1.4.14 647 5/11/2021
1.4.13 696 4/26/2021
1.4.12 518 4/22/2021
1.4.11 549 4/18/2021
1.4.10 550 4/15/2021
1.4.9 585 3/31/2021
1.4.8 542 3/24/2021
1.4.7 592 3/21/2021
1.4.6 1,268 2/26/2021
1.4.5 695 2/11/2021
1.4.4 546 2/9/2021
1.4.3 534 2/5/2021
1.4.2 562 1/24/2021
1.4.1 559 1/19/2021
1.4.0 569 1/12/2021
1.3.10 568 12/23/2020
1.3.9 566 12/8/2020
1.3.8 575 12/3/2020
1.3.7 569 11/25/2020
1.0.0 166 7/22/2024
0.0.1 631 11/25/2020

# 1.8.13 (23 June 2025)
- #1322 Add Scenario set State method [feature]
- #1321 Feature: Setting individual scenario state via Admin API [feature]

The full release notes can be found here: https://github.com/wiremock/WireMock.Net/blob/master/CHANGELOG.md