Home

Welcome to the Boomerang wiki!

Boomerang makes testing your applications easier by enabling you to fake HTTP services your code depends upon.

This makes tests faster and less brittle, allowing you to get consistent and fast feedback from your tests.

• Getting started
• Extending Boomerang

Configuring Requests Boomerang supports all HTTP verbs. You can configure these using Boomerangs simple fluent interface. The first thing you need to do is create an instance of Boomerang;

var host = Host.Boomerang.Create(
	    x => x.AtAddress("http://localhost:5100")
        );

Now your ready to configure requests on the host. Examples of using the interface is below;

GET The below code configures will return a OK response with a body of 'Coffee' for a request to http://localhost:5100/api/menu

host.Get("api/menu/items/123").Returns("Coffee", 200);

Post The below code will return a Created response with a body of Mocha for a request to the relative address api/menu/items/123

host.Post("api/menu/items/123").Returns("Mocha", 201);

Put

            host.Put("api/menu/items/123").Returns("Mocha", 201);

Delete

            host.Delete("api/menu/items/123").Returns("Mocha", 202);

Request All other verbs are supported via the general Request method. For example, the below code configures a Trace request;

                host.Request("api/menu/items", "TRACE").Returns("", 200);

The second parameter defines the Http verb the request is configuring.

If you configure these several times you might consider creating you own extension method as below;

   public static IRequestHandler Trace(this IBoomerang host, string relativeUrl)
    {
        return host.Request(relativeUrl, "TRACE");
    }

Now you can simply use this extension method whereever you want to configure a Trace request;

   host.Trace("api/menu/items").Returns("Trace", 200);