https://github.com/psf/cachecontrol
The httplib2 caching algorithms packaged up for use with requests.
https://github.com/psf/cachecontrol
Last synced: 25 days ago
JSON representation
The httplib2 caching algorithms packaged up for use with requests.
- Host: GitHub
- URL: https://github.com/psf/cachecontrol
- Owner: psf
- License: other
- Created: 2013-06-18T05:55:43.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2025-05-02T16:58:09.000Z (about 1 month ago)
- Last Synced: 2025-05-09T00:10:07.248Z (about 1 month ago)
- Language: Python
- Size: 559 KB
- Stars: 481
- Watchers: 19
- Forks: 126
- Open Issues: 32
-
Metadata Files:
- Readme: README.rst
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
..
SPDX-FileCopyrightText: SPDX-FileCopyrightText: 2015 Eric Larson
SPDX-License-Identifier: Apache-2.0
==============
CacheControl
==============
.. image:: https://img.shields.io/pypi/v/cachecontrol.svg
:target: https://pypi.python.org/pypi/cachecontrol
:alt: Latest Version
.. image:: https://github.com/psf/cachecontrol/actions/workflows/tests.yml/badge.svg
:target: https://github.com/psf/cachecontrol/actions/workflows/tests.yml
CacheControl is a port of the caching algorithms in httplib2_ for use with
requests_ session object.
It was written because httplib2's better support for caching is often
mitigated by its lack of thread safety. The same is true of requests in
terms of caching.
Quickstart
==========
.. code-block:: python
import requests
from cachecontrol import CacheControl
sess = requests.session()
cached_sess = CacheControl(sess)
response = cached_sess.get('https://google.com')
If the URL contains any caching based headers, it will cache the
result in a simple dictionary.
For more info, check out the docs_
.. _docs: http://cachecontrol.readthedocs.org/en/latest/
.. _httplib2: https://github.com/httplib2/httplib2
.. _requests: http://docs.python-requests.org/