Tool for version tag update
Project description
[![Build Status](https://travis-ci.org/simontorres/simple-version-manager.svg?branch=master)](https://travis-ci.org/simontorres/simple-version-manager) [![Coverage Status](https://coveralls.io/repos/github/simontorres/simple-version-manager/badge.svg?branch=master)](https://coveralls.io/github/simontorres/simple-version-manager?branch=master) # Simplify version management
The idea behind the development of this small tool is to simplify the process of increasing your version number. It is designed to work with a specific format explained below.
## Version format supported
There are countless ways of handling your versions and there is no _right_ or _wrong_ way. The format I choose is the following:
` major.minor.patch.devN `
Some examples in no particular order
` 0.0.1 1.1.1.dev1 30.1.1.dev5 `
## Usage Please note that this will depend on the size of your team and complexity of the project. Either way if the team is large there will be a manager that should control when the version is updated so in principle is the same for a large or even a one-person team. Here are some examples:
You should use this program with –dev argument right after you pulled the latest changes from upstream
You can use –patch, –minor or –major in combination with –release when you want to create a new release.
Also you have the freedom of updating any of the fields independently
## Options The argument options are better explained with examples. Let’s say we currently are working on version 1.2.3.dev4
--dev will increase the development version by one leaving you with 1.2.3.dev5
--patch will give you 1.2.4.dev1 notice that the development version is dropped back to one
--minor will change the version to 1.3.0.dev1 notice now that not only _dev_ is dropped to one but also the patch count drops to zero.
--major will change version to 2.0.0.dev1 which is the same as –minor plus dropping _minor_ to zero.
--release will remove the devN part leaving you with 1.2.3. –release can be used in combination of other options.
--set Let you set the version to any value.
If you start from a _stable_ version like 2.0.0 you should use the –dev argument that will increase the patch number and add the _dev1_ string. 2.0.1.dev1
# References
[distutils.version.LooseVersion](http://epydoc.sourceforge.net/stdlib/distutils.version.LooseVersion-class.html)
[Semantic Version](https://semver.org/) (Not used here but a good reference on version numbering)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file simple_version_manager-0.1.0.tar.gz
.
File metadata
- Download URL: simple_version_manager-0.1.0.tar.gz
- Upload date:
- Size: 4.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.5.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 58659d510ce6ce945d69b4ab5279e9f3e800d1b16779bd2ba041fb5a4dfdf88b |
|
MD5 | 4a820e010e366755a1dc0867439e922c |
|
BLAKE2b-256 | 0142325be471b5cf8c2dbcad797c3fbdedbe3d28eec808ae3c713723de96395f |
File details
Details for the file simple_version_manager-0.1.0-py3-none-any.whl
.
File metadata
- Download URL: simple_version_manager-0.1.0-py3-none-any.whl
- Upload date:
- Size: 11.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.5.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d15ad224a3e40b6852678249dcd468b98e9b8f43fe2499ffed555de3669f24ca |
|
MD5 | eae377e2e790336770d64f9669e65e11 |
|
BLAKE2b-256 | 589b8f51beffe23a8d900c8107b057eabeaaffc00106606f41507054a923accf |