はてなブックマーク

たくさんあって楽しくなってきますね。 この中でも特に読んだほうが良いページは「zshexpn」と「zshoptions」です。 zshexpnは展開に関するmanページです。展開というのはつまり、短い文字列を長い名前に置き換えることです。コマンドライン履歴の展開やファイル名生成(ワイルドカードなど)がこれにあたります。展開機能を使いこなせば、本来より短い名前で指定できるようになるので、コマンドライン操作が速く快適になります。 zshoptionsはzshのオプション一覧とその解説が書かれています。これを見て便利だと思うオプションを試してみると良いです。 zshをカスタマイズして便利に使おうという典型的なzshユーザーは、この2つを読んでおけばだいたいのことができるでしょう。 その他、役に立つものからどうでもいいものまで、たくさんページがあります。このアドベントカレンダーを利用して、今後いく

zshのmanページを読んで解説しようという企画の第一回目です。manページを読んで大事なところを紹介したり解説したりします。 今回は一番基本のページ、man zsh(1)を読みます。ここにはzshの概要とWebサイトや公式ドキュメントの場所などが書かれています。それでは、実際に中を見て行きましょう。 OVERVIEW(要約) まずここで、zshのmanページ一覧と、それぞれ何のページなのかが1行で簡単に書かれています。調べたいことがあってどのmanページを読めばよいのか分からなくなったときは、ここを見るとよいです。 AVAILABILITY(入手場所) zshのソースコードをダウンロードするためのFTP、ウェブサイトURLが書いてあります。あと、ソースコード リポジトリが紹介されています。リポジトリはhttp://sourceforge.net/projects/zsh/にあって、CVS

さて、われわれは毎日シェルを使っているわけですが、みなさんはどうやって今のシェルを選んだのでしょうか。 初期設定のままとか、なんとなくとかいう理由の人もいるでしょう。逆に、色々とシェルを渡り歩いて今の結果に行き着いたという人もいるでしょう。 僕の場合、初めはbashを使っていました。どのシェルを使ってもだいたい同じことができるだろうという考えのもと、普通にデフォルトのログインシェルを使っていました。特に困ることもなく、使いこなすということもなく、なんとなく使っていました。 ある日、他の人が使っているtcshの設定ファイルを見る機会がありました。確かそのときの職場に伝わっていた秘伝のtcshrcだったと思います。それはaliasやらなんやら激しくカスタマイズされていました。「おお、こういう世界もあるのか」と、感心しました。 しかし、それを真似しようと調べてみたところ、どうやらtcshには欠陥

前の記事でも紹介したけど、zshですべてのオプションの設定を一覧表示したいときは、set -oコマンドを使う。 set -o noaliases off allexport off noalwayslastprompt off alwaystoend off noappendhistory off autocd on autocontinue off noautolist off ... 以下省略 ...

zshには「オプション」というものがある。オプションとは、zshの動作を切り替えるためのオン/オフのフラグのこと。zshを使ってる人は何かしらオプションを設定して、使いやすいようにカスタマイズしてると思う。このオプションを設定したり、設定した値を確認する方法がちょっと分かりにくいので、ここでまとめておく。 オプションを有効にする オプションを有効にするには、setoptコマンドを使う。これは次のように、setopt <オプション名>という形で使う。

シェルスクリプトでコマンドライン引数をオプションとして解析したいときは、getoptsを使うのが一般的なやり方だ。 でも、getoptsはGNUスタイルの長いオプションに対応していないので、--helpとかのオプションを受け付けれないという欠点がある。そんなときでも、zshならzparseoptsというコマンドを使えば長いオプションでも解析できるので紹介する。 基本パターン まずは一番簡単なパターンとして、次の3つのオプションを解析する例を紹介する(mvコマンドのオプションをイメージしている)。どのオプションも引数は取らない。 -v --help --version このオプションをパースするには、zparseoptsというzshの組み込みコマンドを使って、次のように書く。 #!/bin/zsh local -A opthash zparseopts -D -A opthash -- -h

zshでは連想配列が使える。でも、普通のプログラム言語と違ってちょっと癖があるので、ここで使い方についてまとめてみる。 宣言 連想配列は必ずtypesetかlocalで宣言が必要になる。typeset -Aまたはlocal -Aという形で宣言する。

