clang-apply-replacements 16.0.0

Clang-apply-replacements is an LLVM-based tool for applying clang-tidy fix-it replacements

clang-apply-replacements Python distribution

This project packages the clang-apply-replacements utility as a Python package. It allows you to install clang-apply-replacements directly from PyPI:

python -m pip install clang-apply-replacements

This project intends to release a new PyPI package for each major and minor release of clang-apply-replacements.

What is clang-apply-replacements?

clang-apply-replacements is an LLVM-based tool that reads serialized clang-tidy replacements (fix-it hints) from YAML files and applies them to source files. It is part of the clang-tools-extra suite.

Use with pipx

You can use pipx to run clang-apply-replacements, as well. For example, pipx run clang-apply-replacements <args> will run clang-apply-replacements without any previous install required on any machine with pipx (including all default GitHub Actions / Azure runners, avoiding requiring a pre-install step or even actions/setup-python).

Building new releases

The clang-apply-replacements repository provides the logic to build and publish binary wheels of the clang-apply-replacements utility.

In order to add a new release, the following steps are necessary:

• Edit the version file to reflect the new version.
• Make a GitHub release to trigger the GitHub Actions release workflow. Alternatively, the workflow can be triggered manually.

On manual triggers, the following input variables are available:

• use_qemu: Whether to build targets that require emulation (default: true)
• llvm_version: Override the LLVM version (default: "")
• wheel_version: Override the wheel packaging version (default "0")
• deploy_to_testpypi: Whether to deploy to TestPyPI instead of PyPI (default: false)

The repository with the precommit hook is automatically updated using a scheduled Github Actions workflow.

Acknowledgments

This repository extends the great work of several other projects:

• clang-apply-replacements itself is provided by the LLVM project under the Apache 2.0 License with LLVM exceptions.
• The build logic is based on scikit-build which greatly reduces the amount of low level code necessary to package clang-apply-replacements.
• The scikit-build packaging examples of CMake and Ninja were very helpful in packaging clang-apply-replacements.
• The CI build process is controlled by cibuildwheel which makes building wheels across a number of platforms a pleasant experience (!)

We are grateful for the generous provisioning with CI resources that GitHub currently offers to Open Source projects.

Troubleshooting

To see which clang-apply-replacements binary the package is using you can set CLANG_APPLY_REPLACEMENTS_WHEEL_VERBOSE to 1 in your environment.