spacemacs/layers/+lang/shell-scripts/README.org

#+TITLE: Shell Scripts layer

[[file:img/fish.png]]

* Table of Contents                                         :TOC_4_gh:noexport:
- [[#description][Description]]
  - [[#features][Features]]
- [[#install][Install]]
  - [[#linting][Linting]]
  - [[#style-checking][Style checking]]
- [[#key-bindings][Key Bindings]]

* Description

This simple layer adds support for shell scripting.

Supported scripting files:
- =.sh=
- =.fish=: [[https://github.com/fish-shell/fish-shell][fish shell]]

*Note:* For Windows scripting see the layer =windows-scripts=

** Features
- Auto-completion using [[https://github.com/Alexander-Miller/company-shell][company-shell]]
- =Sh= scripts linting using  [[https://www.shellcheck.net/][shellcheck]]
- =Sh= scripts style checking using [[https://github.com/openstack-dev/bashate][bashate]]

* Install
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =shell-scripts= to the existing =dotspacemacs-configuration-layers= list in this
file.

** Linting
In order to enable =sh= scripts linting, install [[https://www.shellcheck.net/][shellcheck]].

** Style checking
In order to enable =sh= scripts style checking, install [[https://github.com/openstack-dev/bashate][bashate]].

* Key Bindings

| Key Binding | Description                                               |
|-------------+-----------------------------------------------------------|
| ~SPC i !~   | insert shebang in a script file                           |
| ~SPC m \~   | insert end-of-line backslashes to the lines in the region |