dycw-pre-commit-hooks 0.14.26__py3-none-any.whl → 0.14.39__py3-none-any.whl

pre_commit_hooks/hooks/add_hooks.py

@@ -1,80 +1,225 @@
 from __future__ import annotations
 
+from collections.abc import Callable
 from functools import partial
-from itertools import chain
-from typing import TYPE_CHECKING
+from pathlib import Path
+from typing import TYPE_CHECKING, Literal, assert_never
 
 from click import command, option
 from utilities.click import CONTEXT_SETTINGS
+from utilities.concurrent import concurrent_map
+from utilities.iterables import always_iterable
 from utilities.os import is_pytest
+from utilities.types import PathLike
 
 from pre_commit_hooks.constants import (
     BUILTIN,
     DEFAULT_PYTHON_VERSION,
+    DOCKERFMT_URL,
     DYCW_PRE_COMMIT_HOOKS_URL,
+    FORMATTER_PRIORITY,
+    LINTER_PRIORITY,
+    LOCAL,
     PRE_COMMIT_CONFIG_YAML,
     PYPROJECT_TOML,
     RUFF_URL,
+    SHELLCHECK_URL,
+    SHFMT_URL,
     STD_PRE_COMMIT_HOOKS_URL,
+    STYLUA_URL,
+    TAPLO_URL,
+    UV_URL,
+    XMLFORMATTER_URL,
     paths_argument,
+    python_option,
+    python_package_name_option,
+    python_uv_index_option,
+    python_uv_native_tls_option,
     python_version_option,
 )
-from pre_commit_hooks.utilities import add_pre_commit_config_repo, run_all_maybe_raise
+from pre_commit_hooks.utilities import (
+    apply,
+    ensure_contains_partial_dict,
+    get_set_list_dicts,
+    run_all_maybe_raise,
+    yield_yaml_dict,
+)
 
 if TYPE_CHECKING:
-    from collections.abc import Callable
+    from collections.abc import Callable, MutableSet
     from pathlib import Path
 
-    from utilities.types import PathLike
+    from utilities.types import IntOrAll, MaybeSequenceStr, PathLike
 
 
 @command(**CONTEXT_SETTINGS)
 @paths_argument
-@option("--python", is_flag=True, default=False)
+@option("--ci", is_flag=True, default=False)
+@option("--direnv", is_flag=True, default=False)
+@option("--docker", is_flag=True, default=False)
+@option("--fish", is_flag=True, default=False)
+@option("--lua", is_flag=True, default=False)
+@option("--prettier", is_flag=True, default=False)
+@python_option
+@python_package_name_option
+@python_uv_index_option
+@python_uv_native_tls_option
 @python_version_option
+@option("--shell", is_flag=True, default=False)
+@option("--toml", is_flag=True, default=False)
+@option("--xml", is_flag=True, default=False)
+@option("--max-workers", type=int, default=None)
 def _main(
     *,
     paths: tuple[Path, ...],
+    ci: bool = False,
+    direnv: bool = False,
+    docker: bool = False,
+    fish: bool = False,
+    lua: bool = False,
+    prettier: bool = False,
     python: bool = False,
+    python_package_name: str | None = None,
+    python_uv_index: MaybeSequenceStr | None = None,
+    python_uv_native_tls: bool = False,
     python_version: str = DEFAULT_PYTHON_VERSION,
+    shell: bool = False,
+    toml: bool = False,
+    xml: bool = False,
+    max_workers: int | None = None,
 ) -> None:
     if is_pytest():
         return
