From 9f1bde4ebd57a901ca56e98fca08cf8168bccf86 Mon Sep 17 00:00:00 2001 From: Jan Beran Date: Fri, 26 Jan 2024 13:35:11 +0100 Subject: [PATCH] docs(esptool): Reflect change from flake8 and black to ruff --- CONTRIBUTING.rst | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 6b9d5536e..e15518f9f 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -85,24 +85,22 @@ To use the tool, first install ``pre-commit``. Then enable the ``pre-commit`` an $ python -m pip install pre-commit $ pre-commit install -t pre-commit -t commit-msg -On the first commit ``pre-commit`` will install the hooks, subsequent checks will be significantly faster. If an error is found an appropriate error message will be displayed. If the error was with ``black`` then the tool will fix them for you automatically. Review the changes and re-stage for commit if you are happy with them. +On the first commit ``pre-commit`` will install the hooks, subsequent checks will be significantly faster. If an error is found an appropriate error message will be displayed. Review the changes and re-stage for commit if you are happy with them. Conventional Commits """""""""""""""""""" ``esptool.py`` complies with the `Conventional Commits standard `_. Every commit message is checked with `Conventional Precommit Linter `_, ensuring it adheres to the standard. -Flake8 -"""""" -``esptool.py`` complies with `flake8 `_ style guide enforcement. +Ruff +"""" -Black -""""" +``esptool.py`` is `PEP8 ` compliant and enforces this style guide. For compliancy checking, we use `ruff `. +``Ruff`` also auto-format files in the same style as previously used ``black``. -All files should be formatted using the `Black `_ auto-formatter. -``Black``, ``flake8``, and ``Conventional Precommit Linter`` tools will be automatically run by ``pre-commit`` if that is configured. To check your code manually before submitting, run ``python -m flake8`` and ``black .`` (the tools are installed as part of the development requirements shown at the beginning of this document). +``Ruff`` and ``Conventional Precommit Linter`` tools will be automatically run by ``pre-commit`` if that is configured. To check your code manually before submitting, run ``python -m ruff`` (this tool is installed as part of the development requirements shown at the beginning of this document). When you submit a Pull Request, the GitHub Actions automated build system will run automated checks using these tools.