knossos has various continuous-integration (CI) tests in place to ensure code quality and correctness, including formatting. The following tools may make it easier to comply with these checks locally before checking in code and failing the various CI tests. They are not automatically integrated into the workflow.
knossos uses black for formatting. Note we currently use the default black line length of 88. You may find the following settings useful. To use, copy them into .vscode/settings.json (don't commit them, they are covered by .gitignored) or your user settings:
"python.formatting.provider": "black",
"editor.formatOnSave": true,Pre-commit is a package manager for various git hooks that process files and can help with consistency and correctness. It is configured in .pre-commit-config.yaml . If any changes are made, you will need to re-stage the relevant files and try again.
Per-user, to setup, run
pip install --requirement .\requirements-dev.txt
pre-commit installUsually pre-commit will only be run on staged files. The first run will take a bit of time, but subsequent runs should be relatively fast.
You can apply pre-commit and hooks to all files using
pre-commit run --all-files