Package: scrapy-redis-statictyped
Scrapy-RedisRedis-based components for Scrapy.Free software: MIT licenseDocumentation:https://scrapy-redis.readthedocs.org.Python versions: 2.7, 3.4+FeaturesDistributed crawling/scrapingYou can start multiple spider instances that share a single redis queue.
Best suitable for broad multi-domain crawls.Distributed post-processingScraped items gets pushed into a redis queued meaning that you can start as
many as needed post-processing processes sharing the items queue.Scrapy plug-and-play componentsScheduler + Duplication Filter, Item Pipeline, Base Spiders.NoteThis features cover the basic case of distributing the workload across multiple workers. If you need more features like URL expiration, advanced URL prioritization, etc., we suggest you to take a look at theFronteraproject.RequirementsPython 2.7, 3.4 or 3.5Redis >= 2.8Scrapy>= 1.1redis-py>= 2.10UsageUse the following settings in your project:# Enables scheduling storing requests queue in redis.SCHEDULER="scrapy_redis.scheduler.Scheduler"# Ensure all spiders share same duplicates filter through redis.DUPEFILTER_CLASS="scrapy_redis.dupefilter.RFPDupeFilter"# Enables stats shared based on RedisSTATS_CLASS="scrapy_redis.stats.RedisStatsCollector"# Default requests serializer is pickle, but it can be changed to any module# with loads and dumps functions. Note that pickle is not compatible between# python versions.# Caveat: In python 3.x, the serializer must return strings keys and support# bytes as values. Because of this reason the json or msgpack module will not# work by default. In python 2.x there is no such issue and you can use# 'json' or 'msgpack' as serializers.#SCHEDULER_SERIALIZER = "scrapy_redis.picklecompat"# Don't cleanup redis queues, allows to pause/resume crawls.#SCHEDULER_PERSIST = True# Schedule requests using a priority queue. (default)#SCHEDULER_QUEUE_CLASS = 'scrapy_redis.queue.PriorityQueue'# Alternative queues.#SCHEDULER_QUEUE_CLASS = 'scrapy_redis.queue.FifoQueue'#SCHEDULER_QUEUE_CLASS = 'scrapy_redis.queue.LifoQueue'# Max idle time to prevent the spider from being closed when distributed crawling.# This only works if queue class is SpiderQueue or SpiderStack,# and may also block the same time when your spider start at the first time (because the queue is empty).#SCHEDULER_IDLE_BEFORE_CLOSE = 10# Maximum idle time before close spider.# When the number of idle seconds is greater than MAX_IDLE_TIME_BEFORE_CLOSE, the crawler will close.# If 0, the crawler will DontClose forever to wait for the next request.# If negative number, the crawler will immediately close when the queue is empty, just like Scrapy.#MAX_IDLE_TIME_BEFORE_CLOSE = 0# Store scraped item in redis for post-processing.ITEM_PIPELINES={'scrapy_redis.pipelines.RedisPipeline':300}# The item pipeline serializes and stores the items in this redis key.#REDIS_ITEMS_KEY = '%(spider)s:items'# The items serializer is by default ScrapyJSONEncoder. You can use any# importable path to a callable object.#REDIS_ITEMS_SERIALIZER = 'json.dumps'# Specify the host and port to use when connecting to Redis (optional).#REDIS_HOST = 'localhost'#REDIS_PORT = 6379# Specify the full Redis URL for connecting (optional).# If set, this takes precedence over the REDIS_HOST and REDIS_PORT settings.#REDIS_URL = 'redis://user:pass@hostname:9001'# Custom redis client parameters (i.e.: socket timeout, etc.)#REDIS_PARAMS  = {}# Use custom redis client class.#REDIS_PARAMS['redis_cls'] = 'myproject.RedisClient'# If True, it uses redis' ``SPOP`` operation. You have to use the ``SADD``# command to add URLs to the redis queue. This could be useful if you# want to avoid duplicates in your start urls list and the order of# processing does not matter.#REDIS_START_URLS_AS_SET = False# If True, it uses redis ``zrevrange`` and ``zremrangebyrank`` operation. You have to use the ``zadd``# command to add URLS and Scores to redis queue. This could be useful if you# want to use priority and avoid duplicates in your start urls list.#REDIS_START_URLS_AS_ZSET = False# Default start urls key for RedisSpider and RedisCrawlSpider.#REDIS_START_URLS_KEY = '%(name)s:start_urls'# Use other encoding than utf-8 for redis.#REDIS_ENCODING = 'latin1'NoteVersion 0.3 changed the requests serialization frommarshaltocPickle,
therefore persisted requests using version 0.2 will not able to work on 0.3.Running the example projectThis example illustrates how to share a spider’s requests queue
across multiple spider instances, highly suitable for broad crawls.Setup scrapy_redis package in your PYTHONPATHRun the crawler for first time then stop it:$ cd example-project
$ scrapy crawl dmoz
... [dmoz] ...
^CRun the crawler again to resume stopped crawling:$ scrapy crawl dmoz
... [dmoz] DEBUG: Resuming crawl (9019 requests scheduled)Start one or more additional scrapy crawlers:$ scrapy crawl dmoz
... [dmoz] DEBUG: Resuming crawl (8712 requests scheduled)Start one or more post-processing workers:$ python process_items.py dmoz:items -v
...
Processing: Kilani Giftware (http://www.dmoz.org/Computers/Shopping/Gifts/)
Processing: NinjaGizmos.com (http://www.dmoz.org/Computers/Shopping/Gifts/)
...Feeding a Spider from RedisThe classscrapy_redis.spiders.RedisSpiderenables a spider to read the
urls from redis. The urls in the redis queue will be processed one
after another, if the first request yields more requests, the spider
will process those requests before fetching another url from redis.For example, create a filemyspider.pywith the code below:fromscrapy_redis.spidersimportRedisSpiderclassMySpider(RedisSpider):name='myspider'defparse(self,response):# do stuffpassThen:run the spider:scrapy runspider myspider.pypush urls to redis:redis-cli lpush myspider:start_urls http://google.comNoteThese spiders rely on the spider idle signal to fetch start urls, hence it
may have a few seconds of delay between the time you push a new url and the
spider starts crawling it.ContributionsDonate BTC:13haqimDV7HbGWtz7uC6wP1zvsRWRAhPmFDonate BCC:CSogMjdfPZnKf1p5ocu3gLR54Pa8M42zZMDonate ETH:0x681d9c8a2a3ff0b612ab76564e7dca3f2ccc1c0dDonate LTC:LaPHpNS1Lns3rhZSvvkauWGDfCmDLKT8vPHistory0.7.1 (2021-03-27)Fixes datetime parse error for redis-py 3.x.Add support for stats extensions.0.7.1-rc1 (2021-03-27)Fixes datetime parse error for redis-py 3.x.0.7.1-b1 (2021-03-22)Add support for stats extensions.0.7.0-dev (unreleased)Unreleased.0.6.8 (2017-02-14)Fixed automated release due to not matching registered email.0.6.7 (2016-12-27)Fixes bad formatting in logging message.0.6.6 (2016-12-20)Fixes wrong message on dupefilter duplicates.0.6.5 (2016-12-19)Fixed typo in default settings.0.6.4 (2016-12-18)Fixed data decoding in Python 3.x.AddedREDIS_ENCODINGsetting (defaultutf-8).Default toCONCURRENT_REQUESTSvalue forREDIS_START_URLS_BATCH_SIZE.Renamed queue classes to a proper naming conventiong (backwards compatible).0.6.3 (2016-07-03)AddedREDIS_START_URLS_KEYsetting.Fixed spider methodfrom_crawlersignature.0.6.2 (2016-06-26)Supportredis_clsparameter inREDIS_PARAMSsetting.Python 3.x compatibility fixed.AddedSCHEDULER_SERIALIZERsetting.0.6.1 (2016-06-25)Backwards incompatible change:Require explicitDUPEFILTER_CLASSsetting.AddedSCHEDULER_FLUSH_ON_STARTsetting.AddedREDIS_START_URLS_AS_SETsetting.AddedREDIS_ITEMS_KEYsetting.AddedREDIS_ITEMS_SERIALIZERsetting.AddedREDIS_PARAMSsetting.AddedREDIS_START_URLS_BATCH_SIZEspider attribute to read start urls
in batches.AddedRedisCrawlSpider.0.6.0 (2015-07-05)Updated code to be compatible with Scrapy 1.0.Added-a domain=…option for example spiders.0.5.0 (2013-09-02)AddedREDIS_URLsetting to support Redis connection string.AddedSCHEDULER_IDLE_BEFORE_CLOSEsetting to prevent the spider closing too
quickly when the queue is empty. Default value is zero keeping the previous
behavior.Schedule preemptively requests on item scraped.This version is the latest release compatible with Scrapy 0.24.x.0.4.0 (2013-04-19)AddedRedisSpiderandRedisMixinclasses as building blocks for spiders
to be fed through a redis queue.Added redis queue stats.Let the encoder handle the item as it comes instead converting it to a dict.0.3.0 (2013-02-18)Added support for different queue classes.Changed requests serialization frommarshaltocPickle.0.2.0 (2013-02-17)Improved backward compatibility.Added example project.0.1.0 (2011-09-01)First release on PyPI.