gha-utils 4.19.1__py3-none-any.whl → 4.21.0__py3-none-any.whl

gha_utils/__init__.py

@@ -17,4 +17,4 @@
 
 from __future__ import annotations
 
-__version__ = "4.19.1"
+__version__ = "4.21.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/mailmap.py

@@ -128,7 +128,7 @@ class Mailmap:
 
     @cached_property
     def git_contributors(self) -> set[str]:
-        """Returns the set of all constributors found in the Git commit history.
+        """Returns the set of all contributors found in the Git commit history.
 
         No normalization happens: all variations of authors and committers strings
         attached to all commits are considered.

gha_utils/metadata.py

@@ -20,11 +20,18 @@ The following variables are `printed to the environment file
 <https://docs.github.com/en/free-pro-team@latest/actions/reference/workflow-commands-for-github-actions#environment-files>`_:
 
 ```text
+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"
+zsh_files=
 is_python_project=true
 package_name=click-extra
 blacken_docs_params=--target-version py37 --target-version py38
@@ -34,119 +41,233 @@ released_version=2.0.0
 is_sphinx=true
 active_autodoc=true
 release_notes=[🐍 Available on PyPi](https://pypi.org/project/click-extra/2.21.3).
-new_commits_matrix={'commit': ['346ce664f055fbd042a25ee0b7e96702e95',
-                               '6f27db47612aaee06fdf08744b09a9f5f6c2'],
-                    'include': [{'commit': '346ce664f055fbd042a25ee0b7e96702e95',
-                                 'short_sha': '346ce66',
-                                 'current_version': '2.0.1'},
-                                {'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
-                                 'short_sha': '6f27db4',
-                                 'current_version': '2.0.0'}]}
-release_commits_matrix={'commit': ['6f27db47612aaee06fdf08744b09a9f5f6c2'],
-                        'include': [{'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
-                                     'short_sha': '6f27db4',
-                                     'current_version': '2.0.0'}]}
-nuitka_matrix={'os': ['ubuntu-24.04-arm', 'ubuntu-24.04', 'macos-15', 'macos-13', 'windows-11-arm', 'windows-2025'],
-               'entry_point': ['mpm'],
-               'commit': ['346ce664f055fbd042a25ee0b7e96702e95',
-                          '6f27db47612aaee06fdf08744b09a9f5f6c2'],
-               'include': [{'target': 'linux-arm64',
-                            'os': 'ubuntu-24.04-arm',
-                            'platform_id': 'linux',
-                            'arch': 'arm64',
-                            'extension': 'bin'},
-                           {'target': 'linux-x64',
-                            'os': 'ubuntu-24.04',
-                            'platform_id': 'linux',
-                            'arch': 'x64',
-                            'extension': 'bin'},
-                           {'target': 'macos-arm64',
-                            'os': 'macos-15',
-                            'platform_id': 'macos',
-                            'arch': 'arm64',
-                            'extension': 'bin'},
-                           {'target': 'macos-x64',
-                            'os': 'macos-13',
-                            'platform_id': 'macos',
-                            'arch': 'x64',
-                            'extension': 'bin'},
-                           {'target': 'windows-arm64',
-                            'os': 'windows-11-arm',
-                            'platform_id": 'windows',
-                            'arch": 'arm64',
-                            'extension": 'exe'},
-                           {'target': 'windows-x64',
-                            'os': 'windows-2025',
-                            'platform_id': 'windows',
-                            'arch': 'x64',
-                            'extension': 'exe'},
-                           {'entry_point': 'mpm',
-                            'cli_id': 'mpm',
-                            'module_id': 'meta_package_manager.__main__',
-                            'callable_id': 'main',
-                            'module_path': 'meta_package_manager/__main__.py'},
-                           {'commit': '346ce664f055fbd042a25ee0b7e96702e95',
-                            'short_sha': '346ce66',
-                            'current_version': '2.0.0'},
-                           {'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
-                            'short_sha': '6f27db4',
-                            'current_version': '1.9.1'},
-                           {'os': 'ubuntu-24.04-arm',
-                            'entry_point': 'mpm',
-                            'commit': '346ce664f055fbd042a25ee0b7e96702e95',
-                            'bin_name': 'mpm-linux-arm64-346ce66.bin'},
-                           {'os': 'ubuntu-24.04-arm',
-                            'entry_point': 'mpm',
-                            'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
-                            'bin_name': 'mpm-linux-arm64-6f27db4.bin'},
-                           {'os': 'ubuntu-24.04',
-                            'entry_point': 'mpm',
-                            'commit': '346ce664f055fbd042a25ee0b7e96702e95',
-                            'bin_name': 'mpm-linux-x64-346ce66.bin'},
-                           {'os': 'ubuntu-24.04',
-                            'entry_point': 'mpm',
-                            'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
-                            'bin_name': 'mpm-linux-x64-6f27db4.bin'},
-                           {'os': 'macos-15',
-                            'entry_point': 'mpm',
-                            'commit': '346ce664f055fbd042a25ee0b7e96702e95',
-                            'bin_name': 'mpm-macos-arm64-346ce66.bin'},
-                           {'os': 'macos-15',
-                            'entry_point': 'mpm',
-                            'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
-                            'bin_name': 'mpm-macos-arm64-6f27db4.bin'},
-                           {'os': 'macos-13',
-                            'entry_point': 'mpm',
-                            'commit': '346ce664f055fbd042a25ee0b7e96702e95',
-                            'bin_name': 'mpm-macos-x64-346ce66.bin'},
-                           {'os': 'macos-13',
-                            'entry_point': 'mpm',
-                            'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
-                            'bin_name': 'mpm-macos-x64-6f27db4.bin'},
-                           {'os': 'windows-11-arm',
-                            'entry_point': 'mpm',
-                            'commit': '346ce664f055fbd042a25ee0b7e96702e95',
-                            'bin_name': 'mpm-windows-arm64-346ce66.bin'},
-                           {'os': 'windows-11-arm',
-                            'entry_point': 'mpm',
-                            'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
-                            'bin_name': 'mpm-windows-arm64-6f27db4.bin'},
-                           {'os': 'windows-2025',
-                            'entry_point': 'mpm',
-                            'commit': '346ce664f055fbd042a25ee0b7e96702e95',
-                            'bin_name': 'mpm-windows-x64-346ce66.exe'},
-                           {'os': 'windows-2025',
-                            'entry_point': 'mpm',
-                            'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
-                            'bin_name': 'mpm-windows-x64-6f27db4.exe'},
-                           {'state': 'stable'}]}
+new_commits_matrix={
+    "commit": [
+        "346ce664f055fbd042a25ee0b7e96702e95",
+        "6f27db47612aaee06fdf08744b09a9f5f6c2"
+    ],
+    "include": [
+        {
+            "commit": "346ce664f055fbd042a25ee0b7e96702e95",
+            "short_sha": "346ce66",
+            "current_version": "2.0.1"
+        },
+        {
+            "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
+            "short_sha": "6f27db4",
+            "current_version": "2.0.0"
+        }
+    ]
+}
+release_commits_matrix={
+    "commit": ["6f27db47612aaee06fdf08744b09a9f5f6c2"],
+    "include": [
+        {
+            "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
+            "short_sha": "6f27db4",
+            "current_version": "2.0.0"
+        }
+    ]
+}
+build_targets=[
+    {
+        "target": "linux-arm64",
+        "os": "ubuntu-24.04-arm",
+        "platform_id": "linux",
+        "arch": "arm64",
+        "extension": "bin"
+    },
+    {
+        "target": "linux-x64",
+        "os": "ubuntu-24.04",
+        "platform_id": "linux",
+        "arch": "x64",
+        "extension": "bin"
+    },
+    {
+        "target": "macos-arm64",
+        "os": "macos-26",
+        "platform_id": "macos",
+        "arch": "arm64",
+        "extension": "bin"
+    },
+    {
+        "target": "macos-x64",
+        "os": "macos-15-intel",
+        "platform_id": "macos",
+        "arch": "x64",
+        "extension": "bin"
+    },
+    {
+        "target": "windows-arm64",
+        "os": "windows-11-arm",
+        "platform_id": "windows",
+        "arch": "arm64",
+        "extension": "exe"
+    },
+    {
+        "target": "windows-x64",
+        "os": "windows-2025",
+        "platform_id": "windows",
+        "arch": "x64",
+        "extension": "exe"
+    }
+]
+nuitka_matrix={
+    "os": [
+        "ubuntu-24.04-arm",
+        "ubuntu-24.04",
+        "macos-26",
+        "macos-15-intel",
+        "windows-11-arm",
+        "windows-2025"
+    ],
+    "entry_point": ["mpm"],
+    "commit": [
+        "346ce664f055fbd042a25ee0b7e96702e95",
+        "6f27db47612aaee06fdf08744b09a9f5f6c2"
+    ],
+    "include": [
+        {
+            "target": "linux-arm64",
+            "os": "ubuntu-24.04-arm",
+            "platform_id": "linux",
+            "arch": "arm64",
+            "extension": "bin"
+        },
+        {
+            "target": "linux-x64",
+            "os": "ubuntu-24.04",
+            "platform_id": "linux",
+            "arch": "x64",
+            "extension": "bin"
+        },
+        {
+            "target": "macos-arm64",
+            "os": "macos-26",
+            "platform_id": "macos",
+            "arch": "arm64",
+            "extension": "bin"
+        },
+        {
+            "target": "macos-x64",
+            "os": "macos-15-intel",
+            "platform_id": "macos",
+            "arch": "x64",
+            "extension": "bin"
+        },
+        {
+            "target": "windows-arm64",
+            "os": "windows-11-arm",
+            "platform_id": "windows",
+            "arch": "arm64",
+            "extension": "exe"
+        },
+        {
+            "target": "windows-x64",
+            "os": "windows-2025",
+            "platform_id": "windows",
+            "arch": "x64",
+            "extension": "exe"
+        },
+        {
+            "entry_point": "mpm",
+            "cli_id": "mpm",
+            "module_id": "meta_package_manager.__main__",
+            "callable_id": "main",
+            "module_path": "meta_package_manager/__main__.py"
+        },
+        {
+            "commit": "346ce664f055fbd042a25ee0b7e96702e95",
+            "short_sha": "346ce66",
+            "current_version": "2.0.0"
+        },
+        {
+            "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
+            "short_sha": "6f27db4",
+            "current_version": "1.9.1"
+        },
+        {
+            "os": "ubuntu-24.04-arm",
+            "entry_point": "mpm",
+            "commit": "346ce664f055fbd042a25ee0b7e96702e95",
+            "bin_name": "mpm-linux-arm64-346ce66.bin"
+        },
+        {
+            "os": "ubuntu-24.04-arm",
+            "entry_point": "mpm",
+            "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
+            "bin_name": "mpm-linux-arm64-6f27db4.bin"
+        },
+        {
+            "os": "ubuntu-24.04",
+            "entry_point": "mpm",
+            "commit": "346ce664f055fbd042a25ee0b7e96702e95",
+            "bin_name": "mpm-linux-x64-346ce66.bin"
+        },
+        {
+            "os": "ubuntu-24.04",
+            "entry_point": "mpm",
+            "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
+            "bin_name": "mpm-linux-x64-6f27db4.bin"
+        },
+        {
+            "os": "macos-26",
+            "entry_point": "mpm",
+            "commit": "346ce664f055fbd042a25ee0b7e96702e95",
+            "bin_name": "mpm-macos-arm64-346ce66.bin"
+        },
+        {
+            "os": "macos-26",
+            "entry_point": "mpm",
+            "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
+            "bin_name": "mpm-macos-arm64-6f27db4.bin"
+        },
+        {
+            "os": "macos-15-intel",
+            "entry_point": "mpm",
+            "commit": "346ce664f055fbd042a25ee0b7e96702e95",
+            "bin_name": "mpm-macos-x64-346ce66.bin"
+        },
+        {
+            "os": "macos-15-intel",
+            "entry_point": "mpm",
+            "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
+            "bin_name": "mpm-macos-x64-6f27db4.bin"
+        },
+        {
+            "os": "windows-11-arm",
+            "entry_point": "mpm",
+            "commit": "346ce664f055fbd042a25ee0b7e96702e95",
+            "bin_name": "mpm-windows-arm64-346ce66.bin"
+        },
+        {
+            "os": "windows-11-arm",
+            "entry_point": "mpm",
+            "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
+            "bin_name": "mpm-windows-arm64-6f27db4.bin"
+        },
+        {
+            "os": "windows-2025",
+            "entry_point": "mpm",
+            "commit": "346ce664f055fbd042a25ee0b7e96702e95",
+            "bin_name": "mpm-windows-x64-346ce66.exe"
+        },
+        {
+            "os": "windows-2025",
+            "entry_point": "mpm",
+            "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
+            "bin_name": "mpm-windows-x64-6f27db4.exe"
+        },
+        {"state": "stable"}
+    ]
+}
 ```
 
 .. warning::
