refactor: Use dataclasses for configuration/options and automate schema generation

Author: pawamoy

config/pytest.ini

@@ -10,8 +10,7 @@ testpaths =
 # action:message_regex:warning_class:module_regex:line
 filterwarnings =
   error
-  # TODO: remove once pytest-xdist 4 is released
+  # TODO: Remove once pytest-xdist 4 is released.
   ignore:.*rsyncdir:DeprecationWarning:xdist
-  # TODO: remove once Griffe releases v1
-  ignore:.*`get_logger`:DeprecationWarning:_griffe
-  ignore:.*`name`:DeprecationWarning:_griffe
+  # TODO: Remove once mkdocstrings stops setting fallback function.
+  ignore:.*fallback anchor function:DeprecationWarning:mkdocstrings

docs/schema.json

@@ -199,13 +199,6 @@ in the following pages:
 - [Docstrings options](configuration/docstrings.md): options related to docstrings (parsing and rendering)
 - [Signature options](configuration/signatures.md): options related to signatures and type annotations
 
-#### Options summary
-
-::: mkdocstrings_handlers.python.handler.PythonHandler.default_config
-    options:
-      show_root_heading: false
-      show_root_toc_entry: false
-
 ## Finding modules
 
 There are multiple ways to tell the handler where to find your packages/modules.

docs/usage/index.md

@@ -88,6 +88,8 @@ def check_types(ctx: Context) -> None:
     ctx.run(
         tools.mypy(*PY_SRC_LIST, config_file="config/mypy.ini"),
         title=pyprefix("Type-checking"),
+        # TODO: Update when Pydantic supports 3.14.
+        nofail=sys.version_info >= (3, 14),
     )
 
 

duties.py

@@ -13,6 +13,9 @@ validation:
   absolute_links: warn
   unrecognized_links: warn
 
+hooks:
+- scripts/mkdocs_hooks.py
+
 nav:
 - Home:
   - Overview: index.md

mkdocs.yml

@@ -30,7 +30,7 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "mkdocstrings>=0.26",
+    "mkdocstrings>=0.28",
     "mkdocs-autorefs>=1.2",
     "griffe>=0.49",
 ]
@@ -113,3 +113,4 @@ dev = [
 
 [tool.inline-snapshot]
 storage-dir = "tests/snapshots"
+format-command = "ruff format --config config/ruff.toml --stdin-filename {filename}"

pyproject.toml

@@ -26,7 +26,7 @@
 def human_readable_amount(amount: int) -> str:  # noqa: D103
     str_amount = str(amount)
     if len(str_amount) >= 4:  # noqa: PLR2004
-        return f"{str_amount[:len(str_amount)-3]},{str_amount[-3:]}"
+        return f"{str_amount[: len(str_amount) - 3]},{str_amount[-3:]}"
     return str_amount