aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--src/lib.rs3
-rw-r--r--src/tree/file_builder.rs16
-rw-r--r--src/tree/mod.rs2
3 files changed, 14 insertions, 7 deletions
diff --git a/src/lib.rs b/src/lib.rs
index ad333582c..0ea8f6a63 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -24,7 +24,8 @@ mod parser;
24 24
25pub mod syntax_kinds; 25pub mod syntax_kinds;
26pub use text::{TextRange, TextUnit}; 26pub use text::{TextRange, TextUnit};
27pub use tree::{File, FileBuilder, Node, Sink, SyntaxKind, Token}; 27pub use tree::{File, Node, SyntaxKind, Token};
28pub(crate) use tree::{FileBuilder, Sink};
28pub use lexer::{next_token, tokenize}; 29pub use lexer::{next_token, tokenize};
29pub use parser::parse; 30pub use parser::parse;
30 31
diff --git a/src/tree/file_builder.rs b/src/tree/file_builder.rs
index 738705f02..47038496d 100644
--- a/src/tree/file_builder.rs
+++ b/src/tree/file_builder.rs
@@ -1,10 +1,16 @@
1// FIXME(CAD97): I don't understand this mod well enough to stub out docs for the public symbols yet 1//! This module provides a way to construct a `File`.
2#![allow(missing_docs)] 2//! It is intended to be completely decoupled from the
3 3//! parser, so as to allow to evolve the tree representation
4//! and the parser algorithm independently.
5//!
6//! The `Sink` trait is the bridge between the parser and the
7//! tree builder: the parser produces a stream of events like
8//! `start node`, `finish node`, and `FileBuilder` converts
9//! this stream to a real tree.
4use {SyntaxKind, TextRange, TextUnit}; 10use {SyntaxKind, TextRange, TextUnit};
5use super::{File, NodeData, NodeIdx, SyntaxErrorData}; 11use super::{File, NodeData, NodeIdx, SyntaxErrorData};
6 12
7pub trait Sink { 13pub(crate) trait Sink {
8 fn leaf(&mut self, kind: SyntaxKind, len: TextUnit); 14 fn leaf(&mut self, kind: SyntaxKind, len: TextUnit);
9 fn start_internal(&mut self, kind: SyntaxKind); 15 fn start_internal(&mut self, kind: SyntaxKind);
10 fn finish_internal(&mut self); 16 fn finish_internal(&mut self);
@@ -12,7 +18,7 @@ pub trait Sink {
12} 18}
13 19
14#[derive(Debug)] 20#[derive(Debug)]
15pub struct FileBuilder { 21pub(crate) struct FileBuilder {
16 text: String, 22 text: String,
17 nodes: Vec<NodeData>, 23 nodes: Vec<NodeData>,
18 errors: Vec<SyntaxErrorData>, 24 errors: Vec<SyntaxErrorData>,
diff --git a/src/tree/mod.rs b/src/tree/mod.rs
index 43bda480d..795f23f42 100644
--- a/src/tree/mod.rs
+++ b/src/tree/mod.rs
@@ -4,7 +4,7 @@ use std::fmt;
4use std::cmp; 4use std::cmp;
5 5
6mod file_builder; 6mod file_builder;
7pub use self::file_builder::{FileBuilder, Sink}; 7pub(crate) use self::file_builder::{FileBuilder, Sink};
8 8
9pub use syntax_kinds::SyntaxKind; 9pub use syntax_kinds::SyntaxKind;
10 10