0.2.6 Release Notes
Klepto extends python's lru_cache
to utilize different keymaps and alternate caching algorithms, such as lfu_cache
and mru_cache
. While caching is meant for fast access to saved results, klepto also has archiving capabilities, for longer-term storage. Klepto uses a simple dictionary-sytle interface for all caches and archives, and all caches can be applied to any python function as a decorator. Keymaps are algorithms for converting a function's input signature to a unique dictionary, where the function's results are the dictionary value. Thus for y = f(x)
, y
will be stored in cache[x]
(e.g. {x:y}
).
Klepto provides both standard and 'safe' caching, where safe caches are slower but can recover from hashing errors. Klepto is intended to be used for distributed and parallel computing, where several of the keymaps serialize the stored objects. Caches and archives are intended to be read/write accessible from different threads and processes. Klepto enables a user to decorate a function, save the results to a file or database archive, close the interpreter, start a new session, and reload the function and it's cache.
Klepto installs with pip:
$ pip install klepto
Klepto requires:
- python or pypy, >=3.8
- dill, >=0.3.9
- pox, >=0.3.5
Optional requirements:
- sqlalchemy, >=1.4.0
(install with $ pip install klepto[archives]
)
- h5py, >=2.8.0
(install with $ pip install klepto[archives]
)
- pandas, >=0.17.0
(install with $ pip install klepto[archives]
)
Klepto is licensed under 3-clause BSD:
>>> import klepto
>>> print (klepto.license())
To cite klepto:
>>> import klepto
>>> print (klepto.citation())
What's Changed
- Bump idna from 3.4 to 3.7 in /docs by @dependabot in #127
- Bump jinja2 from 3.1.3 to 3.1.4 in /docs by @dependabot in #128
- Bump requests from 2.31.0 to 2.32.0 in /docs by @dependabot in #129
- Bump tornado from 6.3.3 to 6.4.1 in /docs by @dependabot in #130
- update docs requirements to rtfd 10.27.0 by @mmckerns in #132
- Bump certifi from 2024.2.2 to 2024.7.4 in /docs by @dependabot in #133
- type check with Integral not int by @mmckerns in #134
- add formal support for python 3.13 by @mmckerns in #135
Full Changelog: 0.2.5...0.2.6