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).