#AWS #S3 #Wasabi #Minio #Yandex

bin+lib rust-s3

Tiny Rust library for working with Amazon S3 and compatible object storage APIs. WASM compatible

74 releases (21 breaking)

0.23.0-beta3 Jul 15, 2020
0.22.12 Jul 11, 2020
0.20.0 Mar 28, 2020
0.19.0-alpha.1 Dec 10, 2019
0.2.3 Jul 8, 2016

#8 in WebAssembly

Download history 1902/week @ 2020-04-13 2426/week @ 2020-04-20 1710/week @ 2020-04-27 1828/week @ 2020-05-04 1883/week @ 2020-05-11 1669/week @ 2020-05-18 1898/week @ 2020-05-25 2332/week @ 2020-06-01 2276/week @ 2020-06-08 2576/week @ 2020-06-15 2417/week @ 2020-06-22 1793/week @ 2020-06-29 2135/week @ 2020-07-06 1635/week @ 2020-07-13 1719/week @ 2020-07-20 1096/week @ 2020-07-27

8,688 downloads per month
Used in 5 crates

MIT license

2.5K SLoC

build MIT licensed

rust-s3 [docs]

Rust library for working with Amazon S3 or arbitrary S3 compatible APIs, fully compatible with async/await and futures ^0.3. Blocking familiy of methods is also compatible with wasm.

Support further development

  • BTC - 3QQdtQGSMStTWEBhe65hPiAWJekXH8n26o
  • ETH - 0x369Fd06ACc25CCfE0A28BE40018cF3aC38AcdcB6


Modest interface towards Amazon S3, as well as S3 compatible object storage APIs such as Wasabi, Yandex or Minio. 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

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.


sync and async features are enabled by default. In case you require a different set of features you are probably better off passing in default-features = false, see below. Both sync and async use native-tls as their TLS backend, there are rustls-tls alternative backends available for both of them. rustls-tls features are functionally compatible to their native-tls counterparts, and can be toggled individually or together with the rustls feature. wasm feature is sugar for [sync-rustls]. Useful feature combinations are listed at the bottom of this doc.


sync, wasm presign_put
sync, wasm presign_get


There are a few different options for getting an object. async and sync methods are generic over std::io::Write, while tokio methods are generic over tokio::io::AsyncWriteExt.

async get_object
async get_object_stream
sync, wasm get_object_blocking
sync, wasm get_object_stream_blocking
async tokio_get_object_stream


Each GET method has a PUT companion sync and async methods are generic over std::io::Read, while tokio methods are generic over tokio::io::AsyncReadExt.

async put_object
async put_object_stream
sync, wasm put_object_blocking
sync, wasm put_object_stream_blocking
async tokio_put_object_stream


async list
sync, wasm list_blocking


async delete_object
sync, wasm delete_object_blocking


async location
sync, wasm location_blocking


async put_object_tagging
sync, wasm put_object_tagging_blocking
async get_object_tagging
sync, wasm get_object_tagging_blocking

Usage (in Cargo.toml)

rust-s3 = "0.23"


Disable SSL verification for endpoints, useful for custom regions
# Only available for `async` feature, as `rustls-tls` does not support dangereous features ATM
rust-s3 = {version = "0.23", features = ["async", "no-verify-ssl"], default-features = false}
Fail on HTTP error responses
rust-s3 = {version = "0.23", features = ["fail-on-err"]}
Different SSL backends

Default is native-tls, it is possible to switch to rustls-tls which is more portable

rust-s3 = {version = "0.23", features = ["rustls"], default-features = false}
rust-s3 = {version = "0.23", features = ["wasm"], default-features = false}


~275K SLoC