Skip to content

RELEASING.md

Latest commit

 

History

History
29 lines (21 loc) · 909 Bytes

RELEASING.md

File metadata and controls

29 lines (21 loc) · 909 Bytes
Raw

Releasing

Releases are built and published from GitHub Actions with short-lived PyPI OIDC credentials. Do not add a PyPI token to the repository.

One-time PyPI setup

Before the first release, create a pending PyPI trusted publisher with these exact values:

  • PyPI project: brawsr
  • GitHub owner: brawsr
  • Repository: sdk-python
  • Workflow: publish.yml
  • Environment: pypi

The repository must be public before publishing so PyPI can attach public provenance to the release.

Release

  1. Update project.version and src/brawsr/_version.py together.
  2. Run the complete CI and package verification suite.
  3. Create a GitHub release whose tag is exactly v<project.version> and whose target commit is on main.

Publishing rejects prereleases, mismatched tags, commits outside main, wrong repository metadata, and artifacts that fail reproducibility or installation verification.