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]

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")

src/mock_vws/_flask_server/target_manager.py

@@ -1,6 +1,4 @@
-"""
-Storage layer for the mock Vuforia Flask application.
-"""
+"""Storage layer for the mock Vuforia Flask application."""
 
 import base64
 import copy
@@ -32,18 +30,14 @@
 
 @beartype
 class _TargetRaterChoice(StrEnum):
-    """
-    Target rater choices.
-    """
+    """Target rater choices."""
 
     BRISQUE = auto()
     PERFECT = auto()
     RANDOM = auto()
 
     def to_target_rater(self) -> TargetTrackingRater:
-        """
-        Get the target rater.
-        """
+        """Get the target rater."""
         match self:
             case self.BRISQUE:
                 return BrisqueTargetTrackingRater()
@@ -57,9 +51,7 @@ def to_target_rater(self) -> TargetTrackingRater:
 
 @beartype
 class TargetManagerSettings(BaseSettings):
-    """
-    Settings for the Target Manager Flask app.
-    """
+    """Settings for the Target Manager Flask app."""
 
     target_manager_host: str = ""
     target_rater: _TargetRaterChoice = _TargetRaterChoice.BRISQUE
@@ -91,9 +83,7 @@ def delete_database(database_name: str) -> Response:
 @TARGET_MANAGER_FLASK_APP.route(rule="/databases", methods=[HTTPMethod.GET])
 @beartype
 def get_databases() -> Response:
-    """
-    Return a list of all databases.
-    """
+    """Return a list of all databases."""
     databases = [database.to_dict() for database in TARGET_MANAGER.databases]
     return Response(
         response=json.dumps(obj=databases),
@@ -200,9 +190,7 @@ def create_database() -> Response:
 )
 @beartype
 def create_target(database_name: str) -> Response:
-    """
-    Create a new target in a given database.
-    """
+    """Create a new target in a given database."""
     (database,) = (
         database
         for database in TARGET_MANAGER.databases
@@ -238,9 +226,7 @@ def create_target(database_name: str) -> Response:
 )
 @beartype
 def delete_target(database_name: str, target_id: str) -> Response:
-    """
-    Delete a target.
-    """
+    """Delete a target."""
     (database,) = (
         database
         for database in TARGET_MANAGER.databases
@@ -266,9 +252,7 @@ def delete_target(database_name: str, target_id: str) -> Response:
     methods=[HTTPMethod.PUT],
 )
 def update_target(database_name: str, target_id: str) -> Response:
-    """
-    Update a target.
-    """
+    """Update a target."""
     (database,) = (
         database
         for database in TARGET_MANAGER.databases

src/mock_vws/_flask_server/vwq.py

@@ -33,17 +33,13 @@
 
 @beartype
 class _ImageMatcherChoice(StrEnum):
-    """
-    Image matcher choices.
-    """
+    """Image matcher choices."""
 
     EXACT = auto()
     STRUCTURAL_SIMILARITY = auto()
 
     def to_image_matcher(self) -> ImageMatcher:
-        """
-        Get the image matcher.
-        """
+        """Get the image matcher."""
         match self:
             case self.EXACT:
                 return ExactMatcher()
@@ -55,9 +51,7 @@ def to_image_matcher(self) -> ImageMatcher:
 
 @beartype
 class VWQSettings(BaseSettings):
-    """
-    Settings for the VWQ Flask app.
-    """
+    """Settings for the VWQ Flask app."""
 
     vwq_host: str = ""
     target_manager_base_url: str
@@ -68,9 +62,7 @@ class VWQSettings(BaseSettings):
 
 @beartype
 def get_all_databases() -> set[VuforiaDatabase]:
-    """
-    Get all database objects from the target manager back-end.
-    """
+    """Get all database objects from the target manager back-end."""
     settings = VWQSettings.model_validate(obj={})
     response = requests.get(
         url=f"{settings.target_manager_base_url}/databases",
@@ -111,9 +103,7 @@ def set_terminate_wsgi_input() -> None:
 
 @CLOUDRECO_FLASK_APP.errorhandler(code_or_exception=ValidatorError)
 def handle_exceptions(exc: ValidatorError) -> Response:
-    """
-    Return the error response associated with the given exception.
-    """
+    """Return the error response associated with the given exception."""
     response = Response(
         status=exc.status_code.value,
         response=exc.response_text,
@@ -127,9 +117,7 @@ def handle_exceptions(exc: ValidatorError) -> Response:
 
 @CLOUDRECO_FLASK_APP.route(rule="/v1/query", methods=[HTTPMethod.POST])
 def query() -> Response:
-    """
-    Perform an image recognition query.
-    """
+    """Perform an image recognition query."""
     settings = VWQSettings.model_validate(obj={})
     query_match_checker = settings.query_image_matcher.to_image_matcher()