NAME

       dunamai - Generate dynamic versions

SYNOPSIS

       dunamai [-h] {from,check} ...

       dunamai from [-h] {any,git,mercurial,darcs,...} ...

       dunamai check [-h] [--style {pep440,semver,pvp}] [version]

DESCRIPTION

       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

                                             May 2024                                  DUNAMAI(1)