Visualización de topología de rama en Git

Estoy jugando con Git de forma aislada en mi propia máquina, y me resulta difícil mantener un modelo mental de todas mis ramas y compromisos. Sé que puedo hacer git logpara ver el historial de confirmación desde donde estoy, pero ¿hay alguna manera de ver toda la topografía de la rama, algo como estos mapas ASCII que parecen usarse en todas partes para explicar las ramas?

      .-A---M---N---O---P
     /     /   /   /   /
    I     B   C   D   E
     \   /   /   /   /
      `-------------'

Se siente como si alguien viniera y tratara de recoger mi repositorio tendría dificultades para resolver exactamente lo que estaba sucediendo.

Supongo que estoy influenciado por el navegador de flujo de AccuRev ...

Use git log --grapho gitk. (Ambos también aceptan --all, lo que mostrará todas las ramas en lugar de solo la actual).

Para nombres de sucursales y una vista compacta, intente:

git log --graph --decorate --oneline

Yo suelo usar

git log --graph --full-history --all --pretty=format:"%h%x09%d%x20%s"

Con colores (si su caparazón es Bash):

git log --graph --full-history --all --color \
        --pretty=format:"%x1b[31m%h%x09%x1b[32m%d%x1b[0m%x20%s"

Esto imprimirá una representación basada en texto como esta:

* 040cc7c       (HEAD, master) Manual is NOT built by default
* a29ceb7       Removed offensive binary file that was compiled on my machine and was hence incompatible with other machines.
| * 901c7dd     (cvc3) cvc3 now configured before building
| * d9e8b5e     More sane Yices SMT solver caller
| | * 5b98a10   (nullvars) All uninitialized variables get zero inits
| |/
| * 1cad874     CFLAGS for cvc3 to work successfully
| *   1579581   Merge branch 'llvm-inv' into cvc3
| |\
| | * a9a246b   nostaticalias option
| | * 73b91cc   Comment about aliases.
| | * 001b20a   Prints number of iteration and node.
| |/
|/|
| * 39d2638     Included header files to cvc3 sources
| * 266023b     Added cvc3 to blast infrastructure.
| * ac9eb10     Initial sources of cvc3-1.5
|/
* d642f88       Option -aliasstat, by default stats are suppressed

(Podría usar git log --format=oneline, pero vinculará los mensajes de confirmación con los números, lo que se ve menos bonito en mi humilde opinión).

Para crear un acceso directo para este comando, es posible que desee editar su ~/.gitconfigarchivo:

[alias]
  gr = log --graph --full-history --all --color --pretty=tformat:"%x1b[31m%h%x09%x1b[32m%d%x1b[0m%x20%s%x20%x1b[33m(%an)%x1b[0m"

Sin embargo, como Sodel the Vociferous señala en los comentarios, ese comando de formateo largo es difícil de memorizar. Por lo general, no es un problema, ya que puede incluirlo en el ~/.gitconfigarchivo. Sin embargo, si a veces tiene que iniciar sesión en una máquina remota donde no puede modificar el archivo de configuración, puede usar una versión más simple pero más rápida para escribir:

git log --graph --oneline

Tengo 3 alias (y 4 alias-alias para uso rápido) que normalmente incluyo en mi ~/.gitconfigarchivo:

[alias]
    lg = lg1
    lg1 = lg1-specific --all
    lg2 = lg2-specific --all
    lg3 = lg3-specific --all

    lg1-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(auto)%d%C(reset)'
    lg2-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold cyan)%aD%C(reset) %C(bold green)(%ar)%C(reset)%C(auto)%d%C(reset)%n''          %C(white)%s%C(reset) %C(dim white)- %an%C(reset)'
    lg3-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold cyan)%aD%C(reset) %C(bold green)(%ar)%C(reset) %C(bold cyan)(committed: %cD)%C(reset) %C(auto)%d%C(reset)%n''          %C(white)%s%C(reset)%n''          %C(dim white)- %an <%ae> %C(reset) %C(dim white)(committer: %cn <%ce>)%C(reset)'

git lg/ se git lg1ve así:

git lg2 Se ve como esto:

y se git lg3ve así:

Debe tenerse en cuenta que esto no pretende ser una solución final: es una plantilla que puede cambiar, agregar y arreglar a su gusto. Si desea utilizar estos, mi recomendación es:

1. Añádelos a tu .gitconfig,
2. Personalice a su gusto (diferentes opciones de color, diferentes arreglos de línea para las versiones de 2 y 3 líneas, etc.),
3. Y luego guarde una copia en un Gist u otra herramienta de fragmento de código para que pueda copiarla y pegarla en .gitconfigs en el futuro (o, alternativamente, controlar la versión de sus archivos de puntos, por supuesto) .

_{Nota: La respuesta copiada y mejorada de la respuesta en stackoverflow.com/questions/1057564/pretty-git-branch-graphs ya que es mucho más apropiada aquí que allí. Dejó la copia en la otra pregunta por razones históricas: ahora está cerrada, y la respuesta está referenciada por un montón de otras respuestas.}

Para cualquiera de estas recetas (basadas en git log o gitk), puede agregar --simplify-by-decorationpara contraer las partes lineales poco interesantes de la historia. Esto hace que se vea mucho más de la topología a la vez. ¡Ahora puedo entender grandes historias que serían incomprensibles sin esta opción!

Sentí la necesidad de publicar esto porque no parece ser tan conocido como debería ser. No aparece en la mayoría de las preguntas de Stack Overflow sobre la visualización del historial, y me llevó bastante buscarlo, ¡incluso después de saber que lo quería! Finalmente lo encontré en este informe de error de Debian . La primera mención en Stack Overflow parece ser esta respuesta de Antoine Pelisse.

Gitk a veces me duele leer

Motívame a escribir GitVersionTree .

El 99.999% de mi tiempo está mirando la historia por git lgy el 0.001% está por git log.

Solo quiero compartir dos alias de registro que podrían ser útiles (configurar desde .gitconfig):

[Alias]
     lg = log --graph --pretty=format:'%Cred%h%Creset %ad %s %C(yellow)%d%Creset %C(bold blue)<%an>%Creset' --date=short
     hist = log --graph --full-history --all --pretty=format:'%Cred%h%Creset %ad %s %C(yellow)%d%Creset %C(bold blue)<%an>%Creset' --date=short

• git lg verá el historial actual de la sucursal.
• git hist Verá toda la historia de la sucursal.

Eche un vistazo a Gitkraken , una GUI multiplataforma que muestra la topología de manera lúcida.

Aquí hay un video tutorial rápido sobre algunas funciones avanzadas.

Me gusta, con git log, hacer:

 git log --graph --oneline --branches

(también con --todos, para ver ramas remotas también)

Funciona con versiones recientes de Git: introducidas desde 1.6.3 ( jue, 7 de mayo de 2009 )

• La --pretty=<style>opción " " para la familia de comandos de registro ahora se puede deletrear como " --format=<style>".
  Además, --format=%formatstringes una abreviatura de --pretty=tformat:%formatstring.

• " --oneline" es sinónimo de " --pretty=oneline --abbrev-commit".

PS D:\git\tests\finalRepo> git log --graph --oneline --branches --all
* 4919b68 a second bug10 fix
* 3469e13 a first bug10 fix
* dbcc7aa a first legacy evolution
| * 55aac85 another main evol
| | * 47e6ee1 a second bug10 fix
| | * 8183707 a first bug10 fix
| |/
| * e727105 a second evol for 2.0
| * 473d44e a main evol
|/
* b68c1f5 first evol, for making 1.0

También puede limitar la duración de la visualización del registro (número de confirmaciones):

PS D:\git\tests\finalRepo> git log --graph --oneline --branches --all -5
* 4919b68 a second bug10 fix
* 3469e13 a first bug10 fix
* dbcc7aa a first legacy evolution
| * 55aac85 another main evol
| | * 47e6ee1 a second bug10 fix

(mostrar solo los últimos 5 commits)

Lo que no me gusta de la solución seleccionada actual es:

 git log --graph

Mostraba demasiada información (cuando solo quiero ver un resumen rápido):

PS D:\git\tests\finalRepo> git log --graph
* commit 4919b681db93df82ead7ba6190eca6a49a9d82e7
| Author: VonC <[email protected]>
| Date:   Sat Nov 14 13:42:20 2009 +0100
|
|     a second bug10 fix
|
* commit 3469e13f8d0fadeac5fcb6f388aca69497fd08a9
| Author: VonC <[email protected]>
| Date:   Sat Nov 14 13:41:50 2009 +0100
|
|     a first bug10 fix
|

gitk es genial, pero me obliga a abandonar la sesión de shell para otra ventana, mientras que mostrar los últimos n commits rápidamente suele ser suficiente.

Gitg es una gran herramienta para Linux, similar a Gitx para OS X. Simplemente ejecute 'gitg' en la línea de comando desde algún lugar dentro de la estructura de árbol de su repositorio (lo mismo con gitx).

Encontré "git-big-picture" bastante útil: https://github.com/esc/git-big-picture

Crea bonitos gráficos 2D usando dot / graphviz en lugar de las vistas bastante lineales y "unidimensionales" que producen gitk y sus amigos. Con la opción -i, muestra los puntos de bifurcación y las confirmaciones de fusión, pero omite todo lo que está en el medio.

Una buena herramienta basada en la web es ungit . Se ejecuta en cualquier plataforma compatible con node.js & git. Hay un video de cómo funciona para aquellos que encuentran ese tipo de cosas más fácil que leer ...

Echa un vistazo a BranchMaster .

Lo escribí para visualizar una estructura de rama compleja, al contraer todas las confirmaciones entre ellas en una sola línea. Los números indican el número de confirmaciones.

Nadie mencionó tig? No dobla ramas como "BranchMaster", pero ...

Es rápido, se ejecuta en la terminal.

Debido a que es tan rápido (+ control de teclado) obtienes una gran experiencia de usuario, es casi como mi " ls" para directorios que contienen repositorios git.

https://jonas.github.io/tig/

Tiene los atajos habituales, /para buscar, etc.

(ps. es el terminal en el fondo de esta captura de pantalla, se ve mejor hoy en día, pero mi computadora se niega a tomar una captura de pantalla, lo siento)

(pps. Yo también uso gitkraken y tiene visualizaciones muy claras, pero es mucho más pesado que tig)

Tortoise Git tiene una herramienta llamada "Gráfico de revisión". Si estás en Windows es tan fácil como hacer clic derecho en tu repositorio -> Tortoise Git -> Revision Graph.

Risita dibuja gráficos muy bonitos.

Yo uso los siguientes alias.

[alias]
    lol = log --graph --decorate --pretty=oneline --abbrev-commit
    lola = log --graph --decorate --pretty=oneline --abbrev-commit --all

Tiene más información en el esquema de color que los alias que vi arriba. También parece ser bastante común, por lo que puede tener la posibilidad de que exista en el entorno de otros o de que pueda mencionarlo en una conversación sin tener que explicarlo.

Con capturas de pantalla y una descripción completa aquí: http://blog.kfish.org/2010/04/git-lola.html

Para usuarios de Mac, realice el pago (sin juego de palabras) de la herramienta gratuita de código abierto GitUp: http://gitup.co/

Me gusta la forma en que se muestran los gráficos, es más claro que algunas de las otras herramientas que he visto.

El proyecto está aquí: https://github.com/git-up/GitUp

Tengo este git logalias ~/.gitconfigpara ver el historial del gráfico:

[alias]
l = log --all --graph --pretty=format:'%C(auto)%h%C(auto)%d %s %C(dim white)(%aN, %ar)'

Con el alias en su lugar, git lmostrará algo como esto:

En Git 2.12 + incluso puedes personalizar los colores de línea del gráfico usando la log.graphColorsopción de configuración.

En cuanto al formato de los registros, es similar --oneline, con la adición del nombre del autor (respetando .mailmap) y la fecha relativa del autor . Tenga en cuenta que la %C(auto)sintaxis, que le dice a Git que use los colores predeterminados para commit hash, etc., es compatible con Git> = 1.8.3 .

Encontré esta publicación de blog que muestra una manera concisa:

git log --oneline --abbrev-commit --all --graph --decorate --color

Por lo general, creo un alias para el comando anterior:

alias gl='git log --oneline --abbrev-commit --all --graph --decorate --color'

y simple solo uso gl.

También puede agregar el alias a la configuración de git. Abra ~/.gitconfigy agregue la siguiente línea al [alias]

[alias]
        lg = log --oneline --abbrev-commit --all --graph --decorate --color

y úsalo así: git lg

Mi alias favorito personal, a través de .gitconfig, es:

graph = log --graph --color --all --pretty=format:"%C(yellow)%H%C(green)%d%C(reset)%n%x20%cd%n%x20%cn%x20(%ce)%n%x20%s%n"

Para aquellos que usan el editor de texto VSCode , considere la extensión Git History Extension de D. Jayamanne:

Gitx también es una herramienta de visualización fantástica si estás en OS X.

Otro comando de registro de git. Este con columnas de ancho fijo :

git log --graph --pretty=format:"%x09%h | %<(10,trunc)%cd |%<(25,trunc)%d | %s" --date=short

Echa un vistazo SmartGit. Me recuerda mucho a la visualización de la rama TortoiseHg y es gratis para uso no comercial.

En Windows hay una herramienta muy útil que puedes usar: extensiones git. Es una herramienta gui y hace que las operaciones de git sean muy fáciles.

También es de código abierto.

http://gitextensions.github.io

Lo intenté --simplify-by-decorationpero no se muestran todas mis fusiones. Por lo tanto, simplemente elimino las líneas sin símbolos "\" y "/" en los encabezados, mientras que siempre mantengo líneas con "(" que indican ramas inmediatamente después de eso. Cuando se muestra el historial de ramas, en general no me interesan los comentarios de confirmación, así que También los elimino y termino con el siguiente alias de shell.

gbh () { 
    git log --graph --oneline --decorate "$@" | grep '^[^0-9a-f]*[\\/][^0-9a-f]*\( [0-9a-f]\|$\)\|^[^0-9a-f]*[0-9a-f]*\ (' | sed -e 's/).*/)/'
}

¿podemos hacerlo más complicado?

¿Qué tal un simple registro de git?

El sitio oficial de Git alistó algunas herramientas GUI específicas de la plataforma de terceros. Pulse aquí Herramientas GUI de git para la plataforma Linux

He usado gitgy GitKrakenpara la plataforma Linux. Ambos son buenos para entender el árbol de confirmación