theine 0.1.2

high performance in-memory cache

theine

High performance in-memory cache inspired by Caffeine.

• High performance Rust core
• High hit ratio with W-TinyLFU evication policy
• Expired data are removed automatically using hierarchical timer wheel
• Simple API
• Django cache backend

Benchmarks

https://github.com/Yiling-J/cacheme-benchmark

Requirements

Python 3.7+

Installation

pip install theine

API

from theine import Cache
from datetime import timedelta

cache = Cache("tlfu", 10000)
# without default, return None on miss
v = cache.get("key")

# with default, return default on miss
sentinel = object()
v = cache.get(key, sentinel)

# set with ttl
cache.set("key", {"foo": "bar"}, timedelta(seconds=100))

# delete from cache
cache.delete("key")

Django Cache Backend

CACHES = {
    "default": {
        "BACKEND": "theine.adapters.django.Cache",
        "TIMEOUT": 300,
        "OPTIONS": {"MAX_ENTRIES": 10000},
    },
}