#aws #s3 #minio

rusty-s3

Simple pure Rust AWS S3 Client following a Sans-IO approach

10 releases

Uses new Rust 2021

0.3.2 Aug 30, 2022
0.3.1 Jun 17, 2022
0.3.0 Apr 25, 2022
0.2.1 Dec 29, 2021
0.0.2 Dec 11, 2020

#568 in Network programming

Download history 366/week @ 2022-08-18 929/week @ 2022-08-25 865/week @ 2022-09-01 745/week @ 2022-09-08 973/week @ 2022-09-15 1514/week @ 2022-09-22 922/week @ 2022-09-29 739/week @ 2022-10-06 597/week @ 2022-10-13 188/week @ 2022-10-20 186/week @ 2022-10-27 198/week @ 2022-11-03 142/week @ 2022-11-10 227/week @ 2022-11-17 123/week @ 2022-11-24 173/week @ 2022-12-01

711 downloads per month
Used in 5 crates (3 directly)

BSD-2-Clause

135KB
3K SLoC

rusty-s3

crates.io Documentation dependency status Rustc Version 1.61+ CI codecov

Simple pure Rust AWS S3 Client following a Sans-IO approach, with a modern and rusty take onto s3's APIs.

Request signing and response parsing capabilities are provided for the most common S3 actions, using AWS Signature Version 4.

Minio compatibility tested on every commit by GitHub Actions.

Examples

use std::env;
use std::time::Duration;
use rusty_s3::{Bucket, Credentials, S3Action, UrlStyle};

// setting up a bucket
let endpoint = "https://s3.dualstack.eu-west-1.amazonaws.com".parse().expect("endpoint is a valid Url");
let path_style = UrlStyle::VirtualHost;
let name = "rusty-s3";
let region = "eu-west-1";
let bucket = Bucket::new(endpoint, path_style, name, region).expect("Url has a valid scheme and host");

// setting up the credentials
let key = env::var("AWS_ACCESS_KEY_ID").expect("AWS_ACCESS_KEY_ID is set and a valid String");
let secret = env::var("AWS_SECRET_ACCESS_KEY").expect("AWS_ACCESS_KEY_ID is set and a valid String");
let credentials = Credentials::new(key, secret);

// signing a request
let presigned_url_duration = Duration::from_secs(60 * 60);
let action = bucket.get_object(Some(&credentials), "duck.jpg");
println!("GET {}", action.sign(presigned_url_duration));

More examples can be found in the examples directory on GitHub.

Supported S3 actions

Dependencies

~2.2–3MB
~90K SLoC