{"id":27649,"library":"clangd-tidy","title":"clangd-tidy","description":"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.","status":"active","version":"1.1.1","language":"python","source_language":"en","source_url":"https://github.com/lljbash/clangd-tidy","tags":["clang-tidy","clangd","linting","c++","lsp"],"install":[{"cmd":"pip install clangd-tidy","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"","wrong":"","symbol":"ClangdTidyRunner","correct":"from clangd_tidy import ClangdTidyRunner"}],"quickstart":{"code":"from clangd_tidy import ClangdTidyRunner\nrunner = ClangdTidyRunner()\nresults = runner.run(['example.cpp'])\nfor r in results:\n    print(r.message)","lang":"python","description":"Basic usage to lint a C++ source file."},"warnings":[{"fix":"Install clangd via your package manager (e.g., apt install clangd, brew install llvm).","message":"clangd-tidy requires clangd to be installed and in PATH. Without clangd, the tool will fail silently or produce no results.","severity":"gotcha","affected_versions":"all"},{"fix":"If you rely on pylspclient, pin to <1.1.0 or adapt to the async interface.","message":"In v1.1.0, the internal LSP client was rewritten, removing pylspclient. This may break code depending on internal client behavior.","severity":"breaking","affected_versions":">=1.1.0"},{"fix":"Upgrade to v1.1.1 or manually convert file URIs to absolute paths.","message":"Windows file URI handling was fixed in v1.1.1 for file paths with drive letters. Prior versions may fail to process Windows paths.","severity":"gotcha","affected_versions":"<1.1.1"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run `pip install clangd-tidy` and use `from clangd_tidy import ...`.","cause":"Missing pip install or wrong import path.","error":"ModuleNotFoundError: No module named 'clangd_tidy'"},{"fix":"Install clangd (e.g., `apt install clangd` on Debian/Ubuntu, `brew install llvm` on macOS).","cause":"clangd executable not installed or not in PATH.","error":"clangd: command not found"},{"fix":"Upgrade to clangd-tidy >=1.1.1.","cause":"On Windows, clangd-tidy <1.1.1 cannot parse file URIs with drive letters.","error":"ValueError: URI path is not absolute"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}