gha-utils 4.15.6__py3-none-any.whl → 4.16.0__py3-none-any.whl

gha_utils/__init__.py

@@ -17,4 +17,4 @@
 
 from __future__ import annotations
 
-__version__ = "4.15.6"
+__version__ = "4.16.0"

gha_utils/cli.py

@@ -29,6 +29,7 @@ from click_extra import (
     Choice,
     Context,
     FloatRange,
+    IntRange,
     argument,
     echo,
     extra_group,
@@ -301,6 +302,16 @@ def mailmap_sync(ctx, source, create_if_missing, destination_mailmap):
     help="Name of an environment variable containing a test plan in YAML. This "
     "option can be repeated to collect multiple test plans.",
 )
+@option(
+    "-t",
+    "--select-test",
+    type=IntRange(min=1),
+    multiple=True,
+    metavar="INTEGER",
+    help="Only run the tests matching the provided test case numbers. This option can "
+    "be repeated to run multiple test cases. If not provided, all test cases will be "
+    "run.",
+)
 @option(
     "-s",
     "--skip-platform",
@@ -310,7 +321,14 @@ def mailmap_sync(ctx, source, create_if_missing, destination_mailmap):
     "skip multiple platforms.",
 )
 @option(
-    "-t",
+    "-x",
+    "--exit-on-error",
+    is_flag=True,
+    default=False,
+    help="Exit instantly on first failed test.",
+)
+@option(
+    "-T",
     "--timeout",
     # Timeout passed to subprocess.run() is a float that is silently clamped to
     # 0.0 is negative values are provided, so we mimic this behavior here:
@@ -320,12 +338,21 @@ def mailmap_sync(ctx, source, create_if_missing, destination_mailmap):
     help="Set the default timeout for each CLI call, if not specified in the "
     "test plan.",
 )
+@option(
+    "--stats/--no-stats",
+    is_flag=True,
+    default=True,
+    help="Print per-manager package statistics.",
+)
 def test_plan(
     binary: Path,
     plan_file: tuple[Path, ...] | None,
     plan_envvar: tuple[str, ...] | None,
+    select_test: tuple[int, ...] | None,
     skip_platform: tuple[str, ...] | None,
+    exit_on_error: bool,
     timeout: float | None,
+    stats: bool,
 ) -> None:
     # Load test plan from workflow input, or use a default one.
     test_list = []
@@ -349,25 +376,38 @@ def test_plan(
         test_list = DEFAULT_TEST_PLAN
     logging.debug(f"Test plan: {test_list}")
 
-    stats = Counter(total=len(test_list), skipped=0, failed=0)
+    counter = Counter(total=len(test_list), skipped=0, failed=0)
 
     for index, test_case in enumerate(test_list):
-        logging.info(f"Run test #{index + 1}")
+        test_number = index + 1
+        test_name = f"#{test_number}"
+        logging.info(f"Run test {test_name}...")
+
+        if select_test and test_number not in select_test:
+            logging.warning(f"Test {test_name} skipped by user request.")
+            counter["skipped"] += 1
+            continue
+
         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}")
+            counter["skipped"] += 1
+            logging.warning(f"Test {test_name} skipped: {ex}")
         except Exception as ex:
-            stats["failed"] += 1
-            logging.error(f"Test failed: {ex}")
+            counter["failed"] += 1
+            logging.error(f"Test {test_name} failed: {ex}")
+            if exit_on_error:
+                logging.debug("Don't continue testing, a failed test was found.")
+                sys.exit(1)
+
+    if stats:
+        echo(
+            "Test plan results - "
+            + ", ".join((f"{k.title()}: {v}" for k, v in counter.items()))
+        )
 
