gha-utils 4.14.1__tar.gz → 4.15.0__tar.gz

{gha_utils-4.14.1 → gha_utils-4.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: gha-utils
-Version: 4.14.1
+Version: 4.15.0
 Summary: ⚙️ CLI helpers for GitHub Actions + reuseable workflows
 Author-email: Kevin Deldycke <kevin@deldycke.com>
 Project-URL: Homepage, https://github.com/kdeldycke/workflows
@@ -19,7 +19,6 @@ Classifier: Operating System :: MacOS :: MacOS X
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
@@ -43,17 +42,16 @@ Classifier: Topic :: Text Processing :: Markup :: HTML
 Classifier: Topic :: Text Processing :: Markup :: Markdown
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: backports.strenum~=1.3.1; python_version < "3.11"
 Requires-Dist: boltons>=24.0.0
-Requires-Dist: bump-my-version>=0.21.0
-Requires-Dist: click-extra~=4.14.1
+Requires-Dist: bump-my-version>=0.32.2
+Requires-Dist: click-extra~=4.15.0
+Requires-Dist: extra-platforms~=3.1.0
 Requires-Dist: packaging~=24.1
 Requires-Dist: PyDriller~=2.6
 Requires-Dist: pyproject-metadata~=0.9.0
 Requires-Dist: pyyaml~=6.0.0
-Requires-Dist: tomli~=2.0.1; python_version < "3.11"
 Requires-Dist: wcmatch>=8.5
 Provides-Extra: test
 Requires-Dist: coverage[toml]~=7.6.0; extra == "test"
@@ -137,7 +135,7 @@ $ uvx gha-utils --version
 gha-utils, version 4.9.0
 ```
 
-That's the best way to get started with `gha-utils`, and experiment with its features.
+That's the best way to get started with `gha-utils` and experiment with it.
 
 ### Executables
 

{gha_utils-4.14.1 → gha_utils-4.15.0}/gha_utils/__init__.py

@@ -17,4 +17,4 @@
 
 from __future__ import annotations
 
-__version__ = "4.14.1"
+__version__ = "4.15.0"

{gha_utils-4.14.1 → gha_utils-4.15.0}/gha_utils/changelog.py

@@ -18,15 +18,11 @@ from __future__ import annotations
 
 import logging
 import re
-import sys
 from functools import cached_property
 from pathlib import Path
 from textwrap import indent
 
-if sys.version_info >= (3, 11):
-    import tomllib
-else:
-    import tomli as tomllib  # type: ignore[import-not-found]
+import tomllib
 
 
 class Changelog:

{gha_utils-4.14.1 → gha_utils-4.15.0}/gha_utils/cli.py

@@ -19,11 +19,12 @@ from __future__ import annotations
 import logging
 import os
 import sys
+from collections import Counter
 from datetime import datetime
 from pathlib import Path
 from typing import IO
 
-import click
+from boltons.iterutils import unique
 from click_extra import (
     Choice,
     Context,
@@ -35,12 +36,14 @@ from click_extra import (
     option,
     pass_context,
 )
+from click_extra.envvar import merge_envvar_ids
+from extra_platforms import ALL_IDS
 
 from . import __version__
 from .changelog import Changelog
 from .mailmap import Mailmap
 from .metadata import Dialects, Metadata
-from .test_plan import DEFAULT_TEST_PLAN, parse_test_plan
+from .test_plan import DEFAULT_TEST_PLAN, SkippedTest, parse_test_plan
 
 
 def is_stdout(filepath: Path) -> bool:
@@ -275,16 +278,38 @@ def mailmap_sync(ctx, source, create_if_missing, destination_mailmap):
 @gha_utils.command(short_help="Run a test plan from a file against a binary")
 @option(
     "--binary",
-    # XXX Wait for https://github.com/janluke/cloup/issues/185 to use the
-    # `file_path` type.
-    type=click.Path(exists=True, executable=True, resolve_path=True),
+    type=file_path(exists=True, executable=True, resolve_path=True),
     required=True,
-    help="Path to the binary to test.",
+    metavar="FILE_PATH",
+    help="Path to the binary file to test.",
 )
 @option(
+    "-F",
+    "--plan-file",
+    # TODO: remove deprecated --plan option to avoid confusion.
     "--plan",
     type=file_path(exists=True, readable=True, resolve_path=True),
-    help="Test plan in YAML.",
+    multiple=True,
+    metavar="FILE_PATH",
+    help="Path to a test plan file in YAML. This option can be repeated to run "
+    "multiple test plans in sequence. If not provided, a default test plan will be "
+    "executed.",
+)
+@option(
+    "-E",
+    "--plan-envvar",
+    multiple=True,
+    metavar="ENVVAR_NAME",
+    help="Name of an environment variable containing a test plan in YAML. This "
+    "option can be repeated to collect multiple test plans.",
+)
+@option(
+    "-s",
+    "--skip-platform",
+    type=Choice(sorted(ALL_IDS), case_sensitive=False),
+    multiple=True,
+    help="Skip tests for the specified platforms. This option can be repeated to "
+    "skip multiple platforms.",
 )
 @option(
     "-t",
@@ -293,18 +318,58 @@ def mailmap_sync(ctx, source, create_if_missing, destination_mailmap):
     # 0.0 is negative values are provided, so we mimic this behavior here:
     # https://github.com/python/cpython/blob/5740b95076b57feb6293cda4f5504f706a7d622d/Lib/subprocess.py#L1596-L1597
     type=FloatRange(min=0, clamp=True),
+    metavar="SECONDS",
     help="Set the default timeout for each CLI call, if not specified in the "
     "test plan.",
 )
-def test_plan(binary: Path, plan: Path | None, timeout: float | None) -> None:
+def test_plan(
+    binary: Path,
+    plan_file: tuple[Path, ...] | None,
+    plan_envvar: tuple[str, ...] | None,
+    skip_platform: tuple[str, ...] | None,
+    timeout: float | None,
+) -> None:
     # Load test plan from workflow input, or use a default one.
-    if plan:
-        logging.debug(f"Read test plan from {plan}")
-        test_plan = parse_test_plan(plan)
+    test_list = []
+    if plan_file or plan_envvar:
+        for file in unique(plan_file):
+            logging.info(f"Get test plan from {file} file")
+            tests = list(parse_test_plan(file.read_text(encoding="UTF-8")))
+            logging.info(f"{len(tests)} test cases found.")
+            test_list.extend(tests)
+        for envvar_id in merge_envvar_ids(plan_envvar):
+            logging.info(f"Get test plan from {envvar_id!r} environment variable")
+            tests = list(parse_test_plan(os.getenv(envvar_id)))
+            logging.info(f"{len(tests)} test cases found.")
+            test_list.extend(tests)
+
     else:
-        logging.warning(f"No test plan provided. Default to: {DEFAULT_TEST_PLAN}")
-        test_plan = DEFAULT_TEST_PLAN  # type: ignore[assignment]
+        logging.warning(
+            "No test plan provided through --plan-file/-F or --plan-envvar/-E options:"
+            " use default test plan."
+        )
+        test_list = DEFAULT_TEST_PLAN
+    logging.debug(f"Test plan: {test_list}")
+
+    stats = Counter(total=len(test_list), skipped=0, failed=0)
 
-    for index, test_case in enumerate(test_plan):
-        logging.info(f"Run test #{index}")
-        test_case.check_cli_test(binary, default_timeout=timeout)
+    for index, test_case in enumerate(test_list):
+        logging.info(f"Run test #{index + 1}")
+        try:
+            logging.debug(f"Test case parameters: {test_case}")
+            test_case.run_cli_test(
+                binary, additional_skip_platforms=skip_platform, default_timeout=timeout
+            )
+        except SkippedTest as ex:
+            stats["skipped"] += 1
+            logging.warning(f"Test skipped: {ex}")
+        except Exception as ex:
+            stats["failed"] += 1
+            logging.error(f"Test failed: {ex}")
+
+    logging.info(
+        "Test plan results - "
+        + ", ".join((f"{k.title()}: {v}" for k, v in stats.items()))
+    )
+    if stats["failed"]:
+        sys.exit(1)

{gha_utils-4.14.1 → gha_utils-4.15.0}/gha_utils/metadata.py

@@ -49,7 +49,7 @@ release_commits_matrix={'commit': ['6f27db47612aaee06fdf08744b09a9f5f6c2'],
 nuitka_matrix={'entry_point': ['mpm'],
                'commit': ['346ce664f055fbd042a25ee0b7e96702e95',
                           '6f27db47612aaee06fdf08744b09a9f5f6c2'],
-                'os': ['ubuntu-24.04', 'ubuntu-24.04-arm', 'macos-15', 'macos-13', 'windows-2022'],
+                'os': ['ubuntu-24.04', 'ubuntu-24.04-arm', 'macos-15', 'macos-13', 'windows-2025'],
                 'include': [{'entry_point': 'mpm',
                              'cli_id': 'mpm',
                              'module_id': 'meta_package_manager.__main__',
@@ -77,7 +77,7 @@ nuitka_matrix={'entry_point': ['mpm'],
                              'platform_id': 'macos',
                              'arch': 'x64',
                              'extension': 'bin'},
-                            {'os': 'windows-2022',
+                            {'os': 'windows-2025',
                              'platform_id': 'windows',
                              'arch': 'x64',
                              'extension': 'exe'},
@@ -123,12 +123,12 @@ nuitka_matrix={'entry_point': ['mpm'],
                              'bin_name': 'mpm-macos-x64-build-6f27db4.bin'},
                             {'entry_point': 'mpm',
                              'commit': '346ce664f055fbd042a25ee0b7e96702e95',
-                             'os': 'windows-2022',
+                             'os': 'windows-2025',
                              'arch': 'x64',
                              'bin_name': 'mpm-windows-x64-build-346ce66.exe'},
                             {'entry_point': 'mpm',
                              'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
-                             'os': 'windows-2022',
+                             'os': 'windows-2025',
                              'arch': 'x64',
                              'bin_name': 'mpm-windows-x64-build-6f27db4.exe'}]}
 ```
@@ -147,22 +147,15 @@ import json
 import logging
 import os
 import re
-import sys
 from collections.abc import Iterable
+from enum import StrEnum
 from functools import cached_property
 from pathlib import Path
 from random import randint
 from re import escape
 from typing import Any, Final, Iterator, cast
 
-if sys.version_info >= (3, 11):
-    from enum import StrEnum
-
-    import tomllib
-else:
-    import tomli as tomllib  # type: ignore[import-not-found]
-    from backports.strenum import StrEnum  # type: ignore[import-not-found]
-
+import tomllib
 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]
