🤖 TestCraft API Agent: Generando pruebas automáticas desde OpenAPI con IA

¡Cerramos junio con broche de oro! En esta entrega quiero mostrarte cómo utilizar TestCraft API Automation Agent, una herramienta de código abierto que, a partir de una especificación OpenAPI/Swagger, genera automáticamente un framework de pruebas completo.

Si el nombre te resulta familiar, puede ser porque ya estuvimos hablando de esta herramienta en este post: En la demo de la semana: Cómo automatizar pruebas con TestCraft 🤖 donde básicamente te mostraba cómo usar su extensión de navegador para generar scripts de prueba utilizando la IA como un pro 🤓

---

¿Qué es TestCraft API Agent?

TestCraft API Agent es un proyecto open-source que convierte una especificación OpenAPI o colección Postman en un framework de prueba ejecutable, listo para usar con JavaScript/TypeScript. No solo genera modelos y servicios tipados, sino también pruebas completas con reportes y aserciones integradas (github.com)

Características destacadas:

• Framework completo con estructura organizada.

• Tests generados automáticamente por endpoint.

• Inclusión de formateo y linting para mantener la calidad del código.

• Compatible con OpenAI o Anthropic como motor IA.

• Soporta migración de colecciones Postman a un framework mantenible.

---

🔧 Requisitos previos

Para usarlo necesitas:

• Python ≥ 3.8 y Node.js ≥ 18

• Clave API de OpenAI o Anthropic (se usa IA para generar código)

---

🚀 Paso a paso

1. Cloná el repositorio:

git clone https://github.com/TestCraft-App/api-automation-agent.git
cd api-automation-agent

2. Instalá dependencias:

pip install -r requirements.txt

3. Configura tus credenciales:

• Copiá example.env a .env

• Agregá OPENAI_API_KEY o ANTHROPIC_API_KEY

4. Generá el framework de pruebas usando tu especificación OpenAPI:

python ./main.py ruta/a/tu/openapi.yaml

Ese archivo puede ser un Swagger exportado de Postman o generado manualmente. A partir de él, TestCraft API Agent analiza la estructura de la API (endpoints, métodos, parámetros, respuestas esperadas) y genera automáticamente:

• Modelos tipados (models/)

• Servicios base

• Archivos de pruebas (tests/) con peticiones y validaciones

• Reportes

5. Esto genera una carpeta generated-framework_[timestamp] con:

├── src/
│   ├── models/     ← interfaces TypeScript generadas
│   └── tests/      ← tests automatizados por endpoint
├── package.json
└── tsconfig.json

6. Ejecutá los tests:

cd generated-framework_...
npm install
npm test

¡Y ya está! Tenés un conjunto de pruebas automáticas ejecutables basadas en tu API.

---

✅ ¿Por qué vale la pena?

• Productividad rápida: en minutos tenés un framework listo para usar.

• Cobertura automática: cada endpoint tiene su test generado.

• Calidad de código: incluye formateo y buenas prácticas desde el comienzo.

• Flexible y gratuito: open-source, sin vendor lock-in.

---

🧭 Consideraciones finales

• Requiere clave API (OpenAI/Anthropic) y puede generar costos según consumo.

• Ideal como punto de partida: después podés personalizar o expandir los tests.

• Un excelente complemento para tus pipelines de CI/CD o flujos de trabajo de testing automatizado.

---

🔁 Próxima emisión

En julio seguiremos explorando más herramientas con IA para testing. Comenzaremos a indagar el novedoso mundo de los MCP Servers 😉

---

Si quieres que haga una demo de esta herramienta, deja un ♥️.