bashrs 6.66.0

Rust-to-Shell transpiler for deterministic bootstrap scripts
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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! # Makefile Parser and Purification
//!
//! This module provides parsing, AST representation, and purification for GNU Makefiles.
//!
//! ## Features
//!
//! - Parse GNU Makefiles to AST
//! - Purify Makefiles for determinism and idempotency
//! - Generate safe, reproducible Makefiles
//! - Property-based testing for all transformations
//!
//! ## Safety Note
//! Makefile parser uses unwrap() and indexing on checked invariants (validated syntax, regex captures).
//! Positions and splits are validated before access for performance in hot paths.
//! Some parser functions are placeholders during development.
#![allow(clippy::unwrap_used)]
#![allow(clippy::indexing_slicing)]
#![allow(dead_code)]
#![allow(unused_variables)]
//!
//! ## Usage
//!
//! ```rust,ignore
//! use bashrs::make_parser::{parse_makefile, generate_purified_makefile};
//!
//! let makefile = r#"
//! .PHONY: test
//! test:
//!     cargo test
//! "#;
//!
//! let ast = parse_makefile(makefile).unwrap();
//! let purified = generate_purified_makefile(&ast);
//! ```

pub mod ast;
pub mod error;
pub mod generators;
pub mod lexer;
pub mod parser;
pub mod purify;
pub mod semantic;
pub mod test_generator;

#[cfg(test)]
pub mod tests;

#[cfg(test)]
#[path = "parser_coverage_tests.rs"]
mod make_parser_coverage_tests;

pub use ast::{MakeAst, MakeItem, MakeMetadata};
pub use error::{MakeParseError, SourceLocation};
pub use generators::generate_purified_makefile;
pub use parser::{extract_function_calls, parse_makefile};
pub use purify::{purify_makefile, PurificationResult};
pub use test_generator::{MakefileTestGenerator, MakefileTestGeneratorOptions};