Práctica focalizada · Bloque 2 · Unidad 2.1
EX-B2-01
La aplicación que Uvicorn no puede importar
Un compañero ejecuta `uv run uvicorn app.main:app --reload`, pero el proceso termina antes de abrir el puerto.
Cómo abordarla
Pon en marcha y diagnostica la ruta
Ejecuta primero el baseline. Después modifica la frontera indicada, escribe una regresión positiva y otra negativa y conserva la salida real.
Evidencia objetivo: La aplicación importa, la ruta correcta responde y puedes explicar el orden de coincidencia.
Abrir laboratorio de código
1. Descarga y arranca
- Proyecto con importación defectuosaStarter autocontenido con árbol, traceback y aplicación mínima desplazada.
2. Escribe y prueba
- Reproduce el fallo desde el directorio indicado.
- Comprueba la importación con Python antes de abrir el servidor.
- Corrige entrypoint, estructura o directorio sin mover archivos innecesariamente.
- Demuestra `GET /health` y documenta la causa raíz.
3. Demuestra el comportamiento
- Diagnóstico con las hipótesis comprobadas en orden y la causa demostrada.
- Parche mínimo y comandos de importación, arranque y `GET /health`.
- Comparación breve entre el traceback inicial y la ejecución reparada.
La respuesta principal es tu código y sus pruebas. Usa este espacio solo para anotar la predicción inicial y el resultado observado.
Predicción breve antes de ejecutar
¿Qué significa cada segmento de `app.main:app`, dónde falla el arranque y qué comprobación mínima demuestra la reparación?
Información que necesitas
Traceback inicial: ModuleNotFoundError: No module named 'app.main'; el árbol descargado contiene src/records_api/main.py.Comprueba estas tres cosas
- ¿Qué comportamiento observas y qué parte es todavía una hipótesis?
- ¿Cuál es el cambio mínimo que permite verificar la causa o el contrato?
- ¿Qué evidencia conservarías para demostrar que no rompiste otra frontera?
Anota predicción, comando ejecutado y diferencia observada; el código vive en tu workspace.
Sin respuesta guardada.
Pistas opcionales
Pista 1 · Localiza la frontera
- Separa importación, enrutado, extracción, validación, operación y serialización.
- Lee el status, los headers y la ubicación del error antes de editar.
Pista 2 · Reduce la prueba
- Usa una petición válida y una inválida que difieran en una sola variable.
- Compara el comportamiento con `/openapi.json` cuando el contrato esté documentado.
Profundización opcional
Distinguir directorio de trabajo, módulo importable y atributo ASGI, y reparar solo la causa demostrada.
Contexto adicional
- Trabaja únicamente dentro del alcance del bloque: una aplicación pequeña y estado en memoria.
- No hay solución oficial publicada; el material contiene huecos y defectos deliberados.
- Justifica las decisiones por el mensaje HTTP y el contrato observable, no solo porque el código arranque.
Cómo revisar tu respuesta
- La explicación diferencia módulo y atributo.
- La importación directa y el servidor arrancan desde un checkout limpio.
- No se oculta el problema alterando PYTHONPATH global.
Evidencia, revisión y reinicio
- Decisión razonada guardada localmente en la web.
- Código o informe ejecutable en el workspace temporal, más una captura de curl/OpenAPI cuando proceda.
Revisión: con Codex, utilizando la evidencia y los criterios anteriores; no se publica una solución oficial.
Reinicio: Eliminar el workspace temporal y volver a descargar el material inicial; no hay estado persistente externo.