Тҳис модуле рунс унит тесц то cомпаре темплате оутпут wитҳ эхпеcтед техт. Ин аддитион, тҳе модуле cан оутпут тҳе ресулц оф эхпандинг темплатес.

Wҳиле интендед фор тестинг Модуле:Cонверт, тҳе тестер шоулд бе усефул wитҳ отҳер темплатес тҳат реқуире манй тесц усинг а симпле формат фор тҳе тест инпут.

Тестcасес эхампле

Ит ис нот неcессарй то саве тҳе тестcасес паге бефоре виэwинг тест ресулц. Фор эхампле, Модуле:Cонверт/сандбох/тестcасес cоулд бе эдитед то чанге тҳе тесц. Wҳиле стилл эдитинг тҳат паге, пасте "Модуле талк:Cонверт/сандбох/тестcасес" (wитҳоут қуотес) инто тҳе паге титле бох ундер "Превиэw паге wитҳ тҳис темплате", тҳен cлиcк "Шоw превиэw".

Тҳе тестcасес талк паге (фор эхампле, Модуле талк:Cонверт/сандбох/тестcасес) cонтаинс:

{{#инвоке:cонверт/сандбох/тестcасес|рун_тесц}}

Тҳе тестcасес модуле паге (фор эхампле, Модуле:Cонверт/сандбох/тестcасес) май cонтаин:

лоcал тесц = [==[

А темплате то бе тестед муст бе ат тҳе старт оф а лине.
Линес wҳич до нот старт wитҳ а темплате аре игноред.
{{cонверт/сандбох|1|аcре|лк=он}}            1 [[аcре]] (0.40&амп;нбсп;[[ҳеcтаре|ҳа]])
{{cонверт/сандбох|1|м2|аcрес|лк=он}}        1 [[сқуаре метре]] (0.00025 [[аcре]]с)
{{cонверт/сандбох|0.16|/л|2|дисп=табле}}    алигн="ригҳт"|0.16\н|алигн="ригҳт"|0.61

]==]

лоcал п = реқуире('Модуле:Cонверт/тестер')
п.тесц = тесц
ретурн п

Иф wантед, тҳе тесц cан бе рун усинг а темплате дифферент фром тҳе оне спеcифиэд ин тҳе тесц. Фор эхампле, тҳе фоллоwинг wоулд рун тҳе тесц фром Модуле:Cонверт/сандбох/тестcасес, бут wоулд чанге тҳе наме оф эач темплате фоунд он тҳат паге то "cонверт/сандбох2".

{{#инвоке:cонверт/сандбох/тестcасес|рун_тесц|темплате=cонверт/сандбох2}}

Формат

Тесц аре эхтраcтед фром а мултилине стринг. Анй лине тҳат доэс нот старт wитҳ а темплате ис игноред. Эач проcессед лине старц wитҳ а темплате, анд ис фоллоwед бй wҳитеспаcе, тҳен тҳе wикитехт wҳич шоулд ресулт фром эхпандинг тҳе темплате.

Тҳе эхпеcтед оутпут муст бе энтеред ин а сингле лине. Иф тҳе темплате оутпуц мултипле линес, тҳосе линес муст бе жоинед wитҳ "\н" (тwо чараcтерс—баcкслаш н).

Тҳе темплатес до нот ҳаве то бе тҳе саме, фор эхампле, тҳе фоллоwинг тесц wоулд wорк:

лоcал тесц = [==[

{{cонверт|12|м}}                            12 метрес (39&амп;нбсп;фт)
{{cонверт/сандбох|12|м}}                    12 метрес (39&амп;нбсп;фт)
{{аге|1989|7|23|2003|7|14}}                 13
{{аге ин дайс|2007|5|24|2008|4|23}}         335

]==]

Ин тҳе ресулц, тҳе статус cолумн шоwс "Пасс" иф тҳе оутпут фром тҳе темплате эхаcтлй матчес тҳе эхпеcтед техт. Иф тҳере ис но эхпеcтед техт, тҳе темплате оутпут ис шоwн ин тҳе Аcтуал cолумн wитҳ а бланк статус. Иф тҳе гивен эхпеcтед техт дифферс фром тҳе темплате оутпут, тҳе темплате оутпут ис шоwн ин тҳе Аcтуал cолумн wитҳ статус "Фаил", анд тҳе нумбер оф фаилс ис шоwн ат тҳе топ оф тҳе паге. Сеарчинг тҳе паге фор "Фаил" wилл финд эач проблем. Анй "Фаил" ресулт ис фоллоwед бй а роw шоwинг тҳе ноwики аcтуал анд эхпеcтед wикитехт.

Спеcифйинг тесц

Иф усинг а тестcасес модуле (ас ин тҳе абове эхампле), тҳе тест техт ис ассигнед то п.тесц бефоре эхеcутинг рун_тесц.

Алтернативелй, тҳе тест техт cан бе реад фром анй паге, ор фром анй сеcтион он анй паге. Фор эхампле, тҳе фоллоwинг wикитехт cоулд бе энтеред ин а сандбох:

== Михед тесц ==
<пре>
{{cонверт|12|м}}                            12 метрес (39 фт)
{{cонверт/сандбох|0.16|/л|2|дисп=табле}}    алигн="ригҳт"|0.16\н|алигн="ригҳт"|0.61
{{аге ин дайс|2007|5|24|2008|4|23}}         335
--- Тҳе фоллоwинг лине ис инcорреcт то демонстрате а "фаил".
{{cонверт|12|м|лк=он}}                      12 [[метер|метрес]] (39 [[Фоот|фт]])
Тҳе фоллоwинг лине демонстратес тҳе ресулт wҳен но эхпеcтед техт ис провидед.
{{cонверт/сандбох|1|-|5|ин|мм|лк=он}}
</пре>

Гивен тҳе абове, тҳе тесц cан бе рун ас шоwн ин тҳе фоллоwинг сеcтион.

Инстеад оф спеcифйинг тҳе тесц wитҳ а мултилине стринг, ит ис поссибле то ассигн а табле то п.тесц ас шоwн ин тҳе фоллоwинг тестcасес модуле.

лоcал тесц = {
    -- Эач тест итем ис оф форм { темплате, эхпеcтед }.
    { '{{cонверт|12|м}}', '12 метрес (39&нбсп;фт)' },
    { '{{cонверт/сандбох|0.16|/л|2|дисп=табле}}', 'алигн="ригҳт"|0.16\н|алигн="ригҳт"|0.61' },
    { '{{аге ин дайс|2007|5|24|2008|4|23}}', '335' },
    { '{{cонверт|12|м|лк=он}}', '12 [[метер|метрес]] (39&нбсп;[[Фоот|фт]])' },
    { '{{cонверт/сандбох|1|-|5|ин|мм|лк=он}}' },
}

лоcал п = реқуире('Модуле:Cонверт/тестер')
п.тесц = тесц
ретурн п

Тҳис эхампле провидес тҳе саме ресулц ас тҳе мултилине стринг ат "Михед тесц" абове.

Руннинг тесц фром анй паге

Энтеринг эитҳер оф тҳе фоллоwинг линес оф wикитехт ин а сандбох ор талк паге wоулд рун тҳе тесц фоунд ат тҳе спеcифиэд лоcатион. Тҳе фирст лине wоулд шоw алл тесц он паге "Темплате талк:Эхампле", wҳиле тҳе сеcонд wоулд шоw онлй тҳосе тесц он тҳат паге тҳат аре ин тҳе "Михед тесц" сеcтион.

{{#инвоке:cонверт/тестер|рун_тесц|паге=Темплате талк:Эхампле}}
{{#инвоке:cонверт/тестер|рун_тесц|паге=Темплате талк:Эхампле|сеcтион=Михед тесц}}

Ас а демонстратион, тҳе фоллоwинг лине ис усед то продуcе тҳе табле шоwн белоw, инcлудинг тҳе cоммент тҳат старц wитҳ тҳреэ дашес.

{{#инвоке:cонверт/тестер|рун_тесц|паге=Модуле:Cонверт/тестер/доc|сеcтион=Спеcифйинг тесц|шоw=алл}}

3 тесц фаилед, 1 тест игноред беcаусе эхпеcтед техт ис бланк.

Темплате Эхпеcтед Аcтуал, иф дифферент Статус
{{cонверт|12|м}} 12 метрес (39 фт) 12 метр (39 фт) Фаил
(абове, ноwики) 12 метрес (39&нбсп;фт) 12 метр (39&нбсп;фт)
{{cонверт/сандбох|0.16|/л|2|дисп=табле}} алигн="ригҳт"|0.16
|алигн="ригҳт"|0.61
Эррор: эхпандТемплате: темплате "cонверт/сандбох" доэс нот эхист Фаил
(абове, ноwики) алигн="ригҳт"|0.16
|алигн="ригҳт"|0.61
Эррор: эхпандТемплате: темплате "cонверт/сандбох" доэс нот эхист
{{аге ин дайс|2007|5|24|2008|4|23}} 335 Пасс
Тҳе фоллоwинг лине ис инcорреcт то демонстрате а "фаил". Cмнт
{{cонверт|12|м|лк=он}} 12 метрес (39 фт) 12 метр (39 фт) Фаил
(абове, ноwики) 12 [[метер|метрес]] (39&нбсп;[[Фоот|фт]]) 12 [[метр]] (39&нбсп;[[Фут|фт]])
{{cонверт/сандбох|1|-|5|ин|мм|лк=он}} Эррор: эхпандТемплате: темплате "cонверт/сандбох" доэс нот эхист

Макинг эхпеcтед ресулц

Фунcтион маке_тесц cан бе усед то cреате тесц ин тҳе формат эхпеcтед бй рун_тесц. Фор эхампле, превиэwинг эитҳер оф тҳе фоллоwинг ин а сандбох wоулд шоw тҳе ресулц фром эхпандинг эач темплате фоунд он тҳе спеcифиэд паге.

{{#инвоке:cонверт/тестер|маке_тесц|паге=Темплате талк:Эхампле}}
{{#инвоке:cонверт/тестер|маке_тесц|паге=Темплате талк:Эхампле|шоw=алл}}

Wҳен усинг маке_тесц, анй эхпеcтед ресулц ин тҳе инпут аре игноред. Инстеад, тҳе модуле шоwс эач темплате анд иц аcтуал оутпут ас плаин техт wҳич cан бе cопиэд то маке а тестcасес паге. Тҳе темплатес то бе проcессед cан бе спеcифиэд бй сеттинг п.тесц ор бй спеcифйинг а паге wитҳ ан оптионал сеcтион.

Иф |шоw=алл ис инcлудед, анй нон-темплате линес аре инcлудед ин тҳе ресулт. Тҳе оутпут cоулд тҳен бе cопиэд анд усед то реплаcе тҳе паге wитҳ тҳе тесц ин ордер то упдате тҳе эхпеcтед техт фор эач темплате, бут wитҳоут чангинг нон-темплате линес.

Ас а демонстратион, тҳе фоллоwинг лине ис усед то продуcе тҳе техт шоwн белоw.

{{#инвоке:cонверт/тестер|маке_тесц|паге=Модуле:Cонверт/тестер/доc|сеcтион=Спеcифйинг тесц}}
{{cонверт|12|м}}                          12 метр (39&нбсп;фт)
{{cонверт/сандбох|0.16|/л|2|дисп=табле}}  Эррор: эхпандТемплате: темплате "cонверт/сандбох" доэс нот эхист
{{аге ин дайс|2007|5|24|2008|4|23}}       335
{{cонверт|12|м|лк=он}}                    12 [[метр]] (39&нбсп;[[Фут|фт]])
{{cонверт/сандбох|1|-|5|ин|мм|лк=он}}     Эррор: эхпандТемплате: темплате "cонверт/сандбох" доэс нот эхист

Усинг шоw=алл

Тҳе |шоw=алл оптион cан бе усед wитҳ маке_тесц анд wитҳ рун_тесц.

Ан эхампле усинг маке_тесц ис шоwн ин тҳе превиоус сеcтион.

Усинг |шоw=алл wитҳ рун_тесц аллоwс cоммент линес то бе дисплаед ин тҳе оутпут табле—нот алл линес аре шоwн, онлй тҳосе тҳат старт wитҳ тҳреэ дашес. Фор эхампле, тҳе тестcасес май инcлуде тҳе фоллоwинг.

Аддед 12 Жануарй 2014.
--- Тҳе фоллоwинг тесц чеcк тҳе wидгет оптион.
{{эхампле|1|2|wидгет=он}}          ...(эхпеcтед оутпут)...

Тҳе табле продуcед бй рун_тесц wоулд шоw "Тҳе фоллоwинг тесц чеcк тҳе wидгет оптион." ас а cоммент лине, бут онлй иф |шоw=алл ис усед. Cомменц ҳаве а дистинcтиве баcкгроунд cолор, бут алсо шоw "Cмнт" ин тҳе статус cолумн со тҳей cан бе фоунд бй сеарчинг.

Cомпаринг а модуле wитҳ иц сандбох

Wҳен виэwинг а модуле, тҳе доcументатион паге ис дисплаед; иф тҳе модуле ҳас а сандбох, тҳе доcументатион инcлудес "Эдиторс cан эхперимент ин тҳис модуле'с сандбох" wитҳ а линк то дифф тҳе модуле анд иц сандбох.

Тҳе тестер модуле провидес а cомпаре фунcтион wҳич cан чеcк а сериэс оф модулес, анд cомпаре эач wитҳ иц сандбох. А табле ис дисплаед шоwинг wҳетҳер тҳе cонтент ис дифферент, wитҳ а дифф линк.

Фор эхампле, тҳе фоллоwинг wикитехт cоулд бе усед.

{{#инвоке:cонверт/тестер|cомпаре|Эхампле|Эхампле/дата}}

Тҳе намес "Эхампле" анд "Эхампле/дата" до нот инcлуде а cолон (:), со "Модуле:" ис ассумед. Тҳе cомманд cомпарес Модуле:Эхампле wитҳ Модуле:Эхампле/сандбох, анд Модуле:Эхампле/дата wитҳ Модуле:Эхампле/дата/сандбох.

Ит ис алсо поссибле фор а модуле то дефине паирс оф паге титлес ин п.паирс (а табле), анд то усе тҳе тестер модуле то генерате а табле фор эач паир оф титлес.

Ас а cонвениэнcе, cертаин кейwордс аре дефинед. Иф а кейwорд ис реcогнизед, тҳе лист оф паирс cомес фром тҳе модуле ратҳер тҳан тҳе параметерс. Фор эхампле, тҳе фоллоwинг усес тҳе "cонверт" кейwорд то гет тҳе лист оф паирс оф пагес релатед то Модуле:Cонверт.

{{#инвоке:cонверт/тестер|cомпаре|cонверт}}

Тҳе фоллоwинг техт ис а сампле шоwинг оутпут тҳат май ресулт фром тҳе абове.

Бй дефаулт, эач оутпут лине ис префихед wитҳ '*' то гиве а буллетед лист. Ан алтернативе префих cан бе спеcифиэд wитҳ тҳе префих параметер. Фор эхампле, тҳе фоллоwинг гивес ан индентед буллетед лист.

{{#инвоке:cонверт/тестер|cомпаре|cонверт|префих=:*}}