livery-extensions-python 0.0.0__tar.gz

livery_extensions_python-0.0.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_python-0.0.0/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.4
+Name: livery-extensions-python
+Version: 0.0.0
+Summary: Python distributions, as an extension of the livery workshop: each package's version stamped, its wheel and sdist built, published and verified, its suite run against the installed wheel, and the layering rules over the python sources.
+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-footman>=0.61.0
+Requires-Dist: livery-forge>=0.8.0
+Requires-Dist: livery-toolroom>=0.12.0
+Requires-Dist: livery-workshop>=0.11.0
+Requires-Python: >=3.11
+Project-URL: Repository, https://github.com/willemkokke/livery
+Description-Content-Type: text/markdown
+
+# livery-extensions-python
+
+Python distributions, as an extension of the livery workshop. Listed as
+`python` in a package's `extensions`, it stamps the version in
+`pyproject.toml`, builds the wheel and the sdist, publishes them to a
+python index, and tests the installed wheel in a fresh environment for
+a release. Its layering rules judge the python sources: no reach into
+another distribution's private names, no import a package does not
+declare, and no terminal check beside the runner's own.
+`fm new.package.python-library <name>` creates a python package while a
+workspace lists the extension.

livery_extensions_python-0.0.0/README.md

@@ -0,0 +1,11 @@
+# livery-extensions-python
+
+Python distributions, as an extension of the livery workshop. Listed as
+`python` in a package's `extensions`, it stamps the version in
+`pyproject.toml`, builds the wheel and the sdist, publishes them to a
+python index, and tests the installed wheel in a fresh environment for
+a release. Its layering rules judge the python sources: no reach into
+another distribution's private names, no import a package does not
+declare, and no terminal check beside the runner's own.
+`fm new.package.python-library <name>` creates a python package while a
+workspace lists the extension.

livery_extensions_python-0.0.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["uv_build>=0.11,<0.13"]
+build-backend = "uv_build"
+
+[project]
+name = "livery-extensions-python"
+version = "0.0.0"
+description = "Python distributions, as an extension of the livery workshop: each package's version stamped, its wheel and sdist built, published and verified, its suite run against the installed wheel, and the layering rules over the python sources."
+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-footman>=0.61.0",
+    "livery-forge>=0.8.0",
+    "livery-toolroom>=0.12.0",
+    "livery-workshop>=0.11.0",
+]
+
+[[project.authors]]
+name = "Willem Kokke"
+email = "mail@willem.net"
+
+[project.urls]
+Repository = "https://github.com/willemkokke/livery"
+
+[project.entry-points."workshop.extensions"]
+python = "livery.extensions.python"
+
+[tool.uv.build-backend]
+module-name = "livery.extensions.python"

livery_extensions_python-0.0.0/pyproject.toml.orig

@@ -0,0 +1,48 @@
+# The package'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-python"
+version = "0.0.0"
+description = "Python distributions, as an extension of the livery workshop: each package's version stamped, its wheel and sdist built, published and verified, its suite run against the installed wheel, and the layering rules over the python sources."
+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-footman>=0.61.0",
+    # The python index's simple API: the release train's probe of a
+    # version the index already serves.
+    "livery-forge>=0.8.0",
+    # The store's uv and pytest, through their toolroom handles, so the
+    # versions are the ones the checkout's lock pins.
+    "livery-toolroom>=0.12.0",
+    # The base.
+    "livery-workshop>=0.11.0",
+]
+
+[project.urls]
+Repository = "https://github.com/willemkokke/livery"
+
+# The name a package lists in its 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"]
+python = "livery.extensions.python"
+
+[tool.uv.build-backend]
+# The importable package is livery.extensions.python, its entry module
+# the root's __init__.py, which serves the names an extension that
+# requires python reads; livery and livery.extensions are PEP 420
+# namespaces with no __init__.py.
+module-name = "livery.extensions.python"

livery_extensions_python-0.0.0/src/livery/extensions/python/__init__.py

@@ -0,0 +1,51 @@
+"""The python extension's names another extension reads to build and test a wheel.
+
+The python extension builds, versions, publishes and tests a package
+whose set holds python. An extension that builds such a package's
+wheels with a tool of its own, as nanobind builds them with
+cibuildwheel, reads two of its functions.
+[livery.extensions.python.module_docs][] copies the package's ``docs/``
+into its source tree as the wheel's embedded ``_docs`` for one build,
+and removes the copy after it. [livery.extensions.python.run_isolated_test][]
+installs a built wheel into a fresh venv and runs the package's tests
+against the installed copy.
+"""
+
+from __future__ import annotations
+
+# The literal-False spelling the checkers honour without importing
+# `typing`: the names below are what a checker sees, and at runtime
+# `__getattr__` serves each from its module when it is read, so importing
+# this module loads none of the extension's modules.
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from livery.extensions.python._backend import module_docs as module_docs
+    from livery.extensions.python._backend import (
+        run_isolated_test as run_isolated_test,
+    )
+
+__version__ = "0.0.0"
+
+__all__ = ["__version__", "module_docs", "run_isolated_test"]
+
+# The module each lazily served name lives in.
+_EXPORTS: dict[str, str] = {
+    "module_docs": "livery.extensions.python._backend",
+    "run_isolated_test": "livery.extensions.python._backend",
+}
+
+
+def __getattr__(name: str) -> object:
+    """Serve a public name from its module, each time it is read.
+
+    The value is never kept here, so a test that patches the name in
+    its module is read through.
+    """
+    import importlib
+
+    module = _EXPORTS.get(name)
+    if module is None:
+        raise AttributeError(
+            f"module 'livery.extensions.python' has no attribute {name!r}"
+        )
+    return getattr(importlib.import_module(module), name)

