Struct Parser 

pub struct Parser<'a> { /* private fields */ }

Parser for bash scripts.

Implementations

impl<'a> Parser<'a>

pub fn parse(self) -> ParseResult

Parse the input and return the AST, recovery diagnostics, and syntax facts.

impl<'a> Parser<'a>

pub fn new(input: &'a str) -> Self

Create a new parser for the given input.

pub fn with_dialect(input: &'a str, dialect: ShellDialect) -> Self

Create a new parser for the given input and shell dialect.

pub fn with_profile(input: &'a str, shell_profile: ShellProfile) -> Self

Create a new parser for the given input and full shell profile.

pub fn with_max_depth(input: &'a str, max_depth: usize) -> Self

Create a new parser with a custom maximum AST depth.

pub fn with_fuel(input: &'a str, max_fuel: usize) -> Self

Create a new parser with a custom fuel limit.

pub fn with_limits(input: &'a str, max_depth: usize, max_fuel: usize) -> Self

Create a new parser with custom depth and fuel limits.

max_depth is clamped to HARD_MAX_AST_DEPTH (500) to prevent stack overflow from misconfiguration. Even if the caller passes max_depth = 1_000_000, the parser will cap it at 500.

pub fn with_limits_and_dialect( input: &'a str, max_depth: usize, max_fuel: usize, dialect: ShellDialect, ) -> Self

Create a new parser with custom depth, fuel, and dialect settings.

pub fn with_limits_and_profile( input: &'a str, max_depth: usize, max_fuel: usize, shell_profile: ShellProfile, ) -> Self

Create a new parser with custom depth, fuel, and shell-profile settings.

pub fn dialect(&self) -> ShellDialect

Return the dialect associated with this parser.

pub fn shell_profile(&self) -> &ShellProfile

Borrow the full shell profile associated with this parser.

pub fn current_span(&self) -> Span

Get the current token’s span.

pub fn parse_word_string(input: &str) -> Word

Parse a string as a word (handling $var, $((expr)), ${…}, etc.). Used by the interpreter to expand operands in parameter expansions lazily.

pub fn parse_assignment_word( source: &str, word: Word, explicit_array_kind: Option<ArrayKind>, subscript_interpretation: SubscriptInterpretation, ) -> Option<Assignment>

Classify an already-parsed word as a shell assignment and split its value.

This is the parser-owned entrypoint for downstream analysis that needs assignment target/value structure from a Word that was parsed as a normal command argument.

pub fn parse_assignment_word_group( source: &str, words: &[&Word], explicit_array_kind: Option<ArrayKind>, subscript_interpretation: SubscriptInterpretation, ) -> Option<Assignment>

Classify a contiguous group of already-parsed words as a shell assignment.

Some shell syntax, such as process substitution inside an array subscript, can produce multiple AST words while still occupying one contiguous assignment operand in the source.

pub fn parse_word_string_with_limits( input: &str, max_depth: usize, max_fuel: usize, ) -> Word

Parse a word string with caller-configured limits. Prevents bypass of parser limits in parameter expansion contexts.

pub fn parse_word_string_with_limits_and_dialect( input: &str, max_depth: usize, max_fuel: usize, dialect: ShellDialect, ) -> Word

Parse a word string with caller-configured limits and shell dialect.

pub fn parse_word_fragment(source: &str, text: &str, span: Span) -> Word

Parse a fragment against the original source span so part offsets stay aligned with the surrounding script.

Trait Implementations

impl<'a> Clone for Parser<'a>

fn clone(&self) -> Parser<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.