Mòdul:UnitTests/ús

Aquesta és una subpàgina de documentació per a la Mòdul:UnitTests
Té la informació d'ús, les categories i qualsevol altre contingut que no forma part essencial del codi del mòdul.

UnitTests proporciona unes proves unitàries que poden ser usades per altres scripts utilitzant require. Per exemple, de Mòdul:Demo/tests:

-- Tests per [[Mòdul:Demo]]. El resultat és a la pàgina de discussió.
local p = require('Mòdul:UnitTests')

function p:test_hola()
    self:preprocess_equals('{{#invoke:Demo | hola}}', 'Hola, món!')
end

return p

En la pàgina de discussió Mòdul Discussió:Demo/tests s'executen els casos de prova amb {{#invoke: Demo/tests | run_tests}}. Els mètodes de prova com test_hola de més amunt han de començar amb "test".

Mètodes

run_tests(differs_at): Executa tots els tests. Si s'especifica <differs_at=1> s'afegirà una columna mostrant la posició del primer caràcter on es produeix la diferència entre el resultat esperat i el real. Normalment s'utilitza en la pàgina de discussió de tests.

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

preprocess_equals(text, esperat): preprocessa un <text> wiki i el compara amb el resultat <esperat>. Els scripts i les plantilles es poden invocar de la mateixa forma que es faria en una pàgina.

    self:preprocess_equals('{{#invoke:Demo | hola}}', 'Hola, món!')

preprocess_equals_many(prefix, sufix, casos): Executa una sèrie de preprocess_equals() sobre un conjunt de <casos> format per parelles de valors als que s'afegirà un <prefix> i un <sufix> a cada parella.

    self:preprocess_equals_many('{{#invoke:DemoArgs | suma |', '}}', {
        {'2|3', '5'},
        {'-2|2', '0'},
    })

preprocess_equals_preprocess(text, esperat): Compara si <text> i <esperat> són iguals després de preprocessar-los tots dos. Pot ser útil per compara un script amb una plantilla existent.

    self:preprocess_equals_preprocess('{{#invoke:Demo | hola}}', '{{Hola}}')

preprocess_equals_preprocess_many(prefix, sufix, casos): Executa una sèrie de preprocess_equals_preprocess() sobre un conjunt de <casos> formats per parelles de valors. Afegeix automàticament el <prefix> i <sufix> proporcionats. Si en algun dels casos no es proporciona el segon valor, utilitza en el seu lloc el primer.

    self:preprocess_equals_many('{{#invoke:Foo | spellnum |', '}}', '{{spellnum', '}}', {
        {'2'}, -- equivalent a {'2','2'},
        {'-2', '-2.0'},
    })

equals(funció, valor, esperat): Executa la <funció> amb el <valor> i compara el resultat amb l'<esperat>. Pot ser útil per provar mòduls pensats per ser usats per altres mòduls més que invocant-los amb #invoke.

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