s3 0.1.28

A lean, modern, unofficial S3-compatible client for Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

#[cfg(feature = "async")]
use std::{future::Future, pin::Pin, sync::Arc, time::Duration};

#[cfg(feature = "async")]
use s3::{Auth, Client, Credentials, CredentialsProvider, CredentialsSnapshot};

#[cfg(feature = "async")]
type ProviderFuture<'a> =
    Pin<Box<dyn Future<Output = s3::Result<CredentialsSnapshot>> + Send + 'a>>;

#[cfg(feature = "async")]
#[derive(Clone, Debug)]
struct StaticProvider {
    credentials: Credentials,
}

#[cfg(feature = "async")]
impl CredentialsProvider for StaticProvider {
    fn credentials_async(&self) -> ProviderFuture<'_> {
        let snapshot = CredentialsSnapshot::new(self.credentials.clone());
        Box::pin(async move { Ok(snapshot) })
    }

    #[cfg(feature = "blocking")]
    fn credentials_blocking(&self) -> s3::Result<CredentialsSnapshot> {
        Ok(CredentialsSnapshot::new(self.credentials.clone()))
    }
}

#[cfg(feature = "async")]
#[allow(clippy::result_large_err)]
#[tokio::main]
async fn main() -> Result<(), s3::Error> {
    let provider = StaticProvider {
        credentials: Credentials::new("TESTACCESSKEY", "TESTSECRETKEY")?,
    };

    let client = Client::builder("https://s3.example.com")?
        .region("us-east-1")
        .auth(Auth::provider(Arc::new(provider)))
        .build()?;

    let presigned = client
        .objects()
        .presign_get("my-bucket", "path/to/object.txt")
        .expires_in(Duration::from_secs(300))
        .build_async()
        .await?;

    println!("{}", presigned.url);
    Ok(())
}

#[cfg(not(feature = "async"))]
fn main() {
    eprintln!("This example requires the `async` feature (enabled by default).");
}