|
Metadata-Version: 2.1
|
|
Name: CacheControl
|
|
Version: 0.12.5
|
|
Summary: httplib2 caching for requests
|
|
Home-page: https://github.com/ionrock/cachecontrol
|
|
Author: Eric Larson
|
|
Author-email: eric@ionrock.org
|
|
License: UNKNOWN
|
|
Keywords: requests http caching web
|
|
Platform: UNKNOWN
|
|
Classifier: Development Status :: 4 - Beta
|
|
Classifier: Environment :: Web Environment
|
|
Classifier: License :: OSI Approved :: Apache Software License
|
|
Classifier: Operating System :: OS Independent
|
|
Classifier: Programming Language :: Python :: 2
|
|
Classifier: Programming Language :: Python :: 2.7
|
|
Classifier: Programming Language :: Python :: 3
|
|
Classifier: Programming Language :: Python :: 3.4
|
|
Classifier: Programming Language :: Python :: 3.5
|
|
Classifier: Programming Language :: Python :: 3.6
|
|
Classifier: Topic :: Internet :: WWW/HTTP
|
|
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
|
|
Requires-Dist: requests
|
|
Requires-Dist: msgpack
|
|
Provides-Extra: filecache
|
|
Requires-Dist: lockfile (>=0.9) ; extra == 'filecache'
|
|
Provides-Extra: redis
|
|
Requires-Dist: redis (>=2.10.5) ; extra == 'redis'
|
|
|
|
==============
|
|
CacheControl
|
|
==============
|
|
|
|
.. image:: https://img.shields.io/pypi/v/cachecontrol.svg
|
|
:target: https://pypi.python.org/pypi/cachecontrol
|
|
:alt: Latest Version
|
|
|
|
.. image:: https://travis-ci.org/ionrock/cachecontrol.png?branch=master
|
|
:target: https://travis-ci.org/ionrock/cachecontrol
|
|
|
|
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 threadsafety. 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('http://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/jcgregorio/httplib2
|
|
.. _requests: http://docs.python-requests.org/
|
|
|
|
|