Skip to content

Releasing

PyPI is published only from a GitHub Release, never from a push or tag.

  1. Bump __version__ in tether/__init__.py (and the version assertion in tests/test_tether.py) and update docs/release-notes.md.
  2. Merge to main.
  3. Create a GitHub Release with tag v<version> (for example v0.1.0). The tag must match __version__ (a leading v is ignored) or the workflow fails before building.

The delivery.yml workflow then verifies the tag, builds the sdist and wheel, publishes to PyPI with trusted publishing (no secrets) and attaches both files to the release. Pre-releases are skipped: nothing is published or attached.

One-time setup (repository owner)

  • On PyPI (https://pypi.org/manage/account/publishing/), register a trusted publisher for tether-sdk:
  • PyPI Project Name: tether-sdk
  • Owner: igormcsouza
  • Repository name: tether
  • Workflow name: delivery.yml
  • Environment name: pypi
  • In the GitHub repository settings, the pypi environment and GitHub Pages (GitHub Actions workflow source) are already configured.