Ceedling Test Explorer for Visual Studio Code
Run your Ceedling tests using the
Test Explorer UI.
- Shows a Test Explorer in the Test view in VS Code's sidebar with all detected tests and suites and their state
- Adds CodeLenses to your test files for starting and debugging tests
- Adds Gutter decorations to your test files showing the tests' state
- Adds line decorations to the source line where a test failed
- Shows a failed test's log when the test is selected in the explorer
- Lets you choose test suites that should be run automatically after each file change
- Install the extension and restart VS Code
- Open the workspace or folder containing your Ceedling project
- Configure your
project.yml path in the VS Code's settings if required see below
- Configure the shell path where ceedling is installed in the VS Code's settings if required (It might be required on Windows) see below
- Enable the
xml_tests_report Ceedling plugin in your
project.yml see the ceedling doc
- Open the Test view
- Run your tests using the icons in the Test Explorer or the CodeLenses in your test file
|The path to the ceedling project (where the
project.yml is) to use (relative to the workspace folder). By default (or if this option is set to
null) it use the same path as the workspace folder.
|The path to the shell where ceedling is installed. By default (or if this option is set to
null) it use the OS default shell.
|The Debug configuration to run during debugging. See Debugging for more info.
The following commands are available in VS Code's command palette, use the ID to add them to your keyboard shortcuts:
|Run all tests
|Run tests in current file
|Run the test at the current cursor position
|Cancel running tests
To set up debugging, create a new Debug Configuration.
can be used access the .out test executable filename (without directory) being ran. Depending on your Ceedling configuration
these can be found in
projectPath/build/test/out/. Then, edit the
ceedlingExplorer.debugConfiguration settings with the name of the Debug Configuration to run during debug.
Note: Individual test debugging is not supported. Instead the entire test file will be ran, so skip or remove breakpoints accordingly.
Example configuration with Native Debug (
"name": "Ceedling Test Explorer Debug",
"description": "Enable pretty-printing for gdb",
If you think you've found a bug, please file a bug report.