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
51 Dec 04, 2022
773 Jan 08, 2023
304 Nov 07, 2022
15 Nov 27, 2022
500 Dec 29, 2022
1.7k Jan 05, 2023
420 Dec 22, 2022
658 Dec 01, 2022
59 Apr 05, 2022
764 Jan 02, 2023
0 Nov 01, 2022
976 Dec 28, 2022
118 Dec 09, 2022
5 Jul 09, 2022
2 Dec 22, 2021
92 Dec 13, 2022
39 Jun 05, 2022
409 Dec 04, 2022
23 Dec 01, 2022