First off, thanks for considering to contribute to this project!
These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
We use git hooks through pre-commit to enforce and automatically check some "rules". Please install them (pre-commit install) before to push any commit.
See the relevant configuration file: .pre-commit-config.yaml.
Make sure your code roughly follows PEP-8 and keeps things consistent with the rest of the code:
- docstrings: sphinx-style is used to write technical documentation.
- formatting: black is used to automatically format the code without debate.
- sorted imports: isort is used to sort imports
- static analisis: flake8 is used to catch some dizziness and keep the source code healthy.
ruff is also used to homogeneize rules and perform most of operations as quick as is "rust" possible.