oam/knowledge base/pre-commit.md

Pre-commit

Table of contents

1. TL;DR
2. Troubleshooting
   1. Some files are skipped during a run
3. Further readings

TL;DR

# Generate a very basic configuration.
pre-commit sample-config > .pre-commit-config.yaml

# Manually run checks.
pre-commit run --all-files
pre-commit run "ansible-lint" --files "ansible/"

# Automatically run checks at every commit.
pre-commit install

# Update all hooks to the latest version available.
# It is *not* always the latest *stable* release.
pre-commit autoupdate

# Skip check on commit.
SKIP="check_id" git commit -m "foo"
git commit --no-verify -m "foo"

Config file example.

Troubleshooting

Some files are skipped during a run

Check they are tracked (have been added to the repository).

Further readings

• Pre-commit's website
• List of supported hooks