Skip to content

Code Standards

The Python code in the tests subdirectory ./tests must fulfill the following checks:

Command Explanation
1 ruff check tests Python lint, format and imports check.
2 mypy tests Objects that provide typehints pass type-checking via mypy.
3 fill All tests must execute correctly.
4 mkdocs build --strict Documentation generated without warnings.
5 pyspelling Markdown spell-check.
6 markdownlint-cli2 Markdown lint check.

While this seems like a long list, a correctly configured editor (see VS Code Setup) essentially assures that all points are mostly covered.

Additionally, if you skip type hints, they won't be checked; we can help you add these in the PR.

These checks must pass in order for the execution-spec-tests Github Actions to pass upon pushing to remote.

Running the checks with tox

All these checks can be executed locally in a single command, tox, see Verifying Changes.

If you need help, get in touch!