pytest-dag 3.0.0__tar.gz

pytest_dag-3.0.0/LICENSE

@@ -0,0 +1,44 @@
+Copyright (c) 2026 SLR Software Solutions Inc. All rights reserved.
+
+PYTEST-DAG PROPRIETARY SOFTWARE LICENSE
+
+1. GRANT OF USE
+   Subject to the terms of this License, the copyright holder grants you
+   a non-exclusive, non-transferable, revocable right to install and use
+   this software ("pytest-dag") solely in its unmodified, distributed form
+   for your own internal testing and development purposes.
+
+2. RESTRICTIONS
+   You may NOT, under any circumstances:
+   a) Modify, adapt, translate, or create derivative works of this software,
+      in whole or in part, whether for internal or external use;
+   b) Redistribute, sublicense, sell, rent, lease, or otherwise transfer
+      this software or any portion of it to any third party;
+   c) Remove, alter, or obscure any copyright, trademark, or proprietary
+      notice contained in this software;
+   d) Use this software to build a competing product or service;
+   e) Reverse-engineer the software beyond what is permitted by applicable law.
+
+3. NO IMPLIED RIGHTS
+   No rights are granted except those expressly stated in Section 1.
+   All other rights are reserved by the copyright holder.
+
+4. TERMINATION
+   This License is effective until terminated. Your rights under this
+   License will terminate automatically without notice if you fail to
+   comply with any of its terms. Upon termination you must destroy all
+   copies of the software in your possession.
+
+5. DISCLAIMER OF WARRANTIES
+   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 NON-INFRINGEMENT.
+   IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES,
+   OR OTHER LIABILITY ARISING FROM THE USE OF THIS SOFTWARE.
+
+6. GOVERNING LAW
+   This License shall be governed by the laws of the jurisdiction in which
+   the copyright holder resides, without regard to conflict-of-law principles.
+
+For licensing inquiries, commercial use, or enterprise plans:
+  support@slrsoft.ca

