Struct VariantHandle 

pub struct VariantHandle { /* private fields */ }

Handle for a named, lazily-generated image variant.

Created by Blob::variant; call VariantHandle::url to generate the variant on first access and obtain a presigned serving URL.

Implementations

impl VariantHandle

pub fn key(&self) -> &str

The content-addressed key under which this variant is stored.

pub fn name(&self) -> &str

The human-readable label for this variant (does not affect caching).

pub fn transforms(&self) -> &[Transform]

The transforms applied to the source image.

pub async fn url( &self, store: &dyn BlobStore, budget: &VariantBudget, expires_in: Duration, ) -> Result<String, VariantError>

Ensure the variant is generated, then return a presigned serving URL.

On the first call the source image is fetched, transformed, and persisted under the content-addressed key. Subsequent calls skip generation (head cache hit) and call BlobStore::presigned_url directly.

The returned URL is identical in form to any other presigned URL from the backend: a route-served HMAC-signed URL for the Local backend and a real S3 presigned URL for S3 backends.

Errors

Returns VariantError when the source MIME type is unsupported, the source exceeds the budget, decoding fails, or a storage operation fails.

pub async fn ensure_generated( &self, store: &dyn BlobStore, budget: &VariantBudget, ) -> Result<Blob, VariantError>

Ensure the variant blob exists in the store, returning its handle.

Idempotent: if the variant is already cached this is a single head call with no image processing.

Errors

Returns VariantError on generation or storage failure.

Trait Implementations

impl Clone for VariantHandle

fn clone(&self) -> VariantHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for VariantHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.