testtrain-pytest-allure 0.1.0__tar.gz

testtrain_pytest_allure-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+.ruff_cache
+__pycache__/
+*.pyc
+.venv/
+.pytest_cache/
+.mypy_cache/

testtrain_pytest_allure-0.1.0/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: testtrain-pytest-allure
+Version: 0.1.0
+Summary: Pytest plugin that streams Allure test results to Testtrain in real time
+License: MIT
+Requires-Python: >=3.9
+Requires-Dist: allure-pytest>=2.13
+Requires-Dist: allure-python-commons>=2.13
+Requires-Dist: pytest>=7.0
+Requires-Dist: requests>=2.28
+Description-Content-Type: text/markdown
+
+# testtrain-pytest-allure
+
+A pytest plugin that streams [Allure](https://allurereport.org/) test results to [Testtrain](https://github.com/njxqlus/testtrain) in real time using `allure-python-commons` hooks.
+
+Each test result — including steps, parameters, attachments, and defect links — is posted to the Testtrain API immediately after the test finishes, with no file scanning required.
+
+## Installation
+
+```bash
+pip install testtrain-pytest-allure
+```
+
+## Usage
+
+```bash
+pytest \
+  --testtrain-url=http://localhost:3000 \
+  --testtrain-auth-token=your-token \
+  --alluredir=allure-results \
+  --testtrain-run-id=9f68e116-ca4a-470b-9fcf-72a9e39d126d
+```
+
+The plugin activates automatically when all three `--testtrain-*` options are provided.
+
+## Options
+
+| Option | Description |
+|---|---|
+| `--testtrain-url` | Testtrain platform base URL |
+| `--testtrain-auth-token` | Bearer token for API authentication |
+| `--testtrain-run-id` | UUID of an existing testrun to report results to |
+
+## How It Works
+
+The plugin registers a listener into `allure_commons.plugin_manager` that implements the `report_result` hook. When Allure finalises a test (after teardown), the listener:
+
+1. Maps the `TestResult` object (status, steps, parameters, links) to the Testtrain API schema.
+2. Collects any in-memory attachment data captured during the test run.
+3. Sends everything to `POST /api/tests` (JSON or multipart when attachments are present).
+4. Retries up to 3 times on transient errors with exponential back-off.
+5. Stops the test session if all retries fail.
+
+## Development
+
+```bash
+cd plugins/testtrain-pytest-allure
+uv sync
+uv run pytest tests/
+```

testtrain_pytest_allure-0.1.0/README.md

@@ -0,0 +1,49 @@
+# testtrain-pytest-allure
+
+A pytest plugin that streams [Allure](https://allurereport.org/) test results to [Testtrain](https://github.com/njxqlus/testtrain) in real time using `allure-python-commons` hooks.
+
+Each test result — including steps, parameters, attachments, and defect links — is posted to the Testtrain API immediately after the test finishes, with no file scanning required.
+
+## Installation
+
+```bash
+pip install testtrain-pytest-allure
+```
+
+## Usage
+
+```bash
+pytest \
+  --testtrain-url=http://localhost:3000 \
+  --testtrain-auth-token=your-token \
+  --alluredir=allure-results \
+  --testtrain-run-id=9f68e116-ca4a-470b-9fcf-72a9e39d126d
+```
+
+The plugin activates automatically when all three `--testtrain-*` options are provided.
+
+## Options
+
+| Option | Description |
+|---|---|
+| `--testtrain-url` | Testtrain platform base URL |
+| `--testtrain-auth-token` | Bearer token for API authentication |
+| `--testtrain-run-id` | UUID of an existing testrun to report results to |
+
+## How It Works
+
+The plugin registers a listener into `allure_commons.plugin_manager` that implements the `report_result` hook. When Allure finalises a test (after teardown), the listener:
+
+1. Maps the `TestResult` object (status, steps, parameters, links) to the Testtrain API schema.
+2. Collects any in-memory attachment data captured during the test run.
+3. Sends everything to `POST /api/tests` (JSON or multipart when attachments are present).
+4. Retries up to 3 times on transient errors with exponential back-off.
+5. Stops the test session if all retries fail.
+
+## Development
+
+```bash
+cd plugins/testtrain-pytest-allure
+uv sync
+uv run pytest tests/
+```

testtrain_pytest_allure-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "testtrain-pytest-allure"
+version = "0.1.0"
+description = "Pytest plugin that streams Allure test results to Testtrain in real time"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+dependencies = [
+    "pytest>=7.0",
+    "allure-pytest>=2.13",
+    "allure-python-commons>=2.13",
+    "requests>=2.28",
+]
+
+[project.entry-points."pytest11"]
+testtrain-allure = "testtrain_pytest_allure.plugin"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/testtrain_pytest_allure"]
+
+[dependency-groups]
+dev = [
+    "ruff",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]

testtrain_pytest_allure-0.1.0/src/testtrain_pytest_allure/__init__.py

@@ -0,0 +1,5 @@
+"""testtrain-pytest-allure: streams Allure test results to Testtrain in real time."""
+
+from testtrain_pytest_allure.plugin import pytest_addoption, pytest_configure
+
+__all__ = ["pytest_addoption", "pytest_configure"]