Saltar a contenido

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.