チケットとソースコードを連携せよ！

Tracの最大の利点はSubversionとの連携にあり

さて、最終回の今回はTracのチケットとソースコードの連携を実際に試していく。

コードを書く開発者から見た場合、Tracの最大の利点は普段使い慣れたSubversionから、Tracを使うことができる点にある。開発者は自分の環境に新たなツールをインストールすることなく、Tracへ情報を送ることができる。

Tracの操作は通常Webから行うが、すべての操作をコマンドラインからでもできる。この機能とSubversionへコミット時に自動的に コマンドを呼び出すフックという機能を組み合わせることで、開発者がリポジトリへコミットするとTracを操作するという処理を自動化できるのである。

TracとSubversionの連携

Subversionのフックは、Subversionサーバで設定する。リポジトリディレクトリの下にあるhooksディレクトリにファイル を設置することで、リポジトリへの動作に対してそのコマンドが呼ばれる。デフォルトで置いてある*.tmplというファイル群はサンプルのファイルであ る。

コミット後に呼ばれるのは「post-commit」である。「hooks/post-commit」という実行可能ファイルを置いておくと、 コミット後にこのコマンドが呼ばれることになる。post-commitには、第一引数にリポジトリのパス、第二引数にコミット後のリビジョン番号が入っ ている。

Subversionへコミットするときに書き込むコメントやコミットメッセージに書かれたコマンドを元に、Tracを操作するコマンドは「trac-post-commit-hook」といい、Tracの公式リポジトリ(http://trac.edgewall.org/browser/trunk/contrib/trac-post-commit-hook）で配布されている。

このコマンドがサポートしているチケット操作コマンドは、コミット内容とチケットを関連づけるreferencesと、チケットを閉じる closeである。コマンドの書式は、「コマンド名 チケット番号」となる。前後を()でくくったり、半角空白が開いていれば、文の途中でも使うことができる。

コマンド名は複数の書き方ができ、関連付けるコマンドはreferences、refs、addresses、re、seeのいずれかで指定す る。筆者の場合はよく「refs」を使っている。また、チケットを閉じるコマンドはclose、closed、closes、fix、fixed、 fixesのいずれかで指定する。こちらは筆者の場合「fixed」を使っている。

チケット番号の指定には、「#チケット番号」か「ticket:チケット番号」という書式を用いる。例えばチケット1番を指定する場合には、「#1」か「ticket:1」のようになる。

同時に複数のチケットを指定したい場合には「,（カンマ）」やand、&といった文字で区切って指定する。例えば、コミットするソースがチケット5番と7番に関係する場合、コミットメッセージに「refs #5, #7」と書く。