Qase TestOps Pytest Reporter

Qase Pytest Reporter enables seamless integration between your Pytest tests and Qase TestOps, providing automatic test result reporting, test case management, and comprehensive test analytics.

Features

Link automated tests to Qase test cases by ID
Auto-create test cases from your test code
Report test results with rich metadata (fields, attachments, steps)
Support for parameterized tests
Multi-project reporting support
Flexible configuration (file, environment variables, CLI)
Built-in support for Playwright-based tests

Installation

pip install qase-pytest

Quick Start

1. Create qase.config.json in your project root:

{
  "mode": "testops",
  "testops": {
    "project": "YOUR_PROJECT_CODE",
    "api": {
      "token": "YOUR_API_TOKEN"
    }
  }
}

2. Add Qase ID to your test:

from qase.pytest import qase

@qase.id(1)
def test_example():
    assert True

3. Run your tests:

pytest

Upgrading

For migration guides between major versions, see Upgrade Guide.

Configuration

The reporter is configured via (in order of priority):

CLI options (--qase-*, highest priority)
Environment variables (QASE_*)
Config file (qase.config.json)

Minimal Configuration

Option	Environment Variable	CLI Option	Description
`mode`	`QASE_MODE`	`--qase-mode`	Set to `testops` to enable reporting
`testops.project`	`QASE_TESTOPS_PROJECT`	`--qase-testops-project`	Your Qase project code
`testops.api.token`	`QASE_TESTOPS_API_TOKEN`	`--qase-testops-api-token`	Your Qase API token

Example `qase.config.json`

{
  "mode": "testops",
  "fallback": "report",
  "testops": {
    "project": "YOUR_PROJECT_CODE",
    "api": {
      "token": "YOUR_API_TOKEN"
    },
    "run": {
      "title": "Pytest Automated Run"
    },
    "batch": {
      "size": 100
    }
  },
  "report": {
    "driver": "local",
    "connection": {
      "local": {
        "path": "./build/qase-report",
        "format": "json"
      }
    }
  },
  "framework": {
    "pytest": {
      "captureLogs": true
    }
  }
}

Full configuration reference: See qase-python-commons for all available options including logging, status mapping, execution plans, and more.

Usage

Link Tests with Test Cases

Associate your tests with Qase test cases using test case IDs:

from qase.pytest import qase

# Single ID
@qase.id(1)
def test_single_id():
    assert True

# Multiple IDs
@qase.id([2, 3])
def test_multiple_ids():
    assert True

Add Metadata

Enhance your tests with additional information:

from qase.pytest import qase

@qase.id(1)
@qase.title("User Login Test")
@qase.suite("Authentication")
@qase.fields(
    ("severity", "critical"),
    ("priority", "high"),
    ("layer", "e2e"),
    ("description", "Verify user can log in with valid credentials"),
    ("preconditions", "User account exists in the system"),
)
def test_user_login():
    assert True

Ignore Tests

Exclude specific tests from Qase reporting (test still runs, but results are not sent):

from qase.pytest import qase

@qase.ignore()
def test_not_reported():
    assert True

Test Result Statuses

Pytest Result	Qase Status
Passed	`passed`
Failed (AssertionError)	`failed`
Failed (other exception)	`invalid`
Skipped	`skipped`

Attachments

Attach files, screenshots, and logs to test results:

from qase.pytest import qase

def test_with_attachments():
    # Attach file from path
    qase.attach("/path/to/file.txt")

    # Attach with custom MIME type
    qase.attach(("/path/to/file.json", "application/json"))

    # Attach content from memory
    qase.attach((b"screenshot data", "image/png", "screenshot.png"))

    assert True

Test Steps

Define test steps for detailed reporting:

from qase.pytest import qase

@qase.step("Open login page")
def open_login():
    pass

@qase.step("Enter credentials")
def enter_credentials(username, password):
    pass

