Skip to content

bwasti/cache.py

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 

Repository files navigation

Cache

cache.py is a one file python library that extends memoization across runs using a cache file.

Often it takes some time to load files, do expensive data processing, and train models. As a result, many nice tools have popped up to make the experience smoother, like Jupyter notebooks. However, these tools make it hard to keep coding conventions clean and develop a library-like interface for your project.

cache.py attempts to make it painless to cache expensive functions across python runs, enabling quick iteration while developing usable code.

Usage

To use the file, import cache and annotate functions with @cache.cache().

import cache

@cache.cache()
def expensive_func(arg, kwarg=None):
  # Expensive stuff here
  return arg

The @cache.cache() function can take multiple arguments.

  • @cache.cache(timeout=20) - Only caches the function for 20 seconds.
  • @cache.cache(fname="my_cache.pkl") - Saves cache to a custom filename (defaults to hidden file .cache.pkl)
  • @cache.cache(key=cache.ARGS[KWARGS,NONE]) - Check against args, kwargs or neither of them when doing a cache lookup.

How it works

With a file loaded from disk, cache.py checks against the name, arguments and hash of a function's source to decide if the function has been run before. If it has it returns the cached result immediately. It currently uses pickle and inspect under the hood, making it non-portable.

About

Python memoization across program runs.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages