Galaxy Workflows VSCode Extension
VSCode extension to assist in editing Galaxy Workflow files while enforcing best practices. Use it in combination with Planemo for the best experience developing and maintaining your Galaxy workflows.
The extension can be installed either locally, or in a web context, like github.dev or vscode.dev. The aim is to support the maximum number of features in both modes but the web mode may have some limitations.
The extension aims to focus on assist in editing Format 2 Galaxy Workflow (.gxwf.yml) files. However, it will work with legacy or native Galaxy Workflow format (documents with .ga extension) as an experiment for legacy workflow maintainers.
If you find a bug or have an idea or suggestion that can improve your experience please create a new issue here or comment in any of the existing ones.
Option 1: Install extension locally
Option 2: Use it directly in
|Feature||Legacy Workflows (.ga)||Format 2 Workflows (.gxwf.yml)|
|Documentation on Hover||✔️||✔️|
|Workflow Cleanup Command||✔️||❔|
|Simplified Workflow Diffs||🔶||❔|
✔️ Feature supported in latest version.
🔜 Feature not yet available but planned for future release.
❔ This feature may not apply to this format or not planned yet.
🔶 This feature is only supported in local repositories or file systems. Not supported in Web mode or Virtual File Systems.
❌ This feature is not supported for this format.
You will get diagnostics for every syntax error or incorrect property value as you type so you can fix them right away.
Documentation on Hover
Hover over properties to get a description of what they are and how can you use them. The documentation displayed is based on the Workflow schema annotations, if you think you need more details or something is off, please help us improve the schema here!
Get IntelliSense suggestions depending on your cursor context. Remember that you can manually trigger the suggestions at your current cursor position using
Keep your workflow document consistently formatted. We recommend enabling your VSCode setting to
Format on Save so you don't have to manually format after the changes.
Custom Outline allows you to navigate and find different parts of the Workflow faster using the Outline panel or the Breadcrumbs. The Outline representation has been enhanced, in comparison to the standard JSON Outline, by displaying relevant information more prominently (like using the workflow step name instead of the index on step nodes) or hiding non-essential nodes.
Workflow Cleanup Command
You can clean up the non-essential properties of a (legacy .ga) workflow with this command. These properties are usually related to the display of the workflow in the editor and are not part of the workflow semantics. This command will remove those properties from the document, but you can also use the
Preview clean workflow command, which will show you a preview of the clean workflow instead of making the changes to the original.
Simplified Workflow Diffs
⚠️ This feature is experimental and is only available using a local git repository.
Sometimes you want to compare different revisions of the same (legacy .ga) workflow and see what has changed between them. If the workflow has been through the Galaxy editor or some of the nodes have been moved around, there can be many changes that are just cosmetical and not part of the workflow logic. In those cases, you may want to get a 'simplified' diff so you can focus on the 'real' changes. You can do so in the
Timeline or the
File Explorer by using
Select workflow for (clean) compare in one revision and then
Compare with this workflow (clean) on the other revision, this will compare both revisions using the 'clean' version of the workflow (see the Workflow Cleanup Command), meaning the non-essential parts are removed from both documents before the comparison.