Struct StorageConfig 

pub struct StorageConfig {
    pub backend: String,
    pub data_path: Option<PathBuf>,
    pub in_memory: bool,
}

Storage backend configuration

Determines which storage implementation to use and how to configure it.

Fields

backend: String

Backend type identifier

Supported values:

• "automerge-memory": Automerge in-memory (POC, testing)
• "redb": redb persistence (production target)

data_path: Option<PathBuf>

Data directory path for persistent backends

Required for redb, optional for others. Example: /var/cap/data, ./data, /tmp/cap-test

in_memory: bool

Run in pure in-memory mode (no disk persistence)

When true, the automerge backend will skip all disk writes and store documents only in the LRU cache. Useful for high-throughput testing where persistence is not needed.

Implementations

impl StorageConfig

pub fn from_env() -> Result<Self>

Create configuration from environment variables

Environment Variables

• CAP_STORAGE_BACKEND (default: “automerge-memory”)
• CAP_DATA_PATH (optional, required for some backends)

Returns

StorageConfig loaded from environment

Example

export CAP_STORAGE_BACKEND=automerge-memory
export CAP_DATA_PATH=/var/cap/data

let config = StorageConfig::from_env()?;
assert_eq!(config.backend, "automerge-memory");

pub fn validate(&self) -> Result<()>

Validate configuration

Checks that required fields are present for the selected backend.

Returns

Ok(()) if valid, Err with description if invalid

Errors

• redb requires data_path
• Unknown backend type

Trait Implementations

impl Clone for StorageConfig

fn clone(&self) -> StorageConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StorageConfig

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

Formats the value using the given formatter.

impl Default for StorageConfig

fn default() -> Self

Create configuration with defaults

Uses the Automerge in-memory backend.

Returns

Default configuration (Automerge in-memory backend)