fatou_parser/lib.rs
1//! Lossless CST parser, typed AST wrappers, and incremental reparser for the
2//! Julia language.
3//!
4//! This crate is the parsing engine of the [fatou](https://fatou.dev) CLI,
5//! extracted so other tools can embed it. It parses Julia source into a
6//! [rowan](https://docs.rs/rowan) concrete syntax tree that preserves every
7//! byte of the input (`reconstruct(text) == text` for all inputs), reports
8//! recoverable diagnostics instead of failing, and supports incremental
9//! reparsing of edited buffers.
10//!
11//! # Main entry points
12//!
13//! - [`parser::parse`] — parse source text into a [`parser::ParseOutput`]
14//! (green tree plus diagnostics).
15//! - [`parser::reparse`] and [`parser::reparse_edits`] — incremental reparse
16//! of an edited buffer; a `None` means "do a full parse".
17//! - [`syntax`] — the [`syntax::SyntaxKind`] enum and rowan node/token
18//! aliases shared by every consumer of the tree.
19//! - [`ast`] — typed node wrappers over the CST, including
20//! [`ast::DocAttachment`] for documentation syntax and statically recoverable
21//! string payloads.
22//! - [`documentation`] — a lossless Julia Markdown parser with typed navigation
23//! and local classification of core Documenter links and code fences.
24//!
25//! The crate is `wasm32-unknown-unknown`-compatible: no filesystem, process,
26//! thread, or clock use.
27
28pub mod ast;
29pub mod documentation;
30mod keywords;
31pub mod parser;
32pub mod syntax;
33mod tokens;