From f48b6bbb5eb7a26dbc74293e584847d2742f45bf Mon Sep 17 00:00:00 2001 From: Stefan Hynek <stefan.hynek@uni-goettingen.de> Date: Thu, 18 Nov 2021 14:08:01 +0100 Subject: [PATCH] docs(readme): how to initialize pre-commit hooks --- README.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 45c65f3..293ea7c 100644 --- a/README.md +++ b/README.md @@ -3,9 +3,9 @@ ## Development 1. Prerequisites - - Python 3.8 - - Docker 20.10 - - Docker Compose 1.25 + - Python > 3.8 + - Docker > 20.10 + - Docker Compose > 1.25 1. Create/activate virtual environment (ensure you use the correct python version!). ```sh @@ -51,3 +51,11 @@ Style constraints: Coding constraints: - Objects that are not supposed to be used outside the current scope MUST be named starting with `_` (underscore): [PEP 316](https://www.python.org/dev/peps/pep-0316/#id12) + +For your convenience, pre-commit hooks are configured to check against these constraints. Provided, you have installed the development requirements (see above), activate `pre-commit` to run on every `git commit`: + +```sh +pre-commit install +``` + +Also, a helper with conventional commits is installed with the development requirements that you could leverage to easily comply with it. Just use `cz c` instead of `git commit` -- GitLab