18 releases (breaking)

0.13.0 Feb 3, 2025
0.11.0 Oct 17, 2024
0.9.0 Jun 26, 2024
0.8.0 Mar 8, 2024
0.0.1 Mar 14, 2023

#2436 in Network programming

Download history 690/week @ 2024-10-23 483/week @ 2024-10-30 372/week @ 2024-11-06 926/week @ 2024-11-13 936/week @ 2024-11-20 197/week @ 2024-11-27 536/week @ 2024-12-04 301/week @ 2024-12-11 151/week @ 2024-12-18 12/week @ 2024-12-25 426/week @ 2025-01-08 474/week @ 2025-01-15 289/week @ 2025-01-22 356/week @ 2025-01-29 277/week @ 2025-02-05

1,419 downloads per month

Apache-2.0

590KB
11K SLoC

mountpoint-s3-client

This crate provides a high-performance Amazon S3 client for use by Mountpoint for Amazon S3. The client binds to the AWS Common Runtime, which provides features such as AWS authentication, a HTTP client, and low-level IO primitives.

This crate is not intended for general-purpose use and we consider its interface to be unstable. Customers looking for a general-purpose Amazon S3 client in Rust should use the official AWS SDK for Rust.


lib.rs:

An Amazon S3 client built on top of the AWS Common Runtime (AWS CRT).

This crate provides a high-performance implementation of an Amazon S3 client that uses the AWS Common Runtime (CRT). The CRT is a software library for interacting with AWS services, offering components like IO, HTTP, and encryption. The CRT is purpose-built for high performance and low resource usage to make the most efficient use of your compute resources. For Amazon S3, the CRT includes a client that implements best practice performance design patterns, including timeouts, retries, and automatic request parallelization for high throughput.

This crate is not intended for general-purpose use and we consider its interface to be unstable. Customers looking for a general-purpose Amazon S3 client in Rust should use the official AWS SDK for Rust.

Example

To construct a new S3 client and download an object from a bucket in the us-east-1 region:

use futures::{TryFutureExt, TryStreamExt};
use mountpoint_s3_client::types::GetObjectParams;
use mountpoint_s3_client::{S3CrtClient, ObjectClient};

let client = S3CrtClient::new(Default::default()).expect("client construction failed");

let response = client.get_object("my-bucket", "my-key", &GetObjectParams::new()).await.expect("get_object failed");
let body = response.map_ok(|(offset, body)| body.to_vec()).try_concat().await.expect("body streaming failed");

To further configure the client, use the S3ClientConfig builder:

use mountpoint_s3_client::S3CrtClient;
use mountpoint_s3_client::config::{S3ClientAuthConfig, S3ClientConfig, EndpointConfig};

let config = S3ClientConfig::new()
                .endpoint_config(EndpointConfig::new("us-west-2"))
                .auth_config(S3ClientAuthConfig::NoSigning);
let client = S3CrtClient::new(config).expect("client construction failed");

Dependencies

~40–54MB
~1M SLoC