Skip to content

TESTING.md

Latest commit

 

History

History
96 lines (74 loc) · 3.77 KB

TESTING.md

File metadata and controls

96 lines (74 loc) · 3.77 KB

Guía de pruebas (ScanTailor Advanced)

Ejecutar tests unitarios

Con el proyecto configurado con BUILD_TESTS=ON (por defecto):

mkdir build && cd build
cmake .. -DBUILD_TESTS=ON
cmake --build .
ctest --output-on-failure

O ejecutar cada suite por separado:

./core_tests --log_level=message
./foundation_tests --log_level=message
./math_tests --log_level=message
./imageproc_tests --log_level=message
./qt_tests

Cobertura por módulo

core_tests

  • ContentSpanFinder: detección de intervalos de contenido.
  • DeskewParams: parámetros del filtro de enderezado.
  • ImageId / PageId: identificación de imágenes y páginas, orden, subpáginas.
  • Margins: márgenes y serialización XML.
  • PageRange: rangos de páginas y selección alternada.
  • SelectContentApply: aplicación del filtro de contenido.
  • SmartFilenameOrdering: ordenación natural de nombres de archivo.
  • Units: conversión y representación de unidades (px, mm, cm, in).

foundation_tests

  • Constants: constantes matemáticas (PI, conversiones DPI/DPM, grados/radianes).
  • LineIntersectionScalar: intersección de líneas (escalares).
  • Proximity: distancia entre puntos y punto-segmento.
  • Utils: conversión numérica a cadena (locale independiente).

math_tests

  • Hessians (adiff): diferenciación automática.
  • LineBoundedByRect: recorte de recta por rectángulo.
  • LinearFunction / QuadraticFunction: funciones lineales y cuadráticas.
  • MatrixCalc: operaciones matriciales.
  • SidesOfLine: lado de una recta (puntos).
  • SqDistApproximant: aproximación de distancia al cuadrado.

imageproc_tests

  • BinaryImage, Binarize, Morphology, RasterOp, Scale, Shear, Transform, etc.
  • Dpi: resolución (DPI) y serialización XML.

qt_tests (Qt Test)

  • Tests de lógica (TestCoreQt): Units, foundation::Utils, SmartFilenameOrdering, QSignalSpy (señales y argumentos).
  • Tests de UX (TestUxQt):
    • testButtonClickEmitsSignal: clic en QPushButton emite clicked() (simulación con QTest::mouseClick).
    • testCheckBoxToggleChangesState: cambio de estado con setChecked y señal toggled.
    • testLineEditAcceptsInput: entrada de texto con QTest::keyClicks y comprobación del texto.
    • testCollapsibleGroupBoxStateAndSignal: widget del proyecto: estado colapsado/expandido y señal collapsedStateChanged.
    • testErrorWidgetCreation: creación de ErrorWidget y comprobación de hijos (sin mostrar ventana).

Los tests de UX usan QApplication y pueden simular interacción (clic, teclado) sin abrir ventanas; sirven de base para ampliar con más widgets o diálogos.

Tests de UI/UX y caminos de uso

Actualmente no hay tests automatizados de interfaz ni de flujos completos de uso. Para mejorar la cobertura de UX y caminos de uso se puede:

  1. Qt Test: Añadir un ejecutable de tests que use QTest para:

    • Crear widgets/diálogos sin mostrar ventana.
    • Simular eventos (clic, teclado) y comprobar estado.

  2. Tests de integración: Scripts o tests que:

    • Abran proyectos de ejemplo.
    • Ejecuten filtros y comprueben resultados en disco o en memoria.

  3. Tests E2E: Herramientas como Squish o scripts que controlen la aplicación gráfica (más costosos de mantener).

Para medir cobertura de código con gcov/lcov (solo compiladores que lo soporten):

cmake .. -DCMAKE_BUILD_TYPE=Debug -DBUILD_TESTS=ON -DCMAKE_CXX_FLAGS="--coverage"
cmake --build .
ctest
lcov --capture --directory . --output-file coverage.info
lcov --remove coverage.info '/usr/*' --output-file coverage.info
genhtml coverage.info --output-directory coverage_html

Desactivar tests

En entornos sin Boost o sin dependencias de test:

cmake .. -DBUILD_TESTS=OFF