Skip to main content

版本控制和API稳定性

版本控制

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

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

  • B 是版本号。这将包括许多变化,包括可能破坏向后兼容性的功能和事物,尽管我们努力将这些案例保持在最低限度。

  • C 是bugfix版本号。

后向不兼容性在 发行说明 中明确提及,在升级之前可能需要特别注意。

开发版本不遵循3位数版本,通常作为 dev 后缀版本发布。 1.3dev

注解

Scrapy 0.* 系列,Scrapy使用 odd-numbered versions for development releases。这不是从Scrapy 1.0起的情况。

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

例如:

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

API稳定性

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

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

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