Ramas¶

Administración de ramas¶

Crear una nueva rama¶

Cuando vamos a trabajar en una nueva funcionalidad, es conveniente hacerlo en una nueva rama, para no modificar la rama principal y dejarla inestable. Aunque la orden para manejar ramas es git branch podemos usar también git checkout.

Vamos a crear una nueva rama:

git branch hola

gitGraph:
   commit id: "e19f2c1"
   commit id: "efc252e"
   commit id: "3283e0d" tag: "v1-beta"
   commit id: "fd4da94" tag: "v1"
   commit id: "96a39df"
   commit id: "8c2a509"
   branch hola

Info

Si usamos git branch sin ningún argumento, nos devolverá la lista de ramas disponibles.

La orden anterior no devuelve ningún resultado y tampoco nos cambia de rama, para eso debemos usar checkout:

$ git checkout hola
Switched to branch 'hola'

Tip

Hay una forma más rapida de hacer ambas acciones en un solo paso. Con el parámetro -b de git checkout podemos cambiarnos a una rama que, si no existe, se crea instantáneamente.

$ git checkout -b hola
Switched to a new branch 'hola'

Modificaciones en la rama secundaria¶

Añadimos un nuevo archivo en el directorio lib llamado HolaMundo.php:

<?php

class HolaMundo
{
   private $nombre;

   function __construct($nombre)
   {
      $this->nombre = $nombre;
   }

   function __toString()
   {
      return sprintf ("Hola, %s.\n", $this->nombre);
   }
}

Y modificamos hola.php:

<?php
// Autor: Sergio Gómez <sergio@uco.es>
// El nombre por defecto es Mundo
require('HolaMundo.php');

$nombre = isset($argv[1]) ? $argv[1] : "Mundo";
print new HolaMundo($nombre);

Podríamos confirmar los cambios todos de golpe, pero lo haremos de uno en uno, con su comentario.

$ git add lib/HolaMundo.php
$ git commit -m "Añadida la clase HolaMundo"
[hola 6932156] Añadida la clase HolaMundo
 1 file changed, 16 insertions(+)
 create mode 100644 lib/HolaMundo.php
$ git add lib/hola.php
$ git commit -m "hola usa la clase HolaMundo"
[hola 9862f33] hola usa la clase HolaMundo
 1 file changed, 3 insertions(+), 1 deletion(-)

gitGraph:
   commit id: "e19f2c1"
   commit id: "efc252e"
   commit id: "3283e0d" tag: "v1-beta"
   commit id: "fd4da94" tag: "v1"
   commit id: "96a39df"
   commit id: "8c2a509"
   branch hola
   commit id: "6932156"
   commit id: "9862f33"

Y ahora con la orden git checkout podemos movernos entre ramas:

$ git checkout main
Switched to branch 'main'
$ git checkout hola
Switched to branch 'hola'

Modificaciones en la rama main¶

Podemos volver y añadir un nuevo archivo a la rama principal:

$ git checkout main
Switched to branch 'main'

Creamos un archivo llamado README.md en la raíz de nuestro proyecto con el siguiente contenido:

# Curso de GIT

Este proyecto contiene el curso de introducción a GIT

Y lo añadimos a nuestro repositorio en la rama en la que estamos:

$ git add README.md
$ git commit -m "Añadido README.md"
[main c3e65d0] Añadido README.md
 1 file changed, 3 insertions(+)
 create mode 100644 README.md
$ git hist --all
* c3e65d0 2013-06-16 | Añadido README.md (HEAD, main) [Sergio Gómez]
| * 9862f33 2013-06-16 | hola usa la clase HolaMundo (hola) [Sergio Gómez]
| * 6932156 2013-06-16 | Añadida la clase HolaMundo [Sergio Gómez]
|/
* 81c6e93 2013-06-16 | Movido hola.php a lib [Sergio Gómez]
* 96a39df 2013-06-16 | Añadido el autor del programa y su email [Sergio Gómez]
* fd4da94 2013-06-16 | Se añade un comentario al cambio del valor por defecto (tag: v1) [Sergio Gómez]
* 3283e0d 2013-06-16 | Se añade un parámetro por defecto (tag: v1-beta) [Sergio Gómez]
* efc252e 2013-06-16 | Parametrización del programa [Sergio Gómez]
* e19f2c1 2013-06-16 | Creación del proyecto [Sergio Gómez]

Y vemos como git hist muestra la bifurcación en nuestro código.

