durch/ rust-s3
About the developer
163 Stars 
68 Forks 
MIT License 
332 Commits 
9 Opened issues 
Description
Rust library for interfacing with AWS S3 and other API compatible services
Services available
Contributors list
<!-- 
-->
rust-s3 [docs]
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
tagsand
location, well as
head.
Additionally a dedicated
presign_get
Bucketmethod 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
PUTpresigned 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
Bucketstruct provides constructors for
path-stylepaths,
subdomainstyle is the default.
Bucketexposes methods for configuring and accessing
path-styleconfiguration.
Buckets
| | | |----------|-----------------------------------------------------------------------------| |
create| async | |
delete| async |
Presign
| | | |-------|----------------------------------------------------------------------------------------| |
PUT| presign_put | |
GET| presign_get |
GET
There are a few different options for getting an object.
syncand
asyncmethods are generic over
std::io::Write, while
tokiomethods are generic over
tokio::io::AsyncWriteExt.
| | | |---------|----------------------------------------------------------------------------------------------------| |
async| get_object | |
async| getobjectstream |
PUT
Each
GETmethod has a
PUTcompanion
syncand
asyncmethods are generic over
std::io::Read.
async
streammethods are generic over
futures::io::AsyncReadExt, while
tokiomethods are generic over
tokio::io::AsyncReadExt.
| | | |---------|--------------------------------------------------------------------------------------------------------------------------| |
async| put_object | |
async| putobjectwithcontenttype | |
async| putobjectstream |
List
| | | |---------|--------------------------------------------------------------------------| |
async| list |
DELETE
| | | |---------|--------------------------------------------------------------------------------------------| |
async| delete_object |
Location
| | | |---------|----------------------------------------------------------------------------------| |
async| location |
Tagging
| | | |---------|------------------------------------------------------------------------------------------------------| |
async| putobjecttagging | |
async| getobjecttagging |
Head
| | | |---------|----------------------------------------------------------------------------------------| |
async| head_object |
Usage (in Cargo.toml
)
[dependencies] rust-s3 = "0.27"
Features
Disable SSL verification for endpoints, useful for custom regions
[dependencies]
rust-s3 = {version = "0.26.0", features = ["no-verify-ssl"]}
Fail on HTTP error responses
[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-tlswhich is more portable
[dependencies]
rust-s3 = {version = "0.26.0", features = ["rustls-tls"]}