https://github.com/psf/cachecontrol

The httplib2 caching algorithms packaged up for use with requests.
https://github.com/psf/cachecontrol

Last synced: 11 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 (over 11 years ago)
• Default Branch: master
• Last Pushed: 2024-07-15T17:04:22.000Z (4 months ago)
• Last Synced: 2024-10-29T15:45:10.505Z (14 days ago)
• Language: Python
• Size: 530 KB
• Stars: 468
• Watchers: 20
• Forks: 122
• Open Issues: 33
• 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/