Saltar a contenido

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