ArnoldRoa.com

En el mundo del desarrollo de software, a veces las cosas van mal. Imagina que un día, después de una serie de cambios en tu proyecto, algo deja de funcionar y no estás seguro de qué cambio específico lo causó. Podrías revisar cada commit manualmente, pero eso sería tedioso y propenso a errores. Personalmente he visto como los desarrolladores invierten una cantidad considerable de tiempo intentando identificar que introdujo un bug cuando hay herramientas que pueden hacer esto mucho mas facil, incluso de manera automatizada (si hay una buena bateria de tests, ya sean unitarios o funcionales). Aquí es donde entra en juego git bisect, una poderosa herramienta de Git que te permite localizar rápidamente el commit exacto que introdujo el error.

Para hacer que esta explicación sea más entretenida, vamos a contar la historia de un detective digital llamado Gitti, quien recibe una misión especial: encontrar al bicho travieso que está causando problemas en su ciudad del código.

La Ciudad del Código y el Bicho Travieso

Había una vez en la Ciudad del Código, un lugar donde todo funcionaba perfectamente gracias a los ciudadanos llamados commits. Cada commit tenía su trabajo especial, ya fuera pintar las casas (interfaz de usuario), mantener las calles limpias (optimización del código) o asegurar que todos los semáforos funcionaran correctamente (pruebas automatizadas).

Un día, un bicho travieso se infiltró en la ciudad. De repente, los semáforos empezaron a fallar y las calles se llenaron de basura. La Alcaldesa Repo, quien dirigía la Ciudad del Código, sabía que había un problema, pero no sabía cuándo o cómo había aparecido el bicho.

Fue entonces cuando llamó a Gitti, el detective digital más astuto de todos.

---

¿Qué es Git Bisect?

En términos técnicos, git bisect es un comando de Git que utiliza la búsqueda binaria para encontrar el commit que introdujo un error. Básicamente, te permite identificar cuál fue el primer commit en el que apareció un problema en tu código, dividiendo la historia de commits en dos partes y probando en qué parte está el error, reduciendo la búsqueda a medida que avanzas.

El proceso es simple:

1. Identificas un commit donde el código estaba funcionando correctamente (el commit “bueno”).
2. Identificas un commit donde el código está roto (el commit “malo”).
3. Git divide el rango de commits entre estos dos puntos y selecciona el commit en el medio para que lo pruebes.
4. Según tu respuesta (si el commit es bueno o malo), Git seleccionará la mitad de los commits restantes y repetirá el proceso hasta encontrar el commit que introdujo el problema.

Iniciando el Rastreo con Gitti

La Alcaldesa Repo le dio a Gitti dos pistas cruciales:

• Primera pista: El commit 1a2b3c (o barrio 1a2b3c), donde todo funcionaba a la perfección.
• Segunda pista: El commit 9z8x7y (o barrio 9z8x7y), donde los problemas comenzaron a surgir.

Gitti, armado con esta información, se dispuso a encontrar el bicho travieso. Comenzó dividiendo la ciudad en dos partes iguales, investigando el barrio en el medio.

Usando Git Bisect en la Terminal

Vamos a ponerlo en práctica. Supongamos que estamos trabajando en un proyecto y encontramos que algo dejó de funcionar después de una serie de commits.

Paso 1: Inicializa Git Bisect

Primero, debemos iniciar el proceso de bisect. Vamos a decirle a Git cuál es el último commit bueno y cuál es el commit donde notamos que algo está mal.

git bisect start
git bisect bad 9z8x7y  # Commit donde se rompió el código
git bisect good 1a2b3c  # Último commit conocido donde todo funcionaba

Aquí, le hemos dicho a Git que el commit 9z8x7y es el malo y el commit 1a2b3c es el bueno.

Paso 2: Prueba los Commits

Git automáticamente seleccionará el commit a mitad de camino entre el bueno y el malo y te pedirá que lo pruebes.

Gitti llega al barrio 5f6d7a, donde sospecha que podría estar el bicho. ¿Funcionan bien los semáforos aquí?

En la terminal, probamos el código:

# Ejecuta las pruebas o verifica manualmente si el error persiste

Si el código funciona bien, le decimos a Git:

git bisect good

Si el código sigue teniendo problemas:

git bisect bad

Paso 3: Itera hasta Encontrar el Problema

Git continuará dividiendo los commits restantes y te pedirá que sigas probando. Cada vez que marcas un commit como bueno o malo, Git ajusta su búsqueda, acotando poco a poco el commit problemático.

Después de varias rondas, Gitti finalmente encuentra el barrio problemático: 8h7g6f. Aquí, descubre que un pequeño y malicioso fragmento de código introdujo al bicho travieso. Ahora, con el bicho encontrado, puede trabajar en erradicarlo y restaurar la paz en la Ciudad del Código.

Paso 4: Finaliza Git Bisect

Una vez que hayas encontrado el commit que introdujo el problema, puedes finalizar el proceso:

git bisect reset

Esto devolverá tu repositorio al estado en que estaba antes de comenzar el bisect.

---

Gitti y el Bicho Travieso

Gitti, nuestro detective digital, al encontrar al bicho travieso en el barrio 8h7g6f, notificó a la Alcaldesa Repo, quien inmediatamente envió a sus mejores programadores a reparar el daño. Los semáforos volvieron a funcionar, las calles se limpiaron, y la Ciudad del Código volvió a ser un lugar feliz y funcional.

La Alcaldesa Repo estaba tan contenta con el trabajo de Gitti que decidió hacer de él su detective permanente. Cada vez que un bicho travieso aparecía en la Ciudad del Código, Gitti estaba allí para encontrarlo y asegurarse de que todo volviera a la normalidad.

Conclusión

Git bisect es como tener un detective digital en tu equipo, listo para investigar y resolver problemas en tu código de manera eficiente. No importa si estás trabajando en un pequeño proyecto personal o en un gran repositorio corporativo, esta herramienta puede ahorrarte horas de trabajo y frustración.

La próxima vez que enfrentes un problema en tu código y no sepas cuándo o cómo apareció, recuerda a Gitti, el detective digital, y deja que git bisect te guíe hacia la solución.