s3rs-0.1.17 is not a library.
s3rs
a S3 Rich Support client
- multi config
- interactive command line tool
- easy to debug with http protocol
- AWS4, AWS2 support
current status:
| function | descrrption | CEPH | AWS |
|---|---|---|---|
| la | list all objects | O | O |
| ls | list bucket | O | O |
| ls [bucket] | list objects in the bucket | O | O |
| ls s3://[bucket] | list objects in the bucket | O | O |
| mb [bucket] | create bucket | O | O |
| rb [bucket] | delete bucket | O | O |
| put [file] s3://[bucket]/[object] | upload the file sepcific object name | O | 0 |
| put [file] s3://[bucket] | upload the file use file name as objec name | O | O |
| put test s3://[bucket]/[object] | upload a test file sepcific object name | O | O |
| get s3://[bucket]/[object] file | download objec | O | O |
| get s3://[bucket]/[object] | download objec in current folder | O | O |
| cat s3://[bucket]/[object] | show the object content | O | O |
| del s3://[bucket]/[object] | delete the object | O | O |
| tag add s3://[bucket]/[object] key1=value1 [key2=value2] | add tag(s) to the object | O | O |
| tag put s3://[bucket]/[object] key1=value1 [key2=value2] | add tag(s) to the object | O | O |
| tag del s3://[bucket]/[object] | remove tag(s) from the object | O | O |
| tag rm s3://[bucket]/[object] | remove tag(s) from the object | O | O |
| /uri?query | give the orignal url | O | O |
| ---------------------------------------------------------- | --------------------------------------------- | ------ | ----- |
| s3_type [ceph/aws/aws4/aws2] | change the api for different S3 providor | ||
| log [trace/debug/info/erro] | change the log level | ||
| - trace: more detail about rust | |||
| - debug: for auth signature hash info | |||
| - Info: for Http header and body |
| s3 type | auth type | format | virtual-hosted–style path-style |
|---|---|---|---|
| ceph | aws4 | json | path-style |
| aws | aws4 | xml | virtual-hosted–style |
Build Environment
Please download and install Rust and Cargo (Rust package manager)
Clone the code
git clone https://github.com/yanganto/s3rs.git
Build
cargo build --release- The excutable binary will in
./target/release/s3rs
Install from cargo
cargo install s3rs
Demo
- A short demo video
- snapshot
