PyPI - compiletools - Versions diffs - 8.2.2__tar.gz → 8.2.3__tar.gz - Mend

compiletools 8.2.2tar.gz → 8.2.3tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (428) hide show

{compiletools-8.2.2 → compiletools-8.2.3}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: compiletools
-Version: 8.2.2
+Version: 8.2.3
 Summary: Tools to make compiling C/C++ projects easy
 Keywords: c++,make,development
 Author: DrGeoff
@@ -23,7 +23,7 @@ Requires-Dist: rich-rst>=1.1.7
 Requires-Dist: stringzilla>=3.0.0
 Requires-Dist: bump-my-version>=0.26.0 ; extra == 'dev'
 Requires-Dist: twine>=5.0.0 ; extra == 'dev'
-Requires-Dist: pytest>=8.2.2 ; extra == 'dev'
+Requires-Dist: pytest>=8.2.3 ; extra == 'dev'
 Requires-Dist: pytest-xdist>=3.5 ; extra == 'dev'
 Requires-Dist: ruff>=0.14.0 ; extra == 'dev'
 Requires-Dist: pyright>=1.1 ; extra == 'dev'
@@ -55,7 +55,7 @@ C/C++ build tools that requires almost no configuration.
 :Author: drgeoffathome@gmail.com
 :Date:   2025-12-17
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/pyproject.toml RENAMED Viewed

@@ -1,6 +1,6 @@
 [project]
 name = "compiletools"
-version = "8.2.2"
+version = "8.2.3"
 description = "Tools to make compiling C/C++ projects easy"
 readme = "src/compiletools/README.ct-doc.rst"
 requires-python = ">=3.10"
