Versioning and API Stability

Versioning

Scrapy版本中包含3个数字: ABC

  • A是主要版本. 这种情况很少会改变,而预示着很大的改变.
  • B是发行号. 这将包括许多更改,包括功能和可能破坏向后兼容性的内容,尽管我们努力将这些情况保持在最低限度.
  • C是错误修正版本号.

向后不兼容在发行说明中明确提到,并且在升级之前可能需要特别注意.

开发版本不遵循1.3dev版本,通常以dev后缀版本(例如1.3dev .

Note

对于Scrapy 0. *系列,Scrapy将奇数版本用于开发版本 . 从Scrapy 1.0起,情况不再如此.

从Scrapy 1.0开始,所有发行版都应被视为可投入生产.

例如:

  • 1.1.11.1系列的第一个错误修正版本(可在生产环境中安全使用)

API Stability

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

以单破折号( _ )开头的方法或函数是私有的,切勿将其视为稳定的.

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