ECL for Visual Studio Code
Read the Release Notes to know what has changed over the last few versions of this extension.
This extension adds rich language support for the ECL language to VS Code, including:
- Syntax highlighting
- Auto completion
- F7 Syntax check
- shift+F7 Syntax check all
- cmd/ctrl+F7 Syntax check clear all reported problems
- F12 "Goto definition"
- Basic workunit support
- Multi root workspaces (vscode docs): No need to manually include folders.
- Install Visual Studio Code.
- In VS-Code, open the command palette (
ctrl/cmd+shift+p) and select
Install Extension. Enter 'ecl' to filter the available extensions and choose
- Locate and install the appropriate ECL Client Tools from hpccsystems.com
The following Visual Studio Code settings are available for the ECL extension. These can be set in user preferences (
ctrl/cmd+,) or workspace settings (
// Syntax check args.
// Run 'eclcc -syntax' on save.
// Run 'eclcc -syntax' on load.
// External folders used by IMPORT
// Override eclcc auto detection
// Add '-legacy' arguement to eclcc.
// Open workunits in external browser.
// Automatically open WU in browser on creation.
// Debug logging.
Submitting or debugging ECL using VS-Code requires specifiying the target environment within the VS Code
F5 will prompt you to auto create a skeleton file if none exists):
"user": "", // Optional (vscode will prompt as needed)
"password": "" // Optional (vscode will prompt as needed)
Building and Debugging the Extension
You can set up a development environment for debugging the extension during extension development.
First make sure you do not have the extension installed in
~/.vscode/extensions. Then clone the repo somewhere else on your machine, run
npm install and open a development instance of Code.
rm -rf ~/.vscode/extensions/GordonSmith.ecl
git clone https://github.com/hpcc-systems/vscode-ecl
You can now go to the Debug viewlet and select
Launch Extension then hit run (
[Extension Development Host] instance, open your ECL folder.
You can now hit breakpoints and step through the extension.
If you make edits in the extension
.ts files, just reload (
[Extension Development Host] instance of Code to load in the new extension code. The debugging instance will automatically reattach.
To debug the debugger, see the debugAdapter readme.