“版本”和“发布”的标准Python含义是什么?

时间:2015-12-17 13:57:06

标签: python versioning python-sphinx pypi semantic-versioning

“版本”和“发布”的标准Python含义是什么?尤其令我感到困惑的是如何协调Sphinx对这些术语的使用与PEP 0440中的使用。

例如sphinx-quickstart提示输入带

的版本
  

Sphinx拥有软件“版本”和“发布”的概念。   每个版本都可以有多个版本。例如,对于Python而言   版本是2.5或3.0,而版本是一些东西   像2.5.1或3.0a1。如果您不需要这种双重结构,只需设置即可   两者都是相同的值。

并创建一个包含

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

PEP 0440描述了“释放”,因为他形成N(.N)*似乎使用术语“版本”来指代Sphinx使用的“完整版本”(即其“发布” )。

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

1 个答案:

答案 0 :(得分:3)

它实际上非常一致。 N(.N)*并未引用其描述如何格式化发布的编号的版本:

  

发布段由一个或多个非负整数组成   值,以点分隔

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

  

"唱片集"是项目的唯一标识快照。

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

相关问题