gitGraph:
   commit id: "e19f2c1"
   commit id: "efc252e"
   commit id: "3283e0d" tag: "v1-beta"
   commit id: "fd4da94" tag: "v1"
   commit id: "96a39df"
   commit id: "8c2a509"
   branch hola
   commit id: "6932156"
   commit id: "9862f33"
   checkout main
   commit id: "c3e65d0"

Fusión de ramas y resolución de conflictos¶

Mezclar ramas¶

Podemos incorporar los cambios de una rama a otra con la orden git merge

$ git checkout hola
Switched to branch 'hola'
$ git merge main
Merge made by the 'recursive' strategy.
 README.md | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 README.md
$ git hist --all
*   9c6ac06 2013-06-16 | Merge commit 'c3e65d0' into hola (HEAD, hola) [Sergio Gómez]
|\
* | 9862f33 2013-06-16 | hola usa la clase HolaMundo [Sergio Gómez]
* | 6932156 2013-06-16 | Añadida la clase HolaMundo [Sergio Gómez]
| |
| * c3e65d0 2013-06-16 | Añadido README.md [Sergio Gómez]
|/
* 81c6e93 2013-06-16 | Movido hola.php a lib [Sergio Gómez]
* 96a39df 2013-06-16 | Añadido el autor del programa y su email [Sergio Gómez]
* fd4da94 2013-06-16 | Se añade un comentario al cambio del valor por defecto (tag: v1) [Sergio Gómez]
* 3283e0d 2013-06-16 | Se añade un parámetro por defecto (tag: v1-beta) [Sergio Gómez]
* efc252e 2013-06-16 | Parametrización del programa [Sergio Gómez]
* e19f2c1 2013-06-16 | Creación del proyecto [Sergio Gómez]

gitGraph:
   commit id: "e19f2c1"
   commit id: "efc252e"
   commit id: "3283e0d" tag: "v1-beta"
   commit id: "fd4da94" tag: "v1"
   commit id: "96a39df"
   commit id: "8c2a509"
   branch hola
   commit id: "6932156"
   commit id: "9862f33"
   checkout main
   commit id: "c3e65d0"
   checkout hola
   merge main id: "9c6ac06"

De esa forma se puede trabajar en una rama secundaria incorporando los cambios de la rama principal o de otra rama.

Resolver conflictos¶

Un conflicto es cuando se produce una fusión que Git no es capaz de resolver. Vamos a modificar la rama main para crear uno con la rama hola.

$ git checkout main
Switched to branch 'main'

Modificamos nuestro archivo hola.php de nuevo:

<?php
// Autor: Sergio Gómez <sergio@uco.es>
print "Introduce tu nombre:";
$nombre = trim(fgets(STDIN));
@print "Hola, {$nombre}\n";

Y guardamos los cambios:

$ git add lib/hola.php
$ git commit -m "Programa interactivo"
[main 9c85275] Programa interactivo
 1 file changed, 2 insertions(+), 2 deletions(-)
$ git hist --all
*   9c6ac06 2013-06-16 | Merge commit 'c3e65d0' into hola (hola) [Sergio Gómez]
|\
* | 9862f33 2013-06-16 | hola usa la clase HolaMundo [Sergio Gómez]
* | 6932156 2013-06-16 | Añadida la clase HolaMundo [Sergio Gómez]
| | * 9c85275 2013-06-16 | Programa interactivo (HEAD, main) [Sergio Gómez]
| |/
| * c3e65d0 2013-06-16 | Añadido README.md [Sergio Gómez]
|/
* 81c6e93 2013-06-16 | Movido hola.php a lib [Sergio Gómez]
* 96a39df 2013-06-16 | Añadido el autor del programa y su email [Sergio Gómez]
* fd4da94 2013-06-16 | Se añade un comentario al cambio del valor por defecto (tag: v1) [Sergio Gómez]
* 3283e0d 2013-06-16 | Se añade un parámetro por defecto (tag: v1-beta) [Sergio Gómez]
* efc252e 2013-06-16 | Parametrización del programa [Sergio Gómez]
* e19f2c1 2013-06-16 | Creación del proyecto [Sergio Gómez]

gitGraph:
   commit id: "e19f2c1"
   commit id: "efc252e"
   commit id: "3283e0d" tag: "v1-beta"
   commit id: "fd4da94" tag: "v1"
   commit id: "96a39df"
   commit id: "8c2a509"
   branch hola
   commit id: "6932156"
   commit id: "9862f33"
   checkout main
   commit id: "c3e65d0"
   checkout hola
   merge main id: "9c6ac06"
   checkout main
   commit id: "9c85275"

Volvemos a la rama hola y fusionamos:

