欢迎访问 CacheControl 的文档!#
CacheControl 是 httplib2 中缓存算法的端口,可与 requests 会话对象一起使用。
编写此文档是因为 httplib2 对缓存的更好支持通常会被其缺乏线程安全性所抵消。在缓存方面,requests 也是如此。
安装#
CacheControl 可从 PyPI 获取。你可以使用 pip 安装它
$ pip install CacheControl
一些包含的缓存存储类具有外部要求。有关更多信息,请参阅 存储缓存数据。
快速入门#
对于急于求成的人,以下是如何开始使用 CacheControl
import requests
from cachecontrol import CacheControl
sess = requests.session()
cached_sess = CacheControl(sess)
response = cached_sess.get('http://google.com')
这使用了一个线程安全的内存中字典进行存储。
测试#
所有测试都在 cachecontrol/tests
中,并且可以通过 py.test
运行。
免责声明#
CacheControl 相对较新,可能存在错误。我已努力忠实地将测试从 httplib2 移植到 CacheControl,但很有可能我遗漏了一些东西。如果你发现任何问题,请提交错误报告!
考虑到这一点,CacheControl 已在生产环境中成功使用,取代了 httplib2 的用法。
如果你尝试一下,请告诉我任何问题。