testrelic-pytest 0.1.1__tar.gz

testrelic_pytest-0.1.1/.gitignore

@@ -0,0 +1,74 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Test/coverage caches
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+.pytest_cache/
+htmlcov/
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+
+# Type/lint caches
+.mypy_cache/
+.ruff_cache/
+.dmypy.json
+dmypy.json
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# TestRelic local state
+.testrelic/
+*.queue.json
+
+# Jupyter
+.ipynb_checkpoints
+
+# Local env
+.env
+.env.local

testrelic_pytest-0.1.1/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to `testrelic-pytest` are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.1] - 2026-05-26
+
+### Fixed
+- Cloud `/api/v1/runs` rejected 0.1.0 batch uploads. The server validator uses
+  Zod's `z.string().datetime()` (Zulu-suffix only) and expects the top-level
+  run `duration` as an integer. Additionally, the per-test `duration` must be
+  sent as an integer too — Zod accepts float per-test (`z.number()`) but a
+  downstream handler returns `500 INTERNAL_ERROR` if it isn't a whole number.
+- Format all timestamps as `...Z` via the new `iso_z()` helper, round run
+  duration, and change `PytestResult.duration` to `int` (rounded to ms in the
+  translator). All discovered via the first staging smoke test against
+  `https://stage.testrelic.ai/api/v1`.
+
+## [0.1.0] - 2026-05-25
+
+### Added
+- Initial release.
+- pytest11 plugin that captures generic pytest test outcomes and uploads to the
+  TestRelic AI cloud via `POST /api/v1/runs` (batch) or the realtime
+  `runs/init` → `runs/{id}/tests` → `runs/{id}/finalize` triplet.
+- Outcome translation for `passed`, `failed`, `skipped`, `xfailed`, `xpassed`,
+  and setup/teardown `error`.
+- Capture of markers, parametrize ids, keywords, warnings, and skip reasons.
+- Captured stdout/stderr/log embedded inline with redaction and truncation
+  (artifact promotion for large streams is planned for v0.2).
+- `pytest-xdist` controller aggregation — workers forward reports through the
+  built-in xdist channel; only the controller uploads.
+- `testrelic-pytest drain` CLI for replaying the offline queue.

testrelic_pytest-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TestRelic AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

