instance-cache 0.1.1

为类方法提供实例级的结果缓存, 不影响类实例正常垃圾回收的装饰器

instance_cache

为类方法提供实例级的结果缓存, 不影响类实例正常垃圾回收的装饰器

---

0. 背景

functools.lru_cache 和 cache 函数会保留对调用参数的强引用, 会影响这些参数正常的垃圾回收, 需要等待缓存
超过 max_size 后弹出或手动调用 cache_clear, 比较麻烦.
最常见的场景是作用在一般的类方法上, 保留参数 self 的引用后会影响整个类实例的垃圾回收.

>>> from functools import cache
>>>
>>> class Test:
...     def __del__(self):
...         print('delete!')
...     def method(self):
...         ...
...     @cache
...     def method_cache(self):
...         ...
...
>>> Test().method()
delete!
>>> Test().method()
delete!
>>> Test().method_cache()  # 无法进行垃圾回收
>>> Test().method_cache()
>>> Test().method_cache()
>>> Test.method_cache.cache_clear()  # 需手动调用, 一次性删除所有实例的缓存 (即使还有其他实例处于正常生命周期内)
delete!
delete!
delete!

此处提供一个一般类方法的结果缓存装饰器, 提供实例级别的缓存 (为每个实例单独创建缓存空间).
通过将缓存内容作为每个类实例的属性进行存储 (类似于 functools.cached_property), 避免了影响类实例 self 的正常垃圾回收.
对于其他调用参数, 当类实例被回收后也会正常回收.

---

1. 安装

使用以下命令安装该库

pip install instance_cache

---

2. 使用

使用方法非常简单, 与 functools.lru_cache 基本一致

>>> from instance_cache import instance_cache
>>>
>>> class Test:
...     @instance_cache(cache_name='method_cached')
...     def method(self, x=1, y=2):
...         print('run')
...         ...  # 耗时操作
...         return 1
...     def __del__(self):
...         print('delete!')
...
>>> foo = Test()
>>> foo.method(1, 2)
run
1
>>> foo.method(1, 2)  # 命中缓存, 不运行方法直接返回结果
1
>>> # foo.method_cached.clear()  # 清空实例的结果缓存
>>> del foo  # 会立刻进行垃圾回收
delete!