====== Git - Flujo de trabajo ======

Comandos organizados según el uso habitual: configuración, ramas, clones, diferencias, fusión, sincronización remota y resolución de conflictos.

===== Configuración inicial =====

  * **Muestra la versión de Git instalada**.

<code bash>
git --version
</code>

  * **Inicializa un repositorio nuevo** en el directorio actual.

<code bash>
git init
</code>

  * **Configura un directorio como seguro** (evita el error ''detected dubious ownership'' en entornos como /var/www).

<code bash>
git config --global --add safe.directory /var/www/btrainer
</code>

  * **Inicia Git Flow** (estructura de ramas feature/develop/master/release/hotfix).

<code bash>
git flow init
</code>

===== Estado y seguimiento =====

  * **Muestra el estado actual** del working directory y staging area.

<code bash>
git status
</code>

  * **Añade todos los cambios** (nuevos, modificados y eliminados) al área de staging.

<code bash>
git add .
</code>

  * **Guarda los cambios en staging** con un mensaje descriptivo.

<code bash>
git commit -m "Carga inicial"
</code>

===== Gestión de ramas =====

  * **Lista las ramas locales** (la actual con asterisco).

<code bash>
git branch
</code>

  * **Lista todas las ramas** (locales y remotas).

<code bash>
git branch -a
</code>

  * **Crea una nueva rama** llamada ''arwen-estado''.

<code bash>
git branch arwen-estado
</code>

  * **Crea una rama de respaldo** antes de una fusión peligrosa.

<code bash>
git branch backup/master-pre-fusion
</code>

  * **Elimina una rama local** (solo si ya está fusionada).

<code bash>
git branch -d arwen-estado
</code>

  * **Muestra la ayuda** del comando branch.

<code bash>
git branch -h
</code>

  * **Cambia a la rama develop**.

<code bash>
git checkout develop
</code>

  * **Cambia a la rama master**.

<code bash>
git checkout master
</code>

===== Clonación y copias remotas =====

  * **Clona un repositorio local a una máquina remota vía SSH** (sin --bare: directorio de trabajo completo).

<code bash>
git clone /home/luis/Dropbox/Proyectos/btrainer ssh://ubuntu@boromir/home/ubuntu/Proyectos/btrainer
</code>

  * **Clona desde el directorio actual a remoto** (dos formas equivalentes).

<code bash>
git clone . ssh://ubuntu@boromir/Proyectos/btrainer
</code>

<code bash>
git clone . ubuntu@boromir/Proyectos/btrainer
</code>

  * **Clona un repositorio bare** (solo el historial, sin working directory). Útil para servidores centrales.

<code bash>
git clone --bare . ssh://ubuntu@boromir/Proyectos/btrainer
</code>

<code bash>
git clone --bare /home/luis/Dropbox/Proyectos/btrainer ssh://ubuntu@boromir/home/ubuntu/Proyectos/btrainer
</code>

===== Gestión de remotos =====

  * **Muestra los remotos configurados** con sus URLs.

<code bash>
git remote -v
</code>

  * **Añade un remoto llamado 'boromir'**.

<code bash>
git remote add boromir ssh://ubuntu@boromir:/home/ubuntu/Proyectos/btrainer
</code>

  * **Obtiene la URL del remoto 'boromir'**.

<code bash>
git remote get-url boromir
</code>

  * **Elimina el remoto 'boromir'**.

<code bash>
git remote remove boromir
</code>

===== Sincronización con remotos =====

  * **Descarga cambios del remoto 'boromir' sin fusionarlos** (dry-run primero para previsualizar).

<code bash>
git fetch --dry-run boromir
</code>

<code bash>
git fetch boromir
</code>

  * **Descarga y fusiona cambios del remoto** (pull completo).

<code bash>
git pull
</code>

  * **Pull forzando la fusión** de historiales no relacionados (ej. dos repos independientes).

<code bash>
git pull boromir master --no-rebase --allow-unrelated-histories
</code>

  * **Prueba de envío** (dry-run) antes de hacer push.

<code bash>
git push --dry-run boromir master
</code>

  * **Envía la rama master al remoto 'boromir'**.

<code bash>
git push boromir master
</code>

  * **Envía con sobreescritura forzada** (peligro: reescribe historia remota).

<code bash>
git push boromir master --force
</code>

  * **Versión verbosa del push forzado** (muestra más detalles).

