Package parseutil contains utilities built on top of the parse package.

NewParser creates a new parser from a piece of source text and its name.

Parse parses Elvish source.

PPrintAST pretty-prints the AST part of a Node.

PPrintASTTo pretty-prints the AST part of a Node to a Writer.

PPrintParseTree pretty-prints the parse tree part of a Node.

PPrintParseTreeTo pretty-prints the parse tree part of a Node to a Writer.

Quote returns a representation of s in elvish syntax.

QuoteAs returns a representation of s in elvish syntax, using the syntax specified by q, which must be one of Bareword, SingleQuoted, or DoubleQuoted.

Possible values for RedirMode.

Possible values for PrimaryType.

Possible values for RedirMode.

Possible values for PrimaryType.

Possible values for PrimaryType.

BracedElemExpr represents an expression used as an element in a braced expression.

CmdExpr represents an expression used as the command in a form.

Possible values for PrimaryType.

Possible values for PrimaryType.

Possible values for PrimaryType.

LHSExpr represents an expression used as the left-hand-side in either assignments or map pairs.

Possible values for PrimaryType.

Possible values for PrimaryType.

NormalExpr represents a normal expression, namely none of the special ones below.

Possible values for PrimaryType.

Possible values for RedirMode.

Possible values for RedirMode.

Possible values for PrimaryType.

Possible values for PrimaryType.

Possible values for PrimaryType.

Possible values for PrimaryType.

Possible values for RedirMode.

Array = { Space | '\n' } { Compound { Space | '\n' } }.

Assignment = Indexing '=' Compound.

Chunk = { PipelineSep | Space } { Pipeline { PipelineSep | Space } }.

Compound = { Indexing }.

Error stores multiple ErrorEntry's and can pretty print them.

ErrorEntry represents one parse error.

ExitusRedir = '?' '>' { Space } Compound.

Form = { Space } { { Assignment } { Space } } { Compound } { Space } { ( Compound | MapPair | Redir | ExitusRedir ) { Space } }.

Indexing = Primary { '[' Array ']' }.

MapPair = '&' { Space } Compound { Space } Compound.

Parser maintains some mutable states of parsing.

Pipeline = Form { '|' Form }.

Primary is the smallest expression unit.

Redir = { Compound } { '<'|'>'|'<>'|'>>' } { Space } ( '&'? Compound ).

Sep is the catch-all node type for leaf nodes that lack internal structures and semantics, and serve solely for syntactic purposes.

Node represents a parse tree as well as an AST.

ExprCtx represents special contexts of expression parsing.

PrimaryType is the type of a Primary.

RedirMode records the mode of an IO redirection.