欢迎访问 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 的用法。

如果你尝试一下,请告诉我任何问题。

内容#

索引和表格#