Draft: Migrate to Kotlin, refactor, upgrade libraries, add Texy, add Maven build, add end-to-end tests, replace OrientDB with HSQLDB (Neo4j WIP)

.dependabot/config.yml

@@ -1,8 +1,19 @@
 version: 1
 update_configs:
+
   - package_manager: "java:gradle"
     directory: "/jbake-core"
-    update_schedule: "daily"
+    update_schedule: "monthly"
+
   - package_manager: "java:gradle"
     directory: "/jbake-dist"
-    update_schedule: "daily"
+    update_schedule: "monthly"
+
+  - package_manager: "java:maven"
+    directory: "/jbake-core"
+    update_schedule: "monthly"
+
+  - package_manager: "java:maven"
+    directory: "/jbake-dist"
+    update_schedule: "monthly"
+

.editorconfig

@@ -6,4 +6,7 @@ end_of_line = lf
 insert_final_newline = true
 trim_trailing_whitespace = true
 indent_style = space
-indent_size = 4
+indent_size = 4
+
+[AsciidocParserTest.kt]
+trim_trailing_whitespace = false

.github/workflows/build.yml

@@ -13,36 +13,36 @@ jobs:
         runs-on: ${{ matrix.os }}
 
         steps:
-            - uses: actions/checkout@v2
+            - uses: actions/checkout@v5
 
             - name: Set up Java
-              uses: actions/setup-java@v2
+              uses: actions/setup-java@v5
               with:
-                  java-version: 11
+                  java-version: 17
                   distribution: 'zulu'
 
-            - uses: actions/cache@v2
+            - uses: actions/cache@v4
               with:
                   path: ~/.gradle/caches
                   key: ${{ runner.os }}-gradle-cache-${{ hashFiles('**/*.gradle') }}-${{ hashFiles('**/gradle.properties') }}
                   restore-keys: |
                       ${{ runner.os }}-gradle-
-            - uses: actions/cache@v2
+            - uses: actions/cache@v4
               with:
                   path: ~/.gradle/wrapper
                   key: ${{ runner.os }}-gradle-wrapper-${{ hashFiles('**/gradlew') }}
                   restore-keys: |
                       ${{ runner.os }}-gradlew-
-            - name: Build-win
+            - name: Build-windows
               if: runner.os == 'Windows'
               shell: cmd
               run: gradlew.bat -Dfile.encoding=UTF-8 build -S
-            - name: Build-nix
+            - name: Build-linux
               if: runner.os != 'Windows'
               run: ./gradlew build -S
 
             - name: Upload Reports
-              uses: actions/upload-artifact@v1
+              uses: actions/upload-artifact@v4
               if: failure()
               with:
                   name: reports-${{ runner.os }}

.github/workflows/early-access.yml

@@ -12,23 +12,23 @@ jobs:
 
         steps:
             - name: Checkout
-              uses: actions/checkout@v2
+              uses: actions/checkout@v5
               with:
                   fetch-depth: 0
 
             - name: Set up Java
-              uses: actions/setup-java@v2
+              uses: actions/setup-java@v5
               with:
                   java-version: 11
                   distribution: 'zulu'
 
-            - uses: actions/cache@v2
+            - uses: actions/cache@v4
               with:
                   path: ~/.gradle/caches
                   key: ${{ runner.os }}-gradle-cache-${{ hashFiles('**/*.gradle') }}-${{ hashFiles('**/gradle.properties') }}
                   restore-keys: |
                       ${{ runner.os }}-gradle-
-            - uses: actions/cache@v2
+            - uses: actions/cache@v4
               with:
                   path: ~/.gradle/wrapper
                   key: ${{ runner.os }}-gradle-wrapper-${{ hashFiles('**/gradlew') }}
@@ -49,7 +49,7 @@ jobs:
 
             - name: JReleaser output
               if: always()
-              uses: actions/upload-artifact@v2
+              uses: actions/upload-artifact@v4
               with:
                   name: jreleaser-logs
                   path: |

