From cfce3e4dbb94bd23401a2b43bd17e6cd38703f61 Mon Sep 17 00:00:00 2001
From: Johan Maasing <johan@zoom.nu>
Date: Mon, 24 Mar 2025 21:44:21 +0100
Subject: [PATCH] Initial ANTLR grammar

---
 .gitignore                                    | 35 ++++++++++++
 assembly/pom.xml                              | 24 ++++++++
 parser/pom.xml                                | 55 +++++++++++++++++++
 .../antlr4/nu/zoom/dsl/parser/Endpoints.g4    | 23 ++++++++
 parser/src/main/java/nu/zoom/dsl/Main.java    |  7 +++
 .../nu/zoom/dsl/parser/ParserFactory.java     |  4 ++
 pom.xml                                       | 23 ++++++++
 7 files changed, 171 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 assembly/pom.xml
 create mode 100644 parser/pom.xml
 create mode 100644 parser/src/main/antlr4/nu/zoom/dsl/parser/Endpoints.g4
 create mode 100644 parser/src/main/java/nu/zoom/dsl/Main.java
 create mode 100644 parser/src/main/java/nu/zoom/dsl/parser/ParserFactory.java
 create mode 100644 pom.xml

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..48010bb
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,35 @@
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### IntelliJ IDEA ###
+.idea/**
+*.iws
+*.iml
+*.ipr
+
+### Eclipse ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/
+
+### Mac OS ###
+.DS_Store
\ No newline at end of file
diff --git a/assembly/pom.xml b/assembly/pom.xml
new file mode 100644
index 0000000..43bb1e9
--- /dev/null
+++ b/assembly/pom.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>nu.zoom.dsl</groupId>
+        <artifactId>endgen</artifactId>
+        <version>1.0-SNAPSHOT</version>
+    </parent>
+
+    <groupId>nu.zoom.dsl</groupId>
+    <artifactId>assembly</artifactId>
+
+    <dependencies>
+        <dependency>
+            <groupId>nu.zoom.dsl</groupId>
+            <artifactId>parser</artifactId>
+            <version>${parent.version}</version>
+        </dependency>
+    </dependencies>
+
+</project>
\ No newline at end of file
diff --git a/parser/pom.xml b/parser/pom.xml
new file mode 100644
index 0000000..0c1f9b6
--- /dev/null
+++ b/parser/pom.xml
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>nu.zoom.dsl</groupId>
+        <artifactId>endgen</artifactId>
+        <version>1.0-SNAPSHOT</version>
+    </parent>
+
+    <groupId>nu.zoom.dsl</groupId>
+    <artifactId>parser</artifactId>
+    <dependencies>
+        <dependency>
+            <groupId>org.antlr</groupId>
+            <artifactId>antlr4-runtime</artifactId>
+            <version>4.13.0</version>
+        </dependency>
+    </dependencies>
+    <build>
+        <plugins>
+            <!-- This plugin sets up maven to use Java 7 -->
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.13.0</version>
+                <configuration>
+                    <source>24</source>
+                    <target>24</target>
+                </configuration>
+            </plugin>
+            <!-- Plugin to compile the g4 files ahead of the java files
+                 See https://github.com/antlr/antlr4/blob/master/antlr4-maven-plugin/src/site/apt/examples/simple.apt.vm
+                 Except that the grammar does not need to contain the package declaration as stated in the documentation (I do not know why)
+                 To use this plugin, type:
+                   mvn antlr4:antlr4
+                 In any case, Maven will invoke this plugin before the Java source is compiled
+              -->
+            <plugin>
+                <groupId>org.antlr</groupId>
+                <artifactId>antlr4-maven-plugin</artifactId>
+                <version>4.13.1</version>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>antlr4</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
\ No newline at end of file
diff --git a/parser/src/main/antlr4/nu/zoom/dsl/parser/Endpoints.g4 b/parser/src/main/antlr4/nu/zoom/dsl/parser/Endpoints.g4
new file mode 100644
index 0000000..7fc1d09
--- /dev/null
+++ b/parser/src/main/antlr4/nu/zoom/dsl/parser/Endpoints.g4
@@ -0,0 +1,23 @@
+grammar Endpoints;
+
+generatorconfig     : '{' (configitem)? (',' configitem)* '}';
+configitem          : configkey ':' configvalue ;
+configkey           : IDENTIFIER ;
+configvalue         : (IDENTIFIER|VALUE) ;
+fieldName           : IDENTIFIER ;
+fieldType           : IDENTIFIER ;
+compoundTypeName    : IDENTIFIER ;
+compoundField       : fieldName ':' fieldType ;
+compoundFields      : '(' compoundField (',' compoundField)* ')' ;
+compoundType        : compoundTypeName compoundFields ;
+pathSegment         : '/' (IDENTIFIER|VALUE) ;
+path                : (pathSegment)+ ;
+endpoint            : path '<' (compoundFields | IDENTIFIER) ;
+
+
+fragment DIGIT      : [0-9] ;
+fragment LOWERCASE  : [a-z] ;
+fragment UPPERCASE  : [A-Z] ;
+WS                  : [ \t\n\r]+ -> skip;
+IDENTIFIER          : (LOWERCASE | UPPERCASE) (LOWERCASE | UPPERCASE | DIGIT)* ;
+VALUE               : ~[ ,{}:()\n\t\r/<>"']+  ;
diff --git a/parser/src/main/java/nu/zoom/dsl/Main.java b/parser/src/main/java/nu/zoom/dsl/Main.java
new file mode 100644
index 0000000..c57eaa0
--- /dev/null
+++ b/parser/src/main/java/nu/zoom/dsl/Main.java
@@ -0,0 +1,7 @@
+package nu.zoom.dsl;
+
+public class Main {
+	public static void main(String[] args) {
+		System.out.println("Hello, World!");
+	}
+}
\ No newline at end of file
diff --git a/parser/src/main/java/nu/zoom/dsl/parser/ParserFactory.java b/parser/src/main/java/nu/zoom/dsl/parser/ParserFactory.java
new file mode 100644
index 0000000..370386c
--- /dev/null
+++ b/parser/src/main/java/nu/zoom/dsl/parser/ParserFactory.java
@@ -0,0 +1,4 @@
+package nu.zoom.dsl.parser;
+
+public class ParserFactory {
+}
diff --git a/pom.xml b/pom.xml
new file mode 100644
index 0000000..2ede1fb
--- /dev/null
+++ b/pom.xml
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>nu.zoom.dsl</groupId>
+    <artifactId>endgen</artifactId>
+    <version>1.0-SNAPSHOT</version>
+    <packaging>pom</packaging>
+
+    <properties>
+        <maven.compiler.source>24</maven.compiler.source>
+        <maven.compiler.target>24</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <modules>
+        <module>parser</module>
+        <module>assembly</module>
+    </modules>
+
+</project>
\ No newline at end of file