Welcome to SpecFlow+ Runner's documentation!
============================================

SpecFlow+ Runner is a dedicated test runner for SpecFlow that integrates directly with Visual Studio. You can also execute tests from the :doc:`command line <./Usage/SpecFlowPlus-Runner-Command-Line>`.

SpecFlow+ include the following features:

* Visual Studio integration (syntax coloring, auto completion, navigation, skeleton generation, Gherkin table formatting)
* Visual Studio Test Explorer integration (business readable scenario names, run/debug from feature file)
* Advanced test runner features: :doc:`execution profiles <./Profile/Profiles>`, :doc:`target environments <./Profile/Environment>`, attach artifacts to test execution reports, TFS integration, TeamCity integration, :doc:`complex scenario filter expressions <./Profile/Filter>`
* Dedicated support for integration test execution (:doc:`config file transformation and deployment steps <./Profile/DeploymentTransformation>`, test targets: re-run tests for different environments and configurations, detect flickering scenarios)
* Parallel test execution (app domain isolation, process isolation, execution results consolidation)
* Advanced test execution scheduling (run previously failing tests first, retry scenarios, execution history available as OData)
* Customizable HTML :doc:`reports (Razor templates) <./Usage/Reports>`

If you are new to SpecFlow+, we recommend you to check out the `Getting Started <https://docs.specflow.org/projects/getting-started/en/latest/>`_ guides as a starting point.

A number of example projects have also been put together by the SpecFlow team and the community `here <https://docs.specflow.org/en/latest/Examples.html>`_ .

.. toctree::
   :maxdepth: 1
   :caption: Migration
   :hidden:

   Migration/migratingspecrunrst.rst

.. toctree::
   :maxdepth: 1
   :caption: Installation
   :hidden:

   Installation/Installation.md
   Installation/Support-for-OS-and-Frameworks.md
   Installation/SpecFlowPlus-Licensing-Tool.md
   Installation/SpecFlow.Plus.License-Commands.md
   Installation/Registering-SpecFlowPlus.md
   Installation/Configuring-SpecFlowPlus-Runner-Visual-Studio-Test-Explorer-Integration.md
   Installation/Setting-up-the-SpecFlowPlus-Runner-Server.md
   Installation/SpecFlowPlus-Runner-Server-Data.md
   Installation/SpecFlowPlus-and-Build-Servers.md
   Installation/Migrating-to-SpecFlow-Runner.md


.. toctree::
   :maxdepth: 1
   :caption: Profile
   :hidden:

   Profile/Profiles.md
   Profile/Settings.md
   Profile/Execution.md
   Profile/Environment.md
   Profile/Report.md
   Profile/Filter.md
   Profile/Targets.md
   Profile/DeploymentTransformation.md
   Profile/TestThreads.md
   Profile/VSTest.md
   Profile/TestAssemblyPaths.md
   Profile/Server.md

   Profile/Placeholders.md

.. toctree::
   :maxdepth: 1
   :caption: Usage
   :hidden:

   Usage/Parallel-Execution-Features.md
   Usage/SpecFlowPlus-Runner-Command-Line.md
   Usage/Test-Execution-Result-Codes.md
   Usage/Generating-a-TRX-File.md
   Usage/Reports.md
   Usage/Tutorial-Customising-Reports.md
   Usage/SpecFlow-Runner-APIs.md

.. toctree::
   :maxdepth: 1
   :caption: Common Issues
   :hidden:

   CommonIssues/Troubleshooting.md
   CommonIssues/Known-Issues.md