reckon: Dead simple, dynamic caching.
Project description
reckon: Dead-simple, dynamic memoization
Installation
In order to install the latest version, simply pip3 install -U reckon
.
This library requires Python 3.6 or greater.
What is it?
reckon
implements a dynamic LRU cache by automatically
monitoring the memory usage of your machine and purging
entries as it approaches a pre-defined ratio (defaults to
90%).
reckon
is largely inspired by the global_lru_cache
package, so credit should be given for the initial
implementation. This package brings those ideas into python3
and adds a local cache implementation as well.
Usage
Usage is simple:
import reckon
@reckon.memoize
def some_expensive_func(foo: int, bar: int):
return foo ** bar
reckon
will automatically make use of the global cache.
While the global cache is automatically maintained, it may be necessary to managed the cache manually. To that purpose, reckon provides the following global methods:
reckon.glob.clear
: Clear the global cache.reckon.glob.shrink
: Shrink the global cache.reckon.glob.usage
: Check the current usage ratio.reckon.glob.set_usage
: Set the max memory usage ratio for the global cache.reckon.glob.info
: View high-level information about the cache - similar tofunctools.lru_cache.cache_info
If you wish to only maintain a cache local to a function you can simply pass a flag to the decorator:
import reckon
@reckon.memoize(locale="local")
def some_expensive_func(foo: int, bar: int):
return foo ** bar
Additionally, if you wish to maintain a cache local to a
module, you can initialize your own instance of the
LocalCache
object:
import reckon
cache = reckon.local()
@cache.memoize
def some_expensive_func(foo: int, bar: int):
return foo ** bar
The local cache instance maintains the same high-level API for management as the global cache:
LocalCache.clear
: Clear the local cache.LocalCache.shrink
: Shrink the local cache.LocalCache.usage
: Check the current usage ratio.LocalCache.set_usage
: Set the max memory usage ratio for the local cache.LocalCache.info
: View high-level information about the cache - similar tofunctools.lru_cache.cache_info
All memoized functions have introspection into their cache
via the cache
attribute.
Documentation
Full documentation coming soon!
How to Contribute
- Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
- Create a branch on Github for your issue or fork the repository on GitHub to start making your changes to the master branch.
- Write a test which shows that the bug was fixed or that the feature works as expected.
- Send a pull request and bug the maintainer until it gets merged and published. :)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file reckon-0.2.0.tar.gz
.
File metadata
- Download URL: reckon-0.2.0.tar.gz
- Upload date:
- Size: 8.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e6133d72a076869ad7f46f8aee12277d3f0d874ad4eae0a05fe33f6536dde027 |
|
MD5 | 7dd075baa9659ccf8075bf58747c2e7b |
|
BLAKE2b-256 | aca68e339445d9b11e30d57fd764b3082a006d4d093215787f12a6a6bfc9cd96 |
File details
Details for the file reckon-0.2.0-py2.py3-none-any.whl
.
File metadata
- Download URL: reckon-0.2.0-py2.py3-none-any.whl
- Upload date:
- Size: 8.7 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1812389b46f46cf8fa96654a798c43495ef50cd155cc3e90b7c24929c628c7b6 |
|
MD5 | 327d25e4d0e23f60675b01497fd0b37f |
|
BLAKE2b-256 | 0f4f723513cac87843ab2387c699d61ceecbc23ba98eab3c19c2ab1b21cd33e0 |