build: set up and test GraalPy (#7)

* docs: update README badge

Signed-off-by: Cesar Berrospi Ramis <75900930+ceberam@users.noreply.github.com>

* build: set up and test GraalPy

Signed-off-by: Cesar Berrospi Ramis <75900930+ceberam@users.noreply.github.com>

---------

Signed-off-by: Cesar Berrospi Ramis <75900930+ceberam@users.noreply.github.com>

Author: ceberam

.github/workflows/build.yaml

@@ -27,7 +27,7 @@ jobs:
         uses: actions/setup-java@v4 
         with:
           java-version: ${{matrix.java-version}}
-          distribution: 'adopt'
+          distribution: 'graalvm'
           cache: 'maven'
       - name: Build & Test
         run: mvn -B clean package

README.md

@@ -1,5 +1,6 @@
 [![License MIT](https://img.shields.io/github/license/docling-project/docling-parse)](https://opensource.org/licenses/MIT)
-[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
+[![semantic-release: angular](https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)
+[![graalpy](https://img.shields.io/badge/pyenv-graalpy-blue)](#start-replacing-cpython-with-graalpy) 
 
 
 # Docling4j version 0.1.1
@@ -22,6 +23,8 @@ for the service, like this:
 </dependency>
 ```
 
+**docling4j** uses [GraalPy](https://www.graalvm.org/python), a high-performance embeddable Python 3 runtime for Java. Although not required, [Oracle GraalVM JDK](https://www.oracle.com/java/graalvm/) is recommended for running **docling4j**, since it supports runtime compilation to native code and efficient execution of embedded applications. Find more details on the level of optimizations of different Java runtimes [here](https://www.graalvm.org/latest/reference-manual/embed-languages/#runtime-optimization-support).
+
 ## Get help and support
 
 Please feel free to connect with us using the [discussion section](https://github.com/docling-project/docling/discussions).

pom.xml

@@ -11,13 +11,13 @@
 
   <properties>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <maven.compiler.source>21</maven.compiler.source>
+    <maven.compiler.target>21</maven.compiler.target>
     <surefire-version>3.1.2</surefire-version>
-    <checkstyle-plugin-version>3.3.0</checkstyle-plugin-version>
+    <checkstyle-plugin-version>3.6.0</checkstyle-plugin-version>
     <checkstyle-version>10.21.4</checkstyle-version>
-    <jacoco-plugin-version>0.8.10</jacoco-plugin-version>
+    <jacoco-plugin-version>0.8.12</jacoco-plugin-version>
     <compiler-plugin-version>3.14.0</compiler-plugin-version>
-    <java-source-version>21</java-source-version>
-    <java-target-version>21</java-target-version>
     <maven-enforcer-version>3.4.1</maven-enforcer-version>
     <maven-deploy-plugin-version>3.1.1</maven-deploy-plugin-version>
     <min-maven-version>3.5.0</min-maven-version>
@@ -89,9 +89,9 @@
       <version>24.2.0</version>
     </dependency>
     <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
-      <version>4.13.2</version>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <version>5.13.0-M2</version>
       <scope>test</scope>
     </dependency>
   </dependencies>
@@ -227,10 +227,6 @@
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-compiler-plugin</artifactId>
       <version>${compiler-plugin-version}</version>
-      <configuration>
-        <source>${java-source-version}</source>
-        <target>${java-target-version}</target>
-      </configuration>
     </plugin>
     <plugin>
       <groupId>org.apache.maven.plugins</groupId>

src/main/java/com/ibm/docling/HelloWorld.java

@@ -1,7 +1,11 @@
 package com.ibm.docling;
 
+import org.graalvm.polyglot.Context;
+
 public class HelloWorld {
 	public static void main(String[] args) {
-		System.out.println("Hello, World!");
+		try (Context context = Context.create()) {
+			context.eval("python", "print('Hello from GraalPy!')");
+		}
 	}
-}
+}

src/test/java/com/ibm/docling/GraalPyTest.java

@@ -0,0 +1,19 @@
+package com.ibm.docling;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.graalvm.polyglot.Context;
+import org.graalvm.polyglot.Value;
+
+public class GraalPyTest {
+
+    @Test
+    public void testMain() {
+        try (Context context = Context.newBuilder().allowAllAccess(true).build()) {
+			Value result = context.eval("python", "'Hello from GraalPy!'");
+            assertEquals("Hello from GraalPy!", result.asString());
+		}
+    }
+}