Struct MemoryStorage 

pub struct MemoryStorage { /* private fields */ }

A storage that keeps entries in memory for the lifetime of the process.

Used where nothing durable is available (no-std, or a cache root that can’t be opened). Entries do not survive a restart, so an imported bundle has to be imported again on the next run, which costs nothing but time.

Implementations

impl MemoryStorage

pub fn new(namespace: &str) -> Self

The in-memory storage for namespace, shared process-wide across every environment.

The environment-bound path uses in_environment instead, which isolates the entries per environment so a switch doesn’t serve the previous one’s data. This unscoped constructor is for explicit storages that aren’t tied to an environment (tests, benches).

pub fn namespaces() -> Vec<NamespaceSummary>

Every namespace the active environment holds in memory.

Only the active environment’s entries are reported: the process-wide map also holds other environments’ entries and unscoped explicit storages, but a summary is always about the environment in effect right now.

Trait Implementations

impl Clone for MemoryStorage

fn clone(&self) -> MemoryStorage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryStorage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Storage for MemoryStorage

fn get(&self, key: &[u8]) -> Option<Bytes>

The value stored under key, if any.

fn insert(&self, key: &[u8], value: Bytes, origin: Origin) -> Insertion

Stores value under key. See the trait contract for when the write is declined.

fn replace(&self, key: &[u8], value: Bytes, origin: Origin) -> Insertion

Stores value under key, overwriting whatever is there.

fn scan(&self, visit: &mut dyn FnMut(&[u8], &[u8]))

Visits every entry of the namespace.

fn purge(&self)

Deletes every entry of the namespace, durably.

fn purge_key(&self, key: &[u8])

Deletes the entry under key, durably. Same failure contract as purge.

fn describe(&self) -> String

Human-readable location for log messages.

fn insert_many( &self, entries: &mut dyn Iterator<Item = (Bytes, Bytes)>, origin: Origin, ) -> InsertSummary

Stores many entries under the same rules as insert.

fn loading(&self) -> bool

Whether the storage is still loading its content asynchronously. Entries become visible through get and scan once the load completes.