sem_ver

此软件包包含一个语义版本标签的解析器，附带类型注解。

除了解析版本标签外，它们还可以通过标准比较运算符进行比较，并直接修改。请注意，比较运算符（包括相等）不考虑构建信息。为了测试包括构建信息在内的相等性，请将其转换为字符串并比较。可以直接将SemVer对象与字符串或其他可转换为字符串的对象进行比较，如果其他对象不是有效的SemVer，则将引发ValueError。

有关详细信息，请参阅https://semver.org。

sem_ver.SemVer

sem_ver.validate(version: str) -> bool

测试字符串是否为有效的SemVer。

sem_ver.compare(version_a: str, version_b: str) -> int

比较两个SemVer字符串。如果任一字符串不是有效的SemVer，则将引发ValueError。

sem_ver.force(version: str) -> Optional[SemVer]

使用宽松的解析规则尝试创建SemVer。如果找不到版本信息，则返回None。

SemVer(version: str = None, major: int = 0, minor: int = 0, patch: int = 0, prerelease: Union[str, Sequence[Union[int, str]]] = '', build: Union[str, Sequence[str]] = '')

构造函数。如果传入的版本字符串不匹配正确的格式，则将引发ValueError。

SemVer.major: int

主版本。更改主版本将重置次版本、修补版本、预发布版本和构建版本。

SemVer.minor: int

次版本。更改次版本将重置修补版本、预发布版本和构建版本。

SemVer.patch: int

修补版本。更改修补版本将重置预发布版本和构建版本。

SemVer.prerelease: Optional[str]

预发布标签作为单个字符串。如果预发布字符串不匹配正确的格式，则将引发ValueError。

SemVer.prereleases: List[Union[int, str]]

预发布标签作为整数或字符串的列表。不验证字符串。

SemVer.build: 可选[str]

将构建标签作为一个单独的字符串。如果构建字符串不符合正确的格式，将引发ValueError。

SemVer.builds: List[str]

将构建标签作为一个字符串列表。不验证字符串。

SemVer.next_major() -> SemVer

创建一个用于下一个主要版本的新的SemVer。次要版本、补丁版本、预发布版本和构建版本将被重置。

SemVer.next_minor() -> SemVer

创建一个用于下一个次要版本的新的SemVer。补丁版本、预发布版本和构建版本将被重置。

SemVer.next_patch() -> SemVer

创建一个用于下一个补丁版本的新的SemVer。预发布版本和构建版本将被重置。

SemVer.str() -> str

转换为字符串。

安装

使用pip安装

pip install sem_ver