@@ -457,7 +450,7 @@ class Metadata:
         return matrix
 
     @cached_property
-    def event_type(self) -> WorkflowEvent | None:  # type: ignore[valid-type]
+    def event_type(self) -> WorkflowEvent | None:
         """Returns the type of event that triggered the workflow run.
 
         .. caution::
@@ -481,8 +474,8 @@ class Metadata:
             return None
 
         if bool(os.environ.get("GITHUB_BASE_REF")):
-            return WorkflowEvent.pull_request  # type: ignore[no-any-return]
-        return WorkflowEvent.push  # type: ignore[no-any-return]
+            return WorkflowEvent.pull_request
+        return WorkflowEvent.push
 
     @cached_property
     def commit_range(self) -> tuple[str, str] | None:
@@ -515,7 +508,7 @@ class Metadata:
         if not self.github_context or not self.event_type:
             return None
         # Pull request event.
-        if self.event_type in (  # type: ignore[unreachable]
+        if self.event_type in (
             WorkflowEvent.pull_request,
             WorkflowEvent.pull_request_target,
         ):
@@ -880,7 +873,7 @@ class Metadata:
                     "ubuntu-24.04-arm",
                     "macos-15",
                     "macos-13",
-                    "windows-2022",
+                    "windows-2025",
                 ],
                 "include": [
                     {
@@ -925,7 +918,7 @@ class Metadata:
                         "extension": "bin",
                     },
                     {
-                        "os": "windows-2022",
+                        "os": "windows-2025",
                         "platform_id": "windows",
                         "arch": "x64",
                         "extension": "exe",
@@ -989,14 +982,14 @@ class Metadata:
                     {
                         "entry_point": "mpm",
                         "commit": "346ce664f055fbd042a25ee0b7e96702e95",
-                        "os": "windows-2022",
+                        "os": "windows-2025",
                         "arch": "x64",
                         "bin_name": "mpm-windows-x64-build-346ce66.exe",
                     },
                     {
                         "entry_point": "mpm",
                         "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
-                        "os": "windows-2022",
+                        "os": "windows-2025",
                         "arch": "x64",
                         "bin_name": "mpm-windows-x64-build-6f27db4.exe",
                     },
@@ -1021,7 +1014,7 @@ class Metadata:
                 "ubuntu-24.04-arm",  # arm64
                 "macos-15",  # arm64
                 "macos-13",  # x64
-                "windows-2022",  # x64
+                "windows-2025",  # x64
             ),
         )
 
@@ -1086,7 +1079,7 @@ class Metadata:
                 "extension": "bin",
             },
             {
-                "os": "windows-2022",
+                "os": "windows-2025",
                 "platform_id": "windows",
                 "arch": "x64",
                 "extension": "exe",
@@ -1180,10 +1173,7 @@ class Metadata:
 
         return cast(str, value)
 
-    def dump(
-        self,
-        dialect: Dialects = Dialects.github,  # type: ignore[valid-type]
-    ) -> str:
+    def dump(self, dialect: Dialects = Dialects.github) -> str:
         """Returns all metadata in the specified format.
 
         Defaults to GitHub dialect.

