s3utils

S3 Utils

Go library and CLI tools for interacting with S3-compatible object storage (MinIO, AWS S3, etc.).

Installation

go get github.com/bborbe/s3-utils

Library Usage

import s3utils "github.com/bborbe/s3-utils"

client := s3utils.CreateS3Client(
    s3utils.URL("http://localhost:9000"),
    s3utils.AccessKey("myaccesskey"),
    s3utils.SecretKey("mysecretkey"),
)

CLI Commands

All commands share these common environment variables / flags:

download

Downloads an object from S3 to stdout.

S3_URL=http://localhost:9000 \
S3_ACCESS_KEY=access \
S3_SECRET_KEY=secret \
BUCKET=mybucket \
KEY=myfile.txt \
./download > myfile.txt

upload

Uploads stdin to an S3 object.

cat myfile.txt | \
S3_URL=http://localhost:9000 \
S3_ACCESS_KEY=access \
S3_SECRET_KEY=secret \
BUCKET=mybucket \
KEY=myfile.txt \
./upload

list-buckets

Lists all buckets.

S3_URL=http://localhost:9000 \
S3_ACCESS_KEY=access \
S3_SECRET_KEY=secret \
./list-buckets

list-objects

Lists all objects in a bucket.

S3_URL=http://localhost:9000 \
S3_ACCESS_KEY=access \
S3_SECRET_KEY=secret \
BUCKET=mybucket \
./list-objects

Development

make test        # run tests
make precommit   # format, vet, lint, test

License

BSD-2-Clause — see LICENSE