s3rs 0.1.12

A s3 cli client with multi configs with diffent provider
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

**This project is moved to gitlab** [gitlab repo link](https://gitlab.com/yanganto/s3rs)

s3rs 
---
a **S3** **R**ich **S**upport client
- multi config
- interactive command line tool
- 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    | X   |
| rb [bucket]                       | delete bucket                               | O    | X   |
| 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   |
| /uri?query                        | give the orignal url                        | O    | ?   |
|-----------------------------------|---------------------------------------------|------|-----|
| s3\_type [ceph/aws/aws4/aws2]     | change the api for different S3 providor    |      |     |
| log [trace/debug/info/erro]       | change the log level                        |      |     |
|                                   | - 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)
- [Install Rust](https://www.rust-lang.org/en-US/install.html)
- [Install Cargo](https://crates.io/)

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](https://youtu.be/DnWQbDmBFpg)