{gha_utils-4.14.1 → gha_utils-4.15.0}/gha_utils/test_plan.py

@@ -18,6 +18,8 @@ from __future__ import annotations
 
 import logging
 import re
+import shlex
+import sys
 from dataclasses import asdict, dataclass, field
 from pathlib import Path
 from subprocess import TimeoutExpired, run
@@ -26,26 +28,41 @@ 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, print_cli_run
+from click_extra.testing import args_cleanup, render_cli_run
+from extra_platforms import Group, _TNestedReferences, current_os
+
+
+class SkippedTest(Exception):
+    """Raised when a test case should be skipped."""
+
+    pass
 
 
 @dataclass(order=True)
-class TestCase:
+class CLITestCase:
     cli_parameters: tuple[str, ...] | str = field(default_factory=tuple)
     """Parameters, arguments and options to pass to the CLI."""
 
+    skip_platforms: _TNestedReferences = field(default_factory=tuple)
+    only_platforms: _TNestedReferences = field(default_factory=tuple)
     timeout: float | str | None = None
     exit_code: int | str | None = None
     strip_ansi: bool = False
     output_contains: tuple[str, ...] | str = field(default_factory=tuple)
     stdout_contains: tuple[str, ...] | str = field(default_factory=tuple)
     stderr_contains: tuple[str, ...] | str = field(default_factory=tuple)
