Entorno de trabajo: Git, PEP8 y modularización

Control de versiones con Git (pull/add/commit/push), guía de estilo PEP8, modularización e imports, manejo de paths (os.path.join/Pathlib) y unittest discover. Cubre la selección múltiple de la I1 y los descuentos de tareas.

Creado por

SebastianZ28

Valoración0 votos

-.-

commit

Git: control de versiones

Git es un sistema de control de versiones: guarda el historial de cambios de un proyecto, permite volver a versiones anteriores y trabajar en equipo sin pisarse. GitHub es el servidor remoto donde vive una copia del repositorio.

El flujo de trabajo básico de cada sesión:

bash

git pull            # 1. traer los últimos cambios del remoto (antes de trabajar)
#   ... editas archivos ...
git add archivo.py  # 2. marcar qué cambios entran al próximo commit (staging)
git commit -m "Descripción clara del cambio"   # 3. guardar una versión local
git push            # 4. subir tus commits al remoto (GitHub)

Haz git pull al empezar para partir desde la última versión y evitar conflictos, y git push al terminar para compartir. El orden típico de un cambio es add → commit → push; add selecciona, commit guarda local, push sube.

pull antes de push

Cargando Quiz...

style

PEP8 y guía de estilo

PEP8 es la guía de estilo oficial de Python. Escribir código legible no es opcional en IIC2233: seguir PEP8 es parte de la corrección y su incumplimiento descuenta en tareas. Reglas frecuentes:

Nombres: snake_case para variables y funciones, PascalCase para clases, MAYUSCULAS para constantes.
Indentación: 4 espacios (no tabs).
Líneas de a lo más 79–99 caracteres; una instrucción por línea.
Imports arriba del archivo, uno por línea, sin from modulo import *.
Espacios alrededor de operadores (a = b + 1, no a=b+1).

python

# MAL estilo:
import os,sys
def CalcularTotal(L):
  x=0
  for I in L:x=x+I
  return x
 
# Estilo PEP8:
import os
import sys
 
def calcular_total(numeros):

widgets

Modularización e imports

Modularizar es dividir el programa en varios archivos (.py), cada uno con una responsabilidad clara, en vez de un archivo gigante. En las tareas del curso hay un límite de ≤ 400 líneas por archivo. Cada archivo es un módulo que se importa desde otro.

python

# archivo: utilidades.py
def saludar(nombre):
    return f"Hola, {nombre}"
 
# archivo: main.py
from utilidades import saludar        # importar una función específica
import utilidades                      # o el módulo completo -> utilidades.saludar(...)
 
if __name__ == "__main__":
    print(saludar("Ana"))          # este bloque solo corre si ejecutas main.py directo

folder_open

Paths: rutas de archivos

Para abrir archivos, nunca escribas la ruta a mano con separadores (rompe entre Windows y Mac/Linux y descuenta en tareas). Usa os.path.join o Pathlib, que arman la ruta con el separador correcto de cada sistema operativo.

Ruta absoluta: desde la raíz del sistema (/Users/ana/proyecto/data.csv).
Ruta relativa: desde el directorio actual (data/archivo.csv).

python

import os
 
# MAL: hardcodeado (se rompe en otro SO)
ruta = 'data' + os.sep + 'notas.csv'   # peor aun si escribes el separador a mano
 
# BIEN: portable
ruta = os.path.join('data', 'archivos', 'notas.csv')
 
# alternativa con pathlib
from pathlib import Path
ruta = Path('data') / 'archivos' / 'notas.csv'

terminal

Terminal y tests

Desde la terminal navegas y ejecutas tu proyecto. Comandos básicos: cd carpeta (entrar), cd .. (subir), ls (listar; dir en Windows), python main.py (ejecutar).

El curso usa unittest para los tests. Para descubrir y correr todos los tests de una carpeta se usa unittest discover:

bash

python -m unittest discover        # corre todos los tests del directorio
python -m unittest discover -s tests_publicos   # busca en esa carpeta

Cargando Quiz...