qa-insight 1.0.0__tar.gz

qa_insight-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QA Insight
+
+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.

qa_insight-1.0.0/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: qa-insight
+Version: 1.0.0
+Summary: Official QA Insight SDK for Python. Sends test run events (pytest, Robot Framework, behave) to the QA Insight Collector without changing your tests.
+Author-email: QA Insight <qainsight.io@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/QA-Insight/qa-insight
+Project-URL: Repository, https://github.com/QA-Insight/qa-insight
+Project-URL: Bug Tracker, https://github.com/QA-Insight/qa-insight/issues
+Keywords: qa,testing,playwright,selenium,pytest,robot,behave,observability
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: pytest
+Requires-Dist: pytest>=7.0; extra == "pytest"
+Provides-Extra: robot
+Requires-Dist: robotframework>=6.0; extra == "robot"
+Provides-Extra: behave
+Requires-Dist: behave>=1.2.6; extra == "behave"
+Provides-Extra: examples
+Requires-Dist: pytest>=7.0; extra == "examples"
+Requires-Dist: pytest-playwright>=0.4; extra == "examples"
+Requires-Dist: playwright>=1.30; extra == "examples"
+Requires-Dist: selenium>=4.10; extra == "examples"
+Requires-Dist: robotframework>=6.0; extra == "examples"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# qa-insight (Python SDK)
+
+SDK oficial de [QA Insight](https://github.com/QA-Insight/qa-insight) para **Python**.
+
+Envía automáticamente el ciclo de vida de tus pruebas (inicio/fin de ejecución y de tests) al **Collector** de QA Insight, sin modificar tus tests. Compatible con **pytest** (incluido Selenium WebDriver 4 y Playwright), **Robot Framework**, **behave** (BDD) y un **importador de JUnit XML** post-run.
+
+- **Cero dependencias runtime** (solo stdlib: `urllib`, `threading`, `queue`, `subprocess`, `re`). Las integraciones (pytest, robotframework, behave) son dependencias opcionales.
+- Python **3.9+**.
+- Nunca altera el resultado de tus pruebas; si el Collector no responde, registra una advertencia y continúa.
+
+## Instalación
+
+```bash
+pip install -e .            # desde el repo (desarrollo)
+pip install -e ".[examples]" # con pytest + Playwright + Selenium + Robot para los ejemplos
+```
+
+## Configuración por variables de entorno
+
+| Variable | Default | Descripción |
+|---|---|---|
+| `QAI_ENDPOINT` | `http://localhost:3000/collector/v1/events` | URL del Collector de QA Insight |
+| `QAI_API_KEY` | — | API key de QA Insight (proyecto + ambiente) |
+| `QAI_ENABLED` | `true` | `false` desactiva el envío |
+| `QAI_TIMEOUT_MS` | `2000` | Timeout por request HTTP |
+| `QAI_RETRY_MAX` | `3` | Reintentos para errores transitorios (5xx, 429, red) |
+| `QAI_FLUSH_TIMEOUT_MS` | `5000` | Máximo de espera del flush al terminar |
+| `QAI_RUN_NAME` | `python-run-<ts>` | Nombre de la ejecución |
+| `QAI_RUN_ID` | UUID generado | `externalRunId` (idempotencia del run) |
+| `QAI_FRAMEWORK` | `pytest`/`robot`/`behave`/`junit` | Framework reportado a la columna framework |
+| `QAI_BROWSER` | — | Browser/proyecto (chromium, firefox, webkit, chrome, ...) |
+
+## pytest
+
+El plugin se auto-registra (entry point `pytest11`). Solo necesitas las variables de entorno:
+
+```bash
+export QAI_ENDPOINT=http://localhost:3000/collector/v1/events
+export QAI_API_KEY=qai_...
+export QAI_FRAMEWORK=playwright   # o selenium, o pytest
+pytest
+```
+
+- `pytest_sessionstart` → `RUN_STARTED`
+- Cada test → `TEST_STARTED` / `TEST_FINISHED` (con `retryIndex` si usás `pytest-rerunfailures`)
+- `pytest_sessionfinish` → `RUN_FINISHED`
+- Los tests parametrizados generan nodeids únicos → no colapsan en el backend.
+
+Para reportar el browser por test (badges de browser en la UI), setealos en un `conftest.py`:
+
+```python
+# conftest.py (Playwright)
+import pytest
+from qa_insight import QaiContext
+
+@pytest.fixture(autouse=True)
+def qai_browser(browser):
+    QaiContext.set_browser(browser.browser_type.name)
+```
+
+```python
+# conftest.py (Selenium 4)
+import pytest
+from qa_insight import QaiContext
+
+@pytest.fixture
+def driver():
+    from selenium import webdriver
+    d = webdriver.Chrome()  # Selenium Manager descarga el driver automáticamente
+    QaiContext.set_webdriver(d)
+    yield d
+    d.quit()
+```
+
+El plugin resuelve el browser en este orden: `QaiContext.browser` → `QAI_BROWSER` → capabilities del `QaiContext.webdriver`.
+
+### Cross-browser
+
+- **Playwright**: `pytest --browser chromium --browser firefox --browser webkit` (cada browser genera su ejecución con sus badges).
+- **Selenium 4**: `pytest --selenium-browser chrome` / `pytest --selenium-browser firefox` (ver ejemplo).
+- **Robot Framework**: exporta `QAI_BROWSER=chrome|firefox` al correr con `--variable BROWSER:...`.
+
+## Robot Framework
+
+El SDK incluye un **library listener** (`QaiInsightLibrary`) que se auto-registra, de modo que no hace falta
+pasar `--listener` en la línea de comandos. Solo importá la librería (idealmente en un resource compartido):
+
+```robotframework
+*** Settings ***
+Library    qa_insight.robot_library.QaiInsightLibrary
+```
+
+Al importarse, la librería carga el `.env` del proyecto, emite `RUN_STARTED`, registra el listener para
+toda la ejecución (tags, suites, tests específicos o archivos individuales) y, al terminar, emite
+`RUN_FINISHED` de forma garantizada vía su método `close()`.
+
+Configuración vía `.env` (sin necesidad de `export`):
+
+```bash
+QAI_API_KEY=qai_...
+QAI_ENDPOINT=http://localhost:3000/collector/v1/events
+QAI_FRAMEWORK=robot
+QAI_BROWSER=chrome   # opcional: badges de browser + Open Browser de SeleniumLibrary
+HEADLESS=True        # opcional: modo headless/visible del navegador
+```
+
+Ejecutá tus tests como siempre:
+
+```bash
+robot tests/                     # todo
+robot --include smoke tests/     # por tags
+robot --suite my_suite tests/    # por suite
+robot --test "my test" tests/    # por test
+```
+
+> Alternativa (CLI listener): `robot --listener qa_insight.robot_listener.QaiInsightListener tests/`
+
+## behave (BDD)
+
+```python
+# features/environment.py
+from qa_insight.behave_env import *  # noqa
+```
+
+## Importador de JUnit XML (post-run)
+
+```bash
+export QAI_API_KEY=qai_...
+qa-insight-import junit.xml --framework pytest
+# o para cualquier framework que emita JUnit XML
+```
+
+## Uso manual / sin runner
+
+```python
+from qa_insight import QaiInsight
+
+insight = QaiInsight({"api_key": "qai_...", "framework": "selenium"})
+insight.start_run()
+insight.start_test("test_login", suite="tests/test_auth.py")
+insight.finish_test("test_login", suite="tests/test_auth.py", status="PASSED", duration_ms=1200)
+insight.finish_run()
+```
+
+## Comportamiento ante fallos de red
+
+- Buffer no bloqueante en un hilo de fondo + flush acotado (`QAI_FLUSH_TIMEOUT_MS`) al terminar.
+- Errores transitorios (timeout, red, 5xx, 429) se reintentan con backoff exponencial (50 ms·2^n, cap 1 s).
+- Errores permanentes (4xx) no se reintentan.
+- La API key **nunca** se imprime ni se incluye en los payloads; `errorMessage`/`stacktrace` se redactan antes de enviar (authorization, bearer, cookie, password, secret, api-key, token, `qai_`, `xox*` + literales custom).
+- Payload limitado a 100 KB (se trunca el stacktrace si excede).
+
+## Desarrollo
+
+```bash
+pip install -e ".[dev]"
+ruff check src tests
+pytest
+```
+
+## Licencia
+
+MIT

qa_insight-1.0.0/README.md

@@ -0,0 +1,163 @@
+# qa-insight (Python SDK)
+
+SDK oficial de [QA Insight](https://github.com/QA-Insight/qa-insight) para **Python**.
+
+Envía automáticamente el ciclo de vida de tus pruebas (inicio/fin de ejecución y de tests) al **Collector** de QA Insight, sin modificar tus tests. Compatible con **pytest** (incluido Selenium WebDriver 4 y Playwright), **Robot Framework**, **behave** (BDD) y un **importador de JUnit XML** post-run.
+
+- **Cero dependencias runtime** (solo stdlib: `urllib`, `threading`, `queue`, `subprocess`, `re`). Las integraciones (pytest, robotframework, behave) son dependencias opcionales.
+- Python **3.9+**.
+- Nunca altera el resultado de tus pruebas; si el Collector no responde, registra una advertencia y continúa.
+
+## Instalación
+
+```bash
+pip install -e .            # desde el repo (desarrollo)
+pip install -e ".[examples]" # con pytest + Playwright + Selenium + Robot para los ejemplos
+```
+
+## Configuración por variables de entorno
+
+| Variable | Default | Descripción |
+|---|---|---|
+| `QAI_ENDPOINT` | `http://localhost:3000/collector/v1/events` | URL del Collector de QA Insight |
+| `QAI_API_KEY` | — | API key de QA Insight (proyecto + ambiente) |
+| `QAI_ENABLED` | `true` | `false` desactiva el envío |
+| `QAI_TIMEOUT_MS` | `2000` | Timeout por request HTTP |
+| `QAI_RETRY_MAX` | `3` | Reintentos para errores transitorios (5xx, 429, red) |
+| `QAI_FLUSH_TIMEOUT_MS` | `5000` | Máximo de espera del flush al terminar |
+| `QAI_RUN_NAME` | `python-run-<ts>` | Nombre de la ejecución |
+| `QAI_RUN_ID` | UUID generado | `externalRunId` (idempotencia del run) |
+| `QAI_FRAMEWORK` | `pytest`/`robot`/`behave`/`junit` | Framework reportado a la columna framework |
+| `QAI_BROWSER` | — | Browser/proyecto (chromium, firefox, webkit, chrome, ...) |
+
+## pytest
+
+El plugin se auto-registra (entry point `pytest11`). Solo necesitas las variables de entorno:
+
+```bash
+export QAI_ENDPOINT=http://localhost:3000/collector/v1/events
+export QAI_API_KEY=qai_...
+export QAI_FRAMEWORK=playwright   # o selenium, o pytest
+pytest
+```
+
+- `pytest_sessionstart` → `RUN_STARTED`
+- Cada test → `TEST_STARTED` / `TEST_FINISHED` (con `retryIndex` si usás `pytest-rerunfailures`)
+- `pytest_sessionfinish` → `RUN_FINISHED`
+- Los tests parametrizados generan nodeids únicos → no colapsan en el backend.
+
+Para reportar el browser por test (badges de browser en la UI), setealos en un `conftest.py`:
+
+```python
+# conftest.py (Playwright)
+import pytest
+from qa_insight import QaiContext
+
+@pytest.fixture(autouse=True)
+def qai_browser(browser):
+    QaiContext.set_browser(browser.browser_type.name)
+```
+
+```python
+# conftest.py (Selenium 4)
+import pytest
+from qa_insight import QaiContext
+
+@pytest.fixture
+def driver():
+    from selenium import webdriver
+    d = webdriver.Chrome()  # Selenium Manager descarga el driver automáticamente
+    QaiContext.set_webdriver(d)
+    yield d
+    d.quit()
+```
+
+El plugin resuelve el browser en este orden: `QaiContext.browser` → `QAI_BROWSER` → capabilities del `QaiContext.webdriver`.
+
+### Cross-browser
+
+- **Playwright**: `pytest --browser chromium --browser firefox --browser webkit` (cada browser genera su ejecución con sus badges).
+- **Selenium 4**: `pytest --selenium-browser chrome` / `pytest --selenium-browser firefox` (ver ejemplo).
+- **Robot Framework**: exporta `QAI_BROWSER=chrome|firefox` al correr con `--variable BROWSER:...`.
+
+## Robot Framework
+
+El SDK incluye un **library listener** (`QaiInsightLibrary`) que se auto-registra, de modo que no hace falta
+pasar `--listener` en la línea de comandos. Solo importá la librería (idealmente en un resource compartido):
+
+```robotframework
+*** Settings ***
+Library    qa_insight.robot_library.QaiInsightLibrary
+```
+
+Al importarse, la librería carga el `.env` del proyecto, emite `RUN_STARTED`, registra el listener para
+toda la ejecución (tags, suites, tests específicos o archivos individuales) y, al terminar, emite
+`RUN_FINISHED` de forma garantizada vía su método `close()`.
+
+Configuración vía `.env` (sin necesidad de `export`):
+
+```bash
+QAI_API_KEY=qai_...
+QAI_ENDPOINT=http://localhost:3000/collector/v1/events
+QAI_FRAMEWORK=robot
+QAI_BROWSER=chrome   # opcional: badges de browser + Open Browser de SeleniumLibrary
+HEADLESS=True        # opcional: modo headless/visible del navegador
+```
+
+Ejecutá tus tests como siempre:
+
+```bash
+robot tests/                     # todo
+robot --include smoke tests/     # por tags
+robot --suite my_suite tests/    # por suite
+robot --test "my test" tests/    # por test
+```
+
+> Alternativa (CLI listener): `robot --listener qa_insight.robot_listener.QaiInsightListener tests/`
+
+## behave (BDD)
+
+```python
+# features/environment.py
+from qa_insight.behave_env import *  # noqa
+```
+
+## Importador de JUnit XML (post-run)
+
+```bash
+export QAI_API_KEY=qai_...
+qa-insight-import junit.xml --framework pytest
+# o para cualquier framework que emita JUnit XML
+```
+
+## Uso manual / sin runner
+
+```python
+from qa_insight import QaiInsight
+
+insight = QaiInsight({"api_key": "qai_...", "framework": "selenium"})
+insight.start_run()
+insight.start_test("test_login", suite="tests/test_auth.py")
+insight.finish_test("test_login", suite="tests/test_auth.py", status="PASSED", duration_ms=1200)
+insight.finish_run()
+```
+
+## Comportamiento ante fallos de red
+
+- Buffer no bloqueante en un hilo de fondo + flush acotado (`QAI_FLUSH_TIMEOUT_MS`) al terminar.
+- Errores transitorios (timeout, red, 5xx, 429) se reintentan con backoff exponencial (50 ms·2^n, cap 1 s).
+- Errores permanentes (4xx) no se reintentan.
+- La API key **nunca** se imprime ni se incluye en los payloads; `errorMessage`/`stacktrace` se redactan antes de enviar (authorization, bearer, cookie, password, secret, api-key, token, `qai_`, `xox*` + literales custom).
+- Payload limitado a 100 KB (se trunca el stacktrace si excede).
+
+## Desarrollo
+
+```bash
+pip install -e ".[dev]"
+ruff check src tests
+pytest
+```
+
+## Licencia
+
+MIT

qa_insight-1.0.0/pyproject.toml

@@ -0,0 +1,72 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "qa-insight"
+version = "1.0.0"
+description = "Official QA Insight SDK for Python. Sends test run events (pytest, Robot Framework, behave) to the QA Insight Collector without changing your tests."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "QA Insight", email = "qainsight.io@gmail.com" }]
+keywords = ["qa", "testing", "playwright", "selenium", "pytest", "robot", "behave", "observability"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Quality Assurance",
+  "Topic :: Software Development :: Testing",
+]
+dependencies = []
+
+[project.optional-dependencies]
+pytest = ["pytest>=7.0"]
+robot = ["robotframework>=6.0"]
+behave = ["behave>=1.2.6"]
+examples = [
+  "pytest>=7.0",
+  "pytest-playwright>=0.4",
+  "playwright>=1.30",
+  "selenium>=4.10",
+  "robotframework>=6.0",
+]
+dev = [
+  "pytest>=7.0",
+  "ruff>=0.4",
+  "build>=1.0",
+  "twine>=5.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/QA-Insight/qa-insight"
+Repository = "https://github.com/QA-Insight/qa-insight"
+"Bug Tracker" = "https://github.com/QA-Insight/qa-insight/issues"
+
+[project.entry-points.pytest11]
+qa-insight = "qa_insight.pytest_plugin"
+
+[project.scripts]
+qa-insight-import = "qa_insight.junit_importer:main"
+qa-insight-synthesize = "qa_insight.synthesize:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 110
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"

qa_insight-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

qa_insight-1.0.0/src/qa_insight/__init__.py

@@ -0,0 +1,18 @@
+from .client import QaiClient
+from .config import QaiConfig, resolve_config
+from .dotenv import load_dotenv
+from .insight import QaiContext, QaiInsight
+from .redact import build_redactor
+from .robot_library import QaiInsightLibrary
+
+__all__ = [
+    "QaiClient",
+    "QaiConfig",
+    "QaiContext",
+    "QaiInsight",
+    "QaiInsightLibrary",
+    "build_redactor",
+    "load_dotenv",
+    "resolve_config",
+]
+__version__ = "1.0.0"

qa_insight-1.0.0/src/qa_insight/behave_env.py

@@ -0,0 +1,68 @@
+"""behave hooks.
+
+Import this module from your ``environment.py``:
+
+    from qa_insight.behave_env import *  # noqa
+
+or copy the hooks into your own ``environment.py``.
+"""
+
+from __future__ import annotations
+
+import time
+
+from .insight import QaiInsight
+from .types import QaiTestStatus
+
+_DEFAULT_FRAMEWORK = "behave"
+
+_insight: QaiInsight | None = None
+
+_STATUS = {
+    "passed": QaiTestStatus.PASSED.value,
+    "failed": QaiTestStatus.FAILED.value,
+    "skipped": QaiTestStatus.SKIPPED.value,
+}
+
+_started_at: float | None = None
+
+
+def before_all(context) -> None:
+    global _insight
+    _insight = QaiInsight({"framework": _DEFAULT_FRAMEWORK})
+    _insight.start_run()
+
+
+def before_scenario(context, scenario) -> None:
+    global _insight, _started_at
+    if _insight is None:
+        return
+    feature = getattr(scenario, "feature", None)
+    _started_at = time.time()
+    _insight.start_test(scenario.name, suite=getattr(feature, "name", None) or None, started_at=_started_at)
+
+
+def after_scenario(context, scenario) -> None:
+    global _insight
+    if _insight is None:
+        return
+    feature = getattr(scenario, "feature", None)
+    duration_ms = int((getattr(scenario, "duration", 0) or 0) * 1000)
+    # behave >= 1.3 exposes scenario.status as an IntEnum (Status.passed);
+    # fall back to a plain string for older versions.
+    status_value = getattr(scenario.status, "name", None) or scenario.status
+    status = _STATUS.get(status_value, QaiTestStatus.ABORTED.value)
+    _insight.finish_test(
+        scenario.name,
+        suite=getattr(feature, "name", None) or None,
+        status=status,
+        duration_ms=duration_ms,
+        started_at=_started_at,
+    )
+
+
+def after_all(context) -> None:
+    global _insight
+    if _insight is not None:
+        _insight.finish_run()
+        _insight = None

qa_insight-1.0.0/src/qa_insight/ci.py

@@ -0,0 +1,68 @@
+from __future__ import annotations
+
+import os
+
+
+def _env(name: str) -> str | None:
+    value = os.environ.get(name)
+    return value if value and len(value) > 0 else None
+
+
+def _github_actions() -> dict[str, str | None]:
+    server = _env("GITHUB_SERVER_URL") or "https://github.com"
+    repo = _env("GITHUB_REPOSITORY")
+    run_id = _env("GITHUB_RUN_ID")
+    pipeline_url = f"{server}/{repo}/actions/runs/{run_id}" if repo and run_id else None
+    return {
+        "provider": "github-actions",
+        "branch": _env("GITHUB_HEAD_REF") or _env("GITHUB_REF_NAME"),
+        "commitSha": _env("GITHUB_SHA"),
+        "pipelineUrl": pipeline_url,
+        "runId": run_id,
+        "buildId": _env("GITHUB_RUN_ATTEMPT"),
+    }
+
+
+def _gitlab_ci() -> dict[str, str | None]:
+    return {
+        "provider": "gitlab-ci",
+        "branch": _env("CI_COMMIT_BRANCH") or _env("CI_COMMIT_REF_NAME"),
+        "commitSha": _env("CI_COMMIT_SHA"),
+        "pipelineUrl": _env("CI_PIPELINE_URL") or _env("CI_JOB_URL"),
+        "runId": _env("CI_PIPELINE_ID") or _env("CI_JOB_ID"),
+        "buildId": _env("CI_JOB_ID"),
+    }
+
+
+def _jenkins() -> dict[str, str | None]:
+    return {
+        "provider": "jenkins",
+        "branch": _env("BRANCH_NAME") or _env("GIT_BRANCH"),
+        "commitSha": _env("GIT_COMMIT"),
+        "pipelineUrl": _env("BUILD_URL"),
+        "runId": _env("BUILD_NUMBER"),
+        "buildId": _env("BUILD_ID") or _env("BUILD_NUMBER"),
+    }
+
+
+def _azure_devops() -> dict[str, str | None]:
+    return {
+        "provider": "azure-pipelines",
+        "branch": _env("BUILD_SOURCEBRANCH"),
+        "commitSha": _env("BUILD_SOURCEVERSION"),
+        "pipelineUrl": _env("BUILD_BUILDURI"),
+        "runId": _env("BUILD_BUILDID"),
+        "buildId": _env("BUILD_BUILDID"),
+    }
+
+
+def detect_ci() -> dict[str, str | None]:
+    if _env("GITHUB_ACTIONS") == "true":
+        return _github_actions()
+    if _env("GITLAB_CI") == "true":
+        return _gitlab_ci()
+    if _env("JENKINS_URL") or _env("JENKINS_HOME"):
+        return _jenkins()
+    if _env("TF_BUILD") in ("True", "true"):
+        return _azure_devops()
+    return {}