Struct LocalFileStore 

pub struct LocalFileStore { /* private fields */ }

Local file-based session store.

This is the default storage backend, suitable for single-machine use.

Features

• Sessions stored as pretty-printed JSON
• Atomic writes (write to temp, then rename)
• Automatic directory creation

Example

use orcs_runtime::session::{LocalFileStore, SessionStore, SessionAsset};
use std::path::PathBuf;

let store = LocalFileStore::new(PathBuf::from("~/.orcs/sessions"))?;

// Save a session
let asset = SessionAsset::new();
store.save(&asset).await?;

// List all sessions
let sessions = store.list().await?;
println!("Found {} sessions", sessions.len());

Implementations

impl LocalFileStore

pub fn new(base_path: PathBuf) -> Result<Self, StorageError>

Creates a new local file store.

The directory will be created if it doesn’t exist.

Errors

Returns StorageError::DirectoryCreation if the directory cannot be created.

pub fn base_path(&self) -> &PathBuf

Returns the base path.

Trait Implementations

impl Clone for LocalFileStore

fn clone(&self) -> LocalFileStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LocalFileStore

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

Formats the value using the given formatter.

impl SessionStore for LocalFileStore

async fn save(&self, asset: &SessionAsset) -> Result<(), StorageError>

Saves a session asset.

async fn load(&self, id: &str) -> Result<SessionAsset, StorageError>

Loads a session asset by ID.

async fn list(&self) -> Result<Vec<SessionMeta>, StorageError>

Lists all session metadata.

async fn delete(&self, id: &str) -> Result<(), StorageError>

Deletes a session by ID.

async fn exists(&self, id: &str) -> Result<bool, StorageError>

Checks if a session exists.

fn sync_status(&self) -> SyncStatus

Returns the current sync status.