Persistent cache for requests library
Project description
requests-cache
Requests-cache is a transparent persistent cache for requests (version >= 1.1.0) library.
Usage example
Just write:
import requests
import requests_cache
requests_cache.install_cache('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 of 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.
Note
requests-cache ignores all cache headers, it just caches the data for the time you specify.
If you need library which knows how to use HTTP headers and status codes, take a look at httpcache and CacheControl.
Links
Documentation at readthedocs.org
Source code and issue tracking at GitHub.
Working example at Real Python.
History
0.5.0 (2019-04-18)
Project is now added to https://www.codeshelter.co/
Add gridfs support, thanks to @chengguangnan
Add dynamodb support, thanks to @ar90n
Add response filter #104, thanks to @christopher-dG
Fix bulk_commit #78
Fix remove_expired_responses missed in __init__.py #93
Fix deprecation warnings #122, thanks to mbarkhau
0.4.13 (2016-12-23)
Support PyMongo3, thanks to @craigls #72
Fix streaming releate issue #68
0.4.12 (2016-03-19)
Fix ability to pass backend instance in install_cache #61
0.4.11 (2016-03-07)
ignore_parameters feature, thanks to @themiurgo and @YetAnotherNerd (#52, #55)
More informative message for missing backend dependencies, thanks to @Garrett-R (#60)
0.4.10 (2015-04-28)
Better transactional handling in sqlite #50, thanks to @rgant
Compatibility with streaming in requests >= 2.6.x
0.4.9 (2015-01-17)
expire_after now also accepts timedelta, thanks to @femtotrader
Added Ability to include headers to cache key (include_get_headers option)
Added string representation for CachedSession
0.4.8 (2014-12-13)
Fix bug in reading cached streaming response
0.4.7 (2014-12-06)
Fix compatibility with Requests > 2.4.1 (json arg, response history)
0.4.6 (2014-10-13)
Monkey patch now uses class instead lambda (compatibility with rauth)
Normalize (sort) parameters passed as builtin dict
0.4.5 (2014-08-22)
Requests==2.3.0 compatibility, thanks to @gwillem
0.4.4 (2013-10-31)
Check for backend availability in install_cache(), not at the first request
Default storage fallbacks to memory if sqlite is not available
0.4.3 (2013-09-12)
Fix response.from_cache not set in hooks
0.4.2 (2013-08-25)
Fix UnpickleableError for gzip responses
0.4.1 (2013-08-19)
requests_cache.enabled() context manager
Compatibility with Requests 1.2.3 cookies handling
0.4.0 (2013-04-25)
Redis backend. Thanks to @michaelbeaumont
Fix for changes in Requests 1.2.0 hooks dispatching
0.3.0 (2013-02-24)
Support for Requests 1.x.x
CachedSession
Many backward incompatible changes
0.2.1 (2013-01-13)
Fix broken PyPi package
0.2.0 (2013-01-12)
Last backward compatible version for Requests 0.14.2
0.1.3 (2012-05-04)
Thread safety for default sqlite backend
Take into account the POST parameters when cache is configured with ‘POST’ in allowable_methods
0.1.2 (2012-05-02)
Reduce number of sqlite database write operations
fast_save option for sqlite backend
0.1.1 (2012-04-11)
Fix: restore responses from response.history
Internal refactoring (MemoryCache -> BaseCache, reduce_response and restore_response moved to BaseCache)
connection option for MongoCache
0.1.0 (2012-04-10)
initial PyPI release
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 requests-cache-0.5.0.tar.gz.
File metadata
- Download URL: requests-cache-0.5.0.tar.gz
- Upload date:
- Size: 30.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6822f788c5ee248995c4bfbd725de2002ad710182ba26a666e85b64981866060 |
|
| MD5 | 280bbcb409ebba3026042399d9d5bc1d |
|
| BLAKE2b-256 | cede2b0cd21915d7c266793cd8bf652c9015f6cb31a8baa5c0f3a8b852596dbf |
File details
Details for the file requests_cache-0.5.0-py2.py3-none-any.whl.
File metadata
- Download URL: requests_cache-0.5.0-py2.py3-none-any.whl
- Upload date:
- Size: 24.3 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 73a7211870f7d67af5fd81cad2f67cfe1cd3eb4ee6a85155e07613968cc72dfc |
|
| MD5 | d2018a3ad6f1fac55ed30594a0bb505e |
|
| BLAKE2b-256 | 15d16b9836a781d18811d7f0ca7731d0ee817c4e6f33b7ecd8502ad20996b3e9 |
