Skip to main content

metapensiero.tool.bump_version

A simple tool to bump version number of a Python package

author:

Lele Gaifax

contact:

lele@metapensiero.it

license:

GNU General Public License version 3 or later

This is a very simple tool that I use to automatize the management of the version.txt file I usually put in my Python packages. There are tons of equivalent tools around, but none of them fullfilled my needs.

It uses the package Versio to handle different versioning schemas, with an additional simple2 scheme for versions composed simply by major.minor numbers.

Examples:

$ echo "0.0" > version.txt
$ bump_version --dry-run
Old version: 0.0
New version: 0.1

$ bump_version -n --field major
Old version: 0.0
New version: 1.0

$ echo "0.0.0.0" > version.txt
$ bump_version -f minor --scheme simple4
$ cat version.txt
0.1.0.0

$ echo "0.9" > version.txt
$ bump_version -n -f release --index 1 -s pep440
Old version: 0.9
New version: 0.10

$ bump_version -f release -i 1 -s pep440
$ cat version.txt
0.10

$ bump_version -n -f pre -i 1 -s pep440
Old version: 0.10
New version: 0.10a1

$ bump_version -n -f post -i 1 -s pep440
Old version: 0.10
New version: 0.10.post1

$ bump_version -f post -i 1 -s pep440
$ bump_version -n -f dev -i 1 -s pep440
Old version: 0.10.post1
New version: 0.10.post1.dev1

The version scheme is by default automatically determined from current version (just simple versions though):

$ echo "1.0" > version.txt
$ bump_version -n
Old version: 1.0
New version: 1.1

$ echo "1.0.0" > version.txt
$ bump_version -n
Old version: 1.0.0
New version: 1.0.1

$ echo "1.0.0.0" > version.txt
$ bump_version -n
Old version: 1.0.0.0
New version: 1.0.0.1

The current version may not exist yet, but obviously you must specify the right schema:

$ rm -f version.txt
$ bump_version -n -s simple2
Old version: 0.0
New version: 0.1

$ bump_version -s simple3
$ cat version.txt
0.0.1

Changes

1.3 (2017-03-22)

  • Minor adjustments to take off the dust

1.2 (2016-03-23)

  • New option to automatically select the versioning schema, when one exists

  • New simple test suite

1.1 (2015-09-09)

  • Properly include needed sources in the distribution

1.0 (2015-08-09)

  • Reimport from metapensiero.extjs.desktop

Metadata

Release files for metapensiero.tool.bump_version 1.3

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

Source distribution (sdist)

Source distribution for metapensiero.tool.bump_version 1.3
File Size Uploaded Provenance Actions
metapensiero.tool.bump_version-1.3.tar.gz 5.7 kB Without provenance Details for metapensiero.tool.bump_version-1.3.tar.gz

Release files / metapensiero.tool.bump_version-1.3.tar.gz

Download URL metapensiero.tool.bump_version-1.3.tar.gz
Size 5.7 kB
Tags Source
SHA-256 checksum
How to use checksums
5d63435430b8786188cf48694b7d1d6de61da09221c66bf81b4c29fd9ac46b2b
BLAKE2b-256 checksum
How to use checksums
e312f88b5aa35fd413de44b57e1ede3066ce87d23a420ded841e2793cd2d4880
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for metapensiero.tool.bump_version 1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page