Struct OutputNode 

pub struct OutputNode {
    pub name: String,
    pub entry_type: EntryType,
    pub text: Option<String>,
    pub cells: Vec<String>,
    pub children: Vec<OutputNode>,
}

A node in the output tree.

All fields are always serialized (no skip_serializing_if) for predictable shape across JSON, postcard, and bincode formats.

text is Option because None and Some(“”) are semantically distinct:

• None: this is a named entry (file listing, table row), not a text node
• Some(“”): this IS a text node whose content is empty (e.g. echo "")

The is_text_only() method depends on this distinction.

Fields

name: String

Primary identifier (filename, key, label).

entry_type: EntryType

Rendering hint (colors, icons).

text: Option<String>

Text content (for echo, cat, exec).

Three-state semantics:

• None — named entry (file listing, table row), not text
• Some("") — text node with empty content (e.g., echo "")
• Some("x") — text node with content

is_text_only() returns true iff text is Some AND name/cells/children are empty.

cells: Vec<String>

Additional columns (for ls -l, ps, env).

children: Vec<OutputNode>

Child nodes (for tree, find).

Implementations

impl OutputNode

pub fn new(name: impl Into<String>) -> Self

Create a new node with a name.

pub fn text(content: impl Into<String>) -> Self

Create a text-only node (for echo, cat, etc.).

pub fn with_entry_type(self, entry_type: EntryType) -> Self

Set the entry type for rendering hints.

pub fn with_cells(self, cells: Vec<String>) -> Self

Set additional columns for tabular output.

pub fn with_children(self, children: Vec<OutputNode>) -> Self

Set child nodes for tree output.

pub fn with_text(self, text: impl Into<String>) -> Self

Set text content.

pub fn is_text_only(&self) -> bool

Check if this is a text-only node.

pub fn has_children(&self) -> bool

Check if this node has children.

pub fn estimated_byte_size(&self) -> usize

Estimate brace-notation byte size without materializing.

pub fn write_canonical(&self, w: &mut dyn Write, budget: usize) -> Result<usize>

Write brace-notation to a writer. Returns bytes written.

pub fn display_name(&self) -> &str

Get the display name, potentially with text content.

Trait Implementations

impl Clone for OutputNode

fn clone(&self) -> OutputNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OutputNode

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

Formats the value using the given formatter.

impl Default for OutputNode

fn default() -> OutputNode

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OutputNode

where OutputNode: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for OutputNode

impl PartialEq for OutputNode

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for OutputNode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for OutputNode