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