-
-    The ``new_commits_matrix``, ``release_commits_matrix`` and ``nuitka_matrix``
-    variables in the block above are pretty-printed for readability. They are not
-    actually formatted this way in the environment file, but inlined.
+    Fields with serialized lists and dictionaries, like ``new_commits_matrix``,
+    ``build_targets`` or ``nuitka_matrix``, are pretty-printed in the example above for
+    readability. They are inlined in the actual output and not formatted this way.
 """
 
 from __future__ import annotations
@@ -166,13 +287,14 @@ from random import randint
 from re import escape
 from typing import Any, Final, cast
 
-import gitignore_parser
 from bumpversion.config import get_configuration  # type: ignore[import-untyped]
 from bumpversion.config.files import find_config_file  # type: ignore[import-untyped]
 from bumpversion.show import resolve_name  # type: ignore[import-untyped]
 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 (
@@ -197,6 +319,8 @@ SHORT_SHA_LENGTH = 7
     depends on the size of the repository.
 """
 
+MAILMAP_PATH = Path(".mailmap")
+
 GITIGNORE_PATH = Path(".gitignore")
 
 NUITKA_BUILD_TARGETS = {
@@ -213,13 +337,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",
@@ -269,6 +393,13 @@ Values are dictionaries with the following keys:
 """
 
 
+FLAT_BUILD_TARGETS = [
+    {"target": target_id} | target_data
+    for target_id, target_data in NUITKA_BUILD_TARGETS.items()
+]
+"""List of build targets in a flat format, suitable for matrix inclusion."""
+
+
 WorkflowEvent = StrEnum(
     "WorkflowEvent",
     (
@@ -339,6 +470,7 @@ class TargetVersion(StrEnum):
     PY311 = "3.11"
     PY312 = "3.12"
     PY313 = "3.13"
+    PY314 = "3.14"
 
 
 MYPY_VERSION_MIN: Final = (3, 8)
@@ -349,6 +481,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."""
 
@@ -408,10 +544,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"
             )
         )
