版本控制和API稳定性

版本控制

Scrapy 版本中有 3 个数字：A.B.C

• A 是主版本号。这很少会改变，并且表示非常大的变化。

• B 是发布版本号。这将包括许多变化，包括功能和可能破坏向后兼容性的内容，尽管我们努力将这些情况降到最低。

• C 是错误修复版本号。

向后不兼容性在发布说明中明确提到，升级前可能需要特别注意。

开发版本不遵循三位数版本号，通常以dev为后缀发布，例如1.3dev。

注意

在Scrapy 0.*系列中，Scrapy使用了奇数版本用于开发发布。 从Scrapy 1.0开始，这种情况不再存在。

从Scrapy 1.0开始，所有版本都应被视为生产就绪。

例如：

• 1.1.1 是 1.1 系列的第一个错误修复版本（可在生产环境中安全使用）

API稳定性

API稳定性是1.0版本的主要目标之一。

以单个下划线（_）开头的方法或函数是私有的，永远不应依赖其稳定性。

另外，请记住，稳定并不意味着完整：稳定的API可能会增加新的方法或功能，但现有方法应保持相同的工作方式。

弃用政策

我们的目标是至少保持对已弃用的Scrapy功能的支持1年。

例如，如果一个功能在2020年6月15日发布的Scrapy版本中被弃用，该功能在2021年6月14日或之前发布的版本中应继续有效。

一年后的任何新Scrapy版本可能会移除对该已弃用功能的支持。

在Scrapy版本中移除的所有已弃用功能都在发布说明中明确提及。