In che modo git-diff genera descrizioni di hunk?

Question

(git versione 1.6.5.7)

Quando eseguo git diff l'uscita ha un buon suggerimento ambito dopo i numeri di riga per il mio script Python, ad esempio:

diff --git a/file.py b/file.py 
index 024f5bb..c3b5c56 100644 
--- a/file.py 
+++ b/file.py 
@@ -14,6 +14,8 @@ TITF: Test Infrastructure Tags Format 
... 
@@ -1507,13 +1533,16 @@ class Tags(object): 
... 

Si noti che i numeri di riga sono seguiti da TITF: Test Infrastructure Tags Format e class Tags(object):. La prima patch si applica all'ambito del modulo e la descrizione TITF: Test Infrastructure Tags Format è la descrizione del modulo. La seconda patch si applica a un metodo della classe Tags.

1. In che modo git genera queste descrizioni?
2. Come posso modificarli per mostrare il nome del metodo a cui si applica la patch?

Answer 1

Git utilizza un'espressione regolare per trovare una riga adatta per le intestazioni di hunk. Python è built-in, ma si dovrebbe essere in grado di definire la propria espressione nel tuo ~/.gitconfig:

[diff "python"] 
     xfuncname = "<regex goes here>" 

Ulteriori su questi here.

Edit: l'espressione regolare python built-in sembra essere definita in userdiff.c (linea 53), anche se il mio regex-fu non è sufficiente per capire in realtà esattamente ciò che fa ...

PATTERNS("python", "^[ \t]*((class|def)[ \t].*)$", 
     /* -- */ 
     "[a-zA-Z_][a-zA-Z0-9_]*" 
     "|[-+0-9.e]+[jJlL]?|0[xX]?[0-9a-fA-F]+[lL]?" 
     "|[-+*/<>%&^|=!]=|//=?|<<=?|>>=?|\\*\\*=?" 
     "|[^[:space:]|[\x80-\xff]+"), 
     /* -- */