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]

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",
@@ -298,9 +298,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 +400,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,

src/mock_vws/_base64_decoding.py

@@ -1,6 +1,4 @@
-"""
-Helpers for handling Base64 like Vuforia does.
-"""
+"""Helpers for handling Base64 like Vuforia does."""
 
 import base64
 import binascii

src/mock_vws/_constants.py

@@ -1,6 +1,4 @@
-"""
-Constants used to make the VWS mock.
-"""
+"""Constants used to make the VWS mock."""
 
 from enum import Enum, unique
 

src/mock_vws/_database_matchers.py

@@ -1,6 +1,4 @@
-"""
-Helpers for getting databases which match keys given in requests.
-"""
+"""Helpers for getting databases which match keys given in requests."""
 
 from collections.abc import Iterable, Mapping
 
@@ -19,7 +17,8 @@ def get_database_matching_client_keys(
     request_path: str,
     databases: Iterable[VuforiaDatabase],
 ) -> VuforiaDatabase:
-    """Return the first of the given databases which is being accessed by the
+    """Return the first of the given databases which is being accessed by
+    the
     given client request.
 
     Args:
@@ -67,7 +66,8 @@ def get_database_matching_server_keys(
     request_path: str,
     databases: Iterable[VuforiaDatabase],
 ) -> VuforiaDatabase:
-    """Return the first of the given databases which is being accessed by the
+    """Return the first of the given databases which is being accessed by
+    the
     given server request.
 
     Args:

src/mock_vws/_flask_server/__init__.py

@@ -1,3 +1 @@
-"""
-Flask server for the mock Vuforia web service.
-"""
+"""Flask server for the mock Vuforia web service."""

src/mock_vws/_flask_server/healthcheck.py

@@ -1,6 +1,4 @@
-"""
-Health check for the Flask server.
-"""
+"""Health check for the Flask server."""
 
 import http.client
 import socket
@@ -12,9 +10,7 @@
 
 @beartype
 def flask_app_healthy(port: int) -> bool:
-    """
-    Check if the Flask app is healthy.
-    """
+    """Check if the Flask app is healthy."""
     conn = http.client.HTTPConnection(host="localhost", port=port)
     try:
         conn.request(method="GET", url="/some-random-endpoint")