Preparar el entorno práctico de Python
Resumen del laboratorio
Ilustración conceptual original (SVG)
| De un vistazo | Tu ruta |
|---|---|
| Nivel y tiempo | 100; 20 minutos (estimación de facilitación) |
| Acción inicial | Localiza la raíz de importación de la biblioteca antes de elegir un framework de pruebas. |
| Materiales del aprendiz | Descarga 02-python.zip |
| Espacio de trabajo | Abre la raíz del kit extraído; ejecuta la baseline desde library relativa a esa raíz |
| Comprobación inicial esperada | Las pruebas unittest existentes se descubren y pasan. |
| Ayuda de configuración | Descarga, extrae, Git local y GitHub opcional |
[!NOTE] Una prueba que no puede importar la aplicación no ha probado su comportamiento.
Conceptos · Primera tarea · Lista de evidencias · Restablecer
Objetivos de aprendizaje
- Selecciona el mismo intérprete en VS Code y en el terminal.
- Comprende la raíz de importación y el ejecutor de pruebas del fixture.
- Mantén los entornos virtuales y las cachés en la unidad de trabajo seleccionada.
Antes de empezar
Lee la configuración del entorno. Usa un intérprete de Python compatible
y la extensión de Python de VS Code. Las pruebas de la biblioteca proporcionadas usan unittest.TestCase;
pytest puede ejecutarlas en el laboratorio de pytest. No instales paquetes para la línea base de la
biblioteca estándar salvo que un comando los requiera realmente.
Conceptos y casos de uso
| Elemento | Propósito |
|---|---|
| Intérprete | Ejecuta el código; su selección determina los paquetes disponibles |
| Entorno virtual | Mantiene separadas las dependencias de este fixture |
| Directorio de trabajo | Determina las importaciones de nivel superior y los archivos relativos |
| Descubrimiento de pruebas | Encuentra casos; es distinto de ejecutarlos |
Escenario del ejercicio
La biblioteca se encuentra en AccelerateDevGHCopilot/library. Sus importaciones esperan
application_core, console e infrastructure bajo la raíz de importación actual.
Tarea 1 - Preparar la copia aislada
node scripts/prepare-hands-on.js --lab 02-python --destination /Volumes/T9/Dev/oss/workshop-runs/02-python
Abre únicamente la copia mostrada, selecciona el intérprete de Python y después cambia a
library en su terminal. Registra el intérprete y el directorio de trabajo.
Tarea 2 - Descubrir y ejecutar las pruebas existentes
python -m unittest discover -s tests -p "test_*.py" -v
- Confirma que aparezcan nombres reales de pruebas.
- Registra los resultados de las aserciones y el estado de salida.
- En el editor, usa Python: Configure Tests y selecciona unittest con
testscomo directorio para esta línea base. - Si se selecciona el laboratorio posterior de pytest, crea
.venven la copia desechable, instala allí el requisito declarado de pytest y selecciona ese intérprete. - Evita el descubrimiento automático en todo el contenido formativo; contiene copias independientes con distintas raíces de importación.
Verifica tu trabajo
- El terminal y el editor usan el intérprete previsto.
- Las pruebas se descubren desde
library, no desde un directorio no relacionado. - Ningún resultado de cero pruebas se considera una línea base superada.
- No se creó ningún paquete, entorno ni caché en el disco del sistema operativo para este taller.
Solución de problemas
ModuleNotFoundError: application_core suele indicar una raíz de trabajo o importación
incorrecta. No disperses cambios de sys.path por las pruebas. La ausencia de pytest en una
línea base de unittest no es motivo para instalar pytest globalmente.
Práctica independiente
Compara el descubrimiento de unittest con la recopilación de pytest sobre las mismas clases TestCase.
Explica por qué seleccionar ambos frameworks en VS Code no significa que ambos se hayan ejecutado.
Restablecimiento
Cierra el espacio de trabajo copiado y restaura únicamente las preferencias que hayas cambiado para él. Mantén intactos los intérpretes compartidos y los entornos virtuales de otros proyectos.