This is a Yosai integration using a fork of the dogpile project, authored by Mike Bayer.
The dogpile project consists of two sub-projects: dogpile.core
and dogpile.cache
.
Yosai_DPCache is a fork of these projects, replacing pickle-based serialization with
serialization supported by Yosai and making a few other customizations.
Yosai reduces objects to their serializable form using the marshmallow
library,
encodes the "reductions" with msgpack, json, or other encoding scheme, and then caches
the objects.
Objects obtained from cache are de-serialized back into their reduced forms and then re-materialized into Yosai objects.
Install YosaiDPCache from PyPI using pip: pip install yosai_dpcache
A YosaiDPCache.DPCacheHandler can be configured through one of two ways:
-
Option 1: YAML Config File
-
Define a system environment variable, YOSAI_CACHE_SETTINGS, that points to the location of cache_settings.yaml file and make sure that the file permissions make it readable.
-
Instantiate a DPCacheHandler without arguments.
-
-
Option 2: instantiate a DPCacheHandler, passing all of the required arguments (see cachehandler.py and settings.py for detail)
Only Redis support has been implemented and ad-hoc tested.
Integrated testing of yosai includes YosaiDPCache, and so YosaiDPCache is included with automated testing. However, YosaiDPCache needs its own unit tests covering its customizations.