---
id: cachecontrol
version: "0.14.4"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# CacheControl — httplib2 caching for requests

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install cachecontrol
uv add cachecontrol
poetry add cachecontrol

## Description

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

## AI interpretation — verify before relying

CacheControl adds HTTP caching support to the requests library, implementing httplib2's caching algorithms with thread-safe operation for requests session objects.

Verdict: CacheControl is a lightweight, actively maintained caching layer for requests with no known vulnerabilities and permissive licensing. It's well-suited for applications needing transparent HTTP caching with thread safety.

[View on SkillFed](https://skillfed.io/packages/cachecontrol) · [View on PyPI](https://pypi.org/project/cachecontrol/)