-    output_regex_matches: tuple[str, ...] | str = field(default_factory=tuple)
-    stdout_regex_matches: tuple[str, ...] | str = field(default_factory=tuple)
-    stderr_regex_matches: tuple[str, ...] | str = field(default_factory=tuple)
-    output_regex_fullmatch: str | None = None
-    stdout_regex_fullmatch: str | None = None
-    stderr_regex_fullmatch: str | None = None
+    output_regex_matches: tuple[re.Pattern | str, ...] | str = field(
+        default_factory=tuple
+    )
+    stdout_regex_matches: tuple[re.Pattern | str, ...] | str = field(
+        default_factory=tuple
+    )
+    stderr_regex_matches: tuple[re.Pattern | str, ...] | str = field(
+        default_factory=tuple
+    )
+    output_regex_fullmatch: re.Pattern | str | None = None
+    stdout_regex_fullmatch: re.Pattern | str | None = None
+    stderr_regex_fullmatch: re.Pattern | str | None = None
 
     def __post_init__(self) -> None:
         """Normalize all fields."""
@@ -72,53 +89,78 @@ class TestCase:
                 if not isinstance(field_data, bool):
                     raise ValueError(f"strip_ansi is not a boolean: {field_data}")
 
-            # Validates and normalize regex fullmatch fields.
-            elif field_id.endswith("_fullmatch"):
-                if field_data:
-                    if not isinstance(field_data, str):
-                        raise ValueError(f"{field_id} is not a string: {field_data}")
-                # Normalize empty strings to None.
-                else:
-                    field_data = None
-
             # Validates and normalize tuple of strings.
             else:
-                # Wraps single string into a tuple.
-                if isinstance(field_data, str):
-                    field_data = (field_data,)
-                if not isinstance(field_data, Sequence):
-                    raise ValueError(
-                        f"{field_id} is not a tuple or a list: {field_data}"
-                    )
-                if not all(isinstance(i, str) for i in field_data):
-                    raise ValueError(
-                        f"{field_id} contains non-string elements: {field_data}"
-                    )
-                # Ignore blank value.
-                field_data = tuple(i.strip() for i in field_data if i.strip())
-
-            # Validates regexps.
-            if field_data and "_regex_" in field_id:
+                if field_data:
+                    # Wraps single string and other types into a tuple.
+                    if isinstance(field_data, str) or not isinstance(
+                        field_data, Sequence
+                    ):
+                        # CLI parameters needs to be split on Unix-like systems.
+                        # XXX If we need the same for Windows, have a look at:
+                        # https://github.com/maxpat78/w32lex
+                        if field_id == "cli_parameters" and sys.platform != "win32":
+                            field_data = tuple(shlex.split(field_data))
+                        else:
+                            field_data = (field_data,)
+
+                    for item in field_data:
+                        if not isinstance(item, str):
+                            raise ValueError(f"Invalid string in {field_id}: {item}")
+                    # Ignore blank value.
+                    field_data = tuple(i for i in field_data if i.strip())
+
+            # Normalize any mishmash of platform and group IDs into a set of platforms.
+            if field_id.endswith("_platforms") and field_data:
+                field_data = frozenset(Group._extract_platforms(field_data))
+
+            # Validates fields containing one or more regexes.
+            if "_regex_" in field_id and field_data:
+                # Compile all regexes.
+                valid_regexes = []
                 for regex in flatten((field_data,)):
                     try:
