メインコンテンツへスキップ
見出し画像

Macのzshで、変数に入れたファイルの一覧が1つの名前として渡り、何度もつまずいた話

    このサイトの作業では、記事のファイルを本番のサーバーへ送るときなどに、ターミナルでコマンドを組み立てて動かします。送るファイルが何本もあるときは、その名前を1つの変数にまとめて、コマンドに渡していました。

    作業PCをWindowsからMacに替えてから、このやり方で同じつまずきを何度も繰り返しました。変数に入れた複数のファイルの名前が、ばらばらの名前ではなく、空白を含んだ1つの長い名前としてコマンドに渡ってしまうのです。このnoteでは、決まりを書いてからも繰り返したこと、それでも本番が壊れなかったわけ、最後に変えたやり方を、作業の記録から振り返ります。

    移した日に、決まりは書いてあった

    作業PCをWindowsからMac miniに移したのは10月25日です。移した日の記録に、もう次の1行がありました。

    「Mac のシェルは zsh のため、変数に入れた複数の引数は単語に分かれない」

    このMacで使っているシェルはzshです。zshでは、変数の中に空白で区切った名前を並べても、そのまま渡すと空白のところで別々の名前には分かれません。記録には、対策として「コマンドは引数を直接書く」とも書いています。

    つまり、仕組みは移した日に分かっていて、書き留めてもありました。

    それでも、同じことが続いた

    その後の記録を読み返すと、同じ種類のつまずきが、少なくとも7回あります。

    • 10月25日: 記事を配置するときに、変数が単語に分かれず空の tar を送り、展開が失敗した

    • 10月26日: Threadsの投稿のIDの一覧が1つの文字列として渡り、全件が「見つからない」で拒否された

    • 10月29日: 本番の版を照らし合わせるときに、commitの一覧が1語のまま渡り、ハッシュが合わないように見えた

    • 10月29日: 記事の点検の結果の保存と状態の切り替えが「引数の誤り」で何も書かずに終わり、出力を tail で切っていて気づくのが遅れた

    • 10月31日: 画像を付け替えるときに、変数が分割されず、git archive の時点で止まった

    • 11月1日: 配置の対象を1つの文字列の変数に入れたため、git archive が「pathspec が一致しない」で止まった

    • 11月3日: 変数のファイル名が1語として渡り tar を作れず、本番で展開する前のハッシュ値の照らし合わせで止まった

    起きた場所は、記事の配置、投稿の予約、版の照らし合わせ、画像の付け替えとまちまちです。ただ、原因はどれも同じでした。複数の名前を1つの変数に入れて渡したことです。

    決まりを書いた1行は、作業の記録のずっと前のほうに埋もれていきます。その場その場でコマンドを組み立てるとき、手は慣れた書き方のほうへ戻っていました。

    本番は、一度も壊れなかった

    7回のどれでも、本番のサーバーのファイルやデータは変わっていません。記録にも「本番は触っていない」「何も送っていない」「本番のアプリのファイルは無変更」と残っています。

    壊れなかったのは、名前が1つにつながった時点で、どこかの手順が先に止まったからです。

    • tar を作る段や git archive の段で、つながった名前のファイルが見つからずに止まる

    • 送った tar のハッシュ値を、展開の前に Git の値と照らすところで止まる

    • 投稿の予約では、見つからないIDを1件も通さずに、全件を拒否する

    本番を変える前に、送るものを数えたり照らし合わせたりする段を入れておいたことが、そのまま守りになっていました。ただ、10月29日の2つ目の件は止まり方が静かで、出力を tail で短く切って見ていたために、何も書かれていないことに気づくのが遅れています。止まる段があっても、止まったことを読まなければ、次の作業が空のまま進みかねません。

    名前の一覧は、配列で渡すと決めた

    11月3日の失敗の後、配置のたびにファイルの一覧を配列で渡すようにしました。配列なら、1つ1つの名前が別々の要素として入り、zshでもそのまま別の名前として渡ります。

    同じ日の次の2回の配置の記録には、「今回はファイルの一覧を配列で渡した」「ファイルの一覧は配列で渡した」とあります。どちらの記録にも、配置のやり直しは書かれていません。

    決まりを「気をつける」で終わらせず、毎回の書き方そのものを1つに決めたのが、前と違うところです。手が慣れた書き方に戻っても、その慣れた書き方が配列になっていれば、同じつまずきは起きにくくなります。

    まとめ

    仕組みを知って書き留めても、その決まりが作業の手元に無ければ、同じつまずきは繰り返されます。今回それでも本番が守られたのは、変える前に数えて照らす段があったからでした。

    ターミナルでAIと一緒にコマンドを組み立てている人は、ファイルの一覧を渡す書き方を、気をつけることではなく、いつも使う1つの書き方として決めておくと安心です。そして、処理が途中で終わるときの出力は、短く切らずに最後まで読んでください。

    あなたへのおすすめ