发布流程和规则¶
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 核心团队升级了供应商依赖项,给用户和核心团队带来了很多麻烦。为了减少这种麻烦,我们正在形成一套具体的程序,以便正确设定预期。