これは何? zshの操作で、pecoとかpercolとか、Anything風インターフェースで選択するやつがよく使われてる。これを使うと、例えばコマンドライン履歴からインクリメンタルに検索して、それを実行、とかできるようになる。 でも、pecoとかpercolはシェルとは関係なくて、単に「インクリメンタルに絞り込む」ってところだけしかやってくれない。それだけでは役に立たなくて、「選んだ結果を実行する」とかのシェルの処理が必要になる。 それで、そういうシェルの処理を自分で書きたくない人向けにanyframeというのを作った。 https://github.com/mollifier/anyframe これはzsh用のプラグインで、これを使うと自分でシェルの関数を書かなくても、キーバインドとかaliasを設定するだけでpeco/percolの便利なやつをすぐ使えるようになる。 特徴 普通の人が

zshは標準の機能を使うだけでも便利だけど、それでも足りないときはいろいろなプラグインを追加して拡張できる。でも、プラグイン一覧はどこかにまとまっているわけではない。特に、zsh本体に標準で含まれているプラグインはman zshcontribを見ればわかるけど、それ以外のユーザが独自に作ったプラグインはGoogle検索とかで地道に探すしかない。 そこで、zshで使用できる標準で含まれていないプラグインをまとめて紹介する。これを参考にして、zshをもっと便利にしてください! ディレクトリ移動 名前 概要 参考記事

zshでプロンプトをカラー表示してる人も多いと思う。カラー表示する方法は2種類書き方があって、ちょっと分かりにくいので、その方法についてまとめておく。 方法1 まず1つ目の方法として、プロンプト文字列を%F{色指定}と%fで囲めばその中は指定した色になる。「色指定」の部分には色の名前または数字を書く。使用できる色の名前と数字は以下の通り。 色の名前 数字

適当にコピペしてこれを書いてる人もいると思うけど、このantigen useが何をやっているのかを解説する。 ソースコードを追いかけてみると、これは結局、次のコードと同じになる。 つまり、GitHubにあるoh-my-zshのlibディレクトリ以下を取得して、その下にあるファイルをぜんぶ読み込む(sourceする)、ということをやってる。 なんでこんなことをやってるかというと、oh-my-zshのpluginsやthemesの中にはこのlib以下にあるスクリプトに依存しているやつがあるから。そういうのは単独では動作しないので、こうやってlib以下を読み込む必要がある。なのでoh-my-zshのpluginsやthemesを使ってない人には必要ない。 まあ、oh-my-zshのpluginsやthemesもlibに依存していないやつもあるし、依存していたとしてもlib以下全部が必要ではないの

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article?

zshでは、何か操作を行ったときに呼び出されるhook関数を登録できる。これを使うと、例えば「コマンドを実行するたびにこの関数を実行する」ということができるようになる。もうすでに使ってる人も多いと思うけど、ここでその使い方をまとめておく。 hook関数を登録するには、add-zsh-hook関数を使う。使い方としては、「add-zsh-hook <hook名> <関数名>」という形で呼び出す。「hook名」はどういうときに関数が呼び出されるかというイベント種別を表す文字列で、詳しくは後で説明する。 例 次の例ではprecmdのときにprecmd_function1という関数を呼び出すように登録している。

zshではkillコマンドでプロセスIDやプロセス名を補完できるので紹介する。 基本的な使い方 使い方は簡単で、特に設定しなくてもkillの後にkillしたいコマンド名を入れてTabを押せば、プロセス名が補完される。

zshでは、直前のコマンドラインの最後の単語を挿入する機能がある。1つのファイルに対して違うコマンドを実行するときに便利なので紹介する。 insert-last-wordを使う 標準でinsert-last-wordという機能がある。これを使うと、直前のコマンドラインの最後の単語がカーソル位置に挿入される。キーバインドはESC-_と ESC-.に割り当てられているので、ESCを押したあとに_、またはESCを押したあとに.で使える。 % git diff foo.txt % git add # <= ここでESC-. % git add foo.txt # <= 前のコマンドラインの末尾にある単語が挿入される これを使ってもいいんだけど、次のsmart-insert-last-wordというやつをつかうともっと便利なので紹介する。 smart-insert-last-wordを使う smar

