Contributing¶

The usual process to make a contribution is to:

1. Check for existing related issues
2. Fork the repository and create a new branch
3. Make your changes
4. Make sure formatting, linting and tests passes.
5. Add tests if possible to cover the lines you added.
6. Commit, and send a Pull Request.

Clone the repository¶

Clone the hatch repository, cd into it, and create a new branch for your contribution:

cd hatch
git checkout -b add-my-contribution

Run the tests¶

Run the test suite while developing:

hatch run dev

Run the test suite with coverage report:

hatch run cov

Run the extended test suite with coverage:

hatch run full

Lint¶

Run automated formatting:

hatch run lint:fmt

Run full linting and type checking:

hatch run lint:all

Docs¶

Start the documentation in development:

hatch run docs:serve

Build and validate the documentation website:

hatch run docs:build-check