-                        re.compile(regex)
+                        # Let dots in regex match newlines.
+                        valid_regexes.append(re.compile(regex, re.DOTALL))
                     except re.error as ex:
                         raise ValueError(
                             f"Invalid regex in {field_id}: {regex}"
                         ) from ex
+                # Normalize single regex to a single element.
+                if field_id.endswith("_fullmatch"):
+                    if valid_regexes:
+                        field_data = valid_regexes.pop()
+                    else:
+                        field_data = None
+                else:
+                    field_data = tuple(valid_regexes)
 
             setattr(self, field_id, field_data)
 
-    def check_cli_test(self, binary: str | Path, default_timeout: float | None):
+    def run_cli_test(
+        self,
+        binary: str | Path,
+        additional_skip_platforms: _TNestedReferences | None,
+        default_timeout: float | None,
+    ):
         """Run a CLI command and check its output against the test case.
 
         ..todo::
             Add support for environment variables.
 
         ..todo::
-            Add support for proper mixed stdout/stderr stream as a single,
+            Add support for proper mixed <stdout>/<stderr> stream as a single,
             intertwined output.
         """
+        if self.only_platforms:
+            if current_os() not in self.only_platforms:  # type: ignore[operator]
+                raise SkippedTest(f"Test case only runs on platform: {current_os()}")
+
+        if current_os() in Group._extract_platforms(
+            self.skip_platforms, additional_skip_platforms
+        ):
+            raise SkippedTest(f"Skipping test case on platform: {current_os()}")
+
         if self.timeout is None and default_timeout is not None:
             logging.info(f"Set default test case timeout to {default_timeout} seconds")
             self.timeout = default_timeout
@@ -156,24 +198,33 @@ class TestCase:
                 # encoding="utf-8",
                 text=True,
             )
-        except TimeoutExpired as ex:
+        except TimeoutExpired:
             raise TimeoutError(
-                f"CLI timed out after {self.timeout} seconds: {clean_args}"
-            ) from ex
+                f"CLI timed out after {self.timeout} seconds: {' '.join(clean_args)}"
+            )
 
-        print_cli_run(clean_args, result)
+        for line in render_cli_run(clean_args, result).splitlines():
+            logging.info(line)
 
         for field_id, field_data in asdict(self).items():
-            if field_id == "cli_parameters" or (not field_data and field_data != 0):
+            if field_id == "exit_code":
+                if field_data is not None:
+                    logging.info(f"Test exit code, expecting: {field_data}")
+                    if result.returncode != field_data:
+                        raise AssertionError(
+                            f"CLI exited with code {result.returncode}, "
+                            f"expected {field_data}"
+                        )
+                # The specific exit code matches, let's proceed to the next test.
                 continue
 
-            if field_id == "exit_code":
-                if result.returncode != field_data:
-                    raise AssertionError(
-                        f"CLI exited with code {result.returncode}, "
-                        f"expected {field_data}"
-                    )
+            # Ignore non-output fields, and empty test cases.
+            elif not (
+                field_id.startswith(("output_", "stdout_", "stderr_")) and field_data
+            ):
+                continue
 
+            # Prepare output and name for comparison.
             output = ""
             name = ""
             if field_id.startswith("output_"):
@@ -188,50 +239,50 @@ class TestCase:
                 name = "<stderr>"
 
             if self.strip_ansi:
+                logging.info(f"Strip ANSI sequences from {name}")
                 output = strip_ansi(output)
 
             if field_id.endswith("_contains"):
                 for sub_string in field_data:
+                    logging.info(f"Check if {name} contains {sub_string!r}")
                     if sub_string not in output:
-                        raise AssertionError(
-                            f"CLI's {name} does not contain {sub_string!r}"
-                        )
+                        raise AssertionError(f"{name} does not contain {sub_string!r}")
 
             elif field_id.endswith("_regex_matches"):
                 for regex in field_data:
-                    if not re.search(regex, output):
-                        raise AssertionError(
-                            f"CLI's {name} does not match regex {regex!r}"
-                        )
+                    logging.info(f"Check if {name} matches {sub_string!r}")
+                    if not regex.search(output):
+                        raise AssertionError(f"{name} does not match regex {regex}")
 
             elif field_id.endswith("_regex_fullmatch"):
                 regex = field_data