zshでは現在のコマンドラインを任意のテキストエディタで編集できるので紹介する。 設定 次の設定を.zshrcに書いておく。 autoload -Uz edit-command-line zle -N edit-command-line bindkey '^xe' edit-command-line 最後の^xeのところは僕が使っている例で、好きなように変えてOK。 使い方 さっきの例の設定の場合、^xe(Ctrl+xのあとにCtrlを離してe)でエディタが起動する。起動したエディタで実行したいコマンドを書いて保存、終了、で元のコマンドラインに戻る。後は普通にEnterを押すと実行される。 複数行のコマンドを実行したいときもそのままエディタで書ける。 もちろん、コマンドラインに途中まで入力済みの状態で起動すると、その内容が始めから入った状態でエディタが起動する。編集をキャンセルして元の状態

変数の値にスペースが含まれているとき、zshとbashで単語の分割ルールが違う。zshでシェルスクリプトを書くときに注意が必要になるので紹介する。 例1: 変数をコマンドの引数に指定する 変数の値にスペースを入れて、それをtouchコマンドの引数にしてみる。 zshの場合は変数の値が1つの単語として扱われる。なのでfile1 file2という1つのファイルが作成される。 % filename="file1 file2" % touch $filename % ls -l -rw-r--r-- 1 mollifier mollifier 0 12月 4 10:36 file1 file2

zshを初回起動したときに、こんな画面が出てきたのを見たことある人も多いと思う。 これはzshを初めて使うユーザのために、おすすめ設定を行うための画面だ。zsh-newuser-installというzshのシェルスクリプトでこの画面を表示してる。以下、この記事では「zsh-newuser-install画面」と呼ぶことにする。zshを使おうっていう人が最初に見ることになる画面なんだけど、けっこう分かりにくいのでここで解説する。 どうやったらこの画面になるのか zsh-newuser-install画面はzshの起動ファイルをまだ作成していないときに表示される。起動ファイルというのは、具体的には次の4つ。 ~/.zshenv ~/.zprofile ~/.zshrc ~/.zlogin この4種類のファイルが1つもないときにzshを起動するとzsh-newuser-install画面が表示さ

% cap -T cap deploy # Deploy a new release cap deploy:check # Check required files and directories exist cap deploy:check:directories # Check shared and release directories exist (...以下省略...) _capファイルの中では、cap -Tを呼び出してタスク一覧を取得して、それを元に補完候補を作成しています。capがグローバルにインストールされているときはこれで問題ないのですが、bundle installでインストールしているときはcap -Tを実行してもエラーで実行できません(bundle exec cap -Tとしないと実行できません)。そのために補完候補が作成できていなかったのです。 どうやって対応する

シェルでコマンドを呼び出したときに、コマンド実行に失敗した場合は終了ステータスとして0以外を返すルールになっている。 % ls -z ls: 無効なオプション -- 'z' Try 'ls --help' for more information. % echo $? 2 上の例のように終了ステータスは echo $? で確認できるんだけど、コマンドが成功したかどうかによってプロンプトの色を変えるようにもできるので紹介する。 例 こんな感じで.zshrcに書いておけばOK。 前回のコマンド呼び出しに成功したときは緑、失敗したときは赤になってる。プログラムのコンパイルとかしたときに成功したかどうかが分かりやすいので便利。 解説 %(?.xxx.yyy) という形式の記号を使ってる。これをプロンプト文字列として使うと「前回の終了ステータスが0ならxxx、0以外ならyyy」という意味になる。今回

zsh では普通はオプションを指定したらそのシェルが終了するまでずっと有効なんだけど、そうじゃなくて関数内だけで有効にする方法があるので紹介する。 zsh には local_options というオプションがある。これを有効にすると、関数を出た時に関数を呼び出した時点でのオプション設定が復元される。つまり、関数の中で設定したオプションをその関数内だけで有効にする、という動作になる。 例を紹介する。 glob_dots を関数の中だけで有効にする例 glob_dots は、* でワイルドカード指定したときにドットで始まるファイル名にもマッチするようになるオプション。 デフォルトでは無効になってるんだけど、シェルスクリプトとかzshrcの中に関数を書いている時とかでたまに有効にしたくなることがある。でも適当に有効にすると影響範囲が大きくなりすぎて困る。そういうときに local_options

初めに ghq というコマンドがある。GitHub のリポジトリをクローンしていい感じに管理するコマンドだ。 これには zsh 補完ファイルも含まれているんだけど、補完できないオプションあったりして、いまいちだった。なのでそれを直すことにした。 何日か前に修正して Pull Request を送ったら無事取り込まれたので、どういう感じで修正したのか、その過程を紹介してみる。補完関数の書き方が分からない人でも雰囲気は伝わると思うので参考にしてみてほしい。 ちなみに、ghq 自体の詳しい使い方は作った人の紹介記事を見るのが良いと思う。 どこを直すか まず、ghq コマンドの基本的な使い方はこんな感じ。 # GitHub の mollifier/config リポジトリをローカルに clone する % ghq get mollifier/config # clone したリポジトリを一覧表示す

