index.md

Stubbery

Simple library for creating and running Api stubs in .NET.

Introduction

In many situations it comes handy if we're able to start a simple service that responds on certain routes with preconfigured static responses.

This is particularly important in integration testing, when we might want to replace some of our dependencies with a stub that can reliably provide the expected responses.

Stubbery is a library with which we can simply configure and start a web server that responds on particular routes with the configured results. It targets nestandard2.0, so it can be used with .NET Core 2, and the full .NET Framework up from .NET 4.6.1.

The binaries are published on NuGet and you can find the source code on GitHub.

Basic usage

The following code sample shows how a simple stub can be started that responds on the route /testget with the string testresponse.

using (var stub = new ApiStub())
{
    stub.Get(
        "/testget",
        (req, args) => "testresponse");

    stub.Start();

    var result = await httpClient.GetAsync(new UriBuilder(new Uri(stub.Address)) { Path = "/testget" }.Uri);

    // resultString will contain "testresponse"
    var resultString = await result.Content.ReadAsStringAsync();
}

More details can be found in the Documentation and in the Api Reference.