refactor: install clang tools on demand (#279)

In order of precedence, this patch allows installing clang tools from
1. PyPI
   - Python and `pip` are not required.
     The executable binary is extracted from the downloaded wheel.
- downloaded wheels are verified using SHA256 or Blake2b256 algorithms.
2. system package manager(s) (if any available are supported)
   - Windows: `chocolatey`, `winget`
   - MacOS: homebrew
   - Linux: `apt` (Debian), `dnf` (Fedora), `pacman` (arch linux)
- Note: For `apt`, when first attempt fails, the official LLVM install
script is (cached and) used as a fallback approach.
3. static binaries
   - binaries are verified with accompanied SHA512 checksum
- min and max supported versions can be controlled via env variables at
compile time (not runtime); `MIN_CLANG_TOOLS_VERSION` and
`MAX_CLANG_TOOLS_VERSION` respectively.
- static binary release tag can be controlled via env variable
`CLANG_TOOLS_TAG` at compile time (not runtime).
- static binary repo url can be controlled via env variable
`CLANG_TOOLS_REPO` at compile time (not runtime).

## Caching

Caching is enabled per OS standards and specific to cpp-linter use.
Caching does not apply to package managers as they tend to manage caches
on their own.
Note, the cached official LLVM install script (for the `apt` package
manager fallback) becomes invalid 24 hours after download.
Cache directory can be overridden using the `CPP_LINTER_CACHE`
environment variable.

Author: 2bndy5

.config/nextest.toml

@@ -3,28 +3,37 @@ nextest-version = "0.9.77"
 
 [profile.default]
 # A profile to run most tests, except tests that run longer than 10 seconds
-default-filter = "not test(#*rate_limit_secondary) - test(#git::test::with_*) - test(#repo_get_sha)"
+default-filter = """\
+    not test(#*rate_limit_secondary) \
+    - test(#git::test::with_*) \
+    - test(#git::test::repo_get_sha) \
+    - test(#*eval_version)
+"""
 
 # This will flag any test that runs longer than 10 seconds. Useful when writing new tests.
 slow-timeout = "10s"
 
+# show which tests were skipped
+status-level = "skip"
+
+[profile.warmup]
+# Run this profile before other tests to warmup the cache of clang tools binaries.
+default-filter = 'test(#*eval_version)'
+
 [profile.ci]
 # A profile to run only tests that use clang-tidy and/or clang-format
 # NOTE: This profile is intended to keep CI runtime low. Locally, use default or all profiles
 
 # This is all tests in tests/ folder + unit test for --extra-args.
-default-filter = "kind(test) + test(#*use_extra_args)"
-
-# show which tests were skipped
-status-level = "skip"
+default-filter = "kind(test) + test(#*use_extra_args) + test(#*eval_version)"
 
 # show log output from each test
 success-output = "final"
 failure-output = "immediate-final"
 
 [profile.all]
 # A profile to run all tests (including tests that run longer than 10 seconds)
-default-filter = "all()"
+default-filter = "all() - test(#*eval_version)"
 
 # Revert slow-timeout to nextest default value.
 # Otherwise, default profile value (10s) is inherited.

.github/workflows/benchmark.yml

@@ -60,7 +60,7 @@ jobs:
           fi
       - run: rustup update --no-self-update
         if: steps.cache.outputs.cache-hit != 'true' || steps.validate.outputs.cache-valid == 'false'
-      - run: cargo build --bin cpp-linter --release
+      - run: cargo build --bin cpp-linter --features bin --release
         if: steps.cache.outputs.cache-hit != 'true' || steps.validate.outputs.cache-valid == 'false'
       - name: Upload build artifact
         uses: actions/upload-artifact@v7

.github/workflows/binary-builds.yml

@@ -67,10 +67,10 @@ jobs:
             os: ubuntu-latest
             vendored: true
             cross: true
-          - target: powerpc64-unknown-linux-gnu
-            os: ubuntu-latest
-            vendored: true
-            cross: true
+          # - target: powerpc64-unknown-linux-gnu
+          #   os: ubuntu-latest
+          #   vendored: true
+          #   cross: true
           - target: powerpc64le-unknown-linux-gnu
             os: ubuntu-latest
             vendored: true
@@ -131,7 +131,7 @@ jobs:
           --bin cpp-linter
           --release
           --target ${{ matrix.target }}
-          ${{ matrix.vendored && '--features openssl-vendored' || '' }}
+          --features ${{ matrix.vendored && 'bin,openssl-vendored' || 'bin' }}
 
       - name: Prepare artifacts (unix)
         if: runner.os != 'Windows'

.github/workflows/run-dev-tests.yml

@@ -31,7 +31,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: ['windows-latest', ubuntu-latest]
+        os: ["windows-latest", ubuntu-latest]
 
     runs-on: ${{ matrix.os }}
     steps:
@@ -93,125 +93,28 @@ jobs:
       - if: runner.os == 'Linux'
         run: sudo apt-get update
 
-      - name: Install clang 11
-        uses: ./.github/install-clang-action
-        with:
-          version: '11'
-
-      - name: Collect Coverage for clang v11
-        env:
-          CLANG_VERSION: '11'
-        run: nur test --profile ci
-
-      - name: Install clang 12
-        uses: ./.github/install-clang-action
-        with:
-          version: '12'
-
-      - name: Collect Coverage for clang v12
-        env:
-          CLANG_VERSION: '12'
-        run: nur test --profile ci
-
-      - name: Install clang 13
-        uses: ./.github/install-clang-action
-        with:
-          version: '13'
-
-      - name: Collect Coverage for clang v13
-        env:
-          CLANG_VERSION: '13'
-        run: nur test --profile ci
-
-      - name: Install clang 14
-        uses: ./.github/install-clang-action
-        with:
-          version: '14'
-
-      - name: Collect Coverage for clang v14
-        env:
-          CLANG_VERSION: '14'
-        run: nur test --profile ci
-
-      - name: Install clang 15
-        uses: ./.github/install-clang-action
-        with:
-          version: '15'
-
-      - name: Collect Coverage for clang v15
-        env:
-          CLANG_VERSION: '15'
-        run: nur test --profile ci
-
-      - name: Install clang 16
-        uses: ./.github/install-clang-action
-        with:
-          version: '16'
-
-      - name: Collect Coverage for clang v16
-        env:
-          CLANG_VERSION: '16'
-        run: nur test --profile ci
+      - name: Install nushell
+        uses: hustcer/setup-nu@920172d92eb04671776f3ba69d605d3b09351c30 # v3.22
 
-      - name: Install clang 17
-        uses: ./.github/install-clang-action
-        with:
-          version: '17'
-
-      - name: Collect Coverage for clang v17
-        env:
-          CLANG_VERSION: '17'
-        run: nur test --profile ci
-
-      - name: Install clang 18
-        uses: ./.github/install-clang-action
-        with:
-          version: '18'
-
-      - name: Collect Coverage for clang v18
+      - name: Run test suite
         env:
-          CLANG_VERSION: '18'
-        run: nur test --profile ci
-
-      - name: Install clang v19
-        uses: ./.github/install-clang-action
-        with:
-          version: '19'
-
-      - name: Collect Coverage for clang v19
-        env:
-          CLANG_VERSION: '19'
-        run: nur test --profile ci
-
-      - name: Install clang v20
-        uses: ./.github/install-clang-action
-        with:
-          version: '20'
-
-      - name: Collect Coverage for clang v20
-        env:
-          CLANG_VERSION: '20'
-        run: nur test --profile ci
-
-      - name: Install clang v21
-        uses: ./.github/install-clang-action
-        with:
-          version: '21'
-
-      - name: Collect Coverage for clang v21
-        env:
-          CLANG_VERSION: '21'
-        run: nur test --profile ci
-
-      - name: Install clang v22
-        uses: ./.github/install-clang-action
-        with:
-          version: '22'
-
-      - name: Collect Coverage for clang v22
-        env:
-          CLANG_VERSION: '22'
-        run: nur test --profile all
+          MIN_CLANG_TOOLS_VERSION: "11"
+          MAX_CLANG_TOOLS_VERSION: "22"
+        shell: nu {0}
+        run: |-
+          let max_ver = $env.MAX_CLANG_TOOLS_VERSION | into int
+          let min_ver = $env.MIN_CLANG_TOOLS_VERSION | into int
+          for $ver in ($min_ver..$max_ver) {
+            print $"::group::Testing with clang v($ver)"
+            with-env { CLANG_VERSION: $"($ver)" } {
+              nur test --profile warmup
+              let test_profile = (
+                if ($ver == $max_ver) { "all" } else { "ci" }
+              )
+              nur test --profile $test_profile
+            }
+            print "::endgroup::"
+          }
 
       - name: Generate Coverage HTML report
         run: nur test llvm-cov

.pre-commit-config.yaml

@@ -8,7 +8,7 @@ repos:
         exclude: bindings/node/.*package\.json
       - id: check-docstring-first
       - id: check-added-large-files
-        exclude: '^\.yarn/releases/yarn.*js'
+        exclude: '^\.yarn/releases/yarn.*js|pypi_clang.*\.json$'
       - id: check-yaml
         exclude: docs/mkdocs.yml
       - id: check-toml