HN 日本語サマリー

← 一覧へ戻る
プログラミング

git history コマンドはもっと注目されるべき

The Git history command deserves more attention (lalitm.com)

408 pointsby turbocon287 コメント

要約

Gitの履歴操作をより安全かつ効率的に行うための実験的なコマンド「git history」について解説しています。このコマンドは、jjのような外部ツールに切り替えることなく、既存のGitワークフロー内でコミットの修正や分割をアトミックに行う機能を提供します。fixup、reword、splitの3つのサブコマンドを通じて、開発者は履歴の整合性を保ちながら、より洗練されたコミット管理が可能になります。

全文翻訳

Git history コマンドはもっと注目されるべき

Gitで多くの変更を並行して扱うのは骨が折れる作業です。ブランチやコミットを駆使し、少しのミスでリポジトリを半壊状態にしてしまうような危険な rebase -i コマンドを実行することになります。

最近よく議論されている git の代替である jj は、その解決策として提案されています。jj が解決しようとしている問題点には非常に共感しますが、その解決方法が私にはまだしっくりきていません。過去1年半、3ヶ月ごとに数日間試していますが、ワークフローに組み込もうと努力しても、結局は諦めて git に戻ってしまいます。

そこで登場するのが git history です。これは2つのリリース(2.54(4月、reword と split サブコマンド)および 2.55(6月、fixup サブコマンド))で追加された実験的な コマンドです。各リリース日には注目されましたが、その後、コミュニティでの議論はあまり見られなかったようです。これは残念なことです。なぜなら、私の意見では、これは jj の利点の多くを、ワークフロー全体を切り替えることなく既に提供しているからです。そして素晴らしいのは、これがコア git ディストリビューションの一部であるため、何もインストールせずに試せることです。

3つのサブコマンドがあります: fixup、reword、split。

fixup#

git history fixup は、何か問題がある古いコミットを修正し、その後、すべてのブランチを自動的にリベースして対応させます。

通常通り git add で修正をステージングし、次に git history fixup <commit> を実行して、ステージングされた変更を対象コミットに折り込みます。これは git commit --fixup と autosquash rebase のようなものですが、さらに、そのコミットを含んでいた他のすべてのブランチも更新するという追加の魔法があります。

この最後の部分は、git rebase --update-refs よりも強力です。git rebase --update-refs は、アクティブにリベースしている範囲内の参照のみを移動させます。一方、git history は、そのコミットから派生したすべてのローカルブランチを見つけて書き換えます(現在のブランチのみに限定するオプションもあります)。一方で、マージコミットが存在する場合には機能しません。これは、git の一部の用途では決定的な欠点となるでしょう。

以下に実際の動作を示します:

修正を B に対してステージングした後の状態:

[画像: Commits A, B (buggy), C on feat-1 and D on feat-2 in a line, with a staged fix sitting on top of the tip D.] [画像: Commits A, B (buggy), C on feat-1 and D on feat-2 in a line, with a staged fix sitting on top of the tip D.]

git history fixup B 実行後:

[画像: After fixup: A unchanged; B (now fixed), C and D rewritten with new hashes, branch tips feat-1 and feat-2 following.] [画像: After fixup: A unchanged; B (now fixed), C and D rewritten with new hashes, branch tips feat-1 and feat-2 following.]

B* は修正が折り込まれた B です。コミットを書き換えると新しいハッシュが生成されるため、C と D は C* および D* として自動的に再作成され、feat-1 および feat-2 ブランチの先端もそれに追従します。

最も重要な特性は、3つのコマンドすべてに共通する点ですが、それはアトミックであるということです。つまり、リポジトリを半壊した状態で放置することはありません。これは、コンフリクトが発生する可能性のある操作を拒否することで実現されます。

明確にしておくと、これは jj よりも厳密に機能が限定的です。jj はコンフリクトをファーストクラスとして扱います。そのため、リベース中にコンフリクト状態を保持し、後で解決することができます。git history はまだこれを実行できませんが、ドキュメントでは可能性を残しています:

"This limitation is by design as history rewrites are not intended to be stateful operations. The limitation can be lifted once (if) Git learns about first-class conflicts."

つまり、この制限は将来的に変更される可能性があります。その変化に期待しています!

reword#

git history reword は、古いコミットのコミットメッセージを更新し、すべてを自動的にリベースします。これは、イテレーション中に設計が変更された場合に、コミットメッセージを後から修正するのに非常に役立ちます。

git history reword <commit> は、そのコミットの既存のメッセージでエディタを開きます。メッセージを編集して保存すると、残りのスタックが再構築され、ブランチもそれに追従します。これは fixup と全く同じですが、ツリーの内容ではなくコミットメッセージに対して行われます。

メッセージのみを変更するため、reword(後述の split も同様)はインデックスやワーキングツリーに一切触れることがありません。コミットグラフのみを操作します。そのため、どちらのコマンドも、チェックアウトしていないブランチ上のコミットを、現在作業中の内容を邪魔することなく書き換えることができます。

実行前:

[画像: Commits A, B with message 'fix bug', and C on feat-1.] [画像: Commits A, B with message 'fix bug', and C on feat-1.]

git history reword B 実行後:

[画像: After reword: A unchanged; B rewritten with message 'fix null deref in parser' and C rewritten on top.] [画像: After reword: A unchanged; B rewritten with message 'fix null deref in parser' and C rewritten on top.]

B のメッセージのみが変更されますが、それでも新しいハッシュが生成されるため、C は C* として再構築され、feat-1 もそれに追従します。

split#

git history split は、1つのコミットを2つに分割し、それぞれのコミットに含めたい内容を対話的に選択します。これは git add -p に相当しますが、git rebase で複雑な操作を行う必要がありません。これは3つの中で最も特殊なコマンドだと感じていますが、必要な時には非常に役立ちます。

具体的には、git history split <commit> を実行すると、そのコミットの差分に対して、チャンクごとにプロンプトが表示されます。保持するチャンクが最初のコミットになり、残りが2番目のコミットになります。

B が2つの無関係な変更をまとめていた場合(実行前):

[画像: Commit B bundling two unrelated changes, between A and C on feat-1.] [画像: Commit B bundling two unrelated changes, between A and C on feat-1.]

git history split B 実行後:

[画像: After split: A unchanged; B split into B1 and B2, and C rewritten on top as C*.] [画像: After split: A unchanged; B split into B1 and B2, and C rewritten on top as C*.]

B は B1 と B2 に分割され、C はペアの上に C* として再構築されます。

Conclusion#

jj を使用している人の数を見ると、まだ私が理解できていない重要な考え方があると思います。そして明確にしておくと、git history はそのギャップを完全に埋めるものではありません。jj は依然として操作ログによる簡単な元に戻す機能、ワーキングコピーをコミットとしてモデル化する機能、そしてリベース中にコンフリクトを保持する機能を提供しており、これらは git history が目指しているものではありません。

しかし、現時点では、git history は jj に人々を引きつける多くの要素を取り入れるための大きな一歩であり、既に私が毎日使っているツールに含まれています。そして、ドキュメントの書き方から、今後のリリースでさらに改善が行われることを期待しています!