diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml new file mode 100644 index 0000000..ddc5f9b --- /dev/null +++ b/.pre-commit-config.yaml @@ -0,0 +1,22 @@ +exclude: ".venv|__pycache__|tests/dev/|tests/fixtures/" +fail_fast: false +repos: + - repo: https://github.com/pre-commit/pre-commit-hooks + rev: v4.4.0 + hooks: + - id: check-added-large-files + args: ["--maxkb=1024"] + - id: check-ast + - id: check-builtin-literals + - id: check-case-conflict + - id: check-toml + - id: check-yaml + - id: detect-private-key + - id: end-of-file-fixer + - id: fix-byte-order-marker + - id: fix-encoding-pragma + args: [--remove] + - id: name-tests-test + args: [--pytest-test-first] + - id: trailing-whitespace + args: [--markdown-linebreak-ext=md] diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..02aa3bf --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,11 @@ +# Directives de contribution + +Tout d'abord, merci d'envisager de contribuer à ce projet ! + +Il s'agit principalement de lignes directrices, et non de règles. Faites preuve de discernement, et n'hésitez pas à proposer des modifications à ce document dans une pull request. + +## Git hooks + +Nous utilisons les git hooks via [pre-commit](https://pre-commit.com/) pour appliquer et vérifier automatiquement certaines "règles". Veuillez l'installer avant de pousser un commit. + +Voir le fichier de configuration correspondant : `.pre-commit-config.yaml`. diff --git a/README.md b/README.md index 159c85e..b4399ba 100644 --- a/README.md +++ b/README.md @@ -34,6 +34,16 @@ except Exception as exc: Plus d'exemple dans la documentation développeur. +## Contribuer + +* Installer les dépendances de développement : + + ```sh + python3 -m pip install -e[dev] + ``` + +* Consulter les [directives de contribution](./CONTRIBUTING.md) + ## Compiler la librairie ```sh