bumpr

Bump’R is a version bumper and releaser allowing in a single command:

Clean-up release artifact
Bump version and tag it
Build a source distribution and upload on PyPI
Update version for a new development cycle

Bump’R intend to be customizable with the following features:

Optionnal test suite run before bump
Customizable with a config file
Overridable by command line
Extensible with hooks

Compatibility

Bump’R requires Python 2.6+

Installation

You can install Bump’R with pip:

$ pip install bumpr

or with easy_install:

$ easy_install bumpr

Usage

You can use directly the command line to setup every parameter:

$ bumpr fake/__init__.py README.rst -M -ps dev

But Bump’R is designed to work with a configuration file (bumpr.rc by defaults). Some features are only availables with the configuration file like:

commit message customization
hooks configuration
multiline test, clean and publish commands

Here’s an exemple:

[bumpr]
file = fake/__init__.py
vcs = git
tests = tox
publish = python setup.py sdist register upload
clean =
    python setup.py clean
    rm -rf *egg-info build dist
files = README.rst

[bump]
unsuffix = true
message = Bump version {version}

[prepare]
suffix = dev
message = Prepare version {version} for next development cycle

[changelog]
file = CHANGELOG.rst
bump = {version} ({date:%Y-%m-%d})
prepare = In development

[readthedoc]
id = fake

This way you only have to specify which part you want to bump on the command line:

$ bumpr -M  # Bump the major
$ bumpr     # Bump the default part aka. patch

Documentation

The documentation is hosted on Read the Docs

Changelog

0.3.1 (2017-01-08)

Ensure push is executed
Fix boolean parsing
Fix error handling on version extraction

0.3.0 (2017-01-08)

Support seprator omission in changelog (for markdown)
Add readthedoc badge support.
Breaking Use https and readthedocs.io as default
setup.cfg declaration support
Optionnal bumpr: prefix support
Switch to pytest

0.2.1 (2015-11-21)

Use nosetests instead of custom discovery
Some fixes on Python 3 (mostly encodings)
Improve error handling
Validate configuration

0.2.0 (2013-08-24)

colored diff
Added --bump and --prepare to only perform bump or prepare
Rely on VCS for tracking files and ensure working copy is clean
Added option --nocommit
Ensure dry run does not write or execute anything
Better output and error handling
Group parameters in help
Added optionnal hook vaidation
Fix some Python incompatibilities (Python 2.6 and 3.X)
More documentation

0.1.0 (2013-08-22)

Initial release. Missing some parts but working!

Release files for bumpr 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bumpr 0.3.1
File	Size	Uploaded
bumpr-0.3.1.tar.gz	14.5 kB	Jan 8, 2017	Details

Built distribution (wheel)

Table of built distributions (wheels) for bumpr 0.3.1
File	Interpreter	ABI	Platform	Reset
bumpr-0.3.1-py2.py3-none-any.whl 16.5 kB Jan 8, 2017	Python 3, Python 2	none	any	Details

Total release size: 31.0 kB

Release files / bumpr-0.3.1.tar.gz

Download URL	bumpr-0.3.1.tar.gz
Size	14.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`dd9055da13959d4b36e0bda68659c8fb6c319828ab9fa4d77e8376300e52248d`
BLAKE2b-256 checksum How to use checksums	`2b61e7314d5d3095d3b9c3b5e9dcf9cb0581d9c0439a29c675ac8180c9e91722`
Upload date	Jan 8, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / bumpr-0.3.1-py2.py3-none-any.whl

Download URL	bumpr-0.3.1-py2.py3-none-any.whl
Size	16.5 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`0c99d7749e7f6684d3c6254c5a6bc81d8521c251e79719c472c0cc59ec477108`
BLAKE2b-256 checksum How to use checksums	`24642be17bfbcbaab80533b6767cf63597a5f20c6f6ff1b9d7454ad65923d7a8`
Upload date	Jan 8, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No