pre-commit hook maintenance (#10871)

* re-enable blackdoc with a newer version of black

* comment about the version of black

* explicit string

* enable `toml` linting

* update hook versions

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: keewis

.pre-commit-config.yaml

@@ -24,24 +24,23 @@ repos:
       - id: rst-inline-touching-normal
       - id: text-unicode-replacement-char
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.13.3
+    rev: v0.14.1
     hooks:
       - id: ruff-check
         args: ["--fix", "--show-fixes"]
       - id: ruff-format
-  # Disabled: blackdoc v0.4.3 has compatibility issues with Python 3.13
-  # Re-enable when blackdoc is updated to support Python 3.13
-  # - repo: https://github.com/keewis/blackdoc
-  #   rev: v0.4.3
-  #   hooks:
-  #     - id: blackdoc
-  #       exclude: "generate_aggregations.py"
-  #       additional_dependencies: ["black==24.8.0"]
+  - repo: https://github.com/keewis/blackdoc
+    rev: v0.4.5
+    hooks:
+      - id: blackdoc
+        exclude: "generate_aggregations.py"
+        # make sure this is the most recent version of black
+        additional_dependencies: ["black==25.9.0"]
   - repo: https://github.com/rbubley/mirrors-prettier
     rev: v3.6.2
     hooks:
       - id: prettier
-        args: [--cache-location=.prettier_cache/cache]
+        args: ["--cache-location=.prettier_cache/cache"]
   - repo: https://github.com/pre-commit/mirrors-mypy
     rev: v1.18.2
     hooks:
@@ -61,20 +60,22 @@ repos:
             numpy,
           ]
   - repo: https://github.com/citation-file-format/cff-converter-python
-    rev: ebf0b5e44d67f8beaa1cd13a0d0393ea04c6058d
+    rev: 5295f87c0e261da61a7b919fc754e3a77edd98a7
     hooks:
       - id: validate-cff
   - repo: https://github.com/ComPWA/taplo-pre-commit
     rev: v0.9.3
     hooks:
       - id: taplo-format
         args: ["--option", "array_auto_collapse=false"]
+      - id: taplo-lint
+        args: ["--no-schema"]
   - repo: https://github.com/abravalheri/validate-pyproject
     rev: v0.24.1
     hooks:
       - id: validate-pyproject
         additional_dependencies: ["validate-pyproject-schema-store[all]"]
   - repo: https://github.com/adhtruong/mirrors-typos
-    rev: v1.37.2
+    rev: v1.38.1
     hooks:
       - id: typos

doc/user-guide/io.rst

@@ -128,7 +128,7 @@ The backends are tried in order: **netcdf4 → h5netcdf → scipy → pydap →
     .. code-block:: python
 
         # Prefer h5netcdf over netcdf4
-        xr.set_options(netcdf_engine_order=['h5netcdf', 'netcdf4', 'scipy'])
+        xr.set_options(netcdf_engine_order=["h5netcdf", "netcdf4", "scipy"])
 
     See :ref:`options` for more details on configuration options.