brigand / rust-s3 Goto Github PK

rust-s3 [docs]

Tiny Rust library for working with Amazon S3 or arbitrary S3 compatible APIs, fully compatible with async usage

Intro

Modest interface towards Amazon S3, as well as S3 compatible APIs. Supports put, get, list, and delete, operations on tags and location.

Supports streaming S3 contents, generic over T: Write as of 0.15.0.

0.19.0 will be promoted to master as dependencies mature. It will bring a slew of breaking changes including futures 0.3 and async/.await support. 0.19.0 is a possible candidate for stabilization to 1.0.0 eventually. Alpha version of 0.19.0 is available at crates.io.

What is cool -> Broken and tracked at #54

The main cool feature is that put commands return a presigned link to the file you uploaded This means you can upload to s3, and give the link to select people without having to worry about publicly accessible files on S3.

Configuration

Getter and setter functions exist for all Link params... You don't really have to touch anything there, maybe amz-expire, it is configured for one week which is the maximum Amazon allows ATM.

Usage

In your Cargo.toml

[dependencies]
rust-s3 = "0.18.6"

Disable SSL verification for endpoints, useful for custom regions

[dependencies]
rust-s3 = {version = "0.18.6", features = ["no-verify-ssl"]}

Example

• Simple S3 CRUD