Struct Assets 

pub struct Assets { /* private fields */ }

Available on crate feature images only.

Request-owned association of references and images. Unused images are not sent.

Implementations

impl Assets

pub fn new() -> Self

Create an empty request-owned registry.

pub fn attach(&mut self, image: Image) -> String

Retain an image and return its stable reference. Reattaching clones is idempotent.

pub fn len(&self) -> usize

Number of attached images (including currently unused images).

pub fn is_empty(&self) -> bool

Whether the registry has no attached images.

pub fn validate( &self, state: &State, questions: &IndexMap<String, Question>, ) -> Result<()>

Validate unknown references and repeated-use byte limits before I/O.

Errors

Returns the same InvalidImage failures as Assets::references for unknown handles, size/count overflow, or excessive repeated image use.

pub fn references<'a>( &'a self, state: &State, questions: &IndexMap<String, Question>, ) -> Result<Vec<ImageReference<'a>>>

Collect referenced images in first-use order, preserving repeated-use counts.

Object keys are scanned for Python 0.12 parity. The current hosted service does not replace references inside keys; a key is not an image placement.

Errors

Returns InvalidImage for an unattached UUID-shaped image reference, reference-count/size overflow, or more than 32 MiB counting every use.

pub fn validate_service_request( &self, state: &State, questions: &IndexMap<String, Question>, ) -> Result<()>

Apply TypeSafe’s documented 2026-10-17 preflight in addition to baseline limits.

Current service sides start at 280 px and object keys are never image placements. Processed image size and server decoding cannot be proved here.

Errors

Propagates baseline reference/size errors and returns InvalidImage for referenced images with a side below 280 px or references in object keys.

Trait Implementations

impl Clone for Assets

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Assets

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

Formats the value using the given formatter.

impl Default for Assets

fn default() -> Self

Returns the “default value” for a type.