Enum DitError 

pub enum DitError {
    Io {
        path: String,
        source: Error,
    },
    Gguf(BonsaiError),
    WrongArchitecture {
        found: String,
        expected: String,
    },
    MissingMetadata {
        key: String,
    },
    InvalidMetadata {
        key: String,
        reason: String,
    },
    WrongTensorType {
        name: String,
        found: String,
        expected: String,
    },
    WrongRank {
        name: String,
        found: usize,
        expected: usize,
    },
    Shape(String),
    Kernel(String),
}

Errors that can occur while loading or interrogating a FLUX.2 DiT (bonsai-image) GGUF file.

Variants

Io

An underlying I/O error while opening or mapping the GGUF file.

Fields

path: String

Path that triggered the error.

source: Error

Underlying I/O error.

Gguf(BonsaiError)

An error from the OxiBonsai core GGUF reader (parse, missing tensor, unsupported quant type, byte-slice validation, …).

WrongArchitecture

The file’s general.architecture is not "bonsai-image".

Fields

found: String

Architecture string actually found in the GGUF metadata.

expected: String

Architecture string that was expected.

MissingMetadata

A required bonsai-image.* metadata key was missing.

Fields

key: String

The metadata key that was missing.

InvalidMetadata

A metadata value had an unexpected type or shape.

Fields

key: String

The metadata key whose value was invalid.

reason: String

Human-readable reason the value was rejected.

WrongTensorType

A tensor was found but its stored GGUF type did not match the storage convention for its name space (quantized → TQ2_0_g128, plain → BF16).

Fields

name: String

Tensor name.

found: String

GGUF type actually found.

expected: String

GGUF type that was expected.

WrongRank

A tensor’s stored dimensionality was unexpected (e.g. a quantized linear that was not 2-D).

Fields

name: String

Tensor name.

found: usize

Number of dimensions actually found.

expected: usize

Number of dimensions that was expected.

Shape(String)

A forward-pass shape invariant was violated (e.g. a weight whose (out, in) did not match the expected feature widths).

Kernel(String)

An error from the OxiBonsai kernels crate (e.g. the ternary GEMM rejecting an unaligned contraction dimension).

Trait Implementations

impl Debug for DitError

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

Formats the value using the given formatter.

impl Display for DitError

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

Formats the value using the given formatter.

impl Error for DitError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<BonsaiError> for DitError

fn from(source: BonsaiError) -> Self

Converts to this type from the input type.

impl From<DitError> for PipelineError

fn from(source: DitError) -> Self

Converts to this type from the input type.

impl From<KernelError> for DitError

fn from(source: KernelError) -> Self

Converts to this type from the input type.