Struct FileStorage 

pub struct FileStorage { /* private fields */ }

File storage using a pluggable backend

This struct wraps a StorageBackend implementation and provides higher-level operations like index management.

Implementations

impl FileStorage

pub fn new(config: FileConfig) -> Self

Create a new file storage with the default local backend

pub fn with_backend( config: FileConfig, backend: Box<dyn StorageBackend>, ) -> Self

Create a file storage with a custom backend

This allows using different storage backends like S3, Azure Blob, etc.

Example

use agent_diva_files::{FileStorage, FileConfig};
use agent_diva_files::backend::LocalStorageBackend;
use std::path::PathBuf;

let config = FileConfig::default();
let backend = LocalStorageBackend::new(PathBuf::from("/custom/path"));
let storage = FileStorage::with_backend(config, Box::new(backend));

pub async fn initialize(&self) -> Result<()>

Initialize the storage backend

pub async fn store_data(&self, hash: &str, data: &[u8]) -> Result<PathBuf>

Store file data and return the relative path

The hash is used as the key for content-addressed storage.

pub async fn read_data(&self, relative_path: &Path) -> Result<Vec<u8>>

Read file data by relative path

pub async fn delete_data(&self, relative_path: &Path) -> Result<()>

Delete file data by relative path

pub async fn exists(&self, hash: &str) -> bool

Check if a file exists by hash

pub fn full_path(&self, relative_path: &Path) -> PathBuf

Get the full path for a relative path

pub async fn stats(&self) -> Result<StorageStats>

Get storage statistics

pub fn backend(&self) -> &dyn StorageBackend

Get a reference to the underlying backend