This is a C/C++ code analysis plugin for VSCode that shows bug reports detected by the Clang Static Analyzer and Clang Tidy analyzers, using CodeChecker as a backend.
PATH environment variable.compile_commands.json file.F9/Shift-F9 by default)CodeChecker works by reading a generated compilation database, often called compile_commands.json, and executing specific analyses based on that.
CMake has built-in support for generating a compilation database. Set the environment variable CMAKE_EXPORT_COMPILE_COMMANDS=ON, and the compilation database should be inside your build folder. If you are using the CMake Tools extension for VS Code, you can add this flag to the extension settings under Cmake > Build Environment.
make and other build systems have no built-in support for generating a compilation database, but CodeChecker can generate one based on the build command. To generate one, you can use the command CodeChecker log -b "[full build command]" -o .codechecker/compile_commands.json.
To automate the process, the extension provides ways to run the CodeChecker log command automatically. First, in the Extension Settings set CodeChecker > Executor > Log build command, and then use either the VS Code Task, or the VS Code command CodeChecker: Run CodeChecker Log to execute the analysis. You can also run CodeChecker: Preview CodeChecker log in terminal to have more fine-grained control over the parameters passed to CodeChecker.
The extension uses Codechecker version 6.18.2 or later. If your installation path is different, or CodeChecker is not in the the PATH environment variable, the path to it can be set manually under Preferences > Settings > Extensions > CodeChecker > Executable path.
The extension can run a CodeChecker analysis on your project, either when saving a file, or when using one of the CodeChecker: Analyze commands. You can stop the analysis by clicking the Cancel button on CodeChecker's notification - partial results are saved automatically.
The analysis is fully configurable, and the resulting CodeChecker command line can be previewed with the CodeChecker: Show full command line command (for supported arguments, run CodeChecker analyze --help). Settings for the current workspace can be set on the Workspace tab in the Settings. Automatic analysis on saving can be configured as well.
Detailed information about the configuration options can be found under Settings.
The extension provides the following commands:
Command Description
CodeChecker: Analyze current file Analyzes the currently opened source file using CodeChecker. Can also be called by clicking on the Re-analyze current file button in CodeChecker's side panel.
Run On Save is turned off in the plugin's settings. CodeChecker: Analyze selected files... Analyzes the files selected by the user, using CodeChecker. Accepts multiple files as input. CodeChecker: Analyze entire project Analyzes the entire project using CodeChecker. Can also be called by clicking on the Re-analyze entire project button in CodeChecker's side panel.
CodeChecker: Stop running CodeChecker instance Stops the currently running analysis. Partial results are saved and updated. CodeChecker: Run CodeChecker log Updates the compilation database, by building the current project. A variant with a custom user-specified build command is also available. CodeChecker: Preview CodeChecker log in terminal The current CodeChecker log command is pasted into a new terminal window, where it can be edited before running it. CodeChecker: Show database setup dialog Shows the dialog to select the path to an existing compilation database, or to create a new one. CodeChecker: Next reproduction step,
CodeChecker: Previous reproduction step Moves between a displayed reproduction path's steps. You can also navigate directly to a report's step via CodeChecker's side panel.
Ctrl-F7, Ctrl-Shift-F7 respectively. CodeChecker: Show full CodeChecker analyze command line Shows the full CodeChecker command line used to analyze files.
CodeChecker: Show Output Focuses CodeChecker's output in the editor. The plugin's logs, as well as the output of previous CodeChecker runs are displayed here. CodeChecker: Reload metadata Reloads CodeChecker's metadata.json file. Can also be called by clicking on the Reload CodeChecker metadata button on the CodeChecker's side panel.
The analysis commands are also available in task form:
Task Equivalent command{ type: "CodeChecker", taskType: "currentFile" } CodeChecker: Analyze current file { type: "CodeChecker", taskType: "selectedFiles", selectedFiles: [] } CodeChecker: Analyze selected files...
selectedFiles array, using full paths. { type: "CodeChecker", taskType: "project" } CodeChecker: Analyze entire project { type: "CodeChecker log" } CodeChecker: Run CodeChecker log { type: "CodeChecker log", customBuildCommand: "..." } CodeChecker: Run CodeChecker log with custom build command
Since CodeChecker-related paths vary greatly between systems, the following settings are provided, accessible through the Settings menu:
Name Description CodeChecker > Backend > Output folder${workspaceFolder}/.codechecker) The output folder where the CodeChecker analysis files are stored. CodeChecker > Backend > Compilation database path
null) Control how a bug is displayed in the editor, depending on what its severity is. Bugs can be displayed as 'Error', 'Warning', 'Information' or 'Hint'. By default, everything except 'STYLE' severity is displayed as an error. Configured as an array, such as { "UNSPECIFIED": "Warning", "LOW": "Warning" } CodeChecker > Editor > Show database dialog
on) Controls the dialog when opening a workspace without a compilation database. CodeChecker > Editor > Enable CodeLens
on) Enable CodeLens for displaying the reproduction path in the editor. CodeChecker > Executor > Enable notifications
on) Enable CodeChecker-related toast notifications. CodeChecker > Executor > Executable path
CodeChecker) Path to the CodeChecker executable. Can be an executable in the PATH environment variable, or an absolute path to one. CodeChecker > Executor > Analysis timeout
CodeChecker analyze. For example, if you want to use a config file for CodeChecker pass '--config <config.json>'. For supported arguments, run CodeChecker analyze --help.
CodeChecker: Show full CodeChecker analyze command line. CodeChecker > Executor > Log build command
make) The default build command used when running CodeChecker log via commands or tasks. CodeChecker > Executor > Log Arguments
CodeChecker log.
CodeChecker: Preview CodeChecker log in terminal. CodeChecker > Executor > Run on save
on) Controls auto-run of CodeChecker on saving a file.
Note: If you have already installed this extension from Marketplace, uninstall it first to prevent conflicts with your own build.
This extension uses Node.js (v12+) and Yarn (v2+). Recommended VS Code extensions are ESLint and TypeScript+Webpack Problem Matcher
To build and run the extension, do the following:
yarn install --immutable, to install dependenciescode .)To run tests, select Extension Tests as the active debug configuration, or run yarn run test.
The extension is released under the Apache 2.0 license, the same license as CodeChecker.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4