cachepy 1.1

功能

• Memory-based and file-based caches;
• Ability to set the TTL (time-to-live) and NOC (the number of calls) on caches;
• Encryption of the cached data (symmetric encryption algorithm (RSA) is used);
• LFU (least frequently used) and MFU (most frequently used) cache-clearing strategies;
• caches of limited size;

注释

• Encryption functionality requires the PyCryptodome package to be installed;
• File-based caches save the cached data in a file; files with cached data should be cleaned up manually, if needed.

示例

fromcachepyimport*mycache=Cache()# save the cached data to memory without encryption@mycachedefmy_heavy_function(x):'''Performs heavy computations'''print('Hi, I am called...')returnx**2my_heavy_function(2)# "Hi, I am called..." will be printed to stdout only once# return 4my_heavy_function(2)# return 4

要将数据存储到文件中，需要初始化一个decorator，如下所示：

# create cache-to-file decoratorfilecache=FileCache('mycache')# mycache.dat file will be created;# `.dat` extension is appended automatically to the filename# (depends on the shelve module implementation);

它的行为与基于内存的行为相同，但所有缓存的数据都存储在 指定的文件。

可以设置生存时间（TTL）和/或最大呼叫次数（NOC）。 对于初始化装饰程序时缓存的数据：

importtimefromcachepyimport*cache_with_ttl=Cache(ttl=2)# ttl given in seconds@cache_with_ttldefmy_heavy_function(x):'''Performs heavy computations'''print('Hi, I am called...')returnx**2my_heavy_function(3)# Hi, I am called... will be printed# return 9my_heavy_function(3)# 'Hi, I am called ...' will not be printed# return 9time.sleep(2)my_heavy_function(3)# 'Hi, I am called ...' will be printed again# return 9

cache_with_noc=Cache(noc=2)# the number-of-calls: noc = 2@cache_with_nocdefmy_heavy_function(x):'''Performs heavy computations'''print('Hi, I am called...')returnx**2my_heavy_function(3)my_heavy_function(3)# 'Hi, I am called ...' will not be printedmy_heavy_function(3)# 'Hi, I am called ...' will be printed again

定义时，可以很容易地同时使用noc和ttl参数 缓存装饰器：

cache_with_noc_ttl=Cache(noc=2,ttl=1)@cache_with_noc_ttldefmy_heavy_function(x):'''Performs heavy computations'''print('Hi, I am called...')returnx**2my_heavy_function(3)my_heavy_function(3)# 'Hi, I am called ...' will not be printedmy_heavy_function(3)# 'Hi, I am called ...' will be printed (noc is# reached, recompute the func value)time.sleep(2)# get ttl expiredmy_heavy_function(3)# 'Hi, I am called ...' will be printed again

可以通过提供非空的密钥参数来加密缓存的数据 密码（使用RSA加密算法）：

cache_to_file_ttl_noc=FileCache('mycache',noc=2,ttl=2,key='mypassword')@cache_to_file_ttl_nocdefmy_heavy_function(x):'''Performs heavy computations'''print('Hi, I am called...')returnx**2my_heavy_function(2)# 'Hi, I am called...' will be printedmy_heavy_function(2)# 'Hi, I am called...' will not be printed

当my_heavy_function被cache_to_file_ttl_noc修饰时，如图所示 在上面的例子中，将计算值2**2=4 计算将存储在名为mycache.dat的文件中。沿着 根据计算结果，将存储附加信息 在文件mycache.dat中。附加信息包括： 1）结果的过期时间（从TTL计算得出）； 2）noc和3）已执行的 修饰（my_heavy_function）。

只有安装了pycryptodome包并且 键参数（代表密码的非空字符串）传递给 缓存构造函数。它还可以使用旧的pycrypto包。

如果将非空的键参数传递给缓存构造函数 但未找到pycryptome，在这种情况下会发出特别警告 （“未安装PyCryptoDome。数据不会被加密 缓存将照常工作，但没有加密功能。

有限制的缓存

标准缓存构造函数用于初始化容量不受限制的缓存。 还有容量有限的缓存。 这种缓存由名为limitedcache和limitedfilecache的构造函数初始化。 这些构造函数有 参数> CIT> CaseEXSimule（存储在缓存中的最大项目数） 算法（缓存清除算法）。可用的算法 lfu（默认值，表示最不常用）和mfu（最常用）。 当algorithm='lfu'时，将从缓存中删除最不常用的项， 如果筋疲力尽。如果算法='mfu'，则所有的行为都是相同的， 唯一的区别是删除了最常用的项。

测试

python -m  cachepy.test

待办事项

• Writing backend for redis server

日志列表

• Version 1.1
• Version 1.0 (broken installation via pip/pipenv)

• Version 0.1

  • initial release

作者

Dmitry Kislov <kislov@easydan.com>