HTTPX-CACHE
Note: Early development / alpha, use at your own risk.
httpx-cache is yet another implementation/port is a port of the caching algorithms in httplib2 for use with httpx Transport object.
It is is heavily insipired by:
This project supports the latest version of httpx (at of the time of writing): [email protected], when httpx releases a v1 version, the update should be straithforward for this project.
Installation
Using pip:
pip install httpx-cache
Using poetry:
poetry add httpx-cache
Features
- In memory dict cache store
- Support for cache-controle headers
- Sync cache transport for httpx
- Async cache transport for httpx
Quickstart
The lib provides an httpx compliant transport that you can use instead of the the defult one when creating your httpx client:
import httpx
from httpx_cache import CacheControlTransport
with httpx.Client(transport=CacheControlTransport()) as client:
response = client.get("https://httpbin.org/get")
# the response is effectively cached, calling teh same request with return a response from the cache
response2 = client.get("https://httpbin.org/get")
You can also wrap an existing transport with CacheControlTransport. The CacheControlTransport will use the existing transport for making the request call and then cach the result if it satisfies the cache-control headers.
import httpx
from httpx_cache import CacheControlTransport
my_transport = httpx.HTTPTransport(http2=True, verify=False)
with httpx.Client(transport=CacheControlTransport(transport=my_transport)) as client:
response = client.get("https://httpbin.org/get")
# the response is effectively cached, calling teh same request with return a response from the cache
response2 = client.get("https://httpbin.org/get")
Examples
more examples in ./examples.
TODO
- support etags
- support cache expiry dates
- support file cach
- support redis (sync/async) cache
500 Dec 29, 2022
23 Dec 01, 2022
2 Aug 14, 2022
979 Jan 03, 2023
51 Dec 04, 2022
420 Dec 22, 2022
15 Nov 27, 2022
1k Dec 15, 2022
1.7k Jan 05, 2023
773 Jan 08, 2023
846 Nov 26, 2022
59 Apr 05, 2022
118 Dec 09, 2022
774 Jan 02, 2023
1.7k Dec 30, 2022
39 Jun 05, 2022
5 Jul 09, 2022
82 Mar 04, 2022