rable 0.1.2

A Rust implementation of the Parable bash parser — complete GNU Bash 5.3-compatible parsing with Python bindings
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

pub mod ast;
pub mod error;
pub mod format;
pub mod lexer;
pub mod parser;
pub mod sexp;
pub mod token;

#[cfg(feature = "python")]
mod python;

use error::Result;

/// Parses a bash source string into a list of AST nodes.
///
/// This is the main entry point for the parser. The returned nodes
/// can be formatted as S-expressions using their `Display` implementation,
/// producing output compatible with Parable.
///
/// # Errors
///
/// Returns `RableError::Parse` for syntax errors and
/// `RableError::MatchedPair` for unclosed delimiters.
pub fn parse(source: &str, extglob: bool) -> Result<Vec<ast::Node>> {
    let lexer = lexer::Lexer::new(source, extglob);
    let mut parser = parser::Parser::new(lexer);
    parser.parse_all()
}