scrapy

Packaging fix: disallow unsupported Twisted versions in setup.py

Bug fixes 

Class attributes for subclasses of ImagesPipeline and FilesPipeline work as they did before 1.1.1 ( #2243 , fixes #2198 )

Documentation 

Overview and tutorial rewritten to use http://toscrape.com websites ( #2236 , #2249 , #2252 ).

Bug fixes 

Introduce a missing IMAGES_STORE_S3_ACL setting to override the default ACL policy in ImagesPipeline when uploading images to S3 (note that default ACL policy is “private” – instead of “public-read” – since Scrapy 1.1.0)

IMAGES_EXPIRES default value set back to 90 (the regression was introduced in 1.1.1)

Bug fixes 

Add “Host” header in CONNECT requests to HTTPS proxies ( #2069 )

Use response body when choosing response class ( #2001 , fixes #2000 )

Do not fail on canonicalizing URLs with wrong netlocs ( #2038 , fixes #2010 )

a few fixes for HttpCompressionMiddleware (and SitemapSpider ):

Do not decode HEAD responses ( #2008 , fixes #1899 )

Handle charset parameter in gzip Content-Type header ( #2050 , fixes #2049 )

Do not decompress gzip octet-stream responses ( #2065 , fixes #2063 )

Catch (and ignore with a warning) exception when verifying certificate against IP-address hosts ( #2094 , fixes #2092 )

Make FilesPipeline and ImagesPipeline backward compatible again regarding the use of legacy class attributes for customization ( #1989 , fixes #1985 )

New features 

Enable genspider command outside project folder ( #2052 )

Retry HTTPS CONNECT TunnelError by default ( #1974 )

Documentation 

FEED_TEMPDIR setting at lexicographical position ( commit 9b3c72c )

Use idiomatic .extract_first() in overview ( #1994 )

Update years in copyright notice ( commit c2c8036 )

Add information and example on errbacks ( #1995 )

Use “url” variable in downloader middleware example ( #2015 )

Grammar fixes ( #2054 , #2120 )

New FAQ entry on using BeautifulSoup in spider callbacks ( #2048 )

Add notes about Scrapy not working on Windows with Python 3 ( #2060 )

Encourage complete titles in pull requests ( #2026 )

Tests 

Upgrade py.test requirement on Travis CI and Pin pytest-cov to 2.2.1 ( #2095 )

This 1.1 release brings a lot of interesting features and bug fixes:

Scrapy 1.1 has beta Python 3 support (requires Twisted >= 15.5). See Beta Python 3 Support for more details and some limitations.

Hot new features:

Item loaders now support nested loaders ( #1467 ).

FormRequest.from_response improvements ( #1382 , #1137 ).

Added setting AUTOTHROTTLE_TARGET_CONCURRENCY and improved AutoThrottle docs ( #1324 ).

Added response.text to get body as unicode ( #1730 ).

Anonymous S3 connections ( #1358 ).

Deferreds in downloader middlewares ( #1473 ). This enables better robots.txt handling ( #1471 ).

HTTP caching now follows RFC2616 more closely, added settings HTTPCACHE_ALWAYS_STORE and HTTPCACHE_IGNORE_RESPONSE_CACHE_CONTROLS ( #1151 ).

Selectors were extracted to the parsel library ( #1409 ). This means you can use Scrapy Selectors without Scrapy and also upgrade the selectors engine without needing to upgrade Scrapy.

HTTPS downloader now does TLS protocol negotiation by default, instead of forcing TLS 1.0. You can also set the SSL/TLS method using the new DOWNLOADER_CLIENT_TLS_METHOD setting.

These bug fixes may require your attention:

Don’t retry bad requests (HTTP 400) by default ( #1289 ). If you need the old behavior, add 400 to RETRY_HTTP_CODES .

Fix shell files argument handling ( #1710 , #1550 ). If you try scrapy shell index.html it will try to load the URL http://index.html , use scrapy shell ./index.html to load a local file.

Robots.txt compliance is now enabled by default for newly-created projects ( #1724 ). Scrapy will also wait for robots.txt to be downloaded before proceeding with the crawl ( #1735 ). If you want to disable this behavior, update ROBOTSTXT_OBEY in settings.py file after creating a new project.

Exporters now work on unicode, instead of bytes by default ( #1080 ). If you use PythonItemExporter , you may want to update your code to disable binary mode which is now deprecated.

Accept XML node names containing dots as valid ( #1533 ).

When uploading files or images to S3 (with FilesPipeline or ImagesPipeline ), the default ACL policy is now “private” instead of “public” Warning: backward incompatible! . You can use FILES_STORE_S3_ACL to change it.

We’ve reimplemented canonicalize_url() for more correct output, especially for URLs with non-ASCII characters ( #1947 ). This could change link extractors output compared to previous Scrapy versions. This may also invalidate some cache entries you could still have from pre-1.1 runs. Warning: backward incompatible! .

Keep reading for more details on other improvements and bug fixes.

Beta Python 3 Support 

We have been hard at work to make Scrapy run on Python 3. As a result, now you can run spiders on Python 3.3, 3.4 and 3.5 (Twisted >= 15.5 required). Some features are still missing (and some may never be ported).

Almost all builtin extensions/middlewares are expected to work. However, we are aware of some limitations in Python 3:

Scrapy does not work on Windows with Python 3

Sending emails is not supported

FTP download handler is not supported

Telnet console is not supported

Additional New Features and Enhancements 

Scrapy now has a Code of Conduct ( #1681 ).

Command line tool now has completion for zsh ( #934 ).

Improvements to scrapy shell :

Support for bpython and configure preferred Python shell via SCRAPY_PYTHON_SHELL ( #1100 , #1444 ).

Support URLs without scheme ( #1498 ) Warning: backward incompatible!

Bring back support for relative file path ( #1710 , #1550 ).

Added MEMUSAGE_CHECK_INTERVAL_SECONDS setting to change default check interval ( #1282 ).

Download handlers are now lazy-loaded on first request using their scheme ( #1390 , #1421 ).

HTTPS download handlers do not force TLS 1.0 anymore; instead, OpenSSL’s SSLv23_method()/TLS_method() is used allowing to try negotiating with the remote hosts the highest TLS protocol version it can ( #1794 , #1629 ).

RedirectMiddleware now skips the status codes from handle_httpstatus_list on spider attribute or in Request ’s meta key ( #1334 , #1364 , #1447 ).

Form submission:

now works with <button> elements too ( #1469 ).

an empty string is now used for submit buttons without a value ( #1472 )

Dict-like settings now have per-key priorities ( #1135 , #1149 and #1586 ).

Sending non-ASCII emails ( #1662 )

CloseSpider and SpiderState extensions now get disabled if no relevant setting is set ( #1723 , #1725 ).

Added method ExecutionEngine.close ( #1423 ).

Added method CrawlerRunner.create_crawler ( #1528 ).

Scheduler priority queue can now be customized via SCHEDULER_PRIORITY_QUEUE ( #1822 ).

.pps links are now ignored by default in link extractors ( #1835 ).

temporary data folder for FTP and S3 feed storages can be customized using a new FEED_TEMPDIR setting ( #1847 ).

FilesPipeline and ImagesPipeline settings are now instance attributes instead of class attributes, enabling spider-specific behaviors ( #1891 ).

JsonItemExporter now formats opening and closing square brackets on their own line (first and last lines of output file) ( #1950 ).

If available, botocore is used for S3FeedStorage , S3DownloadHandler and S3FilesStore ( #1761 , #1883 ).

Tons of documentation updates and related fixes ( #1291 , #1302 , #1335 , #1683 , #1660 , #1642 , #1721 , #1727 , #1879 ).

Other refactoring, optimizations and cleanup ( #1476 , #1481 , #1477 , #1315 , #1290 , #1750 , #1881 ).

Deprecations and Removals 

Added to_bytes and to_unicode , deprecated str_to_unicode and unicode_to_str functions ( #778 ).

binary_is_text is introduced, to replace use of isbinarytext (but with inverse return value) ( #1851 )

The optional_features set has been removed ( #1359 ).

The --lsprof command line option has been removed ( #1689 ). Warning: backward incompatible , but doesn’t break user code.

The following datatypes were deprecated ( #1720 ):

scrapy.utils.datatypes.MultiValueDictKeyError

scrapy.utils.datatypes.MultiValueDict

scrapy.utils.datatypes.SiteNode

The previously bundled scrapy.xlib.pydispatch library was deprecated and replaced by pydispatcher .

Relocations 

telnetconsole was relocated to extensions/ ( #1524 ).

Note: telnet is not enabled on Python 3 ( https://github.com/scrapy/scrapy/pull/1524#issuecomment-146985595 )

Bugfixes 

Scrapy does not retry requests that got a HTTP 400 Bad Request response anymore ( #1289 ). Warning: backward incompatible!

Support empty password for http_proxy config ( #1274 ).

Interpret application/x-json as TextResponse ( #1333 ).

Support link rel attribute with multiple values ( #1201 ).

Fixed scrapy.FormRequest.from_response when there is a <base> tag ( #1564 ).

Fixed TEMPLATES_DIR handling ( #1575 ).

Various FormRequest fixes ( #1595 , #1596 , #1597 ).

Makes _monkeypatches more robust ( #1634 ).

Fixed bug on XMLItemExporter with non-string fields in items ( #1738 ).

Fixed startproject command in macOS ( #1635 ).

Fixed PythonItemExporter and CSVExporter for non-string item types ( #1737 ).

Various logging related fixes ( #1294 , #1419 , #1263 , #1624 , #1654 , #1722 , #1726 and #1303 ).

Fixed bug in utils.template.render_templatefile() ( #1212 ).

sitemaps extraction from robots.txt is now case-insensitive ( #1902 ).

HTTPS+CONNECT tunnels could get mixed up when using multiple proxies to same remote host ( #1912 ).

Packaging fix: disallow unsupported Twisted versions in setup.py

FIX: RetryMiddleware is now robust to non-standard HTTP status codes ( #1857 )

FIX: Filestorage HTTP cache was checking wrong modified time ( #1875 )

DOC: Support for Sphinx 1.4+ ( #1893 )

DOC: Consistency in selectors examples ( #1869 )

FIX: [Backport] Ignore bogus links in LinkExtractors (fixes #907 , commit 108195e )

TST: Changed buildbot makefile to use ‘pytest’ ( commit 1f3d90a )

DOC: Fixed typos in tutorial and media-pipeline ( commit 808a9ea and commit 803bd87 )

DOC: Add AjaxCrawlMiddleware to DOWNLOADER_MIDDLEWARES_BASE in settings docs ( commit aa94121 )

Ignoring xlib/tx folder, depending on Twisted version. ( commit 7dfa979 )

Run on new travis-ci infra ( commit 6e42f0b )

Spelling fixes ( commit 823a1cc )

escape nodename in xmliter regex ( commit da3c155 )

test xml nodename with dots ( commit 4418fc3 )

TST don’t use broken Pillow version in tests ( commit a55078c )

disable log on version command. closes #1426 ( commit 86fc330 )

disable log on startproject command ( commit db4c9fe )

Add PyPI download stats badge ( commit df2b944 )

don’t run tests twice on Travis if a PR is made from a scrapy/scrapy branch ( commit a83ab41 )

Add Python 3 porting status badge to the README ( commit 73ac80d )

fixed RFPDupeFilter persistence ( commit 97d080e )

TST a test to show that dupefilter persistence is not working ( commit 97f2fb3 )

explicit close file on file:// scheme handler ( commit d9b4850 )

Disable dupefilter in shell ( commit c0d0734 )

DOC: Add captions to toctrees which appear in sidebar ( commit aa239ad )

DOC Removed pywin32 from install instructions as it’s already declared as dependency. ( commit 10eb400 )

Added installation notes about using Conda for Windows and other OSes. ( commit 1c3600a )

Fixed minor grammar issues. ( commit 7f4ddd5 )

fixed a typo in the documentation. ( commit b71f677 )

Version 1 now exists ( commit 5456c0e )

fix another invalid xpath error ( commit 0a1366e )

fix ValueError: Invalid XPath: //div/[id=”not-exists”]/text() on selectors.rst ( commit ca8d60f )

Typos corrections ( commit 7067117 )

fix typos in downloader-middleware.rst and exceptions.rst, middlware -> middleware ( commit 32f115c )

Add note to Ubuntu install section about Debian compatibility ( commit 23fda69 )

Replace alternative macOS install workaround with virtualenv ( commit 98b63ee )

Reference Homebrew’s homepage for installation instructions ( commit 1925db1 )

Add oldest supported tox version to contributing docs ( commit 5d10d6d )

Note in install docs about pip being already included in python>=2.7.9 ( commit 85c980e )

Add non-python dependencies to Ubuntu install section in the docs ( commit fbd010d )

Add macOS installation section to docs ( commit d8f4cba )

DOC(ENH): specify path to rtd theme explicitly ( commit de73b1a )

minor: scrapy.Spider docs grammar ( commit 1ddcc7b )

Make common practices sample code match the comments ( commit 1b85bcf )

nextcall repetitive calls (heartbeats). ( commit 55f7104 )

Backport fix compatibility with Twisted 15.4.0 ( commit b262411 )

pin pytest to 2.7.3 ( commit a6535c2 )

Merge pull request #1512 from mgedmin/patch-1 ( commit 8876111 )

Merge pull request #1513 from mgedmin/patch-2 ( commit 5d4daf8 )

Typo ( commit f8d0682 )

Fix list formatting ( commit 5f83a93 )

fix Scrapy squeue tests after recent changes to queuelib ( commit 3365c01 )

Merge pull request #1475 from rweindl/patch-1 ( commit 2d688cd )

Update tutorial.rst ( commit fbc1f25 )

Merge pull request #1449 from rhoekman/patch-1 ( commit 7d6538c )

Small grammatical change ( commit 8752294 )

Add openssl version to version command ( commit 13c45ac )

add service_identity to Scrapy install_requires ( commit cbc2501 )

Workaround for travis#296 ( commit 66af9cd )

Twisted 15.3.0 does not raises PicklingError serializing lambda functions ( commit b04dd7d )

Minor method name fix ( commit 6f85c7f )

minor: scrapy.Spider grammar and clarity ( commit 9c9d2e0 )

Put a blurb about support channels in CONTRIBUTING ( commit c63882b )

Fixed typos ( commit a9ae7b0 )

Fix doc reference. ( commit 7c8a4fe )

Unquote request path before passing to FTPClient, it already escape paths ( commit cc00ad2 )

include tests/ to source distribution in MANIFEST.in ( commit eca227e )

DOC Fix SelectJmes documentation ( commit b8567bc )

DOC Bring Ubuntu and Archlinux outside of Windows subsection ( commit 392233f )

DOC remove version suffix from Ubuntu package ( commit 5303c66 )

DOC Update release date for 1.0 ( commit c89fa29 )

You will find a lot of new features and bugfixes in this major release. Make sure to check our updated overview to get a glance of some of the changes, along with our brushed tutorial .

Support for returning dictionaries in spiders 

Declaring and returning Scrapy Items is no longer necessary to collect the scraped data from your spider, you can now return explicit dictionaries instead.

Classic version

class MyItem ( scrapy . Item ): url = scrapy . Field () class MySpider ( scrapy . Spider ): def parse ( self , response ): return MyItem ( url = response . url )

New version

class MySpider ( scrapy . Spider ): def parse ( self , response ): return { 'url' : response . url }

Per-spider settings (GSoC 2014) 

Last Google Summer of Code project accomplished an important redesign of the mechanism used for populating settings, introducing explicit priorities to override any given setting. As an extension of that goal, we included a new level of priority for settings that act exclusively for a single spider, allowing them to redefine project settings.

Start using it by defining a custom_settings class variable in your spider:

class MySpider ( scrapy . Spider ): custom_settings = { "DOWNLOAD_DELAY" : 5.0 , "RETRY_ENABLED" : False , }

Read more about settings population: Settings

Python Logging 

Scrapy 1.0 has moved away from Twisted logging to support Python built in’s as default logging system. We’re maintaining backward compatibility for most of the old custom interface to call logging functions, but you’ll get warnings to switch to the Python logging API entirely.

Old version

from scrapy import log log . msg ( 'MESSAGE' , log . INFO )

New version

import logging logging . info ( 'MESSAGE' )

Logging with spiders remains the same, but on top of the log() method you’ll have access to a custom logger created for the spider to issue log events:

class MySpider ( scrapy . Spider ): def parse ( self , response ): self . logger . info ( 'Response received' )

Read more in the logging documentation: Logging

Crawler API refactoring (GSoC 2014) 

Another milestone for last Google Summer of Code was a refactoring of the internal API, seeking a simpler and easier usage. Check new core interface in: Core API

A common situation where you will face these changes is while running Scrapy from scripts. Here’s a quick example of how to run a Spider manually with the new API:

from scrapy.crawler import CrawlerProcess process = CrawlerProcess ({ 'USER_AGENT' : 'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1)' }) process . crawl ( MySpider ) process . start ()

Bear in mind this feature is still under development and its API may change until it reaches a stable status.

See more examples for scripts running Scrapy: Common Practices

Module Relocations 

There’s been a large rearrangement of modules trying to improve the general structure of Scrapy. Main changes were separating various subpackages into new projects and dissolving both scrapy.contrib and scrapy.contrib_exp into top level packages. Backward compatibility was kept among internal relocations, while importing deprecated modules expect warnings indicating their new place.

Full list of relocations 

Outsourced packages

Note

These extensions went through some minor changes, e.g. some setting names were changed. Please check the documentation in each new repository to get familiar with the new usage.

Old location

New location

scrapy.commands.deploy

scrapyd-client (See other alternatives here: Deploying Spiders )

scrapy.contrib.djangoitem

scrapy-djangoitem

scrapy.webservice

scrapy-jsonrpc

scrapy.contrib_exp and scrapy.contrib dissolutions

Old location

New location

scrapy.contrib_exp.downloadermiddleware.decompression

scrapy.downloadermiddlewares.decompression

scrapy.contrib_exp.iterators

scrapy.utils.iterators

scrapy.contrib.downloadermiddleware

scrapy.downloadermiddlewares

scrapy.contrib.exporter

scrapy.exporters

scrapy.contrib.linkextractors

scrapy.linkextractors

scrapy.contrib.loader

scrapy.loader

scrapy.contrib.loader.processor

scrapy.loader.processors

scrapy.contrib.pipeline

scrapy.pipelines

scrapy.contrib.spidermiddleware

scrapy.spidermiddlewares

scrapy.contrib.spiders

scrapy.spiders

scrapy.contrib.closespider

scrapy.contrib.corestats

scrapy.contrib.debug

scrapy.contrib.feedexport

scrapy.contrib.httpcache

scrapy.contrib.logstats

scrapy.contrib.memdebug

scrapy.contrib.memusage

scrapy.contrib.spiderstate

scrapy.contrib.statsmailer

scrapy.contrib.throttle

scrapy.extensions.*

Plural renames and Modules unification

Old location

New location

scrapy.command

scrapy.commands

scrapy.dupefilter

scrapy.dupefilters

scrapy.linkextractor

scrapy.linkextractors

scrapy.spider

scrapy.spiders

scrapy.squeue

scrapy.squeues

scrapy.statscol

scrapy.statscollectors

scrapy.utils.decorator

scrapy.utils.decorators

Class renames

Old location

New location

scrapy.spidermanager.SpiderManager

scrapy.spiderloader.SpiderLoader

Settings renames

Old location

New location

SPIDER_MANAGER_CLASS

SPIDER_LOADER_CLASS

Changelog 

New Features and Enhancements

Python logging ( #1060 , #1235 , #1236 , #1240 , #1259 , #1278 , #1286 )

FEED_EXPORT_FIELDS option ( #1159 , #1224 )

Dns cache size and timeout options ( #1132 )

support namespace prefix in xmliter_lxml ( #963 )

Reactor threadpool max size setting ( #1123 )

Allow spiders to return dicts. ( #1081 )

Add Response.urljoin() helper ( #1086 )

look in ~/.config/scrapy.cfg for user config ( #1098 )

handle TLS SNI ( #1101 )

Selectorlist extract first ( #624 , #1145 )

Added JmesSelect ( #1016 )

add gzip compression to filesystem http cache backend ( #1020 )

CSS support in link extractors ( #983 )

httpcache dont_cache meta #19 #689 ( #821 )

add signal to be sent when request is dropped by the scheduler ( #961 )

avoid download large response ( #946 )

Allow to specify the quotechar in CSVFeedSpider ( #882 )

Add referer to “Spider error processing” log message ( #795 )

process robots.txt once ( #896 )

GSoC Per-spider settings ( #854 )

Add project name validation ( #817 )

GSoC API cleanup ( #816 , #1128 , #1147 , #1148 , #1156 , #1185 , #1187 , #1258 , #1268 , #1276 , #1285 , #1284 )

Be more responsive with IO operations ( #1074 and #1075 )

Do leveldb compaction for httpcache on closing ( #1297 )

Deprecations and Removals

Deprecate htmlparser link extractor ( #1205 )

remove deprecated code from FeedExporter ( #1155 )

a leftover for.15 compatibility ( #925 )

drop support for CONCURRENT_REQUESTS_PER_SPIDER ( #895 )

Drop old engine code ( #911 )

Deprecate SgmlLinkExtractor ( #777 )

Relocations

Move exporters/init.py to exporters.py ( #1242 )

Move base classes to their packages ( #1218 , #1233 )

Module relocation ( #1181 , #1210 )

rename SpiderManager to SpiderLoader ( #1166 )

Remove djangoitem ( #1177 )

remove scrapy deploy command ( #1102 )

dissolve contrib_exp ( #1134 )

Deleted bin folder from root, fixes #913 ( #914 )

Remove jsonrpc based webservice ( #859 )

Move Test cases under project root dir ( #827 , #841 )

Fix backward incompatibility for relocated paths in settings ( #1267 )

Documentation

CrawlerProcess documentation ( #1190 )

Favoring web scraping over screen scraping in the descriptions ( #1188 )

Some improvements for Scrapy tutorial ( #1180 )

Documenting Files Pipeline together with Images Pipeline ( #1150 )

deployment docs tweaks ( #1164 )

Added deployment section covering scrapyd-deploy and shub ( #1124 )

Adding more settings to project template ( #1073 )

some improvements to overview page ( #1106 )

Updated link in docs/topics/architecture.rst ( #647 )

DOC reorder topics ( #1022 )

updating list of Request.meta special keys ( #1071 )

DOC document download_timeout ( #898 )

DOC simplify extension docs ( #893 )

Leaks docs ( #894 )

DOC document from_crawler method for item pipelines ( #904 )

Spider_error doesn’t support deferreds ( #1292 )

Corrections & Sphinx related fixes ( #1220 , #1219 , #1196 , #1172 , #1171 , #1169 , #1160 , #1154 , #1127 , #1112 , #1105 , #1041 , #1082 , #1033 , #944 , #866 , #864 , #796 , #1260 , #1271 , #1293 , #1298 )

Bugfixes

Item multi inheritance fix ( #353 , #1228 )

ItemLoader.load_item: iterate over copy of fields ( #722 )

Fix Unhandled error in Deferred (RobotsTxtMiddleware) ( #1131 , #1197 )

Force to read DOWNLOAD_TIMEOUT as int ( #954 )

scrapy.utils.misc.load_object should print full traceback ( #902 )

Fix bug for “.local” host name ( #878 )

Fix for Enabled extensions, middlewares, pipelines info not printed anymore ( #879 )

fix dont_merge_cookies bad behaviour when set to false on meta ( #846 )

Python 3 In Progress Support

disable scrapy.telnet if twisted.conch is not available ( #1161 )

fix Python 3 syntax errors in ajaxcrawl.py ( #1162 )

more python3 compatibility changes for urllib ( #1121 )

assertItemsEqual was renamed to assertCountEqual in Python 3. ( #1070 )

Import unittest.mock if available. ( #1066 )

updated deprecated cgi.parse_qsl to use six’s parse_qsl ( #909 )

Prevent Python 3 port regressions ( #830 )

PY3: use MutableMapping for python 3 ( #810 )

PY3: use six.BytesIO and six.moves.cStringIO ( #803 )

PY3: fix xmlrpclib and email imports ( #801 )

PY3: use six for robotparser and urlparse ( #800 )

PY3: use six.iterkeys, six.iteritems, and tempfile ( #799 )

PY3: fix has_key and use six.moves.configparser ( #798 )

PY3: use six.moves.cPickle ( #797 )

PY3 make it possible to run some tests in Python3 ( #776 )

Tests

remove unnecessary lines from py3-ignores ( #1243 )

Fix remaining warnings from pytest while collecting tests ( #1206 )

Add docs build to travis ( #1234 )

TST don’t collect tests from deprecated modules. ( #1165 )

install service_identity package in tests to prevent warnings ( #1168 )

Fix deprecated settings API in tests ( #1152 )

Add test for webclient with POST method and no body given ( #1089 )

py3-ignores.txt supports comments ( #1044 )

modernize some of the asserts ( #835 )

selector.repr test ( #779 )

Code refactoring

CSVFeedSpider cleanup: use iterate_spider_output ( #1079 )

remove unnecessary check from scrapy.utils.spider.iter_spider_output ( #1078 )

Pydispatch pep8 ( #992 )

Removed unused ‘load=False’ parameter from walk_modules() ( #871 )

For consistency, use job_dir helper in SpiderState extension. ( #805 )

rename “sflo” local variables to less cryptic “log_observer” ( #775 )

encode invalid xpath with unicode_escape under PY2 ( commit 07cb3e5 )

fix IPython shell scope issue and load IPython user config ( commit 2c8e573 )

Fix small typo in the docs ( commit d694019 )

Fix small typo ( commit f92fa83 )

Converted sel.xpath() calls to response.xpath() in Extracting the data ( commit c2c6d15 )

Support new _getEndpoint Agent signatures on Twisted 15.0.0 ( commit 540b9bc )

DOC a couple more references are fixed ( commit b4c454b )

DOC fix a reference ( commit e3c1260 )

t.i.b.ThreadedResolver is now a new-style class ( commit 9e13f42 )

S3DownloadHandler: fix auth for requests with quoted paths/query params ( commit cdb9a0b )

fixed the variable types in mailsender documentation ( commit bb3a848 )

Reset items_scraped instead of item_count ( commit edb07a4 )

Tentative attention message about what document to read for contributions ( commit 7ee6f7a )

mitmproxy 0.10.1 needs netlib 0.10.1 too ( commit 874fcdd )

pin mitmproxy 0.10.1 as >0.11 does not work with tests ( commit c6b21f0 )

Test the parse command locally instead of against an external url ( commit c3a6628 )

Patches Twisted issue while closing the connection pool on HTTPDownloadHandler ( commit d0bf957 )

Updates documentation on dynamic item classes. ( commit eeb589a )

Merge pull request #943 from Lazar-T/patch-3 ( commit 5fdab02 )

typo ( commit b0ae199 )

pywin32 is required by Twisted. closes #937 ( commit 5cb0cfb )

Update install.rst ( commit 781286b )

Merge pull request #928 from Lazar-T/patch-1 ( commit b415d04 )

comma instead of fullstop ( commit 627b9ba )

Merge pull request #885 from jsma/patch-1 ( commit de909ad )

Update request-response.rst ( commit 3f3263d )

SgmlLinkExtractor - fix for parsing <area> tag with Unicode present ( commit 49b40f0 )

pem file is used by mockserver and required by scrapy bench ( commit 5eddc68b63 )

scrapy bench needs scrapy.tests* ( commit d6cb999 )

no need to waste travis-ci time on py3 for 0.24 ( commit 8e080c1 )

Update installation docs ( commit 1d0c096 )

There is a trove classifier for Scrapy framework! ( commit 4c701d7 )

update other places where w3lib version is mentioned ( commit d109c13 )

Update w3lib requirement to 1.8.0 ( commit 39d2ce5 )

Use w3lib.html.replace_entities() (remove_entities() is deprecated) ( commit 180d3ad )

set zip_safe=False ( commit a51ee8b )

do not ship tests package ( commit ee3b371 )

scrapy.bat is not needed anymore ( commit c3861cf )

Modernize setup.py ( commit 362e322 )

headers can not handle non-string values ( commit 94a5c65 )

fix ftp test cases ( commit a274a7f )

The sum up of travis-ci builds are taking like 50min to complete ( commit ae1e2cc )

Update shell.rst typo ( commit e49c96a )

removes weird indentation in the shell results ( commit 1ca489d )

improved explanations, clarified blog post as source, added link for XPath string functions in the spec ( commit 65c8f05 )

renamed UserTimeoutError and ServerTimeouterror #583 ( commit 037f6ab )

adding some xpath tips to selectors docs ( commit 2d103e0 )

fix tests to account for https://github.com/scrapy/w3lib/pull/23 ( commit f8d366a )

get_func_args maximum recursion fix #728 ( commit 81344ea )

Updated input/output processor example according to #560. ( commit f7c4ea8 )

Fixed Python syntax in tutorial. ( commit db59ed9 )

Add test case for tunneling proxy ( commit f090260 )

Bugfix for leaking Proxy-Authorization header to remote host when using tunneling ( commit d8793af )

Extract links from XHTML documents with MIME-Type “application/xml” ( commit ed1f376 )

Merge pull request #793 from roysc/patch-1 ( commit 91a1106 )

Fix typo in commands.rst ( commit 743e1e2 )

better testcase for settings.overrides.setdefault ( commit e22daaf )

Using CRLF as line marker according to http 1.1 definition ( commit 5ec430b )

Use a mutable mapping to proxy deprecated settings.overrides and settings.defaults attribute ( commit e5e8133 )

there is not support for python3 yet ( commit 3cd6146 )

Update python compatible version set to Debian packages ( commit fa5d76b )

DOC fix formatting in release notes ( commit c6a9e20 )

Fix deprecated CrawlerSettings and increase backward compatibility with .defaults attribute ( commit 8e3f20a )

Enhancements 

Improve Scrapy top-level namespace ( #494 , #684 )

Add selector shortcuts to responses ( #554 , #690 )

Add new lxml based LinkExtractor to replace unmaintained SgmlLinkExtractor ( #559 , #761 , #763 )

Cleanup settings API - part of per-spider settings GSoC project ( #737 )

Add UTF8 encoding header to templates ( #688 , #762 )

Telnet console now binds to 127.0.0.1 by default ( #699 )

Update Debian/Ubuntu install instructions ( #509 , #549 )

Disable smart strings in lxml XPath evaluations ( #535 )

Restore filesystem based cache as default for http cache middleware ( #541 , #500 , #571 )

Expose current crawler in Scrapy shell ( #557 )

Improve testsuite comparing CSV and XML exporters ( #570 )

New offsite/filtered and offsite/domains stats ( #566 )

Support process_links as generator in CrawlSpider ( #555 )

Verbose logging and new stats counters for DupeFilter ( #553 )

Add a mimetype parameter to MailSender.send() ( #602 )

Generalize file pipeline log messages ( #622 )

Replace unencodeable codepoints with html entities in SGMLLinkExtractor ( #565 )

Converted SEP documents to rst format ( #629 , #630 , #638 , #632 , #636 , #640 , #635 , #634 , #639 , #637 , #631 , #633 , #641 , #642 )

Tests and docs for clickdata’s nr index in FormRequest ( #646 , #645 )

Allow to disable a downloader handler just like any other component ( #650 )

Log when a request is discarded after too many redirections ( #654 )

Log error responses if they are not handled by spider callbacks ( #612 , #656 )

Add content-type check to http compression mw ( #193 , #660 )

Run pypy tests using latest pypi from ppa ( #674 )

Run test suite using pytest instead of trial ( #679 )

Build docs and check for dead links in tox environment ( #687 )

Make scrapy.version_info a tuple of integers ( #681 , #692 )

Infer exporter’s output format from filename extensions ( #546 , #659 , #760 )

Support case-insensitive domains in url_is_from_any_domain() ( #693 )

Remove pep8 warnings in project and spider templates ( #698 )

Tests and docs for request_fingerprint function ( #597 )

Update SEP-19 for GSoC project per-spider settings ( #705 )

Set exit code to non-zero when contracts fails ( #727 )

Add a setting to control what class is instantiated as Downloader component ( #738 )

Pass response in item_dropped signal ( #724 )

Improve scrapy check contracts command ( #733 , #752 )

Document spider.closed() shortcut ( #719 )

Document request_scheduled signal ( #746 )

Add a note about reporting security issues ( #697 )

Add LevelDB http cache storage backend ( #626 , #500 )

Sort spider list output of scrapy list command ( #742 )

Multiple documentation enhancements and fixes ( #575 , #587 , #590 , #596 , #610 , #617 , #618 , #627 , #613 , #643 , #654 , #675 , #663 , #711 , #714 )

Bugfixes 

Encode unicode URL value when creating Links in RegexLinkExtractor ( #561 )

Ignore None values in ItemLoader processors ( #556 )

Fix link text when there is an inner tag in SGMLLinkExtractor and HtmlParserLinkExtractor ( #485 , #574 )

Fix wrong checks on subclassing of deprecated classes ( #581 , #584 )

Handle errors caused by inspect.stack() failures ( #582 )

Fix a reference to unexistent engine attribute ( #593 , #594 )

Fix dynamic itemclass example usage of type() ( #603 )

Use lucasdemarchi/codespell to fix typos ( #628 )

Fix default value of attrs argument in SgmlLinkExtractor to be tuple ( #661 )

Fix XXE flaw in sitemap reader ( #676 )

Fix engine to support filtered start requests ( #707 )

Fix offsite middleware case on urls with no hostnames ( #745 )

Testsuite doesn’t require PIL anymore ( #585 )

fix a reference to unexistent engine.slots. closes #593 ( commit 13c099a )

downloaderMW doc typo (spiderMW doc copy remnant) ( commit 8ae11bf )

Correct typos ( commit 1346037 )

localhost666 can resolve under certain circumstances ( commit 2ec2279 )

test inspect.stack failure ( commit cc3eda3 )

Handle cases when inspect.stack() fails ( commit 8cb44f9 )

Fix wrong checks on subclassing of deprecated classes. closes #581 ( commit 46d98d6 )

Docs: 4-space indent for final spider example ( commit 13846de )

Fix HtmlParserLinkExtractor and tests after #485 merge ( commit 368a946 )

BaseSgmlLinkExtractor: Fixed the missing space when the link has an inner tag ( commit b566388 )

BaseSgmlLinkExtractor: Added unit test of a link with an inner tag ( commit c1cb418 )

BaseSgmlLinkExtractor: Fixed unknown_endtag() so that it only set current_link=None when the end tag match the opening tag ( commit 7e4d627 )

Fix tests for Travis-CI build ( commit 76c7e20 )

replace unencodeable codepoints with html entities. fixes #562 and #285 ( commit 5f87b17 )

RegexLinkExtractor: encode URL unicode value when creating Links ( commit d0ee545 )

Updated the tutorial crawl output with latest output. ( commit 8da65de )

Updated shell docs with the crawler reference and fixed the actual shell output. ( commit 875b9ab )

PEP8 minor edits. ( commit f89efaf )

Expose current crawler in the Scrapy shell. ( commit 5349cec )

Unused re import and PEP8 minor edits. ( commit 387f414 )

Ignore None’s values when using the ItemLoader. ( commit 0632546 )

DOC Fixed HTTPCACHE_STORAGE typo in the default value which is now Filesystem instead Dbm. ( commit cde9a8c )

show Ubuntu setup instructions as literal code ( commit fb5c9c5 )

Update Ubuntu installation instructions ( commit 70fb105 )

Merge pull request #550 from stray-leone/patch-1 ( commit 6f70b6a )

modify the version of Scrapy Ubuntu package ( commit 725900d )

fix 0.22.0 release date ( commit af0219a )

fix typos in news.rst and remove (not released yet) header ( commit b7f58f4 )

Enhancements 

[ Backward incompatible ] Switched HTTPCacheMiddleware backend to filesystem ( #541 ) To restore old backend set HTTPCACHE_STORAGE to scrapy.contrib.httpcache.DbmCacheStorage

Proxy https:// urls using CONNECT method ( #392 , #397 )

Add a middleware to crawl ajax crawlable pages as defined by google ( #343 )

Rename scrapy.spider.BaseSpider to scrapy.spider.Spider ( #510 , #519 )

Selectors register EXSLT namespaces by default ( #472 )

Unify item loaders similar to selectors renaming ( #461 )

Make RFPDupeFilter class easily subclassable ( #533 )

Improve test coverage and forthcoming Python 3 support ( #525 )

Promote startup info on settings and middleware to INFO level ( #520 )

Support partials in get_func_args util ( #506 , #504 )

Allow running individual tests via tox ( #503 )

Update extensions ignored by link extractors ( #498 )

Add middleware methods to get files/images/thumbs paths ( #490 )

Improve offsite middleware tests ( #478 )

Add a way to skip default Referer header set by RefererMiddleware ( #475 )

Do not send x-gzip in default Accept-Encoding header ( #469 )

Support defining http error handling using settings ( #466 )

Use modern python idioms wherever you find legacies ( #497 )

Improve and correct documentation ( #527 , #524 , #521 , #517 , #512 , #505 , #502 , #489 , #465 , #460 , #425 , #536 )

Fixes 

Update Selector class imports in CrawlSpider template ( #484 )

Fix unexistent reference to engine.slots ( #464 )

Do not try to call body_as_unicode() on a non-TextResponse instance ( #462 )

Warn when subclassing XPathItemLoader, previously it only warned on instantiation. ( #523 )

Warn when subclassing XPathSelector, previously it only warned on instantiation. ( #537 )

Multiple fixes to memory stats ( #531 , #530 , #529 )

Fix overriding url in FormRequest.from_response() ( #507 )

Fix tests runner under pip 1.5 ( #513 )

Fix logging error when spider name is unicode ( #479 )

Update CrawlSpider Template with Selector changes ( commit 6d1457d )

fix method name in tutorial. closes GH-480 ( commit b4fc359

include_package_data is required to build wheels from published sources ( commit 5ba1ad5 )

process_parallel was leaking the failures on its internal deferreds. closes #458 ( commit 419a780 )

Enhancements 

New Selector’s API including CSS selectors ( #395 and #426 ),

Request/Response url/body attributes are now immutable (modifying them had been deprecated for a long time)

ITEM_PIPELINES is now defined as a dict (instead of a list)

Sitemap spider can fetch alternate URLs ( #360 )

Selector.remove_namespaces() now remove namespaces from element’s attributes. ( #416 )

Paved the road for Python 3.3+ ( #435 , #436 , #431 , #452 )

New item exporter using native python types with nesting support ( #366 )

Tune HTTP1.1 pool size so it matches concurrency defined by settings ( commit b43b5f575 )

scrapy.mail.MailSender now can connect over TLS or upgrade using STARTTLS ( #327 )

New FilesPipeline with functionality factored out from ImagesPipeline ( #370 , #409 )

Recommend Pillow instead of PIL for image handling ( #317 )

Added Debian packages for Ubuntu Quantal and Raring ( commit 86230c0 )

Mock server (used for tests) can listen for HTTPS requests ( #410 )

Remove multi spider support from multiple core components ( #422 , #421 , #420 , #419 , #423 , #418 )

Travis-CI now tests Scrapy changes against development versions of w3lib and queuelib python packages.

Add pypy 2.1 to continuous integration tests ( commit ecfa7431 )

Pylinted, pep8 and removed old-style exceptions from source ( #430 , #432 )

Use importlib for parametric imports ( #445 )

Handle a regression introduced in Python 2.7.5 that affects XmlItemExporter ( #372 )

Bugfix crawling shutdown on SIGINT ( #450 )

Do not submit reset type inputs in FormRequest.from_response ( commit b326b87 )

Do not silence download errors when request errback raises an exception ( commit 684cfc0 )

Bugfixes 

Fix tests under Django 1.6 ( commit b6bed44c )

Lot of bugfixes to retry middleware under disconnections using HTTP 1.1 download handler

Fix inconsistencies among Twisted releases ( #406 )

Fix Scrapy shell bugs ( #418 , #407 )

Fix invalid variable name in setup.py ( #429 )

Fix tutorial references ( #387 )

Improve request-response docs ( #391 )

Improve best practices docs ( #399 , #400 , #401 , #402 )

Improve django integration docs ( #404 )

Document bindaddress request meta ( commit 37c24e01d7 )

Improve Request class documentation ( #226 )

Other 

Dropped Python 2.6 support ( #448 )

Add cssselect python package as install dependency

Drop libxml2 and multi selector’s backend support, lxml is required from now on.

Minimum Twisted version increased to 10.0.0, dropped Twisted 8.0 support.

Running test suite now requires mock python library ( #390 )

Thanks 

Thanks to everyone who contribute to this release!

List of contributors sorted by number of commits:

69 Daniel Graña < dangra @...> 37 Pablo Hoffman < pablo @...> 13 Mikhail Korobov < kmike84 @...> 9 Alex Cepoi < alex . cepoi @...> 9 alexanderlukanin13 < alexander . lukanin .13 @...> 8 Rolando Espinoza La fuente < darkrho @...> 8 Lukasz Biedrycki < lukasz . biedrycki @...> 6 Nicolas Ramirez < nramirez . uy @...> 3 Paul Tremberth < paul . tremberth @...> 2 Martin Olveyra < molveyra @...> 2 Stefan < misc @...> 2 Rolando Espinoza < darkrho @...> 2 Loren Davie < loren @...> 2 irgmedeiros < irgmedeiros @...> 1 Stefan Koch < taikano @...> 1 Stefan < cct @...> 1 scraperdragon < dragon @...> 1 Kumara Tharmalingam < ktharmal @...> 1 Francesco Piccinno < stack . box @...> 1 Marcos Campal < duendex @...> 1 Dragon Dave < dragon @...> 1 Capi Etheriel < barraponto @...> 1 cacovsky < amarquesferraz @...> 1 Berend Iwema < berend @...>

IPython refuses to update the namespace. fix #396 ( commit 3d32c4f )

Fix AlreadyCalledError replacing a request in shell command. closes #407 ( commit b1d8919 )

Fix start_requests() laziness and early hangs ( commit 89faf52 )

fix regression on lazy evaluation of start requests ( commit 12693a5 )

forms: do not submit reset inputs ( commit e429f63 )

increase unittest timeouts to decrease travis false positive failures ( commit 912202e )

backport master fixes to json exporter ( commit cfc2d46 )

Fix permission and set umask before generating sdist tarball ( commit 06149e0 )

Backport scrapy check command fixes and backward compatible multi crawler process( #339 )

remove extra import added by cherry picked changes ( commit d20304e )

fix crawling tests under twisted pre 11.0.0 ( commit 1994f38 )

py26 can not format zero length fields {} ( commit abf756f )

test PotentiaDataLoss errors on unbound responses ( commit b15470d )

Treat responses without content-length or Transfer-Encoding as good responses ( commit c4bf324 )

do no include ResponseFailed if http11 handler is not enabled ( commit 6cbe684 )

New HTTP client wraps connection lost in ResponseFailed exception. fix #373 ( commit 1a20bba )

limit travis-ci build matrix ( commit 3b01bb8 )

Merge pull request #375 from peterarenot/patch-1 ( commit fa766d7 )

Fixed so it refers to the correct folder ( commit 3283809 )

added Quantal & Raring to support Ubuntu releases ( commit 1411923 )

fix retry middleware which didn’t retry certain connection errors after the upgrade to http1 client, closes GH-373 ( commit bb35ed0 )

fix XmlItemExporter in Python 2.7.4 and 2.7.5 ( commit de3e451 )

minor updates to 0.18 release notes ( commit c45e5f1 )

fix contributors list format ( commit 0b60031 )

Lot of improvements to testsuite run using Tox, including a way to test on pypi

Handle GET parameters for AJAX crawlable urls ( commit 3fe2a32 )

Use lxml recover option to parse sitemaps ( #347 )

Bugfix cookie merging by hostname and not by netloc ( #352 )

Support disabling HttpCompressionMiddleware using a flag setting ( #359 )

Support xml namespaces using iternodes parser in XMLFeedSpider ( #12 )

Support dont_cache request meta flag ( #19 )

Bugfix scrapy.utils.gz.gunzip broken by changes in python 2.7.4 ( commit 4dc76e )

Bugfix url encoding on SgmlLinkExtractor ( #24 )

Bugfix TakeFirst processor shouldn’t discard zero (0) value ( #59 )

Support nested items in xml exporter ( #66 )

Improve cookies handling performance ( #77 )

Log dupe filtered requests once ( #105 )

Split redirection middleware into status and meta based middlewares ( #78 )

Use HTTP1.1 as default downloader handler ( #109 and #318 )

Support xpath form selection on FormRequest.from_response ( #185 )

Bugfix unicode decoding error on SgmlLinkExtractor ( #199 )

Bugfix signal dispatching on pypi interpreter ( #205 )

Improve request delay and concurrency handling ( #206 )

Add RFC2616 cache policy to HttpCacheMiddleware ( #212 )

Allow customization of messages logged by engine ( #214 )

Multiples improvements to DjangoItem ( #217 , #218 , #221 )

Extend Scrapy commands using setuptools entry points ( #260 )

Allow spider allowed_domains value to be set/tuple ( #261 )

Support settings.getdict ( #269 )

Simplify internal scrapy.core.scraper slot handling ( #271 )

Added Item.copy ( #290 )

Collect idle downloader slots ( #297 )

Add ftp:// scheme downloader handler ( #329 )

Added downloader benchmark webserver and spider tools Benchmarking

Moved persistent (on disk) queues to a separate project ( queuelib ) which Scrapy now depends on

Add Scrapy commands using external libraries ( #260 )

Added --pdb option to scrapy command line tool

Added XPathSelector.remove_namespaces which allows to remove all namespaces from XML documents for convenience (to work with namespace-less XPaths). Documented in Selectors .

Several improvements to spider contracts

New default middleware named MetaRefreshMiddleware that handles meta-refresh html tag redirections,

MetaRefreshMiddleware and RedirectMiddleware have different priorities to address #62

added from_crawler method to spiders

added system tests with mock server

more improvements to macOS compatibility (thanks Alex Cepoi)

several more cleanups to singletons and multi-spider support (thanks Nicolas Ramirez)

support custom download slots

added –spider option to “shell” command.

log overridden settings when Scrapy starts

Thanks to everyone who contribute to this release. Here is a list of contributors sorted by number of commits:

130 Pablo Hoffman < pablo @...> 97 Daniel Graña < dangra @...> 20 Nicolás Ramírez < nramirez . uy @...> 13 Mikhail Korobov < kmike84 @...> 12 Pedro Faustino < pedrobandim @...> 11 Steven Almeroth < sroth77 @...> 5 Rolando Espinoza La fuente < darkrho @...> 4 Michal Danilak < mimino . coder @...> 4 Alex Cepoi < alex . cepoi @...> 4 Alexandr N Zamaraev ( aka tonal ) < tonal @...> 3 paul < paul . tremberth @...> 3 Martin Olveyra < molveyra @...> 3 Jordi Llonch < llonchj @...> 3 arijitchakraborty < myself . arijit @...> 2 Shane Evans < shane . evans @...> 2 joehillen < joehillen @...> 2 Hart < HartSimha @...> 2 Dan < ellisd23 @...> 1 Zuhao Wan < wanzuhao @...> 1 whodatninja < blake @...> 1 vkrest < v . krestiannykov @...> 1 tpeng < pengtaoo @...> 1 Tom Mortimer - Jones < tom @...> 1 Rocio Aramberri < roschegel @...> 1 Pedro < pedro @...> 1 notsobad < wangxiaohugg @...> 1 Natan L < kuyanatan . nlao @...> 1 Mark Grey < mark . grey @...> 1 Luan < luanpab @...> 1 Libor Nenadál < libor . nenadal @...> 1 Juan M Uys < opyate @...> 1 Jonas Brunsgaard < jonas . brunsgaard @...> 1 Ilya Baryshev < baryshev @...> 1 Hasnain Lakhani < m . hasnain . lakhani @...> 1 Emanuel Schorsch < emschorsch @...> 1 Chris Tilden < chris . tilden @...> 1 Capi Etheriel < barraponto @...> 1 cacovsky < amarquesferraz @...> 1 Berend Iwema < berend @...>

obey request method when Scrapy deploy is redirected to a new endpoint ( commit 8c4fcee )

fix inaccurate downloader middleware documentation. refs #280 ( commit 40667cb )

doc: remove links to diveintopython.org, which is no longer available. closes #246 ( commit bd58bfa )

Find form nodes in invalid html5 documents ( commit e3d6945 )

Fix typo labeling attrs type bool instead of list ( commit a274276 )

fixes spelling errors in documentation ( commit 6d2b3aa )

add doc about disabling an extension. refs #132 ( commit c90de33 )

Fixed error message formatting. log.err() doesn’t support cool formatting and when error occurred, the message was: “ERROR: Error processing %(item)s” ( commit c16150c )

lint and improve images pipeline error logging ( commit 56b45fc )

fixed doc typos ( commit 243be84 )

add documentation topics: Broad Crawls & Common Practices ( commit 1fbb715 )

fix bug in Scrapy parse command when spider is not specified explicitly. closes #209 ( commit c72e682 )

Update docs/topics/commands.rst ( commit 28eac7a )

Remove concurrency limitation when using download delays and still ensure inter-request delays are enforced ( commit 487b9b5 )

add error details when image pipeline fails ( commit 8232569 )

improve macOS compatibility ( commit 8dcf8aa )

setup.py: use README.rst to populate long_description ( commit 7b5310d )

doc: removed obsolete references to ClientForm ( commit 80f9bb6 )

correct docs for default storage backend ( commit 2aa491b )

doc: removed broken proxyhub link from FAQ ( commit bdf61c4 )

Fixed docs typo in SpiderOpenCloseLogging example ( commit 7184094 )

Scrapy contracts: python2.6 compat ( commit a4a9199 )

Scrapy contracts verbose option ( commit ec41673 )

proper unittest-like output for Scrapy contracts ( commit 86635e4 )

added open_in_browser to debugging doc ( commit c9b690d )

removed reference to global Scrapy stats from settings doc ( commit dd55067 )

Fix SpiderState bug in Windows platforms ( commit 58998f4 )

fixed LogStats extension, which got broken after a wrong merge before the 0.16 release ( commit 8c780fd )

better backward compatibility for scrapy.conf.settings ( commit 3403089 )

extended documentation on how to access crawler stats from extensions ( commit c4da0b5 )

removed .hgtags (no longer needed now that Scrapy uses git) ( commit d52c188 )

fix dashes under rst headers ( commit fa4f7f9 )

set release date for 0.16.0 in news ( commit e292246 )

Scrapy changes:

added Spiders Contracts , a mechanism for testing spiders in a formal/reproducible way

added options -o and -t to the runspider command

documented AutoThrottle extension and added to extensions installed by default. You still need to enable it with 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, backward compatibility is kept on the Stats Collector API and signals.

added a process_start_requests() method to spider middlewares

dropped Signals singleton. Signals should now be accessed 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 Core 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 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 module

dropped support for Python 2.5. See https://www.zyte.com/blog/scrapy-0-15-dropping-support-for-python-2-5/

dropped support for Twisted 2.5

added REFERER_ENABLED setting, to control referer middleware

changed default user agent to: Scrapy/VERSION (+http://scrapy.org)

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 DjangoItem to main contrib

LogFormatter method now return dicts(instead of strings) to support lazy formatting ( #164 , commit dcef7b0 )

downloader handlers ( DOWNLOAD_HANDLERS setting) now receive settings as the first argument of the init method

replaced memory usage accounting with (more portable) resource module, removed scrapy.utils.memory module

removed signal: scrapy.mail.mail_sent

removed TRACK_REFS setting, now 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

added precise to supported Ubuntu distros ( commit b7e46df )

fixed bug in json-rpc webservice reported in https://groups.google.com/forum/#!topic/scrapy-users/qgVBmFybNAQ/discussion . also removed no longer supported ‘run’ command from extras/scrapy-ws.py ( commit 340fbdb )

meta tag attributes for content-type http equiv can be in any order. #123 ( commit 0cb68af )

replace “import Image” by more standard “from PIL import Image”. closes #88 ( commit 4d17048 )

return trial status as bin/runtests.sh exit value. #118 ( commit b7b2e7f )

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 )

don’t 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 )

move buffer pointing to start of file before computing checksum. refs #92 ( commit 6a5bef2 )

Compute image checksum before persisting images. closes #92 ( commit 9817df1 )

remove leaking references in cached failures ( commit 673a120 )

fixed bug in MemoryUsage extension: get_engine_status() takes exactly 1 argument (0 given) ( commit 11133e9 )

fixed struct.error on http compression middleware. closes #87 ( commit 1423140 )

ajax crawling wasn’t expanding for unicode urls ( commit 0de3fb4 )

Catch start_requests() iterator errors. refs #83 ( commit 454a21d )

Speed-up libxml2 XPathSelector ( commit 2fbd662 )

updated versioning doc according to recent changes ( commit 0a070f5 )

scrapyd: fixed documentation link ( commit 2b4e4c3 )

extras/makedeb.py: no longer obtaining version from git ( commit caffe0e )

extras/makedeb.py: no longer obtaining version from git ( commit caffe0e )

bumped version to 0.14.1 ( commit 6cb9e1c )

fixed reference to tutorial directory ( commit 4b86bd6 )

doc: removed duplicated callback argument from Request.replace() ( commit 1aeccdd )

fixed formatting of scrapyd doc ( commit 8bf19e6 )

Dump stacks for all running threads and fix engine status dumped by StackTraceDump extension ( commit 14a8e6e )

added comment about why we disable ssl on boto images upload ( commit 5223575 )

SSL handshaking hangs when doing too many parallel connections to S3 ( commit 63d583d )

change tutorial to follow changes on dmoz site ( commit bcb3198 )

Avoid _disconnectedDeferred AttributeError exception in Twisted>=11.1.0 ( commit 98f3f87 )

allow spider to set autothrottle max concurrency ( commit 175a4b5 )

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

New features and improvements 

Added SMTP-AUTH support to scrapy.mail

New settings added: MAIL_USER , MAIL_PASS ( r2065 | #149)

Added new scrapy-ctl view command - To view URL in the browser, as seen by Scrapy ( r2039 )

Added web service for controlling Scrapy process (this also deprecates the web console. ( r2053 | #167)

Support for running Scrapy as a service, for production systems ( r1988 , r2054 , r2055 , r2056 , r2057 | #168)

Added wrapper induction library (documentation only available in source code for now). ( r2011 )

Simplified and improved response encoding support ( r1961 , r1969 )

Added LOG_ENCODING setting ( r1956 , documentation available)

Added RANDOMIZE_DOWNLOAD_DELAY setting (enabled by default) ( r1923 , doc available)

MailSender is no longer IO-blocking ( r1955 | #146)

Linkextractors and new Crawlspider now handle relative base tag urls ( r1960 | #148)

Several improvements to Item Loaders and processors ( r2022 , r2023 , r2024 , r2025 , r2026 , r2027 , r2028 , r2029 , r2030 )

Added support for adding variables to telnet console ( r2047 | #165)

Support for requests without callbacks ( r2050 | #166)

API changes 

Change Spider.domain_name to Spider.name (SEP-012, r1975 )

Response.encoding is now the detected encoding ( r1961 )

HttpErrorMiddleware now returns None or raises an exception ( r2006 | #157)

scrapy.command modules relocation ( r2035 , r2036 , r2037 )

Added ExecutionQueue for feeding spiders to scrape ( r2034 )

Removed ExecutionEngine singleton ( r2039 )

Ported S3ImagesStore (images pipeline) to use boto and threads ( r2033 )

Moved module: scrapy.management.telnet to scrapy.telnet ( r2047 )

Changes to default settings 

Changed default SCHEDULER_ORDER to DFO ( r1939 )

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

New features 

Added DEFAULT_RESPONSE_ENCODING setting ( r1809 )

Added dont_click argument to FormRequest.from_response() method ( r1813 , r1816 )

Added clickdata argument to FormRequest.from_response() method ( r1802 , r1803 )

Added support for HTTP proxies ( HttpProxyMiddleware ) ( r1781 , r1785 )

Offsite spider middleware now logs messages when filtering out requests ( r1841 )

Backward-incompatible changes 

Changed scrapy.utils.response.get_meta_refresh() signature ( r1804 )

Removed deprecated scrapy.item.ScrapedItem class - use scrapy.item.Item instead ( r1838 )

Removed deprecated scrapy.xpath module - use scrapy.selector instead. ( r1836 )

Removed deprecated core.signals.domain_open signal - use core.signals.domain_opened instead ( r1822 )

• log.msg() now receives a spider argument ( r1822 )

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) ( r1827 | #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 ( r1849 | #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 ( r1833 )
• Its settings were also renamed:

CLOSEDOMAIN_TIMEOUT to CLOSESPIDER_TIMEOUT

CLOSEDOMAIN_ITEMCOUNT to CLOSESPIDER_ITEMCOUNT

Removed deprecated SCRAPYSETTINGS_MODULE environment variable - use SCRAPY_SETTINGS_MODULE instead ( r1840 )

Renamed setting: REQUESTS_PER_DOMAIN to CONCURRENT_REQUESTS_PER_SPIDER ( r1830 , r1844 )

Renamed setting: CONCURRENT_DOMAINS to CONCURRENT_SPIDERS ( r1830 )

Refactored HTTP Cache middleware

HTTP Cache middleware has been heavily refactored, retaining the same functionality except for the domain sectorization which was removed. ( r1843 )

Renamed exception: DontCloseDomain to DontCloseSpider ( r1859 | #120)

Renamed extension: DelayedCloseDomain to SpiderCloseDelay ( r1861 | #121)

Removed obsolete scrapy.utils.markup.remove_escape_chars function - use scrapy.utils.markup.replace_escape_chars instead ( r1865 )

First release of Scrapy.