livery-extensions-pytest 0.1.0__tar.gz

livery_extensions_pytest-0.1.0/LICENSE

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

livery_extensions_pytest-0.1.0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: livery-extensions-pytest
+Version: 0.1.0
+Summary: pytest as a check of the livery workshop: each python package's suite and documentation examples, configured by the root pytest.toml and .coveragerc.
+Author: Willem Kokke
+Author-email: Willem Kokke <mail@willem.net>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Dist: livery-workshop>=0.11.0
+Requires-Dist: coverage>=7.13 ; extra == 'coverage'
+Requires-Dist: livery-footman>=0.61.0 ; extra == 'test'
+Requires-Dist: livery-git>=0.3.0 ; extra == 'test'
+Requires-Dist: livery-extensions-cmake>=0.0.0 ; extra == 'test'
+Requires-Dist: livery-extensions-docs>=0.0.0 ; extra == 'test'
+Requires-Dist: livery-extensions-coverage>=0.0.0 ; extra == 'test'
+Requires-Dist: livery-extensions-python>=0.0.0 ; extra == 'test'
+Requires-Python: >=3.11
+Project-URL: Repository, https://github.com/willemkokke/livery
+Provides-Extra: coverage
+Provides-Extra: test
+Description-Content-Type: text/markdown
+
+<!-- Seeded from the python-library template at
+     birth; this file is the workspace's own. Edit it directly:
+     nothing rewrites it.
+-->
+# livery-extensions-pytest
+
+pytest as a check of the livery workshop. Listed as `pytest` in a workspace's
+`[workspace] extensions`, it registers `test.pytest`, which runs each python
+package's suite, measured while coverage is listed, and `examples.pytest`,
+which runs each package's documentation examples. It writes the root
+`pytest.toml`, and `.coveragerc` while coverage is listed.

livery_extensions_pytest-0.1.0/README.md

@@ -0,0 +1,11 @@
+<!-- Seeded from the python-library template at
+     birth; this file is the workspace's own. Edit it directly:
+     nothing rewrites it.
+-->
+# livery-extensions-pytest
+
+pytest as a check of the livery workshop. Listed as `pytest` in a workspace's
+`[workspace] extensions`, it registers `test.pytest`, which runs each python
+package's suite, measured while coverage is listed, and `examples.pytest`,
+which runs each package's documentation examples. It writes the root
+`pytest.toml`, and `.coveragerc` while coverage is listed.

livery_extensions_pytest-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["uv_build>=0.11,<0.13"]
+build-backend = "uv_build"
+
+[project]
+name = "livery-extensions-pytest"
+version = "0.1.0"
+description = "pytest as a check of the livery workshop: each python package's suite and documentation examples, configured by the root pytest.toml and .coveragerc."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Typing :: Typed",
+]
+dependencies = ["livery-workshop>=0.11.0"]
+
+[[project.authors]]
+name = "Willem Kokke"
+email = "mail@willem.net"
+
+[project.optional-dependencies]
+coverage = ["coverage>=7.13"]
+test = [
+    "livery-footman>=0.61.0",
+    "livery-git>=0.3.0",
+    "livery-extensions-cmake>=0.0.0",
+    "livery-extensions-docs>=0.0.0",
+    "livery-extensions-coverage>=0.0.0",
+    "livery-extensions-python>=0.0.0",
+]
+
+[project.urls]
+Repository = "https://github.com/willemkokke/livery"
+
+[project.entry-points."workshop.extensions"]
+pytest = "livery.extensions.pytest"
+
+[project.entry-points.pytest11]
+livery-extensions-pytest-contexts = "livery.extensions.pytest._contexts"
+
+[tool.uv.build-backend]
+module-name = "livery.extensions.pytest"
+namespace = true

livery_extensions_pytest-0.1.0/pyproject.toml.orig

