2021-05-05 04:01:30 +00:00
|
|
|
"""
|
2021-05-05 09:37:20 +00:00
|
|
|
Various helper functions for analyzing and manipulating :pep:`440` version numbers,
|
2021-05-05 04:01:30 +00:00
|
|
|
meant to augment the `packaging.version` module.
|
|
|
|
"""
|
|
|
|
|
2021-04-23 20:00:51 +00:00
|
|
|
# yaclog: yet another changelog tool
|
|
|
|
# Copyright (c) 2021. Andrew Cassidy
|
|
|
|
#
|
|
|
|
# This program is free software: you can redistribute it and/or modify
|
|
|
|
# it under the terms of the GNU Affero General Public License as
|
|
|
|
# published by the Free Software Foundation, either version 3 of the
|
|
|
|
# License, or (at your option) any later version.
|
|
|
|
#
|
|
|
|
# This program is distributed in the hope that it will be useful,
|
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
# GNU Affero General Public License for more details.
|
|
|
|
#
|
|
|
|
# You should have received a copy of the GNU Affero General Public License
|
|
|
|
# along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
|
2021-04-30 08:52:06 +00:00
|
|
|
import re
|
|
|
|
from typing import Optional, Tuple
|
2021-04-23 20:00:51 +00:00
|
|
|
|
2021-04-30 08:52:06 +00:00
|
|
|
from packaging.version import Version, VERSION_PATTERN
|
|
|
|
|
|
|
|
version_regex = re.compile(VERSION_PATTERN, re.VERBOSE | re.IGNORECASE)
|
|
|
|
|
|
|
|
|
|
|
|
def extract_version(version_str: str) -> Tuple[Optional[Version], int, int]:
|
|
|
|
"""
|
2021-05-05 09:37:20 +00:00
|
|
|
Extracts a :pep:`440` version object from a string which may have other text
|
2021-04-30 08:52:06 +00:00
|
|
|
|
|
|
|
:param version_str: The input string to extract from
|
|
|
|
:return: A tuple of (version, start, end), where start and end are the span of the version in the original string
|
|
|
|
"""
|
|
|
|
match = version_regex.search(version_str)
|
|
|
|
if not match:
|
|
|
|
return None, -1, -1
|
|
|
|
return (Version(match[0]),) + match.span()
|
2021-04-23 20:00:51 +00:00
|
|
|
|
|
|
|
|
2021-04-30 08:52:06 +00:00
|
|
|
def increment_version(version_str: str, rel_seg: int = None, pre_seg: str = None) -> str:
|
|
|
|
"""
|
2021-05-05 09:37:20 +00:00
|
|
|
Increment the :pep:`440` version number in a string
|
2021-04-23 20:00:51 +00:00
|
|
|
|
2021-04-30 08:52:06 +00:00
|
|
|
:param version_str: The input string to manipulate
|
|
|
|
:param rel_seg: Which segment of the "release" value to increment, if any
|
2021-05-01 04:19:04 +00:00
|
|
|
:param pre_seg: Which kind of prerelease to use, if any. An empty string clears the prerelease field.
|
2021-04-30 08:52:06 +00:00
|
|
|
:return: The original string with the version number incremented
|
|
|
|
"""
|
|
|
|
v, *span = extract_version(version_str)
|
2021-04-23 20:00:51 +00:00
|
|
|
epoch = v.epoch
|
|
|
|
release = v.release
|
|
|
|
pre = v.pre
|
|
|
|
post = v.post
|
|
|
|
dev = v.dev
|
|
|
|
local = v.local
|
|
|
|
|
2021-04-30 08:52:06 +00:00
|
|
|
if rel_seg is not None:
|
|
|
|
if len(release) <= rel_seg:
|
|
|
|
release += (0,) * (1 + rel_seg - len(release))
|
|
|
|
release = release[0:rel_seg] + (release[rel_seg] + 1,) + (0,) * (len(release) - rel_seg - 1)
|
2021-05-01 04:19:04 +00:00
|
|
|
pre = None
|
2021-04-30 08:52:06 +00:00
|
|
|
|
|
|
|
if pre_seg is not None:
|
2021-05-01 04:19:04 +00:00
|
|
|
if pre_seg == '': # full release, clear prerelease field
|
|
|
|
pre = None
|
|
|
|
elif pre and pre[0] == pre_seg: # increment current prerelease type
|
2021-04-30 08:52:06 +00:00
|
|
|
pre = (pre_seg, pre[1] + 1)
|
2021-04-23 20:00:51 +00:00
|
|
|
else:
|
2021-05-01 04:19:04 +00:00
|
|
|
pre = (pre_seg, 1) # set prerelease field
|
2021-04-23 20:00:51 +00:00
|
|
|
|
2021-04-30 08:52:06 +00:00
|
|
|
new_v = join_version(epoch, release, pre, post, dev, local)
|
|
|
|
return version_str[0:span[0]] + new_v + version_str[span[1]:]
|
2021-04-23 20:00:51 +00:00
|
|
|
|
|
|
|
|
|
|
|
def join_version(epoch, release, pre, post, dev, local) -> str:
|
2021-05-05 09:37:20 +00:00
|
|
|
"""Join multiple segments of a :pep:`440` version"""
|
2021-04-23 20:00:51 +00:00
|
|
|
parts = []
|
|
|
|
|
|
|
|
# Epoch
|
|
|
|
if epoch != 0:
|
|
|
|
parts.append(f"{epoch}!")
|
|
|
|
|
|
|
|
# Release segment
|
|
|
|
parts.append(".".join(str(x) for x in release))
|
|
|
|
|
|
|
|
# Pre-release
|
|
|
|
if pre is not None:
|
|
|
|
parts.append("".join(str(x) for x in pre))
|
|
|
|
|
|
|
|
# Post-release
|
|
|
|
if post is not None:
|
|
|
|
parts.append(f".post{post}")
|
|
|
|
|
|
|
|
# Development release
|
|
|
|
if dev is not None:
|
|
|
|
parts.append(f".dev{dev}")
|
|
|
|
|
|
|
|
# Local version segment
|
|
|
|
if local is not None:
|
|
|
|
parts.append(f"+{local}")
|
|
|
|
|
|
|
|
return "".join(parts)
|
2021-04-28 01:56:53 +00:00
|
|
|
|
|
|
|
|
2021-04-30 08:52:06 +00:00
|
|
|
def is_release(version_str: str) -> bool:
|
2021-05-05 09:37:20 +00:00
|
|
|
"""
|
|
|
|
Check if a version string is a release version
|
|
|
|
|
|
|
|
:param version_str: the input string to check
|
|
|
|
:return: True if the input contains a released :pep:`440` version,
|
|
|
|
or False if a prerelease version or no version is found
|
|
|
|
"""
|
2021-04-30 08:52:06 +00:00
|
|
|
v, *span = extract_version(version_str)
|
|
|
|
if v:
|
|
|
|
return not (v.is_devrelease or v.is_prerelease)
|
|
|
|
else:
|
|
|
|
return False
|