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=1añ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.
<syntaxhighlight lang="lua" style="margin-left:1.5em; width:auto;">
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.
<syntaxhighlight lang="lua" style="margin-left:1.5em; width:auto;">
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.
<syntaxhighlight lang="lua" style="margin-left:1.5em; width:auto;">
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
<syntaxhighlight lang="lua" style="margin-left:1.5em; width:auto;">
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.
<syntaxhighlight lang="lua" style="margin-left:1.5em; width:auto;">
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.