发布流程和规则

v2.6.2 版本中的新增内容。

v2.6.2 之后发布的版本开始,以下规则将规范和描述 Requests 核心团队如何制作新版本。

主要版本

主要版本将包含重大更改。当对其进行版本控制时,它将被版本控制为 vX.0.0。例如,如果之前的版本是 v10.2.7,则下一个版本将是 v11.0.0

重大更改是指与之前版本向后兼容性中断的更改。如果项目将 Response 对象上的 text 属性更改为方法,则这只会发生在主要版本中。

主要版本还可能包含其他错误修复。Requests 的核心开发人员致力于提供良好的用户体验。这意味着我们还致力于尽可能地保持向后兼容性。主要版本发布频率较低,并且在考虑发布之前需要有充分的理由。

次要版本

次要版本不会包含重大更改,但可能包含其他错误修复。如果之前发布的 Requests 版本是 v10.2.7,则次要版本将被版本控制为 v10.3.0

次要版本将与具有相同主要版本号的版本向后兼容。换句话说,所有以 v10. 开头的版本都应该彼此兼容。

修补程序版本

修补程序版本将仅包含在项目发布之前版本时遗漏的错误修复。如果之前发布的 Requests 版本是 v10.2.7,则修补程序版本将被版本控制为 v10.2.8

v2.6.2 之后,修补程序不会包括对供应商依赖项的升级。

理由

在 2.5 和 2.6 发布系列中,Requests 核心团队升级了供应商依赖项,给用户和核心团队带来了很多麻烦。为了减少这种麻烦,我们正在形成一套具体的程序,以便正确设定预期。