Struct MemoryStore 

pub struct MemoryStore { /* private fields */ }

A process-local cache. Cloning shares one store, so it can be registered as application state and handed to every handler.

Implementations

impl MemoryStore

pub fn new() -> Self

pub fn with_prefix(prefix: impl Into<String>) -> Self

pub fn with_options(prefix: impl Into<String>, sweep_every: Duration) -> Self

Build a store with an explicit sweep interval.

The sweep is spawned only when a Tokio runtime is already running, so constructing a cache during boot — before the runtime exists — works and simply relies on lazy eviction until the process starts serving.

pub fn sweep(&self)

Remove expired entries now. The background sweep calls this; tests call it directly rather than waiting a minute.

pub fn len(&self) -> usize

How many unexpired entries are held. For tests and diagnostics.

pub fn is_empty(&self) -> bool

Trait Implementations

impl Cache for MemoryStore

fn driver(&self) -> &'static str

The driver’s name, used in cache.hit / cache.miss events and in error messages. Telescope shows it as the store column.

fn get<'a>(&'a self, key: &'a str) -> BoxFuture<'a, Result<Option<Json>>>

Fetch a value, or None when it is missing or expired.

fn put<'a>( &'a self, key: &'a str, value: Json, ttl: Duration, ) -> BoxFuture<'a, Result<()>>

Store a value that expires after ttl.

fn forever<'a>(&'a self, key: &'a str, value: Json) -> BoxFuture<'a, Result<()>>

Store a value with no expiry. It still goes away on Cache::flush.

fn forget<'a>(&'a self, key: &'a str) -> BoxFuture<'a, Result<bool>>

Remove a key. Returns whether something was actually there.

fn flush(&self) -> BoxFuture<'_, Result<()>>

Remove everything this store owns.

fn increment<'a>(&'a self, key: &'a str, by: i64) -> BoxFuture<'a, Result<i64>>

Add by to a counter, creating it at zero first. Returns the new value.

fn increment_within<'a>( &'a self, key: &'a str, by: i64, ttl: Duration, ) -> BoxFuture<'a, Result<i64>>

Increment a counter, giving it ttl only when this call created it.

fn ttl<'a>(&'a self, key: &'a str) -> BoxFuture<'a, Result<Option<Duration>>>

How long until a key expires: None when it is missing or immortal.

fn has<'a>(&'a self, key: &'a str) -> BoxFuture<'a, Result<bool>>

Whether a live (unexpired) value exists.

fn decrement<'a>(&'a self, key: &'a str, by: i64) -> BoxFuture<'a, Result<i64>>

Subtract by from a counter. Returns the new value.

fn pull<'a>(&'a self, key: &'a str) -> BoxFuture<'a, Result<Option<Json>>>

Read a value and remove it in one call — Laravel’s Cache::pull.

impl Clone for MemoryStore

fn clone(&self) -> MemoryStore

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for MemoryStore

fn default() -> Self

Returns the “default value” for a type.