@@ -0,0 +1,65 @@
+# Seeded from the python-library template at
+# birth; this file is the workspace's own. Edit it directly:
+# nothing rewrites it.
+[build-system]
+requires = ["uv_build>=0.11,<0.13"]
+build-backend = "uv_build"
+
+[project]
+name = "livery-extensions-pytest"
+version = "0.1.0"
+description = "pytest as a check of the livery workshop: each python package's suite and documentation examples, configured by the root pytest.toml and .coveragerc."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+authors = [{ name = "Willem Kokke", email = "mail@willem.net" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Typing :: Typed",
+]
+
+dependencies = [
+    "livery-workshop>=0.11.0",
+]
+
+[project.optional-dependencies]
+# coverage.py, which this extension imports inside the functions that
+# measure the suites for the coverage extension. While coverage is
+# listed, this extension's own lines of the workspace's dev group
+# install it.
+coverage = ["coverage>=7.13"]
+# The members this package's tests need beyond its dependencies, one
+# for each test edge of its workshop.toml, at the edge's floor.
+test = [
+    "livery-footman>=0.61.0",
+    "livery-git>=0.3.0",
+    "livery-extensions-cmake>=0.0.0",
+    "livery-extensions-docs>=0.0.0",
+    "livery-extensions-coverage>=0.0.0",
+    "livery-extensions-python>=0.0.0",
+]
+
+[project.urls]
+Repository = "https://github.com/willemkokke/livery"
+
+# The name a workspace lists in [workspace] extensions, and the package
+# whose extension.toml the workshop mounts it from. Nothing else: the
+# extension adds no verb of its own, and nothing activates by being
+# installed.
+[project.entry-points."workshop.extensions"]
+pytest = "livery.extensions.pytest"
+
+# Every pytest this venv starts carries the context plugin: in a metered
+# CI leg it names each test's coverage context by node id, so the leg
+# splits one run's data per suite; elsewhere it is quiet.
+[project.entry-points.pytest11]
+livery-extensions-pytest-contexts = "livery.extensions.pytest._contexts"
+
+[tool.uv.build-backend]
+# PEP 420 namespace: the importable package is livery.extensions.pytest and
+# there is no livery/__init__.py anywhere in this repository.
+module-name = "livery.extensions.pytest"
+namespace = true

livery_extensions_pytest-0.1.0/src/livery/extensions/pytest/_contexts.py

@@ -0,0 +1,69 @@
+"""Name each test's coverage context in a metered pytest run.
+
+Registered through livery-extensions-pytest's ``pytest11`` entry point,
+so every pytest this venv starts carries it. It acts only when
+coverage's process startup is measuring the process (inside a CI check
+leg the test runner arms ``COVERAGE_PROCESS_START`` in pytest's
+environment while coverage is listed, and in the gate's own never):
+each test records under one context, its node id, from its setup to
+its teardown, so a leg can split one pooled run's data by the suite
+each test belongs to. Outside a metered run every hook returns at
+once, and a meter that is not collecting is left alone.
+
+Under coverage's sysmon core a line is recorded under the first
+context that reaches it and never again, so a suite's contexts hold
+the lines its tests reached first. The leg's split keeps the union
+complete regardless: a line another suite's test reached first is
+stored with that suite, whose closure holds the file.
+"""
+
+from __future__ import annotations
+
+import os
+from typing import Any
+
+import pytest
+
+#: Coverage's own variable: set in pytest's environment by the test
+#: runner inside CI, so pytest and every python it starts are metered
+#: from interpreter start, and the meter is the one this plugin names
+#: contexts on. A pytest-cov run has its own meter and is left alone.
+ARMED = "COVERAGE_PROCESS_START"
+
+
+def _meter() -> Any | None:
+    """The coverage object process startup began in this metered run, or None."""
+    if not os.environ.get(ARMED):
+        return None
+    try:
+        import coverage
+    except ImportError:
+        return None
+    return getattr(coverage.process_startup, "coverage", None)
+
+
+def _switch(context: str) -> None:
+    meter = _meter()
+    if meter is None:
+        return
+    from coverage.exceptions import CoverageException
+
+    try:
+        meter.switch_context(context)
+    except CoverageException:
+        return
+
+
+def pytest_runtest_setup(item: pytest.Item) -> None:
+    """Record the test under its node id, from its setup to its teardown.
+
+    Switched in the process that runs the test, at its setup: the hooks
+    that report on a test also run in the process that schedules the
+    tests, whose own lines belong to no test.
+    """
+    _switch(item.nodeid)
+
+
+def pytest_runtest_logfinish(nodeid: str, location: object) -> None:
+    """Return to the empty context once the test is over."""
+    _switch("")