derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
124 lines
10 KiB
ReStructuredText
124 lines
10 KiB
ReStructuredText
==================================
|
|
Clang-tidy IDE/Editor Integrations
|
|
==================================
|
|
|
|
.. _clangd: http://clangd.llvm.org/
|
|
.. _is available: https://clangd.llvm.org/installation.html#editor-plugins
|
|
.. _more: https://langserver.org/#implementations-client
|
|
|
|
Apart from being a standalone tool, :program:`clang-tidy` is integrated into
|
|
various IDEs, code analyzers, and editors. We recommend using clangd_ which
|
|
integrates :program:`clang-tidy` and `is available`_ in most major editors
|
|
through plugins (Vim, Emacs, Visual Studio Code, Sublime Text and more_).
|
|
|
|
The following table shows the most well-known :program:`clang-tidy`
|
|
integrations in detail.
|
|
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
| | Feature | | | | |
|
|
+======================================+========================+=================================+==========================+=========================================+==========================+
|
|
| **Tool** | On-the-fly inspection | Check list configuration (GUI) | Options to checks (GUI) | Configuration via ``.clang-tidy`` files | Custom clang-tidy binary |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|A.L.E. for Vim | \+\ | \-\ | \-\ | \-\ | \+\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|Clang Power Tools for Visual Studio | \-\ | \+\ | \-\ | \+\ | \-\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|Clangd | \+\ | \-\ | \-\ | \+\ | \-\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|CLion IDE | \+\ | \+\ | \+\ | \+\ | \+\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|CodeChecker | \-\ | \-\ | \-\ | \-\ | \+\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|CPPCheck | \-\ | \-\ | \-\ | \-\ | \-\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|CPPDepend | \-\ | \-\ | \-\ | \-\ | \-\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|Flycheck for Emacs | \+\ | \-\ | \-\ | \+\ | \+\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|KDevelop IDE | \-\ | \+\ | \+\ | \+\ | \+\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|Qt Creator IDE | \+\ | \+\ | \-\ | \+\ | \+\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|ReSharper C++ for Visual Studio | \+\ | \+\ | \-\ | \+\ | \+\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|Syntastic for Vim | \+\ | \-\ | \-\ | \-\ | \+\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|Visual Assist for Visual Studio | \+\ | \+\ | \-\ | \-\ | \-\ |
|
|
+--------------------------------------+------------------------+---------------------------------+--------------------------+-----------------------------------------+--------------------------+
|
|
|
|
**IDEs**
|
|
|
|
.. _CLion: https://www.jetbrains.com/clion/
|
|
.. _integrates clang-tidy: https://www.jetbrains.com/help/clion/clang-tidy-checks-support.html
|
|
|
|
CLion_ 2017.2 and later `integrates clang-tidy`_ as an extension to the
|
|
built-in code analyzer. Starting from 2018.2 EAP, CLion allows using
|
|
:program:`clang-tidy` via Clangd. Inspections and applicable quick-fixes are
|
|
performed on the fly, and checks can be configured in standard command line
|
|
format. In this integration, you can switch to the :program:`clang-tidy`
|
|
binary different from the bundled one, pass the configuration in
|
|
``.clang-tidy`` files instead of using the IDE settings, and configure
|
|
options for particular checks.
|
|
|
|
.. _KDevelop: https://www.kdevelop.org/
|
|
.. _kdev-clang-tidy: https://github.com/KDE/kdev-clang-tidy/
|
|
|
|
KDevelop_ with the kdev-clang-tidy_ plugin, starting from version 5.1, performs
|
|
static analysis using :program:`clang-tidy`. The plugin launches the
|
|
:program:`clang-tidy` binary from the specified location and parses its
|
|
output to provide a list of issues.
|
|
|
|
.. _QtCreator: https://www.qt.io/
|
|
.. _Clang Code Model: https://doc.qt.io/qtcreator/creator-clang-codemodel.html
|
|
.. _Clang Tools: https://doc.qt.io/qtcreator/creator-clang-tools.html
|
|
|
|
QtCreator_ 4.6 integrates :program:`clang-tidy` warnings into the editor
|
|
diagnostics under the `Clang Code Model`_. To employ :program:`clang-tidy`
|
|
inspection in QtCreator, you need to create a copy of one of the presets and
|
|
choose the checks to be performed. Since QtCreator 4.7 project-wide analysis is
|
|
possible with the `Clang Tools`_ analyzer.
|
|
|
|
.. _MS Visual Studio: https://visualstudio.microsoft.com/
|
|
.. _ReSharper C++: https://www.jetbrains.com/help/resharper/Clang_Tidy_Integration.html
|
|
.. _Visual Assist: https://docs.wholetomato.com/default.asp?W761
|
|
.. _Clang Power Tools: https://marketplace.visualstudio.com/items?itemName=caphyon.ClangPowerTools
|
|
|
|
`MS Visual Studio`_ can integrate :program:`clang-tidy` by means of three
|
|
different tools. The `ReSharper C++`_ extension, version 2017.3 and later,
|
|
provides seamless :program:`clang-tidy` integration: checks and quick-fixes run
|
|
alongside native inspections.
|
|
Apart from that, ReSharper C++ incorporates :program:`clang-tidy` as a separate
|
|
step of its code clean-up process. `Visual Assist`_ build 2210 includes a
|
|
subset of :program:`clang-tidy` checklist to inspect the code as you edit.
|
|
Another way to bring :program:`clang-tidy` functionality to Visual Studio is
|
|
the `Clang Power Tools`_ plugin, which includes most of the
|
|
:program:`clang-tidy` checks and runs them during compilation or as a separate
|
|
step of code analysis.
|
|
|
|
**Editors**
|
|
|
|
.. _Flycheck: https://github.com/ch1bo/flycheck-clang-tidy
|
|
.. _Syntastic: https://github.com/vim-syntastic/syntastic
|
|
.. _A.L.E.: https://github.com/w0rp/ale
|
|
.. _Emacs24: https://www.gnu.org/s/emacs/
|
|
.. _Vim: https://www.vim.org/
|
|
|
|
Emacs24_, when expanded with the Flycheck_ plugin, incorporates the
|
|
:program:`clang-tidy` inspection into the syntax analyzer. For Vim_, you can
|
|
use Syntastic_, which includes :program:`clang-tidy`, or `A.L.E.`_,
|
|
a lint engine that applies :program:`clang-tidy` along with other linters.
|
|
|
|
**Analyzers**
|
|
|
|
.. _CPPDepend: https://www.cppdepend.com/cppdependv2018
|
|
.. _CPPCheck: https://sourceforge.net/p/cppcheck/news/
|
|
.. _CodeChecker: https://github.com/Ericsson/codechecker
|
|
.. _plugin: https://github.com/Ericsson/CodeCheckerEclipsePlugin
|
|
|
|
:program:`clang-tidy` is integrated in CPPDepend_ starting from version 2018.1
|
|
and CPPCheck_ 1.82. CPPCheck integration lets you import Visual Studio
|
|
solutions and run the :program:`clang-tidy` inspection on them. The
|
|
CodeChecker_ application of version 5.3 or later, which also comes as a plugin_
|
|
for Eclipse, supports :program:`clang-tidy` as a static analysis instrument and
|
|
allows to use a custom :program:`clang-tidy` binary.
|