Enum JsonBacktraceBuilder 

pub enum JsonBacktraceBuilder<'a, T: IntoOwned, O = <T as IntoOwned>::Owned> {
    Root,
    File(&'a Self, T),
    Item(&'a Self, JsonFragmentPathItemRef<'a>),
    Path(&'a Self, &'a JsonFragmentPathBuf),
    Backtrace(&'a Self, &'a JsonBacktrace<O>),
}

Incrementally builds a JsonBacktraceBuf as a borrow-chain stack, without allocating until Self::build is called.

Each variant borrows the previous step (&'a Self), so a complete chain lives on the stack across nested calls; use Self::build to turn it into an owned JsonBacktraceBuf.

Variants

Root

Empty backtrace with no frames.

File(&'a Self, T)

Starts a new file frame, extending the previous chain.

Item(&'a Self, JsonFragmentPathItemRef<'a>)

Pushes one navigation step onto the last file frame’s fragment path.

Path(&'a Self, &'a JsonFragmentPathBuf)

Pushes every segment of a path onto the last file frame’s fragment path, in a single step.

Backtrace(&'a Self, &'a JsonBacktrace<O>)

Appends the frames of a previously-built backtrace onto the chain.

Implementations

impl<T: IntoOwned> JsonBacktraceBuilder<'_, T>

pub fn new() -> &'static Self

Creates an empty stack with no items.

pub fn file<'a>(&'a self, file: T) -> JsonBacktraceBuilder<'a, T>

Starts a new file frame, extending this chain.

pub fn push<'a>( &'a self, item: JsonFragmentPathItemRef<'a>, ) -> JsonBacktraceBuilder<'a, T>

Pushes a single navigation step onto this chain.

pub fn push_path<'a>( &'a self, path: &'a JsonFragmentPathBuf, ) -> JsonBacktraceBuilder<'a, T>

Pushes every segment of path, in order, in a single step.

Equivalent to calling Self::push once per segment of path, but without building an intermediate chain node for each one.

pub fn push_backtrace<'a>( &'a self, backtrace: &'a JsonBacktrace<T::Owned>, ) -> JsonBacktraceBuilder<'a, T>

Appends the frames of a previously-built backtrace onto this chain, in a single step.

Useful to “jump back” to a location recorded earlier (e.g. where a value was originally defined), while still preserving how the current chain got there.

pub fn array_index(&self, index: usize) -> JsonBacktraceBuilder<'_, T>

Push a navigation step to the index-th element of an array.

pub fn object_entry<'b>( &'b self, key: impl Into<&'b str>, ) -> JsonBacktraceBuilder<'b, T>

Push a navigation step to the whole entry (key + value) for the first occurrence of key.

Equivalent to object_entry_at(key, 0). For objects with duplicate keys, use object_entry_at to specify the occurrence index.

pub fn object_entry_at<'b>( &'b self, key: impl Into<&'b str>, occurrence: usize, ) -> JsonBacktraceBuilder<'b, T>

Push a navigation step to the whole entry (key + value) for the occurrence-th occurrence of key.

0 selects the first occurrence, 1 the second, etc.

pub fn object_key<'b>( &'b self, key: impl Into<&'b str>, ) -> JsonBacktraceBuilder<'b, T>

Push a navigation step to the key string of the first occurrence of key.

Equivalent to object_key_at(key, 0). For objects with duplicate keys, use object_key_at to specify the occurrence index.

pub fn object_key_at<'b>( &'b self, key: impl Into<&'b str>, occurrence: usize, ) -> JsonBacktraceBuilder<'b, T>

Push a navigation step to the key string of the occurrence-th occurrence of key.

0 selects the first occurrence, 1 the second, etc.

pub fn object_value<'b>( &'b self, key: impl Into<&'b str>, ) -> JsonBacktraceBuilder<'b, T>

Push a navigation step to the value of the first occurrence of key.

Equivalent to object_value_at(key, 0). For objects with duplicate keys, use object_value_at to specify the occurrence index.

pub fn object_value_at<'b>( &'b self, key: impl Into<&'b str>, occurrence: usize, ) -> JsonBacktraceBuilder<'b, T>

Push a navigation step to the value of the occurrence-th occurrence of key.

0 selects the first occurrence, 1 the second, etc.

pub fn build(self) -> JsonBacktraceBuf<T::Owned>

where T: Clone, T::Owned: Clone,

Consumes this chain and produces the equivalent owned JsonBacktraceBuf.

Trait Implementations

impl<T: IntoOwned + Clone> Clone for JsonBacktraceBuilder<'_, T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: IntoOwned + Copy> Copy for JsonBacktraceBuilder<'_, T>

impl<'a, T: Debug + IntoOwned, O: Debug> Debug for JsonBacktraceBuilder<'a, T, O>

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

Formats the value using the given formatter.

impl<T: Clone + IntoOwned> From<JsonBacktraceBuilder<'_, T>> for JsonBacktraceBuf<T::Owned>

where T::Owned: Clone,

fn from(value: JsonBacktraceBuilder<'_, T>) -> Self

Converts to this type from the input type.