{"id":17835769,"url":"https://github.com/guitarrapc/bash-styleguide","last_synced_at":"2025-08-13T23:32:01.732Z","repository":{"id":250699974,"uuid":"835147218","full_name":"guitarrapc/bash-styleguide","owner":"guitarrapc","description":"Styleguide for Bash scripts","archived":false,"fork":false,"pushed_at":"2024-09-05T00:51:49.000Z","size":278,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-14T20:03:06.660Z","etag":null,"topics":["bash","personally","style-guide","styleguide"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guitarrapc.png","metadata":{"files":{"readme":"README.ja.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-29T08:57:02.000Z","updated_at":"2024-09-05T00:51:33.000Z","dependencies_parsed_at":"2024-10-27T21:24:11.435Z","dependency_job_id":null,"html_url":"https://github.com/guitarrapc/bash-styleguide","commit_stats":null,"previous_names":["guitarrapc/bash-styleguide"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guitarrapc%2Fbash-styleguide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guitarrapc%2Fbash-styleguide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guitarrapc%2Fbash-styleguide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guitarrapc%2Fbash-styleguide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guitarrapc","download_url":"https://codeload.github.com/guitarrapc/bash-styleguide/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229786948,"owners_count":18124002,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","personally","style-guide","styleguide"],"created_at":"2024-10-27T20:26:05.099Z","updated_at":"2024-12-15T05:42:34.135Z","avatar_url":"https://github.com/guitarrapc.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"[![License: CC0-1.0](https://img.shields.io/badge/License-CC0%201.0-lightgrey.svg)](http://creativecommons.org/publicdomain/zero/1.0/)\n\n[English](README.md) | [日本語](README.ja.md)\n\n# bash-styleguide\n\nスタイルガイドは絶対ではありません、必要なら壊してください。本スタイルガイドが目指すのは、Bashスクリプトを書く心理的障壁になるのを避けつつ、Bashスクリプトを書いていて悩んで答えがでない状況を減らすことです。Bashスクリプトは繊細でメンテナンスが難しく嫌いになりやすいことが多いでしょう。それでもBashスクリプトを書くことは必要なので、このスタイルガイドを用意しました。\n\n迷ったときは、一貫性を最優先に決定してください。コードベース全体で1つのスタイルを一貫して使用することで、他の (より重要な) 問題に集中できます。一貫性があれば、自動化も可能になります。多くの場合、「一貫性を保つ」というルールは、「1つだけ選択して、それについて心配するのをやめる」ということになります。これらの点について柔軟性を許可する潜在的な価値は、人々がそれについて議論するコストを上回ります。ただし、一貫性には限界があります。一貫性は、明確な技術的議論や長期的な方向性がない場合に良い決着をつける要因となります。一方で、新しいスタイルに対してコードベースが古いスタイルのまま物事を進める正当化理由に一貫性を用いるべきではありません。\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n# Table of Contents\n\n- [はじめに (Introduction)](#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB-introduction)\n  - [自動化支援 (Automation Support)](#%E8%87%AA%E5%8B%95%E5%8C%96%E6%94%AF%E6%8F%B4-automation-support)\n  - [スタイルガイドでどう変わる (How the Style Guide Changes)](#%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%82%AC%E3%82%A4%E3%83%89%E3%81%A7%E3%81%A9%E3%81%86%E5%A4%89%E3%82%8F%E3%82%8B-how-the-style-guide-changes)\n- [背景 (Background)](#%E8%83%8C%E6%99%AF-background)\n  - [どのシェルを使うか (Which Shell to Use)](#%E3%81%A9%E3%81%AE%E3%82%B7%E3%82%A7%E3%83%AB%E3%82%92%E4%BD%BF%E3%81%86%E3%81%8B-which-shell-to-use)\n  - [いつシェルを使うか (When to use Shell)](#%E3%81%84%E3%81%A4%E3%82%B7%E3%82%A7%E3%83%AB%E3%82%92%E4%BD%BF%E3%81%86%E3%81%8B-when-to-use-shell)\n  - [シェルの実行環境 (Shell Execution Environment)](#%E3%82%B7%E3%82%A7%E3%83%AB%E3%81%AE%E5%AE%9F%E8%A1%8C%E7%92%B0%E5%A2%83-shell-execution-environment)\n- [シェルファイルとインタプリタ呼出 (Shell Files and Interpreter Invocation)](#%E3%82%B7%E3%82%A7%E3%83%AB%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%A8%E3%82%A4%E3%83%B3%E3%82%BF%E3%83%97%E3%83%AA%E3%82%BF%E5%91%BC%E5%87%BA-shell-files-and-interpreter-invocation)\n  - [ファイル拡張子 (File Extensions)](#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E6%8B%A1%E5%BC%B5%E5%AD%90-file-extensions)\n  - [SUID/SGID](#suidsgid)\n- [環境 (Environment)](#%E7%92%B0%E5%A2%83-environment)\n  - [スクリプトの呼び出し (Script Invocation)](#%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%97%E3%83%88%E3%81%AE%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97-script-invocation)\n  - [共通関数スクリプト (Common Function Scripts)](#%E5%85%B1%E9%80%9A%E9%96%A2%E6%95%B0%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%97%E3%83%88-common-function-scripts)\n  - [スクリプトの引数制御 (Script Argument Control)](#%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%97%E3%83%88%E3%81%AE%E5%BC%95%E6%95%B0%E5%88%B6%E5%BE%A1-script-argument-control)\n  - [デバッグモードとドライランモード (Debug and Dry-run Mode)](#%E3%83%87%E3%83%90%E3%83%83%E3%82%B0%E3%83%A2%E3%83%BC%E3%83%89%E3%81%A8%E3%83%89%E3%83%A9%E3%82%A4%E3%83%A9%E3%83%B3%E3%83%A2%E3%83%BC%E3%83%89-debug-and-dry-run-mode)\n  - [ローカルで実行可能にする (Make It Executable Locally)](#%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%AB%E3%81%A7%E5%AE%9F%E8%A1%8C%E5%8F%AF%E8%83%BD%E3%81%AB%E3%81%99%E3%82%8B-make-it-executable-locally)\n  - [STDOUT vs STDERR](#stdout-vs-stderr)\n- [命名規則 (Naming Conventions)](#%E5%91%BD%E5%90%8D%E8%A6%8F%E5%89%87-naming-conventions)\n  - [関数名 (Function Names)](#%E9%96%A2%E6%95%B0%E5%90%8D-function-names)\n  - [変数名 (Variable Names)](#%E5%A4%89%E6%95%B0%E5%90%8D-variable-names)\n- [コメント (Comments)](#%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88-comments)\n  - [ファイルヘッダー (File Header)](#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%83%98%E3%83%83%E3%83%80%E3%83%BC-file-header)\n  - [コメントの実装 (Implementation Comments)](#%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88%E3%81%AE%E5%AE%9F%E8%A3%85-implementation-comments)\n  - [TODO コメント (TODO Comments)](#todo-%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88-todo-comments)\n- [フォーマット (Formatting)](#%E3%83%95%E3%82%A9%E3%83%BC%E3%83%9E%E3%83%83%E3%83%88-formatting)\n  - [タブとスペース (Tabs and Spaces)](#%E3%82%BF%E3%83%96%E3%81%A8%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9-tabs-and-spaces)\n  - [行の長さと長い文字列 (Line Length and Long Strings)](#%E8%A1%8C%E3%81%AE%E9%95%B7%E3%81%95%E3%81%A8%E9%95%B7%E3%81%84%E6%96%87%E5%AD%97%E5%88%97-line-length-and-long-strings)\n  - [パイプライン (Pipelines)](#%E3%83%91%E3%82%A4%E3%83%97%E3%83%A9%E3%82%A4%E3%83%B3-pipelines)\n  - [ループ (Loops)](#%E3%83%AB%E3%83%BC%E3%83%97-loops)\n  - [case文 (Case statement)](#case%E6%96%87-case-statement)\n  - [変数展開 (Variable expansion)](#%E5%A4%89%E6%95%B0%E5%B1%95%E9%96%8B-variable-expansion)\n  - [クォート (Quoting)](#%E3%82%AF%E3%82%A9%E3%83%BC%E3%83%88-quoting)\n  - [関数の宣言 (Function Declaration)](#%E9%96%A2%E6%95%B0%E3%81%AE%E5%AE%A3%E8%A8%80-function-declaration)\n- [機能とバグ (Features and Bugs)](#%E6%A9%9F%E8%83%BD%E3%81%A8%E3%83%90%E3%82%B0-features-and-bugs)\n  - [ShellCheckを使う (Use ShellCheck)](#shellcheck%E3%82%92%E4%BD%BF%E3%81%86-use-shellcheck)\n  - [コマンド置換 (Command Substitution)](#%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E7%BD%AE%E6%8F%9B-command-substitution)\n  - [Test構文 (Test Expression)](#test%E6%A7%8B%E6%96%87-test-expression)\n  - [文字列のテスト (Testing Strings)](#%E6%96%87%E5%AD%97%E5%88%97%E3%81%AE%E3%83%86%E3%82%B9%E3%83%88-testing-strings)\n  - [ファイル名のワイルドカード展開 (Wildcard Expansion of Filenames)](#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E5%90%8D%E3%81%AE%E3%83%AF%E3%82%A4%E3%83%AB%E3%83%89%E3%82%AB%E3%83%BC%E3%83%89%E5%B1%95%E9%96%8B-wildcard-expansion-of-filenames)\n  - [Evalの禁止 (Eval is Evil)](#eval%E3%81%AE%E7%A6%81%E6%AD%A2-eval-is-evil)\n  - [配列 (Arrays)](#%E9%85%8D%E5%88%97-arrays)\n  - [whileへのパイプ (Pipes to While)](#while%E3%81%B8%E3%81%AE%E3%83%91%E3%82%A4%E3%83%97-pipes-to-while)\n  - [forループ (For Loops)](#for%E3%83%AB%E3%83%BC%E3%83%97-for-loops)\n  - [算術演算 (Arithmetic)](#%E7%AE%97%E8%A1%93%E6%BC%94%E7%AE%97-arithmetic)\n- [コマンド呼び出し (Calling Commands)](#%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97-calling-commands)\n  - [返り値判定 (Checking Return Values)](#%E8%BF%94%E3%82%8A%E5%80%A4%E5%88%A4%E5%AE%9A-checking-return-values)\n  - [エラー処理 (Error Handling)](#%E3%82%A8%E3%83%A9%E3%83%BC%E5%87%A6%E7%90%86-error-handling)\n  - [ビルトインコマンド vs 外部コマンド (Builtin Commands vs. External Commands)](#%E3%83%93%E3%83%AB%E3%83%88%E3%82%A4%E3%83%B3%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89-vs-%E5%A4%96%E9%83%A8%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89-builtin-commands-vs-external-commands)\n- [スクリプトの安定化 (Script Stabilization)](#%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%97%E3%83%88%E3%81%AE%E5%AE%89%E5%AE%9A%E5%8C%96-script-stabilization)\n  - [再実行可能なスクリプトを書く (Writing Rerunnable Scripts)](#%E5%86%8D%E5%AE%9F%E8%A1%8C%E5%8F%AF%E8%83%BD%E3%81%AA%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%97%E3%83%88%E3%82%92%E6%9B%B8%E3%81%8F-writing-rerunnable-scripts)\n  - [変更前に状態の確認を行う (Check State Before Changing)](#%E5%A4%89%E6%9B%B4%E5%89%8D%E3%81%AB%E7%8A%B6%E6%85%8B%E3%81%AE%E7%A2%BA%E8%AA%8D%E3%82%92%E8%A1%8C%E3%81%86-check-state-before-changing)\n  - [一時ファイルの安全な作成 (Safely Creating Temporary Files)](#%E4%B8%80%E6%99%82%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E5%AE%89%E5%85%A8%E3%81%AA%E4%BD%9C%E6%88%90-safely-creating-temporary-files)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n# はじめに (Introduction)\n\nBashスクリプトのスタイルガイドを示します。このスタイルガイドは、[Googleスタイルガイド (rev 2.03)](https://google.github.io/styleguide/shellguide.html)、[icy/bash-coding-style](https://github.com/icy/bash-coding-style)をベースに、一部独自規約で構成されています。意図的に独自規約にした項目は`(独自)`と明示します。\n\n用いる表示は次の通りです。\n\n| 表記 | 意味 |\n| --- | --- |\n| ✔️ DO | 推奨します。 |\n| ❌ AVOID | 推奨しません。避ける努力をしてください。 |\n| ⚠️ CONSIDER | 可能か検討してください。状況によっては適用することがあります。 |\n\n## 自動化支援 (Automation Support)\n\nスタイルガイドを守るにあたり、次の自動化が支援します。自動化支援によって注意されたことを守ることでスタイルガイドのほぼすべてが満たされます。(スクリプト構造は担保されません)\n\n* PRで`shellcheck`の実行: ShellCheckのerrorがあった場合、CIで検出、注意を投げかけます\n* インデントはEditorConfigで自動修正がかかります。VSCodeで[EditorConfig.EditorConfig](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)をインストールすることで、リアルタイムで適用されます\n* VSCodeで[timonwong.shellcheck](https://marketplace.visualstudio.com/items?itemName=timonwong.shellcheck)をインストールすることで、リアルタイムでShellCheckの結果を確認できます\n* ローカルでshellcheckを実行する手順を実行できます。次のコマンドを実行します\n\n```shell\npaths=(\".\")\nfor item in \"${paths[@]}\"; do\n  for script in $(find \"${item}\" -type f -name \"*.sh\" | grep -v \"/.git/\"); do\n    echo \"## shellcheck: ${script}\"\n    shellcheck '--external-sources' \"$script\"\n  done\ndone\n```\n\n## スタイルガイドでどう変わる (How the Style Guide Changes)\n\nスタイルガイドに沿ったスクリプトは次の対応が標準的に入っていると期待できます。\n\n* スクリプト構造が統一されます。スタイルガイドに示した通りの構造でスクリプト構造が一定になります\n* shellcheckに対応します。shellcheckの標準実行で検出されるものはなく、一部過剰な警告はインラインで無視するためdisableされています\n* CIによる`shellcheck`の自動実行が行われます。これにより`shellcheck`に違反した記述はPR時点で検出されます\n* ローカルで`shellcheck`を実行する手順が明記されます。これによりCIでの警告をローカルで再現、先につぶすことができます\n* 共通関数がサポートされ、`common::print`のようなログ関数やデバッグ有効化がサポートされます。これによりログフォーマットの統一、デバッグ機能の統一的な有効化が可能になります\n* `--debug`引数がサポートされます。これによりスクリプトの変更なく`set -e`を有効にして実行できます\n* `--dry-run`引数がサポートされます。作用のあるスクリプトで設定されており、処理を反映することなく何が実行されるか検証可能になります\n* `--aws-args`引数がサポートされます。awsコマンドを含むスクリプトで引数が設定されており、ローカルの認証情報でスクリプトを実行できます\n* 実行時にスクリプトの引数が表示されます。これにより処理開始前に何がどのような値で開始するか明確になります\n\n自分が書くときは、スクリプトの構造に沿っていること、shellcheckの問題がないことを確認してください。この2点を満たすことでほとんどの些細なミスを防ぎ、一定のスクリプトデバッガビリティを確保できます。\n\n* [スクリプトの構造 (Script Structure)](#スクリプトの構造-script-structure)にそってスクリプトを作成してください\n  * --dry-runや--debugなどの共通引数を用意してください\n  * 引数の初期化を行いましょう\n  * 共通関数を用いたログ出力を行いましょう\n  * 既存スクリプトをコピーするとやりやすいでしょう\n* shellcheckの問題がローカル/PRで検出されないことを確認してください\n\n# 背景 (Background)\n\n## どのシェルを使うか (Which Shell to Use)\n\n\u003e **Note** 独自規約 (ベース: Googleスタイルガイド)\n\n* ✔️ DO: すべてのスクリプトはBashを用います\n* ✔️ DO: スクリプトの先頭に`#!/bin/bash`を記述します\n* ✔️ DO: シェルオプション設定に`set -euo pipefail`を用います。(独自)\n* ⚠️ CONSIDER: 他のシェルを使用する場合、その理由をコメントで記述します。(独自)\n\nBashを用いてください。実行可能ファイルは`#!/bin/bash`と最小限のフラグで始めます。全ての実行可能シェルスクリプトを`bash`に制限することで、どのマシンにもインストールされている一貫したシェルを使用できます。唯一の例外は、コーディング対象によって強制される場合です。例えば、Alpine Linuxはashがデフォルトであるため`/bin/sh`を用います。\n\nシェルオプションの設定に`set`を利用することで、スクリプトを`bash script_name`として呼び出してもその機能を損なわないようにします。`set -euo pipefail`は、スクリプトのエラーを早期に自動検出し、エラーが発生した場合にスクリプトを終了させるためのものです。`set -e`はエラーが発生した場合にスクリプトを終了させるためのものです。`set -u`は未定義の変数を参照した場合にエラーを発生させるためのものです。`set -o pipefail`はパイプラインの途中でエラーが発生した場合にスクリプトを終了させるためのものです。\n\n**推奨 (recommended)**\n\n```shell\n#!/bin/bash\nset -euo pipefail\n```\n\n**非推奨 (discouraged)**\n\n```shell\n#!/bin/bash\n# setがありません\n```\n\n```shell\n#!/bin/bash -euo pipefail\n# setにしてください。bash ./function.sh としたとき-euoは無効になります。\n```\n\n## いつシェルを使うか (When to use Shell)\n\n\u003e **Note** 独自規約 (ベース: Googleスタイルガイド)\n\n* ✔️ DO: 小さなユーティリティまたは単純なラッパー スクリプトにのみ使用してください\n* ✔️ DO: GitHub ActionsなどCIで数行のスクリプトを書きたくなった場合、yamlファイルに埋め込むのではなくシェルスクリプトを作成してください。(独自)\n* ✔️ DO: GitHub ActionsなどCIで複数のワークフローでパラメーター違いの同処理を呼び出す場合、yamlファイルに埋め込むのではなくシェルスクリプトを作成してください。(独自)\n* ⚠️ CONSIDER: もしパフォーマンスが重要な場合、他言語を含めてシェル以外の手段を検討してください\n* ⚠️ CONSIDER: 100行を超えるスクリプトや、単純ではない制御フロー ロジックを使用するスクリプトを書いている場合は、今すぐにより構造化された言語で書き直す必要があります。スクリプトは大きくなることを念頭に置いてください。後で時間のかかる書き直しを避けるために、早めにスクリプトを書き直してください\n* ⚠️ CONSIDER: コードの複雑さを評価するときは (言語を切り替えるかどうかを決定する場合など)、コードの作成者以外の人がコードを簡単に保守できるかどうかを考慮してください\n\n主に他のユーティリティを呼び出し、比較的少ないデータ操作しか行わない場合、シェルはタスクに適した選択肢です。シェルスクリプトは開発言語ではありませんが、CIでさまざまなユーティリティスクリプトの作成に使用されています。このスタイルガイドは、シェルスクリプトを広範囲に展開して使用することを提案するものではなく、シェルスクリプトの使用を認めるものです。\n\nシェルスクリプトは小さな用途やシンプルなラッパースクリプトとして利用してください。特に、GitHub Actionsにおいて「複数行に渡る処理」や「複数のワークフローで再利用する処理」を書く場合にシェルスクリプトを用います。Bashはテキストを扱うことが容易な一方、あまりにも複雑な処理や言語/アプリ特有の処理を扱うケースでは向いていません。構造化してかける言語を検討するといいでしょう。\n\n## シェルの実行環境 (Shell Execution Environment)\n\n\u003e **Note** 独自規約\n\n* ✔️ DO: シェルの実行はGitHub Actionsの`ubuntu-latest`ランナーの実行を想定します\n* ✔️ DO: ローカルで実行する場合、Ubuntu (WSL)を用います\n* ⚠️ CONSIDER: 他の環境で実行する場合、その環境に合わせてシェルスクリプトを修正してください。(macOSなど)\n\nシェルスクリプトはGitHub Actionsの`ubuntu-latest`ランナーの実行を想定しています。ローカルで実行する場合はUbuntu (WSL)を用います。\n他環境ではGNU系コマンドである保証がないため、環境に合わせてシェルスクリプトを修正する必要があります。\n\n# シェルファイルとインタプリタ呼出 (Shell Files and Interpreter Invocation)\n\n## ファイル拡張子 (File Extensions)\n\n\u003e **Note** 独自規約 (ベース: Googleスタイルガイド)\n\n* ✔️ DO: 外部から呼び出すスクリプトは`.sh`拡張子を用います\n* ✔️ DO: 外部から呼び出さない内部専用のスクリプトには拡張子を用いません。(独自)\n\n実行可能ファイルは「`.sh`(強く推奨)」か「拡張子なし」にします。外部から呼び出すスクリプトは必ず`.sh`とし実行可能にしません。\n\n**推奨 (recommended)**\n\n```shell\n# 外部から呼び出すスクリプト\nfoo.sh\n\n# 内部からしかよびださないスクリプト\n_functions\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# 外部から呼び出すスクリプトを拡張子なしにするのはやめましょう\nfoo\n\n# 内部からしかよびださないスクリプトなのに.shをつけるのはやめましょう\nfunctions.sh\n```\n\n## SUID/SGID\n\n\u003e **Note** 独自規約 (ベース: Googleスタイルガイド)\n\n* ✔️ DO: 権限昇格が必要な場合`sudo`を使用してください\n* ❌ AVOID: SUIDやSGIDは禁止です\n* ❌ AVOID: GitHub Actionsのスクリプトは`sudo`も禁止です。(独自)\n\nシェルスクリプトにおいてSUIDとSGIDは禁止です。シェルにはセキュリティの問題が多々あり、SUID/SGIDを許可するのに足る安全性を確保すること困難を極めます。bashはSUIDの実行を困難にしますが、プラットフォームによってはそれが可能であるため明示的に禁止します。権限の昇格が必要であれば`sudo`で呼び出してください。\n\nGitHub Actionsで実行する場合`sudo`、SUID、SGIDは使う必要がないため禁止します。\n\n**推奨 (recommended)**\n\n```shell\n# 呼び出し時にsudoを使用 (GitHub Actionsでは禁止)\nsudo foo.sh\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# スクリプト内部でsuやrootユーザー切り替え\n```\n\n# 環境 (Environment)\n\n## スクリプトの呼び出し (Script Invocation)\n\n\u003e **Note** 独自規約\n\n* ✔️ DO: スクリプトの実行は、bashを経由して呼び出します\n* ✔️ DO: スクリプト引数はクォートで囲みます。ただし固定文字列のようにスペースの入る余地がない場合はクォートを省略しても構いません\n* ❌ AVOID: スクリプトを直接実行してはいけません\n\nスクリプトを直接実行することは避けてください。`bash`を経由して呼び出すことで、クリプトの実行環境を統一しスクリプトの実行環境を保証するとともに、exitによってインタラクティブに操作している現在のシェルが終了するのを防ぎます。\n\n**推奨 (recommended)**\n\n```shell\nbash ./foo.sh\n\n# スペースがない場合はクォートを省略しても構いません\nbash ./foo.sh --baz true\n\n# クォ－トで囲むことでスペースが入っても安全になる\nbash ./foo.sh --foo \"hello world\" --bar \"$bar\"\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# 直接呼出し\n. ./foo.sh\n\n# chmod +xで実行権限を与えて実行もだめ\nchmod +x ./foo.sh\n./foo.sh\n\n# bar変数にスペースが含まれたり、空文字列だと引数解釈がおかしくなる可能性がある\nbash ./foo.sh --foo hello world --bar $bar\n```\n\n## 共通関数スクリプト (Common Function Scripts)\n\n\u003e **Note** 独自規約\n\n* ✔️ DO: 共通関数の呼び出しは`.`を用いてください\n\n共通関数を呼び出す場合、`source`ではなく`.`用いてください。これは`.`がPOSIX準拠であるためです。ただ、shellcheck SC1091は避けるのが難しい場合もあるため、その時はshellcheck disableを用いてください。\n\n**推奨 (recommended)**\n\n```shell\n# shellcheck disable=SC1091\n. \"$(dirname \"${BASH_SOURCE[0]}\")/_functions\"\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# sourceではなく . を用いる\nsource \"$(dirname \"${BASH_SOURCE[0]}\")/_functions\"\n```\n\n## スクリプトの引数制御 (Script Argument Control)\n\n\u003e **Note** 独自規約\n\n* ✔️ DO: 引数処理はwhile文で回しつつcase文で処理します\n* ✔️ DO: スクリプトの引数は`--パラメーター名 値`のセットで受け取ります。パラメーター名は十分に理解できる名前を付けます\n* ✔️ DO: スクリプトの引数指定が不要なオプショナル引数を用いる場合、ローカル変数で`${_変数名:=デフォルト値}`を使って初期化します\n* ⚠️ CONSIDER: `--パラメーター名`単独で受け取ることは避けてください、ただし状況によっては許容され、この場合`shift 2`ではなく`shift`を用います\n* ❌ AVOID: スクリプトの引数はをパラメーター指定なしで`値1 値2 値3`のように受け取りません\n* ❌ AVOID: スクリプトの引数名に`--f`のような1文字の引数名や`--ns`のような省略名は避けてください\n\nスクリプトの引数制御は引数をwhileでループさせながらcase文で判定、shiftで引数をずらしながら解析します。スクリプトの引数として受ける場合、ローカル変数や定数と区別するため変数は`_大文字`とします。スクリプトの引数は、処理本体へ入る前に初期化を確実に行い、ログ表示を行うことでデバッグを容易にします。\n\n**推奨 (recommended)**\n\n```shell\nset -euo pipefail # -uによって初期化されていない変数で処理を止める\n\nwhile [[ $# -gt 0 ]]; do\n  case $1 in\n    # required (省略不能な引数。指定しないと初期化で止める)\n    --bar-piyo) _BAR_PIYO=$2; shift 2; ;; # `--bar-piyo \"値\"`で受け取る\n    # optional (省略可能な引数。デフォルト値で初期化する)\n    --optional) _OPTIONAL=$2; shift 2; ;; # 省略可能。変数の表示時にデフォルト値で初期化する\n    *) shift ;;\n  esac\ndone\n\n# 変数を初期化する\ncommon::print \"引数:\"\ncommon::print \"--bar-piyo=${_BAR_PIYO}\" # オプショナルな引数は、省略されてもここでデフォルト値で初期化する\ncommon::print \"--optional=${_OPTIONAL:=\"true\"}\" # オプショナルな引数は、省略されてもここでデフォルト値で初期化する\n```\n\n**非推奨 (discouraged)**\n\n```shell\nset -euo pipefail # -uによって初期化されていない変数で処理を止める\n\nwhile [[ $# -gt 0 ]]; do\n  case $1 in\n    # required\n    -f) _FOO_=$2; shift 2; ;; # ハイフン一つの引数名はダメ\n    --bar) _BAR=true; shift; ;; # 引数なしで受け取ることは可能なら避けてtrue/falseで受けるほうが望ましい\n    # optional\n    -o) _OPTIONAL=$2; shift 2; ;; # 変数初期化がないので引数に指定されないと実行時に落ちる\n    *) shift ;;\n  esac\ndone\n\n# 変数初期化なし\n```\n\n## デバッグモードとドライランモード (Debug and Dry-run Mode)\n\n\u003e **Note** 独自規約\n\n* ✔️ DO: `--debug true|false`のようなデバッグモードを用意します\n* ✔️ DO: `--dry-run true|false`のようなドライランモードを実行不能な場合を除いて用意します\n* ✔️ DO: `--dry-run`引数省略時のデフォルト値は`true`にします\n\nスクリプトの共通の引数として`--debug`と`--dry-run`を入れることを検討してください。デバッグモードやドライランモードはスクリプトの動作を変更するため、デバッグやテストを行う際に有用です。デバッグモードは`set -x`を有効にすることでスクリプトの実行をトレースします。ドライランモードは実際のコマンドを実行せず、実行されるコマンドを表示したりコマンドのドライランモードを利用することで、スクリプトの動作を確認します。\nデバッグモードやドライランを用意する初期化処理でスクリプト全体が長くなりがちですが、スクリプトの動作を変更するための引数は必要なものと割り切ります。\n\n`--dry-run`引数省略時のデフォルト値は`true`にすることで、スクリプトを実行しても間違って実行されないようにします。これは不意の実行を防ぐためにとても有用です。\n\n**推奨 (recommended)**\n\n```shell\n# ... 省略\n\n# 引数処理\nwhile [[ $# -gt 0 ]]; do\n  case $1 in\n    # optional\n    --debug) _DEBUG=$2; shift 2; ;; # デバッグモード\n    --dry-run) _DRYRUN=$2; shift 2; ;; # ドライランモード\n    *) shift ;;\n  esac\ndone\n\n# 変数を初期化する\ncommon::print \"引数:\"\ncommon::print \"--debug=${_DEBUG:=\"false\"}\" # デフォルトfalseにしてデバッグモードは必要な時だけ有効にします\ncommon::print \"--dry-run=${_DRYRUN:=\"true\"}\" # デフォルトtrueにしてスクリプトをただ実行しても間違って実行されないようにします\n\n# デバッグモードを設定する\ncommon::debug_mode # 共通スクリプトでset -xがかかります\n\n# ドライランの用意\ndryrun=\"\"\ndryrun_k8s=\"\"\ndryrun_aws=\"\"\ndryrun_az=\"\"\nif [[ \"${_DRYRUN}\" == \"true\" ]]; then\n  dryrun=\"echo (dryrun) \"\n  dryrun_k8s=\"--dry-run=server\"\n  dryrun_aws=\"--dryrun\"\n  dryrun_az=\"--dryrun\"\nfi\n\n# 共通関数を使ってデバッグメッセージを出力できる。common::debugの実装は次のようなものをイメージしてください\n# function common::debug {\n#   if [[ \"${_DEBUG:=false}\" == \"true\" ]]; then\n#     echo \"$*\"\n#   fi\n# }\ncommon::debug \"デバッグメッセージ\"\n\n# コマンドをechoに置き換えることでドライランモードを実現\n$dryrun dotnet run ...\n\n# kubectlは--dry-run=serverを指定することでサーバーサイド検証付きでドライランモードを実現\nkubectl apply -f ./manifests ${dryrun_k8s}\n\n# aws s3 cpは--dryrunを差し込むことでドライランモードを実現\naws s3 cp $dryrun_aws ...\n\n# aws s3以外はドライランモードがないことがほとんどなのでechoに差し替えが妥当\n$dryrun aws scheduler ...\n\n# az webappは--dryrunを差し込むことでドライランモードを実現\naz webapp up $dryrun_az ...\n\n# az containerappは--dryrunがないのでechoに差し替えが妥当\n$dryrun az containerapp ...\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# 強制で-xで入れるとスクリプト実行が読みづらいのでデバッグモードを用意しましょう\nset -euxo pipefail\n\n# 引数処理\nwhile [[ $# -gt 0 ]]; do\n  case $1 in\n    # --debugは必須です。入れてね。\n    # --dry-runできそうなのに入れないのはなぜ?\n    *) shift ;;\n  esac\ndone\n\n# デバッグモードがないので標準出力される\necho \"デバッグメッセージ\"\n\n# dry-runできそうじゃない!?\ndotnet run ...\n\n# dry-runできそうじゃない!?\nkubectl apply -f ./manifests\n\n# dry-runできそうじゃない!?\naws s3 cp ...\n\n# dry-runできそうじゃない!?\naz webapp up ...\n```\n\n## ローカルで実行可能にする (Make It Executable Locally)\n\n\u003e **Note** 独自規約\n\n* ✔️ DO: スクリプトはローカル環境で実行可能にします\n* ❌ AVOID: 利用者にスクリプトで使っているCLIの知識を求めることは避けてください\n\nスクリプトをローカル環境で実行可能にすることで、スクリプトの開発が用意になり、また動作を確認しやすくなります。スクリプトの実行を可能にするためには、AWS引数やドライランモードなどのオプションを提供することが有効です。一方で、`az login`のように事前にログインすることで以降のセッションで認証指定する必要がない場合は、この考慮は不要です。\n\n**推奨 (recommended)**\n\n```shell\n# ローカル実行時に--aws-argsを指定することでAWS認証情報を渡す\n$ bash ./my_script.sh --aws-args \"--profile aws-profile --region ap-northeast-1\" --dry-run true\n```\n\n```shell\n# ... 省略\n\n# 引数処理\nwhile [[ $# -gt 0 ]]; do\n  case $1 in\n    # optional\n    --aws-args) _AWS_ARGS=$2; shift 2; ;;\n    *) shift ;;\n  esac\ndone\n\n# 変数を初期化する\ncommon::print \"引数:\"\ncommon::print \"--aws-args=${_AWS_ARGS:=\"\"}\"\n\n# ... 省略\n\n# ローカル認証用の引数をスクリプト実行時に与えて実行できる\naws rds describe-db-clusters $_AWS_ARGS\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# ローカル実行時に環境変数などを駆使してAWS認証情報を渡すことになる。実行者にaws cli知識が必要になる。\n$ AWS_PROFILE=aws-profile AWS_REGION=ap-northeast-1 my_script.sh\n```\n\n```shell\n# ... 省略\n\n# awsコマンドをローカルで実行できるかは環境次第で、ユーザーを選んでしまう\naws rds describe-db-clusters\n```\n\n\n## STDOUT vs STDERR\n\n\u003e **Note** 独自規約 (ベース: Googleスタイルガイド)\n\n* ✔️ DO: エラーメッセージはSTDERRに出力します\n* ❌ AVOID: エラーメッセージをSTDOUTに出力しないでください\n\nエラーメッセージは`STDERR`に出力することで、通常の状態と本質的な問題の切り分けを容易にします。スクリプトで独自関数を定義するのではなく共通関数`common::error`関数を用いてください。\n\n**推奨 (recommended)**\n\n```shell\nfunction common::error {\n  echo \"ERROR(${FUNCNAME[1]:-unknown}):: $*\" \u003e\u00262\n}\n\nif ! do_something; then\n  common::error \"Unable to do_something\"\n  exit 1\nfi\n```\n\n**非推奨 (discouraged)**\n\n```shell\nif ! do_something; then\n  echo \"Unable to do_something\"\n  exit 1\nfi\n```\n\n# 命名規則 (Naming Conventions)\n\n## 関数名 (Function Names)\n\n\u003e **Note** 独自規約 (ベース: Googleスタイルガイドとicy/bash-coding-style)\n\n* ✔️ DO: キーワード`function`を付けます。(独自)\n* ✔️ DO: 小文字、単語の区切りにはアンダースコアを利用します\n* ✔️ DO: 共通スクリプトはパッケージと関数名を`::`で区切ります\n* ✔️ DO: 共通スクリプト内部でしか利用されなくない関数は`__`をプレフィックスにつけます。(独自)\n* ❌ AVOID: 関数名の後にカッコ`()`はつけません。(独自)\n\n単一の関数を書いている場合、小文字と単語の区切りにはアンダースコアを利用してください。もし共通関数を書いている場合、関数名はパッケージ名と`::`で分離します。\nブレースは関数名と同じ行に記述します。関数名の後に`()`が存在する場合`function`キーワードは必須じゃありませんが、関数であることを明示するためにfunctionを用い`()`は利用しません。\n\n**推奨 (recommended)**\n\n```shell\n# 単一の関数\nfunction my_func {\n  ...\n}\n\n# パッケージとして公開する関数\nfunction mypackage::my_func {\n  ...\n}\n\n# パッケージの内部でしか使ってほしくない関数は__をプレフィックスにつける\nfunction __super_internal_func {\n  ...\n}\n\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# functionがなく()が利用されている\nMyFunc () {\n  ...\n}\n\n# 関数名がパスカルケース\nfunction MyFunc {\n  ...\n}\n\n# 関数名がキャメルケース\nfunction myFunc  {\n  ...\n}\n\n# パッケージと関数名の区切り::がない\nfunction package_my_func {\n  ...\n}\n```\n\n## 変数名 (Variable Names)\n\n\u003e **Note** 独自規約 (ベース: Googleスタイルガイドとicy/bash-coding-style)\n\n* ✔️ DO: 関数名と同様に小文字、単語の区切りにはアンダースコアを利用します\n* ✔️ DO: ループの変数名は、ループ対象の変数と似た名前にします\n\n**推奨 (recommended)**\n\n```shell\nfor zone in \"${zones[@]}\"; do\n  something_with \"${zone}\"\ndone\n```\n\n**非推奨 (discouraged)**\n\n```shell\nfor item in \"${zones[@]}\"; do\n  something_with \"${item}\"\ndone\n```\n\n定数と環境変数は大文字で宣言します。定数はファイルの先頭で宣言します。\n\n* ✔️ DO: 定数は全て大文字、区切りはアンダースコア、ファイルの先頭で宣言します\n* ✔️ DO: 定数とエクスポートされる環境変数は大文字で宣言します\n\n**推奨 (recommended)**\n\n```shell\n# 定数\nreadonly PATH_TO_FILES='/some/path'\n\n# 定数と環境変数\ndeclare -xr ORACLE_SID='PROD'\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# 定数を小文字宣言\nreadonly path_to_file='/some/path'\n\n# 定数と環境変数を小文字宣言\ndeclare -xr oracle_sid='PROD'\n```\n\nスクリプトの引数処理のように親スコープとなるユーザー実行から与えられる変数は`_大文字`、区切りはアンダースコアで宣言します。\n\nグローバル変数はシェル全体で使用されるため、それらの利用時にエラーを捕捉することが重要です。読み取り専用を意図した変数をの宣言を明示的に行います。\n\n* ⚠️ CONSIDER: `readonly`や`declare -r`を使って読み取り専用を保証します。このスタイルは可能であれば実施しますが無理に行う必要はありません。(独自)\n\n**推奨 (recommended)**\n\n```shell\nreadonly zlib1g_version=\"$(dpkg --status zlib1g | grep Version: | cut -d ' ' -f 2)\"\nif [[ -z \"${zlib1g_version}\" ]]; then\n  echo \"error message\"\nfi\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# 読み取り専用になっていない\nzlib1g_version=\"$(dpkg --status zlib1g | grep Version: | cut -d ' ' -f 2)\"\nif [[ -z \"${zlib1g_version}\" ]]; then\n  error_message\nfi\n```\n\n関数内で`local`を使って変数宣言すると変数が関数とその子の内側のみから見えることを保証できます。代入値にコマンド置換を用いる場合、宣言と代入は異なる文で行ってください。これはコマンドの終了コードが`local`で上書きされて伝播しないためです。\n\n* ✔️ DO: 関数専用の変数は`local`で宣言します\n* ✔️ DO: `local`によって代入の終了コードが上書きされるのを避けるため、値の代入にコマンド置換を用いる場合は宣言と代入は異なる行で行います\n\n**推奨 (recommended)**\n\n```shell\nmy_func2() {\n  # エラーが出得ない代入ならば宣言と代入は同じ行で行ってもよい\n  local name=\"$1\"\n\n  # コマンド置換で代入する場合、宣言と代入の行は分離\n  local my_var\n  my_var=\"$(my_func)\"\n  (( $? == 0 )) || return\n\n  ...\n}\n```\n\n**非推奨 (discouraged)**\n\n```shell\nmy_func2() {\n  # $? は常にゼロになっていしまう。なぜならmy_func ではなく、'local' の終了コードを保持するため\n  local my_var=\"$(my_func)\"\n  (( $? == 0 )) || return\n\n  ...\n}\n```\n\n# コメント (Comments)\n\n## ファイルヘッダー (File Header)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: ファイルの先頭にはファイルの目的や内容を簡潔に説明するコメントを記述します。ただしshebang行の前にはコメントを記述しません\n\nファイルは内容の説明の記述から始めます。全てのファイルに内容の簡単な説明を含むtop-level commentが記述します。\n\n**推奨 (recommended)**\n\n```shell\n#!/bin/bash\n#\n# Perform hot backups of Oracle databases.\n```\n\n## コメントの実装 (Implementation Comments)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: トリッキーだったり重要な意味をもつなど注意を要するコードにはコメントを付与します\n* ✔️ DO: コメントは可能なら短く、理解しやすい説明をします\n* ⚠️ CONSIDER: 端的に説明できない場合、背景を含めて詳細に説明することも検討してください\n\nトリッキーであったり、一目瞭然でない、興味深い、もしくは重要なコードの部分にコメントします。ただし全てにはコメントしてはいけません。複雑なアルゴリズムが存在したり、通常から外れたことをしている場合に、可能ならコメントを付与します。短いコメントで理解しやすい説明ができない場合、背景を含めて詳細に説明します。\n\n## TODO コメント (TODO Comments)\n\n\u003e **Note** 独自規約 (ベース: Googleスタイルガイド)\n\n* ✔️ DO: TODOコメントの利用を検討してください\n* ❌ AVOID: TODOコメントを記述した個人をコメントに明記しないでください。(独自)\n\n一時的であったり、短期的な解決策、概ね良いが完璧でないコードにはTODOコメントを利用します。`TODO`には全て大文字の文字列`TODO`を含めます。誰が書いたかは`git brame`で確認できるため、個人識別名を書く必要はありません。TODOコメントの目的は、要求に応じてより詳細を探すために、検索可能な一貫した`TODO`を用意することです。`TODO`は参照された人物が問題を修正する確約ではないので、想定する修正を付記すると後々修正しやすいでしょう。\n\n**例**\n\n```shell\n# TODO: このコードはエラー処理が不足しているため修正が必要です。エラー判定を追加してexit 1で終了させます。\n```\n\n# フォーマット (Formatting)\n\n既存のファイルを編集しているときはそのスタイルに従う必要があるが、新しいコードには次のスタイルを適用します。\n\n## タブとスペース (Tabs and Spaces)\n\n\u003e **Note** 独自規約 (ベース: Googleスタイルガイドとicy/bash-coding-style)\n\n* ✔️ DO: EditorConfigに従って自動整形します。(独自)\n* ✔️ DO: 2つのスペースでインデントします。タブは用いません\n* ✔️ DO: 可読性向上のため、ブロック間には空行を入れます\n* ✔️ DO: 末尾スペースは入れません。(独自)\n* ✔️ DO: ファイルの末尾には改行を入れます。(独自)\n* ❌ AVOID: 既存ファイルに無理にスタイルを適用しないでください。既存ファイルはそのファイルのスタイルを守ってください\n\nEdiroConfigでインデントや末尾スペース、ファイル末尾の改行が自動修正されます。インデントは2つのスペースです。何をするにしても、タブは利用不可です。\n\n多くのエディターは実際のインデントと、表示錠のスペース/タブを好みに応じて切替することは出来ません。別の人のエディターはあなたのエディターと同じ設定を持っているとは限りません。スペースを使うことで、コードがどのエディターでも同じように見えることを保証します。\n\n既存のファイルでは、既存のインデントを忠実に守ってください。既存ファイルに無理にスタイルを適用する必要はありませんが、EditorConfigによる自動修正がかかった場合、それはコミットをしてください。\n\n## 行の長さと長い文字列 (Line Length and Long Strings)\n\n\u003e **Note** 独自規約\n\n* ✔️ DO: 長すぎる文字列の記述にはヒアドキュメントや埋め込み改行を検討してください\n* ⚠️ CONSIDER: 文字列リテラルの長さを短くする方法を探してください\n\n行の最大の長さはなく、N文字で改行する規約はありません。ただし、あまりに長い文字列を記述する必要がある場合、可能であればヒアドキュメントや埋め込み改行を検討してください。適切に分割できない文字列リテラルの存在は許容されますが、短くする方法を探すことを強く推奨します。\n\n**推奨 (recommended)**\n\n```shell\n# ヒアドキュメントの利用\ncat \u003c\u003cEND\nI am an exceptionally long\nstring.\nEND\n\n# 埋め込み改行\nlong_string=\"I am an exceptionally\nlong string.\"\n\n# 配列の改行\narray=(\n  \"foo\"\n  \"bar\"\n  \"baz\"\n)\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# 1行に\\nを用いて納める。(Slack APIなど事情がある場合はOK)\nstr=\"I am an exceptionally long\\nstring.\"\n\n# 配列にならべすぎる\narray=(\"foo\" \"bar\" \"baz\" \"piyo\" \"okonomi\" \"oosugiiiiii\")\n```\n\n## パイプライン (Pipelines)\n\n\u003e **Note** 独自規約 (ベース: Googleスタイルガイドとicy/bash-coding-style)\n\n* ✔️ DO: パイプライン全体がすっと1行に収まるなら1行で記述します\n* ✔️ DO: パイプライン全体が長く読みにくい場合、1行ごとに分割します\n* ✔️ DO: `|`によるコマンドの連鎖や、`||`や`\u0026\u0026`の論理演算子による連結も同様\n\nパイプラインは全体が長く読みにくい場合、1行ごとに分割します。もしパイプライン全体がすっと1行に収まるなら1行で記述します。\n改行する場合、後続するパイプセクションのために改行し継続を示す`\\`を末尾に付与、2つのスペースでインデントし、パイプを置く形式でパイプセグメントが行ごとに分割します。パイプを末尾において改行しないでください。\nこれは`|`によるコマンドの連鎖や、`||`や`\u0026\u0026`の論理演算子による連結にも適用されます。\n\n**推奨 (recommended)**\n\n```shell\n# 1行に全て収まる場合\ncommand1 | command2\n\n# 長いコマンド\ncommand1 \\\n  | command2 \\\n  | command3 \\\n  | command4\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# 1行に全て収まるのに改行は不要\ncommand1 \\\n  | command2\n\n# 長いコマンドで改行を用いないのは読むのが困難\ncommand1 | command2 | command3 | command4\n```\n\n## ループ (Loops)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: `; do`と`; then`は、`while`, `for`そして`if`と同じ行に置きます\n* ✔️ DO: `elif`や`else`は独自の行に置きます\n\nシェルのループは少し変わっていますが、関数の宣言時におけるカッコの原則に従い`; then`と`; do`はif/for/whileと同じ行に置きます。`else`は独自の行に置かれるべきであり、閉じ構文も独自の行に置かれるべきです。そしてそれらは開き構文に垂直方向で整列されるべきです。\n\n**推奨 (recommended)**\n\n```shell\nif [[ nantoka ]]; then\n  ;;\nfi\n\nfor i in $(seq 1 10); do\n  echo $i\ndone\n```\n\n**非推奨 (discouraged)**\n\n```shell\nif [[ nantoka ]];\nthen\n  ;;\nfi\n\nfor i in $(seq 1 10)\ndo\n  echo $i\ndone\n```\n\n## case文 (Case statement)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: 候補は2つのスペースでインデントします\n* ✔️ DO: 1行の候補では、パターンの閉じカッコの後ろ、及び`;;`の前に、1つのスペースが必要です\n* ✔️ DO: 長いもしくは複数コマンドの候補は、パターン、アクション、そして`;;`が複数行に分割します\n* ⚠️ CONSIDER: 短いコマンドの候補は、パターン、アクション、そして`;;`を1行に収めることも検討してください\n\n条件式は`case`や`esac`から1レベルインデントします。複数行のアクションはさらなるレベルにインデントします。パターン表現の前に開きカッコがあってはならない。`;\u0026`や`;;\u0026`の記法は回避します。\n\n**推奨 (recommended)**\n\n```shell\ncase \"${expression}\" in\n  \"--a\")\n    _VARIABLE_=\"...\"\n    ;;\n  \"--absolute\")\n    _ACTIONS=\"relative\"\n    ;;\n  *) shift ;;\nesac\n```\n\n単純なコマンドは式の可読性が保たれるならば、パターンおよび`;;`と同じ行に配置します。アクションが単一行に収まらない場合、パターンは独自の行に置き、次にアクション、次に`;;`を同様に独自の行に置きます。パターンをアクションと同じ行に配置する場合、パターンの閉じカッコの後ろ、及び`;;`の前に、1つのスペースを入れます。\n\n## 変数展開 (Variable expansion)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: 一貫した変数展開します\n* ✔️ DO: 変数展開はダブルクォートで囲みます。シングルクォートでは変数展開されません\n* ❌ AVOID: 明示的に必要な場合もしくは深刻な混乱を避ける場合を除いて、シェル特殊変数/位置パラメータはブレースで区切るな\n\n変数はクォートします。`$var`よりもブレースで囲んだ`${var}`を用います。\n強く推奨されるガイドラインですが、必須のレギュレーションではありません。ただし必須ではないものの、これを軽視しないでください。\n\nその他全ての変数はブレースで区切るのが好ましい。\n\n**推奨 (recommended)**\n\n```shell\n# Preferred style for 'special' variables:\necho \"Positional: $1\" \"$5\" \"$3\"\necho \"Specials: !=$!, -=$-, _=$_. ?=$?, #=$# *=$* @=$@ \\$=$$ …\"\n\n# Braces necessary:\necho \"many parameters: ${10}\"\n\n# Braces avoiding confusion:\n# Output is \"a0b0c0\"\nset -- a b c\necho \"${1}0${2}0${3}0\"\n\n# Preferred style for other variables:\necho \"PATH=${PATH}, PWD=${PWD}, mine=${some_var}\"\nwhile read -r f; do\n  echo \"file=${f}\"\ndone \u003c \u003c(find /tmp)\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# Unquoted vars, unbraced vars, brace-delimited single letter\n# shell specials.\necho a=$avar \"b=$bvar\" \"PID=${$}\" \"${1}\"\n\n# Confusing use: this is expanded as \"${1}0${2}0${3}0\",\n# not \"${10}${20}${30}\nset -- a b c\necho \"$10$20$30\"\n```\n\n## クォート (Quoting)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: クォートされていない展開が要求される場合や、シェル内部整数である場合を除き、変数、コマンド置換、スペースやシェルのメタ文字を含む文字列は常にクォートします\n* ✔️ DO: 複数の要素を安全にクォートするために配列を利用します。特にコマンドラインフラグの場合。後述の[配列 (Arrays)](#配列-arrays)参照\n* ✔️ DO: 整数として定義されるシェル内部の読み取り専用特殊変数のクォートはオプションです: `$?`, `$#`, `$$`, `$!` (`man bash`参照)。一貫性のため、\"${PPID}\"のように整数な内部変数はクォートします\n* ✔️ DO: 文字列変数`\"${words}\"`はクォートします\n* ❌ AVOID: 整数リテラルはクォートしてはいけません。`$((2 + 2))`のような数値演算はクォートしてはいけません\n* ⚠️ CONSIDER: `[[...]]`中のパターンマッチにおけるクォートの規則に注意を払え。後述の[Test](#test)参照\n* ⚠️ CONSIDER: 単純に引数をメッセージの文字列やログに追記するような特別な理由でないならば、`$*`ではなく`\"$@\"`を利用します\n\n```shell\n# 'Single' quotes indicate that no substitution is desired.\n# \"Double\" quotes indicate that substitution is required/tolerated.\n\n# Simple examples\n\n# \"quote command substitutions\"\n# Note that quotes nested inside \"$()\" don't need escaping.\nflag=\"$(some_command and its args \"$@\" 'quoted separately')\"\n\n# \"quote variables\"\necho \"${flag}\"\n\n# Use arrays with quoted expansion for lists.\ndeclare -a FLAGS\nFLAGS=( --foo --bar='baz' )\nreadonly FLAGS\nmybinary \"${FLAGS[@]}\"\n\n# It's ok to not quote internal integer variables.\nif (( $# \u003e 3 )); then\n  echo \"ppid=${PPID}\"\nfi\n\n# \"never quote literal integers\"\nvalue=32\n# \"quote command substitutions\", even when you expect integers\nnumber=\"$(generate_number)\"\n\n# \"prefer quoting words\", not compulsory\nreadonly USE_INTEGER='true'\n\n# \"quote shell meta characters\"\necho 'Hello stranger, and well met. Earn lots of $$$'\necho \"Process $$: Done making \\$\\$\\$.\"\n\n# \"command options or path names\"\n# ($1 is assumed to contain a value here)\ngrep -li Hugo /dev/null \"$1\"\n\n# Less simple examples\n# \"quote variables, unless proven false\": ccs might be empty\ngit send-email --to \"${reviewers}\" ${ccs:+\"--cc\" \"${ccs}\"}\n\n# Positional parameter precautions: $1 might be unset\n# Single quotes leave regex as-is.\ngrep -cP '([Ss]pecial|\\|?characters*)$' ${1:+\"$1\"}\n\n# For passing on arguments,\n# \"$@\" is right almost every time, and\n# $* is wrong almost every time:\n#\n# * $* and $@ will split on spaces, clobbering up arguments\n#   that contain spaces and dropping empty strings;\n# * \"$@\" will retain arguments as-is, so no args\n#   provided will result in no args being passed on;\n#   This is in most cases what you want to use for passing\n#   on arguments.\n# * \"$*\" expands to one argument, with all args joined\n#   by (usually) spaces,\n#   so no args provided will result in one empty string\n#   being passed on.\n#\n# Consult\n# https://www.gnu.org/software/bash/manual/html_node/Special-Parameters.html and\n# https://mywiki.wooledge.org/BashGuide/Arrays for more\n\n(set -- 1 \"2 two\" \"3 three tres\"; echo $#; set -- \"$*\"; echo \"$#, $@\")\n(set -- 1 \"2 two\" \"3 three tres\"; echo $#; set -- \"$@\"; echo \"$#, $@\")\n```\n\n## 関数の宣言 (Function Declaration)\n\n\u003e **Note** Googleスタイルガイド\n\n* ❌ AVOID: 関数と関数の間に実行可能なコードを書くことを避けてください\n\n関数宣言と関数宣言の間に処理を書くとコードの追跡が困難になり、結果デバッグ時に予期せぬ不幸を引き起こします。関数宣言は定数記述部分の直後に配置してください。\n\n**推奨 (recommended)**\n\n```shell\nfunction foo() {\n  ...\n}\nfunction bar() {\n  ...\n}\n\necho \"何か処理\"\n```\n\n**非推奨 (discouraged)**\n\n```shell\nfunction foo() {\n  ...\n}\n\necho \"何か処理\"\n\nfunction bar() {\n  ...\n}\n```\n\n# 機能とバグ (Features and Bugs)\n\n## ShellCheckを使う (Use ShellCheck)\n\n\u003e **Note** 独自規約 (ベース: Googleスタイルガイド)\n\n* ✔️ DO: ShellCheckを使用してシェルスクリプトのバグを特定します\n* ✔️ DO: ShellCheckの--severityレベルwarning以上をすべて解消させます。(独自)\n* ⚠️ CONSIDER: ShellCheckの--severityレベルinfo以上をすべて解消することを検討します。(独自)\n* ⚠️ CONSIDER: ShellCheckの--severityレベルinfoで解消できない場合`# shellcheck disable=SCXXXX`コメントを付与してignoreを検討します。(独自)\n\n[ShellCheck](https://www.shellcheck.net/)プロジェクトはシェルスクリプトについての一般的なバグや警告を検出します。シェルスクリプトが大きかろうと小さかろうと全てに適用します。\n\nshellcheckはWindows/Ubuntu/macOS各種で[インストール](https://github.com/koalaman/shellcheck)できます。\n\n```shell\n# Debian/Ubuntu\nsudo apt install shellcheck\n# macOS\nbrew install shellcheck\n# Windows\nwinget install --id koalaman.shellcheck\nscoop install shellcheck\n```\n\n**推奨 (recommended)**\n\n```shell\n# 部分式には$()を用います。\nfoo=$(cmd ...)\n\n# パスのように空白入る可能性がある変数はクォートで囲みます。\nls \"/foo/bar/${nanika_file}\"\n\n# sourceのパスが解消できないためSC1091の警告無視が必須なので許容される\n# shellcheck disable=SC1091\n. \"$(dirname \"${BASH_SOURCE[0]}\")/_functions\"\n\n# ドライラン用の$_AWS_ARGSを${_AWS_ARGS}にしないことでSC2086がでない。これが許容されるのは、空文字になる可能性、スペース区切りの複数引数になる可能性の両方あるためクォートで囲むことができない\naws s3 ls foo_bucket $_AWS_ARGS\n\n# ドライラン用の$dryrunを${dryrun}にしないことでSC2086がでない。これが許容されるのは、空文字になる可能性、スペース区切りの複数引数になる可能性の両方あるためクォートで囲むことができない\n$dryrun aws s3 ls foo_bucket $_AWS_ARGS\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# SC2006として検出。部分式に``はスタイルガイド、shellcheck両方で禁止です、修正しましょう。\nfoo=`cmd ...`\n\n# SC2086として検出。パスのように空白入る可能性がある変数はクォートで囲まないと警告が出ます。修正しましょう。\nls /foo/bar/${nanika_file}\n```\n\n## コマンド置換 (Command Substitution)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: backtick \\`\\` ではなく`$(command)`を使用します\n\n入れ子になった内側のbacktickは`\\`によるエスケープが求められますが、`$(command)`の形式なら入れ子になっても変更の必要がなく読みやすさを維持できます。\n\n**推奨 (recommended)**\n\n```shell\nvar=$(command \"$(command1)\")\n```\n\n**非推奨 (discouraged)**\n\n```shell\nvar=`command \\`command1\\``\n```\n\n## Test構文 (Test Expression)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: `[ ... ]`ではなく`[[ ... ]]`を使用します\n\n`[[ ... ]]`は`[ ... ]`, `test`そして`/usr/bin/[`よりも適切です。`[[ ... ]]`は`[[`と`]]`の間でパス名の展開や単語の分割が行われないためエラーを削減します。また、`[[ ... ]]]`は`[...]`とは違い、正規表現マッチングが可能です。\n\n`[]`が引き起こす問題の背景は[詳細ページ](http://tiswww.case.edu/php/chet/bash/FAQ)のE14参照。\n\n**推奨 (recommended)**\n\n```shell\n# This ensures the string on the left is made up of characters in\n# the alnum character class followed by the string name.\n# Note that the RHS should not be quoted here.\nif [[ \"filename\" =~ ^[[:alnum:]]+name ]]; then\n  echo \"Match\"\nfi\n\n# This matches the exact pattern \"f*\" (Does not match in this case)\nif [[ \"filename\" == \"f*\" ]]; then\n  echo \"Match\"\nfi\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# This gives a \"too many arguments\" error as f* is expanded to the\n# contents of the current directory. It might also trigger the\n# \"unexpected operator\" error because `[` does not support `==`, only `=`.\nif [ \"filename\" == f* ]; then\n  echo \"Match\"\nfi\n```\n\n## 文字列のテスト (Testing Strings)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: 文字列の比較には`==`を使用します\n* ✔️ DO: 数値比較する場合は`(( ... ))`または`-lt`や`-gt`を利用します\n* ⚠️ CONSIDER: 空文字列の比較には`== \"\"`ではなく`-z`の使用を検討します\n* ⚠️ CONSIDER: 文字列の比較において、固定文字列をプレフィックス/サフィックスにつけて文字列全体の比較をすることは避けましょう\n* ⚠️ CONSIDER: 文字列の比較において、`\u003c`や`\u003e`は辞書的比較するため注意が必要です\n* ❌ AVOID: 文字列の比較には`=`を使用しません\n* ❌ AVOID: 数値の比較に`\u003e`や`\u003c`を使用しません\n\nbashはtestで空文字列を十分スマートに扱えます。コードの可読性を考えて、文字列判定を用いてください。比較時に固定文字をプレフィックス/サフィックスにつけて文字列全体の比較をすることは避けましょう。\n\n**推奨 (recommended)**\n\n```shell\n# Comparing strings\nif [[ \"${my_var}\" == \"some_string\" ]]; then\n  do_something\nfi\n\n# -z (string length is zero) and -n (string length is not zero) are\n# preferred over testing for an empty string\nif [[ -z \"${my_var}\" ]]; then\n  do_something\nfi\n\n# This is OK (ensure quotes on the empty side), but not preferred:\nif [[ \"${my_var}\" == \"\" ]]; then\n  do_something\nfi\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# Avoid compare the whole string with a additional string\nif [[ \"${my_var}X\" == \"some_stringX\" ]]; then\n  do_something\nfi\n```\n\n何をテストしているかの混乱を避けるため、明示的に`-z`や`-n`を利用します。\n\n**推奨 (recommended)**\n\n```shell\nif [[ -n \"${my_var}\" ]]; then\n  do_something\nfi\n```\n\n**非推奨 (discouraged)**\n\n```shell\nif [[ \"${my_var}\" ]]; then\n  do_something\nfi\n```\n\n同値判定には`==`を利用し`=`は利用しません。前者は`[[`の利用を強制し、後者は代入と紛らわしくなります。ただし、`[[ ... ]]`の中での`\u003c`と`\u003e`は辞書的比較するため注意が必要です。数値比較する場合は`(( ... ))`または`-lt`や`-gt`を利用します。\n\n**推奨 (recommended)**\n\n```shell\n# == を用いる\nif [[ \"${my_var}\" == \"val\" ]]; then\n  do_something\nfi\n\n# (())を用いる\nif (( my_var \u003e 3 )); then\n  do_something\nfi\n\n# 数値比較は-gtや-ltが適切\nif [[ \"${my_var}\" -gt 3 ]]; then\n  do_something\nfi\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# = は使わない\nif [[ \"${my_var}\" = \"val\" ]]; then\n  do_something\nfi\n\n# 恐らく意図しない辞書的比較\nif [[ \"${my_var}\" \u003e 3 ]]; then\n  # 4ならば真、22ならば偽\n  do_something\nfi\n```\n\n## ファイル名のワイルドカード展開 (Wildcard Expansion of Filenames)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: ファイル名のワイルドカード展開する場合は明示的なパス指定を行います\n* ❌ AVOID: ファイル名のワイルドカード展開する場合は`*`を使用しないでください。代わりに`./*`を使用します\n\nファイル名は`-`から始まる可能性があるため、ワイルドカード展開は`*`ではなく`./*`の方がより安全です。\n\n```shell\n# Here's the contents of the directory:\n# -f  -r  somedir  somefile\n```\n\n**推奨 (recommended)**\n\n```shell\n# Prevent the accidental removal of files starting with `-`\n$ rm -v ./*\nremoved `./-f'\nremoved `./-r'\nrm: cannot remove `./somedir': Is a directory\nremoved `./somefile'\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# Incorrectly deletes almost everything in the directory by force\n$ rm -v *\nremoved directory: `somedir'\nremoved `somefile'\n```\n\n## Evalの禁止 (Eval is Evil)\n\n\u003e **Note** Googleスタイルガイド\n\n* ❌ AVOID: `eval`は使わないでください\n\n`eval`は変数への代入に利用される場合、入力コードを難読化し、それらの変数が何であるかの確認を可能にすることなく変数を設定できます。`eval`はセキュリティリスクを伴うため、避けるべきです。\n\n**非推奨 (discouraged)**\n\n```shell\n# What does this set?\n# Did it succeed? In part or whole?\neval $(set_my_variables)\n\n# What happens if one of the returned values has a space in it?\nvariable=\"$(eval some_function)\"\n```\n\n## 配列 (Arrays)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: 配列を利用して複数の要素を格納します\n* ✔️ DO: 改行で区切られた文字列出力は素直にループを利用することを検討してください。配列に変換するよりも簡単です\n* ❌ AVOID: 単一文字列に複数の要素を格納、連携することは避けます\n\nbashの配列は、クォートの複雑さを回避して要素のリストを保存するのに使います。配列はより複雑なデータ構造の利用を容易にするため利用されるべきではありません。(前述の[いつシェルを使うか (When to use Shell)](#いつシェルを使うか-when-to-use-shell)参照)\n\n配列は文字列の順序付きコレクションを格納し、コマンドやループに対しては個々の要素に安全に展開されます。\n単一文字列をコマンドへの複数の引数として利用すると、必然的に`eval`や文字列中のクォートの入れ子を誘発するため避けます。\n\n**推奨 (recommended)**\n\n```shell\n# An array is assigned using parentheses, and can be appended to\n# with +=( … ).\ndeclare -a flags\nflags=(--foo --bar='baz')\nflags+=(--greeting=\"Hello ${name}\")\nmybinary \"${flags[@]}\"\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# Don’t use strings for sequences.\nflags='--foo --bar=baz'\nflags+=' --greeting=\"Hello world\"'  # This won’t work as intended.\nmybinary ${flags}\n```\n\n```shell\n# Command expansions return single strings, not arrays. Avoid\n# unquoted expansion in array assignments because it won’t\n# work correctly if the command output contains special\n# characters or whitespace.\n\n# This expands the listing output into a string, then does special keyword\n# expansion, and then whitespace splitting.  Only then is it turned into a\n# list of words.  The ls command may also change behavior based on the user's\n# active environment!\ndeclare -a files=($(ls /directory))\n\n# The get_arguments writes everything to STDOUT, but then goes through the\n# same expansion process above before turning into a list of arguments.\nmybinary $(get_arguments)\n```\n\n**配列の利点**\n\n* 配列の利用はクォートを錯乱させることなくリストの作成を可能にします。逆に、配列を利用しなければ、文字列中でクォートを入れ子にする誤った試みへつながります\n* 配列は、スペースを含む任意の文字列からなるシーケンス/リストの安全な保存を可能にします\n\n**配列の欠点**\n\n* 配列の利用によりスクリプトはより複雑になる可能性があります\n* 改行で区切られた文字列出力は配列に変換するためには追加の処理が必要です。変換するよりも素直にループを利用することを検討してください\n\n```shell\n# 改行で区切られた文字列出力を配列に変換する\nIFS=$'\\n' read -r -d '' -a files \u003c \u003c(ls /directory \u0026\u0026 printf '\\0')\n```\n\n配列はリストを安全に作成したり渡したりする場合に利用します。特に、コマンド引数のセットを構築する時のように、クォートが錯乱する問題を避ける場合に利用します。配列にアクセスするときはクォート展開`\"${array[@]}\"`を利用します。しかしながら、もしさらに高度なデータ操作が要求される場合は、そもそもシェルスクリプトの利用は避けましょう。\n\n## whileへのパイプ (Pipes to While)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: プロセス置換か`readarray`ビルトイン(bash4+)を使用して`while`へパイプします\n* ❌ AVOID: `| while`を使用して`while`へパイプしてループすることは避けます\n\n`while`へパイプする場合はプロセス置換か`readarray`ビルトイン (bash4+) を優先的に利用します。プロセス置換はサブシェルを作成しますが、`while`やその他のコマンドをサブシェル内に置くことなくサブシェルから`while`へのリダイレクトを可能にします。一方、パイプはサブシェルを作るためパイプライン中における変数の変更は親シェルに伝播せず、`| while`を用いると追いかけるのが困難な分かりにくいバグを誘引します。\n\n代わりに`readarray`組み込み関数を使用してファイルを配列に読み込み、配列の内容をループすることを検討してください。(上記と同じ理由で)`readarray`に代入するときはパイプではなくプロセス置換を使用する必要があることに注意してください。ただし、ループの入力生成がパイプの後ではなく前に配置されるという利点があります。\n\n**推奨 (recommended)**\n\n```shell\n# readarray is most recommended\nlast_line='NULL'\nreadarray -t lines \u003c \u003c(ls)\nfor line in \"${lines[@]}\"; do\n  if [[ -n \"${line}\" ]]; then\n    last_line=\"${line}\"\n  fi\ndone\n\n# This will output the last non-empty line from your_command\necho \"${last_line}\"\n```\n\n```shell\n# Process substitution is also acceptable\nlast_line='NULL'\nwhile read line; do\n  if [[ -n \"${line}\" ]]; then\n    last_line=\"${line}\"\n  fi\ndone \u003c \u003c(ls)\n\n# This will output the last non-empty line from your_command\necho \"${last_line}\"\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# Pipe won't pass variable changes to outside\nlast_line='NULL'\nls | while read -r line; do\n  if [[ -n \"${line}\" ]]; then\n    last_line=\"${line}\"\n  fi\ndone\n\n# This will always output 'NULL'!\necho \"${last_line}\"\n```\n\n## forループ (For Loops)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: スペースを含ないことが確実な場合、`for`ループを使用してリストをイテレートします\n* ✔️ DO: `for`ループを使用してリストをイテレートする場合、`\"${array[@]}\"`を使用します。この時変数は、配列か改行で区切られた文字列であることを確認してください\n\nforループでイテレートする際は注意が必要です。`for var in $(...)`では、出力は行ではなくスペースで分割します。出力が想定外のスペースを含ないことが分かっているため場合安全ですが、明確でない場合は`while read`ループか`readarray`の方が安全で明確になるでしょう。forループを使用してリストをイテレートする場合、`\"${array[@]}\"`を使用することでクォート規約を遵守します。\n\n**推奨 (recommended)**\n\n```shell\n# use array when itelating space separeted list. (You cannot itelate with string \"foo bar piyo\")\nlines=(foo bar piyo)\nfor line in \"${lines[@]}\"; do\n  echo \"1 ${line}\"\ndone\n\n# use array when itelating line separated outout\nlines=$(ls -l)\nfor line in \"${lines[@]}\"; do\n  echo \"1 ${line}\"\ndone\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# shellckeck warn you SC2206 for quote this\nlines=\"foo bar piyo\"\nfor line in ${lines[@]}; do\n  echo \"1 ${line}\"\ndone\n\n# Won't work. output is `1 foo bar piyo`\nlines=\"foo bar piyo\"\nfor line in \"${lines[@]}\"; do\n  echo \"1 ${line}\"\ndone\n\n# space included lines won't itelate correctly\nfor line in $(ls -l); do\n  echo \"1 ${line}\"\ndone\n```\n\n## 算術演算 (Arithmetic)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: 算術演算には`(( ... ))`や`$(( ... ))`を利用します\n* ❌ AVOID: `$[]`構文、`let`や`expr`を使用して算術演算しないでください\n* ⚠️ CONSIDER: `(( ... ))`を独立した文として利用することは避けてください。代わりに、`if (( ... ))`のように条件式として利用してください\n* ⚠️ CONSIDER: `(( ... ))`や`$(( ... ))`内部では変数を`i`のように`$`や`${}`を省略できます\n\n`\u003c`と`\u003e`は`[[ ... ]]`式内部では数値比較として動作せず辞書的比較します。([文字列のテスト (Testing Strings)](#文字列のテスト-testing-strings)参照)。代わりに全ての算術演算に対しては`[[ ... ]]`ではなく、`(( ... ))`を優先的に利用してください。\n\n`(( ... ))`を独立した文として利用する場合、その式がゼロと評価されるか注意が必要なため避けてください。特に`set -e`が有効な場合、`set -e; i=0; (( i++ ))`はシェルを終了させてしまいます。\n文法的考慮点を差し置いても、シェルビルトインの算術演算`(())`は多くの場合`expr`よりも高速です。\n\n**推奨 (recommended)**\n\n```shell\n# Simple calculation used as text - note the use of $(( … )) within a string.\necho \"$(( 2 + 2 )) is 4\"\n\n# When performing arithmetic comparisons for testing\nif (( a \u003c b )); then\n  …\nfi\n\n# Some calculation assigned to a variable.\n(( i = 10 * j + 400 ))\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# This form is non-portable and deprecated\ni=$[2 * 10]\n\n# Despite appearances, 'let' isn't one of the declarative keywords,\n# so unquoted assignments are subject to globbing wordsplitting.\n# For the sake of simplicity, avoid 'let' and use (( … ))\nlet i=\"2 + 2\"\n\n# The expr utility is an external program and not a shell builtin.\ni=$( expr 4 + 4 )\n\n# Quoting can be error prone when using expr too.\ni=$( expr 4 '*' 4 )\n\n# シェルが終了してしまう\nset -e\ni=0\n(( i++ ))\n```\n\n`$(())`で変数を利用する場合、シェルが`var`を変数と認識するため、`${var}`や`$var`は不要です。`${...}`を省略することで読みやすくなるため推奨しますが、この規約は先述のクォート規約と反するため必須ではありません。\n\n**推奨 (recommended)**\n\n```shell\n# N.B.: Remember to declare your variables as integers when\n# possible, and to prefer local variables over globals.\nlocal -i hundred=\"$(( 10 * 10 ))\"\ndeclare -i five=\"$(( 10 / 2 ))\"\n\n# Increment the variable \"i\" by three.\n# Note that:\n#  - We do not write ${i} or $i.\n#  - We put a space after the (( and before the )).\n(( i += 3 ))\n\n# To decrement the variable \"i\" by five:\n(( i -= 5 ))\n\n# Do some complicated computations.\n# Note that normal arithmetic operator precedence is observed.\nhr=2\nmin=5\nsec=30\necho \"$(( hr * 3600 + min * 60 + sec ))\" # prints 7530 as expected\n```\n\n# コマンド呼び出し (Calling Commands)\n\n## 返り値判定 (Checking Return Values)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: 返り値は常に判定し、有益な返り値を与えます\n* ✔️ DO: コマンドの成否で処理を分ける場合、`if`文で直接判定します\n* ❌ AVOID: `set -euo pipefail`が前提にあるため、`$?`や`PIPESTATUS`変数による返り値判定は避けます\n\n\n**推奨 (recommended)**\n\n```shell\n# ifの中ならコマンドが失敗してもよい\nif ! mv \"${file_list[@]}\" \"${dest_dir}/\"; then\n  echo \"Unable to move ${file_list[*]} to ${dest_dir}\" \u003e\u00262\n  exit 1\nfi\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# set -euo pipefailなのでmvが失敗した場合、スクリプトは終了する\nmv \"${file_list[@]}\" \"${dest_dir}/\"\nif (( $? != 0 )); then\n  echo \"Unable to move ${file_list[*]} to ${dest_dir}\" \u003e\u00262\n  exit 1\nfi\n\n# set -euo pipefailなので、PIPESTATUSは使わない。パイプライン全体でのエラーを判定する。\ntar -cf - ./* | (cd \"${dir}\" \u0026\u0026 tar -xf -)\nif (( PIPESTATUS[0] != 0 || PIPESTATUS[1] != 0 )); then\n  echo \"Unable to tar files to ${dir}\" \u003e\u00262\nfi\n```\n\n## エラー処理 (Error Handling)\n\n\u003e **Note** icy/bash-coding-styleベース\n\n* ✔️ DO: 関数内で発生するエラーは関数で処理をします。呼び出し元でエラー処理は避けます\n\n別関数で発生したエラーを呼び出し元で処理することは避けます。関数内でエラーが発生した場合、その関数内でエラー処理を行います。エラー処理は`common::error`関数を用いてエラーメッセージを表示し、`return 1`で関数を終了します。\n\n**推奨 (recommended)**\n\n```shell\n_foobar_call() {\n  # do something\n\n  if [[ $? -ge 1 ]]; then\n    _error \"${FUNCNAME[0]} has some internal error\"\n  fi\n}\n\n_my_def() {\n  _foobar_call || return 1\n}\n```\n\n**非推奨 (discouraged)**\n\n```shell\n_my_def() {\n  _foobar_call\n\n  if [[ $? -ge 1 ]]; then\n    echo \u003e\u00262 \"_foobar_call has some error\"\n    _error \"_foobar_call has some error\"\n    return 1\n  fi\n}\n```\n\n## ビルトインコマンド vs 外部コマンド (Builtin Commands vs. External Commands)\n\n\u003e **Note** Googleスタイルガイド\n\n* ✔️ DO: シェルビルトイン呼び出しか分離プロセス呼び出しかの選択を迫られたら、ビルトインを選択します\n* ❌ AVOID: bashの変数展開を複雑に駆使するのとsedなど標準的な外部コマンドでシンプルにかける場合、ビルトインコマンドに固執するのは避けてください\n\nシェルビルトインは、外部コマンドと比べて堅牢かつポータル(例えば`sed`はBSDとGNUで異なる)であるため、bash(1)にある変数展開機能のようなビルトインの利用は適切です。しかしながら、外部コマンドの標準的な利用がシンプルである場合、ビルトインコマンドに固執する必要はありません。特に複雑な変数展開を用いると他の開発者がコードを理解するのに時間を要する可能性があります。\n\n**推奨 (recommended)**\n\n```shell\naddition=$(( X + Y ))\nsubstitution=\"${string/#foo/bar}\"\n```\n\n**非推奨 (discouraged)**\n\n```shell\naddition=\"$(expr \"${X}\" + \"${Y}\")\"\nsubstitution=\"$(echo \"${string}\" | sed -e 's/^foo/bar/')\"\n```\n\n# スクリプトの安定化 (Script Stabilization)\n\nスタイルガイドを守ってもスクリプトの安定化は約束できません。よくあるスクリプトの安定化にのためのベストプラクティスを示します。\n\n\n## 再実行可能なスクリプトを書く (Writing Rerunnable Scripts)\n\n\u003e **Note** 独自規約\n\n* ✔️ DO: スクリプトを同じ引数で実行したときに同じ結果が得られるようにします\n\n冪等性のあるコードを書くことは重要です。冪等性=スクリプトを何度実行しても同じ結果が得られため、スクリプトの途中で処理が失敗した場合でも再実行により続きから処理を行えるようになります。冪等性を意識することで、より信頼性の高い、メンテナンスしやすいスクリプトを作成できます。\n\n**推奨 (recommended)**\n\n```shell\n# このスクリプトは冪等性がある\nfile_name=\"foo_bar/per_run_unique_$(date +%s)\"\nmkdir -p \"$(dirname \"${name}\")\"\nif [[ ! -f \"${name}\" ]]; then\n  # ファイルがあってもなくてもコンテンツが初期化されてから追記される\n  echo \"nanika\" \u003e \"${file_name}\"\n  echo \"okonomiyaki\" \u003e\u003e \"${file_name}\"\n  echo \"takoyaki\" \u003e\u003e \"${file_name}\"\nfi\n\n# kubectl applyは再実行性があるコマンドなので活用する\nkubectl apply -f ./manifest.yaml\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# 初回にディレクトリの存在があっても次にある可能性が保証されていない\nfile_name=\"foo_bar/per_run_unique_$(date +%s)\"\nif [[ ! -f \"${file_name}\" ]]; then\n  # 前のファイルがあると追記されて同じ結果にならない\n  echo \"nanika\" \u003e\u003e \"${file_name}\"\n  echo \"okonomiyaki\" \u003e\u003e \"${file_name}\"\n  echo \"takoyaki\" \u003e\u003e \"${file_name}\"\nfi\n\n# kubectl createは再実行性が担保されていないのですでに存在するとエラーになる\nkubectl create nanika\n```\n\n## 変更前に状態の確認を行う (Check State Before Changing)\n\n\u003e **Note** 独自規約\n\n* ✔️ DO: 変更前に状態を確認し意図したコマンドが実行されることを担保します\n\nシステムの状態を変更する操作する場合、すでに目的の状態になっているかどうかを最初にチェックすることで、不要な処理を避けエラーを防ぎます。\n\n**推奨 (recommended)**\n\n```shell\n# 変数が空かどうかチェックしてから処理を行う\nif [[ \"${kubemanifest}\" == \"\" ]]; then\n  common::error \"kubernetes manifest not generated. exit script.\"\n  exit 1\nfi\n\necho \"${kubemanifest}\" | kubectl apply -f -\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# 何もチェックせずに処理を行う。kubemanifestが空の場合、意図しない結果になる\necho \"${kubemanifest}\" | kubectl apply -f -\n```\n\n## 一時ファイルの安全な作成 (Safely Creating Temporary Files)\n\n\u003e **Note** 独自規約\n\n* ✔️ DO: 一時ファイルの作成には`mktemp`を使用します\n* ⚠️ CONSIDER: スクリプト終了時には`trap`を使用して確実に削除できないか検討します\n\nmktempを使用することで、安全に一時ファイルを作成でき、trapを使用することでスクリプト終了時に確実に削除できます。\n\n**推奨 (recommended)**\n\n```shell\n# mktemp を使用して安全に一時ファイルを作成\ntemp_file=$(mktemp)\n\n# スクリプトの終了時に一時ファイルを削除\ntrap 'rm -f \"$temp_file\"' EXIT\n\n# 一時ファイルを使用した処理が安全にかける\n```\n\n**非推奨 (discouraged)**\n\n```shell\n# 独自ルールの一時ファイル作成は重複を考慮するのが難しい\ntemp_file=$(/tmp/foobar_$(date +%s))\n\n# 一時ファイルを使用した処理をここに記述\n\n# ファイルの削除漏れが発生する可能性がある\nrm \"${temp_file}\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguitarrapc%2Fbash-styleguide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguitarrapc%2Fbash-styleguide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguitarrapc%2Fbash-styleguide/lists"}