Skip to main content

Crate smallpict

Crate smallpict 

Source
Expand description

§SmallPict Rust SDK

Official Rust client library for the SmallPict Image Optimization API — next-gen image transcoding (AVIF, WebP), smart compression, Edge CDN delivery, and cache purging.

§Quick Start (Async)

use smallpict::{Client, ImageFormat, OptimizeOptions};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::builder()
        .api_key(std::env::var("SMALLPICT_API_KEY")?)
        .secret_key(std::env::var("SMALLPICT_SECRET_KEY")?)
        .build()?;
    let image_data = std::fs::read("hero.png")?;

    let options = OptimizeOptions::builder()
        .format(ImageFormat::Avif)
        .quality(80)
        .max_width(1920)
        .build();

    let result = client.optimize(&image_data, Some(options)).await?;
    println!("CDN URL: {}", result.url);
    println!("Saved: {:.2}% ({} bytes)", result.savings_percentage, result.bytes_saved);
    Ok(())
}

§Quick Start (Blocking)

Enable the blocking feature in Cargo.toml:

[dependencies]
smallpict = { version = "0.1", features = ["blocking"] }
#[cfg(feature = "blocking")]
{
    use smallpict::blocking::BlockingClient;
    use smallpict::models::{ImageFormat, OptimizeOptions};

    let client = BlockingClient::builder()
        .api_key(std::env::var("SMALLPICT_API_KEY")?)
        .secret_key(std::env::var("SMALLPICT_SECRET_KEY")?)
        .build()?;
    let image_data = std::fs::read("hero.png")?;
    let result = client.optimize(&image_data, None)?;
    println!("CDN URL: {}", result.url);
}

Re-exports§

pub use errors::sanitize_message;
pub use errors::SecretRedacted;
pub use errors::SmallPictError;
pub use models::BoosterExpiry;
pub use models::Capacity;
pub use models::CapacityBooster;
pub use models::CapacityCdn;
pub use models::CapacityLapse;
pub use models::CapacityStorage;
pub use models::CompressionMode;
pub use models::FallbackMode;
pub use models::FitMode;
pub use models::ImageFormat;
pub use models::JobStatusResult;
pub use models::OptimizeOptions;
pub use models::OptimizeOptionsBuilder;
pub use models::OptimizeResult;
pub use models::PurgeResponse;
pub use models::PurgeType;
pub use models::QuotaResponse;
pub use client::Client;
pub use client::ClientBuilder;

Modules§

client
crypto
errors
models