版本控制和API稳定性

版本

Scrapy 版本号有3个数字:A.B.C

  • A 是主要版本。这将很少改变,并将意味着非常大的变化。

  • B 是发行号。这将包括许多变化,包括可能破坏向后兼容性的特性和东西,尽管我们努力将这些情况保持在最低限度。

  • C 是错误修复版本号。

向后兼容性在:ref:`release notes <news>`中明确提到,在升级之前可能需要特别注意。

开发版本不遵循3号版本,通常发布为 dev 后缀版本,例如 1.3dev .

注解

带Scrapy 0.*系列,使用Scrapy odd-numbered versions for development releases . 从Scrapy1.0开始就不再是这样了。

从Scrapy1.0开始,所有版本都应视为生产就绪。

例如:

  • 1.1.1 是的第一个错误修复版本 1.1 系列(生产中使用安全)

API稳定性

API的稳定性是 1.0 释放。

以单个破折号开头的方法或函数( _ )是私人的,不应该被当作稳定的。

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

弃用政策

我们的目标是保持对过时的垃圾特性的支持至少一年。

例如,如果某个特性在2020年6月15日发布的版本中被弃用,那么该特性应该在2021年6月14日或之前的版本中继续工作。

一年后有新的发痒症状吗 may 删除对该已弃用功能的支持。

在旧版本中删除的所有不推荐的特性都在 release notes .