<code bash>
git -v push boromir master --force
</code>

<code bash>
git --verbose push boromir master --force
</code>

  * **Resetea el remoto de forma remota vía SSH** (fuerza el HEAD en el servidor sin hacer clone).

<code bash>
ssh ubuntu@boromir "cd /home/ubuntu/Proyectos/btrainer && git reset --hard HEAD"
</code>

===== Comparaciones y diferencias =====

==== Diferencias básicas ====

  * **Muestra cambios sin stage** (working directory vs staging).

<code bash>
git diff
</code>

  * **Muestra cambios concretos** en un archivo.

<code bash>
git diff st.py
</code>

<code bash>
git diff templates/client3_rutina.html
</code>

  * **Muestra diferencias en un directorio completo**.

<code bash>
git diff templates/
</code>

==== Diferencias entre ramas ====

  * **Diferencia entre master y develop** con formato estadístico.

<code bash>
git diff --stat develop master | less
</code>

<code bash>
git diff --dirstat master develop | less
</code>

  * **Muestra solo nombres de archivos** que difieren.

<code bash>
git diff --name-only
</code>

<code bash>
git diff --name-only master develop | less
</code>

  * **Muestra nombres + estado** (A=added, M=modified, D=deleted).

<code bash>
git diff --name-status master develop | less
</code>

  * **Muestra estadísticas numéricas** (líneas añadidas/eliminadas).

<code bash>
git diff --numstat develop master | less
</code>

  * **Ignora cambios de espacios en blanco** (-w) y sin contexto (-U0).

<code bash>
git diff -w master develop | less
</code>

<code bash>
git diff -w -U0 master develop | less
</code>

  * **Versión resumida** (solo total de líneas cambiadas).

<code bash>
git diff --shortstat develop master | less
</code>

  * **Formato raw** (máximo detalle, útil para scripts).

<code bash>
git diff --raw master develop | less
</code>

  * **Diferencia entre ramas específicas** (master vs arwen-estado).

<code bash>
git diff --stat master arwen-estado
</code>

==== Diferencias con el área de staging ====

  * **Muestra archivos en staging** que están a punto de committearse.

<code bash>
git diff --cached --stat
</code>

  * **Archivos nuevos** (solo los añadidos).

<code bash>
git diff --cached --name-only --diff-filter=A
</code>

  * **Diferencia de un archivo específico** en staging.

<code bash>
git diff --cached Pipfile
</code>

<code bash>
git diff --cached st.py
</code>

  * **Diferencia de un binario o archivo especial** (ej. SVG).

<code bash>
git diff --cached static/css/fonts/icomoon.svg
</code>

===== Historial y logs =====

  * **Muestra el historial completo**.

<code bash>
git log
</code>

  * **Muestra ayuda** del comando log.

<code bash>
git log -h
</code>

  * **Log con referencias decoradas** (ramas, tags).

<code bash>
git log --decorate
</code>

  * **Log de una rama específica**.

<code bash>
git log develop
</code>

  * **Formato compacto** (una línea por commit) con grafo ASCII.

<code bash>
git log --oneline --graph --all
</code>

  * **Combinación completa**: oneline + graph + all + decorate.

<code bash>
git log --oneline --graph --all --decorate
</code>

  * **Versión con decoración y grafo** (similar al anterior pero más detallado).

<code bash>
git log --decorate --all --graph
</code>

  * **Describe el commit actual** (tag más cercano + distancia + hash).

<code bash>
git describe
</code>

===== Fusiones (merge) =====

  * **Fusiona develop en la rama actual**.

<code bash>
git merge develop
</code>

  * **Fusiona master en la rama actual**.

<code bash>
git merge master
</code>

===== Resolución de conflictos =====

  * **Mantiene la versión local** (ours) en conflicto.

<code bash>
git checkout --ours st.py
</code>

  * **Mantiene la versión remota** (theirs) en conflicto.

<code bash>
git checkout --theirs st.py
</code>

===== Notas importantes =====

  * ''--force'' en push reescribe la historia remota. Usar con precaución en ramas compartidas.
  * ''git reset --hard'' en remoto vía SSH es destructivo localmente en el servidor.
  * ''git pull --no-rebase --allow-unrelated-histories'' es útil para unir dos repositorios independientes.
  * El flag ''-w'' en diff ignora cambios de espacios/blancos, ideal para limpiar ruido visual.