clangd-tidy

library1.1.1pypypiunverified

A faster alternative to clang-tidy that uses clangd to provide linting and formatting checks. Current version is 1.1.1, with an active release cadence. Requires Python >=3.8.

testing

pip install clangd-tidy

github ↗package ↗

INSTALL

IMPORT

SIG · CLANGD-TIDY

clangd-tidy

testingpythonv1.1.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ClangdTidyRunner

✓ from clangd_tidy.main_cli import ClangdTidyRunner

✗ from clangd_tidy import ClangdTidyRunner

Basic usage to lint a C++ source file.

from clangd_tidy import ClangdTidyRunner runner = ClangdTidyRunner() results = runner.run(['example.cpp']) for r in results: print(r.message)

clangd-tidy --version

Debug

Known issues

gotchaclangd-tidy requires clangd to be installed and in PATH. Without clangd, the tool will fail silently or produce no results.

fix

Install clangd via your package manager (e.g., apt install clangd, brew install llvm).

affects: all

breakingIn v1.1.0, the internal LSP client was rewritten, removing pylspclient. This may break code depending on internal client behavior.

fix

If you rely on pylspclient, pin to <1.1.0 or adapt to the async interface.

affects: >=1.1.0

gotchaWindows file URI handling was fixed in v1.1.1 for file paths with drive letters. Prior versions may fail to process Windows paths.

fix

Upgrade to v1.1.1 or manually convert file URIs to absolute paths.

affects: <1.1.1

Upgrade

Version history

1.1.1latest on PyPI · released Feb 9, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

30 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/lljbash/clangd-tidy ↗

packagehttps://pypi.org/project/clangd-tidy/ ↗