Contributor Guide

Making a Change

Tests are executed through tox.

tox

Code is formatted using ruff.

tox -e autoformat

When making a pull request you will need to create a news fragment to document your change. Release notes are managed through towncrier.

tox -e release_notes -- create --help

Release Process

This page documents the steps to be taken to release a new version of Sphinx AutoAPI.

Pre-Checks

  1. Check that the dependencies of the package are correct.

  2. Clean the .tox directory and run the tests.

  3. Commit and push any changes needed to make the tests pass.

  4. Check that the tests passed on github.

Preparation

  1. Update the version numbers in src/pathseq/__init__.py and pyproject.toml.

  2. Run tox -e release_notes -- build

  3. Commit and push the changes.

  4. Check that the tests passed on github.

Release

  1. Create a new release in github that tags the commit and uses the built release notes as the description.

The tag created by the release will trigger the github actions to build and upload the package to PyPI.