/vscode-sh-snippets

Keyword snippets and micro patterns for Shell Script

Primary LanguageJavaScriptOtherNOASSERTION

Shell Script Snippets

This extension contains keyword snippets and micro patterns for shell script.

What's new in Shell Script Snippets 0.16.0

  • Added l13Snippets.shellScript.useFunctionBlockPadding to enable or disable line padding in function blocks.

Index

  1. Introduction
  2. Shortcut rules for Shell Script
  3. Recommended Settings
  4. Recommended Keyboard Shortcuts
  5. Recommended Extensions

Introduction

The idea of those snippets is to create a workflow with micro patterns. Write one to four characters and you get the keyword or pattern.

Some prefixes are twice, because the rules are matching different patterns like e1 -> echo ; and export ;. Then you have to pick the right one.

The following prefixes are just examples to explain the rules. To see the complete list, please visit SNIPPETS.md. If a keyword or pattern might be missing, please open an issue on Github and make a suggestion.

Shortcut rules for Shell Script

1. The first letter of a word or the upper case in camel or pascal case defines the prefix.

Prefix Snippet
n null
f false
t true
itf if CONDITION; then ... fi
wdd while CONDITION; do ... done

2. An underscore "_" defines a value or subshell.

Prefix Snippet
_ "${}"
__ "$()"

3. An underscore "_" after a character defines a brace scope.

Prefix Snippet
f_ function NAME { ... }
$_ NAME () { ... }

4. The number "1" at the end defines a one line snippet.

Prefix Snippet
e1 echo ...;
s1 shift$0;

5. A case can be defined by the two following prefixes.

Prefix Snippet
_) ) ... ;;
_* *) ... ;;

6. A "b" or a "z" at the end stands for bash or zsh.

Prefix Snippet
s1b source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/.sh";
s1z source "$(cd "$(dirname "${(%):-%x}")" && pwd)/.zsh";

7. A default pattern for a script can be initialized with

Prefix Snippet
$b #!/usr/bin/env bash main () { ... exit 0; };main "$@";
$z #!/usr/bin/env zsh main () { ... exit 0; };main "$@";

Recommended Settings

It is recommended to set the snippet suggestions to top.

"editor.snippetSuggestions": "top",

Recommended Keyboard Shortcuts

Please have the following keyboard shortcuts always in mind, because these are fundamental to get the most out of it. Every tab stop is used only if necessary, because it prevents VS Code to open the IntelliSense menu automatically. So sometimes DownArrow or Cmd/Ctrl + Enter can have the same effect.

macOS

  • Tab - Jump to the next tab stop of the snippet.
  • DownArrow - Move the caret down one line.
  • Cmd + Enter - Insert line below, even if the caret is in the middle of a line.
  • Cmd + Shift + Enter - Insert line above, even if the caret is in the middle of a line.

Windows / Linux

  • Tab - Jump to the next tab stop of the snippet.
  • DownArrow - Move the caret down one line.
  • Ctrl + Enter - Insert line below, even if the caret is in the middle of a line.
  • Ctrl + Shift + Enter - Insert line above, even if the caret is in the middle of a line.

Recommended Extensions