-    funcs: list[Callable[[], bool]] = list(
-        chain(
-            (partial(_add_check_versions_consistent, path=p) for p in paths),
-            (partial(_add_format_pre_commit_config, path=p) for p in paths),
-            (partial(_add_run_prek_autoupdate, path=p) for p in paths),
-            (partial(_add_run_version_bump, path=p) for p in paths),
-            (partial(_add_standard_hooks, path=p) for p in paths),
+    run_all_maybe_raise(
+        *(
+            partial(
+                _run,
+                path=p,
+                ci=ci,
+                direnv=direnv,
+                docker=docker,
+                fish=fish,
+                lua=lua,
+                prettier=prettier,
+                python=python,
+                python_package_name=python_package_name,
+                python_uv_index=python_uv_index,
+                python_uv_native_tls=python_uv_native_tls,
+                python_version=python_version,
+                shell=shell,
+                toml=toml,
+                xml=xml,
+                max_workers="all" if max_workers is None else max_workers,
+            )
+            for p in paths
         )
     )
+
+
+def _run(
+    *,
+    path: PathLike = PRE_COMMIT_CONFIG_YAML,
+    ci: bool = False,
+    direnv: bool = False,
+    docker: bool = False,
+    fish: bool = False,
+    lua: bool = False,
+    prettier: bool = False,
+    python: bool = False,
+    python_package_name: str | None = None,
+    python_uv_index: MaybeSequenceStr | None = None,
+    python_uv_native_tls: bool = False,
+    python_version: str = DEFAULT_PYTHON_VERSION,
+    shell: bool = False,
+    toml: bool = False,
+    xml: bool = False,
+    max_workers: IntOrAll = "all",
+) -> bool:
+    funcs: list[Callable[[], bool]] = [
+        partial(_add_check_version_bumped, path=path),
+        partial(_add_check_versions_consistent, path=path),
+        partial(_add_format_pre_commit_config, path=path),
+        partial(_add_run_prek_autoupdate, path=path),
+        partial(_add_run_version_bump, path=path),
+        partial(_add_setup_bump_my_version, path=path),
+        partial(_add_standard_hooks, path=path),
+    ]
+    if ci:
+        funcs.append(partial(_add_update_ci_action_versions, path=path))
+        funcs.append(partial(_add_update_ci_extensions, path=path))
+    if direnv:
+        funcs.append(partial(_add_setup_direnv, path=path))
+    if docker:
+        funcs.append(partial(_add_dockerfmt, path=path))
+    if fish:
+        funcs.append(partial(_add_fish_indent, path=path))
+    if lua:
+        funcs.append(partial(_add_stylua, path=path))
+    if prettier:
+        funcs.append(partial(_add_prettier, path=path))
     if python:
-        funcs.extend(partial(_add_add_future_import_annotations, path=p) for p in paths)
-        funcs.extend(partial(_add_format_requirements, path=p) for p in paths)
-        funcs.extend(partial(_add_replace_sequence_str, path=p) for p in paths)
-        funcs.extend(partial(_add_ruff_check, path=p) for p in paths)
-        funcs.extend(partial(_add_ruff_format, path=p) for p in paths)
-        funcs.extend(partial(_add_setup_git, path=p) for p in paths)
-        funcs.extend(
-            partial(_add_setup_pyright, path=p, python_version=python_version)
-            for p in paths
+        funcs.append(partial(_add_add_future_import_annotations, path=path))
+        funcs.append(partial(_add_format_requirements, path=path))
+        funcs.append(partial(_add_replace_sequence_str, path=path))
+        funcs.append(partial(_add_ruff_check, path=path))
+        funcs.append(partial(_add_ruff_format, path=path))
+        funcs.append(
+            partial(
+                _add_setup_bump_my_version,
+                path=path,
+                python_package_name=python_package_name,
+            )
         )
-        funcs.extend(
-            partial(_add_setup_ruff, path=p, python_version=python_version)
-            for p in paths
+        funcs.append(
+            partial(
+                _add_setup_direnv,
+                path=path,
+                python=python,
+                python_uv_index=python_uv_index,
+                python_uv_native_tls=python_uv_native_tls,
+                python_version=python_version,
+            )
+        )
+        funcs.append(partial(_add_setup_git, path=path))
+        funcs.append(
+            partial(_add_setup_pyright, path=path, python_version=python_version)
         )
-        funcs.extend(partial(_add_update_requirements, path=p) for p in paths)
-    run_all_maybe_raise(*funcs)
+        funcs.append(partial(_add_setup_ruff, path=path, python_version=python_version))
+        funcs.append(partial(_add_update_requirements, path=path))
+        funcs.append(partial(_add_uv_lock, path=path))
+    if shell:
+        funcs.append(partial(_add_shellcheck, path=path))
+        funcs.append(partial(_add_shfmt, path=path))
+    if toml:
+        funcs.append(partial(_add_taplo_format, path=path))
+    if xml:
+        funcs.append(partial(_add_xmlformatter, path=path))
+    return all(
+        concurrent_map(apply, funcs, parallelism="threads", max_workers=max_workers)
+    )
+
+
+def _add_check_version_bumped(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        DYCW_PRE_COMMIT_HOOKS_URL,
+        "check-version-bumped",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        type_="linter",
+    )
+    return len(modifications) == 0
 
 
 def _add_check_versions_consistent(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         DYCW_PRE_COMMIT_HOOKS_URL,
         "check-versions-consistent",
         path=path,
         modifications=modifications,
+        rev=True,
         type_="linter",
     )
     return len(modifications) == 0
@@ -82,11 +227,12 @@ def _add_check_versions_consistent(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -
 
 def _add_format_pre_commit_config(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         DYCW_PRE_COMMIT_HOOKS_URL,
         "format-pre-commit-config",
         path=path,
         modifications=modifications,
+        rev=True,
         type_="linter",
     )
     return len(modifications) == 0
@@ -94,11 +240,12 @@ def _add_format_pre_commit_config(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) ->
 
 def _add_run_prek_autoupdate(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         DYCW_PRE_COMMIT_HOOKS_URL,
         "run-prek-autoupdate",
         path=path,
         modifications=modifications,
+        rev=True,
         type_="formatter",
     )
     return len(modifications) == 0
@@ -106,11 +253,31 @@ def _add_run_prek_autoupdate(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool
 
 def _add_run_version_bump(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         DYCW_PRE_COMMIT_HOOKS_URL,
         "run-version-bump",
         path=path,
         modifications=modifications,
+        rev=True,
+        type_="formatter",
+    )
+    return len(modifications) == 0
+
+
+def _add_setup_bump_my_version(
+    *, path: PathLike = PRE_COMMIT_CONFIG_YAML, python_package_name: str | None = None
+) -> bool:
+    modifications: set[Path] = set()
+    args: list[str] = []
+    if python_package_name is not None:
+        args.append(f"--python-package-name={python_package_name}")
+    _add_hook(
+        DYCW_PRE_COMMIT_HOOKS_URL,
+        "setup-bump-my-version",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        args=args if len(args) >= 1 else None,
         type_="formatter",
     )
     return len(modifications) == 0
@@ -118,100 +285,100 @@ def _add_run_version_bump(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
 
 def _add_standard_hooks(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN,
         "check-added-large-files",
         path=path,
         modifications=modifications,
         type_="linter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN,
         "check-case-conflict",
         path=path,
         modifications=modifications,
         type_="linter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN,
         "check-executables-have-shebangs",
         path=path,
         modifications=modifications,
         type_="linter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN, "check-json", path=path, modifications=modifications, type_="linter"
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN, "check-json5", path=path, modifications=modifications, type_="linter"
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN,
         "check-merge-conflict",
         path=path,
         modifications=modifications,
         type_="linter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN,
         "check-symlinks",
         path=path,
         modifications=modifications,
         type_="linter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN, "check-toml", path=path, modifications=modifications, type_="linter"
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN, "check-xml", path=path, modifications=modifications, type_="linter"
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN, "check-yaml", path=path, modifications=modifications, type_="linter"
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN,
         "detect-private-key",
         path=path,
         modifications=modifications,
         type_="linter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN,
         "end-of-file-fixer",
         path=path,
         modifications=modifications,
         type_="formatter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN,
         "fix-byte-order-marker",
         path=path,
         modifications=modifications,
         type_="formatter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN,
         "mixed-line-ending",
         path=path,
         modifications=modifications,
-        args=("add", ["--fix=lf"]),
+        args=["--fix=lf"],
         type_="formatter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN,
         "no-commit-to-branch",
         path=path,
         modifications=modifications,
         type_="linter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         BUILTIN,
         "trailing-whitespace",
         path=path,
         modifications=modifications,
         type_="formatter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         STD_PRE_COMMIT_HOOKS_URL,
         "check-illegal-windows-names",
         path=path,
@@ -219,7 +386,7 @@ def _add_standard_hooks(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
         rev=True,
         type_="linter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         STD_PRE_COMMIT_HOOKS_URL,
         "destroyed-symlinks",
         path=path,
@@ -227,13 +394,129 @@ def _add_standard_hooks(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
         rev=True,
         type_="linter",
     )
-    add_pre_commit_config_repo(
+    _add_hook(
         STD_PRE_COMMIT_HOOKS_URL,
         "pretty-format-json",
         path=path,
         modifications=modifications,
         rev=True,
-        args=("add", ["--autofix"]),
+        args=["--autofix"],
+        type_="formatter",
+    )
+    return len(modifications) == 0
+
+
+def _add_update_ci_action_versions(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        DYCW_PRE_COMMIT_HOOKS_URL,
+        "update-ci-action-versions",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        type_="formatter",
+    )
+    return len(modifications) == 0
+
+
+def _add_update_ci_extensions(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        DYCW_PRE_COMMIT_HOOKS_URL,
+        "update-ci-extensions",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        type_="formatter",
+    )
+    return len(modifications) == 0
+
+
+def _add_setup_direnv(
+    *,
+    path: PathLike = PRE_COMMIT_CONFIG_YAML,
+    python: bool = False,
+    python_uv_index: MaybeSequenceStr | None = None,
+    python_uv_native_tls: bool = False,
+    python_version: str = DEFAULT_PYTHON_VERSION,
+) -> bool:
+    modifications: set[Path] = set()
+    args: list[str] = []
+    if python:
+        args.append("--python")
+    if python_uv_index is not None:
+        args.append(f"--python-uv-index={','.join(always_iterable(python_uv_index))}")
+    if python_uv_native_tls:
+        args.append("--python-uv-native-tls")
+    if python_version is not None:
+        args.append(f"--python-version={python_version}")
+    _add_hook(
+        DYCW_PRE_COMMIT_HOOKS_URL,
+        "setup-direnv",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        args=args if len(args) >= 1 else None,
+        type_="formatter",
+    )
+    return len(modifications) == 0
+
+
+def _add_dockerfmt(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        DOCKERFMT_URL,
+        "dockerfmt",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        args=["--newline", "--write"],
+        type_="formatter",
+    )
+    return len(modifications) == 0
+
+
+def _add_fish_indent(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        LOCAL,
+        "fish_indent",
+        path=path,
+        modifications=modifications,
+        name="fish_indent",
+        entry="fish_indent",
+        language="unsupported",
+        files=r"\.fish$",
+        args=["--write"],
+        type_="formatter",
+    )
+    return len(modifications) == 0
+
+
+def _add_stylua(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        STYLUA_URL,
+        "stlya",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        type_="formatter",
+    )
+    return len(modifications) == 0
+
+
+def _add_prettier(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        LOCAL,
+        "prettier",
+        path=path,
+        modifications=modifications,
+        name="prettier",
+        entry="npx prettier --write",
+        language="unsupported",
+        types_or=["markdown", "yaml"],
         type_="formatter",
     )
     return len(modifications) == 0
@@ -243,7 +526,7 @@ def _add_add_future_import_annotations(
     *, path: PathLike = PRE_COMMIT_CONFIG_YAML
 ) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         DYCW_PRE_COMMIT_HOOKS_URL,
         "add-future-import-annotations",
         path=path,
@@ -256,7 +539,7 @@ def _add_add_future_import_annotations(
 
 def _add_format_requirements(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         DYCW_PRE_COMMIT_HOOKS_URL,
         "format-requirements",
         path=path,
@@ -269,7 +552,7 @@ def _add_format_requirements(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool
 
 def _add_replace_sequence_str(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         DYCW_PRE_COMMIT_HOOKS_URL,
         "replace-sequence-str",
         path=path,
@@ -282,13 +565,13 @@ def _add_replace_sequence_str(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> boo
 
 def _add_ruff_check(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         RUFF_URL,
         "ruff-check",
         path=path,
         modifications=modifications,
         rev=True,
-        args=("exact", ["--fix"]),
+        args=["--fix"],
         type_="linter",
     )
     return len(modifications) == 0
@@ -296,7 +579,7 @@ def _add_ruff_check(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
 
 def _add_ruff_format(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         RUFF_URL,
         "ruff-format",
         path=path,
@@ -309,7 +592,7 @@ def _add_ruff_format(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
 
 def _add_setup_git(*, path: PathLike = PRE_COMMIT_CONFIG_YAML) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         DYCW_PRE_COMMIT_HOOKS_URL,
         "setup-git",
         path=path,
@@ -326,13 +609,13 @@ def _add_setup_pyright(
     python_version: str = DEFAULT_PYTHON_VERSION,
 ) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         DYCW_PRE_COMMIT_HOOKS_URL,
         "setup-pyright",
         path=path,
         modifications=modifications,
         rev=True,
-        args=("exact", [f"--python-version={python_version}"]),
+        args=[f"--python-version={python_version}"],
         type_="formatter",
     )
     return len(modifications) == 0
@@ -344,13 +627,13 @@ def _add_setup_ruff(
     python_version: str = DEFAULT_PYTHON_VERSION,
 ) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         DYCW_PRE_COMMIT_HOOKS_URL,
         "setup-ruff",
         path=path,
         modifications=modifications,
         rev=True,
-        args=("exact", [f"--python-version={python_version}"]),
+        args=[f"--python-version={python_version}"],
         type_="formatter",
     )
     return len(modifications) == 0
@@ -358,7 +641,7 @@ def _add_setup_ruff(
 
 def _add_update_requirements(*, path: PathLike = PYPROJECT_TOML) -> bool:
     modifications: set[Path] = set()
-    add_pre_commit_config_repo(
+    _add_hook(
         DYCW_PRE_COMMIT_HOOKS_URL,
         "update-requirements",
         path=path,
@@ -369,5 +652,134 @@ def _add_update_requirements(*, path: PathLike = PYPROJECT_TOML) -> bool:
     return len(modifications) == 0
 
 
+def _add_uv_lock(*, path: PathLike = PYPROJECT_TOML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        UV_URL,
+        "uv-lock",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        args=["--upgrade", "--resolution", "highest", "--prerelease", "disallow"],
+        type_="formatter",
+    )
+    return len(modifications) == 0
+
+
+def _add_shellcheck(*, path: PathLike = PYPROJECT_TOML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        SHELLCHECK_URL,
+        "shellcheck",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        type_="linter",
+    )
+    return len(modifications) == 0
+
+
+def _add_shfmt(*, path: PathLike = PYPROJECT_TOML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        SHFMT_URL,
+        "shfmt",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        type_="formatter",
+    )
+    return len(modifications) == 0
+
+
+def _add_taplo_format(*, path: PathLike = PYPROJECT_TOML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        TAPLO_URL,
+        "taplo-format",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        args=[
+            "--option",
+            "indent_tables=true",
+            "--option",
+            "indent_entries=true",
+            "--option",
+            "reorder_keys=true",
+        ],
+        type_="linter",
+    )
+    return len(modifications) == 0
+
+
+def _add_xmlformatter(*, path: PathLike = PYPROJECT_TOML) -> bool:
+    modifications: set[Path] = set()
+    _add_hook(
+        XMLFORMATTER_URL,
+        "xml-formatter",
+        path=path,
+        modifications=modifications,
+        rev=True,
+        types=[],
+        types_or=["plist", "xml"],
+        args=["--eof-newline"],
+        type_="formatter",
+    )
+    return len(modifications) == 0
+
+
+##
+
+
+def _add_hook(
+    url: str,
+    id_: str,
+    /,
+    *,
+    path: PathLike = PRE_COMMIT_CONFIG_YAML,
+    modifications: MutableSet[Path] | None = None,
+    rev: bool = False,
+    name: str | None = None,
+    entry: str | None = None,
+    language: str | None = None,
+    files: str | None = None,
+    types: list[str] | None = None,
+    types_or: list[str] | None = None,
+    args: list[str] | None = None,
+    type_: Literal["formatter", "linter"] | None = None,
+) -> None:
+    with yield_yaml_dict(path, modifications=modifications) as dict_:
+        repos_list = get_set_list_dicts(dict_, "repos")
+        repo_dict = ensure_contains_partial_dict(
+            repos_list, {"repo": url}, extra={"rev": "master"} if rev else {}
+        )
+        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
+        if entry is not None:
+            hook_dict["entry"] = entry
+        if language is not None:
+            hook_dict["language"] = language
+        if files is not None:
+            hook_dict["files"] = files
+        if types is not None:
+            hook_dict["types"] = types
+        if types_or is not None:
+            hook_dict["types_or"] = types_or
+        if args is not None:
+            hook_dict["args"] = args
+        match type_:
+            case "formatter":
+                hook_dict["priority"] = FORMATTER_PRIORITY
+            case "linter":
+                hook_dict["priority"] = LINTER_PRIORITY
+            case None:
+                ...
+            case never:
+                assert_never(never)
+
+
 if __name__ == "__main__":
     _main()