Errors

Every fallible call returns uform::Result, whose Error carries a Status and a static message, so nothing allocates on the failure path. A failure the binding catches before the call crosses the boundary reports the status the library would have used.

match model.on(&executor).text_encode(&texts, Outputs::EMBEDDINGS, Scalar::F32, &mut arena) {
    Ok(encoded) => println!("{} items", encoded.embeddings.map_or(0, |rows| rows.count())),
    Err(Error { status: Status::Contended, .. }) => println!("the arena serves another call"),
    Err(error) => println!("{}: {}", error.status, error.message),
}

Status carries the C enumerators’ values and leaves success to Result, so an Error never carries Status::Deferred, which only Deferred::status reports. Status, Scalar, Mood, CPUClass, GPUClass, Modality, Objective and Negatives print through Display and parse through FromStr the names the C tables own, such as "shape-mismatch" or "intel-haswell", and MultimemTier prints its own, which C never reads back. A panic inside a progress handler is caught at the C frame, since unwinding out of one is an abort, and resurfaces once the call is final.