requests-cache
---------------

Requests-cache is a transparent persistent cache for requests_ library.

.. _requests: http://python-requests.org/

Usage example
-------------

Just write::

    import requests
    import request_cache
    
    request_cache.configure('demo_cache')

And all responses with headers and cookies will be transparently cached to
`demo_cache.sqlite` database. For example, following code will take only
1-2 seconds instead 10, and will run instantly on next launch::

    for i in range(10):
        requests.get('http://httpbin.org/delay/1')
    
It can be useful when you are creating some simple data scraper with constantly
changing parsing logic or data format, and don't want to redownload pages or
write complex error handling and persistence.

Links
-----

- **Documentation** at `readthedocs.org <http://readthedocs.org/docs/requests-cache/>`_

- **Source code and issue tracking** at `BitBucket.org <https://bitbucket.org/reclosedev/requests-cache>`_.

