foyer-py 0.0.5

Python bindings for the foyer Rust hybrid cache library.

foyer-py

Python bindings for the Rust foyer hybrid cache library.

foyer-py is published on PyPI and imported as foyer.

Current status

• Sync in-memory cache bindings are available.
• Sync hybrid cache bindings are available (internally uses Tokio).
• Keys: bytes, str, int.
• Values: bytes.

Quick start

import foyer

cache = foyer.Cache(16)
cache.insert("hello", b"world")

assert cache.get("hello") == b"world"
assert cache.contains("hello")
assert cache.entries == 1

Hybrid cache (sync API)

import tempfile
import foyer

with tempfile.TemporaryDirectory() as path:
    cache = foyer.HybridCache(path, memory_capacity=64 * 1024 * 1024, storage_capacity=256 * 1024 * 1024)
    cache.insert(42, b"The answer")
    assert cache.get(42) == b"The answer"
    cache.close()

Wheel coverage

GitHub Actions builds wheels for:

• Linux: x86_64, aarch64 (manylinux)
• macOS: universal2 (Intel + Apple Silicon)
• Windows: x86_64

Releases are published from tags matching v* (for example v0.0.3).