Solicitud de incorporación de datos de Git Fetch: competencia desbloqueada

Hoy en día, aplicar una corrección a un proyecto es tan fácil como crear una bifurcación, que genera una copia remota completa del proyecto para que realices modificaciones, seleccionando el archivo que quieres cambiar, pulsando Editar y confirmando las correcciones.

¿Pero qué pasa si estás en el extremo receptor de una solicitud de incorporación de cambios (abreviada como RP en el siguiente ejemplo)? Usar una interfaz de usuario web sofisticada es genial y, a menudo, eso es todo lo que necesitas. Basta con hacer clic en un botón para Aprobar, hacer clic en un botón para Fusionar y listo.

¡Pero no siempre es así! Es común tener que descargar los cambios incluidos en una solicitud de incorporación de cambios (PR) localmente, ejecutar algunas pruebas y ver qué aspecto tienen en tu IDE para entender lo que se ha hecho.

Los pasos para descargar (más explícitamente fetch y checkout) las solicitudes de incorporación de cambios de tu compañero o colaborador son conceptualmente sencillos, y aún son más fáciles si conoces un par de detalles y consejos importantes.

Así que déjame guiarte para que entiendas mejor las facilidades de la línea de comandos que git te proporciona para que gestiones las solicitudes de incorporación de cambios con soltura.

Antes de empezar: mejora el símbolo del shell con el nombre y el estado de la rama

Siempre me sorprende la cantidad de personas que tienen un símbolo del sistema vacío que no muestra la rama git en la que se encuentran o si tienen archivos modificados o sin confirmar en su directorio de trabajo. Si has pensado "¡Yo soy uno de esos!", déjame que te ayude. ¡Te quedarás boquiabierto!

Hazte un favor e instala algo tan impresionante como el símbolo líquido, que te proporcionará excelentes anotaciones sobre el estado de tu directorio de trabajo de git (y también admitirá cualquier otro VCS):

(En la captura de pantalla anterior, mi símbolo me alerta de que estoy en la rama newbranch, he añadido 5 líneas a los archivos que rastreo en mi directorio de trabajo y he eliminado 0)

Todo el equipo trabaja en el mismo repositorio

Si trabajas en el mismo repositorio con tu equipo, el proceso de extraer una solicitud de incorporación de cambios es muy sencillo: simplemente ejecuta fetch y checkout para recuperar y extraer la rama desde la que se creó la solicitud:

• Obtén todas las ramas que se publicaron en tu repositorio compartido:

1git fetch origin

• Crea una rama local que haga un seguimiento de la rama remota que te interesa:

1git checkout -b PRJ-1234 origin/PRJ-1234

• Ahora puedes ejecutar diff o merge, o poner a prueba tu corazón con esto:

1git diff main ./run-tests.sh

• Cuando estés satisfecho, vuelve a la interfaz de usuario web y deja tus comentarios o aprueba el cambio directamente.

Colaboradores que trabajan en sus propias bifurcaciones

El proceso cambia un poco cuando algunos de los colaboradores trabajan en bifurcaciones separadas. En este caso, puedes ejecutar fetch para recuperar la rama remota en la que se ha confirmado la contribución o la función:

• Añade primero la rama remota del colaborador:

1git remote add jsmith http://bitbucket.org/jsmith/coolproject.git

• Recopila primero todas las actualizaciones más recientes de origin en tu repositorio principal:

1git checkout main git fetch origin git merge main

• Obtén todas las ramas que se han publicado en la bifurcación del colaborador:

1git fetch jsmith

• Crea una rama local que haga un seguimiento de la rama remota que te interesa:

1git checkout -b jsmith-PRJ-1234 jsmith/PRJ-1234

• Ahora puedes ejecutar diff o merge, o poner a prueba tu corazón con esto:

1git diff main ./run-tests.sh

Reducir el trabajo mediante referencias de solicitud de incorporación de cambios

Aunque lo anterior funciona, hay varias cosas que pueden empeorarlo todo:

• ¿Qué pasa si tienes muchos colaboradores y cada uno de ellos tiene sus propias bifurcaciones? Añadir todas las bifurcaciones y gestionarlas por separado es muy poco práctico.

• ¿Qué pasa si ni siquiera tienes acceso a algunas de las bifurcaciones y no puedes extraer la rama de origen?

La solución a las dos incidencias anteriores es usar referencias de solicitudes de incorporación de cambios que algunos servidores git proporcionan. El procedimiento que mostraré es compatible con algunos servidores git y varía ligeramente según el que utilices. A continuación, explicaré cómo ejecutar fetch para recuperar todas las solicitudes de incorporación de cambios en Stash (ahora llamado "Bitbucket Data Center") y GitHub.

No temas a las referencias de especificaciones

El primer requisito previo es familiarizarse con las referencias de especificaciones. Las referencias de especificaciones son geniales y no deberías temerlas. Consisten en asignaciones simples desde ramas remotas a referencias locales, en otras palabras, una forma sencilla de decirle a git que "esta rama remota (o este conjunto de ramas remotas) debe asignarse a estos nombres localmente en este espacio de nombres".

