Ejecutar Pruebas de Rompecabezas

Ejecutar la suite de pruebas de jigsawR e interpretar resultados.

Cuando Usar

• Despues de modificar cualquier codigo fuente R en el paquete
• Despues de agregar un nuevo tipo de rompecabezas o caracteristica
• Antes de confirmar cambios para verificar que nada esta roto
• Depurar un fallo de prueba especifico

Entradas

• Requerido: Alcance de pruebas (

  full

  ,

  filtered

  o

  single

  )
• Opcional: Patron de filtro (para modo filtrado, ej.

  "snic"

  ,

  "rectangular"

  )
• Opcional: Ruta especifica del archivo de prueba (para modo individual)

Procedimiento

Paso 1: Elegir Alcance de Pruebas

Alcance	Usar cuando	Duracion
Full	Antes de commits, despues de cambios importantes	~2-5 min
Filtered	Trabajando en un tipo de rompecabezas	~30s
Single	Depurando un archivo de prueba especifico	~10s

Esperado: Alcance de pruebas seleccionado segun el flujo de trabajo actual: suite completa antes de commits, filtrada al trabajar en un tipo de rompecabezas especifico, archivo individual al depurar una prueba.

En caso de fallo: Si no esta seguro de que alcance usar, usar suite completa por defecto. Toma mas tiempo pero detecta regresiones entre tipos.

Paso 2: Crear y Ejecutar Script de Prueba

Suite completa:

Crear un archivo de script (ej.,

/tmp/run_tests.R

):

devtools::test()

R_EXE="/mnt/c/Program Files/R/R-4.5.0/bin/Rscript.exe"
cd /mnt/d/dev/p/jigsawR && "$R_EXE" -e "devtools::test()"

Filtrado por patron:

"$R_EXE" -e "devtools::test(filter = 'snic')"

Archivo individual:

"$R_EXE" -e "testthat::test_file('tests/testthat/test-snic-puzzles.R')"

Esperado: Salida de pruebas con conteos de pases/fallos/omisiones.

En caso de fallo:

• NO usar la bandera

  --vanilla

  ; renv necesita

  .Rprofile

  para activarse
• Si hay errores de renv, ejecutar

  renv::restore()

  primero
• Para comandos complejos que fallan con codigo de salida 5, escribir en un archivo de script

Paso 3: Interpretar Resultados

Buscar la linea de resumen:

[ FAIL 0 | WARN 0 | SKIP 7 | PASS 2042 ]

• PASS: Pruebas exitosas
• FAIL: Pruebas fallidas (necesitan investigacion)
• SKIP: Pruebas omitidas (generalmente por paquetes opcionales faltantes como

  snic

  )
• WARN: Advertencias durante pruebas (revisar pero no bloquean)

Esperado: La linea de resumen analizada para identificar conteos PASS, FAIL, SKIP y WARN. FAIL = 0 para una ejecucion de pruebas limpia.

En caso de fallo: Si la linea de resumen no es visible, el ejecutor de pruebas puede haberse detenido antes de completar. Verificar errores a nivel de R sobre el resumen. Si la salida esta truncada, redirigir a un archivo:

"$R_EXE" -e "devtools::test()" > test_results.txt 2>&1

.

Paso 4: Investigar Fallos

Si las pruebas fallan:

1. Leer el mensaje de fallo -- incluye archivo, linea y esperado vs real
2. Verificar si es un fallo nuevo o preexistente
3. Para fallos de asercion, leer la prueba y la funcion siendo probada
4. Para fallos de error, verificar si cambio una firma de funcion

# Run just the failing test with verbose output
"$R_EXE" -e "testthat::test_file('tests/testthat/test-failing.R', reporter = 'summary')"

Esperado: Causa raiz de cada prueba fallida identificada. El fallo es una regresion genuina (el codigo necesita correccion) o un problema del entorno de pruebas (dependencia faltante, problema de ruta).

En caso de fallo: Si el mensaje de fallo no es claro, agregar sentencias

browser()

o

print()

a la prueba y re-ejecutar con

testthat::test_file()

para depuracion interactiva.

Paso 5: Verificar Razones de Omision

Las pruebas omitidas son normales cuando faltan dependencias opcionales:

• Las pruebas del paquete

  snic

  se omiten con

  skip_if_not_installed("snic")

• Las pruebas que requieren un SO especifico se omiten con

  skip_on_os()

• Omisiones solo para CRAN con

  skip_on_cran()

Confirmar que las razones de omision son legitimas, no enmascaran fallos reales.

Esperado: Todas las omisiones se explican por razones legitimas (dependencia opcional no instalada, omision especifica de plataforma, omision solo para CRAN). Ninguna omision enmascara fallos de prueba reales.

En caso de fallo: Si una omision parece sospechosa, eliminar temporalmente la llamada

skip_if_*()

y ejecutar la prueba para ver si pasa o revela un fallo oculto.

Validacion

• Todas las pruebas pasan (FAIL = 0)
• Sin advertencias inesperadas
• El conteo de omisiones coincide con lo esperado (solo omisiones de dependencias opcionales)
• El conteo de pruebas no ha disminuido (ninguna prueba eliminada accidentalmente)

Errores Comunes

• Usar

  --vanilla

  : Rompe la activacion de renv. Nunca usarlo con jigsawR.
• Cadenas

  -e

  complejas: Problemas de escape del shell causan codigo de salida 5. Usar archivos de script.
• Estado del paquete obsoleto: Ejecutar

  devtools::load_all()

  o

  devtools::document()

  antes de probar si cambio codigo que afecta el NAMESPACE.
• Dependencias de prueba faltantes: Algunas pruebas necesitan paquetes sugeridos. Verificar el campo Suggests de

  DESCRIPTION

  .
• Problemas de pruebas paralelas: Si las pruebas interfieren, ejecutar secuencialmente con

  testthat::test_file()

  .

Habilidades Relacionadas

• generate-puzzle

  -- generar rompecabezas para verificar que el comportamiento coincide con las pruebas

• add-puzzle-type

  -- los nuevos tipos necesitan suites de pruebas completas

• write-testthat-tests

  -- patrones generales para escribir pruebas R

• validate-piles-notation

  -- probar el analisis PILES independientemente