build(deps): Add back black

ruff doesn't replace black, yet

Author: tony

CHANGES

@@ -14,6 +14,14 @@ $ pip install --user --upgrade --pre libtmux
 
 <!-- Maintainers and contributors: Insert change notes for the next release above -->
 
+_Maintenance only, no bug fixes or features_
+
+### Development
+
+- Add back `black` for formatting
+
+  This is still necessary to accompany `ruff`, until it replaces black.
+
 ## libtmux 0.22.0 (2023-05-27)
 
 _Maintenance only, no bug fixes or features_

Makefile

@@ -38,6 +38,9 @@ serve_docs:
 dev_docs:
 	$(MAKE) -j watch_docs serve_docs
 
+black:
+	poetry run black `${PY_FILES}`
+
 ruff:
 	poetry run ruff .
 

docs/developing.md

@@ -61,6 +61,36 @@ and `setup.cfg`:
 
 ## Linting
 
+### black
+
+[black] is used for formatting.
+
+````{tab} Command
+
+poetry:
+
+```console
+$ poetry run black .
+```
+
+If you setup manually:
+
+```console
+$ black .
+```
+
+````
+
+````{tab} make
+
+```console
+$ make black
+```
+
+````
+
+In the future, `ruff` (below) may replace black as formatter.
+
 ### ruff
 
 The project uses [ruff] to handles formatting, sorting imports and linting.
@@ -115,8 +145,6 @@ $ ruff . --fix
 
 ````
 
-
-
 ### mypy
 
 [mypy] is used for static type checking.
@@ -215,5 +243,6 @@ Update `__version__` in `__about__.py` and `pyproject.toml`::
 [poetry]: https://python-poetry.org/
 [entr(1)]: http://eradman.com/entrproject/
 [`entr(1)`]: http://eradman.com/entrproject/
+[black]: https://github.com/psf/black
 [ruff]: https://ruff.rs
 [mypy]: http://mypy-lang.org/

poetry.lock

@@ -75,6 +75,7 @@ coverage = "*"
 pytest-cov = "*"
 
 ### Format ###
+black = "*"
 ruff = "*"
 mypy = "*"
 
@@ -94,7 +95,7 @@ docs = [
 ]
 test = ["pytest", "pytest-rerunfailures", "pytest-mock", "pytest-watcher"]
 coverage = ["codecov", "coverage", "pytest-cov"]
-lint = ["ruff", "mypy"]
+lint = ["black", "ruff", "mypy"]
 
 [tool.poetry.plugins.pytest11]
 libtmux = "libtmux.pytest_plugin"