Enum OutputTo 

pub enum OutputTo {
    Split,
    Stdout,
    Stderr,
}

Where a CliEmitter sends its events, selected by --output-to.

The stream an event lands on follows the program’s consumption mode, not the event’s shape (see the spec’s CLI Event Framing):

• OutputTo::Split (the default) is finite one-shot mode: result goes to stdout, while error/progress/log go to stderr. stdout therefore carries only successful payloads, so a shell capture or pipe never mistakes a failure for data.
• OutputTo::Stdout / OutputTo::Stderr are event-stream mode: every event, including error, is collapsed onto that one stream so a consumer reading it in order (kind-branching) sees preserved ordering.

A command is an event stream when it produces more than one caller-needed output over time — a chunked payload, or an address the caller must act on before the command can report its outcome. Such a command defaults to OutputTo::Stdout and rejects an explicit split, because splitting it would strand the caller’s data on the diagnostic stream. If a kind:"progress" event carries a payload the caller must read, the command is an event stream that has not declared itself.

Variants

Split

Finite one-shot: result → stdout, error/progress/log → stderr.

Stdout

Event stream: every event onto stdout.

Stderr

Event stream: every event onto stderr.

Implementations

impl OutputTo

pub fn parse(value: &str) -> Result<Self, String>

Parse an --output-to value: split (default), stdout, or stderr.

Trait Implementations

impl Clone for OutputTo

fn clone(&self) -> OutputTo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for OutputTo

impl Debug for OutputTo

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

Formats the value using the given formatter.

impl Eq for OutputTo

impl PartialEq for OutputTo

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for OutputTo