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_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.