gha-utils 4.4.5__py3-none-any.whl → 4.5.0__py3-none-any.whl

gha_utils/__init__.py

@@ -17,4 +17,4 @@
 
 from __future__ import annotations
 
-__version__ = "4.4.5"
+__version__ = "4.5.0"

gha_utils/changelog.py

@@ -112,15 +112,15 @@ class Changelog:
         SECTION_START = "##"
         sections = self.content.split(SECTION_START, 2)
         changelog_header = sections[0] if len(sections) > 0 else "# Changelog\n\n"
-        recent_entry = sections[1] if len(sections) > 1 else ""
-        past_entries = sections[2] if len(sections) > 2 else ""
+        current_entry = f"{SECTION_START}{sections[1]}" if len(sections) > 1 else ""
+        past_entries = f"{SECTION_START}{sections[2]}" if len(sections) > 2 else ""
 
         # Derive the release template from the last entry.
         DATE_REGEX = r"\d{4}\-\d{2}\-\d{2}"
         VERSION_REGEX = r"\d+\.\d+\.\d+"
 
         # Replace the release date with the unreleased tag.
-        new_entry = re.sub(DATE_REGEX, "unreleased", recent_entry, count=1)
+        new_entry = re.sub(DATE_REGEX, "unreleased", current_entry, count=1)
 
         # Update GitHub's comparison URL to target the main branch.
         new_entry = re.sub(
@@ -141,16 +141,12 @@ class Changelog:
             new_entry,
             flags=re.MULTILINE | re.DOTALL,
         )
-
-        # Prefix entries with section marker.
         new_entry = f"{SECTION_START}{new_entry}"
-        history = f"{SECTION_START}{recent_entry}{SECTION_START}{past_entries}"
-
         logging.info("New generated section:\n" + indent(new_entry, " " * 2))
 
         # No need to update.
+        history = f"{current_entry}{past_entries}"
         if new_entry in history:
             return None
-
         # Recompose full changelog with new top entry.
         return f"{changelog_header}{new_entry}{history}"

gha_utils/cli.py

@@ -19,7 +19,6 @@ from __future__ import annotations
 import logging
 import os
 import sys
-from contextlib import contextmanager
 from datetime import datetime
 from pathlib import Path
 
