semantic-version 2.8.1

链接

• 包装在PyPI：http://pypi.python.org/pypi/semantic_version/
• 关于ReadTheDocs：https://python-semanticversion.readthedocs.io/
• 来源于GitHub：http://github.com/rbarrois/python-semanticversion/
• 建立在Travis CI：http://travis-ci.org/rbarrois/python-semanticversion/
• 语义版本规范：SemVer

版本

定义Version非常简单：

>>> importsemantic_version>>> v=semantic_version.Version('0.1.1')>>> v.major0
>>> v.minor1
>>> v.patch1
>>> v.prerelease[]
>>> v.build[]
>>> list(v)[0, 1, 1, [], []]

如果提供的版本字符串无效，将引发ValueError：

>>> semantic_version.Version('0.1')Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/Users/rbarrois/dev/semantic_version/src/semantic_version/base.py", line 64, in __init__major,minor,patch,prerelease,build=self.parse(version_string,partial)
  File "/Users/rbarrois/dev/semantic_version/src/semantic_version/base.py", line 86, in parseraiseValueError('Invalid version string: %r'%version_string)ValueError: Invalid version string: '0.1'

显然，Versions可以比较：

>>> semantic_version.Version('0.1.1')<semantic_version.Version('0.1.2')True
>>> semantic_version.Version('0.1.1')>semantic_version.Version('0.1.1-alpha')True
>>> semantic_version.Version('0.1.1')<=semantic_version.Version('0.1.1-alpha')False

您还可以获得一个新版本，该版本表示某个版本级别中的凹凸：

>>> v=semantic_version.Version('0.1.1+build')>>> new_v=v.next_major()>>> str(new_v)'1.0.0'
>>> v=semantic_version.Version('1.1.1+build')>>> new_v=v.next_minor()>>> str(new_v)'1.2.0'
>>> v=semantic_version.Version('1.1.1+build')>>> new_v=v.next_patch()>>> str(new_v)'1.1.2'

还可以检查给定字符串是否是正确的语义版本字符串：

>>> semantic_version.validate('0.1.3')True
>>> semantic_version.validate('0a2')False

最后，可以使用命名组件创建Version，而不是：

>>> semantic_version.Version(major=0,minor=1,patch=2)Version('0.1.2')

在这种情况下，major、minor和patch是必需的，并且必须是整数。 prerelease和patch如果提供，则必须是字符串的元组：

>>> semantic_version.Version(major=0,minor=1,patch=2,prerelease=('alpha','2'))Version('0.1.2-alpha.2')

需求规格

SimpleSpec对象描述了一系列可接受的版本：

>>> s=SimpleSpec('>=0.1.1')# At least 0.1.1>>> s.match(Version('0.1.1'))True
>>> s.match(Version('0.1.1-alpha1'))# pre-release satisfy version specTrue
>>> s.match(Version('0.1.0'))False

还可以使用in关键字使用更简单的测试语法：

>>> s=SimpleSpec('==0.1.1')>>> Version('0.1.1-alpha1')insTrue
>>> Version('0.1.2')insFalse

组合规范可以表示如下：

>>> SimpleSpec('>=0.1.1,<0.3.0')

>>> Version.coerce('0')Version('0.0.0')
>>> Version.coerce('0.1.2.3.4')Version('0.1.2+3.4')
>>> Version.coerce('0.1.2a3')Version('0.1.2-a3')

>>> Version('0.1.0-alpha')inSimpleSpec('<0.1.0')# No pre-release identifierFalse
>>> Version('0.1.0-alpha')inSimpleSpec('<0.1.0-')# Include pre-release in checksTrue

基于npm的范围

NpmSpec类处理npm样式范围：

>>> Version('1.2.3')inNpmSpec('1.2.2 - 1.4')True
>>> Version('1.2.3')inNpmSpec('<1.x || >=1.2.3')True

有关npm的详细说明，请参阅https://docs.npmjs.com/misc/semver.html。 范围语法。

注意

所有文件都应包含以下标题：

# -*- encoding: utf-8 -*-
# Copyright (c) The python-semanticversion project