A visualizer for LLVM's linting tool: clang-tidy.
Install it:
python -m pip install clang-html
In your shell:
# Call it as python module
python -m clang_html [logfile.log] [-o clang.html] [-d list.html]
# Call it directly
clang-tidy-html [logfile.log] [-o clang.html] [-d list.html]
In your python terminal:
>>> from pathlib import Path
>>> from clang_html import clang_tidy_visualizer
>>> clang_tidy_visualizer(Path("examples/sample.log"))
2021-04-23 12:30:40,619 - clang_html.clang_visualizer - INFO - Writing results to clang.html
Install Clang-Tidy to use for your C/C++ source files.
On your local Linux machine, installation is as easy as:
sudo apt install clang-tidy
You will need bash or some other terminal to execute the script. Download Python 3 or higher here.
When running clang-tidy on your files, be sure to pipe it into a new log file of checks:
clang-tidy -checks=* [filename.c] | tee [newfile.log]
If you are receiving the following error:
Error while trying to load a compilation database: Could not auto-detect compilation database for file "your_file.c" No compilation database found in /your/directory or any parent directory
Create a simple json file to be compiled into your project documented here.
Clone or fork this repository to run the script on your native system.
The script takes in one file argument of a txt or log file with your outputted clang-tidy checks.
python -m clang_html [newfile.log] [-o clang.html] [-d list.html]
Inside the same directory as clang_visualizer.py, you will find a new html file called 'clang.html'.
You can also specify your custom file name when calling the script with [-o, --out] other_name.html or clang_tidy_visualizer(Path("sample.log"), Path("clang.html")).
An example html output can be found here.
The highlighting functionality uses your local session storage, which will save your changes on exit.
Feel free to create a pull request for any updates or fixes to this repository.
This repository uses LLVM Clang for versioning. By default, the script uses the latest information presented on LLVM's official checks list. Earlier versions should have support for the vast majority of checks.
The -d --checks_dict_url command-line option can link to another version (e.g., find v14.0.0 checks with: https://releases.llvm.org/14.0.0/tools/clang/tools/extra/docs/clang-tidy/checks/list.html).
- Austin Hale
See also the list of contributors who participated in this project.
This project is licensed under the MIT License - see the LICENSE file for details.