add Benchmark update & cleanup mise tasks

.editorconfig

@@ -16,3 +16,4 @@ max_line_length = 110
 [*.py]
 # checked by black
 indent_size = 4
+max_line_length = 120

.github/workflows/release.yml

@@ -24,14 +24,14 @@ jobs:
         with:
           persist-credentials: false
 
-      - name: Set Up JDK
-        uses: actions/setup-java@dded0888837ed1f317902acf8a20df0ad188d165 # v5
+      - uses: jdx/mise-action@be3be2260bc02bc3fbf94c5e2fed8b7964baf074 # v3.4.0
         with:
-          java-version: 21
-          distribution: temurin
+          version: v2025.11.1
+          sha256: d4bec11aeb5b13180c596b70abf59716acda20131dbc3df8b9146f97cecf645c
+          cache: false
 
-      - name: Build with Maven
-        run: ./scripts/build-release.sh
+      - name: Build release version
+        run: mise run build-release
         env:
           TAG: ${{ github.ref_name }}
 

.github/workflows/test-release-build.yml

@@ -27,8 +27,8 @@ jobs:
           key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
           restore-keys: |
             ${{ runner.os }}-maven-
-      - name: Run the Maven verify phase
-        run: ./scripts/build-release.sh
+      - name: Build release version
+        run: mise run build-release
         env:
           # don't ues the current snapshot version, to test a more realistic release
           TAG: ${{ github.run_number }}

