Enum JsonDecodeErrorSource 

pub enum JsonDecodeErrorSource<R, Q = usize>
where
    Q: Copy + Debug,
{
    Read {
        raw_input_bytes: usize,
        kind: ErrorKind,
        source: Option<Arc<Error>>,
    },
    Budget {
        stage: JsonDecodeStage,
        raw_input_bytes: usize,
        normalized_input_bytes: Option<usize>,
        source: MeasuredBudgetError<R, Q>,
    },
    EmptyInput {
        stage: JsonDecodeStage,
        raw_input_bytes: usize,
        normalized_input_bytes: Option<usize>,
    },
    InvalidUtf8 {
        raw_input_bytes: usize,
        valid_up_to: usize,
        error_len: Option<usize>,
        source: Option<Utf8Error>,
    },
    InvalidJson {
        raw_input_bytes: usize,
        normalized_input_bytes: Option<usize>,
        syntax: JsonSyntaxError,
        source: Option<Arc<dyn Error + Send + Sync>>,
    },
    UnexpectedTopLevel {
        raw_input_bytes: usize,
        normalized_input_bytes: Option<usize>,
        expected: JsonRootKind,
        actual: JsonRootKind,
    },
    Deserialize {
        raw_input_bytes: usize,
        normalized_input_bytes: Option<usize>,
        line: usize,
        column: usize,
        source: Option<Arc<dyn Error + Send + Sync>>,
    },
}

An owned semantic source extracted from a JSON decoding failure.

This enum contains the owned operation-level source for one failure. It lets downstream adapters move that source into their own models with one exhaustive match, without pairing super::JsonDecodeError::kind with fallible source accessors. A materialization reason is stored separately: read it with super::JsonDecodeError::materialization_error_reason before consuming the error with super::JsonDecodeError::into_source. Parser and Serde sources remain present only when decoding used super::DiagnosticPolicy::Detailed.

Type Parameters

• R - Resource identity attached to budget failures.
• Q - Quantity representation attached to budget failures.

Examples

use qubit_json::decode::{JsonDecodeErrorSource, JsonDecoder};

let mut decoder = JsonDecoder::unlimited();
let error = decoder.validate_str("{").expect_err("invalid JSON must fail");
match error.into_source() {
    JsonDecodeErrorSource::InvalidJson { syntax, .. } => {
        assert_eq!(syntax.offset(), 1);
    }
    source => panic!("unexpected decoding source: {source:?}"),
}

Variants

Read

Reading input failed before text decoding began.

Fields

raw_input_bytes: usize

Number of bytes observed as read before the failure; this is not necessarily the amount charged by every input path.

kind: ErrorKind

Stable standard I/O failure category.

source: Option<Arc<Error>>

Original error retained only under detailed diagnostics.

Budget

A resource measurement was rejected.

Fields

stage: JsonDecodeStage

Semantic stage where the measurement was rejected.

raw_input_bytes: usize

Original input length observed at the decoding boundary; not necessarily the amount charged to an input-byte budget.

normalized_input_bytes: Option<usize>

Predicted normalized target length when available; it does not prove that normalized text was allocated or rewritten.

source: MeasuredBudgetError<R, Q>

Complete measured-budget failure.

EmptyInput

Input was empty at a public boundary.

Fields

stage: JsonDecodeStage

Semantic stage where emptiness was detected.

raw_input_bytes: usize

Original input length observed at the decoding boundary.

normalized_input_bytes: Option<usize>

Predicted normalized target length when available; it does not prove that normalized text was produced.

InvalidUtf8

Raw bytes were not valid UTF-8.

Fields

raw_input_bytes: usize

Original input length observed at the decoding boundary.

valid_up_to: usize

Valid prefix length reported by UTF-8 validation.

error_len: Option<usize>

Invalid sequence length when known.

source: Option<Utf8Error>

Detailed source retained only under detailed diagnostics.

InvalidJson

Text was not one valid JSON document.

Fields

raw_input_bytes: usize

Original input length observed at the decoding boundary.

normalized_input_bytes: Option<usize>

Predicted normalized target length when available; it does not prove that normalized text was allocated or rewritten.

syntax: JsonSyntaxError

Stable scanner reason and source coordinates.

source: Option<Arc<dyn Error + Send + Sync>>

Detailed parser source retained only under detailed diagnostics.

UnexpectedTopLevel

A valid document had an unexpected top-level kind.

Fields

raw_input_bytes: usize

Original input length observed at the decoding boundary.

normalized_input_bytes: Option<usize>

Predicted normalized target length when available; it does not prove that normalized text was produced.

expected: JsonRootKind

Required top-level kind.

actual: JsonRootKind

Observed top-level kind.

Deserialize

A valid admitted document could not materialize the target type.

Fields

raw_input_bytes: usize

Original input length observed at the decoding boundary.

normalized_input_bytes: Option<usize>

Predicted normalized target length when available; it does not prove that normalized text was produced.

line: usize

One-based Serde line, or zero when unavailable.

column: usize

One-based Serde column, or zero when unavailable.

source: Option<Arc<dyn Error + Send + Sync>>

Detailed source retained only under detailed diagnostics.

Trait Implementations

impl<R: Clone, Q> Clone for JsonDecodeErrorSource<R, Q>

where Q: Copy + Debug + Clone,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R: Debug, Q> Debug for JsonDecodeErrorSource<R, Q>

where Q: Copy + Debug + Debug,

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

Formats the value using the given formatter.