@@ -456,8 +597,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]
@@ -485,17 +625,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}"
@@ -516,7 +656,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,
@@ -534,10 +674,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
 
@@ -570,6 +710,31 @@ class Metadata:
             return WorkflowEvent.pull_request
         return WorkflowEvent.push
 
+    @cached_property
+    def event_actor(self) -> str | None:
+        """Returns the GitHub login of the user that triggered the workflow run."""
+        return self.github_context.get("actor")
+
+    @cached_property
+    def event_sender_type(self) -> str | None:
+        """Returns the type of the user that triggered the workflow run."""
+        sender_type = self.github_context.get("event", {}).get("sender", {}).get("type")
+        return cast(str | None, sender_type)
+
+    @cached_property
+    def is_bot(self) -> bool:
+        """Returns ``True`` if the workflow was triggered by a bot or automated process.
+
+        This is useful to only run some jobs on human-triggered events. Or skip jobs
+        triggered by bots to avoid infinite loops.
+        """
+        if self.event_sender_type == "Bot" or self.event_actor in (
+            "dependabot[bot]",
+            "dependabot-preview[bot]",
+        ):
+            return True
+        return False
+
     @cached_property
     def commit_range(self) -> tuple[str, str] | None:
         """Range of commits bundled within the triggering event.
@@ -640,15 +805,34 @@ 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):
+            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
+
+        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:
@@ -697,10 +881,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``.
 
@@ -730,12 +931,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 = gitignore_parser.parse_gitignore(GITIGNORE_PATH)
-
         for file_path in iglob(
             patterns,
             flags=NODIR | GLOBSTAR | DOTGLOB | GLOBTILDE | BRACE | FOLLOW | NEGATE,
@@ -765,7 +960,7 @@ class Metadata:
                 continue
 
             # Skip files that are ignored by .gitignore.
-            if gitignore and gitignore(file_path):
+            if self.gitignore_match(file_path):
                 logging.debug(f"Skip file matching {GITIGNORE_PATH}: {file_path}")
                 continue
 
@@ -775,12 +970,43 @@ class Metadata:
     @cached_property
     def python_files(self) -> list[Path]:
         """Returns a list of python files."""
-        return self.glob_files("**/*.py", "!.venv/**")
+        return self.glob_files("**/*.{py,pyi,pyw,pyx,ipynb}")
+
+    @cached_property
+    def json_files(self) -> list[Path]:
+        """Returns a list of JSON files."""
+        return self.glob_files(
+            "**/*.{json,jsonc,json5}",
+            "**/.code-workspace",
+            "!**/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."""
-        return self.glob_files("**/*.{md,markdown,rst,tex}", "!.venv/**")
+        return self.glob_files(
+            "**/*.{markdown,mdown,mkdn,mdwn,mkd,md,mdtxt,mdtext,rst,tex}"
+        )
+
+    @cached_property
+    def markdown_files(self) -> list[Path]:
+        """Returns a list of Markdown files."""
+        return self.glob_files("**/*.{markdown,mdown,mkdn,mdwn,mkd,md,mdtxt,mdtext}")
+
+    @cached_property
+    def zsh_files(self) -> list[Path]:
+        """Returns a list of Zsh files."""
+        return self.glob_files("**/*.{sh,zsh}", "**/.{zshrc,zprofile,zshenv,zlogin}")
 
     @cached_property
     def is_python_project(self):
