Módulo:UnitTests/doc

Esta es la página de documentación de Módulo:UnitTests

UnitTests proporciona una prueba unitaria que poden ser usadas por otros scripts utilizando require. Por ejemplo en Módulo:Demo/tests:

<syntaxhighlight lang="lua"> -- Tests por Module:Prueba. El resultado está en la página de discusión. local p = require('Module:UnitTests')

function p:test_hola()

   self:preprocess_equals('Error en la secuencia de órdenes: no existe el módulo «Prueba».', '¡Hola mundo!')

end

return p </syntaxhighlight>

En la página Módulo discusión:Demo/tests se puede ver el resultado de ejecutar los casos de prueba con {{#invoke: Demo/tests | run_tests}}. Los métodos de prueba como test_hola de más arriba deben empezar con "test".

Métodos

run_tests

run_tests(): Ejecuta todos los tests. Normalmente se utiliza en la página de discusión de tests.

    {{#invoke:Prueba/tests|run_tests}}

Si se especifica differs_at=1 añadirá una columna mostrando la posición del primer carácter donde se produce la diferencia entre el resultado esperado y el real.

    {{#invoke:Example/testcases|run_tests|differs_at=1}}

preprocess_equals

preprocess_equals(text, esperado): Preprocesa un wikitexto <text> y lo compara con el resultado <esperado>. Los scripts y las plantillas se pueden invocar de la misma forma que se haría en una página.

   self:preprocess_equals('Error en la secuencia de órdenes: no existe el módulo «Prueba».', '¡Hola mundo!')

</syntaxhighlight>

preprocess_equals_many

preprocess_equals_many(prefijos, sufijos, casos): Ejecuta una serie de preprocess_equals() sobre un conjunto de <casos> formado por parejas de valores a los que se añadirá un <prefijo> y un <sufijo> a cada pareja.

   self:preprocess_equals_many('Error de Lua en Módulo:DemoArgs en la línea 20: attempt to perform arithmetic on local 'num1' (a nil value).', {
       {'2|3', '5'},
       {'-2|2', '0'},
   })

</syntaxhighlight>

preprocess_equals_preprocess

preprocess_equals_preprocess(text, esperat): Compara si <text> y <esperar> son iguales después de preprocesar a los dos. Puede ser útil para compara un script con una plantilla existente.

   self:preprocess_equals_preprocess('Error en la secuencia de órdenes: no existe el módulo «Prueba».', 'Plantilla:Hola')

</syntaxhighlight>

preprocess_equals_preprocess_many

preprocess_equals_preprocess_many(prefijo, sufijo, casos): Ejecuta una serie de preprocess_equals_preprocess() sobre un conjunto de <casos> formados por parejas de valores. Añade automáticamente el <prefijo> y <sufijo> proporcionado. Si en alguno de los casos no se proporciona el segundo valor, utiliza en su lugar el primero

   self:preprocess_equals_many('Error en la secuencia de órdenes: no existe el módulo «Foo».', 'Plantilla:Spellnum', '', {
       {'2'}, -- equivale a {'2','2'},
       {'-2', '-2.0'},
   })

</syntaxhighlight>

equals

equals(función, valor, esperado): Ejecuta la <función> con el <valor> y compara el resultado con el <esperado>. Puede ser útil para probar módulos pensados para ser usados por otros módulos más que invocando los mismos con #invoke.

   self:equals('Suma simple', 2 + 2, 4)

</syntaxhighlight>

Categorización automática

Los módulos que no superan alguna prueba se incluyen automáticamente en la categoría:Wikipedia:Módulos con pruebas erróneas.