docs: add documentation about pre-commit

This commit is contained in:
Mike Salvatore 2021-04-05 12:14:49 -04:00
parent 4966aaf213
commit c1d4c7a0d2
1 changed files with 20 additions and 1 deletions

View File

@ -63,3 +63,22 @@ After the `deploy_linux.sh` script completes, you can start the monkey island.
cd infection_monkey/monkey
./monkey_island/linux/run.sh
```
## Pre-commit hooks
Both the Linux and Windows deployment scrips will install and configure
[pre-commit](https://pre-commit.com/). Pre-commit is a multi-language package
manager for pre-commit hooks. It will run a set of checks when you attempt to
commit. If your commit does not pass all checks, it will be reformatted and/or
you'll be given a list of errors and warnings that need to be fixed before you
can commit.
Our CI system runs the same checks when when pull requests are submitted. This
system may report that the build has failed if the pre-commit hooks have not
been run or all issues have not been resolved.
### Manually installing pre-commit
To install and configure pre-commit manually, run `pip install --user
pre-commit`. Next, go to the top level directory of this repository and run
`pre-commit install` Now, pre-commit will automatically run whenever you `git commit`.