Overview

Modern opensource BDD framework for C# and .NET with gherkin support

Description	Package
Core services. Responsible for scenario lifecycle & configuration.
Adding support for Gherkin language. Source generator.
Adding support for C# expressions for arguments.

How to use

Wiki: Setup .NET 8 project with Gherkin support

Comparing with alternatives

Comparing with Reqnroll (or Specflow, other popular framework in .NET Ecosystem) this framework has following difference:

• Microsoft.Extensions.* based
• Microsoft testing platform as a backend. No hell with different unit tests providers.
• Source generator for features compilation & step registration
• Code first approach with builder pattern
• Extensibility via public interfaces and DI
• Modular. Small and fast library. All extra features are provided as separate nuget packages
• No reflection usage (or quite limited)
• Support .NET 8+ (.NET 9 is a recommended option) and .NET Framework 4.7.2+
• AOT & Trimming friendly. More info: Native AOT deployment
• Nullable reference types and other modern dotnet features support

BddDotNet.Gherkin.SourceGenerator usage example

Allow you to use Gherkin scenarios:

Feature: Guess the word

  # The first example has two steps
  Scenario: Maker starts a game
    When the Maker starts a game
    Then the Maker waits for a Breaker to join

  # The second example has three steps
  Scenario: Breaker joins a game
    Given the Maker has started a game with the word "silky"
    When the Breaker joins the Maker's game
    Then the Breaker must guess a word with 5 characters

BddDotNet usage example

Alllow you to use builder syntax for building steps & scenarios

Program.cs content:

using BddDotNet;
using Microsoft.Testing.Platform.Builder;

var builder = await TestApplication.CreateBuilderAsync(args);
var services = builder.AddBddDotNet();

services.Scenario<Program>("feature1", "scenario1", async context =>
{
    await context.Given("this is given step");
    await context.When("this is when step");
    await context.Then("this is then step");
});

services.Given(new("this is given step"), () =>
{
    Console.WriteLine("This is the given step.");
});

services.When(new("this is when step"), () =>
{
    Console.WriteLine("This is the when step.");
});

services.Then(new("this is then step"), () =>
{
    Console.WriteLine("This is the then step.");
});

using var testApp = await builder.BuildAsync();
return await testApp.RunAsync();