livery_extensions_python-0.0.0/src/livery/extensions/python/_answers.py

@@ -0,0 +1,127 @@
+"""The python extension's answers: about a package, and about the workspace.
+
+About a package, from its manifest and sources: its version, the files
+a version is written into, its requirements, the names its code is
+referenced by, its public modules and what each source references.
+About the workspace, while pytest is listed: the functions that run
+the python packages' suites and a package's documentation examples.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from livery.extensions.python import _backend
+
+if TYPE_CHECKING:
+    from collections.abc import Callable, Mapping
+    from pathlib import Path
+
+    from livery.forge import Registry
+    from livery.workshop import Package, RequirementWriter, SourceReferences
+
+
+def current_version(package: Package) -> str:
+    """The version the package's ``pyproject.toml`` declares."""
+    return _backend.current_version(package)
+
+
+def version_files(package: Package) -> tuple[Path, ...]:
+    """``pyproject.toml``, and every ``__init__.py`` that may carry ``__version__``."""
+    return tuple(_backend.stamp_version(package).homes())
+
+
+def requirements(package: Package) -> Mapping[str, str]:
+    """The package's ``[project.dependencies]``, each name to its constraint."""
+    return _backend.declared_requirements(package)
+
+
+def requirement_writers(package: Package) -> tuple[RequirementWriter, ...]:
+    """The pyproject's writer of a requirement on a sibling that holds python."""
+    del package
+    return (_backend.declare_requirement,)
+
+
+def test_requirements(package: Package) -> Mapping[str, str]:
+    """The package's ``test`` extra, each name to its constraint."""
+    return _backend.declared_test_requirements(package)
+
+
+def test_requirement_writers(package: Package) -> tuple[RequirementWriter, ...]:
+    """The pyproject's writer of a test requirement on a sibling that holds python."""
+    del package
+    return (_backend.declare_test_requirement,)
+
+
+def module_roots(package: Package) -> tuple[str, ...]:
+    """The import prefixes the package's code is referenced by."""
+    return tuple(_backend.module_roots(package))
+
+
+def public_modules(package: Package) -> tuple[str, ...]:
+    """The modules that declare the package's public API."""
+    return tuple(_backend.public_modules(package))
+
+
+def references(package: Package) -> tuple[SourceReferences, ...]:
+    """What each python source under ``src`` and ``tests`` references, one per file."""
+    return _backend.references(package)
+
+
+#: The ecosystem a python package is released to, as the ``distributions``
+#: query names it, and the registry kind its target resolves by.
+ECOSYSTEM = "python"
+
+
+def distributions(package: Package) -> tuple[tuple[str, str], ...]:
+    """The distribution the package releases, as its ecosystem and its name."""
+    return ((ECOSYSTEM, package.name),)
+
+
+def executables(package: Package) -> tuple[str, ...]:
+    """The scripts the package's ``pyproject.toml`` names in ``[project.scripts]``."""
+    return _backend.scripts(package)
+
+
+def registry(package: Package) -> Registry:
+    """The simple index the package is released to, as a probe of its versions.
+
+    The index is the python target the registry ladder resolves for the
+    package's workspace ([livery.workshop.registry][]), and the probe
+    reads it with the target's credential: an authenticated index, a
+    forge's own registry or a private owner's, answers only with it, and
+    an anonymous probe would wait for a version the index already
+    serves.
+    """
+    from livery.forge import SimpleRegistry
+    from livery.workshop import registry as resolved
+
+    target = resolved(package.root, ECOSYSTEM)
+    return SimpleRegistry(target.url, token=target.token)
+
+
+def suite_runner(root: Path) -> Callable[..., None]:
+    """Answer ``python.test.runner`` with the function that runs the suites.
+
+    pytest's test step asks with the workspace root, which the answer
+    does not depend on, and calls the answer with the words for pytest,
+    the packages whose suites run in one call, the root, the test files
+    that stand for each package's suite, the CI point and whether the
+    run is measured.
+    """
+    del root
+    return _backend.run_test
+
+
+def examples_runner(
+    root: Path,
+) -> Callable[[Package, Path, tuple[str, ...], tuple[str, ...]], None]:
+    """Answer ``python.examples.runner`` with the function that runs examples.
+
+    pytest's examples step asks with the workspace root, which the
+    answer does not depend on, and calls the answer once per package
+    with the package, the root, the example files the run names (empty
+    for all of them) and the words for pytest.
+    """
+    del root
+    return _backend.run_examples