dycw-actions 0.2.2__py3-none-any.whl

actions/__init__.py

@@ -0,0 +1,3 @@
+from __future__ import annotations
+
+__version__ = "0.2.2"

actions/cli.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+from click import group
+from utilities.click import CONTEXT_SETTINGS
+
+from actions.publish.cli import publish_sub_cmd
+from actions.sleep.cli import sleep_sub_cmd
+from actions.tag.cli import tag_sub_cmd
+
+
+@group(**CONTEXT_SETTINGS)
+def _main() -> None: ...
+
+
+_ = _main.command(name="publish", **CONTEXT_SETTINGS)(publish_sub_cmd)
+_ = _main.command(name="sleep", **CONTEXT_SETTINGS)(sleep_sub_cmd)
+_ = _main.command(name="tag", **CONTEXT_SETTINGS)(tag_sub_cmd)
+
+
+if __name__ == "__main__":
+    _main()

actions/logging.py

@@ -0,0 +1,8 @@
+from __future__ import annotations
+
+from logging import getLogger
+
+LOGGER = getLogger("actions")
+
+
+__all__ = ["LOGGER"]

actions/publish/__init__.py

@@ -0,0 +1 @@
+from __future__ import annotations

actions/publish/cli.py

@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+from rich.pretty import pretty_repr
+from typed_settings import click_options
+from utilities.logging import basic_config
+
+from actions import __version__
+from actions.logging import LOGGER
+from actions.publish.lib import publish_package
+from actions.publish.settings import PublishSettings
+from actions.settings import CommonSettings
+from actions.utilities import ENV_LOADER
+
+
+@click_options(
+    CommonSettings, [ENV_LOADER], show_envvars_in_help=True, argname="common"
+)
+@click_options(
+    PublishSettings, [ENV_LOADER], show_envvars_in_help=True, argname="publish"
+)
+def publish_sub_cmd(*, common: CommonSettings, publish: PublishSettings) -> None:
+    basic_config(obj=LOGGER)
+    LOGGER.info(
+        """\
+Running '%r' (version %s) with settings:
+%s
+%s""",
+        publish_package.__name__,
+        __version__,
+        pretty_repr(common),
+        pretty_repr(publish),
+    )
+    if common.dry_run:
+        LOGGER.info("Dry run; exiting...")
+        return
+    publish_package(
+        username=publish.username,
+        password=publish.password,
+        publish_url=publish.publish_url,
+        trusted_publishing=publish.trusted_publishing,
+        native_tls=publish.native_tls,
+    )
+
+
+__all__ = ["publish_sub_cmd"]

actions/publish/lib.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from utilities.tempfile import TemporaryDirectory
+
+from actions import __version__
+from actions.logging import LOGGER
+from actions.publish.settings import PUBLISH_SETTINGS
+from actions.utilities import log_run
+
+if TYPE_CHECKING:
+    from typed_settings import Secret
+
+
+def publish_package(
+    *,
+    username: str | None = PUBLISH_SETTINGS.username,
+    password: Secret[str] | None = PUBLISH_SETTINGS.password,
+    publish_url: str | None = PUBLISH_SETTINGS.publish_url,
+    trusted_publishing: bool = PUBLISH_SETTINGS.trusted_publishing,
+    native_tls: bool = PUBLISH_SETTINGS.native_tls,
+) -> None:
+    LOGGER.info(
+        """\
+Running %r (version %s) with settings:
+ - username           = %s
+ - password           = %s
+ - publish_url        = %s
+ - trusted_publishing = %s
+ - native_tls         = %s
+ """,
+        publish_package.__name__,
+        __version__,
+        username,
+        password,
+        publish_url,
+        trusted_publishing,
+        native_tls,
+    )
+    with TemporaryDirectory() as temp:
+        _ = log_run("uv", "build", "--out-dir", str(temp), "--wheel", "--clear")
+        _ = log_run(
+            "uv",
+            "publish",
+            *([] if username is None else ["--username", username]),
+            *([] if password is None else ["--password", password]),
+            *([] if publish_url is None else ["--publish-url", publish_url]),
+            *(["--trusted-publishing", "always"] if trusted_publishing else []),
+            *(["--native-tls"] if native_tls else []),
+            f"{temp}/*",
+        )
+
+
+__all__ = ["publish_package"]

