[py] Remove docformatter and update README.md

cgoldberg · cgoldberg · commit 95b5594f88dc · 2025-05-15T22:42:15.000-04:00
diff --git a/README.md b/README.md
@@ -217,16 +217,12 @@ To automatically update and pin new dependencies, run:
 
 ### Python
 
-#### Linting
+#### Linting and Formatting
 
 We follow the [PEP8 Style Guide for Python Code](https://peps.python.org/pep-0008) (except we use a 120 character line length).
-This is checked and enforced with several linting tools, including
-[black](https://pypi.org/project/black),
-[docformatter](https://pypi.org/project/docformatter),
-[flake8](https://flake8.pycqa.org),
-and [isort](https://pycqa.github.io/isort).
+This is checked and enforced with [ruff](https://docs.astral.sh/ruff/), a linting/formatting tool.
 
-To run all of the linting tools:
+To run linting and formatting:
 ```shell
 ./go py:lint
 ```
diff --git a/py/pyproject.toml b/py/pyproject.toml
@@ -131,15 +131,9 @@ ignore_missing_imports = true
 # suppress error messages about imports that cannot be resolved.
 ignore_missing_imports = true
 
-[tool.docformatter]
-exclude = "selenium/webdriver/common/devtools"
-in-place = true
-recursive = true
-
 [tool.ruff]
 extend-exclude = [
     "selenium/webdriver/common/devtools/",
-    "private/",
     "generate.py",
 ]
 line-length = 120
diff --git a/py/tox.ini b/py/tox.ini
@@ -38,6 +38,5 @@ deps =
   ruff==0.11.10
   docformatter==1.7.5
 commands =
-  docformatter selenium/ test/ conftest.py
   ruff check --fix --show-fixes --exit-non-zero-on-fix selenium/ test/ conftest.py
   ruff format --exit-non-zero-on-format selenium/ test/ conftest.py
diff --git a/scripts/format.sh b/scripts/format.sh
@@ -33,7 +33,7 @@ bazel run @rules_rust//:rustfmt
 
 # TODO: use bazel target when rules_python supports formatting
 section "Python"
-echo "    python - isort, black, autoflake, flake8, docformatter" >&2
+echo "    python - ruff" >&2
 pip install tox
 export TOXENV=linting
 tox -c py/tox.ini
