Contributing

Contributions (pull requests) are very welcome! Here's how to get started.

Getting started

First fork the library on GitHub.

Then clone and install the library in development mode:

git clone https://github.com/your-username-here/equinox.git
cd equinox
pip install -e .

Then install the pre-commit hooks:

pip install pre-commit
pre-commit install

These hooks use ruff to format and lint the code, and pyright to typecheck it.

If you're making changes to the code:

Now make your changes. Make sure to include additional tests if necessary.

Next verify the tests all pass:

pip install pytest
pytest

Then push your changes back to your fork of the repository:

git push

Finally, open a pull request on GitHub!

If you're making changes to the documentation:

Make your changes. You can then build the documentation by doing

pip install -r docs/requirements.txt
mkdocs serve

Then doing Control-C, and running:

mkdocs serve

(So you run mkdocs serve twice.)

You can then see your local copy of the documentation by navigating to localhost:8000 in a web browser.

Provide feedback