Swift Test Adapter for Visual Studio Code
This extension for Text Explorer UI add ide test capabilities with swift SPM in VSCode and also integrates with CodeLLDB to enable debug capabilities but it doesn't depend from it. Install it only if you want to enable debug capabilities
Features
- Debug on linux
- Reload test lists on save if a test file changes (Configurable)
- Run single test or all tests in a class or all test in a target instead of
swift testeverything everytime - Detects test file location and line
- Highlights test failed lines with output
- Prints test run output
Screenshots
Example of running debug
Example of run tests
Missing Features
- AutoRun
- Parallel tests (but not likelly at this moment)
- Code Coverage
Debug
As already mentioned this extension is capable to debug code integrating with the CodeLLDB extension. You can reference their user manual on how to set up the correct liblldb path for the extension to work, then it should work out of the box when selecting the test case to debug.
For instance I've my swift toolchain inside /swift-toolchain/ directory and I've set the lldb backends to /swift-toolchain/usr/lib/liblldb.so
Errors
If you see an error like this
This version of LLDB has no plugin for the swift language. Inspection of frame variables will be limited.
while running a debug session you probably didn't properly set the correct liblldb.so
Could not initialize Python interpreter - some features will be unavailable (e.g. debug visualizers).
in the debug console it's actually a problem with the distributed version of swift lldb and it doesn't seem to cause any problem
Support
This extension is really new so I suppose bugs will be frequent, feel free to open any issue if you find something or you want to propose a new feature
And also I would really appreciate it if you can find 5 minutes to review this extension in the marketplace
Known Issues
Fails to load tests on startup
This often occurs if you have more swift extensions which launch builds and two concurrent build are issued when the extension loads.
The extension rebuilds the whole project when you load tests
This issue occurs if you have enabled the debugging setting and you launch a swift build command. When the debugging setting is enabled the extension build the project whit the command swift test --enable-test-discovery -Xswiftc -Xfrontend -Xswiftc -serialize-debugging-options plus the build options passed in the settings. These flags makes possible to correctly debug a test when is launched, but if you launch a build with different flags all the project will be rebuilded from zero.
Pro Tip you can build the project with the same flags and debug the executable using the same lldb extension