def test_login():
    open_login()
    enter_credentials("user", "pass")

    # Inline step with context manager
    with qase.step("Click login button"):
        pass

For detailed usage examples, see the Usage Guide.

Running Tests

Basic Execution

pytest

With CLI Options

pytest \
    --qase-mode=testops \
    --qase-testops-project=PROJ \
    --qase-testops-api-token=your_token

With Environment Variables

export QASE_MODE=testops
export QASE_TESTOPS_PROJECT=PROJ
export QASE_TESTOPS_API_TOKEN=your_token
pytest

With Existing Test Run

pytest --qase-testops-run-id=123

With Test Plan

pytest --qase-testops-plan-id=456

Requirements

Python >= 3.9
pytest >= 7.0.0

Documentation

Guide	Description
Usage Guide	Complete usage reference with all decorators and options
Attachments	Adding screenshots, logs, and files to test results
Steps	Defining test steps for detailed reporting
Parameters	Working with parameterized tests
Multi-Project Support	Reporting to multiple Qase projects
Upgrade Guide	Migration guide for breaking changes

Examples

See the examples directory for complete working examples.

License

Apache License 2.0. See LICENSE for details.

Using with pytest-bdd

If pytest-bdd is installed alongside qase-pytest, Gherkin scenarios are reported with full step hierarchy automatically — no manual qase.step() instrumentation required.

Feature file

Feature: Login

  @qase.id=42 @qase.suite=Login.Smoke
  Scenario: Successful login
    Given the user is on the login page
    When the user enters valid credentials
    Then the user should see the dashboard

Test module

from pytest_bdd import scenarios

scenarios("features/login.feature")

Scenario name becomes the test title, the Feature becomes the parent suite, each step is captured with its Given/When/Then keyword. You can still use with qase.step("..."): inside a step function to add nested sub-steps — they will appear as children of the Gherkin step.

Recognized scenario tags

Place tags on the Scenario line so they reach the plugin via scenario.tags:

Tag	Effect
`@qase.id=123`	Link to test case 123
`@qase.id=123,124`	Link to multiple test cases
`@qase.project_id.CODE=1,2`	Multi-project link
`@qase.ignore`	Skip the scenario from reporting
`@qase.muted`	Do not let this scenario fail the run
`@qase.suite=A.B.C`	Override suite (dot for nesting)
`@qase.severity=critical`	Set severity field
`@qase.priority=high`	Set priority field
`@qase.layer=e2e`	Set layer field
Any other tag	Stored as a free tag on the result

Versions

Tested with pytest-bdd >= 7.0, < 9.0. pytest-bdd-ng is expected to work but is not officially tested.

Metadata

Release files for qase-pytest 9.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for qase-pytest 9.0.0
File	Size	Uploaded
qase_pytest-9.0.0.tar.gz	28.0 kB	Aug 31, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for qase-pytest 9.0.0
File	Interpreter	ABI	Platform	Reset
qase_pytest-9.0.0-py3-none-any.whl 26.3 kB Aug 31, 2026	Python 3	none	any	Details

Total release size: 54.2 kB

Release files / qase_pytest-9.0.0.tar.gz

Download URL	qase_pytest-9.0.0.tar.gz
Size	28.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`9fa1c669833b67499cf91a0633a1d634ce9a8f1b1c809b3493600a7d003e997b`
BLAKE2b-256 checksum How to use checksums	`a77461306114bc2dc4a25b3b0bcaf14cd71efa921730fb7cac1c5f39049d84be`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / qase_pytest-9.0.0-py3-none-any.whl

Download URL	qase_pytest-9.0.0-py3-none-any.whl
Size	26.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7b3420ab655b877605a1e29905eb6da457f3139b4100b171d24e6ee76d3cd6c9`
BLAKE2b-256 checksum How to use checksums	`20dd78f921277bf51195d510277b3936ac6aabdb26772b9395ea320521f2776e`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`