Pruebas unitarias en FastAPI con PyTest

Contenido del curso

Web App con FastAPI + Docker

Frontend con Next.js y Cursor IDE

iOS con Swift + Cursor IDE

Android + Cursor IDE

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:007:01

Pruebas unitarias en FastAPI con PyTest

Curso de Cursor AI Code Editor

Clase 9 de 25

Clase 9 / 25

Recursos

Validar que tus endpoints cumplan con el contrato definido es tan importante como construirlos. Con pruebas unitarias en FastAPI usando PyTest y Cursor, puedes garantizar que cada respuesta respete la estructura acordada sin depender de la base de datos. Esto te sirve si trabajas con APIs en Python y quieres acelerar tu flujo de testing apoyado en IA.

¿Cómo indexar la documentación de FastAPI en Cursor?

Antes de pedirle a Cursor que escriba pruebas, necesita conocer cómo se testean los endpoints en FastAPI. La estrategia es la misma que usaste con Alembic y SQLAlchemy: indexar la documentación oficial.

Copia la URL de la documentación de testing de FastAPI.
Abre los settings de Cursor y agrega la fuente como FastAPIDocs.
Confirma y espera a que termine la indexación.

Con eso, Cursor ya puede generar código alineado con las prácticas reales del framework.

¿Por qué indexar la documentación antes de pedir pruebas? Porque sin contexto oficial, el modelo improvisa. Indexarla le da referencias actualizadas sobre TestClient, fixtures y dependency overrides.

¿Qué instrucciones darle a Cursor para generar las pruebas?

La clave está en ser explícito con tres cosas: objetivo, framework y estrategia de aislamiento. En el prompt le pides crear pruebas unitarias para los endpoints de main que cumplan con el contrato definido en contracts, usando PyTest como framework y haciendo mock del course service para no depender de la base de datos.

Aquí aparece un detalle importante. Si el course service no está inyectado como dependencia de FastAPI, mockearlo se vuelve complicado. Por eso, antes de generar las pruebas, conviene pedir un refactor para que el servicio se consuma como un Depends de FastAPI.

¿Qué cambia con la inyección de dependencias?

El endpoint get_courses deja de recibir directamente la sesión de base de datos y pasa a recibir el course_service, que se resuelve con una función get_course_service encargada de instanciar el servicio. Ese pequeño cambio habilita algo poderoso: puedes sobreescribir la dependencia en pruebas con un mock limpio.

¿Cómo se estructura el archivo test_main.py?

Cursor genera el archivo de pruebas siguiendo buenas prácticas de PyTest. Lo interesante es cómo organiza el aislamiento:

Crea un mock de los cursos y del detalle para evitar consultar la base de datos.
Define ese mock como fixture de PyTest, lo que permite reutilizarlo como dependencia en cada método de prueba.
Cubre el endpoint de health, el root y el de cursos, validando que la estructura del contrato esté presente en cada respuesta.

Esto se traduce en pruebas rápidas, deterministas y enfocadas en lo que importa: que el endpoint devuelva lo prometido.

¿Qué es un fixture en PyTest? Es una función que prepara datos o dependencias antes de cada prueba. En FastAPI se usa para inyectar mocks del servicio sin tocar la base de datos real.

¿Cómo ejecutar y depurar las pruebas desde Cursor?

El plugin de Python para Cursor incluye una integración visual con PyTest que ahorra tiempo al depurar. Para activarla:

Abre la paleta con Command + Shift + P y escribe tests.
Selecciona configurar pruebas unitarias y elige PyTest como framework.
Define el root directory del servicio, en este caso app.

Después de configurarlo, aparece un botón de play junto a cada prueba. Desde ahí puedes ejecutar tests individuales o lanzarlos en modo debug.

¿Cómo aprovechar los breakpoints en pruebas y endpoints?

Puedes poner un breakpoint dentro del test y otro dentro del endpoint en main.py. Al correr el debug, el flujo se detiene primero en la prueba, luego entra al endpoint donde el course_service ya es el mock configurado, y finalmente regresa con el response HTTP. En la debug console inspeccionas el JSON, los datos retornados y validas que todo coincida con el contrato.

