foreverpyrite/r2client
1
0
Fork 0
mirror of https://github.com/ForeverPyrite/r2client.git synced 2025-12-10 01:38:07 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
d73cc39585fb36536fd29dfc7b5bb18086643883
r2client/r2cli/README.md
ForeverPyrite f92026698c Made this whole thing somewhat publicly presentable. 
Now that's not to say I cleaned up the source code, who knows what the
heck is in there...
2025-09-19 23:31:53 -04:00

1.0 KiB
Raw Blame History

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

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