Enum Expansion 

pub enum Expansion {
    Complete(String),
    Blocked {
        holes: Vec<Hole>,
    },
}

What expanding a fragment produced.

There are two outcomes and no third: either the text is complete, or it is blocked and no text comes back at all. Half-expanded source reads as ground truth to whatever parses it next and is not, so this type cannot represent it.

Deliberately not #[non_exhaustive], unlike the record types around it. A caller must handle both arms, and that is the guarantee — a wildcard arm written today to satisfy the attribute is exactly where a third outcome would land unnoticed tomorrow. A new variant here would be a change every embedder must see, so it should break their build.

Variants

Complete(String)

Every expansion resolved. This is exactly the text the command reads on stdin, given the scope that was supplied.

Blocked

A $(…) stands between the body and its final text. Running it is a decision with a clock and a blast radius, so the kernel returns the question instead of answering it.

Fields

holes: Vec<Hole>

Every substitution the body contains, in source order.

Trait Implementations

impl Clone for Expansion

fn clone(&self) -> Expansion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Expansion

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Expansion

fn deserialize<__D>( __deserializer: __D, ) -> Result<Expansion, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Expansion

impl PartialEq for Expansion

fn eq(&self, other: &Expansion) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Expansion

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Expansion