repomatic.versions module

PEP 440 version primitives, shared by the whole package.

Every version this package reads comes from somewhere it does not control (a lock file, a package index, a git tag), so parsing has to tolerate junk, and nearly every module compares or normalizes versions somewhere. These helpers used to live in repomatic.release.version_sync, whose import graph reaches the GitHub, PyPI and npm clients: the modules below it in that graph each kept a private two-line copy of the parse rather than close a cycle. A leaf module with no dependency beyond packaging is what lets everyone import the one copy.

repomatic.versions.BUMP_PARTS = ('minor', 'major')

The version parts a bump-version job may propose.

The changelog.yaml bump matrix runs one job per entry, and is_version_bump_allowed() gates each against the last release. A patch bump is absent by design: the post-release commit already writes the next .dev0 floor, so nothing has to propose one.

repomatic.versions.DEV_SUFFIX_RE = re.compile('\\.dev\\d*$')

Match the trailing PEP 440 developmental-release segment of a version.

repomatic.versions.safe_version(value)

Parse a PEP 440 version, returning None for anything unparsable.

Collapsing the try/except InvalidVersion into one helper keeps the callers reading as the filters they are.

Parameters:

value (str) – A version string.

Return type:

Version | None

Returns:

The parsed Version, or None when value is empty or not PEP 440.

repomatic.versions.is_newer(new, old)

Return True when new is a strictly higher version than old.

Unparsable versions compare as not-newer, so a malformed candidate never triggers a bump.

Return type:

bool

repomatic.versions.strip_dev_suffix(version)

Drop any PEP 440 .devN segment from version.

"5.10.0.dev0" becomes "5.10.0". A version carrying no developmental segment is returned unchanged, so the call is safe to apply blindly.

Return type:

str