/* * * This abstraction goal is to leverage all the semantic of Garage K2V+S3, * to be as tailored as possible to it ; it aims to be a zero-cost abstraction * compared to when we where directly using the K2V+S3 client. * * My idea: we can encapsulate the causality token * into the object system so it is not exposed. */ use std::hash::{Hash, Hasher}; use futures::future::BoxFuture; pub mod in_memory; pub mod garage; pub enum Alternative { Tombstone, Value(Vec), } type ConcurrentValues = Vec; pub enum Selector<'a> { Range { begin: &'a str, end: &'a str }, List (Vec<(&'a str, &'a str)>), Prefix (&'a str), } #[derive(Debug)] pub enum StorageError { NotFound, Internal, } impl std::fmt::Display for StorageError { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { f.write_str("Storage Error: "); match self { Self::NotFound => f.write_str("Item not found"), Self::Internal => f.write_str("An internal error occured"), } } } impl std::error::Error for StorageError {} // Utils pub type AsyncResult<'a, T> = BoxFuture<'a, Result>; // ----- Builders pub trait IBuilders { fn row_store(&self) -> Result; fn blob_store(&self) -> Result; fn url(&self) -> &str; } pub type Builders = Box; impl Clone for Builders { fn clone(&self) -> Self { // @FIXME write a real implementation with a box_clone function Box::new(in_memory::FullMem{}) } } impl std::fmt::Debug for Builders { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { f.write_str("aerogramme::storage::Builder") } } impl PartialEq for Builders { fn eq(&self, other: &Self) -> bool { self.url() == other.url() } } impl Eq for Builders {} impl Hash for Builders { fn hash(&self, state: &mut H) { self.url().hash(state); } } // ------ Row pub trait IRowStore { fn row(&self, partition: &str, sort: &str) -> RowRef; fn select(&self, selector: Selector) -> AsyncResult>; } pub type RowStore = Box; pub trait IRowRef { fn clone_boxed(&self) -> RowRef; fn key(&self) -> (&str, &str); fn set_value(&self, content: Vec) -> RowValue; fn fetch(&self) -> AsyncResult; fn rm(&self) -> AsyncResult<()>; fn poll(&self) -> AsyncResult; } pub type RowRef = Box; impl Clone for RowRef { fn clone(&self) -> Self { return self.clone_boxed() } } pub trait IRowValue { fn to_ref(&self) -> RowRef; fn content(&self) -> ConcurrentValues; fn push(&self) -> AsyncResult<()>; } pub type RowValue = Box; // ------- Blob pub trait IBlobStore { fn blob(&self, key: &str) -> BlobRef; fn list(&self, prefix: &str) -> AsyncResult>; } pub type BlobStore = Box; pub trait IBlobRef { fn set_value(&self, content: Vec) -> BlobValue; fn key(&self) -> &str; fn fetch(&self) -> AsyncResult; fn copy(&self, dst: &BlobRef) -> AsyncResult<()>; fn rm(&self) -> AsyncResult<()>; } pub type BlobRef = Box; pub trait IBlobValue { fn to_ref(&self) -> BlobRef; fn get_meta(&self, key: &str) -> Option<&[u8]>; fn content(&self) -> Option<&[u8]>; fn push(&self) -> AsyncResult<()>; } pub type BlobValue = Box;