pytest-httpchain 0.14.0__tar.gz → 0.14.2__tar.gz

{pytest_httpchain-0.14.0 → pytest_httpchain-0.14.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytest-httpchain
-Version: 0.14.0
+Version: 0.14.2
 Summary: pytest plugin for HTTP testing using JSON files
 Keywords: testing,pytest,httpx,http,api,integration-testing
 Author: Alexander Eresov
@@ -10,11 +10,11 @@ License-File: LICENSE
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Framework :: Pytest
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
 Requires-Dist: deepmerge>=2.0
 Requires-Dist: graphql-core>=3.0.0
 Requires-Dist: httpx[http2]>=0.27.0
@@ -24,18 +24,19 @@ Requires-Dist: pydantic>=2.13.4
 Requires-Dist: referencing>=0.28.4
 Requires-Dist: pyrate-limiter>=4.2.0
 Requires-Dist: pytest>=9.0
-Requires-Dist: pytest-order>=1.3.0
 Requires-Dist: simpleeval>=1.0.3
 Requires-Dist: typer>=0.16.0
 Requires-Python: >=3.13
-Project-URL: Changelog, https://github.com/aeresov/pytest-httpchain/blob/main/CHANGELOG.md
-Project-URL: Documentation, https://aeresov.github.io/pytest-httpchain/
 Project-URL: Repository, https://github.com/aeresov/pytest-httpchain
+Project-URL: Documentation, https://aeresov.github.io/pytest-httpchain/
+Project-URL: Changelog, https://github.com/aeresov/pytest-httpchain/blob/main/CHANGELOG.md
 Description-Content-Type: text/markdown
 
 [![image](https://img.shields.io/pypi/v/pytest-httpchain)](https://pypi.python.org/pypi/pytest-httpchain)
 [![image](https://img.shields.io/pypi/l/pytest-httpchain)](https://github.com/aeresov/pytest-httpchain/blob/main/LICENSE)
 [![image](https://img.shields.io/pypi/pyversions/pytest-httpchain)](https://pypi.python.org/pypi/pytest-httpchain)
+[![Test](https://github.com/aeresov/pytest-httpchain/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/aeresov/pytest-httpchain/actions/workflows/test.yml)
+[![Docs](https://github.com/aeresov/pytest-httpchain/actions/workflows/docs.yml/badge.svg?branch=main)](https://aeresov.github.io/pytest-httpchain/)
 
 # pytest-httpchain
 
@@ -73,7 +74,7 @@ Each scenario contains 1+ stages executed in order. One stage failure stops the
 
 ### Common data context
 
-A key-value store persists throughout scenario execution. Variables, fixtures, and saved response data all live here. Use template expressions (`{{ var }}`) anywhere in your requests — substitution happens dynamically before each stage.
+A key-value store persists throughout scenario execution. Variables, fixtures, and saved response data all live here. Use template expressions (`{{ var }}`) in any request **value** — substitution happens dynamically before each stage. (Dict keys are not substituted; `HTTPCHAIN029` flags a template in a key.)
 
 ### Response processing
 
@@ -199,7 +200,7 @@ pip install 'git+https://github.com/aeresov/pytest-httpchain@main'
 
 -   Test file discovery is based on this name pattern: `test_<name>.<suffix>.json`.
     The suffix is configurable via the `httpchain_suffix` pytest ini option, default value is **http**.
--   `$ref` instructions can point to other files using relative paths; absolute paths are rejected for security.
+-   `$ref` instructions can point to other files using relative paths; absolute paths are rejected for security, and every reference must resolve inside the root path (pytest's `rootdir` when collecting; `--root-path` for the CLI).
     You can limit the depth of relative path traversal using the `httpchain_ref_parent_traversal_depth` ini option, default value is **3**.
 -   Template expressions support list/dict comprehensions. You can limit the maximum comprehension length using the `httpchain_max_comprehension_length` ini option, default value is **50000**.
 -   Parallel stage iterations (repeat/foreach) have a safety limit configurable via the `httpchain_max_parallel_iterations` ini option, default value is **10000**.
@@ -250,7 +251,15 @@ A JSON Schema is published for as-you-type validation and autocomplete. Referenc
 }
 ```
 
-The hosted schema tracks the `main` branch (it is redeployed on every push, so it may describe unreleased changes); to pin the schema matching your installed version (e.g. for CI), emit it locally:
+The hosted schema at the unversioned URL tracks the `main` branch (it is redeployed on every push, so it may describe unreleased changes). To pin the schema for a release, use its versioned URL:
+
+```json
+{
+    "$schema": "https://aeresov.github.io/pytest-httpchain/schema/v0.14.0/scenario.schema.json"
+}
+```
+
+or emit the schema matching your installed version locally:
 
 ```bash
 uvx pytest-httpchain schema > scenario.schema.json
@@ -283,5 +292,4 @@ This project was inspired by [Tavern](https://github.com/taverntesting/tavern) a
 [httpx](https://www.python-httpx.org) does comms.  
 [Pydantic](https://docs.pydantic.dev) keeps structure.  
 [simpleeval](https://github.com/danthedeckie/simpleeval) powers templates.  
-[pytest-order](https://github.com/pytest-dev/pytest-order) sorts chain.  
 [pytest-datadir](https://github.com/gabrielcnr/pytest-datadir) saved me a lot of elbow grease while testing.

{pytest_httpchain-0.14.0 → pytest_httpchain-0.14.2}/README.md

@@ -1,6 +1,8 @@
 [![image](https://img.shields.io/pypi/v/pytest-httpchain)](https://pypi.python.org/pypi/pytest-httpchain)
 [![image](https://img.shields.io/pypi/l/pytest-httpchain)](https://github.com/aeresov/pytest-httpchain/blob/main/LICENSE)
 [![image](https://img.shields.io/pypi/pyversions/pytest-httpchain)](https://pypi.python.org/pypi/pytest-httpchain)
+[![Test](https://github.com/aeresov/pytest-httpchain/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/aeresov/pytest-httpchain/actions/workflows/test.yml)
+[![Docs](https://github.com/aeresov/pytest-httpchain/actions/workflows/docs.yml/badge.svg?branch=main)](https://aeresov.github.io/pytest-httpchain/)
 
 # pytest-httpchain
 
@@ -38,7 +40,7 @@ Each scenario contains 1+ stages executed in order. One stage failure stops the
 
 ### Common data context
 
-A key-value store persists throughout scenario execution. Variables, fixtures, and saved response data all live here. Use template expressions (`{{ var }}`) anywhere in your requests — substitution happens dynamically before each stage.
+A key-value store persists throughout scenario execution. Variables, fixtures, and saved response data all live here. Use template expressions (`{{ var }}`) in any request **value** — substitution happens dynamically before each stage. (Dict keys are not substituted; `HTTPCHAIN029` flags a template in a key.)
 
 ### Response processing
 
@@ -164,7 +166,7 @@ pip install 'git+https://github.com/aeresov/pytest-httpchain@main'
 
 -   Test file discovery is based on this name pattern: `test_<name>.<suffix>.json`.
     The suffix is configurable via the `httpchain_suffix` pytest ini option, default value is **http**.
--   `$ref` instructions can point to other files using relative paths; absolute paths are rejected for security.
+-   `$ref` instructions can point to other files using relative paths; absolute paths are rejected for security, and every reference must resolve inside the root path (pytest's `rootdir` when collecting; `--root-path` for the CLI).
     You can limit the depth of relative path traversal using the `httpchain_ref_parent_traversal_depth` ini option, default value is **3**.
 -   Template expressions support list/dict comprehensions. You can limit the maximum comprehension length using the `httpchain_max_comprehension_length` ini option, default value is **50000**.
 -   Parallel stage iterations (repeat/foreach) have a safety limit configurable via the `httpchain_max_parallel_iterations` ini option, default value is **10000**.
@@ -215,7 +217,15 @@ A JSON Schema is published for as-you-type validation and autocomplete. Referenc
 }
 ```
 
-The hosted schema tracks the `main` branch (it is redeployed on every push, so it may describe unreleased changes); to pin the schema matching your installed version (e.g. for CI), emit it locally:
+The hosted schema at the unversioned URL tracks the `main` branch (it is redeployed on every push, so it may describe unreleased changes). To pin the schema for a release, use its versioned URL:
+
+```json
+{
+    "$schema": "https://aeresov.github.io/pytest-httpchain/schema/v0.14.0/scenario.schema.json"
+}
+```
+
+or emit the schema matching your installed version locally:
 
 ```bash
 uvx pytest-httpchain schema > scenario.schema.json
@@ -248,5 +258,4 @@ This project was inspired by [Tavern](https://github.com/taverntesting/tavern) a
 [httpx](https://www.python-httpx.org) does comms.  
 [Pydantic](https://docs.pydantic.dev) keeps structure.  
 [simpleeval](https://github.com/danthedeckie/simpleeval) powers templates.  
-[pytest-order](https://github.com/pytest-dev/pytest-order) sorts chain.  
 [pytest-datadir](https://github.com/gabrielcnr/pytest-datadir) saved me a lot of elbow grease while testing.

{pytest_httpchain-0.14.0 → pytest_httpchain-0.14.2}/pyproject.toml

@@ -1,10 +1,9 @@
 [project]
 name = "pytest-httpchain"
-version = "0.14.0"
+version = "0.14.2"
 description = "pytest plugin for HTTP testing using JSON files"
 readme = "README.md"
 requires-python = ">=3.13"
-authors = [{ name = "Alexander Eresov", email = "aeresov@gmail.com" }]
 dependencies = [
     "deepmerge>=2.0",
     "graphql-core>=3.0.0",
@@ -15,39 +14,56 @@ dependencies = [
     "referencing>=0.28.4",
     "pyrate-limiter>=4.2.0",
     "pytest>=9.0",
-    "pytest-order>=1.3.0",
     "simpleeval>=1.0.3",
     "typer>=0.16.0",
 ]
-keywords = ["testing", "pytest", "httpx", "http", "api", "integration-testing"]
+keywords = [
+    "testing",
+    "pytest",
+    "httpx",
+    "http",
+    "api",
+    "integration-testing",
+]
 license = "MIT"
 license-files = ["LICENSE"]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Framework :: Pytest",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Testing",
+    "Typing :: Typed",
 ]
 
+[[project.authors]]
+name = "Alexander Eresov"
+email = "aeresov@gmail.com"
+
 [project.urls]
 Repository = "https://github.com/aeresov/pytest-httpchain"
 Documentation = "https://aeresov.github.io/pytest-httpchain/"
 Changelog = "https://github.com/aeresov/pytest-httpchain/blob/main/CHANGELOG.md"
 
+[project.scripts]
+pytest-httpchain = "pytest_httpchain.cli:app"
+
+[project.entry-points.pytest11]
+pytest_httpchain = "pytest_httpchain.plugin"
+
 [dependency-groups]
 dev = [
+    "flask>=3.0",
     "flask-httpauth>=4.8.0",
-    "http-server-mock>=1.7",
     "import-linter>=2.0",
     "ruff>=0.12.1",
-    "pytest-cov>=6.0.0",
-    "coverage[toml]>=7.0",
+    "coverage[toml]>=7.10",
     "pytest-datadir>=1.7.2",
+    "pytest-order>=1.3.0",
     "pytest-xdist>=3.8.0",
+    "trustme>=1.1.0",
 ]
 docs = [
     "mkdocs>=1.6.1",
@@ -55,21 +71,14 @@ docs = [
 ]
 
 [tool.uv]
-default-groups = ["dev", "docs"]
-
-[build-system]
-requires = ["uv_build>=0.7.21,<0.8.0"]
-build-backend = "uv_build"
+default-groups = [
+    "dev",
+    "docs",
+]
 
 [tool.uv.build-backend]
 source-exclude = ["src/pytest_httpchain/**/CLAUDE.md"]
 
-[project.scripts]
-pytest-httpchain = "pytest_httpchain.cli:app"
-
-[project.entry-points.pytest11]
-pytest_httpchain = "pytest_httpchain.plugin"
-
 [tool.ruff]
 line-length = 180
 target-version = "py313"
@@ -80,14 +89,15 @@ line-ending = "lf"
 
 [tool.ruff.lint]
 select = [
-    "E",  # pycodestyle errors
-    "W",  # pycodestyle warnings
-    "F",  # pyflakes
-    "I",  # isort
-    "B",  # flake8-bugbear
-    "C4", # flake8-comprehensions
-    "UP", # pyupgrade
-    "TID252", # flake8-tidy-imports: ban relative imports
+    "E",
+    "W",
+    "F",
+    "I",
+    "B",
+    "C4",
+    "UP",
+    "PT",
+    "TID252",
 ]
 ignore = []
 
@@ -103,10 +113,6 @@ python-version = "3.13"
 [tool.ty.terminal]
 error-on-warning = true
 
-# Test suites (especially the models package) deliberately construct models with
-# invalid types to assert ValidationError, and access attributes on unions/mocks
-# the checker can't narrow. Relax those specific rules for test code only; src/
-# stays strict and uses pinpoint `# ty: ignore[...]` comments instead.
 [[tool.ty.overrides]]
 include = ["tests/**"]
 
@@ -119,31 +125,38 @@ missing-argument = "ignore"
 
 [tool.pytest]
 minversion = "9.0"
-log_cli = true
+strict = true
+log_cli = false
 log_cli_level = "INFO"
 norecursedirs = ["examples"]
 pytester_example_dir = "tests/integration/examples"
-addopts = ["--log-disable=werkzeug", "--import-mode=importlib"]
-pythonpath = [
-    ".",
+addopts = [
+    "--log-disable=werkzeug",
+    "--import-mode=importlib",
 ]
+pythonpath = ["."]
 testpaths = ["tests"]
+markers = ["slow: subprocess-spawning or sleep-bound integration test; deselect with -m 'not slow'"]
+filterwarnings = [
+    "error",
+    "default::pytest_httpchain.ScenarioValidationWarning",
+]
 
 [tool.coverage.run]
 source = ["src"]
 branch = true
+parallel = true
+patch = ["subprocess"]
 
 [tool.coverage.report]
 precision = 2
 show_missing = true
 skip_covered = false
+fail_under = 88
 
 [tool.importlinter]
 root_package = "pytest_httpchain"
 
-# Exhaustive vertical layering: every top-level module must appear in exactly one
-# layer; a new module fails lint-imports until it is placed. Modules on the same
-# layer (separated by ":") are additionally kept mutually independent.
 [[tool.importlinter.contracts]]
 name = "package layering"
 type = "layers"
@@ -153,7 +166,7 @@ layers = [
     "plugin : cli",
     "factory",
     "carrier : dataflow : schema",
-    "validation : har_writer : report_formatter",
+    "validation : har_writer : report_formatter : request_builder : response_steps",
     "utils : scoping",
     "userfunc",
     "models",
@@ -161,10 +174,12 @@ layers = [
     "errors : constants : warnings",
 ]
 
-# Horizontal refinement the layers contract cannot express: models sits above the
-# domain trio and may import templates/userfunc, but must never import jsonref.
 [[tool.importlinter.contracts]]
 name = "models does not import jsonref"
 type = "forbidden"
 source_modules = ["pytest_httpchain.models"]
 forbidden_modules = ["pytest_httpchain.jsonref"]
+
+[build-system]
+requires = ["uv_build>=0.11,<0.12"]
+build-backend = "uv_build"

pytest_httpchain-0.14.2/pyproject.toml.orig

@@ -0,0 +1,205 @@
+[project]
+name = "pytest-httpchain"
+version = "0.14.2"
+description = "pytest plugin for HTTP testing using JSON files"
+readme = "README.md"
+requires-python = ">=3.13"
+authors = [{ name = "Alexander Eresov", email = "aeresov@gmail.com" }]
+dependencies = [
+    "deepmerge>=2.0",
+    "graphql-core>=3.0.0",
+    "httpx[http2]>=0.27.0",
+    "jmespath>=1.0.0",
+    "jsonschema>=4.18.0",
+    "pydantic>=2.13.4",
+    "referencing>=0.28.4",
+    "pyrate-limiter>=4.2.0",
+    "pytest>=9.0",
+    "simpleeval>=1.0.3",
+    "typer>=0.16.0",
+]
+keywords = ["testing", "pytest", "httpx", "http", "api", "integration-testing"]
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Framework :: Pytest",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Testing",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Repository = "https://github.com/aeresov/pytest-httpchain"
+Documentation = "https://aeresov.github.io/pytest-httpchain/"
+Changelog = "https://github.com/aeresov/pytest-httpchain/blob/main/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "flask>=3.0",
+    "flask-httpauth>=4.8.0",
+    "import-linter>=2.0",
+    "ruff>=0.12.1",
+    "coverage[toml]>=7.10", # `patch = ["subprocess"]` needs 7.10
+
+    "pytest-datadir>=1.7.2",
+    # Not a runtime dependency: the plugin's own collection hooks own stage
+    # ordering. Installed in dev so the ordering regression tests can exercise
+    # the regroup's defense against a user-installed pytest-order.
+    "pytest-order>=1.3.0",
+    "pytest-xdist>=3.8.0",
+    "trustme>=1.1.0",
+]
+docs = [
+    "mkdocs>=1.6.1",
+    "mkdocs-material>=9.6.16",
+]
+
+[tool.uv]
+default-groups = ["dev", "docs"]
+
+[build-system]
+requires = ["uv_build>=0.11,<0.12"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+source-exclude = ["src/pytest_httpchain/**/CLAUDE.md"]
+
+[project.scripts]
+pytest-httpchain = "pytest_httpchain.cli:app"
+
+[project.entry-points.pytest11]
+pytest_httpchain = "pytest_httpchain.plugin"
+
+[tool.ruff]
+line-length = 180
+target-version = "py313"
+
+[tool.ruff.format]
+quote-style = "double"
+line-ending = "lf"
+
+[tool.ruff.lint]
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "B",  # flake8-bugbear
+    "C4", # flake8-comprehensions
+    "UP", # pyupgrade
+    "PT", # flake8-pytest-style
+    "TID252", # flake8-tidy-imports: ban relative imports
+]
+ignore = []
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.lint.isort]
+known-first-party = ["tests"]
+
+[tool.ty.environment]
+python-version = "3.13"
+
+[tool.ty.terminal]
+error-on-warning = true
+
+# Test suites (especially the models package) deliberately construct models with
+# invalid types to assert ValidationError, and access attributes on unions/mocks
+# the checker can't narrow. Relax those specific rules for test code only; src/
+# stays strict and uses pinpoint `# ty: ignore[...]` comments instead.
+[[tool.ty.overrides]]
+include = ["tests/**"]
+
+[tool.ty.overrides.rules]
+invalid-argument-type = "ignore"
+unknown-argument = "ignore"
+unresolved-attribute = "ignore"
+not-subscriptable = "ignore"
+missing-argument = "ignore"
+
+[tool.pytest]
+minversion = "9.0"
+# pytest 9 umbrella: strict_config, strict_markers, strict_xfail,
+# strict_parametrization_ids — unknown ini keys and unregistered markers
+# become errors instead of warnings.
+strict = true
+# Logs are captured and shown only for failing tests (pytest's default). Streaming
+# live INFO for every passing test buried real output ~10-27x; opt back in per-run
+# with `-o log_cli=true --log-cli-level=INFO` when debugging.
+log_cli = false
+log_cli_level = "INFO"
+norecursedirs = ["examples"]
+pytester_example_dir = "tests/integration/examples"
+addopts = ["--log-disable=werkzeug", "--import-mode=importlib"]
+pythonpath = [
+    ".",
+]
+testpaths = ["tests"]
+markers = [
+    "slow: subprocess-spawning or sleep-bound integration test; deselect with -m 'not slow'",
+]
+# Treat warnings as errors so dependency deprecations (e.g. across the 3.13/3.14
+# and lowest-floor matrix) fail loudly instead of rotting. The plugin's own
+# ScenarioValidationWarning is intentional behavior that many tests assert on,
+# so it stays a warning; individual tests still escalate it via -W when needed.
+filterwarnings = [
+    "error",
+    "default::pytest_httpchain.ScenarioValidationWarning",
+]
+
+[tool.coverage.run]
+source = ["src"]
+branch = true
+# Measure pytester subprocess children too (runpytest_subprocess families):
+# `patch` injects startup into every child with this config serialized —
+# data_file/source absolutized, so children report into this project's data
+# files regardless of their CWD. Requires the pid-suffixed parallel data
+# files; run `coverage combine` before `coverage report`.
+parallel = true
+patch = ["subprocess"]
+
+[tool.coverage.report]
+precision = 2
+show_missing = true
+skip_covered = false
+# Regression floor for the CI `coverage report` step (full suite under
+# `coverage run -m pytest`, ~95%). Kept a few points below the real number to
+# tolerate platform/Python-version branch differences; ratchet upward as
+# coverage improves rather than letting it silently erode.
+fail_under = 88
+
+[tool.importlinter]
+root_package = "pytest_httpchain"
+
+# Exhaustive vertical layering: every top-level module must appear in exactly one
+# layer; a new module fails lint-imports until it is placed. Modules on the same
+# layer (separated by ":") are additionally kept mutually independent.
+[[tool.importlinter.contracts]]
+name = "package layering"
+type = "layers"
+containers = ["pytest_httpchain"]
+exhaustive = true
+layers = [
+    "plugin : cli",
+    "factory",
+    "carrier : dataflow : schema",
+    "validation : har_writer : report_formatter : request_builder : response_steps",
+    "utils : scoping",
+    "userfunc",
+    "models",
+    "templates : jsonref",
+    "errors : constants : warnings",
+]
+
+# Horizontal refinement the layers contract cannot express: models sits above the
+# domain trio and may import templates/userfunc, but must never import jsonref.
+[[tool.importlinter.contracts]]
+name = "models does not import jsonref"
+type = "forbidden"
+source_modules = ["pytest_httpchain.models"]
+forbidden_modules = ["pytest_httpchain.jsonref"]

pytest_httpchain-0.14.2/src/pytest_httpchain/__init__.py

@@ -0,0 +1,9 @@
+"""pytest-httpchain: declarative HTTP API integration testing.
+
+Test scenarios are JSON files (``test_<name>.http.json``) with ``$ref`` support,
+``{{ expr }}`` templates, and multi-stage request chaining.
+"""
+
+from pytest_httpchain.warnings import ScenarioValidationWarning
+
+__all__ = ["ScenarioValidationWarning"]