$ git checkout hola
Switched to branch 'hola'
$ git merge main
Auto-merging lib/hola.php
CONFLICT (content): Merge conflict in lib/hola.php
Automatic merge failed; fix conflicts and then commit the result.

Si editamos nuestro archivo lib/hola.php obtendremos algo similar a esto:

<?php
// Autor: Sergio Gómez <sergio@uco.es>
<<<<<<< HEAD
// El nombre por defecto es Mundo
require('HolaMundo.php');

$nombre = isset($argv[1]) ? $argv[1] : "Mundo";
print new HolaMundo($nombre);
=======
print "Introduce tu nombre:";
$nombre = trim(fgets(STDIN));
@print "Hola, {$nombre}\n";
>>>>>>> main

La primera parte marca el código que estaba en la rama donde trabajábamos (HEAD) y la parte final el código de donde fusionábamos. Resolvemos el conflicto, dejando el archivo como sigue:

<?php
// Autor: Sergio Gómez <sergio@uco.es>
require('HolaMundo.php');

print "Introduce tu nombre:";
$nombre = trim(fgets(STDIN));
print new HolaMundo($nombre);

Y resolvemos el conflicto confirmando los cambios:

$ git add lib/hola.php
$ git commit -m "Solucionado el conflicto al fusionar con la rama main"
[hola a36af04] Solucionado el conflicto al fusionar con la rama main

gitGraph:
   commit id: "e19f2c1"
   commit id: "efc252e"
   commit id: "3283e0d" tag: "v1-beta"
   commit id: "fd4da94" tag: "v1"
   commit id: "96a39df"
   commit id: "8c2a509"
   branch hola
   commit id: "6932156"
   commit id: "9862f33"
   checkout main
   commit id: "c3e65d0"
   checkout hola
   merge main id: "9c6ac06"
   checkout main
   commit id: "9c85275"
   checkout hola
   merge main id: "a36af04"

Rebasing vs Merging¶

Rebasing es otra técnica para fusionar distinta a merge y usa la orden git rebase. Vamos a dejar nuestro proyecto como estaba antes del fusionado. Para ello necesitamos anotar el hash anterior al de la acción de merge. El que tiene la anotación "hola usa la clase HolaMundo".

Para ello podemos usar la orden git reset que nos permite mover HEAD donde queramos.

$ git checkout hola
Switched to branch 'hola'
$ git hist
*   a36af04 2013-06-16 | Solucionado el conflicto al fusionar con la rama main (HEAD, hola) [Sergio Gómez]
|\
| * 9c85275 2013-06-16 | Programa interactivo (main) [Sergio Gómez]
* |   9c6ac06 2013-06-16 | Merge commit 'c3e65d0' into hola [Sergio Gómez]
|\ \
| |/
| * c3e65d0 2013-06-16 | Añadido README.md [Sergio Gómez]
* | 9862f33 2013-06-16 | hola usa la clase HolaMundo [Sergio Gómez]
* | 6932156 2013-06-16 | Añadida la clase HolaMundo [Sergio Gómez]
|/
* 81c6e93 2013-06-16 | Movido hola.php a lib [Sergio Gómez]
* 96a39df 2013-06-16 | Añadido el autor del programa y su email [Sergio Gómez]
* fd4da94 2013-06-16 | Se añade un comentario al cambio del valor por defecto (tag: v1) [Sergio Gómez]
* 3283e0d 2013-06-16 | Se añade un parámetro por defecto (tag: v1-beta) [Sergio Gómez]
* efc252e 2013-06-16 | Parametrización del programa [Sergio Gómez]
* e19f2c1 2013-06-16 | Creación del proyecto [Sergio Gómez]
$ git reset --hard 9862f33
HEAD is now at 9862f33 hola usa la clase HolaMundo

Y nuestro estado será:

$ git hist --all
* 9862f33 2013-06-16 | hola usa la clase HolaMundo (HEAD, hola) [Sergio Gómez]
* 6932156 2013-06-16 | Añadida la clase HolaMundo [Sergio Gómez]
| * 9c85275 2013-06-16 | Programa interactivo (main) [Sergio Gómez]
| * c3e65d0 2013-06-16 | Añadido README.md [Sergio Gómez]
|/
* 81c6e93 2013-06-16 | Movido hola.php a lib [Sergio Gómez]
* 96a39df 2013-06-16 | Añadido el autor del programa y su email [Sergio Gómez]
* fd4da94 2013-06-16 | Se añade un comentario al cambio del valor por defecto (tag: v1) [Sergio Gómez]
* 3283e0d 2013-06-16 | Se añade un parámetro por defecto (tag: v1-beta) [Sergio Gómez]
* efc252e 2013-06-16 | Parametrización del programa [Sergio Gómez]
* e19f2c1 2013-06-16 | Creación del proyecto [Sergio Gómez]

