Saltar a contenido

app.engine.validator

Módulo de validación para el Framework de Pruebas. Implementa el Patrón Strategy para evaluar dinámicamente los resultados de la ejecución SQL contra los criterios esperados.

ValidationStrategy

Bases: ABC

Interfaz base que define el contrato para cualquier regla de validación.

evaluate(execution_data, expected_value) abstractmethod

Evalúa el resultado devuelto por la base de datos contra el valor esperado.

Parameters:

Name Type Description Default
execution_data Any

Resultado entregado por TargetDatabaseExecutor (dict, list o número).

required
expected_value str

El valor configurado en el caso de prueba.

required

Returns:

Name Type Description
bool bool

True si la prueba pasa (PASS), False si falla (FAIL).

RowCountValidation

Bases: ValidationStrategy

Estrategia para validar la cantidad exacta de filas devueltas (SELECT) o afectadas (DML).

evaluate(execution_data, expected_value)

ExistenceValidation

Bases: ValidationStrategy

Estrategia para validar si la consulta devolvió registros o afectó filas.

evaluate(execution_data, expected_value)

ValidationContext

Contexto principal que recibe la data de ejecución y delega la evaluación a la estrategia inyectada en tiempo de ejecución.

set_strategy(strategy)

Permite cambiar la estrategia de validación dinámicamente.

execute_validation(execution_data, expected_value)

Ejecuta la evaluación utilizando la estrategia actual.

ScalarValueValidation

Bases: ValidationStrategy

Valida el valor de la primera columna de la ÚNICA fila devuelta por un SELECT. No supera la validación si la consulta falla, devuelve 0 filas o más de una fila.

evaluate(execution_data, expected_value)

format_scalar(value)

Texto estable de un valor escalar (sin notación científica ni ceros sobrantes).

scalar_equals(value, expected)

Compara numéricamente si ambos son números; en otro caso, como texto exacto.