.github/workflows/maven-build.yml

@@ -0,0 +1,47 @@
+name: Maven Tests
+
+on:
+    push:
+        branches: [ "*" ]
+    pull_request:
+
+jobs:
+    build:
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Check out repository
+              uses: actions/checkout@v5
+
+            - name: Set up JDK
+              uses: actions/setup-java@v5
+              with:
+                  java-version: '17'
+                  distribution: 'temurin'
+
+            - name: Cache Maven repository
+              uses: actions/cache@v4
+              with:
+                  path: ~/.m2/repository
+                  key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
+                  restore-keys: |
+                      ${{ runner.os }}-m2-
+
+            - name: Run Maven tests
+              run: mvn -B clean install
+
+            - name: Upload test reports
+              if: always()
+              uses: actions/upload-artifact@v4
+              with:
+                  path: |
+                      **/target/surefire-reports/*
+                      **/target/failsafe-reports/*
+
+            - name: Publish Test Results
+              uses: EnricoMi/[email protected]
+              with:
+                  check_name: 'Maven Tests'
+                  files: |
+                      **/target/surefire-reports/*.xml
+                      **/target/failsafe-reports/*.xml

.github/workflows/qodana_code_quality.yml

@@ -0,0 +1,42 @@
+#-------------------------------------------------------------------------------#
+#            Discover all capabilities of Qodana in our documentation           #
+#             https://www.jetbrains.com/help/qodana/about-qodana.html           #
+#-------------------------------------------------------------------------------#
+
+name: Qodana
+on:
+    workflow_dispatch:
+    pull_request:
+    push:
+        branches:
+            - master
+            - kotlin-upgraded
+
+jobs:
+    qodana:
+        if: false  # Disabled
+        runs-on: ubuntu-latest
+        permissions:
+            contents: write
+            pull-requests: write
+            checks: write
+        steps:
+            -   uses: actions/checkout@v5
+                with:
+                    ref: ${{ github.event.pull_request.head.sha }}
+                    fetch-depth: 0
+            -   name: 'Qodana Scan'
+                uses: JetBrains/[email protected]
+                env:
+                    QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
+                    project.open.type: Gradle
+                with:
+                    # When pr-mode is set to true, Qodana analyzes only the files that have been changed
+                    pr-mode: false
+                    use-caches: true
+                    post-pr-comment: true
+                    use-annotations: true
+                    # Upload Qodana results (SARIF, other artifacts, logs) as an artifact to the job
+                    upload-result: false
+                    # Quick-fixes available in Ultimate and Ultimate Plus plans
+                    push-fixes: 'none'

.gitignore

@@ -2,6 +2,7 @@
 .project
 /.settings
 /target
+**/target
 /bin
 /dist
 /.idea
@@ -12,3 +13,7 @@
 build/
 .gradle
 .gradletasknamecache