@@ -36,7 +36,7 @@ tui = [
 dev = [
     "bump-my-version>=0.26.0",
     "twine>=5.0.0",
-    "pytest>=8.2.2",
+    "pytest>=8.2.3",
     "pytest-xdist>=3.5",
     "ruff>=0.14.0",
     "pyright>=1.1",
@@ -96,7 +96,7 @@ include = [
 ]
 [tool.bumpversion]
-current_version = "8.2.2"
+current_version = "8.2.3"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 search = "{current_version}"

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.cleanup-remote-locks.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Legacy helper for pruning stale lockdir directories remotely
 :Author: drgeoffathome@gmail.com
 :Date:   2025-11-26
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.create-documentation.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Generate man(1) pages from the reStructuredText source tree
 :Author: drgeoffathome@gmail.com
 :Date:   2025-11-26
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-backends.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Build backend architecture and selection guide
 :Author: drgeoffathome@gmail.com
 :Date:   2026-04-02
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 7
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-build-dynamic-library.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Produce a shared object from a root source file with zero boilerplate
 :Author: drgeoffathome@gmail.com
 :Date:   2025-11-26
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-build-static-library.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Generate a static library from a root source file in one shot
 :Author: drgeoffathome@gmail.com
 :Date:   2025-11-26
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-build.rst RENAMED Viewed

@@ -8,7 +8,7 @@ One-command Make-specific wrapper around ct-findtargets + make
 :Author: drgeoffathome@gmail.com
 :Date:   2025-11-26
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-cake.rst RENAMED Viewed

@@ -9,7 +9,7 @@ Swiss army knife for building a C/C++ project
 :Author: drgeoffathome@gmail.com
 :Date:   2018-02-06
 :Copyright: Copyright (C) 2011-2016 Zomojo Pty Ltd
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-cleanup-locks.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Clean up stale lock directories from file locking
 :Author: drgeoffathome@gmail.com
 :Date:   2025-10-16
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-commandline.rst RENAMED Viewed

@@ -9,7 +9,7 @@ This document describes the command line arguments that are common across ct-* p
 :Author: drgeoffathome@gmail.com
 :Date:   2017-07-06
 :Copyright: Copyright (C) 2011-2016 Zomojo Pty Ltd
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-compilation-database.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Generate compile_commands.json for clang tooling and IDE integration
 :Author: drgeoffathome@gmail.com
 :Date:   2025-10-08
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-config.rst RENAMED Viewed

@@ -9,7 +9,7 @@ Helper tool for examining ct-* configuration
 :Author: drgeoffathome@gmail.com
 :Date:   2016-08-16
 :Copyright: Copyright (C) 2011-2016 Zomojo Pty Ltd
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-cppdeps.rst RENAMED Viewed

@@ -9,7 +9,7 @@ C/C++ dependency analysis using the preprocessor
 :Author: drgeoffathome@gmail.com
 :Date:   2022-06-05
 :Copyright: Copyright (C) Geoffery Ericksson
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-create-makefile.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Generate Makefile from compiletools magic
 :Author: drgeoffathome@gmail.com
 :Date:   2024-11-24
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-doc.rst RENAMED Viewed

@@ -15,7 +15,7 @@ C/C++ build tools that requires almost no configuration.
 :Author: drgeoffathome@gmail.com
 :Date:   2025-12-17
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-filelist.rst RENAMED Viewed

@@ -9,7 +9,7 @@ Determine header and source dependencies of a C/C++ file by following headers an
 :Author: drgeoffathome@gmail.com
 :Date:   2017-07-06
 :Copyright: Copyright (C) 2011-2016 Zomojo Pty Ltd
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-findtargets.rst RENAMED Viewed

@@ -9,7 +9,7 @@ Find executable and test targets in a C/C++ project
 :Author: drgeoffathome@gmail.com
 :Date:   2018-04-17
 :Copyright: Copyright (C) 2011-2018 Zomojo Pty Ltd
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-git-sha-report.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Report git blob SHA hashes for files in the repository
 :Author: drgeoffathome@gmail.com
 :Date:   2024-11-24
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-gitroot.rst RENAMED Viewed

@@ -9,7 +9,7 @@ Display the git repository root directory
 :Author: drgeoffathome@gmail.com
 :Date:   2017-09-28
 :Copyright: Copyright (C) 2011-2016 Zomojo Pty Ltd
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-headertree.rst RENAMED Viewed

@@ -9,7 +9,7 @@ Create a tree of header dependencies starting at the given C/C++ file
 :Author: drgeoffathome@gmail.com
 :Date:   2018-07-26
 :Copyright: Copyright (C) 2011-2018 Zomojo Pty Ltd
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-jobs.rst RENAMED Viewed

@@ -9,7 +9,7 @@ Determine optimal parallel job count for builds
 :Author: drgeoffathome@gmail.com
 :Date:   2017-04-28
 :Copyright: Copyright (C) 2011-2016 Zomojo Pty Ltd
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-list-backends.rst RENAMED Viewed

@@ -8,7 +8,7 @@ List available build backends
 :Author: drgeoffathome@gmail.com
 :Date:   2026-03-31
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-list-variants.rst RENAMED Viewed

@@ -9,7 +9,7 @@ List available build variants
 :Author: drgeoffathome@gmail.com
 :Date:   2016-08-16
 :Copyright: Copyright (C) 2011-2016 Zomojo Pty Ltd
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-lock-helper.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Helper for file locking during concurrent compilation
 :Author: drgeoffathome@gmail.com
 :Date:   2024-01-01
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-magicflags.rst RENAMED Viewed

@@ -9,7 +9,7 @@ Show the magic flags / magic comments that a file exports
 :Author: drgeoffathome@gmail.com
 :Date:   2018-02-23
 :Copyright: Copyright (C) 2011-2018 Zomojo Pty Ltd
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-release.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Automated version bump + build + publish for compiletools
 :Author: drgeoffathome@gmail.com
 :Date:   2025-11-26
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-timing-report.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Analyze and display build timing reports
 :Author: drgeoffathome@gmail.com
 :Date:   2026-04-06
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-trim-cache.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Trim stale entries from shared object and PCH caches
 :Author: drgeoffathome@gmail.com
 :Date:   2026-04-21
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.ct-watch-build.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Continuous rebuild helper that watches sources with inotify
 :Author: drgeoffathome@gmail.com
 :Date:   2025-11-26
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/README.profile-ct-cake-worktree.rst RENAMED Viewed

@@ -8,7 +8,7 @@ Safely profile ct-cake performance using temporary git worktrees
 :Author: drgeoffathome@gmail.com
 :Date:   2025-11-26
-:Version: 8.2.2
+:Version: 8.2.3
 :Manual section: 1
 :Manual group: developers

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/build_backend.py RENAMED Viewed

@@ -554,13 +554,14 @@ class BuildBackend(abc.ABC):
             test_result_paths = []
             for exe_path in test_exe_paths:
                 result_path = exe_path + ".result"
-                test_cmd = testprefix_parts + [exe_path, "&&", "touch", result_path]
+                test_cmd = testprefix_parts + [exe_path]
                 graph.add_rule(
                     BuildRule(
                         output=result_path,
                         inputs=[exe_path],
                         command=test_cmd,
                         rule_type="test",
+                        success_marker=result_path,
                     )
                 )
                 test_result_paths.append(result_path)

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/build_graph.py RENAMED Viewed

@@ -7,6 +7,7 @@ Backends consume a BuildGraph to produce their native output format.
 from __future__ import annotations
+import shlex
 from dataclasses import dataclass, field
 VALID_RULE_TYPES = frozenset(
@@ -29,19 +30,26 @@ class BuildRule:
     Attributes:
         output: The file this rule produces (or a phony target name).
         inputs: Files this rule depends on (source files, headers, objects).
-        command: List of **shell tokens** (NOT argv) to execute, or None
-            for phony rules. Tokens are space-joined and executed under
-            ``/bin/sh -c`` by every backend, so shell metacharacters
-            (``&&``, ``||``, ``>``, ``$VAR``, ...) are interpreted as
-            shell syntax — *not* passed literally to the program. A
-            future backend that hands the list straight to
-            ``subprocess.run(..., shell=False)`` would need to either
-            re-shellify the tokens or refuse rules that contain
-            metacharacter elements.
+        command: argv list passed directly to ``subprocess.run`` (with
+            ``shell=False`` semantics), or None for phony rules. Tokens
+            MUST NOT contain shell metacharacters (``&&``, ``||``, ``>``,
+            ``$VAR``, ...) — side effects like "touch a marker on success"
+            belong in ``success_marker``, not in command tokens. Shell-rendered
+            backends (Make, Ninja) join with spaces and let the underlying
+            tool run the result through ``/bin/sh -c``; argv-executing
+            backends (Shake, Slurm) hand the list straight to subprocess.
+            Both behaviours agree as long as no token is shell-active.
         rule_type: One of "compile", "link", "test", "phony", "mkdir", "clean",
             "copy", "static_library", "shared_library".
         order_only_deps: Dependencies that must exist but whose timestamps are
             not checked (e.g., output directories).
+        success_marker: Optional path to ``touch`` after the command exits
+            successfully. Used by test rules to record passes for incremental
+            re-runs. Each backend renders this in its native idiom: shell
+            backends append ``&& touch <marker>`` to the recipe; argv backends
+            call ``Path(marker).touch()`` after the subprocess returns 0.
+            Backends that own their own pass/fail bookkeeping (CMake CTest,
+            Bazel cc_test) ignore this field.
     Equality and hash are by ``output`` only — deliberate so that
     BuildGraph._rules (a dict keyed by output) deduplicates rules. Rules
@@ -55,6 +63,7 @@ class BuildRule:
     rule_type: str
     order_only_deps: list[str] = field(default_factory=list)
     include_weight: int = 0
+    success_marker: str | None = None
     def __post_init__(self):
         if self.rule_type not in VALID_RULE_TYPES:
@@ -158,3 +167,16 @@ class BuildGraph:
                 filtered.add_rule(rule)
         return filtered
+def render_shell_recipe(rule: BuildRule) -> str:
+    """Render rule.command as a shell-executable string, appending the
+    success_marker touch tail when set.
+    Used by shell-rendered backends (Make, Ninja) for non-compile/non-link
+    rules whose command is intended to run through ``/bin/sh -c``.
+    """
+    cmd_str = shlex.join(rule.command)
+    if rule.success_marker:
+        cmd_str += f" && touch {shlex.quote(rule.success_marker)}"
+    return cmd_str

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/makefile_backend.py RENAMED Viewed

@@ -22,7 +22,7 @@ from compiletools.build_backend import (
     BuildBackend,
     register_backend,
 )
-from compiletools.build_graph import BuildGraph
+from compiletools.build_graph import BuildGraph, render_shell_recipe
 @functools.lru_cache(maxsize=1)
@@ -271,14 +271,14 @@ class MakefileBackend(BuildBackend):
             else:
                 recipe = cmd_str
         elif rule.rule_type == "test":
-            cmd_str = " ".join(rule.command)
+            cmd_str = render_shell_recipe(rule)
             if self.args.verbose >= 1:
                 exe_name = rule.inputs[0] if rule.inputs else rule.output
                 recipe = f"@echo ... {exe_name} ; {cmd_str}"
             else:
                 recipe = cmd_str
         else:
-            recipe = " ".join(rule.command)
+            recipe = render_shell_recipe(rule)
         if self._timing_enabled and rule.rule_type in ("compile", "link", "shared_library", "static_library"):
             recipe = self._wrap_with_timing(recipe, rule.output)

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/ninja_backend.py RENAMED Viewed

@@ -10,7 +10,7 @@ from compiletools.build_backend import (
     BuildBackend,
     register_backend,
 )
-from compiletools.build_graph import BuildGraph
+from compiletools.build_graph import BuildGraph, render_shell_recipe
 @register_backend
@@ -94,7 +94,7 @@ class NinjaBackend(BuildBackend):
                 elif rule.rule_type in ("link", "static_library", "shared_library"):
                     cmd_str = self._wrap_link_cmd(rule.command)
                 else:
-                    cmd_str = " ".join(rule.command)
+                    cmd_str = render_shell_recipe(rule)
                 f.write(f"  cmd = {cmd_str}\n")
             f.write("\n")

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/test_build_backend.py RENAMED Viewed

@@ -354,13 +354,45 @@ class TestBuildGraphPopulation:
         rule = test_rules[0]
         assert rule.output == f"{bindir}/test_foo.result"
         assert rule.inputs == [f"{bindir}/test_foo"]
-        # The recipe must NOT self-delete its own output (Fix 2): make's
-        # mtime check skips re-running the test only when .result is fresher
-        # than the executable.
+        # The recipe must NOT self-delete its own output: make's mtime check
+        # skips re-running the test only when .result is fresher than the exe.
         assert "rm" not in rule.command
-        assert "touch" in rule.command
         assert f"{bindir}/test_foo" in rule.command
+    def test_test_result_rule_command_is_pure_argv(self, tmp_path):
+        """Test rule command must be argv-only — no shell metacharacters.
+        Touch-on-success is modeled via success_marker, not embedded in command
+        tokens. argv-executing backends (Shake, Slurm) pass command straight to
+        subprocess.run and would otherwise feed '&&' / 'touch' to the test exe
+        as ignored argv parameters.
+        """
+        args = make_backend_args(tmp_path, filename=[], tests=["/src/test_foo.cpp"])
+        hunter = make_mock_hunter(sources=["/src/test_foo.cpp"])
+        backend = self._make_backend(tmp_path, args=args, hunter=hunter)
+        bindir = str(tmp_path / "bin")
+        graph = backend.build_graph()
+        test_rules = graph.rules_by_type("test")
+        assert len(test_rules) == 1
+        rule = test_rules[0]
+        assert "&&" not in rule.command
+        assert "touch" not in rule.command
+        assert rule.command == [f"{bindir}/test_foo"]
+    def test_test_result_rule_carries_success_marker(self, tmp_path):
+        """Test rule must declare its .result file as success_marker."""
+        args = make_backend_args(tmp_path, filename=[], tests=["/src/test_foo.cpp"])
+        hunter = make_mock_hunter(sources=["/src/test_foo.cpp"])
+        backend = self._make_backend(tmp_path, args=args, hunter=hunter)
+        bindir = str(tmp_path / "bin")
+        graph = backend.build_graph()
+        test_rules = graph.rules_by_type("test")
+        assert test_rules[0].success_marker == f"{bindir}/test_foo.result"
     def test_test_result_rules_include_testprefix(self, tmp_path):
         """Test result rules should include TESTPREFIX when set."""
         args = make_backend_args(tmp_path, filename=[], tests=["/src/test_foo.cpp"])

{compiletools-8.2.2 → compiletools-8.2.3}/src/compiletools/test_build_graph.py RENAMED Viewed

@@ -49,6 +49,25 @@ class TestBuildRule:
         )
         assert rule.order_only_deps == ["/tmp/obj/"]
+    def test_success_marker_defaults_to_none(self):
+        rule = BuildRule(
+            output="/tmp/obj/foo.o",
+            inputs=["/src/foo.cpp"],
+            command=["g++", "-c", "/src/foo.cpp"],
+            rule_type="compile",
+        )
+        assert rule.success_marker is None
+    def test_success_marker_accepts_path(self):
+        rule = BuildRule(
+            output="/tmp/bin/foo.result",
+            inputs=["/tmp/bin/foo"],
+            command=["/tmp/bin/foo"],
+            rule_type="test",
+            success_marker="/tmp/bin/foo.result",
+        )
+        assert rule.success_marker == "/tmp/bin/foo.result"
 class TestBuildGraph:
     def test_empty_graph(self):

compiletools 8.2.2__tar.gz → 8.2.3__tar.gz

compiletools 8.2.2tar.gz → 8.2.3tar.gz