. e move to Mise

Author: JayBazuzi

.github/workflows/test-ea.yml

@@ -11,24 +11,17 @@ jobs:
 
     steps:
     - uses: actions/checkout@v5
-    - uses: actions/[email protected]
-      with:
-        path: ~/.m2/repository
-        key: ubuntu-maven-${{ hashFiles('**/pom.xml') }}
-        restore-keys: |
-          ubuntu-maven-
-    - name: Set up JDK21
-      uses: actions/setup-java@v5
-      with:
-        distribution: 'zulu'
-        java-version: 21
+    - uses: jdx/mise-action@v2
+    - name: Set Java version for building (JDK 21)
+      run: echo "21" > .java-version
+      shell: bash
     - name: Turn off formatting
-      run: |
-        ./set_formatting_off.sh
-    - name: Build with Maven
-      run: |
-        mvn -B install --file pom.xml
-    - name: Set up JDK8
+      run: ./set_formatting_off.sh
+      shell: bash
+    - name: Build with Mise
+      run: ./build_and_test.sh
+      shell: bash
+    - name: Set up JDK8 for runtime testing
       uses: actions/setup-java@v5
       with:
         distribution: 'zulu'

.github/workflows/test-jdk-8.yml

@@ -30,18 +30,11 @@ jobs:
 
     steps:
     - uses: actions/checkout@v5
-    - uses: actions/[email protected]
-      with:
-        path: ~/.m2/repository
-        key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
-        restore-keys: |
-          ${{ runner.os }}-maven-
-    - name: Set up JDK
-      uses: actions/setup-java@v5
-      with:
-        distribution: 'zulu'
-        java-version: ${{ matrix.java }}
-    - name: Build with Maven
+    - uses: jdx/mise-action@v2
+    - name: Set Java version for matrix testing
+      run: echo "${{ matrix.java }}" > .java-version
+      shell: bash
+    - name: Build and Test
       run: |
         ./set_formatting_off.sh
         ./build_and_test.sh

.github/workflows/test.yml

@@ -0,0 +1 @@
+17

.java-version

@@ -0,0 +1,11 @@
+[tools]
+maven = "latest"
+dotnet = "latest"
+
+[tasks]
+build_and_test = "mvn --quiet -B verify --file pom.xml"
+format = "mvn --quiet formatter:format"
+
+[settings]
+# we put the java version in the .java-version file instead of here so that it's easy to override in the CI matrix
+idiomatic_version_file_enable_tools = ["java"]

.mise.toml

@@ -1,3 +1,2 @@
 @echo off
-
-call mvn -B verify --file pom.xml
+"C:\Program Files\Git\bin\bash.exe" build_and_test.sh

build_and_test.cmd

@@ -1,34 +1,10 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-TMP_OUTPUT=$(mktemp)
-if mvn -B verify --file pom.xml > "$TMP_OUTPUT" 2>&1; then
-  # Extract the number of tests run from Maven output
-  TESTS_TOTAL=$(awk '
-    /Results:/ {
-      for(i=0;i<3;i++) {
-        if(getline>0) {
-          if($0 ~ /Tests run: [0-9]+/) {
-            line = $0
-            sub(/.*Tests run: /, "", line)
-            sub(/[^0-9].*$/, "", line)
-            sum += line
-            break
-          }
-        }
-      }
-    }
-    END {print sum}' "$TMP_OUTPUT")
-  
-  # Count unique Maven warnings
-  WARNING_COUNT=$(grep -E "^\[WARNING\]" "$TMP_OUTPUT" | sort -u | wc -l | tr -d ' ')
-  
-  echo "✅ Built: $TESTS_TOTAL tests passed, $WARNING_COUNT unique Maven warnings."
-  EXIT_CODE=0
-else
-  cat "$TMP_OUTPUT"
-  echo "❌ Build failed."
-  EXIT_CODE=1
+# Check if Mise is available
+if ! command -v mise &> /dev/null; then
+    echo "❌ Mise is required but not installed. Please install Mise: https://mise.jdx.dev/"
+    exit 1
 fi
-rm "$TMP_OUTPUT"
-exit $EXIT_CODE
+
+mise task run build_and_test

build_and_test.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+mise task run format

format_code.sh

@@ -0,0 +1,54 @@
+# Repo Setup
+
+## Concept
+
+These are the basic dev scripts that every repo should have. They provide a standardized interface for common development tasks that works across different platforms and environments.
+
+The underlying tool is Mise-en-Place, aka "Mise" (https://mise.jdx.dev/), which manages tools and tasks within the project scope without requiring system-wide installations.
+
+The idea is that you can clone a repo on a clean machine, then run one of these scripts, and it will just work (assuming Mise is already installed).
+
+## Prerequisites
+
+1. **Mise** - The only system requirement. All other tools are managed by Mise per-project.
+
+Mise automatically:
+- Installs required tools (defined in `.mise.toml`)
+- Creates and manages virtual environments  
+- Handles dependencies
+- Runs tasks with proper environment setup
+
+## Implemented Scripts
+
+### Core Scripts
+
+1. **`build_and_test.sh/.cmd`** - Runs the full build pipeline including tests, type checking, linting, and integration tests
+2. **`format_code.sh`** - Formats code using configured formatters
+3. **`run_mdsnippets.sh/.cmd`** - Updates markdown documentation with code snippets
+
+### Script Implementation Details
+
+Prefer to name scripts and tasks using `snake_case`.
+
+**Bash Scripts (.sh):**
+- Include error handling (`set -euo pipefail`)
+- Check for Mise availability with helpful error messages
+- Use `mise task run` to execute configured tasks
+- Support parallel task execution where appropriate
+
+**Windows Scripts (.cmd):**
+- Use Git Bash to execute the corresponding `.sh` file
+- Provide cross-platform compatibility without duplicating logic
+
+### Configuration
+
+Tasks are defined in `.mise.toml`.
+
+**Tool Version Management:**
+- Use idiomatic version files (e.g., `.java-version`, `.python-version`) for language runtimes to enable easy overrides in CI matrix testing
+- Configure `idiomatic_version_file_enable_tools` in `.mise.toml` to automatically detect these version files
+- This allows testing against multiple language versions without modifying the main configuration
+
+**CI Integration:**
+- CI workflows can override tool versions by writing to the version files before running tasks (e.g., `echo "11" > .java-version`)
+- Use matrix builds to test multiple versions: each matrix job writes its target version to the appropriate file