TestIT.Adapter.SpecFlowPlugin 1.7.1

Test IT TMS Adapter for SpecFlow

Getting Started

Installation

NuGet CLI

Install-Package TestIT.Adapter.SpecFlowPlugin
Install-Package TestIT.Adapter.Core

.NET CLI

dotnet add package TestIT.Adapter.SpecFlowPlugin
dotnet add package TestIT.Adapter.Core

Add runtime plugin

Also you need to add following lines to specflow.json:

{
  "assembly": "Tms.Adapter.SpecFlowPlugin"
}

Usage

Configuration

File

Create Tms.config.json file in the project directory:

{
  "url": "URL",
  "privateToken": "USER_PRIVATE_TOKEN",
  "projectId": "PROJECT_ID",
  "configurationId": "CONFIGURATION_ID",
  "testRunId": "TEST_RUN_ID",
  "testRunName": "TEST_RUN_NAME",
  "automaticCreationTestCases": false,
  "automaticUpdationLinksToTestCases": false,
  "certValidation": true,
  "isDebug": true
}

How to run

Just run the command:

dotnet test

Run with filter

To create filter by autotests you can use the Test IT CLI (use adapterMode 1 for run with filter):

$ export TMS_TOKEN=<YOUR_TOKEN>
$ testit autotests_filter 
  --url https://tms.testit.software \
  --configuration-id 5236eb3f-7c05-46f9-a609-dc0278896464 \
  --testrun-id 6d4ac4b7-dd67-4805-b879-18da0b89d4a8 \
  --framework specflow \
  --output tmp/filter.txt

$ export TMS_TEST_RUN_ID=6d4ac4b7-dd67-4805-b879-18da0b89d4a8
$ export TMS_ADAPTER_MODE=1

$ dotnet test --filter "$(cat tmp/filter.txt)"

Attributes

Use attributes to specify information about autotest.

Description of attributes:

• WorkItemIds - a method that links autotests with manual tests. Receives the array of manual tests' IDs
• DisplayName - internal autotest name (used in Test IT)
• ExternalId - unique internal autotest ID (used in Test IT)
• Title - autotest name specified in the autotest card. If not specified, the name from the displayName method is used
• Description - autotest description specified in the autotest card
• Labels - tags listed in the autotest card
• Links - links listed in the autotest card

Description of methods:

• Adapter.AddLinks - add links to the autotest result.
• Adapter.AddAttachments - add attachments to the autotest result.
• Adapter.AddMessage - add message to the autotest result.

Examples

Simple test

Feature: Simple

  @ExternalId=With_all_annotations_success
  @DisplayName=With_all_annotations_success_display_name
  @Title=With_all_annotations_success_title
  @Description=With_all_annotations_success
  @Labels=Label1,Label2
  @Links={"url":"https://test01.example","title":"Example01","description":"Example01_description","type":"Issue"}
  @Links={"url":"https://test02.example","title":"Example02","description":"Example02_description","type":"Issue"}
  @WorkItemIds=123,321
  Scenario: With all annotations
    Then return true

Parameterized test

Feature: Parameterized

  @ExternalId=parametrized_test_{number}_{value}_success
  @DisplayName=parametrized_test_{number}_{value}_success_display_name
  @Title=parametrized_test_{number}_{value}_success_title
  @Description=parametrized_test_{number}_{value}_success
  Scenario Outline: Parametrized test
    When get parameters <number> <value>
    Then return true

    Examples:
      | number | value    |
      | 1      | string01 |
      | 2      | string02 |
      | 3      | string03 |

Contributing

You can help to develop the project. Any contributions are greatly appreciated.

• If you have suggestions for adding or removing projects, feel free to open an issue to discuss it, or create a direct pull request after you edit the README.md file with necessary changes.
• Make sure to check your spelling and grammar.
• Create individual PR for each suggestion.
• Read the Code Of Conduct before posting your first idea as well.

License

Distributed under the Apache-2.0 License. See LICENSE for more information.