-                if not re.fullmatch(regex, output):
-                    raise AssertionError(
-                        f"CLI's {name} does not fully match regex {regex!r}"
-                    )
+                if not regex.fullmatch(output):
+                    raise AssertionError(f"{name} does not fully match regex {regex}")
 
 
-DEFAULT_TEST_PLAN = (
+DEFAULT_TEST_PLAN: list[CLITestCase] = [
     # Output the version of the CLI.
-    TestCase(cli_parameters="--version"),
+    CLITestCase(cli_parameters="--version"),
     # Test combination of version and verbosity.
-    TestCase(cli_parameters=("--verbosity", "DEBUG", "--version")),
+    CLITestCase(cli_parameters=("--verbosity", "DEBUG", "--version")),
     # Test help output.
-    TestCase(cli_parameters="--help"),
-)
+    CLITestCase(cli_parameters="--help"),
+]
+
 
+def parse_test_plan(plan_string: str | None) -> Generator[CLITestCase, None, None]:
+    if not plan_string:
+        raise ValueError("Empty test plan")
 
-def parse_test_plan(plan_path: Path) -> Generator[TestCase, None, None]:
-    plan = yaml.full_load(plan_path.read_text(encoding="UTF-8"))
+    plan = yaml.full_load(plan_string)
 
     # Validates test plan structure.
     if not plan:
-        raise ValueError(f"Empty test plan file {plan_path}")
+        raise ValueError("Empty test plan")
     if not isinstance(plan, list):
         raise ValueError(f"Test plan is not a list: {plan}")
 
-    directives = frozenset(TestCase.__dataclass_fields__.keys())
+    directives = frozenset(CLITestCase.__dataclass_fields__.keys())
 
     for index, test_case in enumerate(plan):
         # Validates test case structure.
@@ -243,4 +294,4 @@ def parse_test_plan(plan_path: Path) -> Generator[TestCase, None, None]:
                 f"{set(test_case) - directives}"
             )
 
-        yield TestCase(**test_case)
+        yield CLITestCase(**test_case)

{gha_utils-4.14.1 → gha_utils-4.15.0}/gha_utils.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: gha-utils
-Version: 4.14.1
+Version: 4.15.0
 Summary: ⚙️ CLI helpers for GitHub Actions + reuseable workflows
 Author-email: Kevin Deldycke <kevin@deldycke.com>
 Project-URL: Homepage, https://github.com/kdeldycke/workflows
@@ -19,7 +19,6 @@ Classifier: Operating System :: MacOS :: MacOS X
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
@@ -43,17 +42,16 @@ Classifier: Topic :: Text Processing :: Markup :: HTML
 Classifier: Topic :: Text Processing :: Markup :: Markdown
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: backports.strenum~=1.3.1; python_version < "3.11"
 Requires-Dist: boltons>=24.0.0
-Requires-Dist: bump-my-version>=0.21.0
-Requires-Dist: click-extra~=4.14.1
+Requires-Dist: bump-my-version>=0.32.2
+Requires-Dist: click-extra~=4.15.0
+Requires-Dist: extra-platforms~=3.1.0
 Requires-Dist: packaging~=24.1
 Requires-Dist: PyDriller~=2.6
 Requires-Dist: pyproject-metadata~=0.9.0
 Requires-Dist: pyyaml~=6.0.0
-Requires-Dist: tomli~=2.0.1; python_version < "3.11"
 Requires-Dist: wcmatch>=8.5
 Provides-Extra: test
 Requires-Dist: coverage[toml]~=7.6.0; extra == "test"
