Git Básico — Cheatsheet para la Cursada¶

Conceptos clave¶

Working Directory  →  Staging Area  →  Local Repository  →  Remote Repository
     (editar)        (git add)         (git commit)          (git push)

Working Directory: tus archivos en disco
Staging Area: archivos listos para el próximo commit
Commit: una "foto" del estado del proyecto
Branch: una línea de desarrollo independiente
Remote: el repositorio en GitHub

Configuración inicial (una sola vez)¶

git config --global user.name "Tu Nombre"
git config --global user.email "tu_email@ejemplo.com"
git config --global init.defaultBranch main

Flujo de trabajo diario¶

1. Ver el estado actual¶

git status              # ¿Qué cambió?
git diff                # Ver cambios en detalle
git log --oneline -10   # Últimos 10 commits

2. Guardar cambios (commit)¶

git add archivo.py          # Agregar un archivo al staging
git add src/                # Agregar un directorio completo
git add .                   # Agregar TODO (usar con cuidado)

git commit -m "Agregar función de ruido rosa"   # Crear commit

3. Subir a GitHub¶

git push                    # Subir commits al remoto
git push -u origin main     # Primera vez: establecer tracking

4. Traer cambios de GitHub¶

git pull                    # Descargar y fusionar cambios
git fetch                   # Solo descargar (sin fusionar)

Branches (ramas)¶

Estrategia para el TP¶

main          ← código estable, tags de entregas
  └── develop ← integración de features
       ├── feature/ruido-rosa     ← cada función en su rama
       ├── feature/sine-sweep
       └── feature/filtros-iec

Comandos¶

# Crear y cambiar a una nueva rama
git checkout -b feature/ruido-rosa

# Ver ramas
git branch              # Locales
git branch -r           # Remotas

# Cambiar de rama
git checkout develop
git checkout main

# Fusionar una rama en la actual
git checkout develop
git merge feature/ruido-rosa

# Subir una rama nueva a GitHub
git push -u origin feature/ruido-rosa

# Eliminar rama (después de fusionar)
git branch -d feature/ruido-rosa

Tags (para entregas)¶

# Crear tag para una entrega
git tag -a v0.1.0 -m "Milestone 1: Generación de señales"

# Subir tags a GitHub
git push --tags

# Ver tags
git tag -l

Mensajes de commit¶

Formato recomendado¶

<tipo>: <descripción breve>

<descripción detallada opcional>

Tipos comunes¶

Tipo	Uso
`feat`	Nueva funcionalidad
`fix`	Corrección de bug
`docs`	Cambios en documentación
`test`	Agregar o modificar tests
`refactor`	Reestructurar sin cambiar funcionalidad
`style`	Formato, espacios, puntos y comas

Ejemplos buenos¶

feat: agregar generación de ruido rosa con Voss-McCartney
fix: corregir cálculo de frecuencias en filtro de octava
test: agregar tests para integral de Schroeder
docs: actualizar README con instrucciones de instalación
refactor: extraer cálculo de espectro a función separada

Ejemplos malos¶

cambios                    # ¿Qué cambios?
arreglos varios            # ¿Qué arreglos?
wip                        # No commitear trabajo incompleto
asdasd                     # ...

Resolver conflictos¶

Cuando dos personas modifican el mismo archivo:

git pull                    # Puede generar conflicto

# Git marca los conflictos así:
# <<<<<<< HEAD
# tu código
# =======
# código del compañero
# >>>>>>> origin/develop

# 1. Editar el archivo y elegir qué mantener
# 2. Quitar las marcas de conflicto
# 3. git add archivo_resuelto.py
# 4. git commit -m "fix: resolver conflicto en generacion.py"

.gitignore¶

Archivo que dice a Git qué ignorar. Crear en la raíz del proyecto:

# Python
__pycache__/
*.pyc
*.pyo
.venv/
*.egg-info/
dist/
build/

# IDE
.vscode/
.idea/

# OS
.DS_Store
Thumbs.db

# Datos
*.wav
*.mp3
*.flac
datos/

# Jupyter (si se usa)
.ipynb_checkpoints/

# Env
.env

GitHub Issues (para el TP)¶

Crear un issue desde la web¶

Ir al repo → Issues → New Issue
Título descriptivo: "Implementar función generar_ruido_rosa"

Descripción con checklist:

## Descripción
Implementar la generación de ruido rosa usando el algoritmo Voss-McCartney.

## Criterios de aceptación
- [ ] Función genera array de la duración correcta
- [ ] Espectro es aproximadamente -3dB/octava
- [ ] Docstring completo (estilo NumPy)
- [ ] Type hints
- [ ] Al menos 2 tests con pytest

Asignar a un integrante
Agregar label: milestone-1

Cerrar un issue con un commit¶

git commit -m "feat: implementar ruido rosa (closes #3)"

El closes #3 cierra automáticamente el issue #3 cuando se mergea.

Comandos de emergencia¶

# Deshacer cambios en un archivo (no commiteados)
git checkout -- archivo.py

# Deshacer el último commit (manteniendo los cambios)
git reset --soft HEAD~1

# Ver quién cambió cada línea de un archivo
git blame archivo.py

# Buscar un texto en todo el historial
git log --all -S "ruido_rosa"

# Ver el diff de un commit específico
git show abc1234

Flujo completo de ejemplo¶

# 1. Empezar a trabajar en una nueva función
git checkout develop
git pull
git checkout -b feature/ruido-rosa

# 2. Escribir código y tests
# ... editar src/acoustipy/generacion.py
# ... editar tests/test_generacion.py

# 3. Verificar
uv run pytest
uv run ruff check .

# 4. Commit
git add src/acoustipy/generacion.py tests/test_generacion.py
git commit -m "feat: implementar generación de ruido rosa (closes #3)"

# 5. Subir
git push -u origin feature/ruido-rosa

# 6. Crear Pull Request en GitHub
# 7. Pedir review a un compañero
# 8. Mergear a develop después del review