Contributing
Contributions are welcome, from typo fixes to new labs.
Report an issue
Open an issue on GitHub with the lab name, the command you ran, what you expected, and what happened. For a check that misses something or fires wrongly, include a synthetic input that reproduces it.
Improve a lab
- Fork the repository and create a branch.
- Make your change, and add or update a test in
tests/test_labs.py. - Run
python3 -m unittest discover -s tests -vand confirm everything passes. - Update the lab’s
README.mdif behaviour changes. - Open a pull request that explains what the change teaches or fixes.
Propose a new lab
New labs follow the same conventions as the existing ones:
- Package layout:
labs/<lab_name>/with__init__.py, a guide (README.md), one runnable script, and a synthetic fixture. - Runnable as a module:
python3 -m labs.<lab_name>.<script>, reading the bundled fixture by default and accepting a path to the learner’s own copy. - Standard library only: no third-party dependencies.
- Local and synthetic: no external network calls, no real data, no payloads.
- Guide structure: Why it matters, Exercise, honest limitations, and a one-line Takeaway.
- Tests: at least one test that shows the check firing, and one that shows it staying quiet on a safe input.
Open an issue describing the skill the lab teaches before you start, so we can agree on scope.