@@ -137,7 +135,7 @@ $ uvx gha-utils --version
 gha-utils, version 4.9.0
 ```
 
-That's the best way to get started with `gha-utils`, and experiment with its features.
+That's the best way to get started with `gha-utils` and experiment with it.
 
 ### Executables
 

{gha_utils-4.14.1 → gha_utils-4.15.0}/gha_utils.egg-info/requires.txt

@@ -1,16 +1,13 @@
 boltons>=24.0.0
-bump-my-version>=0.21.0
-click-extra~=4.14.1
+bump-my-version>=0.32.2
+click-extra~=4.15.0
+extra-platforms~=3.1.0
 packaging~=24.1
 PyDriller~=2.6
 pyproject-metadata~=0.9.0
 pyyaml~=6.0.0
 wcmatch>=8.5
 
-[:python_version < "3.11"]
-backports.strenum~=1.3.1
-tomli~=2.0.1
-
 [test]
 coverage[toml]~=7.6.0
 pytest~=8.3.1

{gha_utils-4.14.1 → gha_utils-4.15.0}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 # Docs: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
 name = "gha-utils"
-version = "4.14.1"
+version = "4.15.0"
 # Python versions and their status: https://devguide.python.org/versions/
-requires-python = ">= 3.10"
+requires-python = ">= 3.11"
 description = "⚙️ CLI helpers for GitHub Actions + reuseable workflows"
 authors = [{ name = "Kevin Deldycke", email = "kevin@deldycke.com" }]
 readme = "readme.md"
@@ -42,7 +42,6 @@ classifiers = [
     'Operating System :: Microsoft :: Windows',
     'Operating System :: POSIX :: Linux',
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
@@ -68,19 +67,18 @@ classifiers = [
     'Typing :: Typed',
 ]
 dependencies = [
-    "backports.strenum ~= 1.3.1 ; python_version < '3.11'",
     # Loose version to let click-extra set its own stricter dependency.
     "boltons >= 24.0.0",
     # Dependency version is more relaxed on bump-my-version to prevent chicken and egg
     # while releasing gha-utils itself.
-    # v0.21.0 is the first to rely on wcmatch library.
-    "bump-my-version >= 0.21.0",
-    "click-extra ~= 4.14.1",
+    # v0.32.2 is the first fixing an issue preventing compilation with Nuitka.
+    "bump-my-version >= 0.32.2",
+    "click-extra ~= 4.15.0",
+    "extra-platforms ~= 3.1.0",
     "packaging ~= 24.1",
     "PyDriller ~= 2.6",
     "pyproject-metadata ~= 0.9.0",
     "pyyaml ~= 6.0.0",
-    "tomli ~= 2.0.1 ; python_version < '3.11'",
     # Loose version to let click-extra set its own stricter dependency.
     "wcmatch >= 8.5",
 ]
@@ -138,7 +136,7 @@ addopts = [
 xfail_strict = true
 
 [tool.bumpversion]
-current_version = "4.14.1"
+current_version = "4.15.0"
 allow_dirty = true
 ignore_missing_files = true
 

{gha_utils-4.14.1 → gha_utils-4.15.0}/readme.md

@@ -70,7 +70,7 @@ $ uvx gha-utils --version
 gha-utils, version 4.9.0
 ```
 
-That's the best way to get started with `gha-utils`, and experiment with its features.
+That's the best way to get started with `gha-utils` and experiment with it.
 
 ### Executables
 

{gha_utils-4.14.1 → gha_utils-4.15.0}/tests/test_mailmap.py

@@ -27,7 +27,7 @@ def test_remove_header():
         # Generated by gha-utils mailmap-sync v4.4.3 - https://github.com/kdeldycke/workflows
         # Timestamp: 2024-08-12T08:15:41.083405
         # Format is:
-        #   Preferred Name <preferred e-mail>  Other Name <other e-mail>
+        #   Preferred Name <preferred e-mail> Other Name <other e-mail>
         #
         # Reference: https://git-scm.com/docs/git-blame#_mapping_authors
 