actions/publish/settings.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+from typed_settings import Secret, load_settings, option, secret, settings
+
+from actions.utilities import ENV_LOADER, empty_str_to_none
+
+
+@settings
+class PublishSettings:
+    token: Secret[str] | None = secret(
+        default=None, converter=empty_str_to_none, help="GitHub token"
+    )
+    username: str | None = option(
+        default=None, converter=empty_str_to_none, help="The username of the upload"
+    )
+    password: Secret[str] | None = secret(
+        default=None, converter=empty_str_to_none, help="The password for the upload"
+    )
+    publish_url: str | None = option(
+        default=None, converter=empty_str_to_none, help="The URL of the upload endpoint"
+    )
+    trusted_publishing: bool = option(
+        default=False, help="Configure trusted publishing"
+    )
+    native_tls: bool = option(
+        default=False,
+        help="Whether to load TLS certificates from the platform's native certificate store",
+    )
+    dry_run: bool = option(default=False, help="Dry run the CLI")
+
+
+PUBLISH_SETTINGS = load_settings(PublishSettings, [ENV_LOADER])
+
+
+__all__ = ["PUBLISH_SETTINGS", "PublishSettings"]

actions/settings.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from typed_settings import Secret, load_settings, option, secret, settings
+
+from actions.utilities import ENV_LOADER, empty_str_to_none
+
+
+@settings
+class CommonSettings:
+    token: Secret[str] | None = secret(
+        default=None, converter=empty_str_to_none, help="GitHub token"
+    )
+    dry_run: bool = option(default=False, help="Dry run the CLI")
+
+
+COMMON_SETTINGS = load_settings(CommonSettings, [ENV_LOADER])
+
+
+__all__ = ["COMMON_SETTINGS", "CommonSettings"]

actions/sleep/__init__.py

@@ -0,0 +1 @@
+from __future__ import annotations

actions/sleep/cli.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from rich.pretty import pretty_repr
+from typed_settings import click_options
+from utilities.logging import basic_config
+
+from actions import __version__
+from actions.logging import LOGGER
+from actions.settings import CommonSettings
+from actions.sleep.lib import random_sleep
+from actions.sleep.settings import SleepSettings
+from actions.utilities import ENV_LOADER
+
+
+@click_options(
+    CommonSettings, [ENV_LOADER], show_envvars_in_help=True, argname="common"
+)
+@click_options(SleepSettings, [ENV_LOADER], show_envvars_in_help=True, argname="sleep")
+def sleep_sub_cmd(*, common: CommonSettings, sleep: SleepSettings) -> None:
+    basic_config(obj=LOGGER)
+    LOGGER.info(
+        """\
+Running '%r' (version %s) with settings:
+%s
+%s""",
+        random_sleep.__name__,
+        __version__,
+        pretty_repr(common),
+        pretty_repr(sleep),
+    )
+    if common.dry_run:
+        LOGGER.info("Dry run; exiting...")
+        return
+    random_sleep(
+        min_=sleep.min, max_=sleep.max, step=sleep.step, log_freq=sleep.log_freq
+    )
+
+
+__all__ = ["sleep_sub_cmd"]

actions/sleep/lib.py

@@ -0,0 +1,66 @@
+from __future__ import annotations
+
+from math import ceil, floor
+from random import choice
+from time import sleep
+
+from utilities.whenever import get_now
+from whenever import TimeDelta, ZonedDateTime
+
+from actions import __version__
+from actions.logging import LOGGER
+from actions.sleep.settings import SLEEP_SETTINGS
+
+
+def random_sleep(
+    *,
+    min_: int = SLEEP_SETTINGS.min,
+    max_: int = SLEEP_SETTINGS.max,
+    step: int = SLEEP_SETTINGS.step,
+    log_freq: int = SLEEP_SETTINGS.log_freq,
+) -> None:
+    LOGGER.info(
+        """\
+Running %r (version %s) with settings:
+ - min_     = %s
+ - max_     = %s
+ - step     = %s
+ - log_freq = %s
+""",
+        random_sleep.__name__,
+        __version__,
+        min_,
+        max_,
+        step,
+        log_freq,
+    )
+    start = get_now()
+    delta = TimeDelta(seconds=choice(range(min_, max_, step)))
+    LOGGER.info("Sleeping for %s...", delta)
+    end = (start + delta).round(mode="ceil")
+    while (now := get_now()) < end:
+        _intermediate(start, now, end, log_freq=log_freq)
+    LOGGER.info("Finished sleeping for %s", delta)
+
+
+def _intermediate(
+    start: ZonedDateTime,
+    now: ZonedDateTime,
+    end: ZonedDateTime,
+    /,
+    *,
+    log_freq: int = SLEEP_SETTINGS.log_freq,
+) -> None:
+    elapsed = TimeDelta(seconds=floor((now - start).in_seconds()))
+    remaining = TimeDelta(seconds=ceil((end - now).in_seconds()))
+    this_sleep = min(remaining, TimeDelta(seconds=log_freq))
+    LOGGER.info(
+        "Sleeping for %s... (elapsed = %s, remaining = %s)",
+        this_sleep,
+        elapsed,
+        remaining,
+    )
+    sleep(round(this_sleep.in_seconds()))
+
+
+__all__ = ["random_sleep"]

