Refactor .clang-tidy configuration for improved readability and update local build script to support versioned clang-tidy binaries

Author: MAminSFV

example_repo/.clang-tidy

@@ -1,8 +1,8 @@
 Checks: "-*,eigen-avoid-auto"
 CheckOptions:
-	- key: eigen-avoid-auto.AllowInRangeFor
-		value: "false"
-	- key: eigen-avoid-auto.OnlyExpressions
-		value: "false"
-	- key: eigen-avoid-auto.BanDecltypeAuto
-		value: "true"
+  - key: eigen-avoid-auto.AllowInRangeFor
+    value: "false"
+  - key: eigen-avoid-auto.OnlyExpressions
+    value: "false"
+  - key: eigen-avoid-auto.BanDecltypeAuto
+    value: "true"

tools/test_example_repo_local_build.sh

@@ -26,9 +26,28 @@ EXAMPLE_BUILD_DIR="$EXAMPLE_DIR/build"
 cmake -S "$EXAMPLE_DIR" -B "$EXAMPLE_BUILD_DIR"
 cmake --build "$EXAMPLE_BUILD_DIR" --target example_repo -- -j"$(nproc)"
 
-CLANG_TIDY_BIN=${CLANG_TIDY:-clang-tidy}
-if ! command -v "$CLANG_TIDY_BIN" >/dev/null 2>&1; then
-    echo "clang-tidy executable '$CLANG_TIDY_BIN' not found in PATH" >&2
+CLANG_TIDY_BIN=${CLANG_TIDY:-}
+if [[ -z "$CLANG_TIDY_BIN" ]]; then
+    if command -v clang-tidy >/dev/null 2>&1; then
+        CLANG_TIDY_BIN=$(command -v clang-tidy)
+    else
+        shopt -s nullglob
+        IFS=: read -r -a path_dirs <<< "$PATH"
+        versioned_bins=()
+        for dir in "${path_dirs[@]}"; do
+            for candidate in "$dir"/clang-tidy-[0-9]*; do
+                [[ -x "$candidate" ]] && versioned_bins+=("$candidate")
+            done
+        done
+        shopt -u nullglob
+        if [[ ${#versioned_bins[@]} -gt 0 ]]; then
+            CLANG_TIDY_BIN=$(printf '%s\n' "${versioned_bins[@]}" | sort -V | tail -n1)
+        fi
+    fi
+fi
+
+if [[ -z "$CLANG_TIDY_BIN" || ! -x "$CLANG_TIDY_BIN" ]]; then
+    echo "clang-tidy executable not found in PATH" >&2
     exit 1
 fi