@@ -1025,8 +1251,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",
                 ],
@@ -1054,14 +1280,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",
@@ -1122,25 +1348,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",
@@ -1186,8 +1412,8 @@ class Metadata:
             "os", tuple(map(itemgetter("os"), NUITKA_BUILD_TARGETS.values()))
         )
         # Augment each "os" entry with platform-specific data.
-        for target_id, target_data in NUITKA_BUILD_TARGETS.items():
-            matrix.add_includes({"target": target_id} | target_data)
+        for target_data in FLAT_BUILD_TARGETS:
+            matrix.add_includes(target_data)
 
         # Augment each entry point with some metadata.
         for cli_id, module_id, callable_id in self.script_entries:
@@ -1289,9 +1515,9 @@ class Metadata:
         - `None` into empty string
         - `bool` into lower-cased string
         - `Matrix` into JSON string
-        - `Iterable` of strings into a serialized space-separated string
-        - `Iterable` of `Path` into a serialized string whose items are space-separated
-          and double-quoted
+        - `Iterable` of mixed strings and `Path` into a serialized space-separated
+          string, where `Path` items are double-quoted
+        - other `Iterable` into a JSON string
         """
         # Structured metadata to be rendered as JSON.
         if isinstance(value, Matrix):
@@ -1309,9 +1535,26 @@ class Metadata:
                 raise NotImplementedError
 
             elif isinstance(value, Iterable):
-                # Cast all items to string, wrapping Path items with double-quotes.
-                items = ((f'"{i}"' if isinstance(i, Path) else str(i)) for i in value)
-                value = " ".join(items)
+                # Cast all items to strings, wrapping Path items with double-quotes.
+                if all(isinstance(i, (str, Path)) for i in value):
+                    items = (
+                        (f'"{i}"' if isinstance(i, Path) else str(i)) for i in value
+                    )
+                    value = " ".join(items)
+                # XXX We only support iterables of dict[str, str] for now.
+                else:
+                    assert all(
+                        isinstance(i, dict)
+                        and all(
+                            isinstance(k, str) and isinstance(v, str)
+                            for k, v in i.items()
+                        )
+                        for i in value
+                    ), f"Unsupported iterable value: {value!r}"
+                    value = json.dumps(value)
+
+            else:
+                raise NotImplementedError(f"GitHub formatting for: {value!r}")
 
         return cast(str, value)
 
@@ -1321,11 +1564,18 @@ class Metadata:
         Defaults to GitHub dialect.
         """
         metadata: dict[str, Any] = {
+            "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,
+            "zsh_files": self.zsh_files,
             "is_python_project": self.is_python_project,
             "package_name": self.package_name,
             "blacken_docs_params": self.blacken_docs_params,
@@ -1337,6 +1587,7 @@ class Metadata:
             "release_notes": self.release_notes,
             "new_commits_matrix": self.new_commits_matrix,
             "release_commits_matrix": self.release_commits_matrix,
+            "build_targets": FLAT_BUILD_TARGETS,
             "nuitka_matrix": self.nuitka_matrix,
         }
 
