跳转到主要内容

Python语义版本控制助手(https://semver.org)

项目描述

一个用于简化语义版本控制的Python模块。

Python Python versions Monthly downloads from PyPI Software license Documentation Status Black Formatter Percentage of open issues GitHub Discussion

该模块遵循MAJOR.MINOR.PATCH风格

  • MAJOR版本当您进行不兼容的API更改时,

  • MINOR版本当您以向后兼容的方式添加功能时,以及

  • PATCH版本当您进行向后兼容的错误修复时。

支持为预发布和构建元数据添加额外标签。

要导入此库,请使用

>>> import semver

使用库非常简单。要将版本字符串转换为不同部分,请使用 semver.Version.parse 函数

>>> ver = semver.Version.parse('1.2.3-pre.2+build.4')
>>> ver.major
1
>>> ver.minor
2
>>> ver.patch
3
>>> ver.prerelease
'pre.2'
>>> ver.build
'build.4'

要提升版本的部分,有几种函数可供您使用。函数 semver.Version.bump_major 不会修改原始对象,但会返回一个新的 semver.Version 实例,其主版本号已被提升

>>> ver = semver.Version.parse("3.4.5")
>>> ver.bump_major()
Version(major=4, minor=0, patch=0, prerelease=None, build=None)

允许连接不同的“提升函数”

>>> ver.bump_major().bump_minor()
Version(major=4, minor=1, patch=0, prerelease=None, build=None)

要比较两个版本,semver 提供了 semver.compare 函数。返回值表示第一个版本和第二个版本之间的关系

>>> semver.compare("1.0.0", "2.0.0")
-1
>>> semver.compare("2.0.0", "1.0.0")
1
>>> semver.compare("2.0.0", "2.0.0")
0

还有其他函数可供探索。请继续阅读!

项目详情


下载文件

下载您平台上的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源分发

semver-3.0.2.tar.gz (215.0 kB 查看哈希)

上传时间

构建分发

semver-3.0.2-py3-none-any.whl (17.1 kB 查看哈希)

上传时间 Python 3

由以下支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面