Git: ¿cómo veo el historial de cambios de un método / función?

Entonces encontré la pregunta sobre cómo ver el historial de cambios de un archivo, pero el historial de cambios de este archivo en particular es enorme y realmente solo estoy interesado en los cambios de un método en particular. Entonces, ¿sería posible ver el historial de cambios solo para ese método en particular?

Sé que esto requeriría que git analizara el código y que el análisis sería diferente para diferentes lenguajes, pero las declaraciones de método / función se ven muy similares en la mayoría de los lenguajes, así que pensé que tal vez alguien haya implementado esta característica.

El idioma con el que estoy trabajando actualmente es Objective-C y el SCM que estoy usando actualmente es git, pero me interesaría saber si esta función existe para cualquier SCM / idioma.

Las versiones recientes de git logaprendieron una forma especial del -Lparámetro:

-L: <nombre_func>: <archivo>

Rastree la evolución del rango de líneas dado por "<start>,<end>"(o el nombre de la función regex <funcname>) dentro de <file>. No puede dar ningún limitador de especificación de ruta. Actualmente, esto está limitado a una caminata a partir de una única revisión, es decir, solo puede dar cero o uno argumentos de revisión positivos. Puede especificar esta opción más de una vez.
...
Si “:<funcname>”se da en lugar de <start>y <end>, es una expresión regular que denota el rango desde la primera línea de nombre de función que coincide <funcname>, hasta la siguiente línea de nombre de función. “:<funcname>”busca desde el final del -Lrango anterior , si lo hubiera, de lo contrario desde el inicio del archivo. “^:<funcname>”busca desde el inicio del archivo.

En otras palabras: si le pides a Git que git log -L :myfunction:path/to/myfile.clo haga, ahora imprimirá felizmente el historial de cambios de esa función.

El uso git gui blamees difícil de hacer uso de secuencias de comandos, y al mismo tiempo git log -G, y git log --pickaxecada uno puede mostrar que cuando la definición del método apareció o desapareció, no he encontrado ninguna manera de hacer que hagan una lista de todos los cambios realizados en el cuerpo de su método.

Sin embargo, puede usar gitattributesy la textconvpropiedad para armar una solución que haga precisamente eso. Aunque estas características originalmente estaban destinadas a ayudarle a trabajar con archivos binarios, funcionan igual de bien aquí.

La clave es hacer que Git elimine del archivo todas las líneas excepto las que le interesan antes de realizar cualquier operación de diferenciación. Entonces git log, git diffetc. verá sólo el área que le interesa.

Aquí está el esquema de lo que hago en otro idioma; puede modificarlo según sus propias necesidades.

• Escriba un breve script de shell (u otro programa) que tome un argumento, el nombre de un archivo fuente, y muestre solo la parte interesante de ese archivo (o nada si ninguno es interesante). Por ejemplo, puede utilizar sedlo siguiente:

  #!/bin/sh
  sed -n -e '/^int my_func(/,/^}/ p' "$1"
  

• Defina un textconvfiltro Git para su nuevo script. (Consulte la gitattributespágina de manual para obtener más detalles). El nombre del filtro y la ubicación del comando pueden ser los que desee.

  $ git config diff.my_filter.textconv /path/to/my_script
  

• Dile a Git que use ese filtro antes de calcular las diferencias para el archivo en cuestión.

  $ echo "my_file diff=my_filter" >> .gitattributes
  

• Ahora, si usa -G.(tenga en cuenta .) para enumerar todas las confirmaciones que producen cambios visibles cuando se aplica su filtro, tendrá exactamente las confirmaciones que le interesan. Cualquier otra opción que use las rutinas diff de Git, como --patch, también obtenga esta vista restringida.

  $ git log -G. --patch my_file
  

• ¡Voilà!

Una mejora útil que podría querer hacer es que su script de filtro tome un nombre de método como primer argumento (y el archivo como segundo). Esto le permite especificar un nuevo método de interés simplemente llamando git config, en lugar de tener que editar su secuencia de comandos. Por ejemplo, podrías decir:

$ git config diff.my_filter.textconv "/path/to/my_command other_func"

Por supuesto, el script de filtro puede hacer lo que quiera, aceptar más argumentos o lo que sea: hay mucha flexibilidad más allá de lo que he mostrado aquí.

git log tiene una opción '-G' que podría usarse para encontrar todas las diferencias.

-G Busque diferencias cuya línea agregada o eliminada coincida con la dada <regex>.

Solo dale una expresión regular adecuada del nombre de la función que te interesa. Por ejemplo,

$ git log --oneline -G'^int commit_tree'
40d52ff make commit_tree a library function
81b50f3 Move 'builtin-*' into a 'builtin/' subdirectory
7b9c0a6 git-commit-tree: make it usable from other builtins

Lo más cercano que puede hacer es determinar la posición de su función en el archivo (por ejemplo, digamos que su función i_am_buggyestá en las líneas 241-263 de foo/bar.c), luego ejecute algo con el efecto de:

git log -p -L 200,300:foo/bar.c

Esto abrirá menos (o un localizador equivalente). Ahora puede escribir /i_am_buggy(o su equivalente en buscapersonas) y comenzar a revisar los cambios.

Esto incluso podría funcionar, dependiendo de su estilo de código:

git log -p -L /int i_am_buggy\(/,+30:foo/bar.c

Esto limita la búsqueda desde el primer hit de esa expresión regular (idealmente su declaración de función) a treinta líneas después de eso. El argumento final también puede ser una expresión regular , aunque detectar eso con expresiones regulares es una proposición más dudosa.

La forma correcta es usarlo git log -L :function:path/to/filecomo se explica en la respuesta de eckes .

Pero además, si su función es muy larga, es posible que desee ver solo los cambios que han introducido varias confirmaciones, no todas las líneas de función, incluidas sin modificar, para cada confirmación que tal vez toque solo una de estas líneas. Como lo hace una persona normal diff.

Normalmente git logpuede ver diferencias con -p, pero esto no funciona con -L. Por lo tanto, grep git log -Ldebe mostrar solo las líneas involucradas y el encabezado de confirmaciones / archivos para contextualizarlos. El truco aquí es hacer coincidir solo las líneas de color de la terminal, agregando un --colorinterruptor, con una expresión regular. Finalmente:

git log -L :function:path/to/file --color | grep --color=never -E -e "^(^[\[[0-9;]*[a-zA-Z])+" -3

Tenga en cuenta que ^[debe ser real, literal ^[. Puede escribirlos presionando ^ V ^ [en bash, es decir Ctrl+ V, Ctrl+ [. Referencia aquí .

También último -3interruptor, permite imprimir 3 líneas de contexto de salida, antes y después de cada línea emparejada. Es posible que desee ajustarlo a sus necesidades.

git blame te muestra quién cambió por última vez cada línea del archivo; puede especificar las líneas a examinar para evitar que el historial de líneas esté fuera de su función.

1. Muestra el historial de funciones con git log -L :<funcname>:<file>como se muestra en la respuesta de eckes y git doc

   Si no muestra nada, consulte Definición de un encabezado de trozo personalizado para agregar algo similar *.java diff=javaal .gitattributes archivo para admitir su idioma.

2. Mostrar historial de funciones entre confirmaciones con git log commit1..commit2 -L :functionName:filePath

3. Muestra el historial de funciones sobrecargado (puede haber muchas funciones con el mismo nombre, pero con diferentes parámetros) con git log -L :sum\(double:filepath