cyberdrop-client 0.6.0

Async Rust client for a focused subset of the Cyberdrop API.

It wraps the browser-facing Cyberdrop endpoints with typed models, explicit errors, and a small reqwest-based async surface suitable for CLI tools and simple services.

Features

• Login, register, and token verification.
• Authenticated album listing, creation, metadata edits, and file listing.
• Single-file uploads with automatic upload-node discovery.
• Streaming uploads for smaller files and chunked uploads for larger files.
• Optional upload progress callback.
• Typed error model for auth failures, missing tokens, missing fields, API errors, I/O errors, and HTTP transport failures.

Installation

[dependencies]
cyberdrop-client = "0.5"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

Quick Start

use cyberdrop_client::CyberdropClient;
use std::path::Path;

#[tokio::main]
async fn main() -> Result<(), cyberdrop_client::CyberdropError> {
    let client = CyberdropClient::new()?;
    let token = client.login("username", "password").await?;

    let client = client.with_auth_token(token.into_string());

    let album_id = client
        .create_album("uploads from rust", Some("created by cyberdrop-client"))
        .await?;

    let uploaded = client
        .upload_file(Path::new("image.jpg"), Some(album_id))
        .await?;

    println!("uploaded {} -> {}", uploaded.name, uploaded.url);
    Ok(())
}

Client Setup

Use CyberdropClient::new() for defaults, or CyberdropClient::new_with_token(...) when you already have a token.

use cyberdrop_client::CyberdropClient;

let client = CyberdropClient::new_with_token("existing-token")?;

Authenticated requests use Cyberdrop's token header, not Authorization: Bearer.

Common Tasks

Verify a token

let verification = client.verify_token("token-to-check").await?;
println!("{}: {}", verification.username, verification.success);

List albums and files

let albums = client.list_albums().await?;

for album in albums {
    let files = client.list_album_files(album.id).await?;
    println!("{} has {} files", album.name, files.count);
}

Edit an album

let album = client.get_album_by_id(album_id).await?;

let edited = client
    .edit_album(
        album.id,
        "new name",
        album.description,
        album.download,
        album.public,
        false,
    )
    .await?;

Pass true as the last argument to request a new public link identifier.

Track upload progress

let uploaded = client
    .upload_file_with_progress("video.mp4", Some(album_id), |progress| {
        println!(
            "{}: {}/{} bytes",
            progress.file_name, progress.bytes_sent, progress.total_bytes
        );
    })
    .await?;

API Surface

Error Model

Higher-level methods convert non-success HTTP responses into CyberdropError:

• 401 and 403 become AuthenticationFailed.
• Other non-2xx statuses become RequestFailed.
• API-level failures become Api.
• Missing required response fields become MissingField.
• File reads become Io.
• Network, TLS, DNS, timeout, and response decode failures become Http.

Development

cargo fmt
cargo check --all-features --all-targets
cargo test

Live tests are feature-gated because they create real Cyberdrop accounts, albums, and uploads:

cargo test --features live-tests