-    logging.info(
-        "Test plan results - "
-        + ", ".join((f"{k.title()}: {v}" for k, v in stats.items()))
-    )
-    if stats["failed"]:
+    if counter["failed"]:
         sys.exit(1)

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-2025'],
+                'os': ['ubuntu-24.04-arm', 'ubuntu-24.04', 'macos-15', 'macos-13', 'windows-11-arm', 'windows-2025'],
                 'include': [{'entry_point': 'mpm',
                              'cli_id': 'mpm',
                              'module_id': 'meta_package_manager.__main__',
@@ -61,14 +61,14 @@ nuitka_matrix={'entry_point': ['mpm'],
                             {'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
                              'short_sha': '6f27db4',
                              'current_version': '1.9.1'},
-                            {'os': 'ubuntu-24.04',
-                             'platform_id': 'linux',
-                             'arch': 'x64',
-                             'extension': 'bin'},
                             {'os': 'ubuntu-24.04-arm',
                              'platform_id': 'linux',
                              'arch': 'arm64',
                              'extension': 'bin'},
+                            {'os': 'ubuntu-24.04',
+                             'platform_id': 'linux',
+                             'arch': 'x64',
+                             'extension': 'bin'},
                             {'os': 'macos-15',
                              'platform_id': 'macos',
                              'arch': 'arm64',
@@ -77,20 +77,14 @@ nuitka_matrix={'entry_point': ['mpm'],
                              'platform_id': 'macos',
                              'arch': 'x64',
                              'extension': 'bin'},
+                            {'os': 'windows-11-arm',
+                             'platform_id": 'windows',
+                             'arch": 'arm64',
+                             'extension": 'exe'},
                             {'os': 'windows-2025',
                              'platform_id': 'windows',
                              'arch': 'x64',
                              'extension': 'exe'},
-                            {'entry_point': 'mpm',
-                             'commit': '346ce664f055fbd042a25ee0b7e96702e95',
-                             'os': 'ubuntu-24.04',
-                             'arch': 'x64',
-                             'bin_name': 'mpm-linux-x64-build-346ce66.bin'},
-                            {'entry_point': 'mpm',
-                             'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
-                             'os': 'ubuntu-24.04',
-                             'arch': 'x64',
-                             'bin_name': 'mpm-linux-x64-build-6f27db4.bin'},
                             {'entry_point': 'mpm',
                              'commit': '346ce664f055fbd042a25ee0b7e96702e95',
                              'os': 'ubuntu-24.04-arm',
@@ -101,6 +95,16 @@ nuitka_matrix={'entry_point': ['mpm'],
                              'os': 'ubuntu-24.04-arm',
                              'arch': 'arm64',
                              'bin_name': 'mpm-linux-arm64-build-6f27db4.bin'},
+                            {'entry_point': 'mpm',
+                             'commit': '346ce664f055fbd042a25ee0b7e96702e95',
+                             'os': 'ubuntu-24.04',
+                             'arch': 'x64',
+                             'bin_name': 'mpm-linux-x64-build-346ce66.bin'},
+                            {'entry_point': 'mpm',
+                             'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
+                             'os': 'ubuntu-24.04',
+                             'arch': 'x64',
+                             'bin_name': 'mpm-linux-x64-build-6f27db4.bin'},
                             {'entry_point': 'mpm',
                              'commit': '346ce664f055fbd042a25ee0b7e96702e95',
                              'os': 'macos-15',
@@ -121,6 +125,16 @@ nuitka_matrix={'entry_point': ['mpm'],
                              'os': 'macos-13',
                              'arch': 'x64',
                              'bin_name': 'mpm-macos-x64-build-6f27db4.bin'},
+                            {'entry_point': 'mpm',
+                             'commit': '346ce664f055fbd042a25ee0b7e96702e95',
+                             'os': 'windows-11-arm',
+                             'arch': 'arm64',
+                             'bin_name': 'mpm-windows-arm64-build-346ce66.bin'},
+                            {'entry_point': 'mpm',
+                             'commit': '6f27db47612aaee06fdf08744b09a9f5f6c2',
+                             'os': 'windows-11-arm',
+                             'arch': 'arm64',
+                             'bin_name': 'mpm-windows-arm64-build-6f27db4.bin'},
                             {'entry_point': 'mpm',
                              'commit': '346ce664f055fbd042a25ee0b7e96702e95',
                              'os': 'windows-2025',
@@ -147,6 +161,7 @@ import json
 import logging
 import os
 import re
+import tomllib
 from collections.abc import Iterable
 from enum import StrEnum
 from functools import cached_property
@@ -155,7 +170,6 @@ from random import randint
 from re import escape
 from typing import Any, Final, Iterator, cast
 
-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]
@@ -876,10 +890,11 @@ class Metadata:
                     "6f27db47612aaee06fdf08744b09a9f5f6c2",
                 ],
                 "os": [
-                    "ubuntu-24.04",
                     "ubuntu-24.04-arm",
+                    "ubuntu-24.04",
                     "macos-15",
                     "macos-13",
+                    "windows-11-arm",
                     "windows-2025",
                 ],
                 "include": [
@@ -901,15 +916,15 @@ class Metadata:
                         "current_version": "1.9.1",
                     },
                     {
-                        "os": "ubuntu-24.04",
+                        "os": "ubuntu-24.04-arm",
                         "platform_id": "linux",
-                        "arch": "x64",
+                        "arch": "arm64",
                         "extension": "bin",
                     },
                     {
-                        "os": "ubuntu-24.04-arm",
+                        "os": "ubuntu-24.04",
                         "platform_id": "linux",
-                        "arch": "arm64",
+                        "arch": "x64",
                         "extension": "bin",
                     },
                     {
@@ -924,6 +939,12 @@ class Metadata:
                         "arch": "x64",
                         "extension": "bin",
                     },
+                    {
+                        "os": "windows-11-arm",
+                        "platform_id": "windows",
+                        "arch": "arm64",
+                        "extension": "exe",
+                    },
                     {
                         "os": "windows-2025",
                         "platform_id": "windows",
@@ -933,30 +954,30 @@ class Metadata:
                     {
                         "entry_point": "mpm",
                         "commit": "346ce664f055fbd042a25ee0b7e96702e95",
-                        "os": "ubuntu-24.04",
-                        "arch": "x64",
-                        "bin_name": "mpm-linux-x64-build-346ce66.bin",
+                        "os": "ubuntu-24.04-arm",
+                        "arch": "arm64",
+                        "bin_name": "mpm-linux-arm64-build-346ce66.bin",
                     },
                     {
                         "entry_point": "mpm",
                         "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
-                        "os": "ubuntu-24.04",
-                        "arch": "x64",
-                        "bin_name": "mpm-linux-x64-build-6f27db4.bin",
+                        "os": "ubuntu-24.04-arm",
+                        "arch": "arm64",
+                        "bin_name": "mpm-linux-arm64-build-6f27db4.bin",
                     },
                     {
                         "entry_point": "mpm",
                         "commit": "346ce664f055fbd042a25ee0b7e96702e95",
-                        "os": "ubuntu-24.04-arm",
-                        "arch": "arm64",
-                        "bin_name": "mpm-linux-arm64-build-346ce66.bin",
+                        "os": "ubuntu-24.04",
+                        "arch": "x64",
+                        "bin_name": "mpm-linux-x64-build-346ce66.bin",
                     },
                     {
                         "entry_point": "mpm",
                         "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
-                        "os": "ubuntu-24.04-arm",
-                        "arch": "arm64",
-                        "bin_name": "mpm-linux-arm64-build-6f27db4.bin",
+                        "os": "ubuntu-24.04",
+                        "arch": "x64",
+                        "bin_name": "mpm-linux-x64-build-6f27db4.bin",
                     },
                     {
                         "entry_point": "mpm",
@@ -986,6 +1007,20 @@ class Metadata:
                         "arch": "x64",
                         "bin_name": "mpm-macos-x64-build-6f27db4.bin",
                     },
+                    {
+                        "entry_point": "mpm",
+                        "commit": "346ce664f055fbd042a25ee0b7e96702e95",
+                        "os": "windows-11-arm",
+                        "arch": "arm64",
+                        "bin_name": "mpm-windows-arm64-build-346ce66.bin",
+                    },
+                    {
+                        "entry_point": "mpm",
+                        "commit": "6f27db47612aaee06fdf08744b09a9f5f6c2",
+                        "os": "windows-11-arm",
+                        "arch": "arm64",
+                        "bin_name": "mpm-windows-arm64-build-6f27db4.bin",
+                    },
                     {
                         "entry_point": "mpm",
                         "commit": "346ce664f055fbd042a25ee0b7e96702e95",
@@ -1009,18 +1044,17 @@ class Metadata:
 
         matrix = Matrix()
 
-        # Run the compilation only on the latest supported version of each OS. The
-        # exception is macOS, as macos-15 is arm64-only and macos-13 is x64-only, so we
-        # need both to target the two architectures.
-        # XXX arm64 Windows is planned for the future:
-        # https://github.com/actions/runner-images/issues/10820
+        # Run the compilation only on the latest supported version of each OS. Note
+        # that macOS and Windows do not have the latest version available for each
+        # architecture.
         matrix.add_variation(
             "os",
             (
-                "ubuntu-24.04",  # x64
                 "ubuntu-24.04-arm",  # arm64
+                "ubuntu-24.04",  # x64
                 "macos-15",  # arm64
                 "macos-13",  # x64
+                "windows-11-arm",  # arm64
                 "windows-2025",  # x64
             ),
         )
@@ -1057,20 +1091,20 @@ class Metadata:
 
         # Add platform-specific variables.
         # Arch values are inspired from those specified for self-hosted runners:
-        # https://docs.github.com/en/actions/hosting-your-own-runners/about-self-hosted-runners#architectures
-        # Arch is not a matrix variant because support is not widely distributed
-        # between different OS.
+        # https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/supported-architectures-and-operating-systems-for-self-hosted-runners#supported-processor-architectures
+        # XXX Maybe we should just adopt target triple:
+        # https://mcyoung.xyz/2025/04/14/target-triples/
         matrix.add_includes(
             {
-                "os": "ubuntu-24.04",
+                "os": "ubuntu-24.04-arm",
                 "platform_id": "linux",
-                "arch": "x64",
+                "arch": "arm64",
                 "extension": "bin",
             },
             {
-                "os": "ubuntu-24.04-arm",
+                "os": "ubuntu-24.04",
                 "platform_id": "linux",
-                "arch": "arm64",
+                "arch": "x64",
                 "extension": "bin",
             },
             {
@@ -1085,6 +1119,12 @@ class Metadata:
                 "arch": "x64",
                 "extension": "bin",
             },
+            {
+                "os": "windows-11-arm",
+                "platform_id": "windows",
+                "arch": "arm64",
+                "extension": "exe",
+            },
             {
                 "os": "windows-2025",
                 "platform_id": "windows",

gha_utils/test_plan.py

@@ -255,7 +255,7 @@ class CLITestCase:
 
             elif field_id.endswith("_regex_matches"):
                 for regex in field_data:
-                    logging.info(f"Check if {name} matches {sub_string!r}")
+                    logging.info(f"Check if {name} matches {regex!r}")
                     if not regex.search(output):
                         raise AssertionError(f"{name} does not match regex {regex}")
 

{gha_utils-4.15.6.dist-info → gha_utils-4.16.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gha-utils
-Version: 4.15.6
+Version: 4.16.0
 Summary: ⚙️ CLI helpers for GitHub Actions + reuseable workflows
 Author-email: Kevin Deldycke <kevin@deldycke.com>
 Project-URL: Homepage, https://github.com/kdeldycke/workflows
@@ -48,7 +48,7 @@ Requires-Dist: boltons>=24.0.0
 Requires-Dist: bump-my-version<1.1.1,>=0.32.2
 Requires-Dist: click-extra~=4.15.0
 Requires-Dist: extra-platforms~=3.1.0
-Requires-Dist: packaging~=24.1
+Requires-Dist: packaging~=25.0
 Requires-Dist: PyDriller~=2.6
 Requires-Dist: pyproject-metadata~=0.9.0
 Requires-Dist: pyyaml~=6.0.0
@@ -307,7 +307,7 @@ Now re-run your actions and they should be able to update the workflow files in
 
 ### Release management
 
-It turns out [Release Engineering is a full-time job, and full of edge-cases](https://blog.axo.dev/2023/02/cargo-dist).
+It turns out [Release Engineering is a full-time job, and full of edge-cases](https://web.archive.org/web/20250126113318/https://blog.axo.dev/2023/02/cargo-dist).
 
 Things have improved a lot in the Python ecosystem with `uv`. But there are still a lot of manual steps to do to release.
 

gha_utils-4.16.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+gha_utils/__init__.py,sha256=dU1v_nE4J435yv5fPvnuQzfu5zhfYS8m31Ck8gY1r_U,866
+gha_utils/__main__.py,sha256=Dck9BjpLXmIRS83k0mghAMcYVYiMiFLltQdfRuMSP_Q,1703
+gha_utils/changelog.py,sha256=JR7iQrWjLoIOpVNe6iXQSyEii82_hM_zrYpR7QO_Uxo,5777
+gha_utils/cli.py,sha256=ZCfGZl7yE7dB_0Tsw0Znui0N80cfUDhMcPuoZIikSxw,13966
+gha_utils/mailmap.py,sha256=naUqJYJnE3fLTjju1nd6WMm7ODiSaI2SHuJxRtmaFWs,6269
+gha_utils/matrix.py,sha256=_afJD0K-xZLNxwykVnUhD0Gj9cdO0Z43g3VHa-q_tkI,11941
+gha_utils/metadata.py,sha256=hJp_NHZh6zjQU_I3Rh5Xm-ecFZFDU2tQsGHMHomOEY0,50633
+gha_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gha_utils/test_plan.py,sha256=PZbWskpop02eiobg2g9GRWU3UDDfKUMhwJCvv6p9XsU,13144
+gha_utils-4.16.0.dist-info/METADATA,sha256=Fo8DhBLPKg5Kfe3aUZkoIt2QThRvP0E84903pw572HI,21149
+gha_utils-4.16.0.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
+gha_utils-4.16.0.dist-info/entry_points.txt,sha256=8bJOwQYf9ZqsLhBR6gUCzvwLNI9f8tiiBrJ3AR0EK4o,54
+gha_utils-4.16.0.dist-info/top_level.txt,sha256=C94Blb61YkkyPBwCdM3J_JPDjWH0lnKa5nGZeZ5M6yE,10
+gha_utils-4.16.0.dist-info/RECORD,,

{gha_utils-4.15.6.dist-info → gha_utils-4.16.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (78.1.1)
+Generator: setuptools (79.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

gha_utils-4.15.6.dist-info/RECORD

@@ -1,14 +0,0 @@
-gha_utils/__init__.py,sha256=1qDATf4vm-Wr_OY4TSAcExU4Gz02lpstGRA3TTFbU9U,866
-gha_utils/__main__.py,sha256=Dck9BjpLXmIRS83k0mghAMcYVYiMiFLltQdfRuMSP_Q,1703
-gha_utils/changelog.py,sha256=JR7iQrWjLoIOpVNe6iXQSyEii82_hM_zrYpR7QO_Uxo,5777
-gha_utils/cli.py,sha256=rE9sjDj4iFqzyj8PwwSt8JkDSgULltm9qvUgXOqGtT4,12858
-gha_utils/mailmap.py,sha256=naUqJYJnE3fLTjju1nd6WMm7ODiSaI2SHuJxRtmaFWs,6269
-gha_utils/matrix.py,sha256=_afJD0K-xZLNxwykVnUhD0Gj9cdO0Z43g3VHa-q_tkI,11941
-gha_utils/metadata.py,sha256=CCUVH2RXG9PdB1F5GA7HUO0MSBpxq0BGvVnY8qY4ZXA,48705
-gha_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gha_utils/test_plan.py,sha256=57qwIaYfOLbyVKA5X4wldAKePxfvclK7lut--If2fSA,13149
-gha_utils-4.15.6.dist-info/METADATA,sha256=XLS9FmukBl_iAc4dISRAjlgUMSle3c55oUMMkeTknr8,21106
-gha_utils-4.15.6.dist-info/WHEEL,sha256=lTU6B6eIfYoiQJTZNc-fyaR6BpL6ehTzU3xGYxn2n8k,91
-gha_utils-4.15.6.dist-info/entry_points.txt,sha256=8bJOwQYf9ZqsLhBR6gUCzvwLNI9f8tiiBrJ3AR0EK4o,54
-gha_utils-4.15.6.dist-info/top_level.txt,sha256=C94Blb61YkkyPBwCdM3J_JPDjWH0lnKa5nGZeZ5M6yE,10
-gha_utils-4.15.6.dist-info/RECORD,,