git diff

では diff の出力をさらに詳しく見ていきましょう。

この行には diff の入力ソースが表示されています。a/diff_test.txt と b/diff_test.txt が diff に渡されているのがわかります。

この行には内部 Git メタデータの一部が表示されています。この情報が必要になることはほぼないでしょう。この出力の数字は Git オブジェクトバージョンのハッシュ識別子に対応しています。

これらの行は各 diff 入力ソースに記号を割り当てる凡例です。今回のケースでは、a/diff_test.txt の変更が --- で示され、b/diff_test.txt の変更が +++ 記号で示されています。

diff 出力のその他の部分は diff の「チャンク」の一覧です。diff ではファイルで変更されたセクションだけが表示されます。現在のサンプルでは単純なシナリオで作業しているため、チャンクは 1 つしかありません。チャンクには独自のきめ細かな出力セマンティックがあります。

最初の行はチャンク ヘッダーです。各チャンクの先頭には、@@ 記号で囲まれたヘッダーがあります。ヘッダーの中身はファイルに加えられた変更の概要になっています。今回のシンプルなサンプルには「-1 +1」がありますが、これは 1 行目に変更があることを意味しています。より現実に近い diff では、以下のようなヘッダーが表示されます。

このヘッダーのサンプルでは、34 行目から 6 行分が抽出されています。さらに、34 行目から 8 行分が追加されています。

diff チャンクの残りの部分には最新の変更が表示されます。変更された各行の先頭には、変更がどのバージョンの diff 入力のものかを示す + または - 記号が先頭に付きます。前に説明したように、- は a/diff_test.txt の変更、+ は b/diff_test.txt の変更を示しています。

これで、変更された単語に色付けされたものだけが出力に表示されるようになりました。

Git ソースをクローンすると、contrib というサブディレクトリに気づくでしょう。このディレクトリには Git 関連のツールや、git の基本機能としてまだ採用されていないこまごまとした面白いものが大量に入っています。たとえば、diff-highlight という Perl スクリプトがあります。diff-highlight は diff 出力で一致する行をグループ化して、変更された、通常の単語よりも小さい塊を強調表示します。

これで、最小限の変更だけが diff として表示されるようになりました。

Git には、diff を実行する前にシェル コマンドを指定してバイナリ ファイルの中身をテキストに変換できる機能があります。ただし、これを行うにはちょっとした設定が必要です。まず、特定の種類のバイナリ ファイルをテキストに変換する方法を記入した textconv フィルターを指定する必要があります。今回は pdftohtml (homebrew から利用可能) というシンプルなユーティリティを使って PDF を人間が読める形の HTML に変換します。1 つのリポジトリでこれを設定するには、.git/config ファイルを編集するか、全体に実行する場合は ~ /.gitconfig を編集します。

この後は 1 つ以上のファイル パターンを pdfconv フィルターと関連付けるだけです。これを行うには .gitattributes ファイルをリポジトリのルートに作成します。

設定が完了したら、git diff はまず設定済みのコンバーター スクリプトでバイナリ ファイルを実行してコンバーター出力の差分を出します。zip や jar、その他のアーカイブ形式を含むすべての種類のバイナリ ファイルで同じ手法を使って有用な差分を出せます。pdf2html の代わりに unzip -l (または類似のコマンド) を使ってコミット イメージ間で追加または削除されたパスを表示します。exiv2 を使ってイメージ ディメンション ドキュメントなどのメタデータの変更を表示できます。.odf や .doc などその他のドキュメント形式をプレーン テキストに変換する変換ツールもあります。いざという時には、正式なコンバーターがなくてもほとんどの場合、ストリングを使ってバイナリ ファイルを変換できます。

このサンプルでは呼び出し時に対象を /path/to/file に限定していて、作業ディレクトリとインデックスの特定の変更を比較することでまだステージされていない変更を表示しています。デフォルトでは、git diff は HEAD との比較を実行します。上のサンプルの、git diff ./path/to/file から HEAD を省略しても同じ結果が得られます。

--cached オプションを指定して git diff を呼び出すと、ステージ済みの変更とローカル リポジトリを比較して差分を出します。--cached オプションは --staged と同義です。

ファイル パスを指定せずに git diff を呼び出すと、リポジトリ全体の変更を比較します。上のファイル固有のサンプルは ./path/to/file 引数なしで呼び出せて、ローカル リポジトリのすべてのファイルで同じ出力結果が出ます。

デフォルトでは、git diff は最後のコミット以降コミットされていない変更を表示します。

git diff に Git ref を渡して diff にコミットできます。ref の例としては、HEAD、タグ、ブランチ名があります。Git のすべてのコミットにはコミット ID があり、GIT LOG を実行して取得できます。また、このコミット IDを git diff に渡せます。

このサンプルではドット演算子を紹介します。このサンプルの 2 つのドットは、diff 入力が両方のブランチの先端であることを示しています。ドットを省略した場合も同じ結果が得られ、ブランチ間にスペースが使用されます。またドットが 3 つある演算子もあります。

ドットが 3 つある演算子は、最初の入力パラメーター branch1 を変更して diff を開始します。これによって、2 つの diff 入力、branch1 の共有されている祖先、other-feature-branch の間の、共有されている共通の祖先のコミットの ref に branch1 を変更します。最後の入力パラメーターは other-feature-branch の先端のまま変わりません。