BDTest

A testing framework for .NET Core 2.0+

About

BDTest is a testing framework. It can be used with other frameworks (such as MSTest, xUnit or NUnit) or standalone. The examples below will use attributes (such as [Test]) from NUnit.

Installation

Install via Nuget > Install-Package BDTest

Usage

Tests can be constructed either by extending from a base class, or by using the a test builder object.

Extending from BDTestBase

public class MyTests : BDTestBase
{
    [Test]
    public void Test1() {
        Given(() => Action1())
        .When(() => Action2())
        .Then(() => Action3())
        .BDTest();
    }
}

Or by using the BDTestBuilder object

public class MyTests 
{
    [Test]
    public void Test1() {
        new BDTestBuilder().Given(() => Action1())
                            .When(() => Action2())
                            .Then(() => Action3())
                            .BDTest();
    }
}

Automatic Context Construction

Lambda Syntax

Construction of your TestContext using lambda syntax

public class MyTests : BDTestBase
{
    [Test]
    public void Test1() {
        WithContext<TestContext>(context =>
            Given(() => Action1(context))
            .When(() => Action2(context))
            .Then(() => Action3(context))
            .BDTest()
        );
    }
}

Your TestContext will be automatically constructed and injected in via the lambda

NUnit

Instead of extending from BDTestBase extend from NUnitBDTestBase and pass the type of your Context. Your context will be constructed for each test independently.

Access this using the Context property. See below for example.

    public class TestsUsingNUnitBaseWithContext : NUnitBDTestBase<TestContext>
    {
        [Test]
        public void Test1()
        {
            Given(() => Action1(Context))
                .When(() => Action2(Context))
                .Then(() => Action3(Context))
                .BDTest();
        }
    }

For either of these methods, your TestContext should have a public constructor with 0 parameters. Otherwise, check out the source code for NUnitBDTestBase to set up your own version with extra construction logic.

Thread Safety Parallelization

In order to keep all tests thread safe and have the ability to run all in parallel:

Use the NUnitBDTestBase<> base class OR WithContext<TestContext>(...) syntax as above
Do not use static variables/fields/properties in your tests
Do not share fields/properties in your test class - All variables should be populated as new for each test - Which the Context construction can take care of

Best Practice

BDTest enforces best practice:

Tests MUST contain a Given + When + Then and executed with a BDTest
Tests MUST start with a Given
- Off of a Given you can have And or When
  - Off of an And you can have And or When
- Off of a When you can have a Then
  - (No And - We should be testing one action!)
- Off of a Then you can have And or BDTest
  - Off of an And you can have And or BDTest

Attributes

StoryText

Annotate your test classes with a [StoryText] attribute

[Story(AsA = "Test User",
    IWant = "To Test",
    SoThat = "Things Work")]
public class MyTests : BDTestBase
{
    ...
}

Scenario Text

Annotate your tests with a [ScenarioText] attribute

[Test]
[ScenarioText("Custom Scenario")]
public void Test1()
{
    Given(() => Action1())
        .When(() => Action2())
        .Then(() => Action3())
        .And(() => Action4())
        .BDTest();
}

Step Text

Annotate your steps/methods with a [StepText] attribute

[StepText("I perform my second action")]
public void Action2()
{
    ...
}

Step Text (with parameters)

Use parameter indexes to substitute in your arguments to the steptext

[StepText("my name is {0} {1}")]
public void SetName(string firstName, string lastName)
{
    ...
}

public void TestSetName() 
{
    Given(() => SetName("Tom", "Longhurst");) // StepText should equal "Given my name is Tom Longhurst"
    .When(() => SetName("Tom", "Longhurst");) // StepText should equal "When my name is Tom Longhurst"
    .Then(() => SetName("Tom", "Longhurst");) // StepText should equal "Then my name is Tom Longhurst"
    .And(() => SetName("Tom", "Longhurst");) // StepText should equal "And my name is Tom Longhurst"
}

Reports

Report Installation

Install via Nuget > Install-Package BDTest.ReportGenerator

Report Usage

You don't have to do anything for the standard reports!

Once the package has been installed and your tests have run, these reports should appear in your output directory automatically.

See below for extra options.

Persistant Test Data

BDTest allows you to pass it a directory path, to persistantly store test data. Why is this useful? It allows us to keep a record of all our test runs, and this allows us to compare test runs.

Set the directory by setting BDTestSettings.PersistantResultsDirectory

[OneTimeSetUp]
public void SetPersistantStorage()
{
    BDTestSettings.PersistantResultsDirectory = "C:\\AcceptanceTests";
}

[Test]
public void Test() 
{
    ...
}

If you set these, you will be produced a Test Time Comparison Report and a Test Flakiness Report.