feat: support install python wheels

Author: shenxianpeng

README.rst

@@ -1,7 +1,7 @@
 clang-tools CLI
 ===============
 
-**Install clang-format, clang-tidy, clang-query, and clang-apply-replacements binaries with clang-tools CLI.**
+**Install clang-format, clang-tidy, clang-query, and clang-apply-replacements binaries and Python wheels with clang-tools CLI.**
 
 .. |latest-version| image:: https://img.shields.io/pypi/v/clang-tools?color=blue
     :target: https://pypi.org/project/clang-tools/
@@ -29,6 +29,8 @@ clang-tools CLI
     are installed using this package's executable script. It does not intend to change or
     modify any binary executable installed from other sources (like LLVM releases).
 
+    For Python wheels, this CLI only support clang-format and clang-tidy tools.
+
 Features
 --------
 

clang_tools/wheel.py

@@ -0,0 +1,29 @@
+from argparse import ArgumentParser
+from cpp_linter_hooks.util import _resolve_install
+
+
+def main() -> int:
+    parser = ArgumentParser(description="Install specified clang tool wheel")
+    parser.add_argument(
+        "--tool",
+        default="clang-format",
+        choices=["clang-format", "clang-tidy"],
+        help="Tool to install (clang-format or clang-tidy)",
+    )
+    parser.add_argument(
+        "--version",
+        default=None,
+        help="Version to install (e.g., 21 or 21.1.2). Defaults to latest compatible version.",
+    )
+    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

@@ -30,10 +30,17 @@ classifiers = [
     "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Build Tools",
 ]
+
+dependencies = [
+    "cpp-linter-hooks>=1.1.6",
+]
+
 dynamic = ["version"]
 
 [project.scripts]
 clang-tools = "clang_tools.main:main"
+clang-tools-binary = "clang_tools.main:main"
+clang-tools-wheel = "clang_tools.wheel:main"
 
 [project.urls]
 source =  "https://github.com/cpp-linter/clang-tools-pip"

tests/test_wheel.py

@@ -0,0 +1,38 @@
+import sys
+from clang_tools.wheel import main
+
+
+def test_main_success(monkeypatch):
+    # Patch _resolve_install to simulate success
+    monkeypatch.setattr(
+        "clang_tools.wheel._resolve_install",
+        lambda tool, version: "/usr/bin/clang-format",
+    )
+    monkeypatch.setattr(
+        sys, "argv", ["util.py", "--tool", "clang-format", "--version", "15.0.7"]
+    )
+    exit_code = main()
+    assert exit_code == 0
+
+
+def test_main_failure(monkeypatch):
+    # Patch _resolve_install to simulate failure
+    monkeypatch.setattr(
+        "clang_tools.wheel._resolve_install", lambda tool, version: None
+    )
+    monkeypatch.setattr(
+        sys, "argv", ["util.py", "--tool", "clang-format", "--version", "99.99.99"]
+    )
+    exit_code = main()
+    assert exit_code == 1
+
+
+def test_main_default_tool(monkeypatch):
+    # Patch _resolve_install to simulate success for default tool
+    monkeypatch.setattr(
+        "clang_tools.wheel._resolve_install",
+        lambda tool, version: "/usr/bin/clang-format",
+    )
+    monkeypatch.setattr(sys, "argv", ["util.py"])
+    exit_code = main()
+    assert exit_code == 0