EvalCache
Lazy tree evaluation cache library.
Brief
The library implements a cache of dependent lazy calculations for working with clean, time-consuming computational tasks, such as symbolic transformations, geometric, numerical algorithms.
The task of the library is to save the result of the computation once performed and, if necessary, load it, saving the computing resources. The algorithm for constructing the hashkey of the computed object uses the input data parameterizing this object, which makes it possible to track changes in the arguments of the lazy algorithm and to postpone the necessary calculations if the conditions have changed. If an lazy object is used as an argument or a generating function, its hashkey is used as its hash. This allows you to build a dependent computational tree. If the input data of an object changes, its hashkey and hashkeys of all objects computed on its basis change. And the subtree will be reevaluated.
Since the library saves every computed object in the cache, including intermediate objects, it can pick up changes in the calculation tree from any step. Thus, previously received data, if they can be applied to a new calculation tree, will be used. This allows you to not make heavy preliminary calculations in separate files, and load them transparently, and also compare results with small changes in input parameters without multiple results remaking.
Install
python3 -m pip install evalcache
Details
Base example
import evalcache
lazy = evalcache.Lazy(cache = evalcache.DirCache(".evalcache"))
@lazy
def func(a,b,c):
return do_something(a,b,c)
lazyresult = func(1,2,3)
result = lazyresult.unlazy() #alternative: result = evalcache.unlazy(lazyresult)
In that example we can see based classes and objects: You should instance "evalcache.Lazy" for start work. "Lazy" get "cache" as parametr. Cache is a dict-like object those will store and load our evaluation's results. "Lazy" instance "lazy" can be used as decorator for create "LazyObjects". Decorated object "func" is a LazyObject. "func" can generate another lazyobject, as "lazyresult", for example with callable interface. For get evaluation result we use "unlazy" method.
Diagnostic
We can visualize cache operations:
lazy = evalcache.Lazy(cache = cache, diag = True)
in this mode, when you use unlazy, you will see console output:
endp - get endpoint object.
fget - get variable from local object store.
load - get early stored value from cache.
save - evaluation executed and value stored.
eval - evaluated without storing
Hash algorithm
You can choose algorithm from hashlib or specify user's hashlib-like algorithm.
lazy = evalcache.Lazy(cache = cache, algo = hashlib.sha512)
DirCache
DirCache is a dict-like object that used pickle to store values in key-named files. It very simple cache and it can be changed to more progressive option if need.
lazy = evalcache.Lazy(cache = evalcache.DirCache(".evalcache"))
Articles
Дисковое кэширование деревьев ленивых вычислений
Contact
mirmik(mirmikns@yandex.ru)
1 maintainer
Metadata
1 maintainer
Release files for evalcache 1.15.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| evalcache-1.15.1.tar.gz | 15.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| evalcache-1.15.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 30.9 kB
Release files / evalcache-1.15.1.tar.gz
| Download URL | evalcache-1.15.1.tar.gz |
|---|---|
| Size | 15.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b44276d19844e31057374c997f06c87135dd7aefb148c76921867136fac29a2b
|
|
BLAKE2b-256 checksum How to use checksums |
5b8c9fde46014a81e32b718de48d963b8421640a9896ce1987622ff8ebe8c0f7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.19
|
Release files / evalcache-1.15.1-py3-none-any.whl
| Download URL | evalcache-1.15.1-py3-none-any.whl |
|---|---|
| Size | 15.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
249dec51c6e1e1ff5a2e2e6a8420d444d44cba945992f90bce7bf9f6dee66338
|
|
BLAKE2b-256 checksum How to use checksums |
a00821c1a5a17a6898c22b621d7a6ee26ddb0cca4e5b148d8c2c5378ec71ec23
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.19
|
