Introduce benchmarking of different LMDB versions

Author: bp-alex

.github/workflows/maven.yml

@@ -25,19 +25,25 @@ jobs:
     - name: Build with Maven
       run: mvn -B verify
 
-    - name: Install gnuplot for report generation
-      run: sudo apt-get update && sudo apt-get install -y gnuplot
+    - name: Install dependencies for report generation
+      run: sudo apt-get update && sudo apt-get install -y gnuplot jq
 
-    - name: Run smoketest benchmarks
+    - name: Run library comparison smoketest
       run: ./run-libs.sh smoketest
 
-    - name: Generate benchmark report
-      run: ./report.sh
+    - name: Generate library comparison report
+      run: ./report-libs.sh
 
-    - name: Upload benchmark results
+    - name: Run version regression smoketest
+      run: ./run-vers.sh smoketest
+
+    - name: Generate version regression report
+      run: ./report-vers.sh
+
+    - name: Upload all benchmark results
       uses: actions/upload-artifact@v4
       if: always()
       with:
-        name: benchmark-smoketest-results
+        name: benchmark-results
         path: target/benchmark/
         retention-days: 7

.gitignore

@@ -1,5 +1,6 @@
 target
 bin
+work
 .classpath
 .project
 .settings

README.md

@@ -83,6 +83,19 @@ The benchmark auto-scales based on available RAM and caps at 1 million entries.
 Results are written to `target/benchmark/out-libs-1.json` through `target/benchmark/out-libs-6.json`
 along with human-readable logs in `target/benchmark/out-libs-1.txt` through `target/benchmark/out-libs-6.txt`.
 
+#### Version Regression Testing
+
+Use the `run-vers.sh` script to test LmdbJava performance across versions:
+
+```bash
+# Quick smoke test (1K entries, fast verification)
+./run-vers.sh smoketest
+
+# Full benchmark using 25% of system RAM (default)
+./run-vers.sh benchmark
+```
+
+This tests selected LmdbJava versions from Maven Central plus current development branches to identify performance regressions.
 
 ### Generating Reports
 
@@ -92,6 +105,8 @@ After running library comparison benchmarks, generate a comprehensive report:
 ./report-libs.sh
 ```
 
+After running version regression tests, generate a version comparison report:
+
 ```bash
 ./report-vers.sh
 ```