Ese ciclo de inspección es oro cuando una prueba falla y necesitas entender si el problema está en el mock, en el endpoint o en la serialización de la respuesta.

¿Qué reto puedes tomar después de las pruebas unitarias?

El siguiente paso natural es subir el nivel y pasar de pruebas unitarias a pruebas de integración. En lugar de mockear el course service, dejas que se ejecute realmente y que invoque a la base de datos. Eso te obliga a configurar una base de datos de pruebas, manejar transacciones y limpiar el estado entre tests.

Es un ejercicio incómodo al principio, pero te da confianza real sobre el comportamiento del sistema completo. Cuéntame en los comentarios qué pasos seguiste, qué se rompió en el camino y cómo lo resolviste.

Daniel Flores

Hace un año

🧪 Pruebas Unitarias en FastAPI con pytest + Cursor

Las pruebas unitarias aseguran que tus endpoints cumplan los contratos definidos desde el inicio. Con Cursor y pytest, puedes automatizar pruebas de forma eficiente y precisa.

📚 Paso 1: Indexar documentación en Cursor

🔗 Copia la URL oficial de FastAPI Docs.
⚙️ Ve a Settings > Indexed Docs en Cursor.
➕ Agrega la documentación de FastAPI. ✅ Esto permite que Cursor genere pruebas contextualizadas y con buenas prácticas.

🧠 Paso 2: Instrucciones clave para Cursor

Al solicitar generación de pruebas, asegúrate de indicarle:

🧪 Usar pytest (debe estar instalado).
🧱 Hacer mock del servicio (courseService, por ejemplo).
🔁 Refactorizar funciones usando Depends() para facilitar la inyección de dependencias (base para pruebas limpias).

🛠️ ¿Qué hace Cursor al generar pruebas?

🔄 Refactoriza endpoints para inyectar servicios (Depends(course_service)).
🧩 Crea fixtures de pytest que simulan las respuestas del servicio.
🧪 Genera archivos como:
- tests/test_main.py: pruebas por endpoint
- README.md: explicación del proceso y alcance

✅ Esto permite validar la lógica sin depender de la base de datos real.

🧰 Ejecución y debugging de pruebas con Cursor

🧭 Usa Cmd + Shift + P y selecciona Run Tests.
🧪 Asegúrate de que pytest esté configurado como framework de pruebas.
📁 Define el root de pruebas (normalmente app/tests/).
▶️ Ejecuta funciones individuales con el botón play.
🐞 Añade breakpoints para depurar paso a paso:
- En los endpoints
- En las funciones de prueba
- En las respuestas simuladas (JSON, HTTP)

Web App con FastAPI + Docker

Vibe coding con Cursor en dos semanas

Stack tecnológico para plataforma educativa online

Configuración de contexto y reglas en Cursor para FastAPI

Setup de FastAPI con Cursor paso a paso

Ejecución autónoma de setup con Cursor

Cursor dentro de un contenedor Docker

Migraciones y modelos ORM con Cursor y Alembic

Creación de servicios y endpoints en FastAPI con Docker

Pruebas unitarias en FastAPI con PyTest

Frontend con Next.js y Cursor IDE

Cursor Agent para front-end sin configuración

Creación y configuración de Cursor Rules para proyectos Next.js

Mejora visual de landing pages con imágenes y tokens CSS

Configuración de estilos globales SCSS y páginas dinámicas en Next.js

Configuración de Vitest para pruebas unitarias en Next.js

Página completa con un solo prompt en Cursor

E2E testing con Playwright MCP en Cursor

iOS con Swift + Cursor IDE

Configuración de Cursor con Xcode para desarrollo iOS nativo

Configura reglas y contexto en Cursor

Genera UI en SwiftUI con prompts en Cursor

Cursor genera capas data y domain en iOS

Conexión de view models con capas domain y data

Android + Cursor IDE

Setup de Cursor para apps Android con Kotlin

Cursor genera una app Android desde cero

Corrección de errores de dependencias con Cursor en Android Studio

Cursor en equipo: entrega frontend en un día

Pruebas unitarias en FastAPI con PyTest

Progreso del curso

Web App con FastAPI + Docker

Frontend con Next.js y Cursor IDE

iOS con Swift + Cursor IDE

Android + Cursor IDE

Recursos

Recursos