Code style¶

Nox or pre-commit performs automatic formatting and linting of the code.

Lint with nox¶

After successful setup, Nox sessions can be executed to perform lint checks:

nox -s lint

This runs ruff and codespell and fixes almost all formatting and linting problems automatically.

nox -R -s lint

nox -s pre_commit

Lint with pre-commit¶

Alternatively, use pre-commit to perform the same job. pre-commit hooks need to be installed:

pre-commit install

Now, each use of git commit in the shell will trigger actions defined in the .pre-commit-config.yaml file. pre-commit is easily deactivated with a similar command:

pre-commit uninstall

If you wish to run pre-commit asynchronously, use:

pre-commit run --all-files

Tools¶

Tools used in the Topwrap project for maintaining the code style:

• nox is a tool, which simplifies management of Python testing.

• pre-commit is a framework for managing and maintaining multi-language pre-commit hooks.

• ruff is a Python linter and code formatter.

• codespell is a Python tool to fix common spelling mistakes in text files