Kann Git wirklich die Bewegung einer einzelnen Funktion von einer Datei in eine andere verfolgen? Wenn das so ist, wie?

Mehrmals bin ich auf die Aussage gestoßen, dass Git sie verfolgen kann, wenn Sie eine einzelne Funktion von einer Datei in eine andere verschieben. In diesem Eintrag heißt es beispielsweise : "Linus sagt, wenn Sie eine Funktion von einer Datei in eine andere verschieben, zeigt Git Ihnen den Verlauf dieser einzelnen Funktion während der Verschiebung an."

Aber ich bin mir ein bisschen bewusst, was Git unter der Haube zu bieten hat, und ich sehe nicht, wie das möglich ist. Ich frage mich also ... ist das eine korrekte Aussage? Und wenn ja, wie ist das möglich?

Mein Verständnis ist, dass Git den Inhalt jeder Datei als Blob speichert und jeder Blob eine global eindeutige Identität hat, die sich aus dem SHA-Hash seines Inhalts und seiner Größe ergibt. Git repräsentiert dann Ordner als Bäume. Alle Dateinameninformationen gehören zum Baum, nicht zum Blob, sodass eine Umbenennung einer Datei beispielsweise als Änderung eines Baums und nicht eines Blobs angezeigt wird.

Wenn ich also eine Datei namens "foo" mit 20 Funktionen und eine Datei namens "bar" mit 5 Funktionen habe und eine der Funktionen von foo in bar verschiebe (was 19 bzw. 6 ergibt), Wie kann Git erkennen, dass ich diese Funktion von einer Datei in eine andere verschoben habe?

Nach meinem Verständnis würde dies dazu führen, dass 2 neue Blobs existieren (einer für den modifizierten foo und einer für den modifizierten Balken). Mir ist klar, dass ein Unterschied berechnet werden kann, um zu zeigen, dass die Funktion von einer Datei in die andere verschoben wurde. Aber ich sehe nicht, wie der Verlauf der Funktion möglicherweise mit bar anstelle von foo in Verbindung gebracht werden könnte (jedenfalls nicht automatisch).

Wenn Git tatsächlich in einzelne Dateien schauen und einen Blob pro Funktion berechnen würde (was verrückt / unmöglich wäre, weil man wissen müsste, wie man eine mögliche Sprache analysiert), könnte ich sehen, wie dies möglich sein könnte.

Also ... ist die Aussage richtig oder nicht? Und wenn es richtig ist, was fehlt dann in meinem Verständnis?

Diese Funktionalität wird durch bereitgestellt git blame -C <file>.

Die -COption veranlasst git, Übereinstimmungen zwischen dem Hinzufügen oder Löschen von Textblöcken in der zu überprüfenden Datei und den in denselben Änderungssätzen geänderten Dateien zu finden. Zusätzliche -C -Coder -C -C -Cerweitern Sie die Suche.

Versuchen Sie es selbst in einem Test-Repo mit git blame -Cund Sie werden sehen, dass der Codeblock, den Sie gerade verschoben haben, aus der Originaldatei stammt, zu der er gehört.

Von der git help blameHandbuchseite:

Der Ursprung von Zeilen wird automatisch bei Umbenennungen ganzer Dateien verfolgt (derzeit gibt es keine Option zum Deaktivieren der Umbenennungsfolge). Informationen zum Verfolgen von Zeilen, die von einer Datei in eine andere verschoben wurden, oder zum Verfolgen von Zeilen, die aus einer anderen Datei usw. kopiert und eingefügt wurden, finden Sie in den Optionen -Cund -M.

Ab Git 2.15 git diffunterstützt jetzt die Erkennung von verschobenen Linien mit der --color-movedOption. Es funktioniert für Verschiebungen zwischen Dateien.

Dies funktioniert natürlich für kolorierte Terminalausgänge. Soweit ich das beurteilen kann, gibt es keine Möglichkeit, Bewegungen im Nur-Text-Patch-Format anzugeben, aber das ist sinnvoll.

Versuchen Sie es mit dem Standardverhalten

git diff --color-moved

Der Befehl nimmt auch Optionen, die derzeit no, default,plain , zebraund dimmed_zebra(Verwenden Sie git help diffdie aktuellen Optionen und die Beschreibungen zu bekommen). Zum Beispiel:

git diff --color-moved=zebra

In Bezug auf , wie es geschehen ist, kann man ein gewisses Verständnis von aufzulesen diesem E - Mail Austausch vom Autor der Funktionalität .

Ein Teil dieser Funktionalität befindet sich in git gui blame(+ Dateiname). Es zeigt eine Anmerkung der Zeilen einer Datei, die jeweils angibt, wann sie erstellt und wann sie zuletzt geändert wurde. Bei der Codeverschiebung in einer Datei wird das Festschreiben der Originaldatei als Erstellung und das Festschreiben angezeigt, bei dem es als letzte Änderung zur aktuellen Datei hinzugefügt wurde . Versuch es.

Was ich wirklich möchte, ist, git logals Argument zusätzlich zu einem Dateipfad einen Zeilennummernbereich anzugeben und dann den Verlauf dieses Codeblocks anzuzeigen. Es gibt keine solche Option, wenn die Dokumentation richtig ist. Ja, nach Linus 'Aussage würde auch ich denken, dass ein solcher Befehl leicht verfügbar sein sollte.

git verfolgt Umbenennungen überhaupt nicht . Ein Umbenennen ist nur ein Löschen und Hinzufügen, das ist alles. Alle Tools, die Umbenennungen anzeigen, rekonstruieren sie aus diesen Verlaufsinformationen.

Das Umbenennen von Tracking-Funktionen ist daher eine einfache Angelegenheit, bei der die Unterschiede aller Dateien in jedem Commit nachträglich analysiert werden. Daran ist nichts besonders Unmögliches; Das vorhandene Umbenennungs-Tracking behandelt bereits 'Fuzzy'-Umbenennungen, bei denen einige Änderungen an der Datei vorgenommen und umbenannt werden. Dies erfordert das Betrachten des Inhalts der Dateien. Es wäre eine einfache Erweiterung, auch nach Funktionsumbenennungen zu suchen.

Ich weiß jedoch nicht, ob die Basis-Git-Tools dies tatsächlich tun - sie versuchen, sprachneutral zu sein, und die Funktionsidentifikation ist sehr viel nicht sprachneutral.

Das git diffzeigt Ihnen, dass bestimmte Zeilen verschwunden sind foound wieder aufgetaucht sind bar. Wenn diese Dateien im selben Commit keine weiteren Änderungen enthalten, ist die Änderung leicht zu erkennen.

Ein intellektueller gitKunde kann Ihnen zeigen, wie Zeilen von einer Datei in eine andere verschoben wurden. Eine sprachbewusste IDE könnte diese Änderung einer bestimmten Funktion zuordnen.

Ähnliches passiert, wenn eine Datei umbenannt wird. Es verschwindet nur unter einem Namen und erscheint unter einem anderen wieder, aber jedes vernünftige Tool kann es bemerken und als Umbenennung darstellen.