Skip to content

Publish releases to PyPI, and fix the README on the PyPI page - #90

Merged
mmshad merged 2 commits into
mainfrom
release-workflow-and-pypi-readme
Aug 5, 2026
Merged

Publish releases to PyPI, and fix the README on the PyPI page#90
mmshad merged 2 commits into
mainfrom
release-workflow-and-pypi-readme

Conversation

@mmshad

@mmshad mmshad commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Two things left over from the 0.1.0 upload.

Release workflow:

  • publishes to PyPI when a GitHub release is published
  • trusted publishing through OIDC, so no API token is stored
  • refuses to publish unless the tag matches the version in pyproject.toml
  • runs the tests before it builds
  • gated on a pypi environment, so a run waits for a reviewer

Two steps are needed once this is merged, both outside the repo: register the trusted publisher on PyPI (owner KempnerInstitute, repo clustertool, workflow release.yml, environment pypi), and add required reviewers to the pypi environment.

README on PyPI:

  • the logo and the flow diagram pointed at relative paths, which PyPI resolves against pypi.org and so shows as broken images
  • PyPI does not render a mermaid fence, so the diagram appeared as its own source text
  • both pictures now use absolute URLs, and the flow ships as an SVG in _static, dark and light
  • the install line leads with the tui extra, which is what most people want
  • a PyPI version badge

Checked with readme_renderer, the library PyPI itself uses: no image resolves relative any more, and no mermaid source is left in the page. The new page reaches PyPI with the next release, since a description cannot be edited after upload.

Also worth knowing: the docs links in the README are still relative, so they lead nowhere from the PyPI page. Left alone for now, since that is every section of the file.

mmshad added 2 commits August 5, 2026 18:16
Trusted publishing, so no token is stored. The job checks the tag
against the version in pyproject.toml, runs the tests, then builds and
uploads.
PyPI resolves a relative image path against pypi.org, so both logos
404 there, and it prints a mermaid fence as source text. Point the
pictures at absolute URLs and ship the flow as an SVG. The install
line now leads with the tui extra.
@mmshad
mmshad merged commit f1c6bf0 into main Aug 5, 2026
7 checks passed
@mmshad
mmshad deleted the release-workflow-and-pypi-readme branch August 5, 2026 22:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant