バージョニングとAPIの安定性¶
バージョニング¶
Scrapyバージョンには3つの数字があります: A . B . C
- A はメジャーバージョンです. これはめったに変わらず, 非常に大きな変更を意味します.
- B はリリース番号です. これには, 後方互換性を損なう可能性のある機能やものを含む多くの変更が含まれますが, これらのケースを最小限に抑えるよう努めています.
- C はバグ修正リリース番号です.
下位互換性は明示的に リリースノート に示されていますが, アップグレードする前に特別な注意が必要な場合があります.
開発リリースは3桁のバージョンに従わず, 一般的に末尾に dev
をつけています. 例: 1.3dev
.
注釈
Scrapy 0.* シリーズでは, Scrapyは開発版に奇数バージョンを使用しました. Scrapy 1.0 以降のケースではありません. Scrapy 1.0からは、すべてのリリースがプロダクションの準備ができていると見なされるべきです.
例:
- 1.1.1 は 1.1 シリーズの最初のバグフィックスバージョンです. (製品版で安全に使用するための.)
API 安定性¶
API 安定性は 1.0 のリリースで一つのゴールを迎えました.
単一のダッシュ( _
)で始まるメソッドまたは関数はprivateであり, 決して安定したものであるべきではありません.
安定したAPIは新しいメソッドや機能を拡張する可能性がありますが、既存のメソッドは同じ方法で機能し続ける必要があります。