app.services.excel_io¶
Integración con Excel: plantilla, importación y exportación de casos, y exportación de resultados (.xlsx).
Qué lo hace una integración funcional y no solo un archivo
- IMPORTA casos desde un Excel con validaciones fila por fila (mismas reglas que la API y la política SQL), con modo de simulación (sin guardar) y todo-o-nada: si hay un solo error no se importa nada.
- EXPORTA casos y resultados (con color por PASS/FAIL/ERROR) para revisarlos o compartirlos.
- Es un ciclo completo: plantilla -> importar -> ejecutar (UI/CLI) -> exportar resultados.
Seguridad de los archivos
- Se rechazan las fórmulas (una celda con fórmula no se importa) y los archivos con macros o demasiado grandes.
- Al exportar, el texto que empiece por = + - @ se escribe como TEXTO literal, nunca como fórmula (inyección de fórmulas).
- No se leen enlaces externos y los archivos se procesan en memoria, sin escribir en disco.
MAX_BYTES = 2 * 1024 * 1024
module-attribute
¶
MAX_UNCOMPRESSED = 25 * 1024 * 1024
module-attribute
¶
MAX_ROWS = 500
module-attribute
¶
MAX_CELL = 30000
module-attribute
¶
SHEET_CASES = 'Casos'
module-attribute
¶
XLSX_MEDIA_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
module-attribute
¶
COLUMNS = [('nombre', 'Nombre'), ('descripcion', 'Descripción'), ('sql', 'SQL'), ('validacion', 'Validación'), ('esperado', 'Esperado'), ('suites', 'Suites')]
module-attribute
¶
REQUIRED = ('nombre', 'sql', 'validacion', 'esperado')
module-attribute
¶
VALIDATION_ALIASES = {'ROW_COUNT': {'row_count', 'cantidad de filas', 'filas', 'cantidad'}, 'SCALAR_VALUE': {'scalar_value', 'valor', 'valor escalar', 'valor que devuelve la consulta'}, 'EXISTS': {'exists', 'existencia', 'existe'}}
module-attribute
¶
HEADER_FILL = PatternFill('solid', fgColor='1F4E78')
module-attribute
¶
STATUS_FILL = {'PASS': PatternFill('solid', fgColor='C6EFCE'), 'FAIL': PatternFill('solid', fgColor='FFEB9C'), 'ERROR': PatternFill('solid', fgColor='FFC7CE')}
module-attribute
¶
ExcelError
¶
Bases: Exception
Archivo inválido en su conjunto (no es un .xlsx, es demasiado grande, falta la hoja…).
build_template()
¶
build_cases_file(rows)
¶
Libro de casos listo para importar a partir de tuplas (nombre, descripción, sql, validación, esperado, suites).
export_cases(db, project_id)
¶
export_results(db, project_id=None, suite_id=None, status=None, days=None, limit=5000, run_id=None)
¶
parse_cases(content)
¶
Lee y valida el Excel. Devuelve (filas_validas, errores). No toca la base de datos.
import_cases(db, project_id, content, mode='skip', dry_run=False, source='UI')
¶
Importa casos. mode = 'skip' (omite los que ya existen por nombre) o 'update' (los actualiza). Todo o nada: si hay algún error de validación no se guarda nada.