asdf-clang-tools

clang-tools plugin for the asdf version manager.

Overview

This is an asdf plugin for installing several clang tools:

• clang-format
• clang-tidy
• clang-query
• clang-apply-replacements
• clang-include-cleaner (version 18+)

This plugin uses the pre-compiled binaries from the very handy cpp-linter/clang-tools-static-binaries repo.

Supported Versions

Clang versions 11 through 22 are supported.

Caveats

• Again, the source for these binaries is currently cpp-linter/clang-tools-static-binaries. Please make sure you trust that repository.
• Pre-compiled binaries are provided for:
  • Linux: amd64 (x86_64), arm64 (aarch64)
  • macOS: amd64 (Intel), arm64 (Apple Silicon)
  • Windows: amd64 (x86_64), arm64 (aarch64)
• Signed binaries are not provided for macOS. This plugin will offer to de-quarantine the binaries for you, but please make sure you understand the consequences.
• clang-include-cleaner is only available from version 18 onward.

Dependencies

• curl, jq
• sha512sum (optional, but recommended)

Install

Plugin:

Tool	Command to add Plugin
clang-format	asdf plugin add clang-format https://github.com/cpp-linter/asdf-clang-tools.git
clang-query	asdf plugin add clang-query https://github.com/cpp-linter/asdf-clang-tools.git
clang-tidy	asdf plugin add clang-tidy https://github.com/cpp-linter/asdf-clang-tools.git
clang-apply-replacements	asdf plugin add clang-apply-replacements https://github.com/cpp-linter/asdf-clang-tools.git
clang-include-cleaner	asdf plugin add clang-include-cleaner https://github.com/cpp-linter/asdf-clang-tools.git

Example:

asdf plugin add clang-format https://github.com/cpp-linter/asdf-clang-tools.git

clang-format:

# Show all installable versions
asdf list all clang-format

# Install specific version
asdf install clang-format latest

# Set a version (on your ~/.tool-versions file)
asdf set clang-format latest

# Now clang-tools commands are available
clang-format

Check asdf readme for more instructions on how to install & manage versions.

Configuration

Environment Variables

• ASDF_CLANG_TOOLS_MACOS_DEQUARANTINE: set to "1" to automatically de-quarantine binaries. Otherwise, it will interactively ask to do so.
• ASDF_CLANG_TOOLS_LINUX_IGNORE_ARCH: set to "1" to install the amd64 binary regardless of the host architecture. This can be useful if you have set up QEMU User Emulation (or similar) to run foreign binaries under emulation. Normally, the native arm64/aarch64 Linux binaries are used automatically when detected.

Contributing

Contributions of any kind welcome! See the contributing guide.

License

See LICENSE