Merge pull request github#152 from github/add-java-crate

Add initial support for Java via tssg

Author: rnkaufman

languages/super_this_method_declaration.java

@@ -0,0 +1,17 @@
+class TestClass extends SecondTestClass {
+  public static void main(String[] args){
+    super.bar();
+       // ^ defined: 14
+    this.bar();
+      // ^ defined: 9
+  }
+
+  public void bar() {
+  }
+}
+
+class SecondTestClass {
+  public void bar() {
+    System.out.println("Hello");
+  }
+}

languages/tree-sitter-stack-graphs-java/.gitignore

@@ -0,0 +1,2 @@
+/Cargo.lock
+/*.html

languages/tree-sitter-stack-graphs-java/Cargo.toml

@@ -0,0 +1,40 @@
+[package]
+name = "tree-sitter-stack-graphs-java"
+version = "0.1.0"
+description = "Stack graphs for the Java programming language"
+
+homepage = "https://github.com/github/stack-graphs/tree/main/stack-graphs/languages/tree-sitter-stack-graphs-java"
+repository = "https://github.com/github/stack-graphs"
+license = "MIT OR Apache-2.0"
+readme = "languages/tree-sitter-stack-graphs-java/README.md"
+edition = "2021"
+
+authors = [
+  "Beka Valentine <[email protected]>",
+  "Douglas Creager <[email protected]>",
+  "GitHub <[email protected]>",
+  "Hendrik van Antwerpen <[email protected]>",
+  "Nina Kaufman <[email protected]>",
+  "Rob Rix <[email protected]>",
+]
+
+keywords = ["tree-sitter", "stack-graphs", "java"]
+
+[[bin]]
+name = "tree-sitter-stack-graphs-java"
+path = "rust/bin.rs"
+
+[lib]
+path = "rust/lib.rs"
+test = false
+
+[[test]]
+name = "test"
+path = "rust/test.rs"
+harness = false # need to provide own main function to handle running tests
+
+[dependencies]
+anyhow = "1.0"
+clap = "3"
+tree-sitter-stack-graphs = { version = "~0.6.0", path = "../../tree-sitter-stack-graphs", features=["cli"] }
+tree-sitter-java = { git = "http://github.com/tree-sitter/tree-sitter-java", rev="09d650def6cdf7f479f4b78f595e9ef5b58ce31e" }

languages/tree-sitter-stack-graphs-java/README.md

@@ -0,0 +1,30 @@
+# tree-sitter-stack-graphs definition for Java
+
+This project defines tree-sitter-stack-graphs rules for Java using the [tree-sitter-java](https://www.npmjs.com/package/tree-sitter-java) grammar.
+
+## Local Development
+
+The project is organized as follows:
+
+- The stack graph rules are defined in `src/stack-graphs.tsg`.
+- Tests are put into the `tests` directory.
+
+The following commands are intended to be run from the repo root.
+
+Run all tests in the project by executing the following:
+
+    cargo test -p tree-sitter-stack-graphs-java
+
+Parse a single test file:
+  `cargo run -p tree-sitter-stack-graphs-java -- parse OPTIONS FILENAME`
+
+Test a single file:
+  `cargo run -p tree-sitter-stack-graphs-java -- test OPTIONS FILENAME`
+
+For debugging purposes, it is useful to run the visualization tool to generate graphs for the tests being run.
+
+To run a test and generate the visualization:
+
+`cargo run -p tree-sitter-stack-graphs-java -- test --output-mode=always -V=%r/%d/%n.html FILENAME`
+
+Go to https://crates.io/crates/tree-sitter-stack-graphs for links to examples and documentation.

languages/tree-sitter-stack-graphs-java/rust/bin.rs

@@ -0,0 +1,18 @@
+use clap::Parser;
+use tree_sitter_stack_graphs::cli::provided_languages::Subcommands;
+use tree_sitter_stack_graphs::NoCancellation;
+
+fn main() -> anyhow::Result<()> {
+    let cli = Cli::parse();
+    cli.subcommand
+        .run(vec![tree_sitter_stack_graphs_java::language_configuration(
+            &NoCancellation,
+        )])
+}
+
+#[derive(Parser)]
+#[clap(about, version)]
+pub struct Cli {
+    #[clap(subcommand)]
+    subcommand: Subcommands,
+}

languages/tree-sitter-stack-graphs-java/rust/lib.rs

@@ -0,0 +1,26 @@
+use tree_sitter_stack_graphs::loader::FileAnalyzers;
+use tree_sitter_stack_graphs::loader::LanguageConfiguration;
+use tree_sitter_stack_graphs::CancellationFlag;
+
+/// The stack graphs tsg source for this language
+pub const STACK_GRAPHS_TSG_SOURCE: &str = include_str!("../src/stack-graphs.tsg");
+
+/// The stack graphs builtins configuration for this language
+pub const STACK_GRAPHS_BUILTINS_CONFIG: &str = include_str!("../src/builtins.cfg");
+/// The stack graphs builtins source for this language
+pub const STACK_GRAPHS_BUILTINS_SOURCE: &str = include_str!("../src/builtins.java");
+
+pub fn language_configuration(cancellation_flag: &dyn CancellationFlag) -> LanguageConfiguration {
+    LanguageConfiguration::from_tsg_str(
+        tree_sitter_java::language(),
+        Some(String::from("source.java")),
+        None,
+        vec![String::from("java")],
+        STACK_GRAPHS_TSG_SOURCE,
+        Some(STACK_GRAPHS_BUILTINS_SOURCE),
+        Some(STACK_GRAPHS_BUILTINS_CONFIG),
+        FileAnalyzers::new(),
+        cancellation_flag,
+    )
+    .unwrap()
+}

languages/tree-sitter-stack-graphs-java/rust/test.rs

@@ -0,0 +1,13 @@
+use std::path::PathBuf;
+use tree_sitter_stack_graphs::{ci::Tester, NoCancellation};
+
+fn main() -> anyhow::Result<()> {
+    let test_path = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("test");
+    Tester::new(
+        vec![tree_sitter_stack_graphs_java::language_configuration(
+            &NoCancellation,
+        )],
+        vec![test_path],
+    )
+    .run()
+}

languages/tree-sitter-stack-graphs-java/src/builtins.cfg

@@ -0,0 +1 @@
+[globals]