Merge pull request #477 from qase-tms/feat/reporters-tags-support

feat: add test-level tags support to all reporters

Author: gibiw

integration/behave/expected/behave-examples.yaml

@@ -4,9 +4,9 @@ run:
     failed: 0
     invalid: 2
     muted: 0
-    passed: 16
+    passed: 18
     skipped: 1
-    total: 19
+    total: 21
 results:
 - title: Test in Authentication suite
   signature: 301::authentication::test_in_authentication_suite
@@ -351,3 +351,37 @@ results:
       action: Then the sum is 3
     execution:
       status: passed
+- title: Test with single tag
+  signature: 901::features::tags.feature::test_with_single_tag
+  testops_ids:
+  - 901
+  status: passed
+  fields:
+    tags: smoke
+  relations:
+    suite:
+      data:
+      - title: features
+      - title: tags.feature
+  steps:
+  - data:
+      action: Given a passing condition
+    execution:
+      status: passed
+- title: Test with multiple tags
+  signature: 902::features::tags.feature::test_with_multiple_tags
+  testops_ids:
+  - 902
+  status: passed
+  fields:
+    tags: smoke,regression,api
+  relations:
+    suite:
+      data:
+      - title: features
+      - title: tags.feature
+  steps:
+  - data:
+      action: Given a passing condition
+    execution:
+      status: passed

integration/behave/features/tags.feature

@@ -0,0 +1,9 @@
+Feature: Tags tests
+
+  @qase.id:901 @qase.tags:smoke
+  Scenario: Test with single tag
+    Given a passing condition
+
+  @qase.id:902 @qase.tags:smoke,regression,api
+  Scenario: Test with multiple tags
+    Given a passing condition

integration/pytest/expected/pytest-examples.yaml

@@ -4,9 +4,9 @@ run:
     failed: 2
     invalid: 0
     muted: 0
-    passed: 24
+    passed: 28
     skipped: 1
-    total: 27
+    total: 31
 results:
 - title: Muted test
   signature: 208::integration::pytest::tests::test_fields.py::test_muted
@@ -375,3 +375,51 @@ results:
       data:
       - title: integration/pytest/tests
       - title: test_basic
+- title: Test with single tag
+  signature: 901::integration::pytest::tests::test_tags.py::test_single_tag
+  testops_ids:
+  - 901
+  status: passed
+  fields:
+    tags: smoke
+  relations:
+    suite:
+      data:
+      - title: integration/pytest/tests
+      - title: test_tags
+- title: Test with multiple tags
+  signature: 902::integration::pytest::tests::test_tags.py::test_multiple_tags
+  testops_ids:
+  - 902
+  status: passed
+  fields:
+    tags: smoke,regression,api
+  relations:
+    suite:
+      data:
+      - title: integration/pytest/tests
+      - title: test_tags
+- title: Test with tags via fields
+  signature: 903::integration::pytest::tests::test_tags.py::test_tags_via_fields
+  testops_ids:
+  - 903
+  status: passed
+  fields:
+    tags: fromfield
+  relations:
+    suite:
+      data:
+      - title: integration/pytest/tests
+      - title: test_tags
+- title: Test with merged tags
+  signature: 904::integration::pytest::tests::test_tags.py::test_tags_merged
+  testops_ids:
+  - 904
+  status: passed
+  fields:
+    tags: fromfield,api
+  relations:
+    suite:
+      data:
+      - title: integration/pytest/tests
+      - title: test_tags

integration/pytest/tests/test_tags.py

@@ -0,0 +1,31 @@
+"""Tests demonstrating tags support."""
+from qase.pytest import qase
+
+
+@qase.id(901)
+@qase.title("Test with single tag")
+@qase.tags("smoke")
+def test_single_tag():
+    assert True
+
+
+@qase.id(902)
+@qase.title("Test with multiple tags")
+@qase.tags("smoke", "regression", "api")
+def test_multiple_tags():
+    assert True
+
+
+@qase.id(903)
+@qase.title("Test with tags via fields")
+@qase.fields(("tags", "fromfield"))
+def test_tags_via_fields():
+    assert True
+
+
+@qase.id(904)
+@qase.title("Test with merged tags")
+@qase.tags("api")
+@qase.fields(("tags", "fromfield"))
+def test_tags_merged():
+    assert True

integration/robot/expected/robot-examples.yaml

@@ -4,9 +4,9 @@ run:
     failed: 0
     invalid: 1
     muted: 0
-    passed: 1
+    passed: 3
     skipped: 0
-    total: 2
+    total: 4
 results:
 - title: Test With Failing Step
   signature: 302::steps::test_with_failing_step
@@ -77,3 +77,27 @@ results:
         action: Should Be True Should Be True
       execution:
         status: passed
