シェルスクリプトのコードを整形してくれるツール `shfmt`

2019-02-152023-02-15Bash,CentOS,Linux,Ubuntu

シェルスクリプトでコーディングする際に使っているツールを紹介。
( とりあえず殴り書きして、コードフォーマットツールに食わせて整形します。 )

GitHub - mvdan/sh: A shell parser, formatter, and interpreter (POSIX/Bash/mksh)

Contents

1. 必要なもの
2. インストール方法
3. 実行方法

必要なもの

Go
- Macなら brew install golang
- CentOSなら yum install golang

インストール方法

Gihtubのshfmtトップページにインストール方法が書かれています。

2019-02-15現在、 go コマンドが使えれば、以下のコマンドだけでインストールされます。

$ go get -u github.com/mvdan/sh/cmd/shfmt

正常にインストールされていれば、以下のフォルダにコマンドがインストールされています。

# 僕の環境
$ uname -moi
x86_64 MacBookPro10,1 Darwin

$ bash -version
GNU bash, バージョン 5.0.2(1)-release (x86_64-apple-darwin18.2.0)

# HOMEディレクトリ配下にコマンドがインストールされている
$ cd
$ ls .go/bin/shfmt
.go/bin/shfmt*

# 頻繁に使うので、 `$HOME/.go/bin` にパスを通しておく
echo 'export PATH="$PATH:$HOME/.go/bin"' >> ~/.bashrc

# コマンドが実行できるか確認
$ shfmt --help

※ちなみに、CentOS7系サーバでセットアップを行うと、 $HOME/.go ではなく $HOME/go ディレクトリにコマンドがインストールされます。なぜパスが違う？？

実行方法

以下のようなコードを用意。
( test.sh　というファイル名で作成 )

#!/usr/bin/env bash

echo "test1"

if [[ 1 = 2 ]];
then
    echo "test2"
fi

  echo "test3"

case $# in
0)
  echo '引数なし'
    ;;
*)
  echo '引数あり'
  ;;
esac

echo "ありがとう" &&
  echo "そしてありがとう"

フォーマッタを適用するには、コマンド引数にファイルを指定します。

$ shfmt test.sh

#!/usr/bin/env bash

echo "test1"

if [[ 1 == 2 ]]; then
        echo "test2"
fi

echo "test3"

case $# in
0)
        echo '引数なし'
        ;;
*)
        echo '引数あり'
        ;;
esac

echo "ありがとう" &&
        echo "そしてありがとう"

オプションを指定しないと使いにくい
- インデントはタブになっている
- switch-caseをインデントしない
- && や | を先頭に持ってきてくれない

なので、以下のような alias を設定し使っています。(オプションの詳細は shfmt --help を参照。)

alias shfmt='$HOME/.go/bin/shfmt -i 2 -ci -bn -s'

設定後、再度実行。

$ shfmt test.sh
#!/usr/bin/env bash

echo "test1"

if [[ 1 == 2 ]]; then
  echo "test2"
fi

echo "test3"

case $# in
  0)
    echo '引数なし'
    ;;
  *)
    echo '引数あり'
    ;;
esac

echo "ありがとう" \
  && echo "そしてありがとう"