Módulo:UnitTests/doc

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

-- 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('{{#invoke:Prueba|hola}}', '¡Hola mundo!')
end

return p

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('{{#invoke:Prueba|hola}}', '¡Hola mundo!')

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('{{#invoke:DemoArgs | suma |', '}}', {
        {'2|3', '5'},
        {'-2|2', '0'},
    })

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('{{#invoke:Prueba|hola}}', '{{Hola}}')

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('{{#invoke:Foo | spellnum |', '}}', '{{spellnum', '}}', {
        {'2'}, -- equivale a {'2','2'},
        {'-2', '-2.0'},
    })

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)

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.