Struct FlattenContext 

pub struct FlattenContext { /* private fields */ }

Context for flatten parsing - wraps AccessedSet with snapshot/rollback support.

When parsing flattened types, all levels share a single AccessedSet owned by the root parser. Child parsers add to this shared set, and only the root parser actually validates with deny_unknown_fields().

Example

// Root parser owns the accessed set
let mut rec1 = ctx.parse_record()?;  // accessed = {} (owned)
rec1.field("a");  // accessed = {a}

// Child parser shares and adds to the same set
let ctx2 = rec1.flatten();
let mut rec2 = ctx2.parse_record()?;  // shares accessed via Rc
rec2.field("b");  // accessed = {a, b}
rec2.deny_unknown_fields()?;  // NO-OP (child)

rec1.field("c");  // accessed = {a, b, c}
rec1.deny_unknown_fields()?;  // VALIDATES (root)

Implementations

impl FlattenContext

pub fn new(accessed: AccessedSet, scope: ParserScope) -> Self

Create a FlattenContext from an existing AccessedSet with the given scope.

pub fn scope(&self) -> ParserScope

Get the parser scope.

pub fn accessed_set(&self) -> &AccessedSet

Get the underlying AccessedSet (for sharing with RecordParser).

pub fn add_field(&self, field: impl Into<String>)

Add a field to the accessed set.

pub fn add_ext(&self, ext: Identifier)

Add an extension to the accessed set.

pub fn has_field(&self, field: &str) -> bool

Check if a field has been accessed.

pub fn has_ext(&self, ext: &Identifier) -> bool

Check if an extension has been accessed.

pub fn push_snapshot(&self)

Push snapshot (at start of union parsing).

pub fn restore_to_current_snapshot(&self)

Restore to current snapshot (when variant fails).

pub fn capture_current_state(&self) -> AccessedSnapshot

Capture current state (for non-priority variants).

pub fn restore_to_state(&self, state: AccessedSnapshot)

Restore to a captured state (when selecting a non-priority variant).

pub fn pop_and_restore(&self)

Pop and restore (when union fails/ambiguous).

pub fn pop_without_restore(&self)

Pop without restore (when union succeeds).

Trait Implementations

impl Clone for FlattenContext

fn clone(&self) -> FlattenContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FlattenContext

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

Formats the value using the given formatter.