Home

Release process

Fetch the latest changes

After you've merged everything you'd like to include, please make sure you're up-to-date with upstream/main:

git checkout main
git fetch upstream
git reset --hard upstream/main

Release process

1. Copy the release notes: go to https://github.com/narwhals-dev/narwhals/releases, click "edit" on the latest (draft) release notes, copy all the content, and paste it somewhere. You'll need this later.
2. Make sure that bump-version branch doesn't appear in https://github.com/narwhals-dev/narwhals/branches - if it does, delete it.
3. Make a new bump-version branch: git checkout -b bump-version
4. Run python utils/bump_version.py patch. Replace 'patch' with either 'minor' or `'major', depending on by how much you want to bump the version.
5. Open a pull request, set its label to "release" and merge.
6. Go to the latest release in https://github.com/narwhals-dev/narwhals/releases, and paste in the release notes which you copied in step 1.
7. Delete the item related to the "bump version to" PR. If you set the label mentioned on step 5, this should not be needed.