Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

394 lines (336 sloc) 25.1 KB

Release notes

0.16 (not yet released)

Scrapy changes:

  • added :ref:`topics-contracts`, a mechanism for testing spiders in a formal/reproducible way
  • added options -o and -t to the :command:`runspider` command
  • documented :doc:`topics/autothrottle` and added to extensions installed by default. You still need to enable it with :setting:`AUTOTHROTTLE_ENABLED`
  • major Stats Collection refactoring: removed separation of global/per-spider stats, removed stats-related signals (stats_spider_opened, etc). Stats are much simpler now, backwards compatibility is kept on the Stats Collector API and signals.
  • added :meth:`~scrapy.contrib.spidermiddleware.SpiderMiddleware.process_start_requests` method to spider middlewares
  • dropped Signals singleton. Signals should now be accesed through the Crawler.signals attribute. See the signals documentation for more info.
  • dropped Signals singleton. Signals should now be accesed through the Crawler.signals attribute. See the signals documentation for more info.
  • dropped Stats Collector singleton. Stats can now be accessed through the Crawler.stats attribute. See the stats collection documentation for more info.
  • documented :ref:`topics-api`
  • lxml is now the default selectors backend instead of libxml2
  • ported FormRequest.from_response() to use lxml instead of ClientForm
  • removed modules: scrapy.xlib.BeautifulSoup and scrapy.xlib.ClientForm
  • SitemapSpider: added support for sitemap urls ending in .xml and .xml.gz, even if they advertise a wrong content type (:commit:`10ed28b`)
  • StackTraceDump extension: also dump trackref live references (:commit:`fe2ce93`)
  • nested items now fully supported in JSON and JSONLines exporters
  • added :reqmeta:`cookiejar` Request meta key to support multiple cookie sessions per spider
  • decoupled encoding detection code to w3lib.encoding, and ported Scrapy code to use that mdule
  • dropped support for Python 2.5. See
  • dropped support for Twisted 2.5
  • added :setting:`REFERER_ENABLED` setting, to control referer middleware
  • changed default user agent to: Scrapy/VERSION (+
  • removed (undocumented) HTMLImageLinkExtractor class from scrapy.contrib.linkextractors.image
  • removed per-spider settings (to be replaced by instantiating multiple crawler objects)
  • USER_AGENT spider attribute will no longer work, use user_agent attribute instead
  • DOWNLOAD_TIMEOUT spider attribute will no longer work, use download_timeout attribute instead
  • removed ENCODING_ALIASES setting, as encoding auto-detection has been moved to the w3lib library
  • promoted :ref:`topics-djangoitem` to main contrib
  • LogFormatter method now return dicts(instead of strings) to support lazy formatting (:issue:`164`, :commit:`dcef7b0`)
  • downloader handlers (:setting:`DOWNLOAD_HANDLERS` setting) now receive settings as the first argument of the constructor
  • replaced memory usage acounting with (more portable) resource module, removed scrapy.utils.memory module
  • removed signal: scrapy.mail.mail_sent
  • removed TRACK_REFS setting, now :ref:`trackrefs <topics-leaks-trackrefs>` is always enabled
  • DBM is now the default storage backend for HTTP cache middleware
  • number of log messages (per level) are now tracked through Scrapy stats (stat name: log_count/LEVEL)
  • number received responses are now tracked through Scrapy stats (stat name: response_received_count)
  • removed scrapy.log.started attribute

Scrapyd changes:



  • forgot to include pydispatch license. #118 (:commit:`fd85f9c`)
  • include egg files used by testsuite in source distribution. #118 (:commit:`c897793`)
  • update docstring in project template to avoid confusion with genspider command, which may be considered as an advanced feature. refs #107 (:commit:`2548dcc`)
  • added note to docs/topics/firebug.rst about google directory being shut down (:commit:`668e352`)
  • Merge branch '0.14' of into 0.14 (:commit:`835d082`)
  • dont discard slot when empty, just save in another dict in order to recycle if needed again. (:commit:`8e9f607`)
  • do not fail handling unicode xpaths in libxml2 backed selectors (:commit:`b830e95`)
  • fixed minor mistake in Request objects documentation (:commit:`bf3c9ee`)
  • fixed minor defect in link extractors documentation (:commit:`ba14f38`)
  • removed some obsolete remaining code related to sqlite support in scrapy (:commit:`0665175`)




New features and settings

  • Support for AJAX crawleable urls

  • New persistent scheduler that stores requests on disk, allowing to suspend and resume crawls (:rev:`2737`)

  • added -o option to scrapy crawl, a shortcut for dumping scraped items into a file (or standard output using -)

  • Added support for passing custom settings to Scrapyd schedule.json api (:rev:`2779`, :rev:`2783`)

  • New ChunkedTransferMiddleware (enabled by default) to support chunked transfer encoding (:rev:`2769`)

  • Add boto 2.0 support for S3 downloader handler (:rev:`2763`)

  • Added marshal to formats supported by feed exports (:rev:`2744`)

  • In request errbacks, offending requests are now received in failure.request attribute (:rev:`2738`)

  • Big downloader refactoring to support per domain/ip concurrency limits (:rev:`2732`)
  • Added builtin caching DNS resolver (:rev:`2728`)

  • Moved Amazon AWS-related components/extensions (SQS spider queue, SimpleDB stats collector) to a separate project: [scaws]( (:rev:`2706`, :rev:`2714`)

  • Moved spider queues to scrapyd: scrapy.spiderqueue -> scrapyd.spiderqueue (:rev:`2708`)

  • Moved sqlite utils to scrapyd: scrapy.utils.sqlite -> scrapyd.sqlite (:rev:`2781`)

  • Real support for returning iterators on start_requests() method. The iterator is now consumed during the crawl when the spider is getting idle (:rev:`2704`)

  • Added :setting:`REDIRECT_ENABLED` setting to quickly enable/disable the redirect middleware (:rev:`2697`)

  • Added :setting:`RETRY_ENABLED` setting to quickly enable/disable the retry middleware (:rev:`2694`)

  • Added CloseSpider exception to manually close spiders (:rev:`2691`)

  • Improved encoding detection by adding support for HTML5 meta charset declaration (:rev:`2690`)

  • Refactored close spider behavior to wait for all downloads to finish and be processed by spiders, before closing the spider (:rev:`2688`)

  • Added SitemapSpider (see documentation in Spiders page) (:rev:`2658`)

  • Added LogStats extension for periodically logging basic stats (like crawled pages and scraped items) (:rev:`2657`)

  • Make handling of gzipped responses more robust (#319, :rev:`2643`). Now Scrapy will try and decompress as much as possible from a gzipped response, instead of failing with an IOError.

  • Simplified !MemoryDebugger extension to use stats for dumping memory debugging info (:rev:`2639`)

  • Added new command to edit spiders: scrapy edit (:rev:`2636`) and -e flag to genspider command that uses it (:rev:`2653`)

  • Changed default representation of items to pretty-printed dicts. (:rev:`2631`). This improves default logging by making log more readable in the default case, for both Scraped and Dropped lines.

  • Added :signal:`spider_error` signal (:rev:`2628`)

  • Added :setting:`COOKIES_ENABLED` setting (:rev:`2625`)

  • Stats are now dumped to Scrapy log (default value of :setting:`STATS_DUMP` setting has been changed to True). This is to make Scrapy users more aware of Scrapy stats and the data that is collected there.

  • Added support for dynamically adjusting download delay and maximum concurrent requests (:rev:`2599`)

  • Added new DBM HTTP cache storage backend (:rev:`2576`)

  • Added listjobs.json API to Scrapyd (:rev:`2571`)

  • CsvItemExporter: added join_multivalued parameter (:rev:`2578`)

  • Added namespace support to xmliter_lxml (:rev:`2552`)

  • Improved cookies middleware by making COOKIES_DEBUG nicer and documenting it (:rev:`2579`)

  • Several improvements to Scrapyd and Link extractors

Code rearranged and removed

  • Merged item passed and item scraped concepts, as they have often proved confusing in the past. This means: (:rev:`2630`)
    • original item_scraped signal was removed
    • original item_passed signal was renamed to item_scraped
    • old log lines Scraped Item... were removed
    • old log lines Passed Item... were renamed to Scraped Item... lines and downgraded to DEBUG level
  • Reduced Scrapy codebase by striping part of Scrapy code into two new libraries:
  • Removed unused function: scrapy.utils.request.request_info() (:rev:`2577`)

  • Removed googledir project from examples/googledir. There's now a new example project called dirbot available on github:

  • Removed support for default field values in Scrapy items (:rev:`2616`)

  • Removed experimental crawlspider v2 (:rev:`2632`)

  • Removed scheduler middleware to simplify architecture. Duplicates filter is now done in the scheduler itself, using the same dupe fltering class as before (DUPEFILTER_CLASS setting) (:rev:`2640`)

  • Removed support for passing urls to scrapy crawl command (use scrapy parse instead) (:rev:`2704`)

  • Removed deprecated Execution Queue (:rev:`2704`)

  • Removed (undocumented) spider context extension (from scrapy.contrib.spidercontext) (:rev:`2780`)

  • removed CONCURRENT_SPIDERS setting (use scrapyd maxproc instead) (:rev:`2789`)

  • Renamed attributes of core components: downloader.sites -> downloader.slots, scraper.sites -> scraper.slots (:rev:`2717`, :rev:`2718`)

  • Renamed setting CLOSESPIDER_ITEMPASSED to :setting:`CLOSESPIDER_ITEMCOUNT` (:rev:`2655`). Backwards compatibility kept.


The numbers like #NNN reference tickets in the old issue tracker (Trac) which is no longer available.

New features and improvements

  • Passed item is now sent in the item argument of the :signal:`item_passed` (#273)
  • Added verbose option to scrapy version command, useful for bug reports (#298)
  • HTTP cache now stored by default in the project data dir (#279)
  • Added project data storage directory (#276, #277)
  • Documented file structure of Scrapy projects (see command-line tool doc)
  • New lxml backend for XPath selectors (#147)
  • Per-spider settings (#245)
  • Support exit codes to signal errors in Scrapy commands (#248)
  • Added -c argument to scrapy shell command
  • Made libxml2 optional (#260)
  • New deploy command (#261)
  • Added :setting:`CLOSESPIDER_PAGECOUNT` setting (#253)
  • Added :setting:`CLOSESPIDER_ERRORCOUNT` setting (#254)

Scrapyd changes

  • Scrapyd now uses one process per spider
  • It stores one log file per spider run, and rotate them keeping the lastest 5 logs per spider (by default)
  • A minimal web ui was added, available at http://localhost:6800 by default
  • There is now a scrapy server command to start a Scrapyd server of the current project

Changes to settings

  • added HTTPCACHE_ENABLED setting (False by default) to enable HTTP cache middleware
  • changed HTTPCACHE_EXPIRATION_SECS semantics: now zero means "never expire".

Deprecated/obsoleted functionality

  • Deprecated runserver command in favor of server command which starts a Scrapyd server. See also: Scrapyd changes
  • Deprecated queue command in favor of using Scrapyd schedule.json API. See also: Scrapyd changes
  • Removed the !LxmlItemLoader (experimental contrib which never graduated to main contrib)


The numbers like #NNN reference tickets in the old issue tracker (Trac) which is no longer available.

New features and improvements

  • New Scrapy service called scrapyd for deploying Scrapy crawlers in production (#218) (documentation available)
  • Simplified Images pipeline usage which doesn't require subclassing your own images pipeline now (#217)
  • Scrapy shell now shows the Scrapy log by default (#206)
  • Refactored execution queue in a common base code and pluggable backends called "spider queues" (#220)
  • New persistent spider queue (based on SQLite) (#198), available by default, which allows to start Scrapy in server mode and then schedule spiders to run.
  • Added documentation for Scrapy command-line tool and all its available sub-commands. (documentation available)
  • Feed exporters with pluggable backends (#197) (documentation available)
  • Deferred signals (#193)
  • Added two new methods to item pipeline open_spider(), close_spider() with deferred support (#195)
  • Support for overriding default request headers per spider (#181)
  • Replaced default Spider Manager with one with similar functionality but not depending on Twisted Plugins (#186)
  • Splitted Debian package into two packages - the library and the service (#187)
  • Scrapy log refactoring (#188)
  • New extension for keeping persistent spider contexts among different runs (#203)
  • Added dont_redirect request.meta key for avoiding redirects (#233)
  • Added dont_retry request.meta key for avoiding retries (#234)

Command-line tool changes

  • New scrapy command which replaces the old (#199) - there is only one global scrapy command now, instead of one per project - Added scrapy.bat script for running more conveniently from Windows
  • Added bash completion to command-line tool (#210)
  • Renamed command start to runserver (#209)

API changes

  • url and body attributes of Request objects are now read-only (#230)

  • Request.copy() and Request.replace() now also copies their callback and errback attributes (#231)

  • Removed UrlFilterMiddleware from scrapy.contrib (already disabled by default)

  • Offsite middelware doesn't filter out any request coming from a spider that doesn't have a allowed_domains attribute (#225)

  • Removed Spider Manager load() method. Now spiders are loaded in the constructor itself.

  • Changes to Scrapy Manager (now called "Crawler"):
    • scrapy.core.manager.ScrapyManager class renamed to scrapy.crawler.Crawler
    • scrapy.core.manager.scrapymanager singleton moved to scrapy.project.crawler
  • Moved module: scrapy.contrib.spidermanager to scrapy.spidermanager

  • Spider Manager singleton moved from scrapy.spider.spiders to the spiders` attribute of ``scrapy.project.crawler singleton.

  • moved Stats Collector classes: (#204)
    • scrapy.stats.collector.StatsCollector to scrapy.statscol.StatsCollector
    • scrapy.stats.collector.SimpledbStatsCollector to scrapy.contrib.statscol.SimpledbStatsCollector
  • default per-command settings are now specified in the default_settings attribute of command object class (#201)

  • changed arguments of Item pipeline process_item() method from (spider, item) to (item, spider)
    • backwards compatibility kept (with deprecation warning)
  • moved scrapy.core.signals module to scrapy.signals
    • backwards compatibility kept (with deprecation warning)
  • moved scrapy.core.exceptions module to scrapy.exceptions
    • backwards compatibility kept (with deprecation warning)
  • added handles_request() class method to BaseSpider

  • dropped scrapy.log.exc() function (use scrapy.log.err() instead)

  • dropped component argument of scrapy.log.msg() function

  • dropped scrapy.log.log_level attribute

  • Added from_settings() class methods to Spider Manager, and Item Pipeline Manager

Changes to settings

  • Added HTTPCACHE_IGNORE_SCHEMES setting to ignore certain schemes on !HttpCacheMiddleware (#225)
  • Added SPIDER_QUEUE_CLASS setting which defines the spider queue to use (#220)
  • Added KEEP_ALIVE setting (#220)
  • Removed SERVICE_QUEUE setting (#220)
  • Removed COMMANDS_SETTINGS_MODULE setting (#201)
  • Renamed REQUEST_HANDLERS to DOWNLOAD_HANDLERS and make download handlers classes (instead of functions)


The numbers like #NNN reference tickets in the old issue tracker (Trac) which is no longer available.

New features and improvements

API changes

Changes to default settings


The numbers like #NNN reference tickets in the old issue tracker (Trac) which is no longer available.

New features

Backwards-incompatible changes

  • Changed scrapy.utils.response.get_meta_refresh() signature (:rev:`1804`)

  • Removed deprecated scrapy.item.ScrapedItem class - use scrapy.item.Item instead (:rev:`1838`)

  • Removed deprecated scrapy.xpath module - use scrapy.selector instead. (:rev:`1836`)

  • Removed deprecated core.signals.domain_open signal - use core.signals.domain_opened instead (:rev:`1822`)

  • log.msg() now receives a spider argument (:rev:`1822`)
    • Old domain argument has been deprecated and will be removed in 0.9. For spiders, you should always use the spider argument and pass spider references. If you really want to pass a string, use the component argument instead.
  • Changed core signals domain_opened, domain_closed, domain_idle

  • Changed Item pipeline to use spiders instead of domains
    • The domain argument of process_item() item pipeline method was changed to spider, the new signature is: process_item(spider, item) (:rev:`1827` | #105)
    • To quickly port your code (to work with Scrapy 0.8) just use spider.domain_name where you previously used domain.
  • Changed Stats API to use spiders instead of domains (:rev:`1849` | #113)
    • StatsCollector was changed to receive spider references (instead of domains) in its methods (set_value, inc_value, etc).
    • added StatsCollector.iter_spider_stats() method
    • removed StatsCollector.list_domains() method
    • Also, Stats signals were renamed and now pass around spider references (instead of domains). Here's a summary of the changes:
    • To quickly port your code (to work with Scrapy 0.8) just use spider.domain_name where you previously used domain. spider_stats contains exactly the same data as domain_stats.
  • CloseDomain extension moved to scrapy.contrib.closespider.CloseSpider (:rev:`1833`)
    • Its settings were also renamed:
  • Removed deprecated SCRAPYSETTINGS_MODULE environment variable - use SCRAPY_SETTINGS_MODULE instead (:rev:`1840`)

  • Renamed setting: REQUESTS_PER_DOMAIN to CONCURRENT_REQUESTS_PER_SPIDER (:rev:`1830`, :rev:`1844`)

  • Renamed setting: CONCURRENT_DOMAINS to CONCURRENT_SPIDERS (:rev:`1830`)

  • Refactored HTTP Cache middleware

  • HTTP Cache middleware has been heavilty refactored, retaining the same functionality except for the domain sectorization which was removed. (:rev:`1843` )

  • Renamed exception: DontCloseDomain to DontCloseSpider (:rev:`1859` | #120)

  • Renamed extension: DelayedCloseDomain to SpiderCloseDelay (:rev:`1861` | #121)

  • Removed obsolete scrapy.utils.markup.remove_escape_chars function - use scrapy.utils.markup.replace_escape_chars instead (:rev:`1865`)


First release of Scrapy.

Jump to Line
Something went wrong with that request. Please try again.