.mise/tasks/build-release.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+#MISE description="Build release package"
+#USAGE arg "<tag>" env="TAG" default="1.5.0-SNAPSHOT"
+
+set -euo pipefail
+
+# shellcheck disable=SC2154 # is set by mise
+VERSION=${usage_tag#v}
+
+mise run set-version "$VERSION"
+mvn -B package -P 'release,!default' -Dmaven.test.skip=true

.mise/tasks/lint-bom.py

@@ -0,0 +1,120 @@
+#!/usr/bin/env python3
+
+# [MISE] description="Make sure the BOM has all necessary modules"
+
+import difflib
+import re
+import sys
+from fnmatch import fnmatch
+from pathlib import Path
+from typing import List
+
+ROOT = Path(__file__).resolve().parents[2]  # repo root (.. from .mise/tasks)
+IGNORE_DIRS = {"prometheus-metrics-parent"}
+MODULE_PREFIX = "prometheus-metrics"
+BOM_POM = ROOT / "prometheus-metrics-bom" / "pom.xml"
+
+
+def first_artifact_id(pom_file: Path) -> str:
+    """Return the second <artifactId> value from the given pom.xml (matches original script).
+
+    The original shell function greps all <artifactId> lines and returns the second one
+    (head -n 2 | tail -n 1). We replicate that behavior exactly.
+    """
+    if not pom_file.is_file():
+        raise FileNotFoundError(f"File {pom_file} does not exist.")
+
+    text = pom_file.read_text(encoding="utf-8")
+    matches = re.findall(r"<artifactId>\s*(.*?)\s*</artifactId>", text)
+    if len(matches) < 2:
+        return ""
+    return matches[1].strip()
+
+
+def add_dir(dir_path: Path, want: List[str]):
+    if not dir_path.is_dir():
+        raise FileNotFoundError(f"Directory {dir_path} does not exist.")
+
+    if any(dir_path.name == ig for ig in IGNORE_DIRS):
+        print(f"Skipping {dir_path}")
+        return
+
+    pom = dir_path / "pom.xml"
+    if not pom.is_file():
+        raise FileNotFoundError(f"File {pom} does not exist.")
+
+    artifact_id = first_artifact_id(pom)
+    if not artifact_id:
+        raise RuntimeError(f"No artifactId found in {pom}")
+
+    print(f"Found artifactId '{artifact_id}' in {pom}")
+    want.append(artifact_id)
+
+
+def collect_want(root: Path) -> List[str]:
+    want: List[str] = []
+    # top-level prometheus-metrics*
+    for entry in sorted(root.iterdir()):
+        if entry.is_dir() and fnmatch(entry.name, f"{MODULE_PREFIX}*"):
+            add_dir(entry, want)
+
+    # prometheus-metrics-tracer/prometheus-metrics*
+    tracer_dir = root / "prometheus-metrics-tracer"
+    if tracer_dir.is_dir():
+        for entry in sorted(tracer_dir.iterdir()):
+            if entry.is_dir() and fnmatch(entry.name, f"{MODULE_PREFIX}*"):
+                add_dir(entry, want)
+
+    # deduplicate and sort
+    want_unique = sorted(set(want))
+    return want_unique
+
+
+def collect_have(bom_pom: Path) -> List[str]:
+    if not bom_pom.is_file():
+        raise FileNotFoundError(f"BOM file {bom_pom} does not exist.")
+
+    text = bom_pom.read_text(encoding="utf-8")
+    # find artifactId values that start with MODULE_PREFIX
+    matches = re.findall(
+        r"<artifactId>\s*(%s[^<\s]*)\s*</artifactId>" % re.escape(MODULE_PREFIX), text
+    )
+    return sorted(matches)
+
+
+def main() -> int:
+    try:
+        want = collect_want(ROOT)
+        have = collect_have(BOM_POM)
+
+        want_text = "\n".join(want)
+        have_text = "\n".join(have)
+
+        if want_text != have_text:
+            print(
+                "The BOM file prometheus-metrics-bom/bom.xml does not match the current directory contents."
+            )
+            print("Expected:")
+            print(want_text)
+            print("Found:")
+            print(have_text)
+            print()
+            diff = difflib.unified_diff(
+                have_text.splitlines(keepends=True),
+                want_text.splitlines(keepends=True),
+                fromfile="found",
+                tofile="expected",
+            )
+            sys.stdout.writelines(diff)
+            return 1
+        else:
+            print("BOM file is up to date.")
+            return 0
+
+    except Exception as e:
+        print(e, file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

scripts/set-release-version-github-pages.sh → .mise/tasks/set-release-version-github-pages.sh

@@ -1,5 +1,7 @@
 #!/usr/bin/env bash
 
+#MISE description="Set release version in GitHub Pages quickstart.md"
+
 set -euox pipefail
 
 version=$(git tag -l | grep 'v' | sort | tail -1 | sed 's/v//')

.mise/tasks/set-version.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+#MISE description="Update version in all pom.xml files"
+#USAGE arg "<version>" help="new version"
+
+set -euo pipefail
+
+# replace all occurrences '<version>1.5.0-SNAPSHOT</version>' with
+# '<version>$usage_version</version>' in all pom.xml files in the current directory and
+# subdirectories
+
+# shellcheck disable=SC2154 # is set by mise
+find . -name 'pom.xml' -exec \
+	sed -i "s/<version>1.5.0-SNAPSHOT<\/version>/<version>$usage_version<\/version>/g" {} +

scripts/super-linter.sh → .mise/tasks/super-linter.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 
-set -euo pipefail
+#MISE description="Run GitHub Super Linter on the repository"
 
-pushd "$(dirname "$0")/.."
+set -euo pipefail
 
 docker pull ghcr.io/super-linter/super-linter:latest
 
@@ -12,5 +12,3 @@ docker run --rm \
 	--env-file ".github/super-linter.env" \
 	-v "$(pwd)":/tmp/lint \
 	ghcr.io/super-linter/super-linter:latest
-
-popd

.mise/tasks/test_update-benchmarks.py

@@ -0,0 +1,98 @@
+import os
+import re
+import sys
+import tempfile
+import unittest
+
+from update_benchmarks import update_pre_blocks_under_module
+
+# Ensure the tasks directory is importable when running the test directly
+here = os.path.dirname(__file__)
+if here not in sys.path:
+    sys.path.insert(0, here)
+
+
+class TestRunBenchmarksFiltering(unittest.TestCase):
+    def setUp(self):
+        # sample JMH table with mixed-class lines
+        self.table = (
+            "Benchmark                                             Mode  Cnt       Score   Error  Units\n"
+            "CounterBenchmark.codahaleIncNoLabels                 thrpt        57881.585          ops/s\n"
+            "HistogramBenchmark.prometheusNative                  thrpt         2385.134          ops/s\n"
+            "TextFormatUtilBenchmark.prometheusWriteToNull        thrpt       885331.328          ops/s\n"
+            "CounterBenchmark.prometheusInc                       thrpt        54090.469          ops/s\n"
+        )
+
+        # create temp dir to act as module path
+        self.tmpdir = tempfile.TemporaryDirectory()
+        self.module_path = self.tmpdir.name
+
+        # Create three files with a javadoc <pre> block that contains mixed results
+        self.files = {}
+        javadoc_pre = (
+            "/**\n"
+            " * Example javadoc\n"
+            " * <pre>\n"
+            " * Benchmark                                             Mode  Cnt       Score   Error  Units\n"
+            " * CounterBenchmark.codahaleIncNoLabels                 thrpt        57881.585          ops/s\n"
+            " * HistogramBenchmark.prometheusNative                  thrpt         2385.134          ops/s\n"
+            " * TextFormatUtilBenchmark.prometheusWriteToNull        thrpt       885331.328          ops/s\n"
+            " * CounterBenchmark.prometheusInc                       thrpt        54090.469          ops/s\n"
+            " * </pre>\n"
+            " */\n"
+        )
+
+        for cls in (
+            "CounterBenchmark",
+            "HistogramBenchmark",
+            "TextFormatUtilBenchmark",
+        ):
+            fname = os.path.join(self.module_path, f"{cls}.java")
+            with open(fname, "w", encoding="utf-8") as f:
+                f.write(javadoc_pre)
+                f.write(f"public class {cls} {{}}\n")
+            self.files[cls] = fname
+
+    def tearDown(self):
+        self.tmpdir.cleanup()
+
+    def _read_pre_contents(self, path):
+        with open(path, "r", encoding="utf-8") as f:
+            content = f.read()
+        m = re.search(r"<pre>\n([\s\S]*?)</pre>", content)
+        return m.group(1) if m else ""
+
+    def test_update_only_inserts_matching_class_lines(self):
+        updated = update_pre_blocks_under_module(self.module_path, self.table)
+        # All three files should be updated
+        self.assertEqual(
+            set(os.path.basename(p) for p in updated),
+            {
+                os.path.basename(self.files["CounterBenchmark"]),
+                os.path.basename(self.files["HistogramBenchmark"]),
+                os.path.basename(self.files["TextFormatUtilBenchmark"]),
+            },
+        )
+
+        # Verify CounterBenchmark file contains only CounterBenchmark lines
+        cb_pre = self._read_pre_contents(self.files["CounterBenchmark"])
+        self.assertIn("CounterBenchmark.codahaleIncNoLabels", cb_pre)
+        self.assertIn("CounterBenchmark.prometheusInc", cb_pre)
+        self.assertNotIn("HistogramBenchmark.prometheusNative", cb_pre)
+        self.assertNotIn("TextFormatUtilBenchmark.prometheusWriteToNull", cb_pre)
+
+        # Verify HistogramBenchmark contains only its line
+        hb_pre = self._read_pre_contents(self.files["HistogramBenchmark"])
+        self.assertIn("HistogramBenchmark.prometheusNative", hb_pre)
+        self.assertNotIn("CounterBenchmark.codahaleIncNoLabels", hb_pre)
+        self.assertNotIn("TextFormatUtilBenchmark.prometheusWriteToNull", hb_pre)
+
+        # Verify TextFormatUtilBenchmark contains only its line
+        tf_pre = self._read_pre_contents(self.files["TextFormatUtilBenchmark"])
+        self.assertIn("TextFormatUtilBenchmark.prometheusWriteToNull", tf_pre)
+        self.assertNotIn("CounterBenchmark.prometheusInc", tf_pre)
+        self.assertNotIn("HistogramBenchmark.prometheusNative", tf_pre)
+
+
+if __name__ == "__main__":
+    unittest.main()