bump
====
Bumps package versions.
Example
=======
By default, running ``bump`` in a directory with a ``setup.py`` will bump the
"patch" number in place::
$ bump
1.0.1
$ git diff setup.py
─────────────────────────────────────────────────
modified: setup.py
─────────────────────────────────────────────────
@ setup.py:6 @ from setuptools import setup
setup(
name='bump',
- version='1.0.0',
+ version='1.0.1',
description='Bumps package version numbers',
long_description=open('README.rst').read(),
license='MIT',
Conveniently ``bump`` will also return the new version number, so you can use
it after running the command, for example::
$ export VERSION=`bump`
$ echo "The new version is $VERSION"
The new version is 1.0.1
Options
=======
The ``bump`` command can also bump the major or minor version numbers, or set
the pre-release identifier or local version segment::
$ bump --help
Usage: bump [OPTIONS] [INPUT] [OUTPUT]
Options:
-M, --major Bump major number. Ex.: 1.2.3 -> 2.2.3
-m, --minor Bump minor number. Ex.: 1.2.3 -> 1.3.3
-p, --patch Bump patch number. Ex.: 1.2.3 -> 1.2.4
-r, --reset Reset subversions. Ex.: Major bump from 1.2.3 will be 2.0.0
instead of 2.2.3
--pre TEXT Set the pre-release identifier
--local TEXT Set the local version segment
--canonicalize Canonicalize the new version
--help Show this message and exit.
The `--reset` option should be used alongside with minor or major bump.
You can configure these options by setting them in a ``.bump`` or ``setup.cfg``
configuration file as well, so you don't have to specify them every time::
$ cat .bump
[bump]
input = some_directory/__file__.py
minor = true
patch = false
reset = true
Raw data
{
"_id": null,
"home_page": "https://github.com/di/bump",
"name": "bump",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "bump increment package version",
"author": "Mark Steve Samson",
"author_email": "hello@marksteve.com",
"download_url": "https://files.pythonhosted.org/packages/83/96/d956d4a71d58c5149069395980ed5fc6c0eb50b7eff994b2b1b6ab0a70b0/bump-1.3.2.tar.gz",
"platform": null,
"description": "bump\n====\n\nBumps package versions.\n\nExample\n=======\n\nBy default, running ``bump`` in a directory with a ``setup.py`` will bump the\n\"patch\" number in place::\n\n $ bump\n 1.0.1\n $ git diff setup.py\n \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n modified: setup.py\n \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n @ setup.py:6 @ from setuptools import setup\n\n setup(\n name='bump',\n - version='1.0.0',\n + version='1.0.1',\n description='Bumps package version numbers',\n long_description=open('README.rst').read(),\n license='MIT',\n\nConveniently ``bump`` will also return the new version number, so you can use\nit after running the command, for example::\n\n $ export VERSION=`bump`\n $ echo \"The new version is $VERSION\"\n The new version is 1.0.1\n\nOptions\n=======\n\nThe ``bump`` command can also bump the major or minor version numbers, or set\nthe pre-release identifier or local version segment::\n\n $ bump --help\n Usage: bump [OPTIONS] [INPUT] [OUTPUT]\n\n Options:\n -M, --major Bump major number. Ex.: 1.2.3 -> 2.2.3\n -m, --minor Bump minor number. Ex.: 1.2.3 -> 1.3.3\n -p, --patch Bump patch number. Ex.: 1.2.3 -> 1.2.4\n -r, --reset Reset subversions. Ex.: Major bump from 1.2.3 will be 2.0.0\n instead of 2.2.3\n --pre TEXT Set the pre-release identifier\n --local TEXT Set the local version segment\n --canonicalize Canonicalize the new version\n --help Show this message and exit.\n\nThe `--reset` option should be used alongside with minor or major bump.\n\nYou can configure these options by setting them in a ``.bump`` or ``setup.cfg``\nconfiguration file as well, so you don't have to specify them every time::\n\n $ cat .bump\n [bump]\n input = some_directory/__file__.py\n minor = true\n patch = false\n reset = true\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Bumps package version numbers",
"version": "1.3.2",
"project_urls": {
"Homepage": "https://github.com/di/bump"
},
"split_keywords": [
"bump",
"increment",
"package",
"version"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e9359fc2abc6030b496531cbeb88c1758fb9b1b13f2df3195730552f31c816f3",
"md5": "f593e8a41224114064ce7dc9364fb589",
"sha256": "fe4574252e91bbfb8768c12ccef67f5a3bd1be7d3e932631695299425f445ed9"
},
"downloads": -1,
"filename": "bump-1.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f593e8a41224114064ce7dc9364fb589",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 4054,
"upload_time": "2022-05-12T20:04:45",
"upload_time_iso_8601": "2022-05-12T20:04:45.033799Z",
"url": "https://files.pythonhosted.org/packages/e9/35/9fc2abc6030b496531cbeb88c1758fb9b1b13f2df3195730552f31c816f3/bump-1.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8396d956d4a71d58c5149069395980ed5fc6c0eb50b7eff994b2b1b6ab0a70b0",
"md5": "2ae07fbd49045aaa66c7308609f9bd9f",
"sha256": "f42e1c7759515937abeab153cbad53ddc8a5008be6553518cbd10faabf500b09"
},
"downloads": -1,
"filename": "bump-1.3.2.tar.gz",
"has_sig": false,
"md5_digest": "2ae07fbd49045aaa66c7308609f9bd9f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 3767,
"upload_time": "2022-05-12T20:04:46",
"upload_time_iso_8601": "2022-05-12T20:04:46.199641Z",
"url": "https://files.pythonhosted.org/packages/83/96/d956d4a71d58c5149069395980ed5fc6c0eb50b7eff994b2b1b6ab0a70b0/bump-1.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-05-12 20:04:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "di",
"github_project": "bump",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "bump"
}
JSON
