Scrapy middleware to ignore previously crawled pages
Project description
This is a Scrapy spider middleware to ignore requests to pages containing items seen in previous crawls of the same spider, thus producing a “delta crawl” containing only new items.
This also speeds up the crawl, by reducing the number of requests that need to be crawled, and processed (typically, item requests are the most CPU intensive).
Requirements
DeltaFetch middleware depends on Python’s bsddb3 package.
On Ubuntu/Debian, you may need to install libdb-dev if it’s not installed already.
Installation
Install scrapy-deltafetch using pip:
$ pip install scrapy-deltafetch
Configuration
Add DeltaFetch middleware by including it in SPIDER_MIDDLEWARES in your settings.py file:
SPIDER_MIDDLEWARES = { 'scrapy_deltafetch.DeltaFetch': 100, }Here, priority 100 is just an example. Set its value depending on other middlewares you may have enabled already.
Enable the middleware using DELTAFETCH_ENABLED in your setting.py:
DELTAFETCH_ENABLED = True
Usage
Following are the different options to control DeltaFetch middleware behavior.
Supported Scrapy settings
DELTAFETCH_ENABLED — to enable (or disable) this extension
DELTAFETCH_DIR — directory where to store state
DELTAFETCH_RESET — reset the state, clearing out all seen requests
These usually go in your Scrapy project’s settings.py.
Supported Scrapy spider arguments
deltafetch_reset — same effect as DELTAFETCH_RESET setting
Example:
$ scrapy crawl example -a deltafetch_reset=1
Supported Scrapy request meta keys
deltafetch_key — used to define the lookup key for that request. by default it’s Scrapy’s default Request fingerprint function, but it can be changed to contain an item id, for example. This requires support from the spider, but makes the extension more efficient for sites that many URLs for the same item.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file scrapy-deltafetch-1.2.0.tar.gz.
File metadata
- Download URL: scrapy-deltafetch-1.2.0.tar.gz
- Upload date:
- Size: 3.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 052666fc57e9f8a4a8d200351cb7920d577e0326fb91bae00b023be7b16e7861 |
|
| MD5 | 4c0941fc731b6a653154d8c97edca834 |
|
| BLAKE2b-256 | 3db3cbadfaf57b32a5b0f8b8f81ac0435e004fe8a89768e0d2e96a9658cff164 |
File details
Details for the file scrapy_deltafetch-1.2.0-py2.py3-none-any.whl.
File metadata
- Download URL: scrapy_deltafetch-1.2.0-py2.py3-none-any.whl
- Upload date:
- Size: 3.9 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 25b8ff108ff97a3b738cc905c6595ca8ca02fe705901f11ceb1c7024ed54c1f2 |
|
| MD5 | b96dd1ecc3ef5ac3cb234f62f6891e62 |
|
| BLAKE2b-256 | e665b9948295a0e4c080dd0d368a85372d25f47fef8ba53d9f0745134b37def6 |
