mirror of
https://github.com/ForeverPyrite/r2client.git
synced 2025-12-10 01:38:07 +00:00
f92026698c
Now that's not to say I cleaned up the source code, who knows what the heck is in there...
38 lines
1.0 KiB
Markdown
38 lines
1.0 KiB
Markdown
# r2cli
|
|
|
|
A rudimentary CLI tool for Cloudflare R2-compatible S3 storage, built on the `r2client` Rust library.
|
|
|
|
## Features
|
|
- Upload files to an R2 bucket
|
|
- Download files from an R2 bucket
|
|
- List files and folders in an R2 bucket
|
|
- Delete a file in an R2 bucket
|
|
|
|
## Usage
|
|
|
|
Set the following environment variables:
|
|
- `R2_ACCESS_KEY`
|
|
- `R2_SECRET_KEY`
|
|
- `R2_ENDPOINT`
|
|
- `R2_BUCKET`
|
|
|
|
For ease of use within development environments, environment variables will also be sourced from `.env`
|
|
|
|
### Example commands
|
|
|
|
```sh
|
|
r2cli upload <local_file> <remote_key>
|
|
r2cli download <remote_key> <local_file>
|
|
r2cli list-files
|
|
r2cli list-folders
|
|
```
|
|
|
|
## Requirements
|
|
- Rust (WOAH (I'm too lazy to build the binary and put it elsewhere))
|
|
- Valid Cloudflare R2 credentials
|
|
|
|
## Todo
|
|
- [ ] Allow multiple, parallel, file uploads under a specific key/folder
|
|
- [ ] Just more stuff like the above, download all the objects in a key/folder, ect
|
|
- [ ] If you REALLY feel goofy, a TUI would be pretty sick, however the r2client APIs would need extended quite a bit
|