Configuration

Basic Configuration

Basic configuration of Bard means the Arrangement part of the test cannot be utilized.

To configure our Scenario a few thing need to be set.

  • Client: our HTTP Client to call our API with (Required)

  • LogMessage: An action to instruct Bard where to log test output to. This is optional but important because Bard provides detailed logs to the test output windows to help with writing and debugging test failures. If not supplied Bard will output all log messages to the Console window which may not appear in your test output. (Optional)

  • Services: An instance of a .NET service provider to allow Bard access to use Dependency Injection. (Optional)

  • BadRequestProvider: Override the default bad request provider with your own implementation. (Optional)

var scenario = ScenarioConfiguration
.Configure(options =>
{
options.Client = httpClient;
options.LogMessage = output.WriteLine;
options.Services = host.Services;
options.BadRequestProvider = new MyBadRequestProvider();
});

Advanced Configuration

Advanced configuration of Bard means that a StoryBook is specified which allows all the features of Bard to be used within the scenario.

var scenario = ScenarioConfiguration
.WithStoryBook<BankingStory, BankingStoryData>()
.Configure(options =>
{
options.Client = httpClient;
options.LogMessage = output.WriteLine;
options.Services = host.Services;
options.BadRequestProvider = new MyBadRequestProvider();
});

The configuration of our Scenario is almost the same as the basic configuration apart from that we specify that we are going to use a StoryBook.

Our StoryBook might look something like this.

public class BankingStory : StoryBook<BankingStoryData>
{
// Stories would go here.
}

And our StoryData is just a plain old c# object (POCO) of your choice.

public class BankingStoryData
{
// Put whatever properties you want here
}