Pre-Commit: Docformatter

Add [docformatter](https://github.com/PyCQA/docformatter) to
auto-format Function/Class docstrings according to numpy style.

.pre-commit-config.yaml

@@ -88,6 +88,16 @@ repos:
 #    exclude: ^(docs/.*|tools/.*)$
 # Alternatively: use autopep8?
 
+# Docstring formatting according to numpy style
+- repo: https://github.com/PyCQA/docformatter
+  rev: v1.5.1
+  hooks:
+    - id: docformatter
+      args: [
+        "--in-place",
+        "--config", "./pyproject.toml",
+      ]
+
 # Python Formatting
 - repo: https://github.com/psf/black
   rev: 23.1.0 # Keep in sync with blacken-docs

pyproject.toml

@@ -0,0 +1,6 @@
+[tool.docformatter]
+wrap-summaries = 79
+wrap-descriptions = 72
+non-strict = false
+syntax = "numpy"
+black = true