Releasing

​

One-time setup (per project, done once by a maintainer)

1. On PyPI, create the clousight-bench project (or claim it) and add a Trusted Publisher:
   • Owner: clousight
   • Repository: clousight-bench
   • Workflow: release.yml
   • Environment: pypi
2. In the GitHub repo settings, create an Environment named pypi (optionally with required reviewers for a manual approval gate before publish).

​

Cutting a release

1. Update CHANGELOG.md: move the Unreleased section under the new version with today’s date.
2. Bump version in pyproject.toml (single source of truth; the release workflow verifies the tag matches it).
3. Land those on main through a pull request.
4. Tag and push:
   git switch main && git pull
   git tag -s v0.2.0 -m "clousight-bench 0.2.0"   # tag must equal the pyproject version
   git push origin v0.2.0
   
5. The release workflow builds the sdist + wheel, runs twine check, and publishes to PyPI. Watch the Actions tab.
6. Create a GitHub Release from the tag and paste the changelog section.

​

Versioning