+- title: Test With Single Tag
+  signature: 901::steps::test_with_single_tag
+  testops_ids:
+  - 901
+  status: passed
+  fields:
+    description: Test with one tag
+    tags: smoke
+  relations:
+    suite:
+      data:
+      - title: Steps
+- title: Test With Multiple Tags
+  signature: 902::steps::test_with_multiple_tags
+  testops_ids:
+  - 902
+  status: passed
+  fields:
+    description: Test with multiple tags
+    tags: smoke,regression,api
+  relations:
+    suite:
+      data:
+      - title: Steps

integration/robot/tests/steps.robot

@@ -13,6 +13,16 @@ Test With Failing Step
     Open Application
     Trigger Failure
 
+Test With Single Tag
+    [Documentation]    Test with one tag
+    [Tags]    Q-901    qase.tags:smoke
+    Should Be True    ${TRUE}
+
+Test With Multiple Tags
+    [Documentation]    Test with multiple tags
+    [Tags]    Q-902    qase.tags:smoke,regression,api
+    Should Be True    ${TRUE}
+
 *** Keywords ***
 Open Application
     Log    Application opened

integration/tavern/expected/tavern-examples.yaml

@@ -4,9 +4,9 @@ run:
     failed: 0
     invalid: 1
     muted: 0
-    passed: 5
+    passed: 7
     skipped: 0
-    total: 6
+    total: 8
 results:
 - title: Get list of users
   signature: 101::test_api.tavern.yaml::qaseid=101_get_list_of_users
@@ -132,3 +132,45 @@ results:
         mime_type: application/json
       - file_name: response.json
         mime_type: application/json
+- title: Get tagged users
+  signature: 901::test_api.tavern.yaml::qaseid=901_qasetags.smoke_get_tagged_users
+  testops_ids:
+  - 901
+  status: passed
+  fields:
+    tags: smoke
+  relations:
+    suite:
+      data:
+      - title: test_api.tavern.yaml
+  steps:
+  - data:
+      action: Fetch users with tag
+    execution:
+      status: passed
+      attachments:
+      - file_name: request.json
+        mime_type: application/json
+      - file_name: response.json
+        mime_type: application/json
+- title: Get tagged posts
+  signature: 902::test_api.tavern.yaml::qaseid=902_qasetags.smoke,regression,api_get_tagged_posts
+  testops_ids:
+  - 902
+  status: passed
+  fields:
+    tags: smoke,regression,api
+  relations:
+    suite:
+      data:
+      - title: test_api.tavern.yaml
+  steps:
+  - data:
+      action: Fetch posts with tags
+    execution:
+      status: passed
+      attachments:
+      - file_name: request.json
+        mime_type: application/json
+      - file_name: response.json
+        mime_type: application/json

integration/tavern/tests/test_api.tavern.yaml

@@ -68,3 +68,23 @@ stages:
       method: GET
     response:
       status_code: 200
+
+---
+test_name: QaseID=901 QaseTags.smoke Get tagged users
+stages:
+  - name: Fetch users with tag
+    request:
+      url: https://jsonplaceholder.typicode.com/users
+      method: GET
+    response:
+      status_code: 200
+
+---
+test_name: QaseID=902 QaseTags.smoke,regression,api Get tagged posts
+stages:
+  - name: Fetch posts with tags
+    request:
+      url: https://jsonplaceholder.typicode.com/posts/1
+      method: GET
+    response:
+      status_code: 200

qase-behave/changelog.md

@@ -1,3 +1,9 @@
+# qase-behave 3.1.0
+
+## What's new
+
+- Added support for test-level tags using the `@qase.tags:tag1,tag2` Gherkin tag. Feature and scenario tags are accumulated.
+
 # qase-behave 3.0.0
 
 ## What's new

qase-behave/docs/usage.md

@@ -11,6 +11,7 @@ This guide provides comprehensive instructions for integrating Qase with Behave
 - [Adding QaseID](#adding-qaseid)
 - [Adding Fields](#adding-fields)
 - [Adding Suite](#adding-suite)
+- [Adding Tags](#adding-tags)
 - [Ignoring Tests](#ignoring-tests)
 - [Working with Attachments](#working-with-attachments)
 - [Multi-Project Support](#multi-project-support)
@@ -146,6 +147,34 @@ Feature: Authentication
 
 ---
 
+## Adding Tags
+
+Use the `@qase.tags:` tag to assign tags to scenarios. Tags are sent as a comma-separated string to the Qase API.
+
+### Basic Usage
+
+```gherkin
+@qase.id:1 @qase.tags:smoke,regression
+Scenario: Login test
+  Given a passing condition
+```
+
+### Feature and Scenario Merge
+
+Tags from the feature level and scenario level are accumulated:
+
+```gherkin
+@qase.tags:smoke
+Feature: Authentication
+
+  @qase.id:1 @qase.tags:regression
+  Scenario: Login test
+    # Tags: smoke, regression
+    Given a passing condition
+```
+
+---
+
 ## Ignoring Tests
 
 Exclude scenarios from Qase reporting while still executing them: