Skip to content

bumpversion.versioning.conventions ​

Standard version conventions.

PEP440_PATTERN ​

python
PEP440_PATTERN = '\n    v?\n    (?:\n        (?P<major>0|[1-9]\\d*)\\.\n        (?P<minor>0|[1-9]\\d*)\\.\n        (?P<patch>0|[1-9]\\d*)\n        (?:                                          # pre-release\n            [-_\\.]?\n            (?P<pre>\n                (?P<pre_l>a|b|c|rc|alpha|beta|pre|preview)\n                [-_\\.]?\n                (?P<pre_n>[0-9]+)?\n            )\n        )?\n        (?:                                          # post release\n            [-_\\.]?\n            (?P<post>\n                post\n                [-_\\.]?\n                [0-9]+\n            )\n        )?\n        (?:                                          # dev release\n            [-_\\.]?\n            (?P<dev>\n                dev\n                [-_\\.]?\n                [0-9]+\n            )\n        )?\n    )\n    (?:\\+(?P<local>[a-z0-9]+(?:[-_\\.][a-z0-9]+)*))?   # local version\n'

PEP440_SERIALIZE_PATTERNS ​

python
PEP440_SERIALIZE_PATTERNS = ['{major}.{minor}.{patch}{pre_l}{pre_n}.{post}.{dev}+{local}', '{major}.{minor}.{patch}{pre_l}{pre_n}.{post}.{dev}', '{major}.{minor}.{patch}{pre_l}{pre_n}.{post}+{local}', '{major}.{minor}.{patch}{pre_l}{pre_n}.{dev}+{local}', '{major}.{minor}.{patch}.{post}.{dev}+{local}', '{major}.{minor}.{patch}{pre_l}{pre_n}.{post}', '{major}.{minor}.{patch}{pre_l}{pre_n}.{dev}', '{major}.{minor}.{patch}{pre_l}{pre_n}+{local}', '{major}.{minor}.{patch}.{post}.{dev}', '{major}.{minor}.{patch}.{post}+{local}', '{major}.{minor}.{patch}.{dev}+{local}', '{major}.{minor}.{patch}.{pre_l}{pre_n}', '{major}.{minor}.{patch}.{post}', '{major}.{minor}.{patch}.{dev}', '{major}.{minor}.{patch}+{local}', '{major}.{minor}.{patch}']

PEP440_COMPONENT_CONFIGS ​

python
PEP440_COMPONENT_CONFIGS = {'major': VersionComponentSpec(), 'minor': VersionComponentSpec(), 'patch': VersionComponentSpec(), 'pre_l': VersionComponentSpec(values=['', 'a', 'b', 'rc']), 'pre_n': VersionComponentSpec(), 'post': VersionComponentSpec(depends_on='patch'), 'dev': VersionComponentSpec(depends_on='patch'), 'local': VersionComponentSpec(depends_on='patch', optional_value='')}

pep440_version_spec ​

python
def pep440_version_spec() -> VersionSpec

Return a VersionSpec for PEP 440.

SEMVER_PATTERN ​

python
SEMVER_PATTERN = '\n    (?P<major>0|[1-9]\\d*)\\.\n    (?P<minor>0|[1-9]\\d*)\\.\n    (?P<patch>0|[1-9]\\d*)\n    (?:\n        -                             # dash separator for pre-release section\n        (?P<pre_l>[a-zA-Z-]+)         # pre-release label\n        (?P<pre_n>0|[1-9]\\d*)         # pre-release version number\n    )?                                # pre-release section is optional\n    (?:\n        \\+                            # plus separator for build metadata section\n        (?P<buildmetadata>\n            [0-9a-zA-Z-]+\n            (?:\\.[0-9a-zA-Z-]+)*\n        )\n    )?                                # build metadata section is optional\n'

SEMVER_SERIALIZE_PATTERNS ​

python
SEMVER_SERIALIZE_PATTERNS = ['{major}.{minor}.{patch}-{pre_l}{pre_n}+{buildmetadata}', '{major}.{minor}.{patch}-{pre_l}{pre_n}', '{major}.{minor}.{patch}+{buildmetadata}', '{major}.{minor}.{patch}']

SEMVER_COMPONENT_CONFIGS ​

python
SEMVER_COMPONENT_CONFIGS = {'major': VersionComponentSpec(), 'minor': VersionComponentSpec(), 'patch': VersionComponentSpec(), 'pre_l': VersionComponentSpec(values=['', 'a', 'b', 'rc']), 'pre_n': VersionComponentSpec(), 'buildmetadata': VersionComponentSpec(independent=True)}

semver_spec ​

python
def semver_spec() -> VersionSpec

Return a VersionSpec for SEMVER.