dunamai1
Generate dynamic versions
Usage
dunamai [-h]
from,check ...
dunamai from
[-h]
any,git,mercurial,darcs, ... ...
dunamai check
[-h]
[--style
pep440,semver,pvp]
[version]
Overview
Dunamai is a Python library and command line tool for producing dynamic, standards-compliant version strings, derived from tags in your version control system. This facilitates uniquely identifying nightly or per-commit builds in continuous integration and releasing new versions of your software simply by creating a tag.
Use dunamai from <VCS> to generate a version string from a particular VCS or use any to autodetect.
Use dunamai check <version> check if a version is valid for a style.
Examples
Get supported VCS:
-
$ dunamai from -h
Get full help for from command:
-
$ dunamai from any -h
Get version from any VCS:
-
$ dunamai from any
Get version from git, fail when there are no tags:
-
$ dunamai from git --strict
Get help for check command including supported styles:
-
$ dunamai check -h
Check if a version is valid according to PEP 440:
-
$ dunamai check 1.2.3
Check if a version is valid according to Semantic Versioning (SemVer):
-
$ dunamai check --style semver 1.2.3
Check if a version is valid according to Haskell Package Version Policy (PVP) using a pipe:
-
$ echo 1.2.3 | dunamai check --style pvp