feat: support clang-format v21 (#97)

* feat: support clang v21

* feat: bump version to 1.1.0

* fix: add version 20.1.7 back

* docs: update readme and migration notes

* docs: update defacult version

* fix: clang-tidy does not support v21

* chore: update failed case number

Author: shenxianpeng

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -14,7 +14,7 @@ repos:
     hooks:
       - id: pyupgrade
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.12.2
+    rev: v0.12.11
     hooks:
       - id: ruff
       - id: ruff-format

README.md

@@ -31,7 +31,7 @@ Add this configuration to your `.pre-commit-config.yaml` file:
 ```yaml
 repos:
   - repo: https://github.com/cpp-linter/cpp-linter-hooks
-    rev: v1.0.1  # Use the tag or commit you want
+    rev: v1.1.0  # Use the tag or commit you want
     hooks:
       - id: clang-format
         args: [--style=Google] # Other coding style: LLVM, GNU, Chromium, Microsoft, Mozilla, WebKit.
@@ -46,7 +46,7 @@ To use custom configurations like `.clang-format` and `.clang-tidy`:
 ```yaml
 repos:
   - repo: https://github.com/cpp-linter/cpp-linter-hooks
-    rev: v1.0.1
+    rev: v1.1.0
     hooks:
       - id: clang-format
         args: [--style=file]  # Loads style from .clang-format file
@@ -61,7 +61,7 @@ To use specific versions of clang-format and clang-tidy (using Python wheel pack
 ```yaml
 repos:
   - repo: https://github.com/cpp-linter/cpp-linter-hooks
-    rev: v1.0.1
+    rev: v1.1.0
     hooks:
       - id: clang-format
         args: [--style=file, --version=18] # Specifies version
@@ -70,7 +70,7 @@ repos:
 ```
 
 > [!NOTE]
-> Starting from version v1.0.0, this package uses Python wheel packages ([clang-format](https://pypi.org/project/clang-format/) and [clang-tidy](https://pypi.org/project/clang-tidy/)) instead of the previous clang-tools binaries. The wheel packages provide better cross-platform compatibility and easier installation. For more details, see the [Migration Guide](MIGRATION.md).
+> Starting from version **v1.0.0**, this pre-commit hook now relies on Python wheel packages — [clang-format](https://pypi.org/project/clang-format/) and [clang-tidy](https://pypi.org/project/clang-tidy/) — instead of the [clang-tools binaries](https://github.com/cpp-linter/clang-tools-static-binaries). The wheel packages are lighter, easier to install, and offer better cross-platform compatibility. For more information, see the [detailed migration notes](docs/migration-notes.md).
 
 ## Output
 
@@ -147,17 +147,17 @@ Use -header-filter=.* to display errors from all non-system headers. Use -system
 ### Performance Optimization
 
 > [!TIP]
-> If your `pre-commit` runs longer than expected, it is highly recommended to add `files` in `.pre-commit-config.yaml` to limit the scope of the hook. This helps improve performance by reducing the number of files being checked and avoids unnecessary processing. Here's an example configuration:
+> For large codebases, if your `pre-commit` runs longer than expected, it is highly recommended to add `files` in `.pre-commit-config.yaml` to limit the scope of the hook. This helps improve performance by reducing the number of files being checked and avoids unnecessary processing. Here's an example configuration:
 
 ```yaml
 - repo: https://github.com/cpp-linter/cpp-linter-hooks
-  rev: v1.0.1
+  rev: v1.1.0
   hooks:
     - id: clang-format
-      args: [--style=file, --version=18]
+      args: [--style=file, --version=20]
       files: ^(src|include)/.*\.(cpp|cc|cxx|h|hpp)$ # Limits to specific dirs and file types
     - id: clang-tidy
-      args: [--checks=.clang-tidy, --version=18]
+      args: [--checks=.clang-tidy, --version=20]
       files: ^(src|include)/.*\.(cpp|cc|cxx|h|hpp)$
 ```
 
@@ -177,7 +177,7 @@ This approach ensures that only modified files are checked, further speeding up
 ```yaml
 repos:
   - repo: https://github.com/cpp-linter/cpp-linter-hooks
-    rev: v1.0.1
+    rev: v1.1.0
     hooks:
       - id: clang-format
         args: [--style=file, --version=18, --verbose]   # Add -v or --verbose for detailed output

cpp_linter_hooks/util.py

@@ -103,6 +103,8 @@ def get_version_from_dependency(tool: str) -> Optional[str]:
     "20.1.5",
     "20.1.6",
     "20.1.7",
+    "20.1.8",
+    "21.1.0",
 ]
 
 CLANG_TIDY_VERSIONS = [

MIGRATION.md renamed to docs/migration-notes.md

@@ -1,4 +1,4 @@
-# Migration: From Clang Tools Binaries to Python Wheels
+# Migration from Clang Tools Binaries to Python Wheels
 
 ## Overview
 

pyproject.toml

@@ -48,7 +48,7 @@ tracker = "https://github.com/cpp-linter/cpp-linter-hooks/issues"
 [project.optional-dependencies]
 # only clang tools can added to this section to make hooks work
 tools = [
-    "clang-format==20.1.7",
+    "clang-format==21.1.0",
     "clang-tidy==20.1.0",
 ]
 

testing/pre-commit-config-verbose.yaml

@@ -3,9 +3,9 @@ repos:
     rev: HEAD
     hooks:
       - id: clang-format
-        args: [--style=file, --version=16, --verbose]  # test with verbose output
+        args: [--style=file, --version=21, --verbose]  # test with verbose output
   - repo: .
     rev: HEAD
     hooks:
       - id: clang-format
-        args: [--style=file, --version=16, -v]  # test with verbose output
+        args: [--style=file, --version=21, -v]  # test with verbose output

testing/pre-commit-config-version.yaml

@@ -34,3 +34,10 @@ repos:
         args: [--style=file, --version=20]
       - id: clang-tidy
         args: [--checks=.clang-tidy, --version=20]
+  - repo: .
+    rev: HEAD
+    hooks:
+      - id: clang-format
+        args: [--style=file, --version=21]
+      - id: clang-tidy
+        args: [--checks=.clang-tidy, --version=20] # clang-tidy does not support version 21

testing/run.sh

@@ -29,7 +29,7 @@ failed_cases=`grep -c "Failed" result.txt`
 
 echo $failed_cases " cases failed."
 
-if [ $failed_cases -eq 9 ]; then
+if [ $failed_cases -eq 10 ]; then
     echo "=============================="
     echo "Test cpp-linter-hooks success."
     echo "=============================="

tests/test_clang_format.py

@@ -14,6 +14,7 @@
         (["--style=Google", "--version=18"], (0, "")),
         (["--style=Google", "--version=19"], (0, "")),
         (["--style=Google", "--version=20"], (0, "")),
+        (["--style=Google", "--version=21"], (0, "")),
     ),
 )
 def test_run_clang_format_valid(args, expected_retval, tmp_path):
@@ -40,6 +41,7 @@ def test_run_clang_format_valid(args, expected_retval, tmp_path):
         (["--style=Google", "--version=18"], 1),
         (["--style=Google", "--version=19"], 1),
         (["--style=Google", "--version=20"], 1),
+        (["--style=Google", "--version=21"], 1),
     ),
 )
 def test_run_clang_format_invalid(args, expected_retval, tmp_path):

tests/test_clang_tidy.py

@@ -22,6 +22,7 @@ def generate_compilation_database():
         (['--checks="boost-*"', "--version=18"], 1),
         (['--checks="boost-*"', "--version=19"], 1),
         (['--checks="boost-*"', "--version=20"], 1),
+        (['--checks="boost-*"', "--version=21"], 1),
     ),
 )
 def test_run_clang_tidy_valid(args, expected_retval):
@@ -43,6 +44,7 @@ def test_run_clang_tidy_valid(args, expected_retval):
         (['--checks="boost-*"', "--version=18"], 1),
         (['--checks="boost-*"', "--version=19"], 1),
         (['--checks="boost-*"', "--version=20"], 1),
+        (['--checks="boost-*"', "--version=21"], 1),
     ),
 )
 def test_run_clang_tidy_invalid(args, expected_retval, tmp_path):