percache 0.3.0

示例

>>> import percache
>>> cache = percache.Cache("/tmp/my-cache")
>>>
>>> @cache
... def longtask(a, b):
...     print("running a long task")
...     return a + b
...
>>> longtask(1, 2)
running a long task
3
>>>
>>> longtask(1, 2)
3
>>> cache.close() # writes new cached results to disk

正如您在第二次调用后丢失的输出中看到的，longtask 只打过一次电话第二次从 隐藏物。这个模块的关键特性是它可以跨多个 调用Python解释器

对要缓存的结果的一个要求是它们是pickable

每个缓存文件可以用于任意数量的不同命名的可调用文件。

>>> class FooCache(dict):
...     def sync(self):
...         ...
...     def close(self):
...         ...
>>> fc = FooCache()
>>> cache = percache.Cache(fc, livesync=True)

缓存详细信息（您应该知道）

缓存可调用结果时，基于可调用名称的SHA1哈希 参数用作将结果存储到缓存文件中的键

哈希计算不直接处理参数，而是处理它们 表示，即通过应用repr()返回的字符串。论据 表示应该充分区分 函数的用途，但在 python解释器。默认情况下，内置函数repr()用于获取 参数表示。这非常适合基本类型、列表、元组 以及它们的组合，但在其他类型上可能会失败：

>>> repr(42)
42                                  # good
>>> repr(["a", "b", (1, 2L)])
"['a', 'b', (1, 2L)]"               # good
>>> o = object()
>>> repr(o)
'<object object at 0xb769a4f8>'     # bad (address is dynamic)
>>> repr({"a":1,"b":2,"d":4,"c":3})
"{'a': 1, 'c': 3, 'b': 2, 'd': 4}"  # bad (order may change)
>>> class A(object):
...     def __init__(self, a):
...         self.a = a
...
>>> repr(A(36))
'<__main__.A object at 0xb725bb6c>' # bad (A.a not considered)
>>> repr(A(35))
'<__main__.A object at 0xb725bb6c>' # bad (A.a not considered)

在python调用中，bad表示是不相同的 （所有bad示例）或没有充分区分值的示例 （最后2个bad示例）。

无论如何，要使用这种类型，您可以

1. 相应地实现类型的__repr__()方法或
2. 使用的repr关键字提供自定义表示函数 Cache构造函数

>>> class mydict(dict):
...     def __repr__(self):
...         items = ["%r: %r" % (k, self[k]) for k in sorted(self)]
...         return "{%s}" % ", ".join(items)
...
>>> repr(mydict({"a":1,"b":2,"d":4,"c":3}))
"{'a': 1, 'b': 2, 'c': 3, 'd': 4}"  # good (always same order)

>>> def myrepr(arg):
...     if isinstance(arg, file):
...         # return a string with file name and modification time
...         return "%s:%s" % (arg.name, os.fstat(arg.fileno())[8])
...     else:
...         return repr(arg)
...
>>> cache = percache.Cache("/some/path", repr=myrepr)

客房服务

• 确保在缓存函数的行为发生时删除缓存文件 已经改变了！
• 为了防止缓存变得越来越大，可以调用 ^Cache实例的{tt15}$方法默认情况下，它清除all 来自缓存的结果。关键字maxagemy用于指定 自从缓存结果为^ {EM1}$以来使用的最大秒数 上次。任何结果在maxage秒内未使用（写入或访问） 从缓存中删除。

更改