testrelic_pytest-0.1.1/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: testrelic-pytest
+Version: 0.1.1
+Summary: Generic pytest reporter that uploads test results to the TestRelic AI cloud platform.
+Project-URL: Homepage, https://testrelic.ai
+Project-URL: Documentation, https://docs.testrelic.ai/pytest
+Project-URL: Repository, https://github.com/testrelic-ai/testrelic-python-sdk
+Project-URL: Bug Tracker, https://github.com/testrelic-ai/testrelic-python-sdk/issues
+Author-email: TestRelic AI <hello@testrelic.ai>
+License: MIT
+License-File: LICENSE
+Keywords: analytics,ci,observability,pytest,reporter,test,test-automation,test-results,testing,testrelic
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.9
+Requires-Dist: httpx<1.0,>=0.27
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: pydantic<3.0,>=2.6
+Requires-Dist: pytest>=7.0
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Requires-Dist: typer<1.0,>=0.12
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.5; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: twine>=5.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# testrelic-pytest
+
+[![PyPI](https://img.shields.io/pypi/v/testrelic-pytest.svg)](https://pypi.org/project/testrelic-pytest/)
+
+Generic [pytest](https://docs.pytest.org/) reporter that ships your test results
+to the [TestRelic AI](https://testrelic.ai/) cloud platform. Works with any
+pytest project — unit tests, API tests, integration tests — and stays out of the
+way when no API key is configured.
+
+## Install
+
+```bash
+pip install testrelic-pytest
+```
+
+The plugin auto-registers via the `pytest11` entry point. Nothing to import.
+
+## Configure
+
+```bash
+export TESTRELIC_API_KEY=tr_live_...
+pytest
+```
+
+The plugin silently no-ops when `TESTRELIC_API_KEY` is unset, so it is safe to
+add to any project.
+
+### Options
+
+All options can be set via CLI flag, environment variable, or a JSON file at
+`.testrelic/testrelic-config.json`. Precedence (highest first):
+**CLI flag → environment → JSON file → defaults**.
+
+CLI flags use a `--testrelic-pytest-*` prefix so they don't collide with the
+`testrelic-playwright` plugin if both are installed.
+
+| CLI flag | Env var | Default | Purpose |
+|---|---|---|---|
+| `--testrelic-pytest-disable` | `TESTRELIC_DISABLE=1` | off | Force-disable the plugin. |
+| `--testrelic-pytest-api-key VALUE` | `TESTRELIC_API_KEY` | — | API key from the TestRelic dashboard. |
+| `--testrelic-pytest-endpoint URL` | `TESTRELIC_CLOUD_ENDPOINT` | `https://platform.testrelic.ai/api/v1` | Cloud base URL. |
+| `--testrelic-pytest-upload-strategy {batch,realtime,both,none}` | `TESTRELIC_UPLOAD_STRATEGY` | `batch` | When to send results. |
+| `--testrelic-pytest-quiet` | `TESTRELIC_QUIET=1` | off | Suppress banner output. |
+| `--testrelic-pytest-run-type {smoke,regression,nightly,ci}` | `TESTRELIC_RUN_TYPE` | — | Dashboard bucket. |
+| `--testrelic-pytest-project-name NAME` | `TESTRELIC_PROJECT_NAME` | git remote or pyproject name | Stable project identity. |
+| `--testrelic-pytest-artifact-threshold-kb N` | — | 32 | Captured output beyond N KB is truncated inline. |
+| `--testrelic-pytest-output PATH` | — | — | Optional JSON dump for debugging. |
+
+### Config file (`.testrelic/testrelic-config.json`)
+
+```json
+{
+  "apiKey": "$TESTRELIC_API_KEY",
+  "endpoint": "https://platform.testrelic.ai/api/v1",
+  "upload": "batch",
+  "projectName": "my-suite",
+  "artifactThresholdKb": 32,
+  "uploadArtifacts": true,
+  "queueDirectory": ".testrelic/queue",
+  "metadata": { "team": "platform" }
+}
+```
+
+`$ENV_VAR` strings are expanded against the process environment at startup.
+
+## What gets captured
+
+For each test the plugin captures:
+
+- `nodeId`, `file`, `className`, `testName`, `parametrizeId`
+- Outcome: `passed | failed | skipped | xfailed | xpassed | error`
+- Duration (ms) and per-phase breakdown (setup/call/teardown)
+- Markers (e.g. `@pytest.mark.smoke`), keywords, parametrize ids
+- Skip reasons and pytest warnings
+- Failure tracebacks and assertion repr
+- Captured stdout / stderr / caplog (inline with redaction; truncated above
+  `--testrelic-artifact-threshold-kb`, hard cap 1 MB per stream — artifact
+  upload for large streams is planned for v0.2)
+
+Test runs include CI metadata auto-detected from GitHub Actions, GitLab CI,
+Jenkins, and CircleCI, plus git branch/commit/author from the working tree.
+
+## pytest-xdist
+
+Parallel runs via `pytest-xdist` (`pytest -n 4`) are supported out of the box.
+Each worker forwards its `TestReport` objects through the xdist channel; only
+the controller node uploads. The result is exactly one cloud run with all tests
+aggregated.
+
+## Offline mode
+
+Any upload that fails after retries is written to `~/.testrelic/queue/` as a
+JSON file. Re-run later:
+
+```bash
+testrelic-pytest drain
+```
+
+The drainer re-authenticates with `TESTRELIC_API_KEY` and replays each entry to
+its original endpoint.
+
+## See also
+
+- [`testrelic-deepeval`](https://pypi.org/project/testrelic-deepeval/) — DeepEval / LLM evaluation bridge
+- [`testrelic-playwright`](https://pypi.org/project/testrelic-playwright/) — Playwright reporter for pytest

testrelic_pytest-0.1.1/README.md

@@ -0,0 +1,105 @@
+# testrelic-pytest
+
+[![PyPI](https://img.shields.io/pypi/v/testrelic-pytest.svg)](https://pypi.org/project/testrelic-pytest/)
+
+Generic [pytest](https://docs.pytest.org/) reporter that ships your test results
+to the [TestRelic AI](https://testrelic.ai/) cloud platform. Works with any
+pytest project — unit tests, API tests, integration tests — and stays out of the
+way when no API key is configured.
+
+## Install
+
+```bash
+pip install testrelic-pytest
+```
+
+The plugin auto-registers via the `pytest11` entry point. Nothing to import.
+
+## Configure
+
+```bash
+export TESTRELIC_API_KEY=tr_live_...
+pytest
+```
+
+The plugin silently no-ops when `TESTRELIC_API_KEY` is unset, so it is safe to
+add to any project.
+
+### Options
+
+All options can be set via CLI flag, environment variable, or a JSON file at
+`.testrelic/testrelic-config.json`. Precedence (highest first):
+**CLI flag → environment → JSON file → defaults**.
+
+CLI flags use a `--testrelic-pytest-*` prefix so they don't collide with the
+`testrelic-playwright` plugin if both are installed.
+
+| CLI flag | Env var | Default | Purpose |
+|---|---|---|---|
+| `--testrelic-pytest-disable` | `TESTRELIC_DISABLE=1` | off | Force-disable the plugin. |
+| `--testrelic-pytest-api-key VALUE` | `TESTRELIC_API_KEY` | — | API key from the TestRelic dashboard. |
+| `--testrelic-pytest-endpoint URL` | `TESTRELIC_CLOUD_ENDPOINT` | `https://platform.testrelic.ai/api/v1` | Cloud base URL. |
+| `--testrelic-pytest-upload-strategy {batch,realtime,both,none}` | `TESTRELIC_UPLOAD_STRATEGY` | `batch` | When to send results. |
+| `--testrelic-pytest-quiet` | `TESTRELIC_QUIET=1` | off | Suppress banner output. |
+| `--testrelic-pytest-run-type {smoke,regression,nightly,ci}` | `TESTRELIC_RUN_TYPE` | — | Dashboard bucket. |
+| `--testrelic-pytest-project-name NAME` | `TESTRELIC_PROJECT_NAME` | git remote or pyproject name | Stable project identity. |
+| `--testrelic-pytest-artifact-threshold-kb N` | — | 32 | Captured output beyond N KB is truncated inline. |
+| `--testrelic-pytest-output PATH` | — | — | Optional JSON dump for debugging. |
+
+### Config file (`.testrelic/testrelic-config.json`)
+
+```json
+{
+  "apiKey": "$TESTRELIC_API_KEY",
+  "endpoint": "https://platform.testrelic.ai/api/v1",
+  "upload": "batch",
+  "projectName": "my-suite",
+  "artifactThresholdKb": 32,
+  "uploadArtifacts": true,
+  "queueDirectory": ".testrelic/queue",
+  "metadata": { "team": "platform" }
+}
+```
+
+`$ENV_VAR` strings are expanded against the process environment at startup.
+
+## What gets captured
+
+For each test the plugin captures:
+
+- `nodeId`, `file`, `className`, `testName`, `parametrizeId`
+- Outcome: `passed | failed | skipped | xfailed | xpassed | error`
+- Duration (ms) and per-phase breakdown (setup/call/teardown)
+- Markers (e.g. `@pytest.mark.smoke`), keywords, parametrize ids
+- Skip reasons and pytest warnings
+- Failure tracebacks and assertion repr
+- Captured stdout / stderr / caplog (inline with redaction; truncated above
+  `--testrelic-artifact-threshold-kb`, hard cap 1 MB per stream — artifact
+  upload for large streams is planned for v0.2)
+
+Test runs include CI metadata auto-detected from GitHub Actions, GitLab CI,
+Jenkins, and CircleCI, plus git branch/commit/author from the working tree.
+
+## pytest-xdist
+
+Parallel runs via `pytest-xdist` (`pytest -n 4`) are supported out of the box.
+Each worker forwards its `TestReport` objects through the xdist channel; only
+the controller node uploads. The result is exactly one cloud run with all tests
+aggregated.
+
+## Offline mode
+
+Any upload that fails after retries is written to `~/.testrelic/queue/` as a
+JSON file. Re-run later:
+
+```bash
+testrelic-pytest drain
+```
+
+The drainer re-authenticates with `TESTRELIC_API_KEY` and replays each entry to
+its original endpoint.
+
+## See also
+
+- [`testrelic-deepeval`](https://pypi.org/project/testrelic-deepeval/) — DeepEval / LLM evaluation bridge
+- [`testrelic-playwright`](https://pypi.org/project/testrelic-playwright/) — Playwright reporter for pytest

testrelic_pytest-0.1.1/pyproject.toml

@@ -0,0 +1,108 @@
+[build-system]
+requires = ["hatchling>=1.21"]
+build-backend = "hatchling.build"
+
+[project]
+name = "testrelic-pytest"
+dynamic = ["version"]
+description = "Generic pytest reporter that uploads test results to the TestRelic AI cloud platform."
+readme = "README.md"
+license = { text = "MIT" }
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+authors = [{ name = "TestRelic AI", email = "hello@testrelic.ai" }]
+keywords = [
+  "pytest",
+  "test",
+  "analytics",
+  "reporter",
+  "test-results",
+  "testrelic",
+  "ci",
+  "testing",
+  "test-automation",
+  "observability",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Framework :: Pytest",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Testing",
+  "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+  "pytest>=7.0",
+  "httpx>=0.27,<1.0",
+  "pydantic>=2.6,<3.0",
+  "typer>=0.12,<1.0",
+  "platformdirs>=4.0",
+  "tomli>=2.0; python_version<'3.11'",
+  "tomli-w>=1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest-cov>=5.0",
+  "pytest-xdist>=3.5",
+  "respx>=0.21",
+  "ruff>=0.6",
+  "mypy>=1.10",
+  "build>=1.2",
+  "twine>=5.1",
+]
+
+[project.urls]
+Homepage = "https://testrelic.ai"
+Documentation = "https://docs.testrelic.ai/pytest"
+Repository = "https://github.com/testrelic-ai/testrelic-python-sdk"
+"Bug Tracker" = "https://github.com/testrelic-ai/testrelic-python-sdk/issues"
+
+[project.scripts]
+testrelic-pytest = "testrelic_pytest.cli:app"
+
+[project.entry-points.pytest11]
+testrelic_pytest = "testrelic_pytest.plugin"
+
+[tool.hatch.version]
+path = "src/testrelic_pytest/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/testrelic_pytest"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "src/testrelic_pytest",
+  "README.md",
+  "LICENSE",
+  "CHANGELOG.md",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "RUF"]
+ignore = [
+  "E501",     # line length handled by formatter, not lint
+  "UP006",    # keep `Dict[]`/`List[]` for parity with the other packages
+  "UP007",    # keep `Optional[X]` / `Union[X, Y]` until we drop py39 runtime support
+  "UP045",    # keep `Optional[X]` (PEP 604 ban for runtime hints on py39)
+  "B008",     # typer Option/Argument call in default is idiomatic
+]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v --tb=short -p no:testrelic_pytest"

testrelic_pytest-0.1.1/src/testrelic_pytest/__init__.py

@@ -0,0 +1,35 @@
+"""TestRelic generic pytest reporter — pytest plugin and helpers."""
+
+from __future__ import annotations
+
+from testrelic_pytest._version import __version__
+from testrelic_pytest.config import (
+    CloudConfig,
+    PytestPluginConfig,
+    resolve_config,
+)
+from testrelic_pytest.schema import (
+    CapturedOutput,
+    CIMetadata,
+    FailureDiagnostic,
+    PhaseResult,
+    PytestResult,
+    PytestRunReport,
+    Status,
+    Summary,
+)
+
+__all__ = [
+    "CIMetadata",
+    "CapturedOutput",
+    "CloudConfig",
+    "FailureDiagnostic",
+    "PhaseResult",
+    "PytestPluginConfig",
+    "PytestResult",
+    "PytestRunReport",
+    "Status",
+    "Summary",
+    "__version__",
+    "resolve_config",
+]

testrelic_pytest-0.1.1/src/testrelic_pytest/_version.py

@@ -0,0 +1 @@
+__version__ = "0.1.1"

testrelic_pytest-0.1.1/src/testrelic_pytest/ci_detector.py

@@ -0,0 +1,102 @@
+"""Detect CI provider and pull build metadata from environment variables."""
+
+from __future__ import annotations
+
+import os
+from typing import Optional
+
+from testrelic_pytest.schema import CIMetadata
+
+
+def detect_ci() -> Optional[CIMetadata]:
+    """Return a populated `CIMetadata` if we recognise the CI provider."""
+    env = os.environ
+
+    if env.get("GITHUB_ACTIONS") == "true":
+        return CIMetadata(
+            provider="github-actions",
+            buildId=env.get("GITHUB_RUN_ID"),
+            commitSha=env.get("GITHUB_SHA"),
+            branch=env.get("GITHUB_REF_NAME"),
+            prNumber=_extract_pr_number(env.get("GITHUB_REF")),
+            workflow=env.get("GITHUB_WORKFLOW"),
+            runUrl=_github_run_url(dict(env)),
+        )
+
+    if env.get("GITLAB_CI") == "true":
+        return CIMetadata(
+            provider="gitlab-ci",
+            buildId=env.get("CI_PIPELINE_ID"),
+            commitSha=env.get("CI_COMMIT_SHA"),
+            branch=env.get("CI_COMMIT_REF_NAME"),
+            prNumber=env.get("CI_MERGE_REQUEST_IID"),
+            workflow=env.get("CI_JOB_NAME"),
+            runUrl=env.get("CI_PIPELINE_URL"),
+        )
+
+    if env.get("JENKINS_URL"):
+        return CIMetadata(
+            provider="jenkins",
+            buildId=env.get("BUILD_ID") or env.get("BUILD_NUMBER"),
+            commitSha=env.get("GIT_COMMIT"),
+            branch=env.get("GIT_BRANCH"),
+            workflow=env.get("JOB_NAME"),
+            runUrl=env.get("BUILD_URL"),
+        )
+
+    if env.get("CIRCLECI") == "true":
+        return CIMetadata(
+            provider="circleci",
+            buildId=env.get("CIRCLE_BUILD_NUM"),
+            commitSha=env.get("CIRCLE_SHA1"),
+            branch=env.get("CIRCLE_BRANCH"),
+            prNumber=_pr_from_url(env.get("CIRCLE_PULL_REQUEST")),
+            workflow=env.get("CIRCLE_JOB"),
+            runUrl=env.get("CIRCLE_BUILD_URL"),
+        )
+
+    if env.get("BITBUCKET_PIPELINE_UUID"):
+        return CIMetadata(
+            provider="bitbucket-pipelines",
+            buildId=env.get("BITBUCKET_BUILD_NUMBER"),
+            commitSha=env.get("BITBUCKET_COMMIT"),
+            branch=env.get("BITBUCKET_BRANCH"),
+            prNumber=env.get("BITBUCKET_PR_ID"),
+            workflow=env.get("BITBUCKET_PIPELINE_UUID"),
+            runUrl=_bitbucket_run_url(dict(env)),
+        )
+
+    return None
+
+
+def _extract_pr_number(ref: Optional[str]) -> Optional[str]:
+    if not ref:
+        return None
+    parts = ref.split("/")
+    if len(parts) >= 3 and parts[1] == "pull":
+        return parts[2]
+    return None
+
+
+def _github_run_url(env: dict[str, str]) -> Optional[str]:
+    server = env.get("GITHUB_SERVER_URL")
+    repo = env.get("GITHUB_REPOSITORY")
+    run = env.get("GITHUB_RUN_ID")
+    if server and repo and run:
+        return f"{server}/{repo}/actions/runs/{run}"
+    return None
+
+
+def _bitbucket_run_url(env: dict[str, str]) -> Optional[str]:
+    workspace = env.get("BITBUCKET_WORKSPACE")
+    repo = env.get("BITBUCKET_REPO_SLUG")
+    build = env.get("BITBUCKET_BUILD_NUMBER")
+    if workspace and repo and build:
+        return f"https://bitbucket.org/{workspace}/{repo}/pipelines/results/{build}"
+    return None
+
+
+def _pr_from_url(url: Optional[str]) -> Optional[str]:
+    if not url:
+        return None
+    return url.rstrip("/").split("/")[-1] or None

testrelic_pytest-0.1.1/src/testrelic_pytest/cli.py

@@ -0,0 +1,59 @@
+"""`testrelic-pytest` CLI."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Optional
+
+import typer
+
+from testrelic_pytest._version import __version__
+
+app = typer.Typer(
+    name="testrelic-pytest",
+    help="TestRelic generic pytest reporter CLI",
+    add_completion=False,
+)
+
+
+@app.command()
+def version() -> None:
+    """Print the package version."""
+    typer.echo(__version__)
+
+
+@app.command(name="drain")
+def drain(
+    queue_dir: Optional[Path] = typer.Option(
+        None,
+        "--queue-dir",
+        help="Override the queue directory. Defaults to .testrelic/queue/.",
+    ),
+) -> None:
+    """Retry queued failed uploads."""
+    from testrelic_pytest.cloud.queue import drain_queue
+
+    counts = drain_queue(queue_dir)
+    typer.echo(json.dumps(counts, indent=2))
+
+
+@app.command()
+def status(
+    queue_dir: Optional[Path] = typer.Option(
+        None,
+        "--queue-dir",
+        help="Queue directory to inspect. Defaults to .testrelic/queue/.",
+    ),
+) -> None:
+    """Show how many uploads are pending replay."""
+    target = Path(queue_dir) if queue_dir else Path(".testrelic") / "queue"
+    if not target.exists():
+        typer.echo(json.dumps({"queued": 0, "queue_dir": str(target)}, indent=2))
+        return
+    queued = len(list(target.glob("*.json")))
+    typer.echo(json.dumps({"queued": queued, "queue_dir": str(target)}, indent=2))
+
+
+if __name__ == "__main__":
+    app()