Crate awkrs

Expand description

Awk-style record processor: library crate shared by the awkrs and ars binaries.

Modules§

aot: Native AOT for awkrs via fusevm::aot (--aot OUT).
awkstr: AwkStr — the byte string an awk value holds.
banner: AWKRS ASCII logo + live-stats banner (shared by the REPL and --help). AWKRS ASCII logo + live-stats box banner. Single source of truth shared by:
fusevm_bridge: fusevm_bridge submodule. Bridge between awkrs’s bytecode Op and fusevm’s fusevm::Op.
intercepts: Function-call AOP intercepts (before/after/around advice) — awkrs/zshrs-original extension; no POSIX awk counterpart. Types + pattern matcher live here; the VM wiring is in crate::vm, the builtins in vm_builtins. Function-call intercept / advice machinery — awkrs/zshrs-original extension.
lsp: LSP server plus the shared documentation corpus (builtin_signature, special_doc, keyword_doc, AWK_KEYWORDS) consumed by the offline gen-docs reference generator. Language Server Protocol (stdio) for editors — awkrs --lsp.
repl: Interactive REPL (awkrs --repl, or the default on a bare terminal). Interactive REPL for awkrs / aw — a reedline line editor over the awk engine.
rust_ffi: awk wiring for inline Rust FFI (rust { ... } blocks): the fusevm::RustSugar config and the source-level desugar the parser runs before lexing. awk wiring for inline Rust FFI (rust { ... } blocks).

run: Run the interpreter. bin_name is used for diagnostics and help (e.g. "awkrs" or "ars").
run_on_interpreter_stack: run, on a thread whose stack the call-depth cap can outlast.
run_program: Embedding entry point: run an awk program over input (treated as the whole input stream) and return everything the program print/printfs.