Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/artemnikitin/s3-tool
CLI tool for AWS S3, written in Go
https://github.com/artemnikitin/s3-tool
Last synced: 4 days ago
JSON representation
CLI tool for AWS S3, written in Go
- Host: GitHub
- URL: https://github.com/artemnikitin/s3-tool
- Owner: artemnikitin
- License: mit
- Created: 2016-01-20T11:36:09.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T02:49:37.000Z (11 months ago)
- Last Synced: 2024-06-20T12:49:45.869Z (5 months ago)
- Language: Go
- Size: 316 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# s3-tool
[](https://goreportcard.com/report/github.com/artemnikitin/s3-tool) [](https://codebeat.co/projects/github-com-artemnikitin-s3-tool) [](https://travis-ci.org/artemnikitin/s3-tool)
CLI tool for AWS S3, written in Go. Work in progress...
##### AWS Credentials
Set environment variables
```
export AWS_ACCESS_KEY_ID=
export AWS_SECRET_ACCESS_KEY=
```
##### Install
Get it via
```
go get github.com/artemnikitin/s3-tool
```
Or you can just get binary from release.
##### Commands
Current list of supported commands:
```
presigned
download
upload
```
- ```presigned``` generate pre-signed URL for downloading file from S3.
Requires parameters:
- ```bucket``` specified bucket in S3
- ```key``` specified key in S3
Example:
```
s3tool presigned -bucket=mybucket -key=my-file.png
```
- ```download``` download file from S3.
Required parameters:
- ```bucket``` specified bucket in S3
- ```key``` specified key in S3
- ```url``` if specified, then ```s3-tool``` will try to download file be pre-signed URL ignoring other parameters
- ```path``` (optional) if specified, then file will be download to specified folder
Example:
```
s3-tool download -bucket=mybucket -key=my-file.png
s3-tool download -url=https://
```
- ```upload``` upload file(s) to S3
Required parameters:
- ```bucket``` specified bucket in S3
- ```key``` specified key in S3
- ```path``` specified path to file/folder. If specified path is folder, then folder with all it's content will be uploaded.
- ```keepRootFolder``` (optional) specified option to keep root folder from ```path``` parameter. Disabled by default.
Example:
```
s3-tool upload -bucket=mybucket -key=my-file.png -path=/path/to/my-file.png
```
```
s3-tool upload -bucket=mybucket -key=/ -path=/path/to/folder -keepRootFolder
```
##### Optional parameters
- ```region``` set S3 region, by default region will be set to ```us-east-1```
Example:
```
s3-tool -bucket=bucket-name -key=my-key -region=region-name
```
##### Run
Run it like:
```
s3-tool command -parameter=blabla ...
```
You can specify parameter ```-log``` for logging AWS requests and responses.