@@ -27,6 +26,7 @@ from click_extra import (
     Choice,
     Context,
     argument,
+    echo,
     extra_group,
     file_path,
     option,
@@ -40,20 +40,14 @@ from .mailmap import Mailmap
 from .metadata import Dialects, Metadata
 
 
-def is_stdout(filepath):
+def is_stdout(filepath: Path) -> bool:
     return str(filepath) == "-"
 
 
-@contextmanager
-def file_writer(filepath):
-    """A context-aware file writer which default to stdout if no path is
-    provided."""
+def handle_stdout(filepath: Path) -> Path | None:
     if is_stdout(filepath):
-        yield sys.stdout
-    else:
-        writer = filepath.open("w")
-        yield writer
-        writer.close()
+        return None
+    return filepath
 
 
 def generate_header(ctx: Context) -> str:
@@ -78,10 +72,12 @@ def remove_header(content: str) -> str:
         if still_in_header:
             # We are still in the header as long as we have blank lines or we have
             # comment lines matching the format produced by the method above.
-            if not line.strip() or line.startswith((
-                "# Generated by ",
-                "# Timestamp: ",
-            )):
+            if not line.strip() or line.startswith(
+                (
+                    "# Generated by ",
+                    "# Timestamp: ",
+                )
+            ):
                 continue
             else:
                 still_in_header = False
@@ -161,9 +157,7 @@ def metadata(ctx, format, overwrite, output_path):
 
     dialect = Dialects(format)
     content = metadata.dump(dialect=dialect)
-
-    with file_writer(output_path) as f:
-        f.write(content)
+    echo(content, file=handle_stdout(output_path))
 
 
 @gha_utils.command(short_help="Maintain a Markdown-formatted changelog")
@@ -183,7 +177,7 @@ def changelog(ctx, source, changelog_path):
     initial_content = None
     if source:
         logging.info(f"Read initial changelog from {source}")
-        initial_content = source.read_text(encoding="utf-8")
+        initial_content = source.read_text(encoding="UTF-8")
 
     changelog = Changelog(initial_content)
     content = changelog.update()
@@ -195,9 +189,7 @@ def changelog(ctx, source, changelog_path):
         logging.info(f"Print updated results to {sys.stdout.name}")
     else:
         logging.info(f"Save updated results to {changelog_path}")
-
-    with file_writer(changelog_path) as f:
-        f.write(content)
+    echo(content, file=handle_stdout(changelog_path))
 
 
 @gha_utils.command(short_help="Update Git's .mailmap file with missing contributors")
@@ -245,7 +237,7 @@ def mailmap_sync(ctx, source, create_if_missing, destination_mailmap):
 
     if source.exists():
         logging.info(f"Read initial mapping from {source}")
-        content = remove_header(source.read_text(encoding="utf-8"))
+        content = remove_header(source.read_text(encoding="UTF-8"))
         mailmap.parse(content)
     else:
         logging.debug(f"Mailmap source file {source} does not exists.")
@@ -271,5 +263,4 @@ def mailmap_sync(ctx, source, create_if_missing, destination_mailmap):
             logging.warning("Nothing to update, stop the sync process.")
             ctx.exit()
 
-    with file_writer(destination_mailmap) as f:
-        f.write(generate_header(ctx) + new_content)
+    echo(generate_header(ctx) + new_content, file=handle_stdout(destination_mailmap))

gha_utils/metadata.py

@@ -267,7 +267,7 @@ class Metadata:
               env:
                 GITHUB_CONTEXT: ${{ toJSON(github) }}
               run: |
-                uv --no-progress run gha-utils --verbosity DEBUG metadata --overwrite "$GITHUB_OUTPUT"
+                gha-utils --verbosity DEBUG metadata --overwrite "$GITHUB_OUTPUT"
 
         .. todo::
             Try to remove reliance on GitHub context entirely so we can eliminate the

{gha_utils-4.4.5.dist-info → gha_utils-4.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: gha-utils
-Version: 4.4.5
+Version: 4.5.0
 Summary: ⚙️ CLI helpers for GitHub Actions + reuseable workflows
 Author-email: Kevin Deldycke <kevin@deldycke.com>
 Project-URL: Homepage, https://github.com/kdeldycke/workflows
@@ -90,11 +90,11 @@ Nothing is done behind your back. A PR is created everytime a change is proposed
 
 Standalone executables of `gha-utils`'s latest version are available as direct downloads for several platforms and architectures:
 
-| Platform          | `x86_64`                                                                                                                         | `arm64`                                                                                                                          |
-| ----------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| **Linux** | [Download `gha-utils-linux-x64.bin`](https://github.com/kdeldycke/workflows/releases/latest/download/gha-utils-linux-x64.bin)     |                                                                                                                                  |
-| **macOS**         | [Download `gha-utils-macos-x64.bin`](https://github.com/kdeldycke/workflows/releases/latest/download/gha-utils-macos-x64.bin)     | [Download `gha-utils-macos-arm64.bin`](https://github.com/kdeldycke/workflows/releases/latest/download/gha-utils-macos-arm64.bin) |
-| **Windows**       | [Download `gha-utils-windows-x64.exe`](https://github.com/kdeldycke/workflows/releases/latest/download/gha-utils-windows-x64.exe) |                                                                                                                                  |
+| Platform    | `x86_64`                                                                                                                          | `arm64`                                                                                                                           |
+| ----------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| **Linux**   | [Download `gha-utils-linux-x64.bin`](https://github.com/kdeldycke/workflows/releases/latest/download/gha-utils-linux-x64.bin)     |                                                                                                                                   |
+| **macOS**   | [Download `gha-utils-macos-x64.bin`](https://github.com/kdeldycke/workflows/releases/latest/download/gha-utils-macos-x64.bin)     | [Download `gha-utils-macos-arm64.bin`](https://github.com/kdeldycke/workflows/releases/latest/download/gha-utils-macos-arm64.bin) |
+| **Windows** | [Download `gha-utils-windows-x64.exe`](https://github.com/kdeldycke/workflows/releases/latest/download/gha-utils-windows-x64.exe) |                                                                                                                                   |
 
 ### Run dev version
 
@@ -216,7 +216,7 @@ You will always end up with this kind or errors:
   error: failed to push some refs to 'https://github.com/kdeldycke/my-repo'
 ```
 
-> \[!NOTE\]
+> [!NOTE]
 > That's also why the Settings > Actions > General > Workflow permissions parameter on your repository has no effect on this issue, even with the `Read and write permissions` set:
 > ![](docs/assets/repo-workflow-permissions.png)
 
@@ -233,7 +233,7 @@ To create this custom `WORKFLOW_UPDATE_GITHUB_PAT`:
   - `Metadata` (mandatory): `Access: **Read-only**`
   - `Pull Requests`: `Access: **Read and Write**`
   - `Workflows`: `Access: **Read and Write**`
-    > \[!NOTE\]
+    > [!NOTE]
     > This is the only place where I can have control over the `Workflows` permission, which is not supported by the `permissions:` parameter in YAML files.
 - Now save these parameters and copy the `github_pat_XXXX` secret token
 - Got to your repo > `Settings` > `Security` > `Secrets and variables` > `Actions` > `Secrets` > `Repository secrets` and click `New repository secrets`

gha_utils-4.5.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+gha_utils/__init__.py,sha256=2hpwFw1Fxf-LQg9Elgz4VZow1ivxy9LI5LEfSKa3mQY,865
+gha_utils/__main__.py,sha256=Dck9BjpLXmIRS83k0mghAMcYVYiMiFLltQdfRuMSP_Q,1703
+gha_utils/changelog.py,sha256=-Iek7GkoM2MhUVQ_CloQzSMMUvX0TfDLytbDuZmrPRs,5923
+gha_utils/cli.py,sha256=WE8Pi4Ga3S_2cn2u2RT7XC6ngrXhrQE4UnFwNOPW6Ec,8976
+gha_utils/mailmap.py,sha256=sum4XIme2Dis7XtHyO9U7ogWelZwqb-yvJ5I92PPnqg,6301
+gha_utils/metadata.py,sha256=FLkNjjAlB3FieMgvbtBQwWnA7tE6APEGnGHgbe8gbZg,47203
+gha_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gha_utils-4.5.0.dist-info/METADATA,sha256=HfmzzdwWWdQ6kyXh0T_rsTJIZdK9KMZMemCaTg8CnHs,17976
+gha_utils-4.5.0.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91
+gha_utils-4.5.0.dist-info/entry_points.txt,sha256=8bJOwQYf9ZqsLhBR6gUCzvwLNI9f8tiiBrJ3AR0EK4o,54
+gha_utils-4.5.0.dist-info/top_level.txt,sha256=C94Blb61YkkyPBwCdM3J_JPDjWH0lnKa5nGZeZ5M6yE,10
+gha_utils-4.5.0.dist-info/RECORD,,

{gha_utils-4.4.5.dist-info → gha_utils-4.5.0.dist-info}/WHEEL

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

gha_utils-4.4.5.dist-info/RECORD

@@ -1,12 +0,0 @@
-gha_utils/__init__.py,sha256=QBMQJ3ouEfz5WZFuN6QGlA8qM7VUlElMMuR7YamFzWw,865
-gha_utils/__main__.py,sha256=Dck9BjpLXmIRS83k0mghAMcYVYiMiFLltQdfRuMSP_Q,1703
-gha_utils/changelog.py,sha256=KuM323SslStwh25fuEiom39t1kfcgwxHAwi6KNy0Lhk,5959
-gha_utils/cli.py,sha256=4wUG29fB0-Z-n105UBgIg5NLuqtODtoMLwKJP7RQFXo,9150
-gha_utils/mailmap.py,sha256=sum4XIme2Dis7XtHyO9U7ogWelZwqb-yvJ5I92PPnqg,6301
-gha_utils/metadata.py,sha256=d7s3_wlWweIxvv5xvtnKg_ohqojRF8eVBR2U5PxHUlA,47224
-gha_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gha_utils-4.4.5.dist-info/METADATA,sha256=QKk6F3Y4yLI_W-UFodlLep6_FRjO3ASH_FjDPJSFfVQ,17996
-gha_utils-4.4.5.dist-info/WHEEL,sha256=HiCZjzuy6Dw0hdX5R3LCFPDmFS4BWl8H-8W39XfmgX4,91
-gha_utils-4.4.5.dist-info/entry_points.txt,sha256=8bJOwQYf9ZqsLhBR6gUCzvwLNI9f8tiiBrJ3AR0EK4o,54
-gha_utils-4.4.5.dist-info/top_level.txt,sha256=C94Blb61YkkyPBwCdM3J_JPDjWH0lnKa5nGZeZ5M6yE,10
-gha_utils-4.4.5.dist-info/RECORD,,