Saltar a contenido

app.cli

CLI del Framework de pruebas SQL: ejecutar casos y suites desde la terminal o desde un flujo de CI y obtener un código de salida útil, además de importar/exportar Excel.

Uso (desde la carpeta framework-pruebas-sql): python -m app.cli init-db python -m app.cli import-excel checks/reglas_demo.xlsx --project "Demo" --create-project --dry-run --mode update python -m app.cli run --project "Demo" --suite "Reglas de calidad" --host 127.0.0.1 --port 1521 --service FREEPDB1 --user FRAMEWORK_TEST --env TEST --junit reportes/sql.xml --markdown reportes/sql.md --json reportes/sql.json python -m app.cli export-excel results --project "Demo" --out resultados.xlsx

La contraseña de Oracle NUNCA se pasa por argumento: se lee de una variable de entorno (por defecto FW_ORACLE_PASSWORD, configurable con --password-env). La base interna (SQLite) se elige con --db o con FRAMEWORK_DB_URL.

Códigos de salida de run (pensados para usar la CLI como compuerta en CI): 0 todas las comprobaciones dieron PASS 1 al menos una dio FAIL y ninguna dio ERROR 2 al menos una dio ERROR (no se pudo ejecutar o evaluar), aunque haya FAIL 3 uso o configuración inválidos (proyecto o suite inexistente, falta la contraseña, argumentos incorrectos…) 4 no había casos que ejecutar Los demás comandos devuelven 0 si salen bien, 1 si el Excel tiene errores de validación y 3 si el uso es inválido.

Cada ejecución queda en el historial con origen CLI (o GITHUB_ACTIONS cuando corre dentro de un flujo de GitHub).

PROJECT_ROOT = Path(__file__).resolve().parents[1] module-attribute

COMMANDS = {'init-db': cmd_init_db, 'import-excel': cmd_import_excel, 'export-excel': cmd_export_excel, 'run': cmd_run} module-attribute

UsageError

Bases: Exception

Argumentos o entorno inválidos (código de salida 3).

junit_xml(results, suite_name, project, run_id, source)

markdown_report(results, meta, exit_code)

cmd_init_db(args, session_factory)

cmd_import_excel(args, session_factory)

cmd_export_excel(args, session_factory)

cmd_run(args, session_factory)

build_parser()

main(argv=None, session_factory=None)