a library for scraping things
Project description
=========
scrapelib
=========
scrapelib is a library for making requests to websites, particularly those
that may be less-than-reliable.
scrapelib originated as part of the `Open States <http://openstates.org/`_
project to scrape the websites of all 50 state legislatures and as a result
was therefore designed with features desirable when dealing with sites that
have intermittent errors or require rate-limiting.
As of version 0.7 scrapelib has been retooled to take advantage of the superb
`requests <http://python-requests.org>`_ library.
Advantages of using scrapelib over alternatives like httplib2 simply using
requests as-is:
* All of the power of the suberb `requests <http://python-requests.org>`_ library.
* HTTP, HTTPS, and FTP requests via an identical API
* support for simple caching with pluggable cache backends
* request throtting
* configurable retries for non-permanent site failures
* optional robots.txt compliance
scrapelib is a project of Sunlight Labs (c) 2012.
All code is released under a BSD-style license, see LICENSE for details.
Written by James Turk <jturk@sunlightfoundation.com>
Contributors:
* Michael Stephens - initial urllib2/httplib2 version
* Joe Germuska - fix for IPython embedding
* Alex Chiang - fix to test suite
Requirements
============
* python 2.6, 2.7, or 3.2
* requests
Installation
============
scrapelib is available on PyPI and can be installed via ``pip install scrapelib``
PyPI package: http://pypi.python.org/pypi/scrapelib
Source: http://github.com/sunlightlabs/scrapelib
Documentation: http://scrapelib.readthedocs.org/en/latest/
Example Usage
=============
::
import scrapelib
s = scrapelib.Scraper(requests_per_minute=10, allow_cookies=True,
follow_robots=True)
# Grab Google front page
s.urlopen('http://google.com')
# Will raise RobotExclusionError
s.urlopen('http://google.com/search')
# Will be throttled to 10 HTTP requests per minute
while True:
s.urlopen('http://example.com')
scrapelib
=========
scrapelib is a library for making requests to websites, particularly those
that may be less-than-reliable.
scrapelib originated as part of the `Open States <http://openstates.org/`_
project to scrape the websites of all 50 state legislatures and as a result
was therefore designed with features desirable when dealing with sites that
have intermittent errors or require rate-limiting.
As of version 0.7 scrapelib has been retooled to take advantage of the superb
`requests <http://python-requests.org>`_ library.
Advantages of using scrapelib over alternatives like httplib2 simply using
requests as-is:
* All of the power of the suberb `requests <http://python-requests.org>`_ library.
* HTTP, HTTPS, and FTP requests via an identical API
* support for simple caching with pluggable cache backends
* request throtting
* configurable retries for non-permanent site failures
* optional robots.txt compliance
scrapelib is a project of Sunlight Labs (c) 2012.
All code is released under a BSD-style license, see LICENSE for details.
Written by James Turk <jturk@sunlightfoundation.com>
Contributors:
* Michael Stephens - initial urllib2/httplib2 version
* Joe Germuska - fix for IPython embedding
* Alex Chiang - fix to test suite
Requirements
============
* python 2.6, 2.7, or 3.2
* requests
Installation
============
scrapelib is available on PyPI and can be installed via ``pip install scrapelib``
PyPI package: http://pypi.python.org/pypi/scrapelib
Source: http://github.com/sunlightlabs/scrapelib
Documentation: http://scrapelib.readthedocs.org/en/latest/
Example Usage
=============
::
import scrapelib
s = scrapelib.Scraper(requests_per_minute=10, allow_cookies=True,
follow_robots=True)
# Grab Google front page
s.urlopen('http://google.com')
# Will raise RobotExclusionError
s.urlopen('http://google.com/search')
# Will be throttled to 10 HTTP requests per minute
while True:
s.urlopen('http://example.com')
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
scrapelib-0.7.3.tar.gz
(13.2 kB
view details)
File details
Details for the file scrapelib-0.7.3.tar.gz.
File metadata
- Download URL: scrapelib-0.7.3.tar.gz
- Upload date:
- Size: 13.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9ff33c378b8a50adbb2a92d21ace4e656ff8f040cddaee184a5d9b7e642e8c1e |
|
| MD5 | d0bde100a5c6d1cbe9a3aa3e9e7068e1 |
|
| BLAKE2b-256 | 866160dd74cbbbc691d96675c725e0d2b71211eff3b68445bfcb70767a4f1a0f |
