Chuleta de comandos git
git help <command> git clone <uri> namedir # clona usando como nombre de directorio namedir. git add <dir> # aade recursivamente todos los archivos del dir. git diff --staged #compares staged changes with last commit git commit -v # muestra el diff en el editor git commit -a -m #automatically stage tracked files. No hace falta git add git rm --cached <file or regexp> #Git no realiza un seguimiento del archivo, pero los deja en el directorio de trabajo. til cuando se olvida aadir archivos al .gitignore y ya hemos agregado dichos archivos al repositorio. git rm <file> #borrarlos con git siempre. git rm -f <file> # si ya est modificado y en el index. git mv <file> <renamed_file> gitk # tcl/tk. Herramienta grfica para git git commit --amend #Modificar el mensaje del ltimo commit git reset HEAD <file> # to unstage git checkout -- <file> # Descartar cambios en el directorio de trabajo.
AADIR ARCHIVOS
git add -i #interactive staggin git add -p #crea patch
STASH
git stash #guarda el estado en una pila y limpia el directorio para poder cambiar de rama git stash list #muestra la pila
git stash apply # vuelve al estado original del dir. Stash{n} especifica uno concreto Y --index reaplica los cambios stagged git stash pop # elimina el primero en la pila. O drop
LOGS
git log -p -2 # Muestra 2 ltimos commits con diff git log --stat git log --pretty git log --pretty=format:%h - %an, %ar : %s git log --pretty=format;%h %s --graph git log --since=2.weeks git log <branch> --not master #Muestra commit de <branch> sin incluir los de master git log --abbrev-commit --pretty=oneline git diff mastercontrib #Muestra solo el trabajo que la rama contrib actual ha introducido desde su antecesor comn con master git log <branch1>..<branch2> #Commits de branch2 que no estn en branch1 git log origin/master..master #Muestra qu commits se van a enviar al servidor git log origin/master.. #Igual que el anterior. Se asume master o HEAD git log refA refB --not refC # commits en refA y refB que no estn en refC git log masterexperiment #commits de master o experiment, pero sin ser comunes. Con --left-right indica a qu rama pertenece cada uno
REMOTES # repos en internet
git remote -v # lista los repos remotos git remote add [shortname] [url] # crea nuevo remote, es posible descargar el contenido de ese repo con git fetch [shortname]. Master branch en [shortcode]/master git fetch <remote> # descarga trabajo nuevo a mquina local, no sobreescribe nada tuyo. ( git pull s hace merge automaticamente si se esta realizando un seguimiento de esa branch) git push [remote-name] [branch-name] # sii nadie ha hecho push antes git remote show [remote-name] # inspecciona remote. git remote rename <old-name> <new-name> # tambin renombra branches: quedara <new-name>/master git remote rm <remote-name> # p.e si el contribuidor ya no contribuye ms
TAGGING
# marcan puntos importantes en la histtoria del repo ( releases ) git tag # muestra las etiquetas actuales
git tag -l v1.4.2.* # acepta regex Dos tipos de tag:
Lightweight : puntero a commit ( branch que no cambia ) Annotated : se almacenan como objetos en la db, con checksum, nombre del creador, email, fecha, mensaje, posibilidad de firmarla con GPG. ( recomendada )
git tag -a <tagname> -m mensaje # annotated tag git show <tag-name> # muestra informacin asociada. git tag -s <tag-name> -m message # la firma con gpg git tag <tag-name> # lightweight tag git tag -v <tag-name> # verifica tags firmadas git tag -a <tag-name> [commit-chksum] # crea tag para commit con dicho chksum Por defecto no se transfieren los tags, para subirlos al servidor:
git push origin [tag-name] # una sola git push origin --tags # Enviar todas
Para usar GPG y firmar tags, hay que subir la clave pblica al repositorio:
gpg --list-keys #Coges la id pblica gpg -a --export <id> | git hash-object -w --stdin #Copia el SHA-1 devuelto git tag -a maintainer-gpg-pub <SHA-1> git push --tags #Comparte la clave con todos los usuarios git show maintainer-gpg-pub | gpg --import #Cada usuario importa la clave as git show <tag> #Devuelve ms informacin sobre la etiqueta
BRANCH
# las ramas simplememte son punteros a distintos snapshots
git branch <nombre-rama> #crea rama. Puntero al commit actual git checkout <nombre-rama> #cambiar a la rama especificada. git checkout -b <nombre-rama> #crea y cambia de rama git merge <rama> # Mezcla la rama actual con <rama> git branch -d <rama> #elimina la rama git push origin --delete <branchName> # Elimina una rama del servidor git mergetool #Herramienta grfica para resolver conflictos git branch # lista ramas git branch -v # lista ramas mostrando ltimo commit git branch --merged #lista ramas que han sido mezcladas con la actual. Si no tienen un *, pueden borrarse, ya que significa que se han incorporado los cambios en la rama actual. git branch --no-merged #lista ramas que no han sido incorporadas a la actual.
REMOTE BRANCHES
git fetch origin # Descarga el contenido del servidor git push <remote> <branch> #Las ramas no se suben por defecto, has de subirlas explcitamente git push <remote> <branch>:<nuevoNombre> #Igual que la de arriba, pero en el servidor se llama a la rama con nuevoNombre en lugar de branch # Cuando se hace un git fetch que trae consigo nuevas ramas remotas, no se disponen de ellas localmente, solo se dispone de un puntero a la rama remota que no es editable. Para poder trabajar sobre esa rama, es necesario crearla Por ejemplo: o git fetch origin # Tras ejecutarlo, notamos que se ha creado una rama nueva (rama_nueva) o git checkout -b rama_nueva origin/rama_nueva # Crea una rama local a partir de la remota o git merge origin/nueva_rama # Equivalente a la de arriba, pero sin establecer el tracking a la rama git push [remotename] :[branch] # elimina una rama remota git push [remotename] [localbranch]:[remotebranch] #La rama en el servidor tiene distinto nombre a la local
TRACKING BRANCHES
git checkout --track origin/rama #Equivalente a -b rama_nueva origin/rama_nueva git chekout -b <nuevo_nombre> origin/<rama> # Establece un nombre distinto para la rama local
REBASE
# Rebase y merge se diferencian en que merge mezcla dos puntos finales de dos snapshots y rebase aplica cada uno de los cambios a la rama en la que se hace el rebase. No lo uses en repos publicos con mas colaboradores, porque todos los demas tendrn que hacer re-merges
git checkout <una rama> git rebase master # aplica todos los cambios de <una rama> a master git merge master #hay que hacer un merge de tipo fast forward # Tenemos 3 ramas, master, client y server, en server y client tenemos varios commit y queremos mezclar client en master pero dejar server intacta: o git rebase --onto master server client # adivina los patches del antecesor comn de las ramas server y client y aplica los cambios a master. o git checkout master o git merge client # fast-forward. Client y master en el mismo snapshot o # Si se quiere aplicar tambin los cambios de server, basta con: o git rebase master server o git checkout master
o git merge server git rebase [basebranch] [topicbranch] # sintaxis de rebase git rebase -i # Rebase interactivo
SERVIDOR
git instawew # Muestra una interfaz web con los commits
GENERAR UN NMERO DE COMPILACIN (BUILD NUMBER)
git describe master #Solo funciona para tags creadas con -s -a
PREPARAR UNA RELEASE
git archive master -- prefix=project/ | gzip > `git describe master`.tar.gz git archive master -- prefix=project/ --format=zip | `git describe master`.zip test/ export-ignore #Al crear el tarball no incluye el directorio test/
GENERAR UN CHANGELOG
git shortlog --no-merges master --not <tag> #Recopila todos los commits desde <tag> y los agrupa por autor
RECOMENDACIONES
Siempre hay que hacer pull antes de push en caso de que alguien haya subido cambios al servidor. Ejemplo: o User1 clona el repo y hace cambios, realiza un commit o User2 clona el repo, hace cambios, hace commit y sube los cambios con push o User1 intenta hacer push, pero ser rechazado con: ! [rejected] master > master (non-fast forward). No puede subir los cambios hasta que no mezcle el trabajo que ha subido User2. As que debe hacer lo siguiente: git fetch origin git merge origin/master git push origin master o Mientras User1 haca estas operaciones, User2 ha creado una rama issue54 y realizado 3 commits, sin haber descargado los cambios de User1. Para sincronizar el trabajo, User2 debe hacer: git fetch origin git log --no-merges origin/master ^issue54 #Observa qu cambios ha hecho User1 git checkout master git merge issue54 && git merge origin/master git push origin master
git diff --check #Antes de hacer commit, ejecutar esto para ver si hemos aadido demasiados espacios que puedan causar problemas a los dems. Commits pequeos que se centren en resolver un problema, no commits con grandes cambios. git add --patch #En caso de hacer varios cambios en el mismo archivo El mensaje del commit debe tener la estructura siguiente: Una linea de no ms de 50 caracteres, seguida de otra lnea en blanco seguida de una descripcin completa del commit.
PASOS A SEGUIR PARA CONTRIBUIR A PROYECYOS AJENOS, MEDIANTE FORK
git clone <url> git checkout -b featureA git commit git remote add myFork <url> git push myFork featureA git request-pull origin/master myFork #enviar la salida por mail al propietario del proyecto, o hacer click en pull request. Buena practica tener siempre una rama master que apunte a origin/master, para estar siempre actualizado con los ultimos cambios en el proyecto original. #Separar cada trabajo realizado en topic branch, que trackeen a origin/master o git checkout -b featureB origin/master o (Hacer cambios) o git commit o git push myFork featureB o (Contactar con el propietario del proyecto) o git fetch origin #Otro ejemplo, el propietario del proyecto quiere aceptar un pull tuyo, pero quiere que hagas algunos cambios, aprovechas la oportunidad y mueves tu trabajo para basarlo en el contenido actual de la rama origin/master, aplastas los cambios en featureB, resuelves conflictos, y haces push: o git checkout -b featureBv2 origin/master o git merge --no-commit --squash featureB o (cambiar la implementacion) o git commit o git push myFork featureBv2 o #--squash coge todo el trabajo de la rama mezclada y la aplasta en un no-merge commit encima de la rama en la que estas. --no-commit no registra el commit automaticamente. As puedes realizar todos los cambios necesarios y luego hacer el commit
REFLOG
En segundo plano, git crea un log de a donde han estado referenciando HEAD y el resto de ramas en los ltimos meses.
git reflog git show HEAD@{n} #Muestra informacin sobre el reflog nmero n git log -g master #Muestra el log formateado como la salida de reflog git show master@{yesterday} #Muestra los commits de ayer.
UTILIDADES
git show <short-SHA-1> #Es posible ver un commit pasando la versin abreviada del SHA-1 git rev-parse <branch> #A qu SHA-1 apunta una rama git show HEAD^ # Muestra commit padre git show HEAD^2 #Muestra segundo padre git show HEAD~2 # El primer padre del primer padre git filter-branch --tree-filter rm -f <file> HEAD #elimina el archivo de todos los commits
DEPURACIN
File anotation o git blame -L 12,22 <archivo> # muestra cuando y por quin se modificaron de la linea 12 a la 22 o git blame -C -L 141,153 <file> # cuando renombras un archivo o lo refactorizas en varios, muestra de donde vino originalmente. Bsqueda Binaria: Cuando hay un bug que no puedes localizar, usas bisect para dererminar en qu commit empez a producirse el bug. o git bisect start o git bisect bad # marcas el commit actual como roto o git bisect good [commit bueno] # ltimo commit conocido que funcionaba o Ahora ir preguntando hasta que encuentres el commit culpable. Si esta bien indicas git bisect good. De lo contrario git bisect bad. Al terminar hay que resetear. o git bisect reset
SUBMODULOS
git submodule add <url> # crea un directorio que contiene el comtenido de otro proyecto. Clonar un repo con submodulos git clone url git submodule init git submodule update
CONFIGURATION
git config --global <opcion> <valor> #global para usuario, system todos y sin nada, especifico para el repo. git config {key} # muestra el valor de key git config --global core.editor <editor> #cambia el editor por defecto git config --global commit.template $HOME/.gitmessage.txt #plantilla para commits git config --global core.pager more|less #paginador por defecto, puedes usar cualquiera git config --global user.signingkey <gpg-key-id> # clave gpg para firmar tags git config --global core.excludesfile <file> #como gitignore git config --global help.autocorrect 1 # autocorrige cuando se escribe un comando incorrecto. Solo en git >= 1.6.1 git config --global color.ui true # colorea la salida de git. Valores: true|false|always git config --global core.autocrlf input #para que usuarios linux no tengan problemas con los retornos de carro de windows git config --global core.autocrlf true #para usuarios de windows git config --global core.whitespace trailing-space, space-before-tab, indent-withnon-tab, cr-at-eol # respectivamente: busca espacios al final de lnea, busca espacios al inicio de tabulacin, busca lneas con 8 o ms espacios en lugar de tabulaciones, acepta retornos de carro git apply --whitespace=warn <patch> # advierte de errores de espacios antes de aplicar el patch. Con --whitespace=fix intenta arreglarlos
GIT ATTRIBUTES
Archivo en .gitattributes en el directorio de trabajo o en .git/info/attributes para no committearlo Identificando archivos binarios Muchos archivos son para uso local y no aportan informacin al repositorio. Para decirle a git qu archivos son binarios hacer aadir al archivo atributes: <nombre archivo o regexp> -crlf -diff # git no intentar corregir problemas de crlf ni mostrar los cambios con diff. En versiones >= 1.6 se pueden sustituir estos dos valores por la macro binary Diffing binary files En ocasiones es til mostrar diffs de archivos binarios, como una archivo de word: *.doc diff=word #tras esto hay que definir el filtro word para que git convierta archivos word a texto: git config diff.word.textconv strings Es posible hacer lo mismo para imgenes jpeg, es necesario instalar exiftool para extraer los metadatos y luego hacer: echo *.jpeg diff=exif >> .gitattributes git config diff.exif.textconv exiftool
Procesar archivos antes de hacer commit y antes de hacer checkout: Es posible crear tus propios filtros para hacer sustitucin. Estos filtros se llaman smudge y clean. Los puedes configurar para distintos directorios y luego escribir un script que procesar cada archivo antes de que sea checkeado (smudge) y commiteado (clean). Para ello,escribe en el .gitattributes: (En caso que quieras procesar cdigo C) *.c filter=indent Luego: git config --global filter.indent.clean indent git config --global filter.indent.smudge cat Otro ejemplo interesante es la expansin de la palabra clave $Date$. Para ello hay que escribir un script en ruby que recibe un archivo, encuentra la fecha de su ltimo commit e inserta dicha fecha en el archivo:
#! /usr/bin/env ruby</em> data = STDIN.read</em> last_date = `git log --pretty=format:"%ad" -1` puts data.gsub('$Date$', '$Date: ' + last_date.to_s + '$')
Puedes nombrar este script como expand_date. Crea un filtro en git, llamado dater y dile que use el script anterior: git config filter.dater.smudge expand_date git config filter.dater.clean perl -pe s/\\\$Date[^\\\$]*\\\$/\\\$Date\\\$/ Para usar el filtro, simplemente escribe la palabra clave en los archivos que desees: echo # $Date$ > date_test.txt echo date*.txt filter=dater >> .gitattributes git add date_test.txt .gitattributes git commit -m Testing date expansion in Git rm date_test.txt git checkout date_test.txt cat date_test.txt $Date: Tue Apr 21 07:26:52 2009 -0700$
GIT HOOKS
Hay dos tipos, de lado cliente y servidor, se guardan en el directorio .git/hooks. Para activarlos basta con que sean ejecutables.
CONCEPTOS
Fast forward: cuando se hace un merge y el commit de la rama a mezclar esta justo un commit adelantado, simplemente se hace apuntar la rama en la que se iba a mezclar al commit del merge.
GITIGNORE:
# a comment - this is ignored *.a # no .a files !lib.a # but do track lib.a, even though youre ignoring .a files above /TODO # only ignore the root TODO file, not subdir/TODO build/ # ignore all files in the build/ directory doc/*.txt # ignore doc/notes.txt, but not doc/server/arch.txt
