troubleshooting.md

🛠️ Troubleshooting - Pre-commit Quality Gate Setup

Issue: Pre-commit command not found

If you are using the virtual environment, activate it first:

(venv) toor@ip-172-31-10-236:~/precommit-lab$ source venv/bin/activate
(venv) toor@ip-172-31-10-236:~/precommit-lab$

If you installed with --user in another setup, add the pip installation path to PATH:

(venv) toor@ip-172-31-10-236:~/precommit-lab$ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

(venv) toor@ip-172-31-10-236:~/precommit-lab$ source ~/.bashrc

Issue: Hooks not running on commit

(venv) toor@ip-172-31-10-236:~/precommit-lab$ pre-commit uninstall
pre-commit uninstalled

(venv) toor@ip-172-31-10-236:~/precommit-lab$ pre-commit install
pre-commit installed at .git/hooks/pre-commit

Issue: Black and Flake8 conflicts

Ensure .flake8 has extend-ignore = E203, W503 to avoid conflicts with Black formatting.

Issue: Bandit too strict

Adjust severity in .pre-commit-config.yaml:

args: ['-ll']  # Only report high severity issues

Issue: Slow hook execution

Run specific hooks only:

(venv) toor@ip-172-31-10-236:~/precommit-lab$ pre-commit run black --all-files
black....................................................................Passed

(venv) toor@ip-172-31-10-236:~/precommit-lab$ pre-commit run flake8 --all-files
flake8...................................................................Failed
- hook id: flake8
- exit code: 1

bad_code.py:2:5: F841 local variable 'password' is assigned to but never used

---