Struct DocumentConstructor 

pub struct DocumentConstructor { /* private fields */ }

Implementations

impl DocumentConstructor

pub fn new() -> Self

pub fn current_node_id(&self) -> NodeId

pub fn current_node(&self) -> &Node

pub fn current_node_mut(&mut self) -> &mut Node

pub fn current_path(&self) -> &[PathSegment]

pub fn document(&self) -> &EureDocument

pub fn document_mut(&mut self) -> &mut EureDocument

pub fn finish(self) -> EureDocument

impl DocumentConstructor

pub fn begin_scope(&mut self) -> Scope

Begin a new scope. Returns a scope handle that must be passed to end_scope. Scopes must be ended in LIFO order (most recent first).

pub fn end_scope(&mut self, scope: Scope) -> Result<(), ScopeError>

End a scope, restoring the constructor to the state when the scope was created. Returns an error if the scope is not the most recent outstanding scope.

pub fn navigate(&mut self, segment: PathSegment) -> Result<NodeId, InsertError>

Navigate to a child node by path segment. Creates the node if it doesn’t exist.

pub fn require_hole(&self) -> Result<(), InsertError>

Validate that the current node is a Hole (unbound). Use this before binding a value to ensure the node hasn’t already been assigned.

pub fn bind_hole( &mut self, label: Option<Identifier>, ) -> Result<(), InsertError>

Bind a hole (optionally labeled) to the current node.

pub fn bind_primitive( &mut self, value: PrimitiveValue, ) -> Result<(), InsertError>

Bind a primitive value to the current node. Error if already bound.

pub fn bind_from( &mut self, value: impl Into<PrimitiveValue>, ) -> Result<(), InsertError>

Bind a value to the current node using Into<PrimitiveValue>.

This is a convenience method for use with the eure! macro. It accepts any type that implements Into<PrimitiveValue>.

pub fn bind_empty_map(&mut self) -> Result<(), InsertError>

Bind an empty map to the current node. Error if already bound.

pub fn bind_empty_array(&mut self) -> Result<(), InsertError>

Bind an empty array to the current node. Error if already bound.

pub fn bind_empty_tuple(&mut self) -> Result<(), InsertError>

Bind an empty tuple to the current node. Error if already bound.

impl DocumentConstructor

pub fn record<F, T>(&mut self, f: F) -> Result<T, WriteError>

where F: FnOnce(&mut RecordWriter<'_>) -> Result<T, WriteError>,

Write a record (map with string keys) using a closure.

Example

c.record(|rec| {
    rec.field("name", "Alice")?;
    rec.field("age", 30)?;
    Ok(())
})?;

pub fn tuple<F, T>(&mut self, f: F) -> Result<T, WriteError>

where F: FnOnce(&mut TupleWriter<'_>) -> Result<T, WriteError>,

Write a tuple using a closure.

Example

c.tuple(|t| {
    t.next("first")?;
    t.next(42)?;
    t.next(true)?;
    Ok(())
})?;

pub fn set_extension<T: IntoDocument>( &mut self, name: &str, value: T, ) -> Result<(), WriteError>

Set an extension value on the current node.

Example

c.set_extension("optional", true)?;

pub fn set_extension_optional<T: IntoDocument>( &mut self, name: &str, value: Option<T>, ) -> Result<(), WriteError>

Set an optional extension value on the current node. Does nothing if the value is None.

Example

c.set_extension_optional("default", self.default)?;

pub fn set_variant(&mut self, variant: &str) -> Result<(), WriteError>

Set the $variant extension for union types.

Example

match self {
    MyEnum::Foo(inner) => {
        c.set_variant("foo")?;
        inner.write_to(c)?;
    }
}

pub fn write<T: IntoDocument>(&mut self, value: T) -> Result<(), WriteError>

Write a value implementing IntoDocument to the current node.

Example

c.write(my_value)?;

Trait Implementations

impl Default for DocumentConstructor

fn default() -> Self

Returns the “default value” for a type.