manage your versioning like a boss

• keybump is an opinionated command-line app to manage versioning workflow + dist + releasing
• keybump makes following the semantic versioning specification a breeze
• keybump helps to automate the tedious task of summarizing changes from one version to the next by intelligently parsing the commit messages

master
develop

links:

• homepage
• source
• python-package
• changelog
• github-issues
• travis-ci
• semantic versioning specification

development + testing done on the following configuration:

• macosx 10.7.6
• python 2.7.4

keybump requires the following in order to run properly:

• python >= 2.5
• git >= 1.8

check that the correct version of git + python are installed

$ python --version $ git --version 

install keybump with pip

$ pip install keybump==3.0.1 

$ keybump [options] 

options:

--bump version bump type to increment. must be one of: major [x].x.x minor x.[x].x patch x.x.[x] --skip-interactive skips the script from using the interactive command line interface --skip-commit skips commiting any changes to the changelog file --skip-tag skips creating a git tag at the current HEAD --skip-push skips pushing to the remote origin --pypi-dist build the release and upload to the python package index --changelog-file path to a changelog history file --changelog-fmt string format of the changelog version summary --git-commit-fmt string format of the git commit message --git-tag-fmt string format of the git tag 

if called with no options, keybump will print the script's current git tag version.

normal usage

$ keybump --bump patch 

if called with no options, keybump will print the script's current project's information:

$ keybump 

use a /cc convention to call out people: screenshot

certain references are auto-linked:

• SHA : 16c999e8c71134401a78d4d46435517b2271d6ac
• User@SHA ref : mojombo@16c999e8c71134401a78d4d46435517b2271d6ac
• User/Project@SHA : mojombo/github-flavored-markdown@16c999e8...
• #Num : #1
• User/#Num : mojombo#1
• User/Project#Num : mojombo/github-flavored-markdown#1

lists can be turned into Task Lists by prefacing list items with:

• [ ] complete
• [x] incomplete

you can use any of the following keywords to close an issue via commit message:

• close
• closes
• closed
• fix
• fixes
• fixed
• resolve
• resolves
• resolved

note: referencing an issue number within the pull request title won't close it, the reference must be in a commit message, or the pull request body

• no built-in support for pre-release or build numbers
  • 1.0.0-alpha, 1.0.0-alpha.1, 1.0.0-0.3.7, 1.0.0-x.7.z.92
  • 1.0.0+build.1, 1.3.7+build.11.e0f985a
• doesn't check validity of user set versions

keybump is distributed under the MIT License