Skip to main content

reckon: Dead simple, dynamic caching.

Project description

reckon: Dead-simple, dynamic memoization

image image image image image codecov Code style: black

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 to functools.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 to functools.lru_cache.cache_info

All memoized functions have introspection into their cache via the cache attribute.

Documentation

Full documentation coming soon!

How to Contribute

  1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
  2. Create a branch on Github for your issue or fork the repository on GitHub to start making your changes to the master branch.
  3. Write a test which shows that the bug was fixed or that the feature works as expected.
  4. 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

reckon-0.2.0.tar.gz (8.2 kB view details)

Uploaded Source

Built Distribution

reckon-0.2.0-py2.py3-none-any.whl (8.7 kB view details)

Uploaded Python 2 Python 3

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

Hashes for reckon-0.2.0.tar.gz
Algorithm Hash digest
SHA256 e6133d72a076869ad7f46f8aee12277d3f0d874ad4eae0a05fe33f6536dde027
MD5 7dd075baa9659ccf8075bf58747c2e7b
BLAKE2b-256 aca68e339445d9b11e30d57fd764b3082a006d4d093215787f12a6a6bfc9cd96

See more details on using hashes here.

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

Hashes for reckon-0.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 1812389b46f46cf8fa96654a798c43495ef50cd155cc3e90b7c24929c628c7b6
MD5 327d25e4d0e23f60675b01497fd0b37f
BLAKE2b-256 0f4f723513cac87843ab2387c699d61ceecbc23ba98eab3c19c2ab1b21cd33e0

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page