Expand description
This is a Rust client library for the Backblaze B2 cloud storage service. It provides a convenient interface for interacting with the B2 API. Relies on Tokio async runtime.
The crate provides a simple client B2SimpleClient that is just a mapping with b2 requests, and a normal client B2Client that provides helpful utilities
and auto re-auth to make life easier, you can access its inner basic client, currently only file uploads with create_upload.
The crate is still a work in progress, so expect breaking changes between 0.0.X versions.
§Features
- Auto re-auth with Backblaze B2.
- Easy file upload handler.
- Mapped all b2 storage request in simple client.
§Installation
Add the following dependency to your project using the cargo add command:
cargo add backblaze-b2-client§Usage
§File Upload
use backblaze_b2_client::B2Client;
use tokio::fs::File;
#[tokio::main]
fn main() {
let client = B2Client::new("your_account_id", "your_application_key");
let file = File::open("path_to_file").await.unwrap();
let metadata = open_file.metadata().await.unwrap();
let upload = client.create_upload(
file,
"file_name".into(),
"bucket_id".into(),
None,
metadata.len(),
None,
).await;
let file_handle_copy = file_handle.clone();
tokio::spawn(async move {
let file_handle = file_handle_copy.clone();
// Logs progress to console every half a second
while !file_handle.has_stopped() {
println!(
"status: {:?}, stats: {:.2}",
file_handle.status(),
file_handle.stats().current_stats()
);
sleep(Duration::from_millis(500)).await;
}
});
// Starts the file upload and waits for it to finish
let file = upload.start().await.unwrap();
println!("{:#?}", file);
}Re-exports§
pub use reqwest;