vcscommand.vimを少し便利に使う

本記事は Vim Advent Calendar 2012 の１８９日目です。１８８日目は @supermomonga さんの Vimのチートシート生成サービス作りました。感じ感じ。 | かなりすごいブログでした。

ここでは Vim からバージョン管理システム上のファイルを扱う際に便利なプラグイン vcscommand.vim とその少し便利な使い方について紹介します。

vcscommand.vimとは

名前の通り Vim からバージョン管理システム（Version Control System：VCS）に対する操作を行うためのプラグインです。特定の VCS を目的としたものではなく、CVS、Subversion、SVK、Git、Mercurial、Bazaar など複数の VCS を同じように操作できるのが特徴です。

vcscommand.vim - CVS/SVN/SVK/git/hg/bzr integration plugin : vim online

操作と言っても複数のファイルをまとめて扱う類のものではなく、開いている単一のファイルに対する操作が中心になります。

インストール

プラグインマネージャを使う場合

プラグインのインストール方法はいくつかありますが、Vundle や NeoBundle を使用している場合は名前だけで導入できて楽です。（以下は Vundle の例）

Bundle 'vcscommand.vim'

このプラグインに限りませんが何らかのプラグインマネージャを導入しておくと気軽に試せるのでオススメです。

zipファイルを解凍する場合

runtimepath にこだわりが無い場合は vim-online から zip ファイルをダウンロードして ~/.vim 以下に展開します。

% curl -L -o ./vcscommand-1.99.47.zip http://www.vim.org/scripts/download_script.php?src_id=19809

% unzip ./vcscommand-1.99.47.zip -d ~/.vim
Archive:  ./vcscommand-1.99.47.zip
c0d27010dd0c96884cfd34c3af621ae009109c69
   creating: /home/yoshikaw/.vim/doc/
  inflating: /home/yoshikaw/.vim/doc/vcscommand.txt
   creating: /home/yoshikaw/.vim/plugin/
  inflating: /home/yoshikaw/.vim/plugin/vcsbzr.vim
  inflating: /home/yoshikaw/.vim/plugin/vcscommand.vim
  inflating: /home/yoshikaw/.vim/plugin/vcscvs.vim
  inflating: /home/yoshikaw/.vim/plugin/vcsgit.vim
  inflating: /home/yoshikaw/.vim/plugin/vcshg.vim
  inflating: /home/yoshikaw/.vim/plugin/vcssvk.vim
  inflating: /home/yoshikaw/.vim/plugin/vcssvn.vim
   creating: /home/yoshikaw/.vim/syntax/
  inflating: /home/yoshikaw/.vim/syntax/cvsannotate.vim
  inflating: /home/yoshikaw/.vim/syntax/gitannotate.vim
  inflating: /home/yoshikaw/.vim/syntax/hgannotate.vim
  inflating: /home/yoshikaw/.vim/syntax/svkannotate.vim
  inflating: /home/yoshikaw/.vim/syntax/svnannotate.vim
  inflating: /home/yoshikaw/.vim/syntax/vcscommit.vim

ファイル一覧をみるとサポートしている各 VCS の実装があることが分かります。

使い方

VCS で一般的な操作に対応したコマンドが用意されています。CVS 専用のコマンドもありますが、長いこと使ってないのでコマンドの意味は忘れてしまいました。このプラグインを使う上では、よほど頻繁に使う場合を除いて VCS 固有のコマンドは覚えなくても良いかなと思っています。詳しくは :h vcscommand でご確認ください。

コマンド

デフォルトマッピング	コマンド	説明
<Leader>ca	VCSAdd	ファイルを VCS 管理に追加
<Leader>cn	VCSAnnotate (VCSBlame)	行毎にリビジョンと最終更新者の情報を表示 ! でアノテーションをファイルと別のバッファに分割して同期表示
<Leader>cN	VCSCommit	VCS 管理のファイルをコミット ! で空のコミットログ
<Leader>cD	VCSDelete (VCSRemove)	ファイルを VCS 管理から削除
<Leader>cd	VCSDiff	ファイルをリポジトリの現在のリビジョンと比較（Unified Diff 形式）引数を１つ与えた場合、そのリビジョンとファイルを比較引数を２つ与えた場合、その２つのリビジョンを比較
<Leader>cg	VCSGotoOriginal	VCS 管理のファイルを開いているバッファを表示
<Leader>cG	VCSGotoOriginal!	VCS 管理のファイルを開いているバッファを表示して残りのスクラッチバッファを除去
<Leader>ci	VCSInfo	ファイルの VCS 管理情報を表示
<Leader>cl	VCSLog	VCS 管理ログを表示引数を１つ与えた場合、そのリビジョンのログを表示それ以外の引数は VCS コマンドに渡される
<Leader>cL	VCSLock	VCS 管理のファイルをロック(VCSに依存)
	VCSRevert	ファイルを VCS 管理のリビジョンに戻す
