Lets users add formatters to VSCode that run locally defined scripts.
Motivation
VSCode's formatter features lets you quickly format code through the Format Document command (shift+alt+f)
or automatically on save with the editor.formatOnSave option.
However, the only way to add new formatters to VSCode is by installing an extension.
If you have custom formatting tools or scripts you want to run, there's no easy way to integrate them with VSCode currently.
This extension solves that problem by providing an easy way to register custom scripts as VSCode formatters.
Here's an example of a custom python script that sorts imports and reformats code being run on a python file:

Quickstart
Install this extension through the VSCode extensions panel or VSCode extensions marketplace.
Define your custom formatting script.
Scripts will receive the contents of the file to be formatted over STDIN.
They should output the formatted results over STDOUT.
Configure the extension to run your script on files of the right type.
The script will be run with a working directory of the workspace root.
Valid language identifiers can be found here.
* is also a valid identifier, allowing a formatter to be used on any language.
"customLocalFormatters.formatters": [
{
"command": "python format-yml-files.py",
"languages": ["yml"]
}
]
That's it! Your script is now integrated with VSCode as an official formatter.
You can now format your code though the Format Document command (shift+alt+f), enable the editor.formatOnSave option, or use the formatter however else VSCode allows.
Extension Settings
Basic usage is just to set a command and an array of languages it should apply to:
"customLocalFormatters.formatters": [
{
"command": "python format-yml-files.py",
"languages": ["yml"]
}
]
You can also specify platform-specific commands instead if needed:
"customLocalFormatters.formatters": [
{
"command": {
"darwin": "gshuf",
"*": "shuf"
},
"languages": ["yml"]
}
]
Matching Files by Pattern
Instead of (or in addition to) languages, you can choose files with
glob patterns.
Patterns are matched relative to the workspace folder, so **/*.md matches Markdown files anywhere in the workspace
and src/**/*.ts matches TypeScript files under src:
"customLocalFormatters.formatters": [
{
"command": "dprint fmt --stdin ${file}",
"patterns": ["**/*.json", "**/*.md", "**/*.toml"]
}
]
When both languages and patterns are set, a file must match one of the languages and one of the patterns.
Files outside the workspace, and untitled files that have never been saved, don't match any pattern.
Full extension configuration schema and documentation can be found in the package.json file.
Variable Substitution
The command argument can substitute the following patterns:
${file}: The full path of the file being formatted
${insertSpaces}: true if the editor is set to insert spaces, false if tabs
${tabSize}: The width of a tab character, or the number of spaces inserted when pressing tab
eg.:
"customLocalFormatters.formatters": [
{
"command": "treefmt --stdin ${file}",
"languages": ["*"]
}
]
Workspace Trust
Formatters run shell commands from the workspace folder, and most formatting tools load code or
config from the project they run in. So this extension is disabled until you
trust the workspace.
Known Limitations
VSCode doesn't seem to provide a way to name the formatter which an extension creates.
This means that if you register multiple formatters for the same language,
they will unfortunately both show up as 'Custom Local Formatters' and it will be difficult to tell them apart.