actions/sleep/settings.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from typed_settings import load_settings, option, settings
+
+from actions.utilities import ENV_LOADER
+
+
+@settings
+class SleepSettings:
+    min: int = option(default=0, help="Minimum duration, in seconds")
+    max: int = option(default=3600, help="Maximum duration, in seconds")
+    step: int = option(default=1, help="Step duration, in seconds")
+    log_freq: int = option(default=60, help="Log frequency, in seconds")
+
+
+SLEEP_SETTINGS = load_settings(SleepSettings, [ENV_LOADER])
+
+
+__all__ = ["SLEEP_SETTINGS", "SleepSettings"]

actions/tag/__init__.py

@@ -0,0 +1 @@
+from __future__ import annotations

actions/tag/cli.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from rich.pretty import pretty_repr
+from typed_settings import click_options
+from utilities.logging import basic_config
+
+from actions import __version__
+from actions.logging import LOGGER
+from actions.settings import CommonSettings
+from actions.tag.lib import tag_commit
+from actions.tag.settings import TagSettings
+from actions.utilities import ENV_LOADER
+
+
+@click_options(
+    CommonSettings, [ENV_LOADER], show_envvars_in_help=True, argname="common"
+)
+@click_options(TagSettings, [ENV_LOADER], show_envvars_in_help=True, argname="tag")
+def tag_sub_cmd(*, common: CommonSettings, tag: TagSettings) -> None:
+    basic_config(obj=LOGGER)
+    LOGGER.info(
+        """\
+Running '%r' (version %s) with settings:
+%s
+%s""",
+        tag_commit.__name__,
+        __version__,
+        pretty_repr(common),
+        pretty_repr(tag),
+    )
+    if common.dry_run:
+        LOGGER.info("Dry run; exiting...")
+        return
+    tag_commit(
+        user_name=tag.user_name,
+        user_email=tag.user_email,
+        major_minor=tag.major_minor,
+        major=tag.major,
+        latest=tag.latest,
+    )
+
+
+__all__ = ["tag_sub_cmd"]

actions/tag/lib.py

@@ -0,0 +1,60 @@
+from __future__ import annotations
+
+from contextlib import suppress
+from subprocess import CalledProcessError
+
+from utilities.version import parse_version
+
+from actions import __version__
+from actions.logging import LOGGER
+from actions.tag.settings import TAG_SETTINGS
+from actions.utilities import log_run
+
+
+def tag_commit(
+    *,
+    user_name: str = TAG_SETTINGS.user_name,
+    user_email: str = TAG_SETTINGS.user_email,
+    major_minor: bool = TAG_SETTINGS.major_minor,
+    major: bool = TAG_SETTINGS.major,
+    latest: bool = TAG_SETTINGS.latest,
+) -> None:
+    LOGGER.info(
+        """\
+Running %r (version %s) with settings:
+ - user_name   = %s
+ - user_email  = %s
+ - major_minor = %s
+ - major       = %s
+ - latest      = %s
+""",
+        tag_commit.__name__,
+        __version__,
+        user_name,
+        user_email,
+        major_minor,
+        major,
+        latest,
+    )
+    _ = log_run("git", "config", "--global", "user.name", user_name)
+    _ = log_run("git", "config", "--global", "user.email", user_email)
+    version = parse_version(log_run("bump-my-version", "show", "current_version"))
+    _tag(str(version))
+    if major_minor:
+        _tag(f"{version.major}.{version.minor}")
+    if major:
+        _tag(str(version.major))
+    if latest:
+        _tag("latest")
+
+
+def _tag(version: str, /) -> None:
+    with suppress(CalledProcessError):
+        _ = log_run("git", "tag", "--delete", version)
+    with suppress(CalledProcessError):
+        _ = log_run("git", "push", "--delete", "origin", version)
+    _ = log_run("git", "tag", "-a", version, "HEAD", "-m", version)
+    _ = log_run("git", "push", "--tags", "--force", "--set-upstream", "origin")
+
+
+__all__ = ["tag_commit"]

