Configurar Pytest
Estado del adapter: ⛔ STUB. El adapter de Pytest está documentado pero no implementado. pytest figura como valor válido en qa-stack.yaml y lippia-neo-bootstrap-stack lo detecta, pero las skills que necesitan el adapter se detienen apenas arrancan:
Adapter pytest en estado STUB.
Ver <skill_root>/adapters/pytest/STUB.md para contribuir.
Valor en qa-stack.yaml |
test_framework: pytest |
| Lenguaje | python |
| Tipo de app previsto | Principalmente api. Pytest no tiene navegador propio, y el caso de pytest-playwright no está cubierto |
| Carpeta de tests por defecto | tests/pytest/ |
1. Qué funciona hoy y qué no
| Skill | ¿Funciona con test_framework: pytest? |
|---|---|
lippia-neo-bootstrap-stack |
✅ Detecta Pytest (pyproject.toml, setup.cfg o requirements.txt con pytest) y genera qa-stack.yaml |
lippia-neo-read-user-story, lippia-neo-create-test-plan y el resto de las skills que no tocan código de tests |
✅ No dependen del framework |
lippia-neo-generate-test-suite |
⛔ Se detiene: no puede generar tests |
lippia-neo-run-and-heal |
⛔ Se detiene: no puede ejecutar ni reparar tests |
| Playbooks que generan o ejecutan tests (Feature End-to-End, Bug Fix Cycle, Smoke Test, Hotfix…) | ⛔ Se frenan en el primer paso que usa esas skills |
Mientras tanto: si lo que necesitás es probar una API, el adapter de Playwright genera y ejecuta tests de API (
app_type: api) sin navegador. Ver Configurar Playwright.
2. Dejar el proyecto preparado
Si tu proyecto es Python y querés dejarlo listo para cuando el adapter esté implementado, podés generar qa-stack.yaml desde ya:
stack:
test_framework: pytest
language: python
app_type: api
auth: api_token
pipeline_provider: gitlab
environment:
base_url: https://api.techstore-staging.com
app_version: sprint-24
os: Ubuntu 22.04
api_contract:
spec_path: openapi.yaml
spec_url: null
paths:
user_stories_storage:
type: local
cloud_provider_mcp: null
local_path: user-stories/
test_plans_dir: test-plans/
tests_dir: tests/pytest/
reports_dir: test-results/
env_file: .env.tests
commands:
run_tests: pytest --junitxml=test-results/results.xml
install_deps: pip install -r requirements.txt
Y tener instalado:
| Herramienta | Versión prevista |
|---|---|
| Python | 3.9 o superior |
pytest |
— |
pytest-json-report |
Para generar el JSON que va a leer parse-results.sh |
httpx (o requests) |
Para los tests de API |
pip install pytest pytest-json-report httpx
3. Cómo va a funcionar (diseño previsto)
Según el contrato documentado en los STUB.md de cada skill, cuando se implemente el adapter:
| Aspecto | Diseño previsto |
|---|---|
| Archivos generados | tests/<US-ID>/test_tc_NN_<slug>.py, con funciones en snake_case |
| Autenticación | Fixtures de conftest.py con httpx.Client: uno con el token de manager y otro con el de viewer |
| Credenciales | Por variables de entorno (API_BASE_URL, API_TOKEN_MANAGER, API_TOKEN_VIEWER, QA_API_TOKEN), nunca literales |
| Limpieza | Un fixture autouse=True que borra los recursos creados por los tests |
| Aserciones | assert estándar de Python |
| Comando de ejecución | pytest <tests_dir> --junitxml=test-results/results.xml --json-report --json-report-file=test-results/results.json -v |
| Resultados | parse-results.sh convierte test-results/results.json al formato común de NEO |
Ejemplo de la plantilla prevista para un test de API:
import os
import pytest
import httpx
BASE_URL = os.environ["API_BASE_URL"]
TOKEN_MANAGER = os.environ["API_TOKEN_MANAGER"]
@pytest.fixture
def manager_client():
headers = {"Authorization": f"Bearer {TOKEN_MANAGER}", "Content-Type": "application/json"}
with httpx.Client(base_url=BASE_URL, headers=headers) as client:
yield client
def test_tc_01_crear_orden_happy_path(manager_client):
response = manager_client.post("/orders/v1", json={"product_id": 42, "quantity": 1})
assert response.status_code == 201
4. Qué falta para completarlo
Para quien quiera contribuir al repositorio de skills, hay que crear:
| Skill | Archivos a crear en adapters/pytest/ |
|---|---|
lippia-neo-generate-test-suite |
README.md (convenciones), test-template.py (plantilla de test de API) y conftest-template.py (fixtures compartidos) |
lippia-neo-run-and-heal |
run.sh (ejecuta pytest), parse-results.sh (convierte el JSON de pytest-json-report al formato común) y README.md |
Cuando exista el README.md en la carpeta del adapter, las skills dejan de considerarlo STUB y lo usan como a cualquier otro. El detalle completo está en skills/lippia-neo-generate-test-suite/adapters/pytest/STUB.md y skills/lippia-neo-run-and-heal/adapters/pytest/STUB.md del repositorio de skills.
5. Problemas comunes (y qué hacer)
| Lo que ves | Por qué pasa | Qué hacer |
|---|---|---|
Adapter pytest en estado STUB |
El adapter todavía no está implementado | Usar Playwright para tests de API mientras tanto, o contribuir con el adapter (sección 4) |
| Un playbook se frena al generar o ejecutar tests | Todos los playbooks usan lippia-neo-generate-test-suite o lippia-neo-run-and-heal |
Mismo caso que el anterior |