[![Latest Version]][crates.io] ![License]

# S3 Object Remover

Bulk remove object from S3.
Optionally create backup as a tar archive.

Features:

* Takes a list of keys to remove form a bucket on standard input.
* Optionally generates tar archive backup to standard output.
* Bulk deletes objects using AWS bulk delete API.

# Example usage

Note: You need to set up AWS credentials and default region using `~/.aws/credentials` and `~/.aws/config` files or use environment variables (`AWS_DEFAULT_REGION`, `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`) or use instance profile (on EC2). Consult AWS documentation for details. Additionally options `--aws-region` and `--aws-region-endpoint` can be specified on the command line.

```sh
cat object.list | s3rm --verbose --backup mybucket > backup.tar
```

# Installation

With Rust already installed on you system.

```sh
cargo install s3rm
```

[crates.io]: https://crates.io/crates/s3rm
[Latest Version]: https://img.shields.io/crates/v/s3rm.svg
[License]: https://img.shields.io/crates/l/s3rm.svg