#object-storage #cloud-storage #storage-api #cloudflare #file-upload #s3 #storage-service

cloudflare-r2-rs

A package which provides dead simple APIs to work with Cloudflare R2 and OVH Object Storage

12 releases (5 breaking)

new 0.6.7 Nov 6, 2024
0.6.5 Sep 6, 2024
0.6.2 Jul 7, 2024
0.1.0 Mar 13, 2024

#728 in Network programming

Download history 77/week @ 2024-07-17 142/week @ 2024-07-24 24/week @ 2024-07-31 3/week @ 2024-08-07 10/week @ 2024-08-14 135/week @ 2024-08-21 127/week @ 2024-08-28 275/week @ 2024-09-04 71/week @ 2024-09-11 66/week @ 2024-09-18 138/week @ 2024-09-25 242/week @ 2024-10-02 181/week @ 2024-10-09 164/week @ 2024-10-16 50/week @ 2024-10-23 16/week @ 2024-10-30

508 downloads per month

Apache-2.0

16KB
183 lines

Easy to use Rust API for Cloudflare's R2 service

Simple Rust API for Cloudflare's R2 and OVH Object Storage (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.

cargo.toml

[dependencies]
cloudflare-r2-rs = "0.6.7"

example use


//Cloudflare
let r2_manager = R2Manager::new(
    //Bucket Name
    "my-bucket", 
    //Cloudflare URI endpoint
    "https://some-id-55353-53535.r2.cloudflarestorage.com",
    //API Token's Access Key ID
    "some-id-55353-53535",
    //API Token's Secret Access Key
    "some-long-secret-key-55353-53535-55353-53535"
).await;

//OVH
let _r2_manager2 = R2Manager::new_with_region(
    "bucket-name", 
    "https://s3.<region>.io.cloud.ovh.net",
    "some-id-55353-53535",
    "some-secret-55353-53535",
    "<region>").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());

Dependencies

~32MB
~404K SLoC