ci!: Add ruff, replacing isort, black, flake8 and its plugins

See also:
- https://ruff.rs/
- https://beta.ruff.rs/
- https://github.com/charliermarsh/ruff

Author: tony

.github/workflows/tests.yml

@@ -56,8 +56,8 @@ jobs:
       run: |
         poetry install -E "test coverage lint"
 
-    - name: Lint with flake8
-      run: poetry run flake8
+    - name: Lint with ruff .
+      run: poetry run ruff .
 
     - name: Lint with mypy
       run: poetry run mypy .

Makefile

@@ -11,12 +11,6 @@ entr_warn:
 	@echo "See https://eradman.com/entrproject/                      "
 	@echo "----------------------------------------------------------"
 
-isort:
-	poetry run isort `${PY_FILES}`
-
-black:
-	poetry run black `${PY_FILES}`
-
 test:
 	poetry run py.test $(test)
 
@@ -44,11 +38,11 @@ start_docs:
 design_docs:
 	$(MAKE) -C docs design
 
-flake8:
-	poetry run flake8
+ruff:
+	poetry run ruff .
 
-watch_flake8:
-	if command -v entr > /dev/null; then ${PY_FILES} | entr -c $(MAKE) flake8; else $(MAKE) flake8 entr_warn; fi
+watch_ruff:
+	if command -v entr > /dev/null; then ${PY_FILES} | entr -c $(MAKE) ruff; else $(MAKE) ruff entr_warn; fi
 
 mypy:
 	poetry run mypy `${PY_FILES}`

docs/developing.md

@@ -329,63 +329,56 @@ this will load the `.tmuxp.yaml` in the root of the project.
 
 ## Formatting
 
-The project uses [black] and [isort] (one after the other). Configurations are in `pyproject.toml`
-and `setup.cfg`:
+### ruff
 
-- `make black isort`: Run `black` first, then `isort` to handle import nuances
-
-## Linting
-
-[flake8] and [mypy] run via CI in our GitHub Actions. See the configuration in `pyproject.toml` and
-`setup.cfg`.
-
-### flake8
-
-[flake8] provides fast, reliable, barebones styling and linting.
+The project uses [ruff] to handles formatting, sorting imports and linting.
 
 ````{tab} Command
 
 poetry:
 
 ```console
-$ poetry run flake8
+$ poetry run ruff
 ```
 
 If you setup manually:
 
 ```console
-$ flake8
+$ ruff .
 ```
 
 ````
 
 ````{tab} make
 
 ```console
-$ make flake8
+$ make ruff
 ```
 
 ````
 
 ````{tab} Watch
 
 ```console
-$ make watch_flake8
+$ make watch_ruff
 ```
 
 requires [`entr(1)`].
 
 ````
 
-````{tab} Configuration
+````{tab} Fix files
+
+poetry:
 
-See `[flake8]` in setup.cfg.
+```console
+$ poetry run ruff . --fix
+```
 
-```{literalinclude} ../setup.cfg
-:language: ini
-:start-at: "[flake8]"
-:end-before: "[isort]"
+If you setup manually:
 
+```console
+$ ruff . --fix
 ```
 
 ````
@@ -443,9 +436,7 @@ the [gh build site].
 [py.test usage argument]: https://pytest.org/latest/usage.html
 [entr]: http://entrproject.org/
 [`entr(1)`]: http://entrproject.org/
-[black]: https://github.com/psf/black
-[isort]: https://pypi.org/project/isort/
-[flake8]: https://flake8.pycqa.org/
+[ruff]: https://ruff.rs
 [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