qagent-pytest 0.2.0

Encuentra lo que falla. Conserva lo que funciona.

QAgent escribe pruebas pytest para tu código Python con un equipo de agentes de IA,
las ejecuta en un entorno aislado y te dice qué falla y por qué, sin debilitar una sola prueba.

 

Por qué QAgent · Cómo funciona · Qué incluye · Instalación · Primeros pasos

Por qué QAgent

Cómo funciona

Abres un proyecto, eliges qué probar y QAgent hace el resto en cuatro pasos.

1 · Explorar QAgent analiza el proyecto y lista sus funciones y endpoints FastAPI, con su complejidad y lo que cambió desde la última vez. Tú eliges qué probar.	2 · Preparar Decides qué hacer: generar pruebas nuevas, volver a correr las guardadas o analizar a fondo las funciones críticas. Antes de empezar ves el uso de IA y la duración estimados.
3 · En curso Sigues en vivo cómo los agentes analizan, escriben y verifican cada prueba. Si la IA intenta debilitar una prueba, lo verás bloqueado aquí.	4 · Resultados Primero lo que requiere atención: cada posible bug llega con su explicación y el valor esperado según el contrato. Puedes exportar el informe.

Detrás de cada corrida trabajan tres agentes coordinados, que solo se comunican por contratos JSON:

Qué incluye

• Pruebas unitarias de funciones Python y pruebas de endpoints FastAPI con TestClient, sin red y simulando Depends.
• Casos clasificados como normales, límite o de error.
• Perfiles de prueba: Humo, con un caso normal por objetivo para una revisión rápida; y análisis a fondo, que además mide la fortaleza de las pruebas en las funciones críticas.
• Mutation testing acotado a las funciones que marques como críticas, nunca al repositorio completo.
• Pruebas de regresión: vuelve a correr las pruebas guardadas sin gastar IA y ve qué empeoró y por qué.
• Métricas por prueba: si pasó, cobertura de líneas y ramas, intentos, tokens por agente y Mutation Score.
• Historial de corridas, con la comparación frente a la anterior.
• Informes exportables en HTML interactivo, PDF, Markdown o JSON.
• Tu IA, por etapa: cada agente puede usar su propio proveedor y modelo (Anthropic, OpenAI, Google Gemini, Groq, DeepSeek, OpenRouter o Xiaomi MiMo).
• Tema oscuro y claro.

Historial: el trabajo anterior, a mano	Configuración: un proveedor y modelo por etapa

Instalación

Windows: instalador (recomendado)

1. Descarga QAgent-<versión>-instalador.exe desde la última versión publicada.
2. Ejecútalo. No necesita permisos de administrador ni tener Python instalado.
3. Si Windows muestra «Windows protegió tu PC», elige Más información → Ejecutar de todas formas (el instalador aún no está firmado digitalmente).

Con pip (si ya usas Python 3.10 o superior)

pip install qagent-pytest
qagent

En PyPI se llama qagent-pytest porque el nombre qagent ya lo usaba otro proyecto; el programa, el comando y la marca siguen siendo QAgent.

Antes de la primera corrida

• Docker Desktop, abierto: las pruebas se ejecutan solo dentro de un contenedor aislado. La primera corrida prepara ese entorno sola (necesita internet y tarda unos minutos, una sola vez). Descargar Docker Desktop.
• Claves de API de los modelos de IA: se agregan en la pantalla Configuración del programa.
• Git, si vas a clonar repositorios por su URL.

¿Quieres probarlo sin claves ni costo? Agrega la línea QAGENT_FAKE_LLM=1 al archivo .env de la carpeta .qagent de tu usuario (C:\Users\<tú>\.qagent\.env): QAgent usará una IA simulada con respuestas grabadas.

Tus claves, tu configuración y la lista de proyectos recientes se guardan en esa carpeta .qagent de tu usuario, nunca junto al programa. Desinstalar QAgent no las borra.

Primeros pasos

1. Abre QAgent desde el menú Inicio (o con el comando qagent).
2. En Configuración, agrega la API de cada etapa: Analizando, Escribiendo pruebas y Verificando.
3. En Inicio, elige Abrir carpeta (un proyecto Python en tu equipo) o Clonar URL Git.
4. En Explorar, elige las funciones y endpoints a probar y pulsa Preparar.
5. En Preparar, elige qué hacer y los tipos de prueba, y pulsa Iniciar prueba.
6. Sigue el avance en En curso y revisa Resultados; desde ahí puedes Exportar informe.

Alcance

QAgent genera pruebas unitarias para código Python 3.10+ y pruebas de endpoints FastAPI. Integración contra servicios reales, extremo a extremo, carga y estrés quedan fuera de esta versión.

Para el equipo de desarrollo

Cómo preparar el entorno, ejecutar las pruebas, construir el instalador y publicar una versión: docs/desarrollo.md. Las reglas del proyecto están en AGENTS.md, las decisiones técnicas en docs/decisiones/ y las notas de cada versión en docs/releases/.

Equipo

Proyecto del curso Taller Integrador I, Ingeniería de Sistemas e Inteligencia Artificial, Universidad Privada Antenor Orrego (UPAO).

Castillo Pezo, Mateo · Oncoy Patricio, Angel · Rodríguez Malca, Rodrigo · Sanchez Vargas, Adrián

Licencia

MIT.