pyproject-api 1.11.2__tar.gz → 1.11.4__tar.gz

{pyproject_api-1.11.2 → pyproject_api-1.11.4}/.github/workflows/check.yaml

@@ -34,7 +34,7 @@ jobs:
           - dev
           - pkg_meta
         os:
-          - ubuntu-latest
+          - ubuntu-26.04
           - windows-latest
           - macos-latest
         exclude:
@@ -47,7 +47,7 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
       - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           enable-cache: false
           cache-dependency-glob: "pyproject.toml"

{pyproject_api-1.11.2 → pyproject_api-1.11.4}/.github/workflows/release.yaml

@@ -11,14 +11,14 @@ env:
 
 jobs:
   build:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-26.04
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
           persist-credentials: false
       - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           enable-cache: false
           cache-dependency-glob: "pyproject.toml"
@@ -26,7 +26,7 @@ jobs:
       - name: Build package
         run: uv build --python 3.14 --python-preference only-managed --sdist --wheel . --out-dir dist
       - name: Store the distribution packages
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: ${{ env.dists-artifact-name }}
           path: dist/*
@@ -34,7 +34,7 @@ jobs:
   release:
     needs:
       - build
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-26.04
     environment:
       name: release
       url: https://pypi.org/project/pyproject-api/${{ github.ref_name }}
@@ -42,7 +42,7 @@ jobs:
       id-token: write
     steps:
       - name: Download all the dists
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           name: ${{ env.dists-artifact-name }}
           path: dist/

{pyproject_api-1.11.2 → pyproject_api-1.11.4}/.pre-commit-config.yaml

@@ -5,7 +5,7 @@ repos:
       - id: end-of-file-fixer
       - id: trailing-whitespace
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.38.0
+    rev: 0.38.2
     hooks:
       - id: check-github-workflows
         args: [ "--verbose" ]
@@ -13,17 +13,17 @@ repos:
     rev: v2.4.3
     hooks:
       - id: codespell
-        additional_dependencies: ["tomli>=2.3"]
+        additional_dependencies: ["tomli>=2.4.1"]
   - repo: https://github.com/tox-dev/tox-toml-fmt
-    rev: "v1.10.3"
+    rev: "v1.11.0"
     hooks:
       - id: tox-toml-fmt
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: "v2.29.4"
+    rev: "v2.30.1"
     hooks:
       - id: pyproject-fmt
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.16.7"
+    rev: "v0.16.10"
     hooks:
       - id: ruff-format
       - id: ruff

{pyproject_api-1.11.2 → pyproject_api-1.11.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pyproject-api
-Version: 1.11.2
+Version: 1.11.4
 Summary: API to interact with the python pyproject.toml based projects
 Project-URL: Changelog, https://github.com/tox-dev/pyproject-api/releases
 Project-URL: Homepage, https://pyproject-api.readthedocs.io
@@ -29,8 +29,8 @@ Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Utilities
 Requires-Python: >=3.10
-Requires-Dist: packaging>=25
-Requires-Dist: tomli>=2.3; python_version < '3.11'
+Requires-Dist: packaging>=26.3
+Requires-Dist: tomli>=2.4.1; python_version < '3.11'
 Description-Content-Type: text/markdown
 
 # [`pyproject-api`][RTD]

{pyproject_api-1.11.2 → pyproject_api-1.11.4}/pyproject.toml

@@ -2,7 +2,7 @@
 build-backend = "hatchling.build"
 requires = [
   "hatch-vcs>=0.5",
-  "hatchling>=1.28",
+  "hatchling>=1.32.4",
 ]
 
 [project]
@@ -47,8 +47,8 @@ dynamic = [
   "version",
 ]
 dependencies = [
-  "packaging>=25",
-  "tomli>=2.3; python_version<'3.11'",
+  "packaging>=26.3",
+  "tomli>=2.4.1; python_version<'3.11'",
 ]
 urls.Changelog = "https://github.com/tox-dev/pyproject-api/releases"
 urls.Homepage = "https://pyproject-api.readthedocs.io"
@@ -65,28 +65,28 @@ dev = [
 ]
 test = [
   "covdefaults>=2.3",
-  "pytest>=8.4.2",
-  "pytest-cov>=7",
-  "pytest-mock>=3.15.1",
-  "setuptools>=80.9",
+  "pytest>=9.1.1",
+  "pytest-cov>=7.1",
+  "pytest-mock>=3.16",
+  "setuptools>=84",
 ]
 type = [
-  "ty>=0.0.19,<0.0.25",
+  "ty<0.0.25,>=0.0.24",
   { include-group = "docs" },
   { include-group = "test" },
 ]
 docs = [
-  "furo>=2025.9.25",
+  "furo>=2025.12.19",
   "sphinx-autodoc-typehints>=3.5.1",
-  "sphinx-llm>=0.4.1",
+  "sphinx-llm>=1.1",
 ]
 lint = [
-  "pre-commit-uv>=4.2",
+  "pre-commit-uv>=4.3",
 ]
 pkg-meta = [
   "check-wheel-contents>=0.6.3",
-  "twine>=6.2",
-  "uv>=0.10.2",
+  "twine>=7",
+  "uv>=0.12.22",
 ]
 
 [tool.hatch]

{pyproject_api-1.11.2 → pyproject_api-1.11.4}/src/pyproject_api/_frontend.py

@@ -17,7 +17,7 @@ from packaging.requirements import Requirement
 from pyproject_api._util import ensure_empty_dir
 
 if TYPE_CHECKING:
-    from collections.abc import Iterator
+    from collections.abc import Generator, Iterator
 
 if sys.version_info >= (3, 11):  # pragma: no cover (py311+)
     import tomllib
@@ -55,11 +55,11 @@ class CmdStatus(ABC):
 class RequiresBuildSdistResult(NamedTuple):
     """Information collected while acquiring the source distribution build dependencies."""
 
-    #: wheel build dependencies
+    #: source distribution build dependencies
     requires: tuple[Requirement, ...]
     #: backend standard output while acquiring the source distribution build dependencies
     out: str
-    #: backend standard output while acquiring the source distribution build dependencies
+    #: backend standard error while acquiring the source distribution build dependencies
     err: str
 
 
@@ -75,7 +75,7 @@ class RequiresBuildWheelResult(NamedTuple):
 
 
 class RequiresBuildEditableResult(NamedTuple):
-    """Information collected while acquiring the wheel build dependencies."""
+    """Information collected while acquiring the editable wheel build dependencies."""
 
     #: editable wheel build dependencies
     requires: tuple[Requirement, ...]
@@ -92,7 +92,7 @@ class MetadataForBuildWheelResult(NamedTuple):
     metadata: Path
     #: backend standard output while generating the wheel metadata
     out: str
-    #: backend standard output while generating the wheel metadata
+    #: backend standard error while generating the wheel metadata
     err: str
 
 
@@ -103,7 +103,7 @@ class MetadataForBuildEditableResult(NamedTuple):
     metadata: Path
     #: backend standard output while generating the editable wheel metadata
     out: str
-    #: backend standard output while generating the editable wheel metadata
+    #: backend standard error while generating the editable wheel metadata
     err: str
 
 
@@ -114,7 +114,7 @@ class SdistResult(NamedTuple):
     sdist: Path
     #: backend standard output while building the source distribution
     out: str
-    #: backend standard output while building the source distribution
+    #: backend standard error while building the source distribution
     err: str
 
 
@@ -211,10 +211,11 @@ class Frontend(ABC):
         folder: Path,
     ) -> tuple[Path, tuple[Path, ...], str, str | None, tuple[Requirement, ...], bool]:
         """
-        Frontend creation arguments from a python project folder (thould have a ``pypyproject.toml`` file per PEP-518).
+        Frontend creation arguments from a python project folder (should have a ``pyproject.toml`` file per PEP-518).
 
         :param folder: the python project folder
         :return: the frontend creation args
+        :raises ValueError: if ``build-system`` is not a table, or one of its keys has a type PEP-518 rules out
 
         E.g., to create a frontend from a python project folder:
 
@@ -226,16 +227,20 @@ class Frontend(ABC):
         if py_project_toml.exists():
             with py_project_toml.open("rb") as file_handler:
                 py_project = tomllib.load(file_handler)
-            build_system = py_project.get("build-system", {})
+            if not isinstance(build_system := py_project.get("build-system", {}), dict):
+                msg = f"build-system must be a table, got {build_system!r}"
+                raise ValueError(msg)
             if "backend-path" in build_system:
-                backend_paths: tuple[Path, ...] = tuple(folder / p for p in build_system["backend-path"])
+                backend_paths: tuple[Path, ...] = tuple(folder / p for p in _str_list(build_system, "backend-path"))
             else:
                 backend_paths = ()
             if "requires" in build_system:
-                requires: tuple[Requirement, ...] = tuple(Requirement(r) for r in build_system.get("requires"))
+                requires: tuple[Requirement, ...] = tuple(Requirement(r) for r in _str_list(build_system, "requires"))
             else:
                 requires = cls.LEGACY_REQUIRES
-            build_backend = build_system.get("build-backend", cls.LEGACY_BUILD_BACKEND)
+            if not isinstance(build_backend := build_system.get("build-backend", cls.LEGACY_BUILD_BACKEND), str):
+                msg = f"build-system.build-backend must be a string, got {build_backend!r}"
+                raise ValueError(msg)
         else:
             backend_paths = ()
             requires = cls.LEGACY_REQUIRES
@@ -490,7 +495,7 @@ class Frontend(ABC):
         return metadata_directory / basename, out, err
 
     @contextmanager
-    def _wheel_directory(self) -> Iterator[Path]:  # ruff:ignore[no-self-use]
+    def _wheel_directory(self) -> Generator[Path, None, None]:  # ruff:ignore[no-self-use]
         with TemporaryDirectory() as wheel_directory:
             yield Path(wheel_directory)
 
@@ -528,3 +533,10 @@ class Frontend(ABC):
     @contextmanager
     def _send_msg(self, cmd: str, result_file: Path, msg: str) -> Iterator[CmdStatus]:
         raise NotImplementedError
+
+
+def _str_list(build_system: dict[str, Any], key: str) -> list[str]:
+    if not isinstance(value := build_system[key], list) or not all(isinstance(entry, str) for entry in value):
+        msg = f"build-system.{key} must be a list of strings, got {value!r}"
+        raise ValueError(msg)
+    return value

{pyproject_api-1.11.2 → pyproject_api-1.11.4}/src/pyproject_api/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.11.2'
-__version_tuple__ = version_tuple = (1, 11, 2)
+__version__ = version = '1.11.4'
+__version_tuple__ = version_tuple = (1, 11, 4)
 
 __commit_id__ = commit_id = None

{pyproject_api-1.11.2 → pyproject_api-1.11.4}/src/pyproject_api/_via_fresh_subprocess.py

@@ -10,7 +10,7 @@ from typing import TYPE_CHECKING, Any, cast
 from ._frontend import CmdStatus, Frontend
 
 if TYPE_CHECKING:
-    from collections.abc import Iterator
+    from collections.abc import Generator
     from pathlib import Path
 
     from packaging.requirements import Requirement
@@ -62,7 +62,7 @@ class SubprocessFrontend(Frontend):
         self.executable = sys.executable
 
     @contextmanager
-    def _send_msg(self, cmd: str, result_file: Path, msg: str) -> Iterator[SubprocessCmdStatus]:  # ruff:ignore[unused-method-argument]
+    def _send_msg(self, cmd: str, result_file: Path, msg: str) -> Generator[SubprocessCmdStatus, None, None]:  # ruff:ignore[unused-method-argument]
         env = os.environ.copy()
         backend = os.pathsep.join(str(i) for i in self._backend_paths).strip()
         if backend:
@@ -73,6 +73,7 @@ class SubprocessFrontend(Frontend):
             stderr=PIPE,
             stdin=PIPE,
             universal_newlines=True,
+            errors="backslashreplace",
             cwd=self._root,
             env=env,
         )

{pyproject_api-1.11.2 → pyproject_api-1.11.4}/tests/test_frontend.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import re
 import subprocess  # ruff:ignore[suspicious-subprocess-import]
 import sys
 from pathlib import Path
@@ -41,8 +42,45 @@ def test_missing_backend(local_builder: Callable[[str], Path]) -> None:
     assert "ModuleNotFoundError: No module named " in exc.err
 
 
-@pytest.mark.parametrize(("stream", "output"), [("stdout", "out"), ("stderr", "err")])
-def test_large_command_with_backend_output(stream: str, output: str, local_builder: Callable[[str], Path]) -> None:
+@pytest.fixture
+def isolated_build_wheel() -> Callable[[Path, str, int], tuple[str, str]]:
+    script = dedent("""
+        import sys
+        from pathlib import Path
+        from pyproject_api import SubprocessFrontend
+
+        root = Path(sys.argv[1])
+        frontend = SubprocessFrontend(*SubprocessFrontend.create_args_from_folder(root)[:-1])
+        result = frontend.build_wheel(root / "dist", config_settings={"payload": "y" * int(sys.argv[3])})
+        print(result.wheel.name)
+        print(getattr(result, sys.argv[2]), end="")
+        """)
+
+    def _f(root: Path, output: str, payload_size: int) -> tuple[str, str]:
+        # Run the frontend in a child process so a hang fails on the timeout instead of stalling pytest.
+        result = subprocess.run(
+            [sys.executable, "-X", "utf8", "-c", script, str(root), output, str(payload_size)],
+            capture_output=True,
+            encoding="utf-8",
+            timeout=30,
+            check=True,
+        )
+        assert not result.stderr
+        wheel, captured = result.stdout.split("\n", 1)
+        return wheel, captured
+
+    return _f
+
+
+@pytest.mark.parametrize(
+    ("stream", "output"), [pytest.param("stdout", "out", id="stdout"), pytest.param("stderr", "err", id="stderr")]
+)
+def test_large_command_with_backend_output(
+    stream: str,
+    output: str,
+    local_builder: Callable[[str], Path],
+    isolated_build_wheel: Callable[[Path, str, int], tuple[str, str]],
+) -> None:
     tmp_path = local_builder(f"""
         import sys
 
@@ -53,27 +91,30 @@ def test_large_command_with_backend_output(stream: str, output: str, local_build
             assert config_settings == {{"payload": "y" * 1048576}}
             return "demo-1.0-py3-none-any.whl"
         """)
-    # Isolate the frontend so a pipe deadlock fails with a timeout instead of hanging pytest.
-    script = dedent("""
+    wheel, captured = isolated_build_wheel(tmp_path, output, 1048576)
+    assert (wheel, "x" * 1048576 in captured) == ("demo-1.0-py3-none-any.whl", True)
+
+
+@pytest.mark.parametrize(
+    ("stream", "output"), [pytest.param("stdout", "out", id="stdout"), pytest.param("stderr", "err", id="stderr")]
+)
+def test_backend_output_with_invalid_bytes(
+    stream: str,
+    output: str,
+    local_builder: Callable[[str], Path],
+    isolated_build_wheel: Callable[[Path, str, int], tuple[str, str]],
+) -> None:
+    tmp_path = local_builder(f"""
         import sys
-        from pathlib import Path
-        from pyproject_api import SubprocessFrontend
 
-        root = Path(sys.argv[1])
-        frontend = SubprocessFrontend(*SubprocessFrontend.create_args_from_folder(root)[:-1])
-        result = frontend.build_wheel(root / "dist", config_settings={"payload": "y" * 1048576})
-        print(result.wheel.name)
-        print("x" * 1048576 in getattr(result, sys.argv[2]))
+        sys.{stream}.buffer.write(b"before\\xffafter")
+        sys.{stream}.flush()
+
+        def build_wheel(wheel_directory, config_settings=None, metadata_directory=None):
+            return "demo-1.0-py3-none-any.whl"
         """)
-    result = subprocess.run(
-        [sys.executable, "-c", script, str(tmp_path), output],
-        capture_output=True,
-        text=True,
-        timeout=30,
-        check=True,
-    )
-    assert result.stdout.splitlines() == ["demo-1.0-py3-none-any.whl", "True"]
-    assert not result.stderr
+    wheel, captured = isolated_build_wheel(tmp_path, output, 0)
+    assert (wheel, "before\\xffafter" in captured) == ("demo-1.0-py3-none-any.whl", True)
 
 
 def test_large_command_with_failed_backend(local_builder: Callable[[str], Path]) -> None:
@@ -128,6 +169,38 @@ def test_backend_build_sdist_demo_pkg_inline(tmp_path: Path, demo_pkg_inline: Pa
     assert result.sdist == tmp_path / "demo_pkg_inline-1.0.0.tar.gz"
 
 
+@pytest.mark.parametrize(
+    ("toml", "message"),
+    [
+        pytest.param(
+            '[build-system]\nrequires = "setuptools"',
+            "build-system.requires must be a list of strings, got 'setuptools'",
+            id="requires-string",
+        ),
+        pytest.param(
+            '[build-system]\nrequires = [{name = "setuptools"}]',
+            "build-system.requires must be a list of strings, got [{'name': 'setuptools'}]",
+            id="requires-table-entry",
+        ),
+        pytest.param(
+            '[build-system]\nbackend-path = "build"',
+            "build-system.backend-path must be a list of strings, got 'build'",
+            id="backend-path-string",
+        ),
+        pytest.param(
+            "[build-system]\nbuild-backend = 42",
+            "build-system.build-backend must be a string, got 42",
+            id="build-backend-int",
+        ),
+        pytest.param('build-system = "setuptools"', "build-system must be a table, got 'setuptools'", id="not-a-table"),
+    ],
+)
+def test_create_args_from_folder_rejects_bad_build_system_type(tmp_path: Path, toml: str, message: str) -> None:
+    (tmp_path / "pyproject.toml").write_text(toml)
+    with pytest.raises(ValueError, match=rf"^{re.escape(message)}$"):
+        SubprocessFrontend.create_args_from_folder(tmp_path)
+
+
 def test_backend_obj(tmp_path: Path) -> None:
     toml = """
         [build-system]

{pyproject_api-1.11.2 → pyproject_api-1.11.4}/tests/test_frontend_setuptools.py

@@ -11,7 +11,7 @@ from pyproject_api._frontend import BackendFailed
 from pyproject_api._via_fresh_subprocess import SubprocessFrontend
 
 if TYPE_CHECKING:
-    from collections.abc import Iterator
+    from collections.abc import Generator
     from pathlib import Path
 
     from _pytest.tmpdir import TempPathFactory
@@ -149,7 +149,7 @@ class _Result(NamedTuple):
 
 def test_result_missing(frontend_setuptools: SubprocessFrontend, tmp_path: Path, mocker: MockerFixture) -> None:
     @contextmanager
-    def named_temporary_file(prefix: str) -> Iterator[_Result]:
+    def named_temporary_file(prefix: str) -> Generator[_Result, None, None]:
         write = S_IWUSR | S_IWGRP | S_IWOTH
         base = tmp_path / prefix
         result = base.with_suffix(".json")

{pyproject_api-1.11.2 → pyproject_api-1.11.4}/tox.toml

@@ -1,4 +1,4 @@
-requires = [ "tox>=4.34.1", "tox-uv>=1.29" ]
+requires = [ "tox>=4.64.7", "tox-uv>=1.36.1" ]
 env_list = [ "3.15", "3.14", "3.13", "3.12", "3.11", "3.10", "3.15t", "docs", "fix", "pkg_meta", "type" ]
 skip_missing_interpreters = true