[](https://www.rust-lang.org/downloads.html)
[](https://github.com/durch/rust-s3/actions)
[](https://crates.io/crates/rust-s3)
[](https://github.com/durch/rust-s3/blob/master/LICENSE.md)
## rust-s3 [[docs](https://docs.rs/rust-s3/)]
Rust library for working with Amazon S3 or arbitrary S3 compatible APIs, fully compatible with **async/await** and `futures ^0.3`
### Support further development
+ BTC - `3QQdtQGSMStTWEBhe65hPiAWJekXH8n26o`
+ ETH - `0x369Fd06ACc25CCfE0A28BE40018cF3aC38AcdcB6`
### Intro
Modest interface towards Amazon S3, as well as S3 compatible object storage APIs such as Wasabi, Yandex, Minio or Google Cloud Storage.
Supports `put`, `get`, `list`, `delete`, operations on `tags` and `location`.
Additionally a dedicated `presign_get` `Bucket` method is available. This means you can upload to s3, and give the link to select people without having to worry about publicly accessible files on S3. This also means that you can give people
a `PUT` presigned URL, meaning they can upload to a specific key in S3 for the duration of the presigned URL.
**[AWS, Yandex and Custom (Minio) Example](https://github.com/durch/rust-s3/blob/master/s3/bin/simple_crud.rs)**
#### Path or subdomain style URLs and headers
`Bucket` struct provides constructors for `path-style` paths, `subdomain` style is the default. `Bucket` exposes methods for configuring and accessing `path-style` configuration.
#### Buckets
| `create` | [async](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.create) |
| `delete` | [async](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.delete) |
#### Presign
| `PUT` | [presign_put](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.presign_put) |
| `GET` | [presign_get](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.presign_get) |
#### GET
There are a few different options for getting an object. `sync` and `async` methods are generic over `std::io::Write`,
while `tokio` methods are generic over `tokio::io::AsyncWriteExt`.
| `async` | [get_object](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.get_object) |
| `async` | [get_object_stream](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.get_object_stream) |
| `sync` | [get_object_blocking](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.get_object_blocking) |
| `sync` | [get_object_stream_blocking](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.get_object_stream_blocking) |
| `tokio` | [tokio_get_object_stream](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.tokio_get_object_stream) |
#### PUT
Each `GET` method has a `PUT` companion `sync` and `async` methods are generic over `std::io::Read`. `async` `stream` methods are generic over `futures::io::AsyncReadExt`, while `tokio` methods are generic over `tokio::io::AsyncReadExt`.
| `async` | [put_object](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.put_object) |
| `async` | [put_object_with_content_type](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.put_object_with_content_type) |
| `async` | [put_object_stream](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.put_object_stream) |
| `sync` | [put_object_blocking](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.put_object_blocking) |
| `sync` | [put_object_with_content_type_blocking](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.put_object_with_content_type_blocking) |
| `sync` | [put_object_stream_blocking](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.put_object_stream_blocking) |
| `tokio` | :x: [#110](https://github.com/durch/rust-s3/issues) - [tokio_put_object_stream](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.tokio_put_object_stream) |
#### List
| `async` | [list](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.list) |
| `sync` | [list_blocking](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.list_blocking) |
#### DELETE
| `async` | [delete_object](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.delete_object) |
| `sync` | [delete_object_blocking](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.delete_object_blocking) |
#### Location
| `async` | [location](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.location) |
| `sync` | [location_blocking](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.location_blocking) |
#### Tagging
| `async` | [put_object_tagging](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.put_object_tagging) |
| `sync` | [put_object_tagging_blocking](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.put_object_tagging_blocking) |
| `async` | [get_object_tagging](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.get_object_tagging) |
| `sync` | [get_object_tagging_blocking](https://docs.rs/rust-s3/s3/bucket/struct.Bucket.html#method.get_object_tagging_blocking) |
### Usage (in `Cargo.toml`)
```toml
[dependencies]
rust-s3 = "0.26.0"
```
#### Features
##### Disable SSL verification for endpoints, useful for custom regions
```toml
[dependencies]
rust-s3 = {version = "0.26.0", features = ["no-verify-ssl"]}
```
##### Fail on HTTP error responses
```toml
[dependencies]
rust-s3 = {version = "0.26.0", features = ["fail-on-err"]}
```
##### Different SSL backends
Default is `reqwest/native-tls`, it is possible to switch to `reqwest/rustls-tls` which is more portable
```toml
[dependencies]
rust-s3 = {version = "0.26.0", features = ["rustls-tls"]}
```