chore: bump docformatter to v1.7.8

[gencurrent]

Summary

• Bumps docformatter from v1.7.7 to v1.7.8 in .pre-commit-config.yaml.
• Removes the ci.skip: [docformatter] workaround added in fix(typing): preserve decorated function type signatures with ParamSpec #376.
• Adds a small exclude: block for 3 files where v1.7.8 disagrees with ruff-format (see docformatter deadlock with ruff-format: blank lines around nested definitions PyCQA/docformatter#354).

Reopens the intent of #381 over an up-to-date master. The cosmetic docstring cleanup that #381 originally bundled is already on master via #385, so this PR is now scoped solely to the dependency + hook configuration change.

Why

docformatter v1.7.7 transitively depended on the unmaintained untokenize package, whose setup.py uses ast.Constant.s (removed in Python 3.12+). This caused fresh installs on pre-commit.ci to fail with:

Failed to build 'untokenize' when getting requirements to build wheel
Error: 'Constant' object has no attribute 's'

PyCQA/docformatter#325 replaced untokenize with stdlib tokenize, and that fix shipped in v1.7.8.

On the exclude block

v1.7.8 also tightened a few docstring decisions that conflict with ruff-format on three files:

• src/cachier/exporters/prometheus.py — blank lines after docstring-only function bodies
• tests/mongo_tests/clients.py — blank lines between module docstring and first class
• tests/test_varargs.py — multi-line string literals used as exec() arguments that docformatter mistakes for docstrings

These are excluded via a regex exclude: block until upstream (PyCQA/docformatter#354) reconciles the conventions, or the local patterns are restructured. Happy to drop the exclude and restructure the patterns in a follow-up if preferred.

Test plan

• pre-commit run docformatter --all-files passes locally
• pre-commit.ci - pr check passes

Notes

• Supersedes chore: bump docformatter to v1.7.8 #381 (closed). cc @shaypal5 @Borda
• @Borda's review pointer to docformatter deadlock with ruff-format: blank lines around nested definitions PyCQA/docformatter#354 is now reflected in the commit message and PR body.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.95%. Comparing base (c92ee34) to head (b92ebb4).

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #388   +/-   ##
=======================================
  Coverage   99.95%   99.95%           
=======================================
  Files          16       16           
  Lines        2109     2109           
  Branches      251      251           
=======================================
  Hits         2108     2108           
  Partials        1        1           

Flag	Coverage Δ
local	66.57% <ø> (ø)
mongodb	40.01% <ø> (ø)
postgres	42.05% <ø> (ø)
redis	44.57% <ø> (ø)
s3	41.29% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update c92ee34...b92ebb4. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.