Releasing

Version is defined in pyproject.toml ([project] version).

Build artifacts

uv build

Produces dist/*.whl and dist/*.tar.gz.

PyPI

The repository includes a GitHub Actions workflow that publishes on release published events (trusted publishing to PyPI). See .github/workflows/publish.yml for the exact steps (uv build + pypa/gh-action-pypi-publish).

Before tagging a release:

  • Run the full test suite and doc build.

  • Update CHANGELOG or release notes under docs/release/ if you maintain them.

  • Ensure PYPI.md (used as the package long description) matches user-facing messaging.

Documentation

Hosted docs may live on thundergraph.ai or another site; this Sphinx tree is the source for building HTML locally or in CI.