Skip to content

docs: add release process with CalVer versioning and PyPI publishing#27

Merged
eric-tramel merged 5 commits into
mainfrom
feat/release-process
Jan 12, 2026
Merged

docs: add release process with CalVer versioning and PyPI publishing#27
eric-tramel merged 5 commits into
mainfrom
feat/release-process

Conversation

@eric-tramel

Copy link
Copy Markdown
Owner

Summary

Add comprehensive release process documentation and GitHub Actions workflow for automated PyPI publishing using trusted publishers (OIDC).

  • Create RELEASE.md with CalVer versioning scheme (YYYY.MM.MICRO)
  • Add .github/workflows/release.yml for automated TestPyPI and PyPI publishing
  • Update version from 0.1.0 to 2025.1.0 (first CalVer version)

Changes

  • RELEASE.md: Complete release process documentation including:

    • CalVer versioning scheme explanation (YYYY.MM.MICRO)
    • Step-by-step release checklist
    • PyPI trusted publisher setup instructions
    • Rollback and recovery procedures
  • .github/workflows/release.yml: Automated release workflow that:

    • Triggers on git tag push (v*)
    • Runs full CI checks (lint, types, tests) before publishing
    • Builds distributions using hatchling
    • Publishes to TestPyPI first for validation
    • Publishes to PyPI using trusted publishers (OIDC)
  • pyproject.toml: Update version to first CalVer version 2025.1.0

  • CHANGELOG.md: Update to reference CalVer instead of SemVer

Testing

  • All CI checks pass (make ci)
  • Workflow YAML syntax validated
  • Documentation reviewed for completeness

Related


🤖 Generated with Claude Code

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3668883e40

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread pyproject.toml
eric-tramel and others added 5 commits January 12, 2026 01:28
Add comprehensive release process documentation and GitHub Actions workflow
for automated PyPI publishing using trusted publishers (OIDC).

- Add RELEASE.md with CalVer versioning scheme (YYYY.MM.MICRO)
- Add step-by-step release checklist and rollback procedures
- Add .github/workflows/release.yml for automated publishing
- Configure TestPyPI and PyPI trusted publisher workflow
- Update version from 0.1.0 to 2025.1.0 (first CalVer version)
- Update CHANGELOG.md to reference CalVer instead of SemVer

Closes #26

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The name "plait" is unavailable on PyPI, so we use "pyplait" as the
package name while keeping "plait" as the Python module name.

- pip install pyplait
- import plait

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Update README.md and docs/getting-started.md to reflect that the
package is published as 'pyplait' on PyPI while imported as 'plait'.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Use importlib.metadata.version() to dynamically get the version from
the installed package, avoiding the need to update two places on each
release.

Addresses reviewer feedback about __version__ being out of sync with
pyproject.toml.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@eric-tramel eric-tramel merged commit c4b0d4e into main Jan 12, 2026
4 checks passed
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.

docs: design release process with CalVer versioning and PyPI publishing

1 participant