odatse.util.version module#

odatse.util.version.parse_version(version: str, ncomponents: int = 3) → tuple[source]#

Parse a dotted version string into a tuple of integers.

Intended for numeric comparison of package versions, where a plain string comparison is wrong (e.g. “1.10.0” < “1.2.0”) and a bare int() per component crashes on pre-release suffixes (e.g. “1.16.0rc1”).

Only the leading digits of each component are used; a component without leading digits and everything after it are ignored. The result is zero-padded to ncomponents elements.

Parameters:

  • version (str) – Dotted version string, e.g. “1.16.0rc1”.

  • ncomponents (int) – Number of components in the returned tuple.

Returns:

Tuple of ncomponents integers, e.g. (1, 16, 0).

Return type:

tuple