feat: support CLI tool to install clang tools wheels

Author: shenxianpeng

README.md

@@ -72,6 +72,35 @@ repos:
         args: [--checks=.clang-tidy, --version=21] # Specifies version
 ```
 
+### Clang Tool Wheel CLI
+
+This package also provides a CLI tool `clang-tools-wheel` to install specific versions of clang-format and clang-tidy wheels directly.
+
+It can automatically resolve and install compatible versions even if no explicit version number is provided.
+
+```bash
+# Install the package
+pip install cpp-linter-hooks
+
+# Install specific version of clang-format
+clang-tools-wheel --tool clang-format --version 21
+clang-format installed at: /home/sxp/.local/bin/clang-format
+
+# Check clang-format version
+/home/sxp/.local/bin/clang-format --version
+clang-format version 21.1.2
+
+# Install specific version of clang-tidy
+clang-tools-wheel --tool clang-tidy --version 21
+clang-tidy installed at: /home/sxp/.local/bin/clang-tidy
+
+# Check clang-tidy version
+/home/sxp/.local/bin/clang-tidy --version
+LLVM (http://llvm.org/):
+  LLVM version 21.1.1
+  Optimized build.
+```
+
 ## Output
 
 ### clang-format Output

cpp_linter_hooks/util.py

@@ -1,6 +1,7 @@
 import sys
 import shutil
 import subprocess
+from argparse import ArgumentParser
 from pathlib import Path
 import logging
 from typing import Optional, List
@@ -86,3 +87,21 @@ def _resolve_install(tool: str, version: Optional[str]) -> Optional[Path]:
         )
 
     return _install_tool(tool, user_version)
+
+
+def main():
+    parser = ArgumentParser("Install specified clang tool wheel")
+    parser.add_argument("--tool", default="clang-format")
+    parser.add_argument("--version", default=None)
+    args = parser.parse_args()
+    path = _resolve_install(args.tool, args.version)
+    if path:
+        print(f"{args.tool} installed at: {path}")
+        return 0
+    else:
+        print(f"Failed to install {args.tool} version {args.version}")
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

pyproject.toml

@@ -40,6 +40,7 @@ dependencies = [
 dynamic = ["version"]
 
 [project.scripts]
+clang-tools-wheel = "cpp_linter_hooks.util:main"
 clang-format-hook = "cpp_linter_hooks.clang_format:main"
 clang-tidy-hook = "cpp_linter_hooks.clang_tidy:main"