#object-storage #storage #storage-service #s3 #acme #cages #evervault

storage-client-interface

A Rust library for exposing the StorageClientInterface trait for interacting with a storage backend. Used by Evervault Cages.

2 unstable releases

0.2.0 Aug 31, 2023
0.1.0 Aug 30, 2023

#1386 in Development tools

Download history 8/week @ 2024-03-13 3/week @ 2024-03-20 41/week @ 2024-03-27 33/week @ 2024-04-03 3/week @ 2024-04-17 13/week @ 2024-04-24 43/week @ 2024-05-08 5/week @ 2024-05-15 7/week @ 2024-06-05 19/week @ 2024-06-12 49/week @ 2024-06-19 14/week @ 2024-06-26

89 downloads per month

Apache-2.0

9KB
130 lines

storage-client-interface

The StorageClientInterface is a trait that defines a set of methods for interacting with object storage. It provides a clear and standardized way to perform common operations for retrieving, uploading, and deleting objects from a storage service. An S3 implementation is also provided under the feature s3 which is included under the default feature.

Trait Definition

use async_trait::async_trait;
use thiserror::Error;

#[derive(Error, Debug)]
pub enum StorageClientError {
    #[error("GetObject Error: {0}")]
    GetObject(String),
    #[error("PutObject Error: {0}")]
    PutObject(String),
    #[error("DeleteObject Error: {0}")]
    DeleteObject(String),
    #[error("Storage Client Error - {0}")]
    General(String),
}

#[async_trait]
pub trait StorageClientInterface {
    async fn get_object(&self, key: String) -> Result<Option<String>, StorageClientError>;
    async fn put_object(&self, key: String, body: String) -> Result<(), StorageClientError>;
    async fn delete_object(&self, key: String) -> Result<(), StorageClientError>;
}

Methods

get_object

Retrieves an object from the storage service based on the provided key.

async fn get_object(&self, key: String) -> Result<Option<String>, StorageClientError>;

put_object

Uploads an object to the storage service with the given key and body.

async fn put_object(&self, key: String, body: String) -> Result<(), StorageClientError>;

delete_object

Deletes an object from the storage service using the specified key.

async fn delete_object(&self, key: String) -> Result<(), StorageClientError>;

Dependencies

~0.3–6.5MB
~110K SLoC