Struct TomlParser 

pub struct TomlParser<'de> { /* private fields */ }

Streaming TOML parser backed by toml_parser.

This parser translates TOML’s event stream into the ParseEvent format expected by facet-format’s deserializer.

Implementations

impl<'de> TomlParser<'de>

pub fn new(input: &'de str) -> Result<Self, TomlError>

Create a new TOML parser from a string slice.

pub const fn input(&self) -> &'de str

Get the original input string.

Trait Implementations

impl<'de> FormatParser<'de> for TomlParser<'de>

type Error = TomlError

Parser-specific error type.

type Probe<'a> = TomlProbe<'de> where Self: 'a

Evidence cursor type produced by FormatParser::begin_probe.

fn next_event(&mut self) -> Result<Option<ParseEvent<'de>>, Self::Error>

Read the next parse event, or None if the input is exhausted.

fn peek_event(&mut self) -> Result<Option<ParseEvent<'de>>, Self::Error>

Peek at the next event without consuming it, or None if at EOF.

fn skip_value(&mut self) -> Result<(), Self::Error>

Skip the current value (for unknown fields, etc.).

fn begin_probe(&mut self) -> Result<Self::Probe<'_>, Self::Error>

Begin evidence collection for untagged-enum resolution.

fn capture_raw(&mut self) -> Result<Option<&'de str>, Self::Error>

Capture the raw representation of the current value without parsing it.

fn current_span(&self) -> Option<Span>

Returns the source span of the most recently consumed event.

fn raw_capture_shape(&self) -> Option<&'static Shape>

Returns the shape of the format’s raw capture type (e.g., RawJson::SHAPE).

fn is_self_describing(&self) -> bool

Returns true if this format is self-describing.

fn hint_struct_fields(&mut self, _num_fields: usize)

Hint to the parser that a struct with the given number of fields is expected.

fn hint_scalar_type(&mut self, _hint: ScalarTypeHint)

Hint to the parser what scalar type is expected next.

fn hint_sequence(&mut self)

Hint to the parser that a sequence (array/Vec) is expected.

fn hint_byte_sequence(&mut self) -> bool

Hint to the parser that a byte sequence (Vec<u8>, &[u8], etc.) is expected.

fn hint_array(&mut self, _len: usize)

Hint to the parser that a fixed-size array is expected.

fn hint_option(&mut self)

Hint to the parser that an Option<T> is expected.

fn hint_map(&mut self)

Hint to the parser that a map is expected.

fn hint_dynamic_value(&mut self)

Hint to the parser that a dynamic value is expected.

fn hint_enum(&mut self, _variants: &[EnumVariantHint])

Hint to the parser that an enum is expected, providing variant information.

fn hint_opaque_scalar( &mut self, _type_identifier: &'static str, _shape: &'static Shape, ) -> bool

Hint to the parser that an opaque scalar type is expected.

fn format_namespace(&self) -> Option<&'static str>

Returns the format namespace for format-specific proxy resolution.