gha-utils 4.20.0__py3-none-any.whl → 4.22.0__py3-none-any.whl

gha_utils/__init__.py

@@ -17,4 +17,4 @@
 
 from __future__ import annotations
 
-__version__ = "4.20.0"
+__version__ = "4.22.0"

gha_utils/cli.py

@@ -239,9 +239,9 @@ def changelog(ctx, source, changelog_path):
     "--create-if-missing/--skip-if-missing",
     is_flag=True,
     default=True,
-    help="Create the destination mailmap file if it is not found. Or skip the update "
-    "process entirely if if does not already exists in the first place. This option "
-    f"is ignore if the destination is to print the result to {sys.stdout.name}.",
+    help="If not found, either create the missing destination mailmap file, or skip "
+    "the update process entirely. This option is ignored if the destination is to print "
+    f"the result to {sys.stdout.name}.",
 )
 @argument(
     "destination_mailmap",

gha_utils/metadata.py

@@ -23,9 +23,16 @@ The following variables are `printed to the environment file
 is_bot=false
 new_commits=346ce664f055fbd042a25ee0b7e96702e95 6f27db47612aaee06fdf08744b09a9f5f6c2
 release_commits=6f27db47612aaee06fdf08744b09a9f5f6c2
+mailmap_exists=true
 gitignore_exists=true
 python_files=".github/update_mailmap.py" ".github/metadata.py" "setup.py"
+json_files=
+yaml_files="config.yaml" ".github/workflows/lint.yaml" ".github/workflows/test.yaml"
+workflow_files=".github/workflows/lint.yaml" ".github/workflows/test.yaml"
 doc_files="changelog.md" "readme.md" "docs/license.md"
+markdown_files="changelog.md" "readme.md" "docs/license.md"
+image_files=
+zsh_files=
 is_python_project=true
 package_name=click-extra
 blacken_docs_params=--target-version py37 --target-version py38
@@ -80,14 +87,14 @@ build_targets=[
     },
     {
         "target": "macos-arm64",
-        "os": "macos-15",
+        "os": "macos-26",
         "platform_id": "macos",
         "arch": "arm64",
         "extension": "bin"
     },
     {
         "target": "macos-x64",
-        "os": "macos-13",
+        "os": "macos-15-intel",
         "platform_id": "macos",
         "arch": "x64",
         "extension": "bin"
@@ -111,8 +118,8 @@ nuitka_matrix={
     "os": [
         "ubuntu-24.04-arm",
         "ubuntu-24.04",
-        "macos-15",
-        "macos-13",
+        "macos-26",
+        "macos-15-intel",
         "windows-11-arm",
         "windows-2025"
     ],
@@ -138,14 +145,14 @@ nuitka_matrix={
         },
         {
             "target": "macos-arm64",
-            "os": "macos-15",
+            "os": "macos-26",
             "platform_id": "macos",
             "arch": "arm64",
             "extension": "bin"
         },
         {
             "target": "macos-x64",
-            "os": "macos-13",
+            "os": "macos-15-intel",
             "platform_id": "macos",
             "arch": "x64",
             "extension": "bin"
@@ -206,25 +213,25 @@ nuitka_matrix={
             "bin_name": "mpm-linux-x64-6f27db4.bin"
         },
         {
-            "os": "macos-15",
+            "os": "macos-26",
             "entry_point": "mpm",
             "commit": "346ce664f055fbd042a25ee0b7e96702e95",
             "bin_name": "mpm-macos-arm64-346ce66.bin"
         },
         {
-            "os": "macos-15",
+            "os": "macos-26",
             "entry_point": "mpm",
             "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
             "bin_name": "mpm-macos-arm64-6f27db4.bin"
         },
         {
-            "os": "macos-13",
+            "os": "macos-15-intel",
             "entry_point": "mpm",
             "commit": "346ce664f055fbd042a25ee0b7e96702e95",
             "bin_name": "mpm-macos-x64-346ce66.bin"
         },
         {
-            "os": "macos-13",
+            "os": "macos-15-intel",
             "entry_point": "mpm",
             "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
             "bin_name": "mpm-macos-x64-6f27db4.bin"
@@ -288,6 +295,7 @@ from extra_platforms import is_github_ci
 from packaging.specifiers import SpecifierSet
 from packaging.version import Version
 from py_walk import get_parser_from_file
+from py_walk.models import Parser
 from pydriller import Commit, Git, Repository  # type: ignore[import-untyped]
 from pyproject_metadata import ConfigurationError, StandardMetadata
 from wcmatch.glob import (
@@ -312,6 +320,8 @@ SHORT_SHA_LENGTH = 7
     depends on the size of the repository.
 """
 
+MAILMAP_PATH = Path(".mailmap")
+
 GITIGNORE_PATH = Path(".gitignore")
 
 NUITKA_BUILD_TARGETS = {
@@ -328,13 +338,13 @@ NUITKA_BUILD_TARGETS = {
         "extension": "bin",
     },
     "macos-arm64": {
-        "os": "macos-15",
+        "os": "macos-26",
         "platform_id": "macos",
         "arch": "arm64",
         "extension": "bin",
     },
     "macos-x64": {
-        "os": "macos-13",
+        "os": "macos-15-intel",
         "platform_id": "macos",
         "arch": "x64",
         "extension": "bin",
@@ -472,6 +482,10 @@ MYPY_VERSION_MIN: Final = (3, 8)
 """
 
 
+# Silence overly verbose debug messages from py-walk logger.
+logging.getLogger("py_walk").setLevel(logging.WARNING)
+
+
 class JSONMetadata(json.JSONEncoder):
     """Custom JSON encoder for metadata serialization."""
 
@@ -531,10 +545,15 @@ class Metadata:
         logging.debug(json.dumps(context, indent=4))
         return context  # type:ignore[no-any-return]
 
-    def git_stash_count(self, git_repo: Git) -> int:
+    @cached_property
+    def git(self) -> Git:
+        """Return a PyDriller Git object."""
+        return Git(".")
+
+    def git_stash_count(self) -> int:
         """Returns the number of stashes."""
         count = int(
-            git_repo.repo.git.rev_list(
+            self.git.repo.git.rev_list(
                 "--walk-reflogs", "--ignore-missing", "--count", "refs/stash"
             )
         )
@@ -579,8 +598,7 @@ class Metadata:
         if not commits:
             return None
 
-        git = Git(".")
-        current_commit = git.repo.head.commit.hexsha
+        current_commit = self.git.repo.head.commit.hexsha
 
         # Check if we need to get back in time in the Git log and browse past commits.
         if len(commits) == 1:  # type: ignore[arg-type]
@@ -608,17 +626,17 @@ class Metadata:
             # Save the initial commit reference and SHA of the repository. The
             # reference is either the canonical active branch name (i.e. ``main``), or
             # the commit SHA if the current HEAD commit is detached from a branch.
-            if git.repo.head.is_detached:
+            if self.git.repo.head.is_detached:
                 init_ref = current_commit
             else:
-                init_ref = git.repo.active_branch.name
+                init_ref = self.git.repo.active_branch.name
             logging.debug(f"Initial commit reference: {init_ref}")
 
             # Try to stash local changes and check if we'll need to unstash them later.
-            counter_before = self.git_stash_count(git)
+            counter_before = self.git_stash_count()
             logging.debug("Try to stash local changes before our series of checkouts.")
-            git.repo.git.stash()
-            counter_after = self.git_stash_count(git)
+            self.git.repo.git.stash()
+            counter_after = self.git_stash_count()
             logging.debug(
                 "Stash counter changes after 'git stash' command: "
                 f"{counter_before} -> {counter_after}"
@@ -639,7 +657,7 @@ class Metadata:
         for commit in commits:
             if past_commit_lookup:
                 logging.debug(f"Checkout to commit {commit.hash}")
-                git.checkout(commit.hash)
+                self.git.checkout(commit.hash)
 
             commit_metadata = {
                 "commit": commit.hash,
@@ -657,10 +675,10 @@ class Metadata:
         # Restore the repository to its initial state.
         if past_commit_lookup:
             logging.debug(f"Restore repository to {init_ref}.")
-            git.checkout(init_ref)
+            self.git.checkout(init_ref)
             if need_unstash:
                 logging.debug("Unstash local changes that were previously saved.")
-                git.repo.git.stash("pop")
+                self.git.repo.git.stash("pop")
 
         return matrix
 
@@ -719,7 +737,7 @@ class Metadata:
         return False
 
     @cached_property
-    def commit_range(self) -> tuple[str, str] | None:
+    def commit_range(self) -> tuple[str | None, str] | None:
         """Range of commits bundled within the triggering event.
 
         A workflow run is triggered by a singular event, which might encapsulate one or
@@ -766,7 +784,7 @@ class Metadata:
             end = self.github_context["event"]["pull_request"]["head"]["sha"]
         # Push event.
         else:
-            start = self.github_context["event"]["before"]
+            start = self.github_context["event"].get("before")
             end = os.environ["GITHUB_SHA"]
             assert end
         logging.debug(f"Commit range: {start} -> {end}")
@@ -788,15 +806,41 @@ class Metadata:
         if not self.commit_range:
             return None
         start, end = self.commit_range
-        # Remove the last commit, as the commit range is inclusive.
-        return tuple(
-            Repository(
-                ".",
-                from_commit=start,
-                to_commit=end,
-                order="reverse",
-            ).traverse_commits(),
-        )[:-1]
+
+        # Sanity check: make sure the start commit exists in the repository.
+        # XXX Even if we skip the start commit later on (because the range is
+        # inclusive), we still need to make sure it exists: PyDriller stills needs to
+        # find it to be able to traverse the commit history.
+        for commit_id in (start, end):
+            if not commit_id:
+                continue
+            try:
+                _ = self.git.get_commit(commit_id)
+            except ValueError:
+                logging.error(
+                    f"Cannot find commit {commit_id} in repository. "
+                    "Repository was probably not checked out with enough depth. "
+                    f"Current depth is {self.git.total_commits()}. "
+                )
+                logging.warning(
+                    "Skipping metadata extraction of the range of new commits."
+                )
+                return None
+
+        if not start:
+            logging.warning("No start commit found. Only one commit in range.")
+            assert end
+            return (self.git.get_commit(end),)
+
+        commit_list = []
+        for index, commit in enumerate(
+            Repository(".", from_commit=start, to_commit=end).traverse_commits()
+        ):
+            # Skip the first commit because the commit range is inclusive.
+            if index == 0:
+                continue
+            commit_list.append(commit)
+        return tuple(commit_list)
 
     @cached_property
     def new_commits_matrix(self) -> Matrix | None:
@@ -845,10 +889,27 @@ class Metadata:
             else None
         )
 
+    @cached_property
+    def mailmap_exists(self) -> bool:
+        return MAILMAP_PATH.is_file()
+
     @cached_property
     def gitignore_exists(self) -> bool:
         return GITIGNORE_PATH.is_file()
 
+    @cached_property
+    def gitignore_parser(self) -> Parser | None:
+        """Returns a parser for the ``.gitignore`` file, if it exists."""
+        if self.gitignore_exists:
+            logging.debug(f"Parse {GITIGNORE_PATH}")
+            return get_parser_from_file(GITIGNORE_PATH)
+        return None
+
+    def gitignore_match(self, file_path: Path | str) -> bool:
+        if self.gitignore_parser and self.gitignore_parser.match(file_path):
+            return True
+        return False
+
     def glob_files(self, *patterns: str) -> list[Path]:
         """Return all file path matching the ``patterns``.
 
@@ -878,12 +939,6 @@ class Metadata:
         current_dir = Path.cwd()
         seen = set()
 
-        # If the .gitignore file exists, we parse it to filter out ignored files.
-        gitignore = None
-        if self.gitignore_exists:
-            logging.debug(f"Load {GITIGNORE_PATH} to filter out ignored files.")
-            gitignore = get_parser_from_file(GITIGNORE_PATH)
-
         for file_path in iglob(
             patterns,
             flags=NODIR | GLOBSTAR | DOTGLOB | GLOBTILDE | BRACE | FOLLOW | NEGATE,
@@ -913,7 +968,7 @@ class Metadata:
                 continue
 
             # Skip files that are ignored by .gitignore.
-            if gitignore and gitignore.match(file_path):
+            if self.gitignore_match(file_path):
                 logging.debug(f"Skip file matching {GITIGNORE_PATH}: {file_path}")
                 continue
 
@@ -934,6 +989,16 @@ class Metadata:
             "!**/package-lock.json",
         )
 
+    @cached_property
+    def yaml_files(self) -> list[Path]:
+        """Returns a list of YAML files."""
+        return self.glob_files("**/*.{yaml,yml}")
+
+    @cached_property
+    def workflow_files(self) -> list[Path]:
+        """Returns a list of GitHub workflow files."""
+        return self.glob_files(".github/workflows/**/*.{yaml,yml}")
+
     @cached_property
     def doc_files(self) -> list[Path]:
         """Returns a list of doc files."""
@@ -946,6 +1011,15 @@ class Metadata:
         """Returns a list of Markdown files."""
         return self.glob_files("**/*.{markdown,mdown,mkdn,mdwn,mkd,md,mdtxt,mdtext}")
 
+    @cached_property
+    def image_files(self) -> list[Path]:
+        """Returns a list of image files.
+
+        Inspired by the list of image extensions supported by calibre's image-actions:
+        https://github.com/calibreapp/image-actions/blob/f325757/src/constants.ts#L32
+        """
+        return self.glob_files("**/*.{jpeg,jpg,png,webp,avif}")
+
     @cached_property
     def zsh_files(self) -> list[Path]:
         """Returns a list of Zsh files."""
@@ -1194,8 +1268,8 @@ class Metadata:
                 "os": [
                     "ubuntu-24.04-arm",
                     "ubuntu-24.04",
-                    "macos-15",
-                    "macos-13",
+                    "macos-26",
+                    "macos-15-intel",
                     "windows-11-arm",
                     "windows-2025",
                 ],
@@ -1223,14 +1297,14 @@ class Metadata:
                     },
                     {
                         "target": "macos-arm64",
-                        "os": "macos-15",
+                        "os": "macos-26",
                         "platform_id": "macos",
                         "arch": "arm64",
                         "extension": "bin",
                     },
                     {
                         "target": "macos-x64",
-                        "os": "macos-13",
+                        "os": "macos-15-intel",
                         "platform_id": "macos",
                         "arch": "x64",
                         "extension": "bin",
@@ -1291,25 +1365,25 @@ class Metadata:
                         "bin_name": "mpm-linux-x64-6f27db4.bin",
                     },
                     {
-                        "os": "macos-15",
+                        "os": "macos-26",
                         "entry_point": "mpm",
                         "commit": "346ce664f055fbd042a25ee0b7e96702e95",
                         "bin_name": "mpm-macos-arm64-346ce66.bin",
                     },
                     {
-                        "os": "macos-15",
+                        "os": "macos-26",
                         "entry_point": "mpm",
                         "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
                         "bin_name": "mpm-macos-arm64-6f27db4.bin",
                     },
                     {
-                        "os": "macos-13",
+                        "os": "macos-15-intel",
                         "entry_point": "mpm",
                         "commit": "346ce664f055fbd042a25ee0b7e96702e95",
                         "bin_name": "mpm-macos-x64-346ce66.bin",
                     },
                     {
-                        "os": "macos-13",
+                        "os": "macos-15-intel",
                         "entry_point": "mpm",
                         "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
                         "bin_name": "mpm-macos-x64-6f27db4.bin",
@@ -1510,11 +1584,15 @@ class Metadata:
             "is_bot": self.is_bot,
             "new_commits": self.new_commits_hash,
             "release_commits": self.release_commits_hash,
+            "mailmap_exists": self.mailmap_exists,
             "gitignore_exists": self.gitignore_exists,
             "python_files": self.python_files,
             "json_files": self.json_files,
+            "yaml_files": self.yaml_files,
+            "workflow_files": self.workflow_files,
             "doc_files": self.doc_files,
             "markdown_files": self.markdown_files,
+            "image_files": self.image_files,
             "zsh_files": self.zsh_files,
             "is_python_project": self.is_python_project,
             "package_name": self.package_name,

gha_utils/test_plan.py

@@ -28,7 +28,11 @@ from typing import Generator, Sequence
 import yaml
 from boltons.iterutils import flatten
 from boltons.strutils import strip_ansi
-from click_extra.testing import args_cleanup, render_cli_run
+from click_extra.testing import (
+    args_cleanup,
+    regex_fullmatch_line_by_line,
+    render_cli_run,
+)
 from extra_platforms import Group, _TNestedReferences, current_os
 
 
@@ -265,9 +269,7 @@ class CLITestCase:
                         raise AssertionError(f"{name} does not match regex {regex}")
 
             elif field_id.endswith("_regex_fullmatch"):
-                regex = field_data
-                if not regex.fullmatch(output):
-                    raise AssertionError(f"{name} does not fully match regex {regex}")
+                regex_fullmatch_line_by_line(field_data, output)
 
 
 DEFAULT_TEST_PLAN: list[CLITestCase] = [

{gha_utils-4.20.0.dist-info → gha_utils-4.22.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gha-utils
-Version: 4.20.0
+Version: 4.22.0
 Summary: ⚙️ CLI helpers for GitHub Actions + reuseable workflows
 Author-email: Kevin Deldycke <kevin@deldycke.com>
 Project-URL: Homepage, https://github.com/kdeldycke/workflows
@@ -50,7 +50,7 @@ Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Requires-Dist: boltons>=24.0.0
 Requires-Dist: bump-my-version<1.1.1,>=0.32.2
-Requires-Dist: click-extra~=6.0.0
+Requires-Dist: click-extra~=6.0.2
 Requires-Dist: extra-platforms~=3.2.0
 Requires-Dist: packaging~=25.0
 Requires-Dist: py-walk~=0.3.3

gha_utils-4.22.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+gha_utils/__init__.py,sha256=gNHVP8cQ0XbGUYqL65Qc0zhxC3_Wstfs0IOorioqYeQ,866
+gha_utils/__main__.py,sha256=Dck9BjpLXmIRS83k0mghAMcYVYiMiFLltQdfRuMSP_Q,1703
+gha_utils/changelog.py,sha256=JR7iQrWjLoIOpVNe6iXQSyEii82_hM_zrYpR7QO_Uxo,5777
+gha_utils/cli.py,sha256=hwvjKEUvctmtJL2aliV0dytF67uHjGVuUKv17j_lMlg,15235
+gha_utils/mailmap.py,sha256=oQt3m0hj-mwg7WxsuJQXWeQTFjlkqTgRNjYsUv7dlYQ,7013
+gha_utils/matrix.py,sha256=eBAU3bKrCif7FQ74EWhK_AwDcNUkGp8Om1NtlFdYJpI,12431
+gha_utils/metadata.py,sha256=NHyBZ5rAI1DNvpfNC5PMlagTYL-rCSz5KUghldGCkMA,59491
+gha_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gha_utils/test_plan.py,sha256=NDmh1uuKPyqswIRykKpE7sZ1W0hcVBlYSwsQ3F21HUQ,13336
+gha_utils-4.22.0.dist-info/METADATA,sha256=tNtxQmSSLnFz-0fkHzy30zKe2fDQ_ylpE4_5UkdRocY,21420
+gha_utils-4.22.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gha_utils-4.22.0.dist-info/entry_points.txt,sha256=8bJOwQYf9ZqsLhBR6gUCzvwLNI9f8tiiBrJ3AR0EK4o,54
+gha_utils-4.22.0.dist-info/top_level.txt,sha256=C94Blb61YkkyPBwCdM3J_JPDjWH0lnKa5nGZeZ5M6yE,10
+gha_utils-4.22.0.dist-info/RECORD,,

gha_utils-4.20.0.dist-info/RECORD

@@ -1,14 +0,0 @@
-gha_utils/__init__.py,sha256=6pjMI0MO85LQg0A1nfuJZcqASUAH-A2ofuD_WIyjlr4,866
-gha_utils/__main__.py,sha256=Dck9BjpLXmIRS83k0mghAMcYVYiMiFLltQdfRuMSP_Q,1703
-gha_utils/changelog.py,sha256=JR7iQrWjLoIOpVNe6iXQSyEii82_hM_zrYpR7QO_Uxo,5777
-gha_utils/cli.py,sha256=jmrSI05qfrkxcB3fQuiB6xf4eumXqg-MBiCITdeW104,15273
-gha_utils/mailmap.py,sha256=oQt3m0hj-mwg7WxsuJQXWeQTFjlkqTgRNjYsUv7dlYQ,7013
-gha_utils/matrix.py,sha256=eBAU3bKrCif7FQ74EWhK_AwDcNUkGp8Om1NtlFdYJpI,12431
-gha_utils/metadata.py,sha256=AozR7hXSANQpjKZ3_GpRq8L_m3KrO4MTLStCQzbKjGo,56490
-gha_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gha_utils/test_plan.py,sha256=AE8Mf1vSQG5EZTytoTts-gzMwUg2Zy21gUwkMlzXT94,13394
-gha_utils-4.20.0.dist-info/METADATA,sha256=MFcEp0QvN2ojvKfSiYDoHZUyzLPGQtyzoUmx5ZljItE,21420
-gha_utils-4.20.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-gha_utils-4.20.0.dist-info/entry_points.txt,sha256=8bJOwQYf9ZqsLhBR6gUCzvwLNI9f8tiiBrJ3AR0EK4o,54
-gha_utils-4.20.0.dist-info/top_level.txt,sha256=C94Blb61YkkyPBwCdM3J_JPDjWH0lnKa5nGZeZ5M6yE,10
-gha_utils-4.20.0.dist-info/RECORD,,