Replace docformatter with pydocstringformatter

- Replace docformatter==1.7.7 with pydocstringformatter==0.7.3
- Replace [tool.docformatter] with [tool.pydocstringformatter] config
- Update ruff ignore comments (D200 -> D205/D212)
- Don't use linewrap-full-docstring to avoid breaking URLs
  (DanielNoord/pydocstringformatter#540)

Author: adamtheturtle

.pre-commit-config.yaml

@@ -29,7 +29,7 @@ ci:
     - ruff-check-fix-docs
     - ruff-format-fix
     - ruff-format-fix-docs
-    - docformatter
+    - pydocstringformatter
     - shellcheck
     - shellcheck-docs
     - shfmt
@@ -119,9 +119,9 @@ repos:
         additional_dependencies: [uv==0.9.5]
         stages: [pre-commit]
 
-      - id: docformatter
-        name: docformatter
-        entry: uv run --extra=dev -m docformatter --in-place
+      - id: pydocstringformatter
+        name: pydocstringformatter
+        entry: uv run --extra=dev pydocstringformatter
         language: python
         types_or: [python]
         additional_dependencies: [uv==0.9.5]

admin/__init__.py

@@ -1,3 +1 @@
-"""
-Admin tools.
-"""
+"""Admin tools."""

admin/create_secrets_files.py

@@ -20,9 +20,7 @@
 
 
 def main() -> None:
-    """
-    Create secrets files.
-    """
+    """Create secrets files."""
     email_address = os.environ["VWS_EMAIL_ADDRESS"]
     password = os.environ["VWS_PASSWORD"]
     new_secrets_dir = Path(os.environ["NEW_SECRETS_DIR"]).expanduser()

ci/__init__.py

@@ -1,3 +1 @@
-"""
-CI helpers.
-"""
+"""CI helpers."""

ci/test_custom_linters.py

@@ -1,6 +1,4 @@
-"""
-Custom lint tests.
-"""
+"""Custom lint tests."""
 
 from pathlib import Path
 from typing import TYPE_CHECKING
@@ -15,9 +13,7 @@
 
 @beartype
 def _ci_patterns(*, repository_root: Path) -> set[str]:
-    """
-    Return the CI patterns given in the CI configuration file.
-    """
+    """Return the CI patterns given in the CI configuration file."""
     ci_file = repository_root / ".github" / "workflows" / "test.yml"
     github_workflow_config = yaml.safe_load(stream=ci_file.read_text())
     matrix = github_workflow_config["jobs"]["ci-tests"]["strategy"]["matrix"]
@@ -33,9 +29,7 @@ def _tests_from_pattern(
     ci_pattern: str,
     capsys: pytest.CaptureFixture[str],
 ) -> set[str]:
-    """
-    From a CI pattern, get all tests ``pytest`` would collect.
-    """
+    """From a CI pattern, get all tests ``pytest`` would collect."""
     # Clear the captured output.
     capsys.readouterr()
     tests: Iterable[str] = set()
@@ -59,7 +53,8 @@ def _tests_from_pattern(
 
 def test_ci_patterns_valid(request: pytest.FixtureRequest) -> None:
     """
-    All of the CI patterns in the CI configuration match at least one test in
+    All of the CI patterns in the CI configuration match at least one
+    test in
     the test suite.
     """
     ci_patterns = _ci_patterns(repository_root=request.config.rootpath)

conftest.py

@@ -1,6 +1,4 @@
-"""
-Setup for Sybil.
-"""
+"""Setup for Sybil."""
 
 from doctest import ELLIPSIS
 
@@ -17,9 +15,7 @@
 
 @beartype
 def pytest_collection_modifyitems(items: list[pytest.Item]) -> None:
-    """
-    Apply the beartype decorator to all collected test functions.
-    """
+    """Apply the beartype decorator to all collected test functions."""
     for item in items:
         if isinstance(item, pytest.Function):
             item.obj = beartype(obj=item.obj)

docs/source/__init__.py

@@ -1,3 +1 @@
-"""
-Documentation.
-"""
+"""Documentation."""

docs/source/conf.py

@@ -1,7 +1,5 @@
 #!/usr/bin/env python3
-"""
-Configuration for Sphinx.
-"""
+"""Configuration for Sphinx."""
 
 import importlib.metadata
 from pathlib import Path

pyproject.toml

@@ -57,7 +57,6 @@ optional-dependencies.dev = [
     "dirty-equals==0.11",
     "doc8==1.1.1",
     "doccmd==2026.1.25",
-    "docformatter==1.7.7",
     "docker==7.1.0",
     "enum-tools[sphinx]==0.13.0",
     "freezegun==1.5.5",
@@ -66,6 +65,7 @@ optional-dependencies.dev = [
     "mypy[faster-cache]==1.19.1",
     "mypy-strict-kwargs==2026.1.12",
     "prek==0.3.0",
+    "pydocstringformatter==0.7.3",
     "pydocstyle==6.3",
     "pylint[spelling]==4.0.4",
     "pylint-per-file-ignores==3.2.0",
@@ -152,8 +152,8 @@ lint.select = [
 lint.ignore = [
     # Ruff warns that this conflicts with the formatter.
     "COM812",
-    # Allow our chosen docstring line-style - no one-line summary.
-    "D200",
+    # Allow our chosen docstring line-style - pydocstringformatter handles formatting
+    # but doesn't enforce D205 (blank line after summary) or D212 (summary on first line).
     "D205",
     "D212",
     "D415",
@@ -169,6 +169,14 @@ lint.per-file-ignores."ci/test_custom_linters.py" = [
     "S101",
 ]
 
+lint.per-file-ignores."doccmd_*.py" = [
+    # Allow our chosen docstring line-style - pydocstringformatter handles
+    # formatting but docstrings in docs may not match this style.
+    "D200",
+    # Allow asserts in docs.
+    "S101",
+]
+
 lint.per-file-ignores."tests/**" = [
     # Allow asserts in tests.
     "S101",
@@ -298,9 +306,6 @@ spelling-private-dict-file = 'spelling_private_dict.txt'
 # --spelling-private-dict-file option instead of raising a message.
 spelling-store-unknown-words = 'no'
 
-[tool.docformatter]
-make-summary-multi-line = true
-
 [tool.check-manifest]
 
 ignore = [
@@ -403,6 +408,12 @@ enableTypeIgnoreComments = false
 reportUnnecessaryTypeIgnoreComment = true
 typeCheckingMode = "strict"
 
+[tool.pydocstringformatter]
+write = true
+split-summary-body = false
+max-line-length = 75
+linewrap-full-docstring = true
+
 [tool.interrogate]
 fail-under = 100
 omit-covered-files = true

src/mock_vws/__init__.py

@@ -1,6 +1,4 @@
-"""
-Tools for using a fake implementation of Vuforia.
-"""
+"""Tools for using a fake implementation of Vuforia."""
 
 from mock_vws._requests_mock_server.decorators import (
     MissingSchemeError,