Struct Storage

pub struct Storage { /* private fields */ }

Implementations

impl Storage

pub async fn download( &self, key: String, to_path: PathBuf, ) -> Result<(), String>

download an object from the bucket

Arguments

• key - the key of the object to download
• to_path - the path to download the object to

Errors

• could not download the object
• could not write the object to the given path

pub async fn download_uri( &self, key: String, expires_in: Option<Duration>, ) -> Result<String, String>

if expires_in is None, then we assume the bucket is publicly accessible and return the public URL. For this to work, you have to make sure the bucket’s policy allows public access. TODO: validate the uri we return in this case is valid, and if not, return an error

Arguments

• key - the key of the object to download
• expires_in - the duration for which the download URI will be valid

Errors

• could not retrieve the download URI

pub async fn upload( &self, key: String, bytes: Vec<u8>, content_type: String, _content_md5: String, ) -> Result<(), String>

upload an object to the bucket

Arguments

• key - the key of the object to upload
• bytes - the bytes of the object to upload
• content_type - the content type of the object to upload
• content_md5 - md5 hash of the object to upload

Errors

• could not upload the object

pub async fn upload_uri( &self, key: String, expires_in: Duration, ) -> Result<UploadURI, String>

returns a URI that can be used to upload an object to the bucket

Arguments

• key - the key of the object to upload
• expires_in - the duration for which the upload URI will be valid

Errors

• could not retrieve the upload URI

pub async fn delete(&self, key: String) -> Result<(), String>

delete an object from the bucket

Arguments

• key - the key of the object to delete

Errors

• could not delete the object

pub async fn delete_many(&self, keys: Vec<String>) -> Result<(), String>

delete many objects from the bucket

Arguments

• keys - a vector of keys to delete

Errors

• could not delete the objects

pub fn new() -> Self

Trait Implementations

impl Clone for Storage

fn clone(&self) -> Storage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Storage

fn default() -> Self

Returns the “default value” for a type.