![\"01.gif](\"https://c16e-esa-io-public-files.s3-ap-northeast-1.amazonaws.com/uploads/production/attachments/15637/2020/05/28/18740/5aa2ee37-d041-40bf-83eb-dd1f45290eab.gif\")
シェルスクリプトは長くなると処理の境界が不鮮明になりがち。
\nコメントで処理の境界を表現する工夫はよく見かけるが、もっと良い方法はないか考えてみた。
\n:コマンド、&&演算子、複合コマンド()や{}を組み合わせて書くと、処理の境界線がはっきりする。
# Install libraries\ncommand\ncommand\ncommand\n\n# Build app\ncommand\ncommand\n\n# Deploy app to server\ncommand\ncommand\n: \"Install libraries\" && {\n\tcommand\n\tcommand\n\tcommand\n}\n\n: \"Build app\" && {\n\tcommand\n\tcommand\n}\n\n\n: \"Deploy app to server\" && {\n\tcommand\n\tcommand\n}\nシェルスクリプトは作業を自動化するのに便利なツールですが、記述するタスクが増えるにつれて可読性が下がってしまいます。それでも読みやすさを維持するために、様々な工夫をされているのではないでしょうか。
\nコメントも工夫の1つです。処理の境界ごとに宣言的なコメントを書いている人も多いとおもいます。たとえば、リリースを自動化するスクリプトなら、おおまかに次のような構成になっているのではないでしょうか？
\n# Install libraries\ncommand\ncommand\ncommand\n\n# Run tests\ncommand\n\n# Build app\ncommand\ncommand\n\n# Deploy app to server\ncommand\ncommand\n\n# Notify result to Slack channel\ncommand\nコメントの部分は一定の粒度の処理を宣言していて、コマンドの部分はその具体的な実装になっているパターンです。実装の部分は、if分岐があったりと実際はもっと複雑なコードになっていると思います。
\nシェルスクリプトが長くなってくると、どのコマンドからどのコマンドまでがどの処理なのか一見分かりにくくなる問題が出てきます。1
\nBashで処理の境界線をはっきり表現できる名前付きブロック記法2というものを考えてみました。
\n処理の境界線を表現する方法として真っ先に思いついたのが、{}を使って処理のまとまりを複合コマンドとして表現する方法です。例えば次のように:
#!/bin/bash\n\n# Install libraries\n{\n\tcommand\n\tcommand\n\tcommand\n}\n\n# Run tests\n{\n\tcommand\n}\n\n# Build app\n{\n\tcommand\n\tcommand\n}\n\n# Deploy app to server\n{\n\tcommand\n\tcommand\n}\n\n# Notify result to Slack channel\n{\n\tcommand\n}\nこれだけでも処理がグルーピングされ、だいぶ分かりやすくなります。しかし、これだけだと、コメントとブロックの関係性があまり表現できてない感じがします。そこで、:コマンドと&&で説明文と処理を強く関連付けした形に表現しなおしてみます。
#!/bin/bash\n\n: \"Install libraries\" && {\n\tcommand\n\tcommand\n\tcommand\n}\n\n: \"Run tests\" && {\n\tcommand\n}\n\n: \"Build app\" && {\n\tcommand\n\tcommand\n}\n\n: \"Deploy app to server\" && {\n\tcommand\n\tcommand\n}\n\n: \"Notify result to Slack channel\" && {\n\tcommand\n}\nいかがでしょうか？処理の説明と処理の内容が、コメントと比べてなんとなく関連しているように見えませんか？また、シンタクスハイライトで説明文がコメントよりも目立っていて、見出し感も出ていますね。
\n処理の境界をコメントで表現する方法と、名前付きブロック記法を一般化すると次のようになります。
\n# 処理名\n処理...\n: \"処理名\" && {\n 処理...\n}\nコメントで処理の境界線を表現するのと比べて、名前付きブロック記法には次のメリットがあると思いました。
\nブレースで処理がグルーピングされ、インデントもつくため、コードを眺めたときに処理の境界を把握しやすくなります。
\n複合コマンドはネストすることができるため、サブ処理をネストで表現することができます。
\n: \"setup database\" && {\n\t: \"create database\" && {\n\t\tcommand\n\t\tcommand\n\t}\n\t: \"migrate database schema\" && {\n\t\tcommand\n\t\tcommand\n\t}\n\t: \"store dummy data\" && {\n\t\tcommand\n\t\tcommand\n\t}\n}\n記法の構成要素については後述しますが、使用するコードはすべてBashの標準機能です。必要な外部ライブラリなしに記述できるのが特徴です。
\nBashは-xオプションで実行コマンドを出力することができます。
\nコメントは-xオプションでデバッグすることはできませんが、:はコマンドの一種なので、-xオプションで処理名を表示することができデバッグがはかどります。
#!/bin/bash\n\nset -x # デバッグオプション\n\n: \"Install libraries\" && {\n command\n command\n command\n}\n\n: \"Run tests\" && {\n command\n}\n\n: \"Build app\" && {\n command\n command\n}\n\n: \"Deploy app to server\" && {\n command\n command\n}\n\n: \"Notify result to Slack channel\" && {\n command\n}\n+ : 'Install libraries'\n+ command\n+ command\n+ command\n+ : 'Run tests'\n+ command\n+ : 'Build app'\n+ command\n+ command\n+ : 'Deploy app to server'\n+ command\n+ command\n+ : 'Notify result to Slack channel'\n+ command\nエディタで折りたたみ機能を使う人にとっては1つのメリットになるかと思います。
\n処理を一時的に無効にしたい場合は、&&を||に置き換えるだけで対応できます。
#!/bin/bash -eux\n\n: \"Install libraries\" || {\n command\n command\n command\n}\n名前付きブロック記法の「:や{}って何だろう？」と疑問を持たれた方もいると思うので、構成要素についても簡単に説明しておきます。
:コマンド:コマンドはBashでは何もしないコマンドです。そして、常にsuccessで終わります。
: \"do nothing\"\nコメントとの違いは実行されるコマンドという点です。なので、サブシェルや変数を扱うこともできます。
\n#!/bin/bash\nset -x\n: \"current directory is $PWD\"\n+ : 'current directory is /Users/suin/Desktop'\n名前付きブロック記法では、:コマンドを説明文として活用しています。
&&演算子&&演算子は前のコマンドが成功した場合、次のコマンドを実行する演算子です。
\n#!/bin/bash\ntrue && echo 1 # 1は出力される\nfalse && echo 2 # 2は出力されない\n:コマンドは常にsuccessで終わるので、&&演算子以降のコマンドは必ず実行されるというわけです。
{}\nBashでは{}や()で複数のコマンドを1つのコマンドとして複合することができます。
#!/bin/bash\n\n{\n\techo 1\n\techo 2\n\techo 3\n} > /tmp/output\n\ncat /tmp/output\n1\n2\n3\n{}は現在のシェルで、()はサブシェルで実行される違いがあります。
#!/bin/bash\n\nfoo=1\n(\n\tfoo=2\n\techo $foo # 2が出力される。サブシェル内なので親シェルのfooは書き換えない\n)\necho $foo # 1が出力される\n\n{\n\tfoo=2 # 現行シェルで実行されるのでfooが書き換わる\n}\necho $foo # 2\n:コマンド、&&演算子、複合コマンド()や{}を組み合わせて書くと、処理の境界線がはっきりする。:コマンド"},{"tag":"h2","depth":2,"href":"#&&%E6%BC%94%E7%AE%97%E5%AD%90","text":"&&演算子","html":"&&演算子"},{"tag":"h2","depth":2,"href":"#%E8%A4%87%E5%90%88%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%7B%7D","text":"複合コマンド{}","html":"複合コマンド{}"},{"tag":"h1","depth":1,"href":"#%E3%81%BE%E3%81%A8%E3%82%81","text":"まとめ","html":"まとめ"}],"ogpImageUrl":"https://www.datocms-assets.com/29850/1593190022-pastedimage20200627146.png?fm=png&mark64=aHR0cHM6Ly93d3cuZGF0b2Ntcy1hc3NldHMuY29tLzI5ODUwLzE1OTMxNTQ2MzYtdHJhbnNwYXJlbnQtcGl4ZWwucG5nP3c9NDAwJmg9NjQmZml0PWNyb3AmYmxlbmQ2ND1hSFIwY0hNNkx5OTNkM2N1WkdGMGIyTnRjeTFoYzNObGRITXVZMjl0THpJNU9EVXdMekUxT1RFNE16TXlPVEF0WVhaaGRHRnlOVEV5TG1wd1p6OXRZWE5yUFdWc2JHbHdjMlVtWm0wOWNHNW5KbmM5TWpVMkptZzlNalUyJmJsZW5kLWg9NjQmYmxlbmQteD0wJmJsZW5kLXk9MCZibGVuZC1tb2RlPW5vcm1hbCZtYXJrNjQ9YUhSMGNITTZMeTloYzNObGRITXVhVzFuYVhndWJtVjBMMzUwWlhoMFAzUjRkQzFoYkdsbmJqMXRhV1JrYkdVbE1rTnNaV1owSm5SNGRDMW1iMjUwUFhOaGJuTXRjMlZ5YVdZbE1rTmliMnhrSm5SNGRDMWpiMnh2Y2oweU1qRTRNVFltZEhoME5qUTlZek5XY0dKbkpuUjRkQzF6YVhwbFBUTXdKbWc5TmpRJm1hcmsteD02NCZtYXJrLWFsaWduPW1pZGRsZSUyQ2xlZnQ&mark-align=bottom%2Cleft&mark-x=100&mark-y=496&blend64=aHR0cHM6Ly93d3cuZGF0b2Ntcy1hc3NldHMuY29tLzI5ODUwLzE1OTMxNTQ2MzYtdHJhbnNwYXJlbnQtcGl4ZWwucG5nP3c9MTIwMCZoPTYzMCZmaXQ9Y3JvcCZtYXJrNjQ9YUhSMGNITTZMeTkzZDNjdVpHRjBiMk50Y3kxaGMzTmxkSE11WTI5dEx6STVPRFV3THpFMU9UTXhOVEE1TkRBdFkzSmhablJ6YldGdUxUQXhMbkJ1WncmbWFyay1hbGlnbj10b3AlMkNjZW50ZXImbWFyay13PTI1MCZtYXJrLXk9ODAmYmxlbmQ2ND1hSFIwY0hNNkx5OWhjM05sZEhNdWFXMW5hWGd1Ym1WMEwzNTBaWGgwUDNSNGRDMWhiR2xuYmoxdGFXUmtiR1VsTWtOalpXNTBaWEltZEhoMExXWnZiblE5YzJGdWN5MXpaWEpwWmlVeVEySnZiR1FtZEhoMExYQmhaRDB4TURBbWRIaDBMV052Ykc5eVBUSXlNVGd4TmlaMGVIUTJORDAwTkVzek5EUkxialEwVDNJME5FczFORFJMZGpRMFQzRTBORTlZTkRSUFNUUTBSM1UxV1dWdE5UVkRSelZoUzBRMU5WZE5ORFJIVFRaaE5uVTFjR2xQTkRSSGNqUTBSM0UwTkV0TU5EUkRUVFZhUTA0MVdXMU9OVXgxV1RRMFIwNDBORTlYTkRSUGREUTBUMFEwTkV0Mk5rdHBXVFZ5VDFZME5FTk9ORFJIY1RRMFMwdzBORXRETkRSSGRUUTBTMU0yU1VORU5EUkhTVFEwUjIwME5FZGZORFJIWmlaMGVIUXRjMmw2WlQwMU5TWjNQVEV5TURBbWFEMDJNekEmYmxlbmQtbW9kZT1ub3JtYWw&blend-mode=normal"}}}