Sudsy for VS Code
Sudsy is one formatter and linter for your whole repo. This extension formats and lints C#, C/C++, CSS, Dockerfile, EditorConfig, Gitignore, GraphQL, HCL, HTML, INI, JSON, Java, JavaScript/TypeScript, Kotlin, Makefile, Markdown, PHP, PowerShell, Protobuf, Python, Ruby, SQL, Shell, TOML, XML and YAML: diagnostics, quick fixes, fix all
and format on save, from the sudsy.yaml of your repository. How close each language is to its usual tool: status table.
Install
The extension is not on the Marketplace yet. Download the .vsix for your platform from the latest release and run:
code --install-extension sudsy-<platform>-<version>.vsix
It bundles the sudsy server. C# needs the .NET 10 runtime; every other language works without it.
Choose Sudsy as the formatter of each language in your settings:
{
"[typescript]": { "editor.defaultFormatter": "sudsy.sudsy", "editor.formatOnSave": true },
"[python]": { "editor.defaultFormatter": "sudsy.sudsy", "editor.formatOnSave": true },
"[yaml]": { "editor.defaultFormatter": "sudsy.sudsy", "editor.formatOnSave": true },
"editor.codeActionsOnSave": { "source.fixAll.sudsy": "explicit" }
}
sudsy.yaml itself gets completion and validation (through the Red Hat YAML extension, if you have it installed).
Settings
sudsy.importStrategy: fromEnvironment (default: sudsy.serverPath if set, else the first sudsy on PATH, else the bundled one) or useBundled.
sudsy.serverPath: the sudsy executable. A CLI for terminals is a separate install (npm i -D @sudsylint/sudsy, pip install sudsy, Homebrew, Scoop or the release archives).
sudsy.csharpWorkerPath: Sudsy.Worker.dll (default: the one beside the executable).
- Both path settings are machine-scoped: set them in user settings, not in a workspace's
.vscode/settings.json. The extension does not run in untrusted (Restricted Mode) workspaces.
sudsy.trace.server: off, messages or verbose.
Building
npm ci, then npm run lint, npm test and npm run build. npm run stage-server -- <release sudsy> <published worker directory> copies the native binary and the worker into server/, and
npm run package -- --target <platform> makes the .vsix of that platform (see
.github/workflows/ci.yml).