僕はコマンドラインで使うシェルスクリプトを書くことがけっこうあるんだけど、インターフェイスというか呼び出し方はとても大事だと思ってるので、そこにわりと時間をかけて考えるようにしてる。実装はいつでも変更できるけど呼び出し方を変えた時は利用者にも変更を強いるので、できれば最初から良い設計で作りたいと思っている。 そこで、僕がシェルスクリプトのオプションとか引数とかの仕様を決める上で注意していることをまとめてみた。シェルスクリプトや、その他コマンドラインのツールを作るときに参考にしてほしい。 シェルの種類は bash や zsh を想定してるけど、実装によらない話なのでどんなシェルでも使えると思う。 エラーの時に Usage (使い方ヘルプメッセージ)を表示するのはやめる エラーになった時に Usage (使い方ヘルプメッセージ) を表示するスクリプトがあるけど、やめたほうがいいと思う。例えばこ

これは何? zsh で自分で補完関数を作るとき、作った関数を直してもう一回読み込んで確認して、っていう手順がけっこうめんどくさい。それを簡単にしたくて、前にさっと再読み込みできるようにする関数を作った。 zsh で自分で作っている補完関数を簡単に再読み込みする - Qiita でも呼び出し方が微妙に分かりにくかったり、使ってるうちに細かく不満が出てきて、独立したプラグインとして書き直したので紹介する。自作の補完関数をデバッグするときに役にたつので、そういうのを書く人は使ってみるといいと思う。 zload という名前にした。コードは GitHub に置いてある。 https://github.com/mollifier/zload インストール まず GitHub の zload のページから zload, _zload と2つファイルを取ってきて $fpath の通ったところに配置する。そ

これでも間違いというわけではないんだけど、追加するディレクトリが存在しない場合も path に追加されて、結果として無駄なディレクトリが含まれている状態になってしまう。あんまりうれしくない。 でも zsh にはちゃんとそれを防ぐ方法があって、ディレクトリ名の後ろに (N-/) を付ければうまく解決できる。

追記 ここで紹介した機能を持つ独立したプラグインを作成しました。 zsh で補完関数を作るときに便利な再読み込みするプラグインを作った - Qiita 本格的に使うならこちらをおすすめします。 はじめに 自分で zsh の補完関数とかを作る時に便利な関数を作ったので紹介する。 これは何? zsh の補完関数を作ったとき、当然それを呼び出して確認してってする。でもその準備がけっこうめんどくさい。 まず、その補完関数を fpath の通ったところに置かないといけない。 例えばカレントディレクトリの中に _my-command という補完関数を作っているとして

Qiita 見てたらこんな投稿を見つけた。 Zsh - よく作業するDirをBookmarkするshellスクリプト - Qiita だいたい、よく使うディレクトリに cd したいとき cd ~/work/project/ruby/web とか長い名前を打つのはめんどくさい。$CDPATH を通しておくっていう手もあるけど、タブで補完したときに候補がいっぱい出たりして微妙に便利じゃない。そんなときにこれを使えばディレクトリの移動が簡単になる。 ちょっと改良の余地があるというか、タブで補完できるようにしたらもっと便利になると思って、独立した zsh のプラグインとして書き直したので紹介する。 このプラグインでできること cd-bookmark というプラグインを作った。これをインストールすれば cd-bookmark というコマンドが使えるようになる。 こいつを使えばよく使うディレクトリに別

zsh には編集子(modifiers)というのがある。 こいつを使うと、グロブ展開(ワイルドカード展開)の結果をいろいろと編集できるようになる。 簡単な例 とりあえず例を見てもらったほうが早いと思う。 # 今このディレクトリにいる % pwd /home/mollifier/tmp # ファイルが2つある % echo * fuga.txt hoge.txt # :a は編集子の一種で、フルパスに変換する % echo *(:a) /home/mollifier/tmp/fuga.txt /home/mollifier/tmp/hoge.txt # :r も編集子の一種で、ファイルの拡張子の部分を取り除く % echo *(:r) fuga hoge # 並べて書けば2つ以上使うこともできる % echo *(:a:r) /home/mollifier/tmp/fuga /home/mo