Python genera muchos archivos que no deberían ser incluidos en commits: bytecode compilado (__pycache__, .pyc), directorios de entorno virtual, paquetes de distribución, informes de cobertura y configuraciones específicas del IDE.
Esta plantilla usa el gitignore oficial de GitHub para Python combinado con reglas de VirtualEnv y patrones comunes de IDE/SO. Funciona con pip, poetry, pipenv, conda, pytest, mypy y todos los flujos de trabajo principales de Python.
Cómo usar
1. Revisa las plantillas preseleccionadas abajo
2. Añade o quita plantillas para que coincidan con tu proyecto (ej: añade Django, Flask)
3. Haz clic en "Copiar" o "Descargar" para obtener el archivo
4. Colócalo en el directorio raíz de tu proyecto
Preguntas frecuentes
¿Debo hacer commit de mi entorno virtual?
Nunca. Los entornos virtuales (venv, .venv, env) pueden ser enormes y son específicos de cada máquina. Añádelos al .gitignore y usa requirements.txt o pyproject.toml para recrearlos.
¿Debo ignorar __pycache__ y archivos .pyc?
Sí. Estos son archivos de bytecode compilado generados automáticamente por Python. Son específicos de la máquina y se regenerarán cuando Python ejecute tu código.
¿Debo hacer commit de los checkpoints de Jupyter notebooks?
No. El directorio .ipynb_checkpoints es autogenerado por Jupyter y debería ser ignorado. Los propios notebooks (archivos .ipynb) sí deberían incluirse en commits.