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

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'

o bé

$ git switch hola
Switched to branch 'hola'

Tip

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

$ git switch -c hola
Switched to a new branch 'hola'

o bé

$ 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 de95ae9] 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 274df42] hola usa la clase HolaMundo
 1 file changed, 3 insertions(+), 1 deletion(-)

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

$ git checkout master
Switched to branch 'master'
$ git switch hola
Switched to branch 'hola'

Modificaciones en la rama master

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

$ git switch master
Switched to branch 'master'

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 introduccion 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"
[master 2890ec2] Añadido README.md
 1 file changed, 3 insertions(+)
 create mode 100644 README.md
$ git log --all --oneline --graph
* 2890ec2 (HEAD -> master) Añadido README.md
| * 274df42 (hola) hola usa la clase HolaMundo
| * de95ae9 Añadida la clase HolaMundo
|/
* b8a3e7f Movido hola.php a lib.
* ddcd445 Añadido el autor del programa y su email
* 4ccf057 (tag: v1) Se añade un comentario al cambio del valor por defecto
* 88d1eff (tag: v1-beta) Se añade un parámetro por defecto
* d13ad44 Parametrización del programa
* 18a30f9 Creación del proyecto

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

Windows

En windows no podem obtenir el hist ja que no ens ha anat mai bé però tenim l'eina Git GUI amb la que podem obrir el repositori que vulguem i obtenir una imatge semblant. També tenim la opció del log --graph que podem combinar amb --oneline i amb --all per obtenir un resultat semblant, tal i com hem fet a l'exemple.

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 switch hola
Switched to branch 'hola'
$ git merge master
Merge made by the 'recursive' strategy.
 README.md | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 README.md
$ git log --all --oneline --graph
*   53c7abb (HEAD -> hola) Merge branch 'master' into hola
|\
| * 2890ec2 (master) Añadido README.md
* | 274df42 hola usa la clase HolaMundo
* | de95ae9 Añadida la clase HolaMundo
|/
* b8a3e7f Movido hola.php a lib.
* ddcd445 Añadido el autor del programa y su email
* 4ccf057 (tag: v1) Se añade un comentario al cambio del valor por defecto
* 88d1eff (tag: v1-beta) Se añade un parámetro por defecto
* d13ad44 Parametrización del programa
* 18a30f9 Creación del proyecto

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 master para crear uno con la rama hola.

$ git checkout master
Switched to branch 'master'

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"
[master 3ffa6cd] Programa interactivo
 1 file changed, 3 insertions(+), 3 deletions(-)
$ git log --all --oneline --graph
* 3ffa6cd (HEAD -> master) Programa interactivo
| *   53c7abb (hola) Merge branch 'master' into hola
| |\
| |/
|/|
* | 2890ec2 Añadido README.md
| * 274df42 hola usa la clase HolaMundo
| * de95ae9 Añadida la clase HolaMundo
|/
* b8a3e7f Movido hola.php a lib.
* ddcd445 Añadido el autor del programa y su email
* 4ccf057 (tag: v1) Se añade un comentario al cambio del valor por defecto
* 88d1eff (tag: v1-beta) Se añade un parámetro por defecto
* d13ad44 Parametrización del programa
* 18a30f9 Creación del proyecto

Volvemos a la rama hola y fusionamos:

$ git checkout hola
Switched to branch 'hola'
$ git merge master
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";
>>>>>>> master

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 master"
[hola 031f996] Solucionado el conflicto al fusionar con la rama master

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". (En el nostre cas 274df42)

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

$ git checkout hola
Switched to branch 'hola'
$ git log --all --oneline --graph
*   031f996 (HEAD -> hola) Solucionado el conflicto al fusionar con la rama master
|\
| * 3ffa6cd (master) Programa interactivo
* | 53c7abb Merge branch 'master' into hola
|\|
| * 2890ec2 Añadido README.md
* | 274df42 hola usa la clase HolaMundo
* | de95ae9 Añadida la clase HolaMundo
|/
* b8a3e7f Movido hola.php a lib.
* ddcd445 Añadido el autor del programa y su email
* 4ccf057 (tag: v1) Se añade un comentario al cambio del valor por defecto
* 88d1eff (tag: v1-beta) Se añade un parámetro por defecto
* d13ad44 Parametrización del programa
* 18a30f9 Creación del proyecto
$ git reset --hard 274df42
HEAD is now at 274df42 hola usa la clase HolaMundo

Y nuestro estado será:

$ git log --all --oneline --graph
* 3ffa6cd (master) Programa interactivo
* 2890ec2 Añadido README.md
| * 274df42 (HEAD -> hola) hola usa la clase HolaMundo
| * de95ae9 Añadida la clase HolaMundo
|/
* b8a3e7f Movido hola.php a lib.
* ddcd445 Añadido el autor del programa y su email
* 4ccf057 (tag: v1) Se añade un comentario al cambio del valor por defecto
* 88d1eff (tag: v1-beta) Se añade un parámetro por defecto
* d13ad44 Parametrización del programa
* 18a30f9 Creación del proyecto

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 master
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 (master) [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]

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 master

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 master
Switched to branch 'master'
$ 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 -> master, 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 master 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 (master) [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 -> master) [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 (master) [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]

En la siguiente imagen se puede ver la diferencia: