clang-tools

Easily install clang-format, clang-tidy, clang-query, clang-apply-replacements, clang-include-cleaner, llvm-cov, llvm-profdata, llvm-symbolizer, and clang-scan-deps static binaries or Python wheels using the clang-tools CLI.

[!IMPORTANT] This package only manages binary executables (& corresponding symbolic links) that 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 supports clang-format, clang-tidy, clang-include-cleaner, and clang-apply-replacements tools.

📖 Full documentation: cpp-linter.github.io/clang-tools-pip

Features

Install clang-format, clang-tidy, clang-query, clang-apply-replacements, clang-include-cleaner, llvm-cov, llvm-profdata, llvm-symbolizer, and clang-scan-deps via a single clang-tools CLI.
Supports both static binaries (standalone executables) and Python wheels (installed via pip).
Automatically uses static binaries when available; falls back to wheels if not.
Works on Linux, macOS, and Windows (x86_64 and ARM64).
Choose a specific LLVM version (12–23) or install the latest.
Install only the tools you need with --tool.
Uses SHA512 checksums to verify downloaded binaries.
Creates unversioned symlinks (e.g., clang-format) alongside versioned binaries (clang-format-18) for convenience.

[!NOTE] To create symbolic links on Windows, you must enable developer mode from the Windows settings under "Privacy & security" > "For developers" category.
Install to any directory with --directory.
Uninstall with clang-tools uninstall.

Install clang-tools CLI

[!TIP] It is recommended to use this package in a virtual environment.
python -m venv env-name
source env-name/bin/activate  # Linux
./env-name/Scripts/activate   # Windows

Install clang-tools command with pip:

pip install clang-tools

Install clang-tools from git repo:

pip install git+https://github.com/cpp-linter/clang-tools-pip.git@main

CLI Usage

For a full list of CLI options, see the documentation.

Install binaries

# Install latest clang-format (auto-detects: tries binary with --version, else wheel)
clang-tools install clang-format

# Install specific version (auto-detect: binary first, fall back to wheel)
clang-tools install clang-format --version 13

# Install multiple tools with a version
clang-tools install clang-format clang-tidy --version 13

# Install to a specified directory
clang-tools install clang-format --version 13 --directory .

If the installed directory is in your path:

clang-format-13 --version
# clang-format version 13.0.0

[!NOTE] Wheel installation resolves the latest matching version from PyPI (e.g. --version 18 finds 18.1.8). If you know the exact version, pip install <tool>==<version> is equivalent and more direct.

Install wheels

To install specific tools as Python wheels:

# Install latest clang-format wheel
clang-tools install clang-format --version 21

# Install latest clang-tidy wheel
clang-tools install clang-tidy --version 21

Supported Clang Tools

clang tools binaries

clang-format
clang-tidy
clang-query
clang-apply-replacements
clang-include-cleaner
llvm-cov
llvm-profdata
llvm-symbolizer
clang-scan-deps

For more details, visit clang-tools-static-binaries.

clang tools Python wheels

Check the respective PyPI pages for available versions and platform support.

License

This project is licensed under the MIT License.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

clang_tools-1.3.0-py3-none-any.whl (15.6 kB view details)

Uploaded Sep 2, 2026 Python 3

File details

Details for the file clang_tools-1.3.0-py3-none-any.whl.

File metadata

Download URL: clang_tools-1.3.0-py3-none-any.whl
Upload date: Sep 2, 2026
Size: 15.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.7

File hashes

Hashes for clang_tools-1.3.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`9945f16ef8dda0850e12a92fbbe7fc2e21784e795f15116a756ae205d2536442`
MD5	`d166d8564582b1fe8f756e327aee1aa6`
BLAKE2b-256	`6f5b3973314161ee0f580184d1405f77b41a2436067d019ce468f85927a9563c`