README.rst

Semver <object data="https://img.shields.io/pypi/v/semver.svg" type="image/svg+xml">Latest version on PyPI</object>

Build status <object data="https://img.shields.io/pypi/pyversions/semver.svg" type="image/svg+xml">Python versions</object> <object data="https://img.shields.io/pypi/dm/semver.svg" type="image/svg+xml">Monthly downloads from PyPI</object> <object data="https://img.shields.io/pypi/l/semver.svg" type="image/svg+xml">Software license</object>

A Python module for semantic versioning. Simplifies comparing versions.

Usage

This module provides just couple of functions, main of which are:

>>> import semver
>>> semver.compare("1.0.0", "2.0.0")
-1
>>> semver.compare("2.0.0", "1.0.0")
1
>>> semver.compare("2.0.0", "2.0.0")
0
>>> semver.match("2.0.0", ">=1.0.0")
True
>>> semver.match("1.0.0", ">1.0.0")
False
>>> semver.format_version(3, 4, 5, 'pre.2', 'build.4')
'3.4.5-pre.2+build.4'
>>> semver.bump_major("3.4.5")
'4.0.0'
>>> semver.bump_minor("3.4.5")
'3.5.0'
>>> semver.bump_patch("3.4.5")
'3.4.6'
>>> semver.max_ver("1.0.0", "2.0.0")
'2.0.0'
>>> semver.min_ver("1.0.0", "2.0.0")
'1.0.0'

Installation

For Python 2:

pip install semver

For Python 3:

pip3 install semver