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

actions/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.11.3"
+__version__ = "0.15.3"

actions/cli.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from click import group
 from utilities.click import CONTEXT_SETTINGS
 
+from actions import __version__
 from actions.clean_dir.cli import clean_dir_sub_cmd
 from actions.clean_dir.constants import CLEAN_DIR_DOCSTRING, CLEAN_DIR_SUB_CMD
 from actions.git_clone_with.cli import git_clone_with_sub_cmd
@@ -47,6 +48,8 @@ from actions.publish_package.constants import (
 )
 from actions.random_sleep.cli import random_sleep_sub_cmd
 from actions.random_sleep.constants import RANDOM_SLEEP_DOCSTRING, RANDOM_SLEEP_SUB_CMD
+from actions.re_encrypt.cli import re_encrypt_sub_cmd
+from actions.re_encrypt.constants import RE_ENCRYPT_DOCSTRING, RE_ENCRYPT_SUB_CMD
 from actions.register_gitea_runner.cli import register_gitea_runner_sub_cmd
 from actions.register_gitea_runner.constants import (
     REGISTER_GITEA_RUNNER_DOCSTRING,
@@ -68,7 +71,7 @@ from actions.tag_commit.cli import tag_commit_sub_cmd
 from actions.tag_commit.constants import TAG_COMMIT_DOCSTRING, TAG_COMMIT_SUB_CMD
 
 
-@group(**CONTEXT_SETTINGS)
+@group(help=f"'actions' {__version__}", **CONTEXT_SETTINGS)
 def _main() -> None: ...
 
 
@@ -87,6 +90,9 @@ _ = _main.command(name=RUN_HOOKS_SUB_CMD, help=RUN_HOOKS_DOCSTRING, **CONTEXT_SE
 _ = _main.command(
     name=RANDOM_SLEEP_SUB_CMD, help=RANDOM_SLEEP_DOCSTRING, **CONTEXT_SETTINGS
 )(random_sleep_sub_cmd)
+_ = _main.command(
+    name=RE_ENCRYPT_SUB_CMD, help=RE_ENCRYPT_DOCSTRING, **CONTEXT_SETTINGS
+)(re_encrypt_sub_cmd)
 _ = _main.command(
     name=REGISTER_GITEA_RUNNER_SUB_CMD,
     help=REGISTER_GITEA_RUNNER_DOCSTRING,

actions/pre_commit/conformalize_repo/cli.py

@@ -57,7 +57,6 @@ def conformalize_repo_sub_cmd(settings: Settings, /) -> None:
         pre_commit__uv=settings.pre_commit__uv,
         pyproject=settings.pyproject,
         pyproject__project__optional_dependencies__scripts=settings.pyproject__project__optional_dependencies__scripts,
-        pyproject__tool__uv__indexes=settings.pyproject__tool__uv__indexes,
         pyright=settings.pyright,
         pytest=settings.pytest,
         pytest__asyncio=settings.pytest__asyncio,
@@ -70,6 +69,7 @@ def conformalize_repo_sub_cmd(settings: Settings, /) -> None:
         ruff=settings.ruff,
         run_version_bump=settings.run_version_bump,
         script=settings.script,
+        uv__indexes=settings.uv__indexes,
         uv__native_tls=settings.uv__native_tls,
     )
 

actions/pre_commit/conformalize_repo/constants.py

@@ -3,8 +3,8 @@ from __future__ import annotations
 from pathlib import Path
 from re import search
 
+from utilities.constants import IS_CI
 from utilities.pathlib import GetRootError, get_root
-from utilities.pytest import IS_CI
 
 from actions.pre_commit.constants import PATH_PRE_COMMIT
 

actions/pre_commit/conformalize_repo/lib.py

@@ -31,6 +31,7 @@ from actions.constants import (
     ENVRC,
     GITEA_PULL_REQUEST_YAML,
     GITEA_PUSH_YAML,
+    GITHUB,
     GITHUB_PULL_REQUEST_YAML,
     GITHUB_PUSH_YAML,
     GITIGNORE,
@@ -65,7 +66,7 @@ from actions.pre_commit.conformalize_repo.constants import (
     UV_URL,
 )
 from actions.pre_commit.conformalize_repo.settings import SETTINGS
-from actions.pre_commit.constants import THROTTLE_DELTA
+from actions.pre_commit.constants import THROTTLE_DURATION
 from actions.pre_commit.format_requirements.constants import FORMAT_REQUIREMENTS_SUB_CMD
 from actions.pre_commit.replace_sequence_strs.constants import (
     REPLACE_SEQUENCE_STRS_SUB_CMD,
@@ -74,18 +75,19 @@ from actions.pre_commit.touch_empty_py.constants import TOUCH_EMPTY_PY_SUB_CMD
 from actions.pre_commit.touch_py_typed.constants import TOUCH_PY_TYPED_SUB_CMD
 from actions.pre_commit.update_requirements.constants import UPDATE_REQUIREMENTS_SUB_CMD
 from actions.pre_commit.utilities import (
-    ensure_aot_contains,
     ensure_contains,
     ensure_contains_partial_dict,
     ensure_contains_partial_str,
     ensure_not_contains,
-    get_aot,
-    get_array,
-    get_dict,
-    get_list,
-    get_table,
+    get_set_aot,
+    get_set_array,
+    get_set_dict,
+    get_set_list_dicts,
+    get_set_list_strs,
+    get_set_table,
     path_throttle_cache,
     yield_json_dict,
+    yield_pyproject_toml,
     yield_text_file,
     yield_toml_doc,
     yield_yaml_dict,
@@ -151,9 +153,6 @@ def conformalize_repo(
     pre_commit__uv: bool = SETTINGS.pre_commit__uv,
     pyproject: bool = SETTINGS.pyproject,
     pyproject__project__optional_dependencies__scripts: bool = SETTINGS.pyproject__project__optional_dependencies__scripts,
-    pyproject__tool__uv__indexes: list[
-        tuple[str, str]
-    ] = SETTINGS.pyproject__tool__uv__indexes,
     pyright: bool = SETTINGS.pyright,
     pytest: bool = SETTINGS.pytest,
     pytest__asyncio: bool = SETTINGS.pytest__asyncio,
@@ -166,6 +165,7 @@ def conformalize_repo(
     ruff: bool = SETTINGS.ruff,
     run_version_bump: bool = SETTINGS.run_version_bump,
     script: str | None = SETTINGS.script,
+    uv__indexes: list[tuple[str, str]] = SETTINGS.uv__indexes,
     uv__native_tls: bool = SETTINGS.uv__native_tls,
 ) -> None:
     LOGGER.info(
@@ -213,7 +213,6 @@ def conformalize_repo(
             f"{pre_commit__uv=}",
             f"{pyproject=}",
             f"{pyproject__project__optional_dependencies__scripts=}",
-            f"{pyproject__tool__uv__indexes=}",
             f"{pyright=}",
             f"{pytest=}",
             f"{pytest__asyncio=}",
@@ -226,6 +225,7 @@ def conformalize_repo(
             f"{ruff=}",
             f"{run_version_bump=}",
             f"{script=}",
+            f"{uv__indexes=}",
             f"{uv__native_tls=}",
         )
     )
@@ -251,16 +251,15 @@ def conformalize_repo(
         taplo=pre_commit__taplo,
         uv=pre_commit__uv,
         script=script,
+        uv__indexes=uv__indexes,
+        uv__native_tls=uv__native_tls,
     )
     if (
         ci__pull_request__pre_commit
-        or ci__pull_request__pre_commit__submodules
         or ci__pull_request__pyright
         or ci__pull_request__pytest__macos
         or ci__pull_request__pytest__ubuntu
         or ci__pull_request__pytest__windows
-        or ci__pull_request__pytest__all_versions
-        or (ci__pull_request__pytest__sops_age_key is not None)
         or ci__pull_request__ruff
     ):
         add_ci_pull_request_yaml(
@@ -330,11 +329,7 @@ def conformalize_repo(
         )
     if gitignore:
         add_gitignore(modifications=modifications)
-    if (
-        pyproject
-        or pyproject__project__optional_dependencies__scripts
-        or (len(pyproject__tool__uv__indexes) >= 1)
-    ):
+    if pyproject:
         add_pyproject_toml(
             modifications=modifications,
             python_version=python_version,
@@ -343,7 +338,7 @@ def conformalize_repo(
             readme=readme,
             optional_dependencies__scripts=pyproject__project__optional_dependencies__scripts,
             python_package_name=python_package_name,
-            tool__uv__indexes=pyproject__tool__uv__indexes,
+            uv__indexes=uv__indexes,
         )
     if pyright:
         add_pyrightconfig_json(
@@ -394,11 +389,11 @@ def add_bumpversion_toml(
     python_package_name: str | None = SETTINGS.python_package_name,
 ) -> None:
     with yield_bumpversion_toml(modifications=modifications) as doc:
-        tool = get_table(doc, "tool")
-        bumpversion = get_table(tool, "bumpversion")
+        tool = get_set_table(doc, "tool")
+        bumpversion = get_set_table(tool, "bumpversion")
         if pyproject:
-            files = get_aot(bumpversion, "files")
-            ensure_aot_contains(
+            files = get_set_aot(bumpversion, "files")
+            ensure_contains(
                 files,
                 _add_bumpversion_toml_file(PYPROJECT_TOML, 'version = "${version}"'),
             )
@@ -407,8 +402,8 @@ def add_bumpversion_toml(
             package_name=package_name, python_package_name=python_package_name
         )
     ) is not None:
-        files = get_aot(bumpversion, "files")
-        ensure_aot_contains(
+        files = get_set_aot(bumpversion, "files")
+        ensure_contains(
             files,
             _add_bumpversion_toml_file(
                 f"src/{python_package_name_use}/__init__.py",
@@ -455,17 +450,17 @@ def add_ci_pull_request_yaml(
     path = GITEA_PULL_REQUEST_YAML if gitea else GITHUB_PULL_REQUEST_YAML
     with yield_yaml_dict(path, modifications=modifications) as dict_:
         dict_["name"] = "pull-request"
-        on = get_dict(dict_, "on")
-        pull_request = get_dict(on, "pull_request")
-        branches = get_list(pull_request, "branches")
+        on = get_set_dict(dict_, "on")
+        pull_request = get_set_dict(on, "pull_request")
+        branches = get_set_list_strs(pull_request, "branches")
         ensure_contains(branches, "master")
-        schedule = get_list(on, "schedule")
+        schedule = get_set_list_dicts(on, "schedule")
         ensure_contains(schedule, {"cron": get_cron_job(repo_name=repo_name)})
-        jobs = get_dict(dict_, "jobs")
+        jobs = get_set_dict(dict_, "jobs")
         if pre_commit:
-            pre_commit_dict = get_dict(jobs, "pre-commit")
+            pre_commit_dict = get_set_dict(jobs, "pre-commit")
             pre_commit_dict["runs-on"] = "ubuntu-latest"
-            steps = get_list(pre_commit_dict, "steps")
+            steps = get_set_list_dicts(pre_commit_dict, "steps")
             if certificates:
                 ensure_contains(steps, update_ca_certificates_dict("pre-commit"))
             ensure_contains(
@@ -479,9 +474,9 @@ def add_ci_pull_request_yaml(
                 ),
             )
         if pyright:
-            pyright_dict = get_dict(jobs, "pyright")
+            pyright_dict = get_set_dict(jobs, "pyright")
             pyright_dict["runs-on"] = "ubuntu-latest"
-            steps = get_list(pyright_dict, "steps")
+            steps = get_set_list_dicts(pyright_dict, "steps")
             if certificates:
                 ensure_contains(steps, update_ca_certificates_dict("pyright"))
             ensure_contains(
@@ -495,14 +490,14 @@ def add_ci_pull_request_yaml(
                 ),
             )
         if pytest__macos or pytest__ubuntu or pytest__windows:
-            pytest_dict = get_dict(jobs, "pytest")
-            env = get_dict(pytest_dict, "env")
+            pytest_dict = get_set_dict(jobs, "pytest")
+            env = get_set_dict(pytest_dict, "env")
             env["CI"] = "1"
             pytest_dict["name"] = (
                 "pytest (${{matrix.os}}, ${{matrix.python-version}}, ${{matrix.resolution}})"
             )
             pytest_dict["runs-on"] = "${{matrix.os}}"
-            steps = get_list(pytest_dict, "steps")
+            steps = get_set_list_dicts(pytest_dict, "steps")
             if certificates:
                 ensure_contains(steps, update_ca_certificates_dict("pytest"))
             ensure_contains(
@@ -517,31 +512,31 @@ def add_ci_pull_request_yaml(
                     with_requirements=script,
                 ),
             )
-            strategy_dict = get_dict(pytest_dict, "strategy")
+            strategy_dict = get_set_dict(pytest_dict, "strategy")
             strategy_dict["fail-fast"] = False
-            matrix = get_dict(strategy_dict, "matrix")
-            os = get_list(matrix, "os")
+            matrix = get_set_dict(strategy_dict, "matrix")
+            os = get_set_list_strs(matrix, "os")
             if pytest__macos:
                 ensure_contains(os, "macos-latest")
             if pytest__ubuntu:
                 ensure_contains(os, "ubuntu-latest")
             if pytest__windows:
                 ensure_contains(os, "windows-latest")
-            python_version_dict = get_list(matrix, "python-version")
+            python_version_dict = get_set_list_strs(matrix, "python-version")
             if pytest__all_versions:
                 ensure_contains(
                     python_version_dict, *yield_python_versions(python_version)
                 )
             else:
                 ensure_contains(python_version_dict, python_version)
-            resolution = get_list(matrix, "resolution")
+            resolution = get_set_list_strs(matrix, "resolution")
             ensure_contains(resolution, "highest", "lowest-direct")
             if pytest__timeout is not None:
                 pytest_dict["timeout-minutes"] = max(round(pytest__timeout / 60), 1)
         if ruff:
-            ruff_dict = get_dict(jobs, "ruff")
+            ruff_dict = get_set_dict(jobs, "ruff")
             ruff_dict["runs-on"] = "ubuntu-latest"
-            steps = get_list(ruff_dict, "steps")
+            steps = get_set_list_dicts(ruff_dict, "steps")
             if certificates:
                 ensure_contains(steps, update_ca_certificates_dict("steps"))
             ensure_contains(
@@ -586,11 +581,11 @@ def add_ci_push_yaml(
     path = GITEA_PUSH_YAML if gitea else GITHUB_PUSH_YAML
     with yield_yaml_dict(path, modifications=modifications) as dict_:
         dict_["name"] = "push"
-        on = get_dict(dict_, "on")
-        push = get_dict(on, "push")
-        branches = get_list(push, "branches")
+        on = get_set_dict(dict_, "on")
+        push = get_set_dict(on, "push")
+        branches = get_set_list_strs(push, "branches")
         ensure_contains(branches, "master")
-        jobs = get_dict(dict_, "jobs")
+        jobs = get_set_dict(dict_, "jobs")
         if publish__github:
             _add_ci_push_yaml_publish_dict(
                 jobs,
@@ -624,9 +619,9 @@ def add_ci_push_yaml(
                 uv__native_tls=uv__native_tls,
             )
         if tag:
-            tag_dict = get_dict(jobs, "tag")
+            tag_dict = get_set_dict(jobs, "tag")
             tag_dict["runs-on"] = "ubuntu-latest"
-            steps = get_list(tag_dict, "steps")
+            steps = get_set_list_dicts(tag_dict, "steps")
             if certificates:
                 ensure_contains(steps, update_ca_certificates_dict("tag"))
             ensure_contains(
@@ -652,14 +647,14 @@ def _add_ci_push_yaml_publish_dict(
     uv__native_tls: bool = SETTINGS.uv__native_tls,
 ) -> None:
     publish_name = f"publish-{name}"
-    publish_dict = get_dict(jobs, publish_name)
+    publish_dict = get_set_dict(jobs, publish_name)
     if github:
-        environment = get_dict(publish_dict, "environment")
+        environment = get_set_dict(publish_dict, "environment")
         environment["name"] = "pypi"
-        permissions = get_dict(publish_dict, "permissions")
+        permissions = get_set_dict(publish_dict, "permissions")
         permissions["id-token"] = "write"
     publish_dict["runs-on"] = "ubuntu-latest"
-    steps = get_list(publish_dict, "steps")
+    steps = get_set_list_dicts(publish_dict, "steps")
     if certificates:
         ensure_contains(steps, update_ca_certificates_dict(publish_name))
     ensure_contains(
@@ -680,15 +675,15 @@ def _add_ci_push_yaml_publish_dict(
 
 def add_coveragerc_toml(*, modifications: MutableSet[Path] | None = None) -> None:
     with yield_toml_doc(COVERAGERC_TOML, modifications=modifications) as doc:
-        html = get_table(doc, "html")
+        html = get_set_table(doc, "html")
         html["directory"] = ".coverage/html"
-        report = get_table(doc, "report")
-        exclude_also = get_array(report, "exclude_also")
+        report = get_set_table(doc, "report")
+        exclude_also = get_set_array(report, "exclude_also")
         ensure_contains(exclude_also, "@overload", "if TYPE_CHECKING:")
         report["fail_under"] = 100.0
         report["skip_covered"] = True
         report["skip_empty"] = True
-        run = get_table(doc, "run")
+        run = get_set_table(doc, "run")
         run["branch"] = True
         run["data_file"] = ".coverage/data"
         run["parallel"] = True
@@ -746,6 +741,7 @@ def _add_envrc_uv_text(
         strip_and_dedent(f"""
             export UV_PRERELEASE='disallow'
             export UV_PYTHON='{python_version}'
+            export UV_RESOLUTION='highest'
             export UV_VENV_CLEAR=1
             if ! command -v uv >/dev/null 2>&1; then
             \techo_date "ERROR: 'uv' not found" && exit 1
@@ -792,6 +788,8 @@ def add_pre_commit_config_yaml(
     taplo: bool = SETTINGS.pre_commit__taplo,
     uv: bool = SETTINGS.pre_commit__uv,
     script: str | None = SETTINGS.script,
+    uv__indexes: list[tuple[str, str]] = SETTINGS.uv__indexes,
+    uv__native_tls: bool = SETTINGS.uv__native_tls,
 ) -> None:
     with yield_yaml_dict(PRE_COMMIT_CONFIG_YAML, modifications=modifications) as dict_:
         _add_pre_commit_config_repo(dict_, ACTIONS_URL, CONFORMALIZE_REPO_SUB_CMD)
@@ -839,7 +837,17 @@ def add_pre_commit_config_yaml(
             )
             _add_pre_commit_config_repo(dict_, ACTIONS_URL, TOUCH_EMPTY_PY_SUB_CMD)
             _add_pre_commit_config_repo(dict_, ACTIONS_URL, TOUCH_PY_TYPED_SUB_CMD)
-            _add_pre_commit_config_repo(dict_, ACTIONS_URL, UPDATE_REQUIREMENTS_SUB_CMD)
+            args: list[str] = []
+            if len(uv__indexes) >= 1:
+                args.extend(["--index", ",".join(v for _, v in uv__indexes)])
+            if uv__native_tls:
+                args.append("--native-tls")
+            _add_pre_commit_config_repo(
+                dict_,
+                ACTIONS_URL,
+                UPDATE_REQUIREMENTS_SUB_CMD,
+                args=("add", args) if len(args) >= 1 else None,
+            )
         if ruff:
             _add_pre_commit_config_repo(
                 dict_, RUFF_URL, "ruff-check", args=("add", ["--fix"])
@@ -866,16 +874,21 @@ def add_pre_commit_config_yaml(
                 ),
             )
         if uv:
+            args: list[str] = [
+                "--upgrade",
+                "--resolution",
+                "highest",
+                "--prerelease",
+                "disallow",
+            ]
+            if script is not None:
+                args.extend(["--script", script])
             _add_pre_commit_config_repo(
                 dict_,
                 UV_URL,
                 "uv-lock",
                 files=None if script is None else rf"^{escape(script)}$",
-                args=(
-                    "add",
-                    ["--upgrade", "--resolution", "highest", "--prerelease", "disallow"]
-                    + ([] if script is None else [f"--script={script}"]),
-                ),
+                args=("add", args),
             )
 
 
@@ -892,11 +905,11 @@ def _add_pre_commit_config_repo(
     types_or: list[str] | None = None,
     args: tuple[Literal["add", "exact"], list[str]] | None = None,
 ) -> None:
-    repos_list = get_list(pre_commit_dict, "repos")
+    repos_list = get_set_list_dicts(pre_commit_dict, "repos")
     repo_dict = ensure_contains_partial_dict(
         repos_list, {"repo": url}, extra={} if url == "local" else {"rev": "master"}
     )
-    hooks_list = get_list(repo_dict, "hooks")
+    hooks_list = get_set_list_dicts(repo_dict, "hooks")
     hook_dict = ensure_contains_partial_dict(hooks_list, {"id": id_})
     if name is not None:
         hook_dict["name"] = name
@@ -911,7 +924,7 @@ def _add_pre_commit_config_repo(
     if args is not None:
         match args:
             case "add", list() as args_i:
-                hook_args = get_list(hook_dict, "args")
+                hook_args = get_set_list_strs(hook_dict, "args")
                 ensure_contains(hook_args, *args_i)
             case "exact", list() as args_i:
                 hook_dict["args"] = args_i
@@ -931,13 +944,13 @@ def add_pyproject_toml(
     readme: bool = SETTINGS.readme,
     optional_dependencies__scripts: bool = SETTINGS.pyproject__project__optional_dependencies__scripts,
     python_package_name: str | None = SETTINGS.python_package_name,
-    tool__uv__indexes: list[tuple[str, str]] = SETTINGS.pyproject__tool__uv__indexes,
+    uv__indexes: list[tuple[str, str]] = SETTINGS.uv__indexes,
 ) -> None:
-    with yield_toml_doc(PYPROJECT_TOML, modifications=modifications) as doc:
-        build_system = get_table(doc, "build-system")
+    with yield_pyproject_toml(modifications=modifications) as doc:
+        build_system = get_set_table(doc, "build-system")
         build_system["build-backend"] = "uv_build"
         build_system["requires"] = ["uv_build"]
-        project = get_table(doc, "project")
+        project = get_set_table(doc, "project")
         project["requires-python"] = f">= {python_version}"
         if description is not None:
             project["description"] = description
@@ -946,33 +959,31 @@ def add_pyproject_toml(
         if readme:
             project["readme"] = "README.md"
         project.setdefault("version", "0.1.0")
-        dependency_groups = get_table(doc, "dependency-groups")
-        dev = get_array(dependency_groups, "dev")
+        dependency_groups = get_set_table(doc, "dependency-groups")
+        dev = get_set_array(dependency_groups, "dev")
         _ = ensure_contains_partial_str(dev, "dycw-utilities[test]")
         _ = ensure_contains_partial_str(dev, "pyright")
         _ = ensure_contains_partial_str(dev, "rich")
         if optional_dependencies__scripts:
-            optional_dependencies = get_table(project, "optional-dependencies")
-            scripts = get_array(optional_dependencies, "scripts")
+            optional_dependencies = get_set_table(project, "optional-dependencies")
+            scripts = get_set_array(optional_dependencies, "scripts")
             _ = ensure_contains_partial_str(scripts, "click")
         if python_package_name is not None:
-            tool = get_table(doc, "tool")
-            uv = get_table(tool, "uv")
-            build_backend = get_table(uv, "build-backend")
+            uv = get_tool_uv(doc)
+            build_backend = get_set_table(uv, "build-backend")
             build_backend["module-name"] = get_python_package_name(
                 package_name=package_name, python_package_name=python_package_name
             )
             build_backend["module-root"] = "src"
-        if len(tool__uv__indexes) >= 1:
-            tool = get_table(doc, "tool")
-            uv = get_table(tool, "uv")
-            indexes = get_aot(uv, "index")
-            for name, url in tool__uv__indexes:
+        if len(uv__indexes) >= 1:
+            uv = get_tool_uv(doc)
+            indexes = get_set_aot(uv, "index")
+            for name, url in uv__indexes:
                 index = table()
                 index["explicit"] = True
                 index["name"] = name
                 index["url"] = url
-                ensure_aot_contains(indexes, index)
+                ensure_contains(indexes, index)
 
 
 ##
@@ -987,7 +998,7 @@ def add_pyrightconfig_json(
     with yield_json_dict(PYRIGHTCONFIG_JSON, modifications=modifications) as dict_:
         dict_["deprecateTypingAliases"] = True
         dict_["enableReachabilityAnalysis"] = False
-        include = get_list(dict_, "include")
+        include = get_set_list_strs(dict_, "include")
         ensure_contains(include, "src" if script is None else script)
         dict_["pythonVersion"] = python_version
         dict_["reportCallInDefaultInitializer"] = True
@@ -1028,8 +1039,8 @@ def add_pytest_toml(
     script: str | None = SETTINGS.script,
 ) -> None:
     with yield_toml_doc(PYTEST_TOML, modifications=modifications) as doc:
-        pytest = get_table(doc, "pytest")
-        addopts = get_array(pytest, "addopts")
+        pytest = get_set_table(doc, "pytest")
+        addopts = get_set_array(pytest, "addopts")
         ensure_contains(
             addopts,
             "-ra",
@@ -1054,18 +1065,18 @@ def add_pytest_toml(
             )
         pytest["collect_imported_tests"] = False
         pytest["empty_parameter_set_mark"] = "fail_at_collect"
-        filterwarnings = get_array(pytest, "filterwarnings")
+        filterwarnings = get_set_array(pytest, "filterwarnings")
         ensure_contains(filterwarnings, "error")
         pytest["minversion"] = "9.0"
         pytest["strict"] = True
-        testpaths = get_array(pytest, "testpaths")
+        testpaths = get_set_array(pytest, "testpaths")
         ensure_contains(testpaths, "src/tests" if script is None else "tests")
         pytest["xfail_strict"] = True
         if asyncio:
             pytest["asyncio_default_fixture_loop_scope"] = "function"
             pytest["asyncio_mode"] = "auto"
         if ignore_warnings:
-            filterwarnings = get_array(pytest, "filterwarnings")
+            filterwarnings = get_set_array(pytest, "filterwarnings")
             ensure_contains(
                 filterwarnings,
                 "ignore::DeprecationWarning",
@@ -1107,14 +1118,14 @@ def add_ruff_toml(
     with yield_toml_doc(RUFF_TOML, modifications=modifications) as doc:
         doc["target-version"] = f"py{python_version.replace('.', '')}"
         doc["unsafe-fixes"] = True
-        fmt = get_table(doc, "format")
+        fmt = get_set_table(doc, "format")
         fmt["preview"] = True
         fmt["skip-magic-trailing-comma"] = True
-        lint = get_table(doc, "lint")
+        lint = get_set_table(doc, "lint")
         lint["explicit-preview-rules"] = True
-        fixable = get_array(lint, "fixable")
+        fixable = get_set_array(lint, "fixable")
         ensure_contains(fixable, "ALL")
-        ignore = get_array(lint, "ignore")
+        ignore = get_set_array(lint, "ignore")
         ensure_contains(
             ignore,
             "ANN401",  # any-type
@@ -1155,27 +1166,27 @@ def add_ruff_toml(
             "ISC002",  # multi-line-implicit-string-concatenation
         )
         lint["preview"] = True
-        select = get_array(lint, "select")
+        select = get_set_array(lint, "select")
         selected_rules = [
             "RUF022",  # unsorted-dunder-all
             "RUF029",  # unused-async
         ]
         ensure_contains(select, "ALL", *selected_rules)
-        extend_per_file_ignores = get_table(lint, "extend-per-file-ignores")
-        test_py = get_array(extend_per_file_ignores, "test_*.py")
+        extend_per_file_ignores = get_set_table(lint, "extend-per-file-ignores")
+        test_py = get_set_array(extend_per_file_ignores, "test_*.py")
         test_py_rules = [
             "S101",  # assert
             "SLF001",  # private-member-access
         ]
         ensure_contains(test_py, *test_py_rules)
         ensure_not_contains(ignore, *selected_rules, *test_py_rules)
-        bugbear = get_table(lint, "flake8-bugbear")
-        extend_immutable_calls = get_array(bugbear, "extend-immutable-calls")
+        bugbear = get_set_table(lint, "flake8-bugbear")
+        extend_immutable_calls = get_set_array(bugbear, "extend-immutable-calls")
         ensure_contains(extend_immutable_calls, "typing.cast")
-        tidy_imports = get_table(lint, "flake8-tidy-imports")
+        tidy_imports = get_set_table(lint, "flake8-tidy-imports")
         tidy_imports["ban-relative-imports"] = "all"
-        isort = get_table(lint, "isort")
-        req_imps = get_array(isort, "required-imports")
+        isort = get_set_table(lint, "isort")
+        req_imps = get_set_array(isort, "required-imports")
         ensure_contains(req_imps, "from __future__ import annotations")
         isort["split-on-trailing-comma"] = False
 
@@ -1224,13 +1235,21 @@ def get_python_package_name(
 ##
 
 
+def get_tool_uv(doc: TOMLDocument, /) -> Table:
+    tool = get_set_table(doc, "tool")
+    return get_set_table(tool, "uv")
+
+
+##
+
+
 def get_version_from_bumpversion_toml(
     *, obj: TOMLDocument | str | None = None
 ) -> Version:
     match obj:
         case TOMLDocument() as doc:
-            tool = get_table(doc, "tool")
-            bumpversion = get_table(tool, "bumpversion")
+            tool = get_set_table(doc, "tool")
+            bumpversion = get_set_table(tool, "bumpversion")
             return parse_version(str(bumpversion["current_version"]))
         case str() as text:
             return get_version_from_bumpversion_toml(obj=tomlkit.parse(text))
@@ -1290,7 +1309,7 @@ def _run_pre_commit_update(*, modifications: MutableSet[Path] | None = None) ->
 
 
 run_pre_commit_update = throttle(
-    delta=THROTTLE_DELTA, path=path_throttle_cache(_run_pre_commit_update)
+    duration=THROTTLE_DURATION, path=path_throttle_cache(_run_pre_commit_update)
 )(_run_pre_commit_update)
 
 
@@ -1356,7 +1375,7 @@ def update_action_file_extensions(
 
 def update_action_versions(*, modifications: MutableSet[Path] | None = None) -> None:
     try:
-        paths = list(Path(".github").rglob("**/*.yaml"))
+        paths = list(GITHUB.rglob("**/*.yaml"))
     except FileNotFoundError:
         return
     versions = {
@@ -1385,8 +1404,8 @@ def yield_bumpversion_toml(
     *, modifications: MutableSet[Path] | None = None
 ) -> Iterator[TOMLDocument]:
     with yield_toml_doc(BUMPVERSION_TOML, modifications=modifications) as doc:
-        tool = get_table(doc, "tool")
-        bumpversion = get_table(tool, "bumpversion")
+        tool = get_set_table(doc, "tool")
+        bumpversion = get_set_table(tool, "bumpversion")
         bumpversion["allow_dirty"] = True
         bumpversion.setdefault("current_version", str(Version(0, 1, 0)))
         yield doc
@@ -1434,6 +1453,7 @@ __all__ = [
     "check_versions",
     "get_cron_job",
     "get_python_package_name",
+    "get_tool_uv",
     "get_version_from_bumpversion_toml",
     "get_version_from_git_show",
     "get_version_from_git_tag",