Overview

Modern Gherkin-based BDD framework for .NET ecosystem

Requirements

• NET 8+ (.NET 9 is recommended)
• Visual Studio 2022 or Visual Studio Code or any other editor with .NET support

Optional: gherking syntax plugin for your code editor:

1. Reqnroll plugin for Visual Studio 2022
2. Cucumber plugin for Visual Studio Code or any other plugin

How to use

1. Create new class library for .NET 8+
2. Add following nuget packages:

• https://www.nuget.org/packages/NGherkin
• https://www.nuget.org/packages/NGherkin.TestAdapter
• https://www.nuget.org/packages/Microsoft.NET.Test.Sdk

3. Create startup class and register dependencies. Example:

public sealed class Startup : StartupBase
{
    public override void Configure(IServiceCollection services)
    {
        services.AddGherkinFeatures();
        services.AddGherkinSteps();
    }
}

4. Add feature files
5. Add classes with steps. Example:

[Steps]
internal sealed class StepClass
{
    [Given("given1")]
    public void Given()
    {
    }

    [When("this is when step with '(.*)' argument an '(.*)' argument")]
    public void When1(int arg1, string arg2, DataTable dataTable)
    {
    }

    [Then("then1")]
    public void Then1()
    {
    }
}