Enum Stmt 

#[non_exhaustive]
pub enum Stmt {
    Assignment(Assignment),
    Command(Command),
    Pipeline(Pipeline),
    If(IfStmt),
    For(ForLoop),
    While(WhileLoop),
    Case(CaseStmt),
    Break(Option<usize>),
    Continue(Option<usize>),
    Return(Option<Box<Expr>>),
    Exit(Option<Box<Expr>>),
    ToolDef(ToolDef),
    Test(TestExpr),
    AndChain {
        left: Box<Stmt>,
        right: Box<Stmt>,
    },
    OrChain {
        left: Box<Stmt>,
        right: Box<Stmt>,
    },
    EnvScoped {
        assignments: Vec<Assignment>,
        body: Box<Stmt>,
    },
    Empty,
}

A single statement in kaish.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Assignment(Assignment)

Variable assignment: NAME=value or local NAME = value

Command(Command)

Simple command: tool arg1 arg2

Pipeline(Pipeline)

Pipeline: a | b | c

If(IfStmt)

Conditional: if cond; then ...; fi

For(ForLoop)

Loop: for X in items; do ...; done

While(WhileLoop)

While loop: while cond; do ...; done

Case(CaseStmt)

Case statement: case expr in pattern) ... ;; esac

Break(Option<usize>)

Break out of loop: break or break N

Continue(Option<usize>)

Continue to next iteration: continue or continue N

Return(Option<Box<Expr>>)

Return from tool: return or return expr

Exit(Option<Box<Expr>>)

Exit the script: exit or exit code

ToolDef(ToolDef)

Tool definition: tool name(params) { body }

Test(TestExpr)

Test expression: [[ -f path ]] or [[ $X == "value" ]]

AndChain

Statement chain with &&: run right only if left succeeds

Fields

left: Box<Stmt>

right: Box<Stmt>

OrChain

Statement chain with ||: run right only if left fails

Fields

left: Box<Stmt>

right: Box<Stmt>

EnvScoped

Inline env prefix: NAME=value... command. The assignments are exported for the duration of body only (bash-style command-scoped environment) and do not persist after it — distinct from a plain Assignment, which is persistent. body is always a command or pipeline.

Fields

assignments: Vec<Assignment>

body: Box<Stmt>

Empty

Empty statement (newline or semicolon only)

Implementations

impl Stmt

pub fn kind_name(&self) -> &'static str

Human-readable variant name for tracing spans.

Trait Implementations

impl Clone for Stmt

fn clone(&self) -> Stmt

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Stmt

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

Formats the value using the given formatter.

impl PartialEq for Stmt

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Stmt