foyer-py 0.0.6

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).
• Native async APIs are available for both cache types.
• 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()

Async APIs

import asyncio
import tempfile
import foyer


async def main() -> None:
    cache = foyer.AsyncCache(16)
    await cache.insert("hello", b"world")
    assert await cache.get("hello") == b"world"

    with tempfile.TemporaryDirectory() as path:
        hybrid = await foyer.AsyncHybridCache.create(path)
        await hybrid.insert(42, b"The answer")
        assert await hybrid.get(42) == b"The answer"
        await hybrid.close()


asyncio.run(main())

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).