bob11327/wiremock.net

WireMock.Net is a flexible library for stubbing and mocking web HTTP responses using requests matching criteria. Based on the functionality from http://WireMock.org

WireMock.Net

A C# .NET version based on mock4net which mimics the functionality from the JAVA based http://WireMock.org

Name	NuGet
WireMock.Net
WireMock.Net.StandAlone

Frameworks

The following frameworks are supported:

• net 4.5.2 and up
• net 4.6 and up
• netstandard 1.3
• netstandard 2.0

Build info

To build you need:

• Microsoft .NET Framework 4.5.2 Developer Pack (https://www.microsoft.com/en-us/download/details.aspx?id=42637)
• Microsoft .NET Framework 4.6 Targeting Pack (https://www.microsoft.com/en-us/download/confirmation.aspx?id=48136)
• Microsoft .NET Framework 4.6.2 Developer Pack (https://www.microsoft.com/en-us/download/confirmation.aspx?id=53321)
• .NET Core 2.0 (https://www.microsoft.com/net/core)

Stubbing

A core feature of WireMock.Net is the ability to return canned/predefined HTTP responses for requests matching criteria, see Wiki : Stubbing & Request Matching.

Using WireMock in UnitTest framework

You can use your favorite test framework and use WireMock within your tests, see Wiki : UnitTesting.

Admin API Reference

The WireMock admin API provides functionality to define the mappings via a http interface, see Wiki : Admin API Reference.

WireMock as a standalone process

This is quite straight forward to launch a mock server within a console application, see Wiki : standalone.

SSL

You can start a standalone mock server listening for HTTPS requests. To do so, there is just a flag to set when creating the server:

var server1 = FluentMockServer.Start(port: 8443, ssl: true);

// or like this

var server2 = FluentMockServer.Start(new FluentMockServerSettings
{
    Urls = new[] { "http://localhost:9091", "https://localhost:9443" }
});

• In case when using net 4.5.2 or net 4.6, you need a certificate registered on your box, properly associated with your application and the port number that will be used. This is not really specific to WireMock.Net, not very straightforward and hence the following stackoverflow thread might come handy: Httplistener with https support.

• When using netstandard, WireMock.Net uses a self signed certificate (which can be overriden if you like) to host https urls.