Expand description
Lossless CST parser, typed AST wrappers, and incremental reparser for the Julia language.
This crate is the parsing engine of the fatou CLI,
extracted so other tools can embed it. It parses Julia source into a
rowan concrete syntax tree that preserves every
byte of the input (reconstruct(text) == text for all inputs), reports
recoverable diagnostics instead of failing, and supports incremental
reparsing of edited buffers.
§Main entry points
parser::parse— parse source text into aparser::ParseOutput(green tree plus diagnostics).parser::reparseandparser::reparse_edits— incremental reparse of an edited buffer; aNonemeans “do a full parse”.syntax— thesyntax::SyntaxKindenum and rowan node/token aliases shared by every consumer of the tree.ast— typed node wrappers over the CST, includingast::DocAttachmentfor documentation syntax and statically recoverable string payloads.documentation— a lossless Julia Markdown parser with typed navigation and local classification of core Documenter links and code fences.
The crate is wasm32-unknown-unknown-compatible: no filesystem, process,
thread, or clock use.
Modules§
- ast
- Zero-cost typed wrappers over the CST — the typed AST interface, modeled on
rust-analyzer’s
astmodule. - documentation
- A lossless parser for Julia’s Markdown dialect and Documenter syntax.
- parser
- The parse pipeline:
lex → parse_expr (Pratt) + structural (recursive descent) → events → build_tree → rowan CST. - syntax
- The Julia syntax-kind set and the
rowanLanguagebinding.