pytest_dag-3.0.0/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: pytest-dag
+Version: 3.0.0
+Summary: A pytest plugin that enforces test execution order via a dependency DAG
+Author-email: "SLR Software Solutions Inc." <support@slrsoft.ca>
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://github.com/SLR-Software-Solutions-Inc/pytest-dag
+Project-URL: Bug Tracker, https://github.com/SLR-Software-Solutions-Inc/pytest-dag/issues
+Keywords: pytest,testing,dag,dependencies,ordering,plugin
+Classifier: Framework :: Pytest
+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: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Testing
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pytest>=7.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: cryptography>=42.0.0
+Dynamic: license-file
+
+# pytest-dag
+
+<p align="center">
+  <img src="assets/branding/pytest-dag-logo.svg" alt="pytest-dag logo" width="88">
+</p>
+
+![pytest-dag banner](assets/branding/pytest-dag-banner.svg)
+
+[![Docs status](https://readthedocs.org/projects/pytest-dag/badge/?version=latest)](https://pytest-dag.readthedocs.io/en/latest/)
+
+Documentation: https://pytest-dag.readthedocs.io/en/latest/
+
+`pytest-dag` is a pytest plugin for dependency-aware test execution.
+
+It lets tests declare dependencies, builds a DAG, runs tests in topological
+order, and skips downstream tests when required dependencies fail.
+
+## Installation
+
+```bash
+pip install pytest-dag
+```
+
+## Quick Start
+
+```python
+import pytest
+
+def test_a():
+    assert True
+
+@pytest.mark.dag(depends=["test_a"])
+def test_b():
+    assert True
+
+@pytest.mark.dag(depends=["test_b"])
+def test_c():
+    assert True
+
+@pytest.mark.dag(depends=["test_b"])
+def test_d():
+    assert True
+```
+
+Expected run order:
+
+`test_a -> test_b -> (test_c, test_d)`
+
+If `test_a` fails, dependent tests are skipped with a clear reason:
+
+```text
+SKIPPED pytest-dag: blocked by test_file.py::test_a (FAILED)
+```
+
+## Marker Syntax
+
+```python
+# Single dependency (string)
+@pytest.mark.dag(depends="test_login")
+def test_profile():
+    ...
+
+# Multiple dependencies (list)
+@pytest.mark.dag(depends=["test_login", "test_db_connect"])
+def test_dashboard():
+    ...
+
+# Cross-file dependency (full nodeid)
+@pytest.mark.dag(depends=["tests/auth/test_auth.py::test_login"])
+def test_profile():
+    ...
+```
+
+## YAML DAG
+
+For larger suites, you can define dependencies in YAML instead of (or in
+addition to) markers.
+
+`pyproject.toml`:
+
+```toml
+[tool.pytest.ini_options]
+dag_file = "tests/dag.yaml"
+```
+
+`tests/dag.yaml`:
+
+```yaml
+nodes:
+  - id: tests/test_flow.py::test_a
+  - id: tests/test_flow.py::test_b
+    depends: [tests/test_flow.py::test_a]
+  - id: tests/test_flow.py::test_c
+    depends: [tests/test_flow.py::test_b]
+```
+
+Marker dependencies and YAML dependencies are unioned.
+
+## CLI Options
+
+| Option                             | Default | Description                                                       |
+| ---------------------------------- | ------- | ----------------------------------------------------------------- |
+| `--dag-strict` / `--no-dag-strict` | strict  | Missing dependency -> error (strict) or skip (lenient) |
+| `--dag-block-on OUTCOMES`          | `fail`  | Outcomes that block dependents: `fail`, `skip`, `xfail`, `error` |
+| `--dag-dump`                       | off     | Print DAG order and edges after collection |
+| `--pytest-dag-license-key`         | unset   | Provide license key directly |
+| `--pytest-dag-license-key-file`    | unset   | Read license key from file |
+
+Examples:
+
+```bash
+# Cascade skipping (skip dependents when a dependency fails or is skipped)
+pytest --dag-block-on fail,skip
+
+# Missing deps become skips instead of collection errors
+pytest --no-dag-strict
+
+# Print computed graph for debugging
+pytest --dag-dump
+```
+
+## License Setup
+
+`pytest-dag` may require a license key depending on current license policy.
+
+Provide a license key using one of:
+
+- Environment variable: `PYTEST_DAG_LICENSE_KEY`
+- CLI value: `--pytest-dag-license-key`
+- Key file: `--pytest-dag-license-key-file`
+
+Examples:
+
+```bash
+export PYTEST_DAG_LICENSE_KEY=pd-XXXX-XXXX-XXXX-XXXX
+python -m pytest -v -rs
+```
+
+```bash
+pytest --pytest-dag-license-key-file /path/to/key.txt -v -rs
+```
+
+Purchase or renew:
+
+- `https://pytest-dag.slrsoft.ca/licenses/purchase`
+
+Support:
+
+- `support@slrsoft.ca`
+
+## Viewing Skip Reasons
+
+Use `-v -rs` to see exact skip reasons:
+
+```bash
+pytest -v -rs
+```
+
+Example summary:
+
+```text
+SKIPPED [2] pytest-dag: blocked by test_demo.py::test_login (FAILED)
+SKIPPED [1] test_demo.py:104: feature not yet implemented
+```
+
+## pytest-xdist Compatibility
+
+`pytest-dag` is not compatible with `pytest-xdist` parallel execution (`-n`).
+To preserve DAG correctness, the plugin automatically disables xdist when it is
+active and prints a warning.
+
+If xdist is installed but `-n` is not passed, nothing is changed.
+
+## Troubleshooting
+
+### `plugins: ... dag-0.1.0` (not `pytest-dag-0.1.0`)
+
+This is normal. Pytest shortens plugin names in output by dropping the
+`pytest-` prefix.
+
+### Plugin not loading in a virtualenv
+
+If `which pytest` points to a global executable after activating a venv, use:
+
+```bash
+python -m pytest ...
+```
+
+This guarantees the venv interpreter and installed plugin are used.
+
+## License
+
+Proprietary. Copyright (c) 2026 SLR Software Solutions Inc.
+
+See the license terms in the repository `LICENSE` file.
+
+Licensing inquiries: `support@slrsoft.ca`

pytest_dag-3.0.0/README.md

@@ -0,0 +1,197 @@
+# pytest-dag
+
+<p align="center">
+  <img src="assets/branding/pytest-dag-logo.svg" alt="pytest-dag logo" width="88">
+</p>
+
+![pytest-dag banner](assets/branding/pytest-dag-banner.svg)
+
+[![Docs status](https://readthedocs.org/projects/pytest-dag/badge/?version=latest)](https://pytest-dag.readthedocs.io/en/latest/)
+
+Documentation: https://pytest-dag.readthedocs.io/en/latest/
+
+`pytest-dag` is a pytest plugin for dependency-aware test execution.
+
+It lets tests declare dependencies, builds a DAG, runs tests in topological
+order, and skips downstream tests when required dependencies fail.
+
+## Installation
+
+```bash
+pip install pytest-dag
+```
+
+## Quick Start
+
+```python
+import pytest
+
+def test_a():
+    assert True
+
+@pytest.mark.dag(depends=["test_a"])
+def test_b():
+    assert True
+
+@pytest.mark.dag(depends=["test_b"])
+def test_c():
+    assert True
+
+@pytest.mark.dag(depends=["test_b"])
+def test_d():
+    assert True
+```
+
+Expected run order:
+
+`test_a -> test_b -> (test_c, test_d)`
+
+If `test_a` fails, dependent tests are skipped with a clear reason:
+
+```text
+SKIPPED pytest-dag: blocked by test_file.py::test_a (FAILED)
+```
+
+## Marker Syntax
+
+```python
+# Single dependency (string)
+@pytest.mark.dag(depends="test_login")
+def test_profile():
+    ...
+
+# Multiple dependencies (list)
+@pytest.mark.dag(depends=["test_login", "test_db_connect"])
+def test_dashboard():
+    ...
+
+# Cross-file dependency (full nodeid)
+@pytest.mark.dag(depends=["tests/auth/test_auth.py::test_login"])
+def test_profile():
+    ...
+```
+
+## YAML DAG
+
+For larger suites, you can define dependencies in YAML instead of (or in
+addition to) markers.
+
+`pyproject.toml`:
+
+```toml
+[tool.pytest.ini_options]
+dag_file = "tests/dag.yaml"
+```
+
+`tests/dag.yaml`:
+
+```yaml
+nodes:
+  - id: tests/test_flow.py::test_a
+  - id: tests/test_flow.py::test_b
+    depends: [tests/test_flow.py::test_a]
+  - id: tests/test_flow.py::test_c
+    depends: [tests/test_flow.py::test_b]
+```
+
+Marker dependencies and YAML dependencies are unioned.
+
+## CLI Options
+
+| Option                             | Default | Description                                                       |
+| ---------------------------------- | ------- | ----------------------------------------------------------------- |
+| `--dag-strict` / `--no-dag-strict` | strict  | Missing dependency -> error (strict) or skip (lenient) |
+| `--dag-block-on OUTCOMES`          | `fail`  | Outcomes that block dependents: `fail`, `skip`, `xfail`, `error` |
+| `--dag-dump`                       | off     | Print DAG order and edges after collection |
+| `--pytest-dag-license-key`         | unset   | Provide license key directly |
+| `--pytest-dag-license-key-file`    | unset   | Read license key from file |
+
+Examples:
+
+```bash
+# Cascade skipping (skip dependents when a dependency fails or is skipped)
+pytest --dag-block-on fail,skip
+
+# Missing deps become skips instead of collection errors
+pytest --no-dag-strict
+
+# Print computed graph for debugging
+pytest --dag-dump
+```
+
+## License Setup
+
+`pytest-dag` may require a license key depending on current license policy.
+
+Provide a license key using one of:
+
+- Environment variable: `PYTEST_DAG_LICENSE_KEY`
+- CLI value: `--pytest-dag-license-key`
+- Key file: `--pytest-dag-license-key-file`
+
+Examples:
+
+```bash
+export PYTEST_DAG_LICENSE_KEY=pd-XXXX-XXXX-XXXX-XXXX
+python -m pytest -v -rs
+```
+
+```bash
+pytest --pytest-dag-license-key-file /path/to/key.txt -v -rs
+```
+
+Purchase or renew:
+
+- `https://pytest-dag.slrsoft.ca/licenses/purchase`
+
+Support:
+
+- `support@slrsoft.ca`
+
+## Viewing Skip Reasons
+
+Use `-v -rs` to see exact skip reasons:
+
+```bash
+pytest -v -rs
+```
+
+Example summary:
+
+```text
+SKIPPED [2] pytest-dag: blocked by test_demo.py::test_login (FAILED)
+SKIPPED [1] test_demo.py:104: feature not yet implemented
+```
+
+## pytest-xdist Compatibility
+
+`pytest-dag` is not compatible with `pytest-xdist` parallel execution (`-n`).
+To preserve DAG correctness, the plugin automatically disables xdist when it is
+active and prints a warning.
+
+If xdist is installed but `-n` is not passed, nothing is changed.
+
+## Troubleshooting
+
+### `plugins: ... dag-0.1.0` (not `pytest-dag-0.1.0`)
+
+This is normal. Pytest shortens plugin names in output by dropping the
+`pytest-` prefix.
+
+### Plugin not loading in a virtualenv
+
+If `which pytest` points to a global executable after activating a venv, use:
+
+```bash
+python -m pytest ...
+```
+
+This guarantees the venv interpreter and installed plugin are used.
+
+## License
+
+Proprietary. Copyright (c) 2026 SLR Software Solutions Inc.
+
+See the license terms in the repository `LICENSE` file.
+
+Licensing inquiries: `support@slrsoft.ca`

pytest_dag-3.0.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pytest-dag"
+version = "3.0.0"
+description = "A pytest plugin that enforces test execution order via a dependency DAG"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE"]
+authors = [
+    { name = "SLR Software Solutions Inc.", email = "support@slrsoft.ca" },
+]
+keywords = ["pytest", "testing", "dag", "dependencies", "ordering", "plugin"]
+classifiers = [
+    "Framework :: Pytest",
+    "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",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Testing",
+    "Intended Audience :: Developers",
+]
+dependencies = ["pytest>=7.0", "pyyaml>=6.0", "cryptography>=42.0.0"]
+
+[project.urls]
+Homepage = "https://github.com/SLR-Software-Solutions-Inc/pytest-dag"
+"Bug Tracker" = "https://github.com/SLR-Software-Solutions-Inc/pytest-dag/issues"
+
+[project.entry-points."pytest11"]
+pytest-dag = "pytest_dag.plugin"
+
+[tool.setuptools.packages.find]
+include = ["pytest_dag*"]
+
+[tool.pytest.ini_options]
+# Disable the plugin for the plugin's own test suite bootstrapping.
+# Tests enable it explicitly via conftest.
+addopts = "-p no:pytest-dag"

pytest_dag-3.0.0/pytest_dag/__init__.py

@@ -0,0 +1,3 @@
+"""pytest-dag: dependency-driven test ordering and skip propagation."""
+
+__version__ = "0.1.0"

pytest_dag-3.0.0/pytest_dag/_build_config.py

@@ -0,0 +1,4 @@
+"""Build-injected official licensing configuration."""
+
+OFFICIAL_LICENSE_ENDPOINT = 'https://pytest-dag.slrsoft.ca'
+OFFICIAL_SIGNING_PUBLIC_KEY_PEM = '-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAjY/lRvFw6SFsmerr8q6So+B8mWoMvHXjgYIzI7zeU7E=\n-----END PUBLIC KEY-----'