<Leader>cr	VCSReview	引数で与えた特定のリビジョンを別バッファに表示引数を与えない場合は現在のリビジョンを表示
<Leader>cs	VCSStatus	ファイルの VCS 管理情報を別バッファに表示
<Leader>cu	VCSUpdate	VCS 管理の最新ファイルに更新
<Leader>cU	VCSUnlock	VCS 管理のファイルをアンロック
<Leader>cv	VCSVimDiff	VCS 管理との差分を VimDiff 形式で表示

CVS専用のコマンド

デフォルトマッピング	コマンド
<Leader>ce	CVSEdit
<Leader>cE	CVSEditors
<Leader>ct	CVSUnedit
	CVSWatch
<Leader>cwa	CVSWatchAdd (CVSWatch add)
<Leader>cwn	CVSWatchOn (CVSWatch on)
<Leader>cwf	CVSWatchOff (CVSWatch off)
<Leader>cwr	CVSWatchRemove (CVSWatch remove)
<Leader>cw	CVSWatchers

マッピング接頭辞をカスタマイズ

mapleader を設定していない場合は \ c l で VCS ログを見る、となります。これはこれで覚えてしまえばよいのですが、g:VCSCommandMapPrefix でマッピングの接頭辞（<Leader>c）を変更できます。

私は次のように設定していますので , v l で VCS ログを見る、となります。よく使うものだけマッピングを書いても良いのですが、こうやって接頭辞だけカスタマイズして用意されているデフォルトマッピングを手軽に自分流にできるのも便利ですね。

よく使うコマンド

私がよく使うコマンドについて Subversion での実行例をあわせて紹介します。

実行例の背景画像は @IMAGEDRIVE さんのイラストを @supermomonga さんの Vim チートシート化したものを使用しています。素敵なイラストとツール、たいへん有り難く使わせて頂きます。

VCSLog

VCS といったらまずは変更履歴。管理されているファイルを開いて VCSLog すると、別のバッファに変更履歴が表示されます。

VCSAnnotate

「この変更を入れたのは誰だあっ！！」というのを調べるときに少し役立つ VCSAnnotate。アノテーションがハイライトされたバッファが分割表示されます。

なおこのコマンドは ! をつけて実行（VCSAnnotate!）するとアノテーションとコードを別のバッファにして同期表示してくれますが、区切りが残念な感じになることが多いです。AUTHOR の最大文字数に合わせざるをえないので難しいところですね。

VCSDiff

手元に加えた変更との差分は VCSDiff で Unified 形式で確認できます。

２つ引数を与えると、任意のリビジョン間の差分が確認できます。

VCSVimDiff

VCSVimDiff で vimdiff コマンドと同じように表示できます。このコマンドも引数にリビジョンを指定できます。見比べながらのマージ作業などに役立ちます。

VCSCommit

変更をコミットするときは VCSCommit。実行するとコミットメッセージを入力するバッファが開きます。バッファを保存するとコミットされます。

もう少し使いやすくする

ここまで紹介したコマンドを個別に使うだけでも便利なのですが、どれも単機能で少し物足りません。

vcscommand.vim ではバッファを作る際に VCSBufferCreated というイベントを発生します。これを利用して新規バッファに対してマッピングなどを仕込むことで、q でバッファを手軽に閉じるなどのカスタマイズができます。（詳しくは :h vcscommand-events）

実際に使用している設定を以下に貼り付けていますが、具体的にどうカスタマイズしているかというと、

VCSLog で開いたバッファで <CR> するとカーソル行のログのリビジョンを取得して VCSDiff、v すると VCSVimDiff、i すると VCSInfo
VCSDiff で開いたバッファで l するとそのリビジョンの VCSLog
VCSAnnotate で開いたバッファで v するとカーソル行のリビジョンを取得して VCSDiff、v すると VCSVimDiff、l するとそのリビジョンの VCSLog、i すると VCSInfo
ウィンドウが1つの時は vsplit して新規バッファを表示（通常は split）

などとしています。これでカーソル行のあるリビジョンについて、ログ表示→差分表示→ログ表示→差分表示、などと追跡が容易になります。対象とするリビジョンは各 VCS の出力メッセージから取得していますが、いまのところ私が使用することのある Subversion、git、Mercurial しか対応していません。

おわりに

今回の Vim Advent Calendar では git に関する話題が多くて Subversion 使いとしては肩身が狭かったのですが、普段 Windows 端末の TortoiseSVN で行っているような履歴の追跡に近いことを vcscommand でも出来ますよ！ということを紹介させていただきました。

明日は @basyura さんです。楽しみですね。

VAC 190 日目 : TweetVim 2.1 Release !! - UserStream (実験的) 付 - basyura's blog

Keep It Simple, Stupid

2013/06/08