Skip to content

releases.md

Latest commit

 

History

History
24 lines (19 loc) · 1.83 KB

releases.md

File metadata and controls

24 lines (19 loc) · 1.83 KB

Release Guide

This document explains the release process for the Python SDK. You can find the most recent version under Github Releases.

Before Release

  1. Before releasing a new SDK version, make sure to update all references from the old version to the new one. For example, the version in packages/pynumaflow/pyproject.toml should be updated (for reference)
    • Edit the version field in packages/pynumaflow/pyproject.toml directly (e.g., change version = "0.12.0" to version = "0.12.1"). The version must follow the PEP 440 specification
  2. If the version to be released has backwards incompatible changes, i.e. it does not support older versions of the Numaflow platform, you must update the MINIMUM_NUMAFLOW_VERSION constant in the pynumaflow/info/types.py file to the minimum Numaflow version that is supported by your new SDK version.
  3. After making these changes, create a PR and merge it.

How to Release

This can be done via the Github UI.

  1. In the Releases section of the Python SDK repo, click Draft a new release
  2. Create a tag that has the same name as the version that you specified in the root pyproject.toml, prefix it with a 'v', and select it
  3. Make the title the same as the tag
  4. Click Generate release notes so that all the changes made since the last release are documented. If there are any major features or breaking changes that you would like to highlight as part of the release, add those to the description as well
  5. Select Set as the latest release or Set as a pre-release, depending on your situation
  6. Finally, click Publish release, and your version tag will be the newest release on the repository