Cerberus

Cerberus is an interactive CLI tool for S3 Object Storage. It is named after the multi-headed dog that guarded the gates of the underworld in Greek mythology.

📚 Prerequisites

Googles' Go language installed to enable building executables from source code.

🏭 Function

Cerberus creates an S3 client to facilitate the interaction with object store buckets and objects.

📂 Project Structure

Inside of your Cerberus project, you'll see the following files:

.
├── .gitignore
├── go.mod
├── go.sum
├── LICENSE.md
├── main.go
├── README.md
├── tasks.go
├── tools.go

🚧 Build

From the root folder containing main.go:

go build -o cerberus .

🎏 Available Flags

Command	Action
-help	Display help information
-list	List all buckets
-create	Create new S3 bucket(s)
-dbkt	Delete S3 bucket(s)
-dobj	Delete s3 object(s)
-get	Download s3 object(s)
-put	Upload S3 object(s)
-large	Upload large S3 object(s)

🏃 Run

cerberus -put [BUCKET-NAME] [SOURCE] [DESTINATION]

🎭 Example

cerberus -put my-bucket ~/Pictures/image.jpg photos/2024/image.jpg

🎫 License

Code is distributed under The Unlicense and is part of the Public Domain.