actions/tag/settings.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+from typed_settings import load_settings, option, settings
+
+from actions.utilities import ENV_LOADER
+
+
+@settings
+class TagSettings:
+    user_name: str = option(default="github-actions-bot", help="'git' user name")
+    user_email: str = option(default="noreply@github.com", help="'git' user email")
+    major_minor: bool = option(default=False, help="Add the 'major.minor' tag")
+    major: bool = option(default=False, help="Add the 'major' tag")
+    latest: bool = option(default=False, help="Add the 'latest' tag")
+
+
+TAG_SETTINGS = load_settings(TagSettings, [ENV_LOADER])
+
+
+__all__ = ["TAG_SETTINGS", "TagSettings"]

actions/utilities.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from subprocess import check_output
+
+from typed_settings import EnvLoader, Secret
+
+from actions.logging import LOGGER
+
+ENV_LOADER = EnvLoader("")
+
+
+def empty_str_to_none(text: str, /) -> str | None:
+    return None if text == "" else text
+
+
+def log_run(*cmds: str | Secret[str]) -> str:
+    LOGGER.info("Running '%s'...", " ".join(map(str, cmds)))
+    return check_output(
+        [c if isinstance(c, str) else c.get_secret_value() for c in cmds], text=True
+    ).rstrip("\n")
+
+
+__all__ = ["ENV_LOADER", "empty_str_to_none", "log_run"]

dycw_actions-0.2.2.dist-info/METADATA

@@ -0,0 +1,14 @@
+Metadata-Version: 2.3
+Name: dycw-actions
+Version: 0.2.2
+Summary: GitHub actions
+Requires-Dist: click>=8.3.1,<8.4
+Requires-Dist: dycw-utilities>=0.170.0,<0.171
+Requires-Dist: rich>=14.2.0,<14.3
+Requires-Dist: typed-settings[attrs,click]>=25.3.0,<25.4
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# `actions`
+
+GitHub actions

dycw_actions-0.2.2.dist-info/RECORD

@@ -0,0 +1,21 @@
+actions/__init__.py,sha256=p-v1DNzSSlMZQrSYK8zcIuyQfiDyhSSgIRE1gXXYcJ0,58
+actions/cli.py,sha256=S2q5iRqZ-AsB-IF0GxExRBBnguPcKRH_97o-kxg-RLU,536
+actions/logging.py,sha256=rMTcQMGndUHTCaXXtyOHt_VXUMhQGRHoN7okpoX0y5I,120
+actions/publish/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
+actions/publish/cli.py,sha256=QN9I8jdZVeRLG0DuYFigV-3uTrAkBfa9XHkpzfpJgJk,1263
+actions/publish/lib.py,sha256=4efV3RnJNrPPebCHS_a6FzSRM9ifFJtBXZXXc5ORNFw,1651
+actions/publish/settings.py,sha256=LPuU3PMDByuxukaDsEVLnZQVRX9Fzwm11ashvn1Gm8g,1160
+actions/settings.py,sha256=__Lu6E960DTvP05C0C0NCauOazn6SS5-fu6y3ENWz7Y,503
+actions/sleep/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
+actions/sleep/cli.py,sha256=3AGGpovn1pdVYn6TOmB_TOusGnjUDMjstemVTvJ3Ci8,1104
+actions/sleep/lib.py,sha256=uMre9J4A4ZEOfDntxn-PZmi7glaHI_QaXuZmmvpq0go,1660
+actions/sleep/settings.py,sha256=M3nn8r9P5lYWz_I-lBNX_dhpWPvtprC48bW55uSgwIA,564
+actions/tag/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
+actions/tag/cli.py,sha256=txW0XDc71eVrQuyKpfk8rrbK2UWU4LuwbuFk03KQkAY,1154
+actions/tag/lib.py,sha256=BHRedlrgk-JpECcPc7yxj7JnAQIScwecoGTFNWwkzUY,1695
+actions/tag/settings.py,sha256=Lg5rE08dSl9rQ_EuqJ5CoW9D_6pxcxiNZEJwQOfcW5w,654
+actions/utilities.py,sha256=F1p07eXZt0m0Ho92_70u-85E-CBWGYfzhiwFJUzdKwo,572
+dycw_actions-0.2.2.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
+dycw_actions-0.2.2.dist-info/entry_points.txt,sha256=2Uu7wAZOm0mmcsGBEsGB370HAWgVWECRFJ9rKgfC3-I,46
+dycw_actions-0.2.2.dist-info/METADATA,sha256=uqq2NqHNuqX4k69OOd00Gave-paWkRiDhFs0uBDpuBg,343
+dycw_actions-0.2.2.dist-info/RECORD,,

dycw_actions-0.2.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.18
+Root-Is-Purelib: true
+Tag: py3-none-any

dycw_actions-0.2.2.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+action = actions.cli:_main
+