---
title: "clang-tidy | pypx"
description: "Clang-tidy is an LLVM-based code analyser tool"
canonical_url: "https://pypx.app/packages/clang-tidy"
meta:
  "og:description": "Clang-tidy is an LLVM-based code analyser tool"
  "og:image": "https://pypx.app/_og/d/h_630%2Cc_PackageCard%2Cname_clang-tidy%2Cversion_23.1.4%2Csummary_Clang-tidy%2Bis%2Ban%2BLLVM-based%2Bcode%2Banalyser%2Btool%2Clicense_Apache%2BSoftware%2BLicense%2Cp_Ii9wYWNrYWdlcy9jbGFuZy10aWR5Ig%2Cs_dzRApV4SxnD6m2I9.png"
  "og:image:height": "630"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "clang-tidy 23.1.4"
  "twitter:image": "https://pypx.app/_og/d/h_630%2Cc_PackageCard%2Cname_clang-tidy%2Cversion_23.1.4%2Csummary_Clang-tidy%2Bis%2Ban%2BLLVM-based%2Bcode%2Banalyser%2Btool%2Clicense_Apache%2BSoftware%2BLicense%2Cp_Ii9wYWNrYWdlcy9jbGFuZy10aWR5Ig%2Cs_dzRApV4SxnD6m2I9.png"
---

> Index of every page on this site: [llms.txt](https://pypx.app/llms.txt)

# **clang-tidy**

v23.1.4

Clang-tidy is an LLVM-based code analyser tool

23.9 MBplatform-specificApache Software License

[** Diff **](https://pypx.app/packages/clang-tidy/diff)

`$ uv add clang-tidy`

# clang-tidy Python distribution

[![PyPI Release](https://img.shields.io/pypi/v/clang-tidy.svg)](https://pypi.org/project/clang-tidy)

This project packages the `clang-tidy` utility and related tools as a Python package. It allows you to install `clang-tidy` directly from PyPI:

```
python -m pip install clang-tidy
```

The tools provided are:

- `clang-tidy`: lints C++ source code using configurable rules
- `clang-apply-replacements`: applies "fixes" that have been exported by `clang-tidy` in YAML format
- `run-clang-tidy.py`: runs `clang-tidy` over all files in a compilation database or a specified path, with parallelism
- `clang-tidy-diff.py`: applies `clang-tidy` to the changed lines in a user-provided diff

This projects intends to release a new PyPI package for each major and minor release of `clang-tidy`.

## Use with pipx

You can use `pipx` to run clang-tidy, as well. For example, `pipx run clang-tidy <args>` will run clang-tidy 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-tidy-wheel repository](https://github.com/ssciwr/clang-tidy-wheel) provides the logic to build and publish binary wheels of the `clang-tidy` utility.

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

- Edit the [version file](https://github.com/ssciwr/clang-tidy-wheel/blob/main/clang-tidy_version.cmake) to reflect the new version.
- Make a GitHub release to trigger the [GitHub Actions release workflow](https://github.com/ssciwr/clang-tidy-wheel/actions/workflows/release.yml). 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-tidy` itself is [provided by the LLVM project](https://github.com/llvm/llvm-project) under the Apache 2.0 License with LLVM exceptions.
- The build logic is based on [scikit-build](https://github.com/scikit-build/scikit-build) which greatly reduces the amount of low level code necessary to package `clang-tidy`.
- The `scikit-build` packaging examples of [CMake](https://github.com/scikit-build/cmake-python-distributions) and [Ninja](https://github.com/scikit-build/ninja-python-distributions) were very helpful in packaging `clang-tidy`.
- The CI build process is controlled by [cibuildwheel](https://github.com/pypa/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-tidy binary the package is using you can set `CLANG_TIDY_WHEEL_VERBOSE` to `1` in your environment.

## **Details **

<dl>

<dt>Version</dt>
<dd>23.1.4</dd>

<dt>License</dt>
<dd>Apache Software License</dd>

<dt>Maintainer</dt>
<dd>Dominic Kempf &lt;ssc@iwr.uni-heidelberg.de&gt;</dd></dl>

## **Links**

- [Clang](http://clang.llvm.org/)
- [Documentation](https://clang.llvm.org/extra/clang-tidy/index.html#clang-tidy)
- [Download](https://github.com/llvm/llvm-project/releases)
- [Source](https://github.com/ssciwr/clang-tidy-wheel)
- [View on PyPI](https://pypi.org/project/clang-tidy/)

## **Release Cadence **

**7**

releases in the past year

avg 83 days between releases

## **Platforms **

linuxarm64mac-x86mac-armwinmusl

## **Maintainers **

- Dominic Kempf · [ssc@iwr.uni-heidelberg.de](mailto:ssc@iwr.uni-heidelberg.de)

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://pypx.app/#website","@type":"WebSite","description":"The Python Package Index, reimagined. Fast search, dependency insights, download trends, and changelogs — all in one place.","name":"pypx","url":"https://pypx.app/"},{"@id":"https://pypx.app/packages/clang-tidy#webpage","@type":"WebPage","description":"Clang-tidy is an LLVM-based code analyser tool","name":"clang-tidy","url":"https://pypx.app/packages/clang-tidy","isPartOf":{"@id":"https://pypx.app/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://pypx.app/packages/clang-tidy"]}]},{"@id":"https://pypx.app/packages/clang-tidy#/schema/software-application/1","@type":"SoftwareApplication","applicationCategory":"DeveloperApplication","description":"Clang-tidy is an LLVM-based code analyser tool","license":"Apache Software License","name":"clang-tidy","softwareVersion":"23.1.4"}]}
```

## Sitemap

See the full [sitemap](https://pypx.app/sitemap.md) for all pages.
