orionis.cache.contracts.ICacheRepository

ORIONIS API REFERENCE

Modules Classes Names

THE ORIONIS API

Build with clarity.

Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.

Explore modules View classes

class documentation

class ICacheRepository(ABC): (source)

Known subclasses: orionis.cache.CacheRepository

View In Hierarchy

Undocumented

Async Method	`add`	Store value only if key does not already exist.
Async Method	`clear`	Remove all entries from the store.
Async Method	`decrement`	Decrement the integer stored at key by amount.
Async Method	`delete`	Remove key from the store.
Async Method	`get`	Retrieve the cached value for key.
Async Method	`getMany`	Retrieve multiple values at once.
Async Method	`has`	Check whether key exists and has not expired.
Async Method	`increment`	Increment the integer stored at key by amount.
Async Method	`pull`	Return and immediately delete key from the store.
Async Method	`remember`	Return the cached value; resolve and cache if absent.
Async Method	`rememberForever`	Return the cached value; resolve and cache forever if absent.
Async Method	`replace`	Replace a live entry atomically without creating a missing key.
Async Method	`set`	Store value under key with an optional TTL.
Async Method	`setMany`	Store multiple key/value pairs with an optional TTL.
Class Variable	`__slots__`	Undocumented

@abstractmethod

async def add(self, key: str, value: Any, ttl: float | None = None) -> bool: (source) ¶

overridden in orionis.cache.CacheRepository

Store value only if key does not already exist.

Parameters
key:`str`	Cache key.
value:`Any`	Value to store.
ttl:`float \| None`	Optional TTL in seconds.

Returns
`bool`	`True` on success, `False` when the key already exists.

@abstractmethod

async def clear(self) -> bool: (source) ¶

overridden in orionis.cache.CacheRepository

Remove all entries from the store.

Returns
`bool`	`True` on success.

@abstractmethod

async def decrement(self, key: str, amount: int = 1) -> int: (source) ¶

overridden in orionis.cache.CacheRepository

Decrement the integer stored at key by amount.

Parameters
key:`str`	Cache key.
amount:`int`	Amount to subtract.

Returns
`int`	New value after decrement.

@abstractmethod

async def delete(self, key: str) -> bool: (source) ¶

overridden in orionis.cache.CacheRepository

Remove key from the store.

Parameters
key:`str`	Cache key.

Returns
`bool`	`True` if the key existed.

@abstractmethod

async def get(self, key: str) -> Any: (source) ¶

overridden in orionis.cache.CacheRepository

Retrieve the cached value for key.

Parameters
key:`str`	Cache key.

Returns
`Any`	Cached value, or `None` when absent.

@abstractmethod

async def getMany(self, keys: list[str]) -> dict[str, Any]: (source) ¶

overridden in orionis.cache.CacheRepository

Retrieve multiple values at once.

Parameters
keys:`list[str]`	Cache keys.

Returns
`dict[str, Any]`	Mapping of key → value; missing keys map to `None`.

@abstractmethod

async def has(self, key: str) -> bool: (source) ¶

overridden in orionis.cache.CacheRepository

Check whether key exists and has not expired.

Parameters
key:`str`	Cache key.

Returns
`bool`	`True` if present and valid.

@abstractmethod

async def increment(self, key: str, amount: int = 1) -> int: (source) ¶

overridden in orionis.cache.CacheRepository

Increment the integer stored at key by amount.

Parameters
key:`str`	Cache key.
amount:`int`	Amount to add.

Returns
`int`	New value after increment.

@abstractmethod

async def pull(self, key: str) -> Any: (source) ¶

overridden in orionis.cache.CacheRepository

Return and immediately delete key from the store.

Parameters
key:`str`	Cache key.

Returns
`Any`	Cached value, or `None` when absent.

@abstractmethod

async def remember(self, key: str, ttl: float | None, resolver: Callable) -> Any: (source) ¶

overridden in orionis.cache.CacheRepository

Return the cached value; resolve and cache if absent.

Parameters
key:`str`	Cache key.
ttl:`float \| None`	TTL applied when caching the resolved value.
resolver:`Callable`	Zero-argument callable (sync or async) producing the value.

Returns
`Any`	Cached or freshly computed value.

@abstractmethod

async def rememberForever(self, key: str, resolver: Callable) -> Any: (source) ¶

overridden in orionis.cache.CacheRepository

Return the cached value; resolve and cache forever if absent.

Parameters
key:`str`	Cache key.
resolver:`Callable`	Zero-argument callable (sync or async) producing the value.

Returns
`Any`	Cached or freshly computed value.

@abstractmethod

async def replace(self, key: str, value: Any, ttl: float | None = None) -> bool: (source) ¶

overridden in orionis.cache.CacheRepository

Replace a live entry atomically without creating a missing key.

Parameters
key:`str`	Cache key that must already exist.
value:`Any`	Replacement value.
ttl:`float \| None`	New lifetime in seconds, or None for no expiry.

Returns
`bool`	True when replaced; False when missing, expired or superseded.

@abstractmethod

async def set(self, key: str, value: Any, ttl: float | None = None) -> bool: (source) ¶

overridden in orionis.cache.CacheRepository

Store value under key with an optional TTL.

Parameters
key:`str`	Cache key.
value:`Any`	Value to cache.
ttl:`float \| None`	Time-to-live in seconds. `None` means no expiry.

Returns
`bool`	`True` on success.

@abstractmethod

async def setMany(self, values: dict[str, Any], ttl: float | None = None) -> bool: (source) ¶

overridden in orionis.cache.CacheRepository

Store multiple key/value pairs with an optional TTL.

Parameters
values:`dict[str, Any]`	Mapping of key → value.
ttl:`float \| None`	Shared TTL in seconds.

Returns
`bool`	`True` on success.

__slots__: tuple = (source) ¶

overridden in orionis.cache.CacheRepository

Undocumented