@@ -36,7 +36,7 @@ def test_remove_header():
 
     assert remove_header(content) == dedent("""\
         # Format is:
-        #   Preferred Name <preferred e-mail>  Other Name <other e-mail>
+        #   Preferred Name <preferred e-mail> Other Name <other e-mail>
         #
         # Reference: https://git-scm.com/docs/git-blame#_mapping_authors
 

{gha_utils-4.14.1 → gha_utils-4.15.0}/tests/test_metadata.py

@@ -33,9 +33,9 @@ def test_metadata_github_format():
             r"doc_files=[\S ]*\n"
             r"is_python_project=true\n"
             r"package_name=gha-utils\n"
-            r"blacken_docs_params=--target-version py310 --target-version py311 "
+            r"blacken_docs_params=--target-version py311 "
             r"--target-version py312 --target-version py313\n"
-            r"mypy_params=--python-version 3\.10\n"
+            r"mypy_params=--python-version 3\.11\n"
             r"current_version=\n"
             r"released_version=\n"
             r"is_sphinx=false\n"
@@ -44,20 +44,20 @@ def test_metadata_github_format():
             r"new_commits_matrix=\n"
             r"release_commits_matrix=\n"
             r'nuitka_matrix=\{"os": \["ubuntu-24\.04", "ubuntu-24\.04-arm", '
-            r'"macos-15", "macos-13", "windows-2022"\], '
+            r'"macos-15", "macos-13", "windows-2025"\], '
             r'"entry_point": \["gha-utils"\], "commit": \["[a-z0-9]+"\], '
             r'"include": \[\{"entry_point": "gha-utils", '
             r'"cli_id": "gha-utils", "module_id": "gha_utils\.__main__", '
             r'"callable_id": "main", '
             r'"module_path": "gha_utils(/|\\\\)__main__\.py"\}, '
             r'\{"commit": "[a-z0-9]+", "short_sha": "[a-z0-9]+", '
-            r'"current_version": "4\.14\.1"\}, \{"os": "ubuntu-24\.04", '
+            r'"current_version": "[0-9\.]+"\}, \{"os": "ubuntu-24\.04", '
             r'"platform_id": "linux", "arch": "x64", "extension": "bin"\}, '
             r'\{"os": "ubuntu-24\.04-arm", "platform_id": "linux", '
             r'"arch": "arm64", "extension": "bin"\}, \{"os": "macos-15", '
             r'"platform_id": "macos", "arch": "arm64", "extension": "bin"\}, '
             r'\{"os": "macos-13", "platform_id": "macos", "arch": "x64", '
-            r'"extension": "bin"\}, \{"os": "windows-2022", '
+            r'"extension": "bin"\}, \{"os": "windows-2025", '
             r'"platform_id": "windows", "arch": "x64", "extension": "exe"\}, '
             r'\{"os": "ubuntu-24\.04", "entry_point": "gha-utils", '
             r'"commit": "[a-z0-9]+", '
@@ -71,7 +71,7 @@ def test_metadata_github_format():
             r'\{"os": "macos-13", "entry_point": "gha-utils", '
             r'"commit": "[a-z0-9]+", '
             r'"bin_name": "gha-utils-macos-x64-build-[a-z0-9]+\.bin"\}, '
-            r'\{"os": "windows-2022", "entry_point": "gha-utils", '
+            r'\{"os": "windows-2025", "entry_point": "gha-utils", '
             r'"commit": "[a-z0-9]+", '
             r'"bin_name": "gha-utils-windows-x64-build-[a-z0-9]+\.exe"\}\]\}\n'
         ),
@@ -93,11 +93,10 @@ def test_metadata_plain_format():
             r"'is_python_project': True, "
             r"'package_name': 'gha-utils', "
             r"'blacken_docs_params': \("
-            r"'--target-version py310', "
             r"'--target-version py311', "
             r"'--target-version py312', "
             r"'--target-version py313'\), "
-            r"'mypy_params': '--python-version 3\.10', "
+            r"'mypy_params': '--python-version 3\.11', "
             r"'current_version': None, "
             r"'released_version': None, "
             r"'is_sphinx': False, "
@@ -107,20 +106,20 @@ def test_metadata_plain_format():
             r"'release_commits_matrix': None, "
             r"'nuitka_matrix': <Matrix: \{"
             r"'os': \('ubuntu-24\.04', 'ubuntu-24\.04-arm', "
-            r"'macos-15', 'macos-13', 'windows-2022'\), "
+            r"'macos-15', 'macos-13', 'windows-2025'\), "
             r"'entry_point': \('gha-utils',\), "
             r"'commit': \('[a-z0-9]+',\)\}; "
             r"include=\(\{'entry_point': 'gha-utils', 'cli_id': 'gha-utils', "
             r"'module_id': 'gha_utils\.__main__', 'callable_id': 'main', "
             r"'module_path': 'gha_utils(/|\\\\)__main__\.py'\}, "
             r"\{'commit': '[a-z0-9]+', 'short_sha': '[a-z0-9]+', "
-            r"'current_version': '4\.14\.1'\}, \{'os': 'ubuntu-24\.04', "
+            r"'current_version': '[0-9\.]+'\}, \{'os': 'ubuntu-24\.04', "
             r"'platform_id': 'linux', 'arch': 'x64', 'extension': 'bin'}, "
             r"{'os': 'ubuntu-24\.04-arm', 'platform_id': 'linux', "
             r"'arch': 'arm64', 'extension': 'bin'\}, \{'os': 'macos-15', "
             r"'platform_id': 'macos', 'arch': 'arm64', 'extension': 'bin'\}, "
             r"\{'os': 'macos-13', 'platform_id': 'macos', 'arch': 'x64', "
-            r"'extension': 'bin'\}, \{'os': 'windows-2022', 'platform_id': "
+            r"'extension': 'bin'\}, \{'os': 'windows-2025', 'platform_id': "
             r"'windows', 'arch': 'x64', 'extension': 'exe'\}, "
             r"\{'os': 'ubuntu-24\.04', 'entry_point': 'gha-utils', "
             r"'commit': '[a-z0-9]+', "
@@ -134,7 +133,7 @@ def test_metadata_plain_format():
             r"\{'os': 'macos-13', 'entry_point': 'gha-utils', "
             r"'commit': '[a-z0-9]+', 'bin_name': "
             r"'gha-utils-macos-x64-build-[a-z0-9]+\.bin'\}, "
-            r"\{'os': 'windows-2022', 'entry_point': 'gha-utils', "
+            r"\{'os': 'windows-2025', 'entry_point': 'gha-utils', "
             r"'commit': '[a-z0-9]+', "
             r"'bin_name': 'gha-utils-windows-x64-build-[a-z0-9]+\.exe'\}\); "
             r"exclude=\(\)>\}"