Versioning and API stability

• B is the release number. This will include many changes including features and things that possibly break backward compatibility, although we strive to keep these cases at a minimum.

Backward-incompatibilities are explicitly mentioned in the release notes, and may require special attention before upgrading.

Note

With Scrapy 0.* series, Scrapy used . This is not the case anymore from Scrapy 1.0 onwards.

Starting with Scrapy 1.0, all releases should be considered production-ready.

For example:

• 1.1.1 is the first bugfix release of the 1.1 series (safe to use in production)

Methods or functions that start with a single dash () are private and should never be relied as stable.

Also, keep in mind that stable doesn’t mean complete: stable APIs could grow new methods or functionality but the existing methods should keep working the same way.

We aim to maintain support for deprecated Scrapy features for at least 1 year.

For example, if a feature is deprecated in a Scrapy version released on June 15th 2020, that feature should continue to work in versions released on June 14th 2021 or before that.

All deprecated features removed in a Scrapy release are explicitly mentioned in the release notes.