Struct OutputData 

pub struct OutputData {
    pub headers: Option<Vec<String>>,
    pub root: Vec<OutputNode>,
}

Structured output data from a command.

This is the top-level structure for command output. It contains optional column headers and a list of root nodes.

headers is Option<Vec> because None means “not tabular” while Some(vec![]) means “tabular with no column headers.” The rendering dispatch in to_json() and the REPL formatter branch on this distinction.

Rendering Rules

Structure	Interactive	Piped/Model
Single node with text	Print text	Print text
Flat nodes, name only	Multi-column, colored	One per line
Flat nodes with cells	Aligned table	TSV or names only
Nested children	Box-drawing tree	Brace notation

Fields

headers: Option<Vec<String>>

Column headers (optional, for table output).

root: Vec<OutputNode>

Top-level nodes.

Implementations

impl OutputData

pub fn new() -> OutputData

Create new empty output data.

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

Create output data with a single text node.

This is the simplest form for commands like echo.

pub fn nodes(nodes: Vec<OutputNode>) -> OutputData

Create output data with named nodes (for ls, etc.).

pub fn table(headers: Vec<String>, nodes: Vec<OutputNode>) -> OutputData

Create output data with headers and nodes (for ls -l, ps, etc.).

pub fn with_headers(self, headers: Vec<String>) -> OutputData

Set column headers.

pub fn is_simple_text(&self) -> bool

Check if this output is simple text (single text-only node).

pub fn is_flat(&self) -> bool

Check if this output is a flat list (no nested children).

pub fn is_tabular(&self) -> bool

Check if this output has tabular data (nodes with cells).

pub fn as_text(&self) -> Option<&str>

Get the text content if this is simple text output.

pub fn to_canonical_string(&self) -> String

Convert to canonical string output (for pipes).

This produces a simple string representation suitable for piping to other commands:

• Text nodes: their text content
• Named nodes: names joined by newlines
• Tabular nodes (name + cells): TSV format (name\tcell1\tcell2…)
• Nested nodes: brace notation

pub fn to_json(&self) -> Value

Serialize to a JSON value for --json flag handling.

Bare data, no envelope — optimized for jq patterns.

Structure	JSON
Simple text	"hello world"
Flat list (names only)	["file1", "file2"]
Table (headers + cells)	[{"col1": "v1", ...}, ...]
Tree (nested children)	{"dir": {"file": null}}

Trait Implementations

impl Clone for OutputData

fn clone(&self) -> OutputData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OutputData

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

Formats the value using the given formatter.

impl Default for OutputData

fn default() -> OutputData

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OutputData

where OutputData: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for OutputData

fn eq(&self, other: &OutputData) -> 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 OutputData

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 Eq for OutputData

impl StructuralPartialEq for OutputData