+/docs/kotlin-migration-line-analysis/*
+dependency-reduced-pom.xml
+pom.xml.versionsBackup
+.flattened-pom.xml

.mvn/extensions.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<extensions>
+
+    <extension><groupId>org.apache.maven.extensions</groupId><artifactId>maven-build-cache-extension</artifactId><version>1.2.1</version></extension>
+
+    <!-- Usage: Add `-Dprofile` -->
+    <extension><groupId>fr.jcgay.maven</groupId><artifactId>maven-profiler</artifactId><version>3.3</version></extension>
+
+    <!--
+    Obsolete?
+    <extension> <groupId>io.takari.maven</groupId> <artifactId>maven-profiler</artifactId> <version>1.1.0</version> </extension>
+    -->
+
+</extensions>

.mvn/jvm.config

@@ -0,0 +1,10 @@
+--add-opens=java.base/java.lang=ALL-UNNAMED
+--add-opens=java.base/java.io=ALL-UNNAMED
+-XX:-UseParallelGC
+-XX:+UseStringDeduplication
+-XX:+UseLargePages
+-XX:+OptimizeStringConcat
+-XX:G1HeapWastePercent=20
+
+-XX:+UnlockExperimentalVMOptions
+-XX:+EnableJVMCI

.mvn/maven-build-cache-config.xml

@@ -0,0 +1,77 @@
+<!--
+  Maven Build Cache configuration for JBake.
+  https://maven.apache.org/extensions/maven-build-cache-extension/
+
+  Enable with: <enabled>true</enabled>
+  Disable with: <enabled>false</enabled> or -Dmaven.build.cache.enabled=false
+-->
+<cache xmlns="http://maven.apache.org/BUILD-CACHE-CONFIG/1.2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xsi:schemaLocation="http://maven.apache.org/BUILD-CACHE-CONFIG/1.2.0 https://maven.apache.org/xsd/build-cache-config-1.2.0.xsd">
+
+    <configuration>
+        <enabled>false</enabled>
+        <local>
+            <maxBuildsCached>5</maxBuildsCached>
+        </local>
+        <projectVersioning adjustMetaInf="true"/>
+    </configuration>
+
+    <input>
+        <global>
+            <includes>
+                <include>**/src/**</include>
+                <include>pom.xml</include>
+                <include>**/pom.xml</include>
+            </includes>
+            <excludes>
+                <!-- Exclude generated/temporary files -->
+                <exclude>**/target/**</exclude>
+                <exclude>**/.flattened-pom.xml</exclude>
+            </excludes>
+        </global>
+    </input>
+
+    <executionControl>
+        <runAlways>
+            <plugins>
+                <!-- Integration tests should always run -->
+                <plugin artifactId="maven-failsafe-plugin"/>
+                <!-- Shade plugin creates uber-jar, should always run to ensure fresh build -->
+                <plugin artifactId="maven-shade-plugin"/>
+            </plugins>
+            <goalsLists>
+                <goalsList artifactId="maven-install-plugin"><goals><goal>install</goal></goals></goalsList>
+                <goalsList artifactId="maven-deploy-plugin"><goals><goal>deploy</goal></goals></goalsList>
+            </goalsLists>
+        </runAlways>
+        <reconcile logAllProperties="true">
+            <plugins>
+                <plugin artifactId="maven-compiler-plugin" goal="compile">
+                    <reconciles>
+                        <reconcile propertyName="source"/>
+                        <reconcile propertyName="target"/>
+                        <reconcile propertyName="debug"/>
+                        <reconcile propertyName="debuglevel"/>
+                    </reconciles>
+                    <logs>
+                        <log propertyName="includes"/>
+                        <log propertyName="excludes"/>
+                    </logs>
+                </plugin>
+                <plugin artifactId="kotlin-maven-plugin" goal="compile">
+                    <reconciles>
+                        <reconcile propertyName="jvmTarget"/>
+                        <reconcile propertyName="languageVersion"/>
+                        <reconcile propertyName="apiVersion"/>
+                    </reconciles>
+                </plugin>
+                <plugin artifactId="duplicate-finder-maven-plugin" goal="check">
+                    <reconciles>
+                        <reconcile propertyName="skip" skipValue="true"/>
+                        <reconcile propertyName="quiet" skipValue="true"/>
+                    </reconciles>
+                </plugin>
+            </plugins>
+        </reconcile>
+    </executionControl>
+</cache>

.mvn/maven-version-rules.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ruleset comparisonMethod="maven"
+         xmlns="http://mojo.codehaus.org/versions-maven-plugin/rule/2.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://mojo.codehaus.org/versions-maven-plugin/rule/2.0.0
+                             https://www.mojohaus.org/versions/versions-model/xsd/rule-2.0.0.xsd">
+
+    <!-- Ignore pre-release versions globally -->
+    <ignoreVersions>
+        <ignoreVersion type="regex">.*[-_.](?i)(alpha|beta|rc|milestone|m[0-9]+|preview|pre|ea|cr|snapshot).*</ignoreVersion>
+    </ignoreVersions>
+
+</ruleset>