firm-cache

Database-backed caching for Python — a pure-Python port of Rails' Solid Cache. No Redis required: cache entries live in your existing SQLite, PostgreSQL, or MySQL/MariaDB database.

Part of firm, a port of the Rails 8 Solid stack.

pip install firm-cache
pip install "firm-cache[encryption]"  # with at-rest encryption

Quickstart

from firm.cache import Cache

cache = Cache(database_url="postgresql://localhost/myapp")

cache.set("greeting", "hello")
cache.get("greeting")  # "hello"
cache.fetch("expensive", lambda: compute())  # compute once, then cached

Highlights

• FIFO eviction by age, total size, or entry count — tuned in the background, like Solid Cache
• Cache anything you can serialize — JSON by default; raw bytes (thumbnails, protobuf, compressed blobs) and ~⅓ smaller rows with firm-cache[msgpack]; arbitrary Python objects with the opt-in pickle coder
• At-rest encryption (Fernet) via firm-cache[encryption]
• fetch, get_multi/set_multi, increment/decrement

Docs

• Cache overview
• All firm documentation

MIT licensed. Schema and design derived from Solid Cache (© 37signals, MIT); see NOTICE.