feat(parsing,parsing_handlers): add API to enhance parsing result (#49)

This PR introduces an API that enables users to augment Tree Sitter's
output, enriching the tree structure with additional information.

parsing/Cargo.toml

@@ -9,5 +9,6 @@ edition = "2021"
 tree-sitter = "0.20.9"
 tree-sitter-java = "0.20.0"
 model = { path = "../model" }
+parsing_handlers = { path = "../parsing_handlers" }
 log = { workspace = true }
 uuid = { workspace = true }

parsing/src/parse.rs

@@ -52,9 +52,9 @@ pub fn parse_string<'a>(
         .set_language(config.language)
         .map_err(|_| "There was an error while setting the parser language")?;
 
-    let parsed = parser.parse(src, None);
-    match parsed {
-        Some(parsed) => Result::Ok(explore_node(parsed.root_node(), src, config)),
-        None => Result::Err("It was not possible to parse the tree."),
-    }
+    let parsed = parser
+        .parse(src, None)
+        .ok_or("It was not possible to parse the tree.")?;
+    let root = explore_node(parsed.root_node(), src, config);
+    Ok(config.handlers.run(root))
 }

parsing/src/tree_sitter_parser.rs

@@ -1,11 +1,13 @@
 use model::Language;
+use parsing_handlers::ParsingHandlers;
 use std::collections::HashSet;
 
 pub struct ParserConfiguration {
     pub(crate) language: tree_sitter::Language,
     pub(crate) stop_compilation_at: HashSet<&'static str>,
     pub(crate) kinds_with_unordered_children: HashSet<&'static str>,
     pub(crate) block_end_delimiters: HashSet<&'static str>,
+    pub(crate) handlers: ParsingHandlers,
 }
 
 impl From<Language> for ParserConfiguration {
@@ -21,6 +23,7 @@ impl From<Language> for ParserConfiguration {
                 ]
                 .into(),
                 block_end_delimiters: ["}"].into(),
+                handlers: ParsingHandlers::from(Language::Java),
             },
         }
     }

parsing_handlers/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "parsing_handlers"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+model = { path = "../model" }
+log = { workspace = true }
+uuid = { workspace = true }

parsing_handlers/src/java/mod.rs

@@ -0,0 +1,5 @@
+use crate::ParsingHandlers;
+
+pub fn get_default_java_parsing_handlers() -> ParsingHandlers {
+    ParsingHandlers::new(vec![])
+}

parsing_handlers/src/language.rs

@@ -0,0 +1,10 @@
+use crate::{java::get_default_java_parsing_handlers, ParsingHandlers};
+use model::Language;
+
+impl From<Language> for ParsingHandlers {
+    fn from(language: Language) -> Self {
+        match language {
+            Language::Java => get_default_java_parsing_handlers(),
+        }
+    }
+}

parsing_handlers/src/lib.rs

@@ -0,0 +1,5 @@
+mod java;
+mod language;
+mod parsing_handlers;
+
+pub use parsing_handlers::{ParsingHandler, ParsingHandlers};

parsing_handlers/src/parsing_handlers.rs

@@ -0,0 +1,17 @@
+use model::CSTNode;
+
+pub type ParsingHandler = fn(root: CSTNode) -> CSTNode;
+
+pub struct ParsingHandlers {
+    handlers: Vec<ParsingHandler>,
+}
+
+impl ParsingHandlers {
+    pub fn new(handlers: Vec<ParsingHandler>) -> Self {
+        Self { handlers }
+    }
+
+    pub fn run<'a>(&'a self, root: CSTNode<'a>) -> CSTNode<'a> {
+        self.handlers.iter().fold(root, |acc, handler| handler(acc))
+    }
+}