Releasing a new version of Dallinger¶
1. After you’ve merged the changes you want into master, start a new branch on which to run the version upgrade and update the CHANGELOG if that hasn’t been done as part of feature branch work.
We’re using semantic versioning, so there are three parts to the version number. when making a release you need to decide which parts should get bumped, which determines what command you give to bumpversion. major is for breaking changes, minor for features, patch for bug fixes.
Example: Running bumpversion patch, which will change every mention of the current version in the codebase and increase it by 0.0.1.
- Log your updates by editing the CHANGELOG.md, where you’ll link to your version’s tree using: https://github.com/dallinger/dallinger/tree/vX.X.X. Mark the PR with the release label.
- Merge this release with the commit “Release version X.X.X.”
- After that’s merged, you’ll want to tag the merge commit with git tag vX.X.X and do git push origin –tags. PyPI releases versions based on the tags via .travis.yml.
- If you are releasing an upgrade to an old version, revert the PyPI change and make it show the highest version number. We do this because PyPI shows the last updated version to be the latest version which may be incorrect.