gitGraph:
   commit id: "e19f2c1"
   commit id: "efc252e"
   commit id: "3283e0d" tag: "v1-beta"
   commit id: "fd4da94" tag: "v1"
   commit id: "96a39df"
   commit id: "8c2a509"
   branch hola
   commit id: "6932156"
   commit id: "9862f33"
   checkout main
   commit id: "c3e65d0"
   commit id: "9c85275"

Hemos desecho todos los merge y nuestro árbol está "limpio". Vamos a probar ahora a hacer un rebase. Continuamos en la rama hola y ejecutamos lo siguiente:

$ git rebase main
First, rewinding head to replay your work on top of it...
Applying: Añadida la clase HolaMundo
Applying: hola usa la clase HolaMundo
Using index info to reconstruct a base tree...
M   lib/hola.php
Falling back to patching base and 3-way merge...
Auto-merging lib/hola.php
CONFLICT (content): Merge conflict in lib/hola.php
error: Failed to merge in the changes.
Patch failed at 0002 hola usa la clase HolaMundo
The copy of the patch that failed is found in: .git/rebase-apply/patch

When you have resolved this problem, run "git rebase --continue".
If you prefer to skip this patch, run "git rebase --skip" instead.
To check out the original branch and stop rebasing, run "git rebase --abort".

El conflicto, por supuesto, se sigue dando. Resolvemos guardando el archivo hola.php como en los casos anteriores:

<?php
// Autor: Sergio Gómez <sergio@uco.es>
require('HolaMundo.php');

print "Introduce tu nombre:";
$nombre = trim(fgets(STDIN));
print new HolaMundo($nombre);

Añadimos los cambios en staging y en esta ocasión, y tal como nos indicaba en el mensaje anterior, no tenemos que hacer git commit sino continuar con el rebase:

$ git add lib/hola.php
$ git status
rebase in progress; onto 269eaca
You are currently rebasing branch 'hola' on '269eaca'.
  (all conflicts fixed: run "git rebase --continue")

Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)

    modified:   lib/hola.php
$ git rebase --continue
Applying: hola usa la clase HolaMundo

Y ahora vemos que nuestro árbol tiene un aspecto distinto, mucho más limpio:

$ git hist --all
* 9862f33 2013-06-16 | hola usa la clase HolaMundo (HEAD -> hola) [Sergio Gómez]
* 6932156 2013-06-16 | Añadida la clase HolaMundo [Sergio Gómez]
* 9c85275 2013-06-16 | Programa interactivo (main) [Sergio Gómez]
* c3e65d0 2013-06-16 | Añadido README.md [Sergio Gómez]
* 81c6e93 2013-06-16 | Movido hola.php a lib [Sergio Gómez]
* 96a39df 2013-06-16 | Añadido el autor del programa y su email [Sergio Gómez]
* fd4da94 2013-06-16 | Se añade un comentario al cambio del valor por defecto (tag: v1) [Sergio Gómez]
* 3283e0d 2013-06-16 | Se añade un parámetro por defecto (tag: v1-beta) [Sergio Gómez]
* efc252e 2013-06-16 | Parametrización del programa [Sergio Gómez]
* e19f2c1 2013-06-16 | Creación del proyecto [Sergio Gómez]

gitGraph:
   commit id: "e19f2c1"
   commit id: "efc252e"
   commit id: "3283e0d" tag: "v1-beta"
   commit id: "fd4da94" tag: "v1"
   commit id: "96a39df"
   commit id: "8c2a509"
   commit id: "c3e65d0"
   commit id: "9c85275"
   branch hola
   commit id: "6932156"
   commit id: "9862f33"

Lo que hace rebase es volver a aplicar todos los cambios a la rama máster, desde su nodo más reciente. Eso significa que se modifica el orden o la historia de creación de los cambios. Por eso rebase no debe usarse si el orden es importante o si la rama es compartida.

Mezclando con la rama main¶

Ya hemos terminado de implementar los cambios en nuestra rama secundaria y es hora de llevar los cambios a la rama principal. Usamos git merge para hacer una fusión normal:

