VSCode Command Runner
Run custom shell command defined in vs code configuration and node module package.json
Features
- Run custom shell command
- Run selected content as shell command
- Run custom shell command with selected files by explorer context menu
Extension Settings
You can defined shell command in vs code configuration
{
"command-runner.terminal.name": "runCommand",
"command-runner.terminal.autoClear": true,
"command-runner.terminal.autoFocus": true,
"command-runner.commands": {
"echo workspaceFolder": "echo ${workspaceFolder}",
"echo file": "echo ${file}"
}
}
or in node module package.json
{
"commands": {
"echo workspaceFolder": "echo ${workspaceFolder}",
"echo file": "echo ${file}"
}
}
Multiple commands can be executed sequentially with
Here is an example of formatting golang code
{
"command-runner2.commands": {
"go.format": [
"IFS=;text=$(cat <<EOFL\n${selectedText}\n\nEOFL\n); echo $text | gofmt | iconv -f UTF-8 -t GBK | clip",
"${command:workbench.action.focusActiveEditorGroup}",
"${command:editor.action.clipboardPasteAction}",
],
}
}
Call a link remotely, and a pop-up window displays the result of the request
{
"command-runner2.commands": {
"cht.sh": [
"${command:workbench.action.newGroupRight}${command:workbench.action.files.newUntitledFile}IFS=;text=$(curl -s cht.sh/${input}?style=bw); echo $text | clip",
"${command:editor.action.clipboardPasteAction}"
],
"curls": [
"${command:workbench.action.newGroupRight}${command:workbench.action.files.newUntitledFile}IFS=;text=$(curl -s ${input}); echo $text | clip",
"${command:editor.action.clipboardPasteAction}"
],
"demo": "echo helloworld",
}
}
Key Binding
You can bind custom keys for the command which defined in configuration
{
"key": "ctrl+alt+1",
"command": "command-runner.run",
"args": { "command": "echo file" }
}
Terminal Options
You can customize the terminal for the command
{
"key": "ctrl+alt+1",
"command": "command-runner.run",
"args": {
"command": "echo file",
"terminal": "runCommand"
}
}
or
{
"key": "ctrl+alt+1",
"command": "command-runner.run",
"args": {
"terminal": {
"name": "runCommand",
"cwd": "path/to/runCommand",
"shellArgs": [],
"autoClear": true,
"autoFocus": true
}
}
}
vim keybinding
"vim.visualModeKeyBindingsNonRecursive": [
{
"before": [
"g","f"
],
"commands": [
{
"command": "command-runner2.run",
"args": {
"command": "go.format"
}
}
]
},
Predefined Variable
${file}
: activated file path;
${fileBasename}
: activated file basename;
${fileBasenameNoExtension}
: activated file basename with no extension;
${fileDirname}
: activated file dirname;
${fileExtname}
: activated file extension;
${lineNumber}
: the first selected line number;
${lineNumbers}
: the all selected line number, eg. 41,46,80
;
${columnNumber}
: the first selected column number;
${columnNumbers}
: the all selected column number, eg. 41,46,80
;
${selectedFile}
: the first selected file/folder from the context menu`;
${selectedFiles}
: the selected file/folder list from the context menu or use config, eg. "path/to/file1" "path/to/file2"
;
${selectedText}
: the first selected text;
${selectedTextList}
: the all selected text list, eg. sl1 sl2
;
${selectedTextSection}
: the all selected text section, eg. sl1\nsl2
;
${selectedPosition}
: the selected position list, eg. 21,6
;
${selectedPositionList}
: the all selected position list, eg. 45,6 80,18 82,5
;
${selectedLocation}
: the first selected location, eg. 21,6,21,10
;
${selectedLocationList}
: the all selected location list, eg. 21,6,21,10 22,6,22,10 23,6,23,10
;
${relativeFile}
: activated file relative path;
${workspaceFolder}
: activated workspace folder path;
${workspaceFolderBasename}
: activated workspace folder basename;
${homedir}
: the home directory of the current user;
${tmpdir}
: default directory for temporary files;
${platform}
: os platform;
${env:PATH}
: shell environment variable "PATH";
${config:editor.fontSize}
: vscode config variable;
${command:workbench.action.terminal.clear}
: run vscode command;
${input}
: input a value as parameter;
${input:defaultValue}
: input a value as parameter, and specify the default value;
Usages
- use shortcut
Ctrl+Shift+R
to select custom command
- use shortcut
Ctrl+Alt+R
to run selected content as shell command
- or press
F1
and then select/type Run Command
or Run In Terminal
,
- or right click the Text Editor and then click
Run Command
to select custom command in editor context menu
- or right click the Text Editor and then click
Run In Terminal
to run selected content as shell command in editor context menu