@@ -1353,7 +1604,7 @@ class Metadata:
                     content += f"{env_name}={env_value}\n"
                 else:
                     # Use a random unique delimiter to encode multiline value:
-                    delimiter = f"ghadelimiter_{randint(10**8, (10**9) - 1)}"
+                    delimiter = f"GHA_DELIMITER_{randint(10**8, (10**9) - 1)}"
                     content += f"{env_name}<<{delimiter}\n{env_value}\n{delimiter}\n"
         else:
             assert dialect == Dialects.json

{gha_utils-4.19.1.dist-info → gha_utils-4.21.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gha-utils
-Version: 4.19.1
+Version: 4.21.0
 Summary: ⚙️ CLI helpers for GitHub Actions + reuseable workflows
 Author-email: Kevin Deldycke <kevin@deldycke.com>
 Project-URL: Homepage, https://github.com/kdeldycke/workflows
@@ -18,10 +18,14 @@ Classifier: License :: OSI Approved :: GNU General Public License v2 or later (G
 Classifier: Operating System :: MacOS :: MacOS X
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: POSIX :: BSD :: FreeBSD
+Classifier: Operating System :: POSIX :: BSD :: NetBSD
+Classifier: Operating System :: POSIX :: BSD :: OpenBSD
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Unix Shell
 Classifier: Topic :: Documentation :: Sphinx
@@ -48,8 +52,8 @@ 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: extra-platforms~=3.2.0
-Requires-Dist: gitignore-parser~=0.1.13
 Requires-Dist: packaging~=25.0
+Requires-Dist: py-walk~=0.3.3
 Requires-Dist: PyDriller~=2.6
 Requires-Dist: pyproject-metadata~=0.9.0
 Requires-Dist: pyyaml~=6.0.0

gha_utils-4.21.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+gha_utils/__init__.py,sha256=HCe5G0ysXtBmQ8s34Mi5DeYCvYLFSPYzWcV4pPfYdGw,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=hySTDkjPS2NMKvFlmEmpy4F7rwrjmST_ZiygmF9OOZk,58839
+gha_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gha_utils/test_plan.py,sha256=AE8Mf1vSQG5EZTytoTts-gzMwUg2Zy21gUwkMlzXT94,13394
+gha_utils-4.21.0.dist-info/METADATA,sha256=tdjkQaFwLnJUNm-3K8lOi4crw_n_HQWn-CNtW6BaD08,21420
+gha_utils-4.21.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gha_utils-4.21.0.dist-info/entry_points.txt,sha256=8bJOwQYf9ZqsLhBR6gUCzvwLNI9f8tiiBrJ3AR0EK4o,54
+gha_utils-4.21.0.dist-info/top_level.txt,sha256=C94Blb61YkkyPBwCdM3J_JPDjWH0lnKa5nGZeZ5M6yE,10
+gha_utils-4.21.0.dist-info/RECORD,,

gha_utils-4.19.1.dist-info/RECORD

@@ -1,14 +0,0 @@
-gha_utils/__init__.py,sha256=lMEtwh0IU3Npa59dfCNSMgI1ilQQl-4K09Qjz3bjXIg,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=g3LQiPNjHsAgCbEYOJcQwdlXqxzmFh697vv2sxHZq-s,7014
-gha_utils/matrix.py,sha256=eBAU3bKrCif7FQ74EWhK_AwDcNUkGp8Om1NtlFdYJpI,12431
-gha_utils/metadata.py,sha256=lAnBC2p17cwpgzpTFw5qYjqvI29wsWtvMlBx4B3rFc4,53791
-gha_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gha_utils/test_plan.py,sha256=AE8Mf1vSQG5EZTytoTts-gzMwUg2Zy21gUwkMlzXT94,13394
-gha_utils-4.19.1.dist-info/METADATA,sha256=CTP2UDJIakJ9NC7QWc2JcLtoczOjznA1wX169iG9VH8,21212
-gha_utils-4.19.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-gha_utils-4.19.1.dist-info/entry_points.txt,sha256=8bJOwQYf9ZqsLhBR6gUCzvwLNI9f8tiiBrJ3AR0EK4o,54
-gha_utils-4.19.1.dist-info/top_level.txt,sha256=C94Blb61YkkyPBwCdM3J_JPDjWH0lnKa5nGZeZ5M6yE,10
-gha_utils-4.19.1.dist-info/RECORD,,