| Crates.io | cloudflare-r2-rs |
| lib.rs | cloudflare-r2-rs |
| version | 0.7.0 |
| created_at | 2024-03-13 21:29:03.66053+00 |
| updated_at | 2026-01-11 14:42:10.438187+00 |
| description | A package which provides dead simple APIs to work with Cloudflare R2, OVH Object Storage and AWS S3. |
| homepage | |
| repository | https://github.com/milen-denev/cloudflare-r2-rs |
| max_upload_size | |
| id | 1172494 |
| size | 73,734 |
Simple Rust API for Cloudflare's R2, OVH Object Storage and AWS S3 (possibly others as well but not tested) with create_bucket, delete_bucket and upload, get, delete file operations. Production ready since it's a thin layer above AWS SDK S3. Updated to be using latest versions.
[dependencies]
cloudflare-r2-rs = "0.7.0"
use cloudflare_r2_rs::r2::{R2Endpoint, R2Manager};
//Cloudflare
let r2_manager = R2Manager::new(
//Bucket Name
"bucket-name",
//Cloudflare URI endpoint
R2Endpoint::Http("https://some-id-55353-53535.r2.cloudflarestorage.com".to_string()),
//API Token's Access Key ID
"some-id-55353-53535",
//API Token's Secret Access Key
"some-long-secret-key-55353-53535-55353-53535",
//Region (None defaults to "us-east-1")
None
).await;
//OVH
let _ovh_manager = R2Manager::new(
"bucket-name",
R2Endpoint::Http("https://s3.<region>.io.cloud.ovh.net".to_string()),
"some-id-55353-53535",
"some-secret-55353-53535",
Some("<region>".to_string())
).await;
//AWS-style endpoint built from bucket + region
let _aws_style = R2Manager::new(
"bucket-name",
R2Endpoint::Bucket,
"iam-access-key-id",
"iam-secret-access-key",
Some("<region>".to_string())
).await;
//Gives control to set Cache-Control header and Content-Type header
r2_manager.upload("test", b"Hello world", Some("max-age=60"), Some("text/plain")).await;
let bytes = r2_manager.get("test").await.unwrap();
println!("{}", String::from_utf8(bytes).unwrap());