Un programa puede ser correcto y fallar porque lo ejecutas con otro intérprete o desde una carpeta inesperada. Hoy prepararás un entorno separado y aprenderás a comprobar dónde estás trabajando. Aprovecharemos tu instalación previa de Python: no necesitas reinstalarla ni buscar una versión concreta anunciada como la última.
Saber qué Python estás utilizando
En Windows abre una terminal en la carpeta del curso y prueba py –version. En Linux o macOS utiliza python3 –version. Necesitas Python 3.10 o posterior para los ejemplos de este curso. Si el comando no existe revisa la instalación que utilizaste en el curso anterior. No escribas estos comandos dentro del indicador de Python con los tres signos de mayor que: pertenecen a la terminal del sistema.
El número de versión no basta para identificar una instalación. En un equipo pueden convivir varias. Crea ubicacion.py con el siguiente contenido y ejecútalo con el comando que acaba de funcionar. La primera salida identifica el ejecutable y la segunda muestra la carpeta de trabajo actual.
import sysprint(sys.executable) print(Path.cwd()) «`
Compara la segunda ruta con la carpeta donde guardaste el archivo. No tienen por qué coincidir. El intérprete puede abrir un programa ubicado en otra carpeta sin cambiar el directorio de trabajo. Esta diferencia explica muchos archivos que parecen desaparecer: se crearon correctamente pero en un lugar distinto del que estabas mirando.
Crear el entorno virtual
Un entorno virtual mantiene separadas las dependencias de un proyecto. No es una máquina virtual ni convierte un programa desconocido en seguro. Sigue teniendo los permisos de tu usuario. Aquí lo utilizaremos como hábito de organización aunque el proyecto empleará únicamente módulos de la biblioteca estándar y no requerirá instalar paquetes de terceros.
En Windows ejecuta py -m venv .venv. En Linux o macOS ejecuta python3 -m venv .venv. El nombre .venv corresponde a una carpeta que Python creará dentro del proyecto. Si tu distribución informa de que falta el soporte para venv sigue las instrucciones de su gestor de paquetes. No modifiques el Python del sistema para resolverlo a ciegas.
Puedes trabajar sin activar el entorno si llamas directamente a su intérprete. Este procedimiento evita depender del tipo de terminal o cambiar políticas de ejecución. En PowerShell o en la consola de Windows utiliza .venv\Scripts\python.exe ubicacion.py. En Linux o macOS utiliza .venv/bin/python ubicacion.py. La salida de sys.executable debe señalar ahora a esa carpeta.
Una convención para el resto del curso
En los ejemplos abreviaremos el comando como python archivo.py. Sustituye python por la ruta anterior si no has activado el entorno. Haz lo mismo cuando aparezca python -m unittest. La parte situada después del intérprete se conserva. Es preferible escribir unos caracteres más y saber qué estás ejecutando que confiar en un comando ambiguo.
Ordenar archivos sin complicar el proyecto
Dentro de la carpeta principal crea una subcarpeta practicas para los ejercicios independientes. Reserva proyecto para la aplicación final. Más adelante tendrás archivos como modelo.py, almacen.py y app.py juntos dentro de proyecto. La base de datos de prueba y los CSV estarán allí o en rutas que indiques expresamente. No copies el entorno virtual dentro de cada subcarpeta.
Evita nombres que coincidan con módulos que vas a importar. Un archivo llamado csv.py puede ocultar al módulo csv de Python. Lo mismo ocurre con json.py, unittest.py o sqlite3.py. Utiliza nombres como practica_csv.py. Si ya cometiste ese error renombra el archivo y vuelve a ejecutar desde una terminal nueva antes de buscar causas más difíciles.
No guardes contraseñas en ejemplos ni añadas paquetes porque alguien los mencione en un tutorial. Un paquete externo introduce otra pieza que tendrás que entender y mantener. Para este curso pathlib, csv, decimal, sqlite3 y unittest cubren el trabajo previsto. Consultarás la documentación oficial cuando necesites confirmar una opción en tu instalación.
Comprobar que puedes reconstruir el entorno
Una instalación reproducible no depende de recordar qué hiciste hace tres semanas. Anota el sistema, la versión de Python, el comando de creación del entorno y el comando de ejecución. Si una persona recibe el código debería poder repetir esos pasos. No hace falta copiar .venv a otro ordenador: se crea otra vez con el Python de ese equipo.
Distingue código, datos y herramientas. El archivo ubicacion.py es código. Un futuro inventario.db contendrá datos. La carpeta .venv es una herramienta de ejecución. Puedes recrear el entorno pero no recuperar por arte de magia una base de datos borrada. Esa distinción será importante cuando preparemos las copias de seguridad.
Errores habituales
La activación del entorno solo afecta a la terminal donde se realiza. Abrir otra ventana puede devolverte al intérprete general. Otra confusión frecuente es escribir pip sin comprobar a qué Python pertenece. Si algún proyecto futuro necesita paquetes utiliza python -m pip con su intérprete para vincular ambas herramientas. En este curso no tienes que instalar nada con pip.
Si el editor ejecuta un Python distinto del de la terminal revisa su selección de intérprete. La salida de sys.executable es una comprobación más útil que el nombre que aparece en una pestaña. Conserva las rutas en el cuaderno: te permitirán explicar un fallo sin limitarte a decir que en tu equipo no funciona.
Lo que deberías recordar
- El intérprete y la carpeta de trabajo son datos distintos.
- Un entorno virtual separa dependencias.
- Puedes usar su ejecutable sin activarlo.
- No nombres tus archivos como módulos estándar.
Ejercicio práctico
Crea el entorno virtual y ejecuta ubicacion.py con su ruta explícita. Copia en el cuaderno la versión, la ruta del ejecutable y el directorio de trabajo. Cierra la terminal, vuelve a abrirla y repite la ejecución. Debes poder obtener el mismo intérprete sin depender de una activación que ya no existe.
Crea las carpetas practicas y proyecto. Guarda una copia del diagnóstico anterior en practicas con un nombre que no coincida con un módulo estándar. Ejecútala desde la carpeta principal indicando su ruta. Explica por qué el directorio de trabajo sigue siendo el principal aunque el archivo esté dentro de practicas.
Finalmente escribe cuatro instrucciones para preparar el curso en otro equipo. Incluye el requisito de Python, la creación de .venv, la ubicación de los archivos y el comando exacto de ejecución. No incluyas pasos de instalación de paquetes porque esta aplicación no los necesita.
Referencia de consulta: Entornos virtuales en la documentación oficial de Python.
Siguiente: Limpiar y comparar textos con criterio.
