版本控制和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 .