build(deps): Add back black

ruff doesn't replace black, yet

Author: tony

CHANGES

@@ -19,6 +19,14 @@ $ pipx install --suffix=@next 'tmuxp' --pip-args '\--pre' --force
 
 <!-- Maintainers, insert changes / features for the next release here -->
 
+_Maintenance only, no bug fixes, or new features_
+
+### Development
+
+- Add back `black` for formatting
+
+  This is still necessary to accompany `ruff`, until it replaces black.
+
 ## tmuxp 1.28.0 (2023-05-27)
 
 _Maintenance only, no bug fixes or features_

Makefile

@@ -38,6 +38,9 @@ start_docs:
 design_docs:
 	$(MAKE) -C docs design
 
+black:
+	poetry run black `${PY_FILES}`
+
 ruff:
 	poetry run ruff .
 

docs/developing.md

@@ -329,6 +329,36 @@ this will load the `.tmuxp.yaml` in the root of the project.
 
 ## Formatting
 
+### 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.
@@ -437,6 +467,7 @@ the [gh build site].
 [entr]: http://entrproject.org/
 [`entr(1)`]: http://entrproject.org/
 [ruff]: https://ruff.rs
+[black]: https://github.com/psf/black
 [mypy]: http://mypy-lang.org/
 [github actions]: https://github.com/features/actions
 [gh build site]: https://github.com/tmux-python/tmuxp/actions?query=workflow%3Atests

poetry.lock

@@ -81,6 +81,7 @@ codecov = "*"
 coverage = "*"
 
 ### Lint ###
+black = "*"
 ruff = "*"
 mypy = "*"
 types-colorama = "*"
@@ -107,6 +108,7 @@ docs = [
 test = ["pytest", "pytest-rerunfailures", "pytest-mock", "pytest-watcher"]
 coverage = ["codecov", "coverage", "pytest-cov"]
 lint = [
+  "black",
   "ruff",
   "mypy",
   "types-colorama",