python - "version"和 "release"的标准 Python 含义是什么?

标签 python versioning python-sphinx pypi semantic-versioning

“版本”和“发布”的标准 Python 含义是什么?特别是,我对如何协调 Sphinx 对这些术语的使用与它们在 PEP 0440 中的使用感到困惑。 .

例如sphinx-quickstart提示一个版本

Sphinx has the notion of a "version" and a "release" for the software. Each version can have multiple releases. For example, for Python the version is something like 2.5 or 3.0, while the release is something like 2.5.1 or 3.0a1. If you don't need this dual structure, just set both to the same value.

并创建一个包含

的配置文件
# The short X.Y version.
version = ...
# The full version, including alpha/beta/rc tags.
release = ...

但是PEP 0440将“版本”描述为具有 N(.N)* 似乎使用术语“版本”来指代 Sphinx 使用的“完整版本”(即其“版本”) .

什么是 Python“版本”,它与“发行版”有何不同?具体来说,Sphinx 是否代表这些术语的标准解释?

最佳答案

它实际上非常一致。 N(.N)* 不是指版本,而是描述如何格式化 release 的编号:

The release segment consists of one or more non-negative integer values, separated by dots

如果您想知道发布是如何定义的,请参阅 PEP 0426 :

"Releases" are uniquely identified snapshots of a project.

所以是的,Sphinx 确实代表了标准解释

关于python - "version"和 "release"的标准 Python 含义是什么?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/34336383/

相关文章:

python - 如何保护客户端与 HBase Thrift 服务器的连接?

python - 属性错误 : 'DiGraph' object has no attribute '_node'

javascript - Django request.user 无法解析 SimpleLazyObject

python - 从嵌套字典构建数据框的最佳方法

python-sphinx - 我如何告诉 readthedocs 要加载哪个需求文件?

python - 如何在 Sphinx 文档中包含 PDF?

C代码版本指示

windows - 我如何设置我在 Eclipse 中的产品版本?

wcf - 对 WCF 服务进行版本控制的方法

documentation - 如何从 Cucumber/Gherkin 生成文档?