dycw-actions 0.8.5__py3-none-any.whl → 0.11.3__py3-none-any.whl

actions/pre_commit/conformalize_repo/settings.py

@@ -8,14 +8,22 @@ from actions.utilities import LOADER
 
 @settings
 class Settings:
-    ci__ca_certificates: bool = option(
+    ci__certificates: bool = option(
         default=False, help="Update CA certficates before each step"
     )
     ci__gitea: bool = option(default=False, help="Set up CI on Gitea")
-    ci__token: str | None = option(default=None, help="Set up CI with this token")
+    ci__token_checkout: Secret[str] | None = secret(
+        default=None, help="Set up CI with this checkout token"
+    )
+    ci__token_github: Secret[str] | None = secret(
+        default=None, help="Set up CI with this GitHub token"
+    )
     ci__pull_request__pre_commit: bool = option(
         default=False, help="Set up CI 'pull-request.yaml' pre-commit"
     )
+    ci__pull_request__pre_commit__submodules: str | None = option(
+        default=None, help="Set up CI 'pull-request.yaml' pre-commit with submodules"
+    )
     ci__pull_request__pyright: bool = option(
         default=False, help="Set up CI 'pull-request.yaml' pyright"
     )
@@ -28,24 +36,48 @@ class Settings:
     ci__pull_request__pytest__windows: bool = option(
         default=False, help="Set up CI 'pull-request.yaml' pytest with Windows"
     )
-    ci__pull_request__pytest__sops_age_key: str | None = option(
+    ci__pull_request__pytest__all_versions: bool = option(
+        default=False, help="Set up CI 'pull-request.yaml' pytest with all versions"
+    )
+    ci__pull_request__pytest__sops_age_key: Secret[str] | None = secret(
         default=None,
         help="Set up CI 'pull-request.yaml' pytest with this 'age' key for 'sops'",
     )
     ci__pull_request__ruff: bool = option(
         default=False, help="Set up CI 'pull-request.yaml' ruff"
     )
-    ci__push__publish: bool = option(
-        default=False, help="Set up CI 'push.yaml' publishing"
+    ci__push__publish__github: bool = option(
+        default=False, help="Set up CI 'push.yaml' publishing to GitHub"
+    )
+    ci__push__publish__primary: bool = option(
+        default=False, help="Set up CI 'push.yaml' publishing #1"
+    )
+    ci__push__publish__primary__job_name: str = option(
+        default="pypi", help="Set up CI 'push.yaml' publishing #1 with this job name"
+    )
+    ci__push__publish__primary__username: str | None = option(
+        default=None, help="Set up CI 'push.yaml' publishing #1 with this username"
+    )
+    ci__push__publish__primary__password: Secret[str] | None = secret(
+        default=None, help="Set up CI 'push.yaml' publishing #1 with this password"
+    )
+    ci__push__publish__primary__publish_url: str | None = option(
+        default=None, help="Set up CI 'push.yaml' publishing #1 with this URL"
+    )
+    ci__push__publish__secondary: bool = option(
+        default=False, help="Set up CI 'push.yaml' publishing #2"
+    )
+    ci__push__publish__secondary__job_name: str = option(
+        default="pypi2", help="Set up CI 'push.yaml' publishing #2 with this job name"
     )
-    ci__push__publish__username: str | None = option(
-        default=None, help="Set up CI 'push.yaml' publishing with this username"
+    ci__push__publish__secondary__username: str | None = option(
+        default=None, help="Set up CI 'push.yaml' publishing #2 with this username"
     )
-    ci__push__publish__password: Secret[str] | None = secret(
-        default=None, help="Set up CI 'push.yaml' publishing with this password"
+    ci__push__publish__secondary__password: Secret[str] | None = secret(
+        default=None, help="Set up CI 'push.yaml' publishing #2 with this password"
     )
-    ci__push__publish__publish_url: Secret[str] | None = secret(
-        default=None, help="Set up CI 'push.yaml' publishing with this URL"
+    ci__push__publish__secondary__publish_url: str | None = option(
+        default=None, help="Set up CI 'push.yaml' publishing #2 with this URL"
     )
     ci__push__tag: bool = option(default=False, help="Set up CI 'push.yaml' tagging")
     ci__push__tag__all: bool = option(

actions/pre_commit/constants.py

@@ -1,8 +1,11 @@
 from __future__ import annotations
 
+from utilities.whenever import HOUR
+
 from actions.constants import PATH_ACTIONS
 
 PATH_PRE_COMMIT = PATH_ACTIONS / "pre_commit"
+THROTTLE_DELTA = 12 * HOUR
 
 
-__all__ = ["PATH_PRE_COMMIT"]
+__all__ = ["PATH_PRE_COMMIT", "THROTTLE_DELTA"]

actions/pre_commit/format_requirements/lib.py

@@ -3,7 +3,9 @@ from __future__ import annotations
 import sys
 from typing import TYPE_CHECKING
 
-from utilities.text import repr_str, strip_and_dedent
+from utilities.functions import get_func_name
+from utilities.tabulate import func_param_desc
+from utilities.text import repr_str
 
 from actions import __version__
 from actions.logging import LOGGER
@@ -18,15 +20,7 @@ if TYPE_CHECKING:
 
 
 def format_requirements(*paths: PathLike) -> None:
-    LOGGER.info(
-        strip_and_dedent("""
-            Running '%s' (version %s) with settings:
-             - paths = %s
-        """),
-        format_requirements.__name__,
-        __version__,
-        paths,
-    )
+    LOGGER.info(func_param_desc(format_requirements, __version__, f"{paths=}"))
     modifications: set[Path] = set()
     for path in paths:
         _format_path(path, modifications=modifications)
@@ -36,6 +30,7 @@ def format_requirements(*paths: PathLike) -> None:
             ", ".join(map(repr_str, sorted(modifications))),
         )
         sys.exit(1)
+    LOGGER.info("Finished running %r", get_func_name(format_requirements))
 
 
 def _format_path(

actions/pre_commit/replace_sequence_strs/lib.py

@@ -10,7 +10,9 @@ from libcst.matchers import Subscript as MSubscript
 from libcst.matchers import SubscriptElement as MSubscriptElement
 from libcst.matchers import matches
 from libcst.metadata import MetadataWrapper
-from utilities.text import repr_str, strip_and_dedent
+from utilities.functions import get_func_name
+from utilities.tabulate import func_param_desc
+from utilities.text import repr_str
 
 from actions import __version__
 from actions.logging import LOGGER
@@ -24,15 +26,7 @@ if TYPE_CHECKING:
 
 
 def replace_sequence_strs(*paths: PathLike) -> None:
-    LOGGER.info(
-        strip_and_dedent("""
-            Running '%s' (version %s) with settings:
-             - paths = %s
-        """),
-        replace_sequence_strs.__name__,
-        __version__,
-        paths,
-    )
+    LOGGER.info(func_param_desc(replace_sequence_strs, __version__, f"{paths=}"))
     modifications: set[Path] = set()
     for path in paths:
         _format_path(path, modifications=modifications)
@@ -42,6 +36,7 @@ def replace_sequence_strs(*paths: PathLike) -> None:
             ", ".join(map(repr_str, sorted(modifications))),
         )
         sys.exit(1)
+    LOGGER.info("Finished running %r", get_func_name(replace_sequence_strs))
 
 
 def _format_path(

actions/pre_commit/touch_empty_py/lib.py

@@ -4,14 +4,15 @@ import sys
 from typing import TYPE_CHECKING
 
 from libcst import parse_statement
-from utilities.text import repr_str, strip_and_dedent
+from utilities.functions import get_func_name
+from utilities.tabulate import func_param_desc
+from utilities.text import repr_str
 from utilities.throttle import throttle
-from utilities.whenever import HOUR
 
 from actions import __version__
-from actions.constants import PATH_THROTTLE_CACHE
 from actions.logging import LOGGER
-from actions.pre_commit.utilities import yield_python_file
+from actions.pre_commit.constants import THROTTLE_DELTA
+from actions.pre_commit.utilities import path_throttle_cache, yield_python_file
 
 if TYPE_CHECKING:
     from collections.abc import MutableSet
@@ -21,15 +22,7 @@ if TYPE_CHECKING:
 
 
 def _touch_empty_py(*paths: PathLike) -> None:
-    LOGGER.info(
-        strip_and_dedent("""
-            Running '%s' (version %s) with settings:
-             - paths = %s
-        """),
-        touch_empty_py.__name__,
-        __version__,
-        paths,
-    )
+    LOGGER.info(func_param_desc(touch_empty_py, __version__, f"{paths=}"))
     modifications: set[Path] = set()
     for path in paths:
         _format_path(path, modifications=modifications)
@@ -39,10 +32,11 @@ def _touch_empty_py(*paths: PathLike) -> None:
             ", ".join(map(repr_str, sorted(modifications))),
         )
         sys.exit(1)
+    LOGGER.info("Finished running %r", get_func_name(touch_empty_py))
 
 
 touch_empty_py = throttle(
-    delta=12 * HOUR, path=PATH_THROTTLE_CACHE / _touch_empty_py.__name__
+    delta=THROTTLE_DELTA, path=path_throttle_cache(_touch_empty_py)
 )(_touch_empty_py)
 
 

actions/pre_commit/touch_py_typed/lib.py

@@ -4,14 +4,16 @@ import sys
 from pathlib import Path
 from typing import TYPE_CHECKING
 
+from utilities.functions import get_func_name
 from utilities.iterables import one
-from utilities.text import repr_str, strip_and_dedent
+from utilities.tabulate import func_param_desc
+from utilities.text import repr_str
 from utilities.throttle import throttle
-from utilities.whenever import HOUR
 
 from actions import __version__
-from actions.constants import PATH_THROTTLE_CACHE
 from actions.logging import LOGGER
+from actions.pre_commit.constants import THROTTLE_DELTA
+from actions.pre_commit.utilities import path_throttle_cache
 
 if TYPE_CHECKING:
     from collections.abc import MutableSet
@@ -20,15 +22,7 @@ if TYPE_CHECKING:
 
 
 def _touch_py_typed(*paths: PathLike) -> None:
-    LOGGER.info(
-        strip_and_dedent("""
-            Running '%s' (version %s) with settings:
-             - paths = %s
-        """),
-        touch_py_typed.__name__,
-        __version__,
-        paths,
-    )
+    LOGGER.info(func_param_desc(touch_py_typed, __version__, f"{paths=}"))
     modifications: set[Path] = set()
     for path in paths:
         _format_path(path, modifications=modifications)
@@ -38,10 +32,11 @@ def _touch_py_typed(*paths: PathLike) -> None:
             ", ".join(map(repr_str, sorted(modifications))),
         )
         sys.exit(1)
+    LOGGER.info("Finished running %r", get_func_name(touch_py_typed))
 
 
 touch_py_typed = throttle(
-    delta=12 * HOUR, path=PATH_THROTTLE_CACHE / _touch_py_typed.__name__
+    delta=THROTTLE_DELTA, path=path_throttle_cache(_touch_py_typed)
 )(_touch_py_typed)
 
 

actions/pre_commit/update_requirements/lib.py

@@ -5,8 +5,9 @@ from functools import partial
 from typing import TYPE_CHECKING
 
 from pydantic import TypeAdapter
-from utilities.functions import max_nullable
-from utilities.text import repr_str, strip_and_dedent
+from utilities.functions import get_func_name, max_nullable
+from utilities.tabulate import func_param_desc
+from utilities.text import repr_str
 
 from actions import __version__
 from actions.logging import LOGGER
@@ -33,15 +34,7 @@ if TYPE_CHECKING:
 
 
 def update_requirements(*paths: PathLike) -> None:
-    LOGGER.info(
-        strip_and_dedent("""
-            Running '%s' (version %s) with settings:
-             - paths = %s
-        """),
-        update_requirements.__name__,
-        __version__,
-        paths,
-    )
+    LOGGER.info(func_param_desc(update_requirements, __version__, f"{paths=}"))
     modifications: set[Path] = set()
     for path in paths:
         _format_path(path, modifications=modifications)
@@ -51,6 +44,7 @@ def update_requirements(*paths: PathLike) -> None:
             ", ".join(map(repr_str, sorted(modifications))),
         )
         sys.exit(1)
+    LOGGER.info("Finished running %r", get_func_name(update_requirements))
 
 
 def _format_path(

actions/pre_commit/utilities.py

@@ -12,12 +12,12 @@ from libcst import Module, parse_module
 from rich.pretty import pretty_repr
 from tomlkit import TOMLDocument, aot, array, document, string, table
 from tomlkit.items import AoT, Array, Table
-from utilities.functions import ensure_class, ensure_str
+from utilities.functions import ensure_class, ensure_str, get_func_name
 from utilities.iterables import OneEmptyError, OneNonUniqueError, one
 from utilities.packaging import Requirement
 from utilities.types import PathLike, StrDict
 
-from actions.constants import YAML_INSTANCE
+from actions.constants import PATH_CACHE, YAML_INSTANCE
 from actions.logging import LOGGER
 from actions.utilities import are_equal_modulo_new_line, write_text, yaml_dump
 
@@ -222,76 +222,10 @@ class PyProjectDependencies:
 ##
 
 
-@contextmanager
-def yield_json_dict(
-    path: PathLike, /, *, modifications: MutableSet[Path] | None = None
-) -> Iterator[StrDict]:
-    with yield_mutable_write_context(
-        path, json.loads, dict, json.dumps, modifications=modifications
-    ) as dict_:
-        yield dict_
-
-
-##
-
-
-@contextmanager
-def yield_python_file(
-    path: PathLike, /, *, modifications: MutableSet[Path] | None = None
-) -> Iterator[WriteContext[Module]]:
-    with yield_immutable_write_context(
-        path,
-        parse_module,
-        lambda: Module(body=[]),
-        lambda module: module.code,
-        modifications=modifications,
-    ) as context:
-        yield context
-
-
-##
-
-
-@contextmanager
-def yield_text_file(
-    path: PathLike, /, *, modifications: MutableSet[Path] | None = None
-) -> Iterator[WriteContext[str]]:
-    with yield_immutable_write_context(
-        path, str, lambda: "", str, modifications=modifications
-    ) as context:
-        yield context
-
-
-##
-
-
-@contextmanager
-def yield_toml_doc(
-    path: PathLike, /, *, modifications: MutableSet[Path] | None = None
-) -> Iterator[TOMLDocument]:
-    with yield_mutable_write_context(
-        path, tomlkit.parse, document, tomlkit.dumps, modifications=modifications
-    ) as doc:
-        yield doc
-
-
-##
-
-
-@contextmanager
-def yield_mutable_write_context[T](
-    path: PathLike,
-    loads: Callable[[str], T],
-    get_default: Callable[[], T],
-    dumps: Callable[[T], str],
-    /,
-    *,
-    modifications: MutableSet[Path] | None = None,
-) -> Iterator[T]:
-    with yield_immutable_write_context(
-        path, loads, get_default, dumps, modifications=modifications
-    ) as context:
-        yield context.output
+def path_throttle_cache(func: Callable[..., Any]) -> Path:
+    func_name = get_func_name(func)
+    cwd_name = Path.cwd().name
+    return PATH_CACHE / "throttle" / f"{func_name}--{cwd_name}"
 
 
 ##
@@ -348,6 +282,81 @@ def yield_immutable_write_context[T](
 ##
 
 
+@contextmanager
+def yield_json_dict(
+    path: PathLike, /, *, modifications: MutableSet[Path] | None = None
+) -> Iterator[StrDict]:
+    with yield_mutable_write_context(
+        path, json.loads, dict, json.dumps, modifications=modifications
+    ) as dict_:
+        yield dict_
+
+
+##
+
+
+@contextmanager
+def yield_mutable_write_context[T](
+    path: PathLike,
+    loads: Callable[[str], T],
+    get_default: Callable[[], T],
+    dumps: Callable[[T], str],
+    /,
+    *,
+    modifications: MutableSet[Path] | None = None,
+) -> Iterator[T]:
+    with yield_immutable_write_context(
+        path, loads, get_default, dumps, modifications=modifications
+    ) as context:
+        yield context.output
+
+
+##
+
+
+@contextmanager
+def yield_python_file(
+    path: PathLike, /, *, modifications: MutableSet[Path] | None = None
+) -> Iterator[WriteContext[Module]]:
+    with yield_immutable_write_context(
+        path,
+        parse_module,
+        lambda: Module(body=[]),
+        lambda module: module.code,
+        modifications=modifications,
+    ) as context:
+        yield context
+
+
+##
+
+
+@contextmanager
+def yield_text_file(
+    path: PathLike, /, *, modifications: MutableSet[Path] | None = None
+) -> Iterator[WriteContext[str]]:
+    with yield_immutable_write_context(
+        path, str, lambda: "", str, modifications=modifications
+    ) as context:
+        yield context
+
+
+##
+
+
+@contextmanager
+def yield_toml_doc(
+    path: PathLike, /, *, modifications: MutableSet[Path] | None = None
+) -> Iterator[TOMLDocument]:
+    with yield_mutable_write_context(
+        path, tomlkit.parse, document, tomlkit.dumps, modifications=modifications
+    ) as doc:
+        yield doc
+
+
+##
+
+
 @contextmanager
 def yield_yaml_dict(
     path: PathLike, /, *, modifications: MutableSet[Path] | None = None
@@ -360,6 +369,7 @@ def yield_yaml_dict(
 
 __all__ = [
     "PyProjectDependencies",
+    "WriteContext",
     "ensure_aot_contains",
     "ensure_contains",
     "ensure_contains_partial_dict",
@@ -375,6 +385,7 @@ __all__ = [
     "get_table",
     "is_partial_dict",
     "is_partial_str",
+    "path_throttle_cache",
     "yield_immutable_write_context",
     "yield_json_dict",
     "yield_mutable_write_context",

actions/publish_package/lib.py

@@ -2,8 +2,9 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+from utilities.functions import get_func_name
+from utilities.tabulate import func_param_desc
 from utilities.tempfile import TemporaryDirectory
-from utilities.text import strip_and_dedent
 
 from actions import __version__
 from actions.logging import LOGGER
@@ -23,21 +24,15 @@ def publish_package(
     native_tls: bool = SETTINGS.native_tls,
 ) -> None:
     LOGGER.info(
-        strip_and_dedent("""
-            Running '%s' (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,
+        func_param_desc(
+            publish_package,
+            __version__,
+            f"{username=}",
+            f"{password=}",
+            f"{publish_url=}",
+            f"{trusted_publishing=}",
+            f"{native_tls=}",
+        )
     )
     with TemporaryDirectory() as temp:
         logged_run("uv", "build", "--out-dir", str(temp), "--wheel", "--clear")
@@ -51,6 +46,7 @@ def publish_package(
             *(["--native-tls"] if native_tls else []),
             f"{temp}/*",
         )
+    LOGGER.info("Finished running %r", get_func_name(publish_package))
 
 
 __all__ = ["publish_package"]

actions/random_sleep/cli.py

@@ -16,8 +16,8 @@ def random_sleep_sub_cmd(settings: Settings, /) -> None:
         return
     basic_config(obj=LOGGER)
     random_sleep(
-        min_=settings.min,
-        max_=settings.max,
+        min=settings.min,
+        max=settings.max,
         step=settings.step,
         log_freq=settings.log_freq,
     )

actions/random_sleep/lib.py

@@ -4,7 +4,8 @@ from math import ceil, floor
 from random import choice
 from time import sleep
 
-from utilities.text import strip_and_dedent
+from utilities.functions import get_func_name
+from utilities.tabulate import func_param_desc
 from utilities.whenever import get_now
 from whenever import TimeDelta, ZonedDateTime
 
@@ -15,33 +16,23 @@ from actions.random_sleep.settings import SETTINGS
 
 def random_sleep(
     *,
-    min_: int = SETTINGS.min,
-    max_: int = SETTINGS.max,
+    min: int = SETTINGS.min,  # noqa: A002
+    max: int = SETTINGS.max,  # noqa: A002
     step: int = SETTINGS.step,
     log_freq: int = SETTINGS.log_freq,
 ) -> None:
     LOGGER.info(
-        strip_and_dedent("""
-            Running '%s' (version %s) with settings:
-             - min_     = %s
-             - max_     = %s
-             - step     = %s
-             - log_freq = %s
-        """),
-        random_sleep.__name__,
-        __version__,
-        min_,
-        max_,
-        step,
-        log_freq,
+        func_param_desc(
+            random_sleep, __version__, f"{min=}", f"{max=}", f"{step=}", f"{log_freq=}"
+        )
     )
     start = get_now()
-    delta = TimeDelta(seconds=choice(range(min_, max_, step)))
+    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)
+    LOGGER.info("Finished running %r", get_func_name(random_sleep))
 
 
 def _intermediate(

actions/register_gitea_runner/configs/entrypoint.sh

@@ -6,16 +6,16 @@ echo_date() { echo "[$(date +'%Y-%m-%d %H:%M:%S')] $*" >&2; }
 
 # main
 wait-for-it.sh \
-    --host="${GITEA_HOST}" \
-    --port="${GITEA_PORT}" \
-    --strict \
-    -- \
-    echo "${GITEA_HOST}:${GITEA_PORT} is up"
+	--host="${GITEA_HOST}" \
+	--port="${GITEA_PORT}" \
+	--strict \
+	-- \
+	echo "${GITEA_HOST}:${GITEA_PORT} is up"
 
 if ! command -v update-ca-certificates >/dev/null 2>&1; then
-    echo_date "Installing 'ca-certificates'..."
-    apk update
-    apk add --no-cache ca-certificates
+	echo_date "Installing 'ca-certificates'..."
+	apk update
+	apk add --no-cache ca-certificates
 fi
 
 update-ca-certificates || true