Por ejemplo, un comando como:

1git fetch +refs/heads/main:refs/remotes/origin/main

Asignará la rama remota main de tu rama remota origin a una rama origin/main local para que puedas escribir:

1git checkout origin/main

Y además hará referencia a esa rama remota. El signo más (+) de la definición indica que queremos que git actualice la referencia incluso si no es de avance rápido.

La forma en que usamos esto para descargar todas las solicitudes de incorporación de cambios consiste en asignar el modo en que el repositorio remoto almacena los HEAD de dichas solicitudes y los asigna a un espacio de nombres local para facilitar su consulta.

Por lo tanto, siempre que tengas un repositorio remoto origin (o upstream) definido, esto es lo que debes hacer.

Nota: Como han señalado con razón varios desarrolladores de Stash (ahora llamado "Bitbucket Data Center"), las referencias que mostraré a continuación se consideranundocumented y private, y podrían cambiar en cualquier momento.

Descargar todas las solicitudes de incorporación de cambios: Stash

• Bifurca un repositorio.

• Clona la bifurcación localmente:

1git clone git@stash.atlassian.com:durdn/tis.git

• Añade el repositorio original upstream como upstream.

1git remote add upstream git@stash.atlassian.com:tpettersen/tis.git

• Obtén los heads más recientes del mantenedor "upstream":

1git fetch upstream

• Añade la refspec (referencia de especificación) que asignará los HEAD de solicitudes de incorporación de cambios a un espacio de nombres pr local. Puedes hacerlo con un comando config:

1git config --add remote.origin.fetch '+refs/pull-requests/*/from:refs/remotes/origin/pr/*'

• Si echas un vistazo a .git/config, las entradas fetch tienen este aspecto:

1[remote "upstream"]
2    url = git@stash.atlassian.com:docker/libswarm.git
3    fetch = +refs/heads/*:refs/remotes/upstream/*
4    fetch = +refs/pull-requests/*/from:refs/remotes/upstream/pr/*

• Ahora puedes ejecutar fetch para recuperar todas las ramas de solicitudes de incorporación de cambios fácilmente:

1$ git fetch upstream
2
3remote: Counting objects: 417, done.
4remote: Compressing objects: 100% (274/274), done.
5remote: Total 417 (delta 226), reused 277 (delta 128)
6Receiving objects: 100% (417/417), 105.28 KiB | 0 bytes/s, done.
7Resolving deltas: 100% (226/226), done.
8
9From stash.atlassian.com:docker/libswarm
10 * [new ref]         refs/pull-requests/10/from-> upstream/pr/10
11 [...]
12 * [new ref]         refs/pull-requests/100/from -> upstream/pr/100
13 * [new ref]         refs/pull-requests/101/from -> upstream/pr/101
14 [...]
15 * [new ref]         refs/pull-requests/109/from -> upstream/pr/109
16 * [new ref]         refs/pull-requests/110/from -> upstream/pr/110
17 [...]

• Ahora, para cambiar a una solicitud de incorporación de cambios concreta, basta con hacer lo siguiente:

1git checkout pr/102

Descargar todas las solicitudes de incorporación de cambios: GitHub

Si las bifurcaciones o los repositorios upstream están en GitHub, funciona exactamente igual que en el ejemplo anterior, pero el comando config cambia a:

1git config --add remote.origin.fetch '+refs/pull//head:refs/remotes/origin/pr/'

Y la rama remota de .git/config cambiará para incluir una configuración de fetch adicional para asignar los HEAD de solicitudes de incorporación de cambios a un espacio de nombres local llamado pr:

1[remote "upstream"] url = git@github.com:docker/libswarm.git fetch = +refs/heads/*:refs/remotes/upstream/* fetch = +refs/pull/*/head:refs/remotes/upstream/pr/*

Obtener una sola solicitud de incorporación de cambios mediante referencias

Si no quieres configurar las entradas de fetch en tu .git/config y solo quieres acceder rápidamente a una solicitud de incorporación de cambios, basta con un solo comando:

• Extrae una sola solicitud de incorporación de cambios en Stash:

1git fetch refs/pull-requests/your-pr-number/from:local-branch-name

• Extrae una sola solicitud de incorporación de cambios en GitHub:

1git fetch refs/pull/your-pr-number/head:local-branch-name

Y si terminas usando mucho lo anterior, puedes agilizar el proceso creando un alias de git:

1# For Stash
2git config alias.spr '!sh -c "git fetch origin pull-requests/${1}/from:pr/${1}" -'
3
4# For Github
5git config alias.gpr '!sh -c "git fetch origin pull/${1}/head:pr/${1}" -'

Con ese alias configurado, se puede recuperar una solicitud de incorporación de cambios (gracias a inuit) con un sencillo:

Conclusión

Controlar el trabajo de tus compañeros o colaboradores es fácil una vez que has creado un par de alias sencillos o has añadido las especificaciones de referencia adecuadas a tu .git/config.