object_store_aws 0.13.1

Object store extension for AWS cloud
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

# object_store_aws

[![Rust](https://github.com/DoumanAsh/object_store_aws/actions/workflows/rust.yml/badge.svg)](https://github.com/DoumanAsh/object_store_aws/actions/workflows/rust.yml)
[![Crates.io](https://img.shields.io/crates/v/object_store_aws.svg)](https://crates.io/crates/object_store_aws)
[![Documentation](https://docs.rs/object_store_aws/badge.svg)](https://docs.rs/crate/object_store_aws/)

AWS extensions for [object_store](https://crates.io/crates/object_store) crate based on AWS SDK

It provides credentials source and optional HTTP client based on SDK's http client

## Features

- `sso` - Enables SSO usage in [aws-config](https://crates.io/crates/aws-config)
- `ring` - Enables ring crypto backend for AWS HTTP client
- `aws-lc` - Enables aws-lc crypto backend for AWS HTTP client
- `aws-lc-fips` - Enables aws-lc FIPS friendly crypto backend for AWS HTTP client

## Usage

```rust
use core::fmt;
use std::sync::Arc;
use object_store_aws::{object_store, init, AmazonS3Builder};
use object_store_aws::object_store::ObjectStore;
use object_store_aws::object_store::multipart::MultipartStore;

async fn create_s3_store() -> impl ObjectStore + MultipartStore + fmt::Debug + Send + Sync + Clone + 'static {
    let credentials = Arc::new(init(None).await.expect("to initialize S3 SDK"));
    AmazonS3Builder::from_env().with_bucket_name("my-super-bucket")
                               .with_region(credentials.region_str())
                               .with_credentials(credentials).build()
                               .expect("to create S3 store")
}
```