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, 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. Delete the item related to the "bump version to" PR