Te presentamos cómo Git Bisect ayuda a la depuración, que es una herramienta muy buena para que la depuración sea muy fácil. Sin embargo, pocas personas lo usan activamente.

Depuración Delta

La depuración de Delta es el proceso de completar múltiples pasos de depuración y en cada uno de estos, el objetivo es eliminar la mitad del «problema». Se puede considerar como una búsqueda binaria de depuración. O como se indica desde su terminología:

Delta Debugging automatiza el método científico de depuración. La idea básica del método científico es establecer una hipótesis sobre por qué algo no funciona. Se debe de realizar una prueba de esta hipótesis y refinarla o rechazarla según el resultado de la prueba. Al depurar, la gente hace esto a mano. Delta Debugging automatiza este proceso.

Git bisect es la forma de cómo aplicamos la depuración delta con Git.

Supongamos que tenemos un error e intentamos encontrar la causa raíz. En cada paso de nuestra investigación para encontrar una solución, eliminamos la mitad del espacio de la solución. Configuración, código, entrada … entre otras cosas. Aquí un ejemplo para hacerlo más claro.

Ejemplo de git bisect

Primero, necesitamos iniciar con un repositorio para rastrear nuestro trabajo.

mkdir test_git_bisect && cd test_git_bisect && git init

Vamos a hacer un script que tenga una época y lo convierta a

Datetime

Para hacerlo, aplicamos el uso de un archivo de entrada (llamado epochs.txt) que solo tenga épocas.

Para ejecutar un git bisect sin problemas, necesitamos tener bastantes commits.

El script de Python parse_epochs.pyque usaremos aquí no tiene nada de extraordinario.

Esto se enfoca en las épocas desde el momento en que comenzamos el script (más 3 segundos) hasta cinco minutos más tarde, con un paso de 3 segundos.

Nuevamente aplicaremos el cambio:

git add . && git commit -m «Generated the first version of input»

Ahora ejecutaremos el script inicial, obteniendo todas las entradas analizadas por fechas:

Ahora es importante modificar la entrada ahora para que sea defectuosa:

echo «random string» >> epochs.txt

y cometer de nuevo:

git add . && git commit -m «Added faulty input»

A fin de alinearse a la entropía y para hacer el ejemplo más complejo, se debe agregar entradas más defectuosas: commits.

Aquí el registro de confirmación que hasta ahora hemos creado:

Si ejecutamos el script nuevamente, lógicamente fallará con el siguiente error:

Todo indica que necesitaremos git bisect para arreglar esto. Para hacerlo, debemos comenzar la investigación:

git bisect start

Ahora hay que marcar una confirmación como mala (generalmente la última) y una confirmación como buena. Esta sería la segunda confirmación cuando generamos la entrada:

git bisect bad b811d35 && git bisect good d02eae8

Después de eso, git bisect dividirá la historia entre el buen y el mal compromiso en dos. Puedes ver eso aplicando git bisect visualize para ver los commits que se consideran los culpables, y

git show

Para imprimir el que está actualmente desprotegido, en nuestro caso sería:

dbf75cd

Si ejecutamos el script, seguirá fallando. Entonces deberemos marcar el commit actual como malo:

git bisect bad dbf75cd

Vale la pena mencionar la salida de Git en ese caso:

Git registrará nuestros avances, casi llegamos.

Si ejecutamos el script nuevamente, obviamente fallará. Y si lo marcamos como malo, Git dirá:

Para entonces, se puede corregir el error o contactar a quien haya cometido el código / entrada / configuración incorrecta. Aquí mostraremos cómo obtener los detalles: