https://github.com/romfos/autotests.framework

Reqnroll based BDD framework with focus on automation testing for .NET
https://github.com/romfos/autotests.framework

automation-test autotest-framework autotests bdd bdd-framework dotnet playwright reqnroll specflow test-framework testing testing-framework webdriver

Last synced: 3 months ago
JSON representation

Reqnroll based BDD framework with focus on automation testing for .NET

• Host: GitHub
• URL: https://github.com/romfos/autotests.framework
• Owner: Romfos
• License: mit
• Created: 2017-05-16T19:55:35.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-05-22T22:23:17.000Z (9 months ago)
• Last Synced: 2024-05-22T23:30:11.974Z (9 months ago)
• Topics: automation-test, autotest-framework, autotests, bdd, bdd-framework, dotnet, playwright, reqnroll, specflow, test-framework, testing, testing-framework, webdriver
• Language: C#
• Homepage:
• Size: 4.83 MB
• Stars: 5
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Overview

Reqnroll based autotest framework

[![.github/workflows/test.yml](https://github.com/Romfos/AutoTests.Framework/actions/workflows/test.yml/badge.svg)](https://github.com/Romfos/AutoTests.Framework/actions/workflows/test.yml)

[![AutoTests.Framework.Playwright](https://img.shields.io/nuget/v/AutoTests.Framework.Playwright?label=AutoTests.Framework.Playwright)](https://www.nuget.org/packages/AutoTests.Framework.Playwright)

Main features:

- C# expression support inside features

- Test data management framework

- Model transformation framework

- Component framework for UI testing

- Playwright integration

# Test example

```gherkin

Feature: CheckoutForm

Scenario: checkout form validation test

    Given navigate to '@Data.Common.HomePageUrl'

    When set following values:

    | Name                  | Value      |

    | checkout > first name | first_name |

    | checkout > last name  | last_name  |

    And click on 'checkout > continue to checkout'

    Then should be visible:

    | Name                              |

    | checkout > username error message |

    And should have following values:

    | Name                              | Value                      |

    | checkout > username error message | Your username is required. |

```

# Requirements

- .NET 8+

- Visual Studio 2022 or Visual Studio Code

- [Reqnroll plugin](https://marketplace.visualstudio.com/items?itemName=Reqnroll.ReqnrollForVisualStudio2022) for Visual Studio 2022 or [Cucumber plugin](https://marketplace.visualstudio.com/items?itemName=CucumberOpen.cucumber-official) for Visual Studio Code

# Nuget packages links  

- https://www.nuget.org/packages/AutoTests.Framework

- https://www.nuget.org/packages/AutoTests.Framework.Components

- https://www.nuget.org/packages/AutoTests.Framework.Playwright

# How to use

You can find example in Bootstrap.Tests project for UI testing

Basic steps:

1) Create unit test project

2) Add additional Reqnroll nuget packages for unit test provider:

| Unit test framework | Nuget package                                                     |

|---------------------|-------------------------------------------------------------------|

| MSTest              | [Reqnroll.MsTest](https://www.nuget.org/packages/Reqnroll.MsTest) |

| NUnit               | [Reqnroll.NUnit](https://www.nuget.org/packages/Reqnroll.NUnit)   |

| xUnit               | [Reqnroll.xUnit](https://www.nuget.org/packages/Reqnroll.xUnit)   |

> [!WARNING]  

> Version of test adapter nuget package should match to Reqnroll package version

   

3) Add nuget package

[AutoTests.Framework.Playwright](https://www.nuget.org/packages/AutoTests.Framework.Playwright)

4) Create `reqnroll.json` and register framework assemblies. Example:

```

{

  "$schema": "https://schemas.reqnroll.net/reqnroll-config-latest.json",

  "stepAssemblies": [

    { "assembly": "AutoTests.Framework" },

    { "assembly": "AutoTests.Framework.Components" },

    { "assembly": "AutoTests.Framework.Playwright" }

  ]

}

```

5) Create Application class for UI application

```csharp

internal sealed class BootstrapApplication : IApplication

{

    [Route("checkout")]

    public Checkout? Checkout { get; set; }

}

```

# How to make browser window visible

By default browser will run in headless mode.

If you need to change this behavior just add BeforeTestRun hook inside your test app and override BrowserTypeLaunchOptions like this:

```csharp

[Binding]

internal sealed class ReqnrollHooks

{

    [BeforeTestRun(Order = 0)]

    public static void BeforeTestRun(IObjectContainer objectContainer)

    {

        objectContainer.RegisterInstanceAs(new BrowserTypeLaunchOptions { Headless = false });

    }

}

```

# How to work with test data

You can create json file in Data subfolder and get access to content in feature to it like:

```gherkin

Feature: CheckoutForm

Scenario: checkout form validation test

    Given navigate to '@Data.Common.HomePageUrl' #return value HomePageUrl from Data\Common.json

```

You can find example in 'Bootstrap.Tests'