Skip to main content

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 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.

History

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

requests-cache-0.4.5.zip (39.6 kB view details)

Uploaded Source

requests-cache-0.4.5.tar.gz (25.5 kB view details)

Uploaded Source

Built Distribution

requests-cache-0.4.5.win32.exe (217.7 kB view details)

Uploaded Source

File details

Details for the file requests-cache-0.4.5.zip.

File metadata

  • Download URL: requests-cache-0.4.5.zip
  • Upload date:
  • Size: 39.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for requests-cache-0.4.5.zip
Algorithm Hash digest
SHA256 4bbda496b9ec2ad39773d95eefa99128addf450ed0b817b403409081d62f23f6
MD5 9998a5e89e16403f985ef1b2151738c8
BLAKE2b-256 3a64139dd6e8cb02bff75d51e4b971cd5765f83512748c00b1db9e7693e7b81c

See more details on using hashes here.

File details

Details for the file requests-cache-0.4.5.tar.gz.

File metadata

File hashes

Hashes for requests-cache-0.4.5.tar.gz
Algorithm Hash digest
SHA256 ab5bd4b2508158bb57b25042ecbac840b7f6035ef940314897ce0efe13112c7b
MD5 82325c94102b529d8a2dd0b2fb1342e9
BLAKE2b-256 9d59b2dc047a1f0e5d188ef30bf63eb2086f9eba6a48d32a351fd8aaa7198d79

See more details on using hashes here.

File details

Details for the file requests-cache-0.4.5.win32.exe.

File metadata

File hashes

Hashes for requests-cache-0.4.5.win32.exe
Algorithm Hash digest
SHA256 94369a37fafe6053cc4e33ac9ed42a313ee5591302c884ef1b724b44f726e6e1
MD5 dbf609e1378474d9759a402029223e86
BLAKE2b-256 1ca8ed6d4821302793d29ad616c46ad97b459db6ffb8c55a269d12ee99bc8124

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page