$ git checkout main
Switched to branch 'main'
$ git merge hola
Updating c3e65d0..491f1d2
Fast-forward
 lib/HolaMundo.php | 16 ++++++++++++++++
 lib/hola.php      |  4 +++-
 2 files changed, 19 insertions(+), 1 deletion(-)
 create mode 100644 lib/HolaMundo.php
 $ git hist --all
 * 9862f33 2013-06-16 | hola usa la clase HolaMundo (HEAD -> main, hola) [Sergio Gómez]
 * 6932156 2013-06-16 | Añadida la clase HolaMundo [Sergio Gómez]
 * 9c85275 2013-06-16 | Programa interactivo [Sergio Gómez]
 * c3e65d0 2013-06-16 | Añadido README.md [Sergio Gómez]
 * 81c6e93 2013-06-16 | Movido hola.php a lib [Sergio Gómez]
 * 96a39df 2013-06-16 | Añadido el autor del programa y su email [Sergio Gómez]
 * fd4da94 2013-06-16 | Se añade un comentario al cambio del valor por defecto (tag: v1) [Sergio Gómez]
 * 3283e0d 2013-06-16 | Se añade un parámetro por defecto (tag: v1-beta) [Sergio Gómez]
 * efc252e 2013-06-16 | Parametrización del programa [Sergio Gómez]
 * e19f2c1 2013-06-16 | Creación del proyecto [Sergio Gómez]

Vemos que indica que el tipo de fusión es fast-forward. Este tipo de fusión tiene el problema que no deja rastro de la fusión, por eso suele ser recomendable usar el parámetro --no-ff para que quede constancia siempre de que se ha fusionado una rama con otra.

Vamos a volver a probar ahora sin hacer fast-forward. Reseteamos main al estado "Programa interactivo".

$ git reset --hard 9c85275
$ git hist --all
* 9862f33 2013-06-16 | hola usa la clase HolaMundo (HEAD -> hola) [Sergio Gómez]
* 6932156 2013-06-16 | Añadida la clase HolaMundo [Sergio Gómez]
* 9c85275 2013-06-16 | Programa interactivo (main) [Sergio Gómez]
* c3e65d0 2013-06-16 | Añadido README.md [Sergio Gómez]
* 81c6e93 2013-06-16 | Movido hola.php a lib [Sergio Gómez]
* 96a39df 2013-06-16 | Añadido el autor del programa y su email [Sergio Gómez]
* fd4da94 2013-06-16 | Se añade un comentario al cambio del valor por defecto (tag: v1) [Sergio Gómez]
* 3283e0d 2013-06-16 | Se añade un parámetro por defecto (tag: v1-beta) [Sergio Gómez]
* efc252e 2013-06-16 | Parametrización del programa [Sergio Gómez]
* e19f2c1 2013-06-16 | Creación del proyecto [Sergio Gómez]

Vemos que estamos como en el final de la sección anterior, así que ahora mezclamos:

$ git merge -m "Aplicando los cambios de la rama hola" --no-ff hola
Merge made by the 'recursive' strategy.
 lib/HolaMundo.php | 16 ++++++++++++++++
 lib/hola.php      |  4 +++-
 2 files changed, 19 insertions(+), 1 deletion(-)
 create mode 100644 lib/HolaMundo.php
$ git hist --all
*   2eab8ca 2013-06-16 | Aplicando los cambios de la rama hola (HEAD -> main) [Sergio Gomez]
*\
| * 9862f33 2013-06-16 | hola usa la clase HolaMundo (hola) [Sergio Gómez]
| * 6932156 2013-06-16 | Añadida la clase HolaMundo [Sergio Gómez]
|/
* 9c85275 2013-06-16 | Programa interactivo (main) [Sergio Gómez]
* c3e65d0 2013-06-16 | Añadido README.md [Sergio Gómez]
* 81c6e93 2013-06-16 | Movido hola.php a lib [Sergio Gómez]
* 96a39df 2013-06-16 | Añadido el autor del programa y su email [Sergio Gómez]
* fd4da94 2013-06-16 | Se añade un comentario al cambio del valor por defecto (tag: v1) [Sergio Gómez]
* 3283e0d 2013-06-16 | Se añade un parámetro por defecto (tag: v1-beta) [Sergio Gómez]
* efc252e 2013-06-16 | Parametrización del programa [Sergio Gómez]
* e19f2c1 2013-06-16 | Creación del proyecto [Sergio Gómez]

gitGraph:
   commit id: "e19f2c1"
   commit id: "efc252e"
   commit id: "3283e0d" tag: "v1-beta"
   commit id: "fd4da94" tag: "v1"
   commit id: "96a39df"
   commit id: "8c2a509"
   commit id: "c3e65d0"
   commit id: "9c85275"
   branch hola
   commit id: "6932156"
   commit id: "9862f33"
   checkout main
   merge hola id: "2eab8ca"

En la siguiente imagen se puede ver la diferencia:

Diferencias entre tipos de fusión