![Latest Version] ![Documentation] ![License]

High level synchronous AWS S3 Rust client library.

This client wraps Rusoto S3 and provides the following features:

• check if bucket or object exists,
• list objects that match prefix as iterator that handles pagination transparently,
• put large objects via multipart API and follow upload progress via a callback,
• delete single or multiple objects via bulk delete API,
• deffer execution using ensure crate for putting and deleting objects.

Example usage

```rust use s3_sync::{S3, Region, ObjectBodyMeta, BucketKey, Bucket}; use std::io::Cursor; use std::io::Read;

let testbucket = std::env::var("S3TESTBUCKET").expect("S3TESTBUCKET not set"); let testkey = "foobar.test";

let s3 = S3::default();

let bucket = s3.checkbucketexists(Bucket::fromname(testbucket)).expect("check if bucket exists") .left().expect("existing bucket"); let bucketkey = BucketKey::fromkey(&bucket, test_key);

let body = Cursor::new(b"hello world".tovec()); let object = s3.putobject(bucket_key, body, ObjectBodyMeta::default()).unwrap();

let mut body = Vec::new(); s3.getbody(&object).expect("object body").readto_end(&mut body).unwrap();

assert_eq!(&body, b"hello world"); ```