patunayan - Online sa Cloud

PROGRAMA:

NAME

patunayan - Magpatakbo ng mga pagsubok sa pamamagitan ng TAP harness.

PAGGAMIT

patunayan ang [mga opsyon] [mga file o direktoryo]

Opsyon

Mga opsyon sa Boolean:

-v, --verbose I-print ang lahat ng linya ng pagsubok.
-l, --lib Magdagdag ng 'lib' sa landas para sa iyong mga pagsubok (-Ilib).
-b, --blib Magdagdag ng 'blib/lib' at 'blib/arch' sa landas para sa
iyong mga pagsubok
-s, --shuffle Patakbuhin ang mga pagsubok sa random na pagkakasunud-sunod.
-c, --color May kulay na output ng pagsubok (default).
--nocolor Huwag kulayan ang output ng pagsubok.
--count Ipakita ang X/Y test count kapag hindi verbose
(default)
--nocount I-disable ang X/Y test count.
-D --tuyo Dry run. Ipakita ang pagsubok na tatakbo sana.
-f, --failures Ipakita ang mga nabigong pagsubok.
-o, --komento Ipakita ang mga komento.
--ignore-exit Huwag pansinin ang katayuan sa paglabas mula sa mga script ng pagsubok.
-m, --merge Pagsamahin ang mga test script ng STDERR sa kanilang STDOUT.
-r, --recurse Paulit-ulit na bumaba sa mga direktoryo.
--reverse Patakbuhin ang mga pagsubok sa reverse order.
-q, --quiet Pigilan ang ilang pagsubok na output habang nagpapatakbo ng mga pagsubok.
-Q, --QUIET I-print lamang ang mga resulta ng buod.
-p, --parse Ipakita ang buong listahan ng mga error sa pag-parse ng TAP, kung mayroon man.
--directives Ipakita lamang ang mga resulta na may TODO o SKIP na mga direktiba.
--timer Lumipas ang oras ng pag-print pagkatapos ng bawat pagsubok.
--trap Trap Ctrl-C at i-print ang buod sa interrupt.
--normalize Normalize TAP output sa verbose output
-T Paganahin ang mga tseke na may bahid.
-t Paganahin ang mga nagbabantang babala.
-W Paganahin ang mga nakamamatay na babala.
-w Paganahin ang mga babala.
-h, --help Ipakita ang tulong na ito
-?, Ipakita ang tulong na ito
-V, --bersyon Ipakita ang bersyon
-H, --man Mas mahabang manpage para patunayan
--norc Huwag iproseso ang default na .proverc

Mga opsyon na kumukuha ng mga argumento:

-I Library path upang isama.
-P Load plugin (naghahanap sa App::Patunayan::Plugin::*.)
-M Mag-load ng module.
-e, --exec Interpreter upang patakbuhin ang mga pagsubok ('' para sa compiled
mga pagsubok.)
--ext Itakda ang extension para sa mga pagsubok (default '.t')
--harness Tukuyin ang test harness na gagamitin. Tingnan ang TAP::Harness.
--formatter Resulta formatter na gagamitin. Tingnan ang MGA FORMAT.
--source Mag-load at/o mag-configure ng SourceHandler. Tingnan mo
MGA HANDLER NG SOURCE.
-a, --archive out.tgz I-imbak ang nagresultang TAP sa isang archive file.
-j, --jobs N Patakbuhin ang N pagsubok na trabaho nang magkatulad (subukan ang 9.)
--state=opts Control prove's persistent state.
--rc=rcfile Mga opsyon sa proseso mula sa rcfile
--rules Mga panuntunan para sa parallel vs sequential processing.

NOTA

.proverc
If ~/.proverc or ./.proverc ang mga ito ay mababasa at anumang mga opsyon na naglalaman ng mga ito ay naproseso
bago ang mga pagpipilian sa command line. Mga opsyon sa .proverc ay tinukoy sa parehong paraan tulad ng
mga pagpipilian sa command line:

# .proverc
--state=mainit, mabilis, makatipid
-j9

Maaaring tukuyin ang mga karagdagang opsyong file gamit ang opsyong "--rc". Default na file ng opsyon
ang pagpoproseso ay hindi pinagana ng "--norc" na opsyon.

Sa ilalim ng Windows at VMS ang opsyon na file ay pinangalanan _prorc sa halip na .proverc at hinahanap
sa kasalukuyang direktoryo lamang.

Pagbabasa mula "STDIN"
Kung mayroon kang listahan ng mga pagsubok (o mga URL, o anumang bagay na gusto mong subukan) sa isang file, ikaw
maaaring idagdag ang mga ito sa iyong mga pagsubok sa pamamagitan ng paggamit ng '-':

patunayan - < my_list_of_things_to_test.txt

Tingnan ang "README" sa direktoryo ng "mga halimbawa" ng distribusyon na ito.

default Pagsubok Directory
Kung walang mga file o direktoryo na ibinibigay, "patunayan" ay naghahanap para sa lahat ng mga file na tumutugma sa pattern
"t/*.t".

May kulay Pagsubok Pagbubuhos
May kulay na test output gamit ang TAP::Formatter::Color ang default, ngunit kung ang output ay hindi sa a
terminal, hindi pinagana ang kulay. Maaari mong i-override ito sa pamamagitan ng pagdaragdag ng "--color" switch.

Ang suporta sa kulay ay nangangailangan ng Term::ANSIColor sa mga platform na tulad ng Unix at Win32::Console sa
mga bintana. Kung ang kinakailangang module ay hindi naka-install ang kulay na output ay hindi magagamit.

lumabas kodigo
Kung ang mga pagsubok ay nabigo, "patunayan" ay lalabas nang hindi zero ang katayuan.

Mga argumento sa Mga Pagsubok
Posibleng magbigay ng mga argumento sa mga pagsubok. Upang gawin ito, paghiwalayin sila mula sa sariling patunay
mga argumento na may arisdottle, '::'. Halimbawa

patunayan -vt/mytest.t :: --url http://example.com

tatakbo t/mytest.t gamit ang mga opsyon '--url http://example.com'. Kapag nagpapatakbo ng maramihan
mga pagsubok na matatanggap ng bawat isa sa kanila ang parehong mga argumento.

"--exec"
Karaniwan maaari ka lamang magpasa ng isang listahan ng mga pagsubok sa Perl at malalaman ng harness kung paano i-execute
sila. Gayunpaman, kung ang iyong mga pagsubok ay hindi nakasulat sa Perl o kung gusto mong gamitin ang lahat ng mga pagsubok
eksakto sa parehong paraan, gamitin ang "-e", o "--exec" switch:

patunayan --exec '/usr/bin/ruby -w't/
patunayan --exec '/usr/bin/perl -Tw -mstrict -Ilib' t/
patunayan --exec '/path/to/my/customer/exec'

"--pagsamahin"
Kung kailangan mong tiyakin na ang iyong mga diagnostic ay ipinapakita sa tamang pagkakasunod-sunod na may kaugnayan sa
mga resulta ng pagsubok maaari mong gamitin ang pagpipiliang "--merge" upang pagsamahin ang STDERR ng mga script ng pagsubok sa kanilang mga
STDOUT.

Ginagarantiyahan nito na ang STDOUT (kung saan lumalabas ang mga resulta ng pagsubok) at STDERR (kung saan ang
lalabas ang mga diagnostic) ay mananatiling naka-sync. Ipapakita ng harness ang anumang diagnostic na iyong mga pagsusuri
naglalabas sa STDERR.

Caveat: ito ay isang bit ng isang kludge. Sa partikular na tandaan na kung anumang bagay na lilitaw sa
Ang STDERR ay mukhang isang resulta ng pagsubok na malito ang test harness. Gamitin lamang ang opsyong ito
kung nauunawaan mo ang mga kahihinatnan at mabubuhay kasama ang panganib.

"--bitag"
Ang pagpipiliang "--trap" ay susubukang i-trap ang SIGINT (Ctrl-C) sa panahon ng pagsubok at ipakita ang
buod ng pagsubok kahit na naantala ang pagtakbo

"--estado"
Maaari mong hilingin sa "patunayan" na alalahanin ang estado ng mga nakaraang pagsubok na tumakbo at pumili at/o mag-order
ang mga pagsubok na tatakbo batay sa naka-save na estado na iyon.

Ang switch na "--state" ay nangangailangan ng argumento na dapat ay isang listahan na pinaghihiwalay ng kuwit ng isa o
higit pa sa mga sumusunod na opsyon.

"huling"
Patakbuhin ang parehong mga pagsubok tulad ng huling beses na na-save ang estado. Ginagawa nitong posible, para sa
halimbawa, upang muling likhain ang pag-order ng isang shuffled na pagsubok.

# Patakbuhin ang lahat ng mga pagsubok sa random na pagkakasunud-sunod
$ prove -b --state=save --shuffle

# Patakbuhin muli ang mga ito sa parehong pagkakasunud-sunod
$ prove -b --state=last

"nabigo"
Patakbuhin lamang ang mga pagsubok na nabigo sa huling pagtakbo.

# Patakbuhin ang lahat ng mga pagsubok
$ prove -b --state=save

# Mga pagkabigo sa pagpapatakbo
$ prove -b --state=failed

Kung tutukuyin mo rin ang opsyong "i-save" ang mga bagong papasa na pagsubok ay ibubukod mula sa
kasunod na pagtakbo.

# Ulitin hanggang wala nang mga pagkabigo
$ prove -b --state=failed, save

"pumasa"
Patakbuhin lamang ang mga nakapasa na pagsusulit mula sa huling pagkakataon. Kapaki-pakinabang upang matiyak na walang mga bagong problema
ay ipinakilala.

"lahat"
Patakbuhin ang lahat ng mga pagsubok sa normal na pagkakasunud-sunod. Maaaring tukuyin ang maramihang mga opsyon, upang patakbuhin ang lahat ng pagsubok
kasama ang mga kabiguan mula sa huling pagkakataon muna:

$ prove -b --state=failed,all,save

"mainit"
Patakbuhin ang mga pagsubok na pinakahuling nabigo muna. Ang huling oras ng pagkabigo ng bawat pagsubok ay
nakaimbak. Ang "mainit" na opsyon ay nagdudulot ng mga pagsubok na patakbuhin sa pinakakamakailang-kabiguan na pagkakasunud-sunod.

$ prove -b --state=hot, save

Ang mga pagsubok na hindi kailanman nabigo ay hindi pipiliin. Upang patakbuhin ang lahat ng pagsubok sa pinakamaraming
kamakailan ay nabigo sa unang paggamit

$ prove -b --state=hot,all,save

Ang kumbinasyong ito ng mga opsyon ay maaari ding tukuyin sa gayon

$ prove -b --state=adrian

"gagawin"
Magpatakbo ng anumang mga pagsubok na may todos.

"mabagal"
Patakbuhin ang mga pagsubok sa pinakamabagal hanggang sa pinakamabilis na pagkakasunud-sunod. Ito ay kapaki-pakinabang kasabay ng "-j"
parallel testing switch para matiyak na ang iyong pinakamabagal na pagsubok ay magsisimulang tumakbo muna.

$ prove -b --state=slow -j9

"mabilis"
Magpatakbo ng mga pagsubok na pagsubok sa pinakamabilis hanggang pinakamabagal na pagkakasunud-sunod.

"bago"
Patakbuhin ang mga pagsubok sa pinakabago hanggang sa pinakalumang pagkakasunud-sunod batay sa mga oras ng pagbabago ng pagsubok
script.

"matanda"
Patakbuhin ang mga pagsubok sa pinakaluma hanggang sa pinakabagong pagkakasunud-sunod.

"sariwa"
Patakbuhin ang mga pansubok na script na iyon na nabago mula noong huling pagsubok na pagtakbo.

"iligtas"
I-save ang estado sa labasan. Ang estado ay naka-imbak sa isang file na tinatawag .patunayan (_patunayan sa Windows
at VMS) sa kasalukuyang direktoryo.

Ang switch na "--state" ay maaaring gamitin nang higit sa isang beses.

$ prove -b --state=hot --state=all, save

--mga tuntunin
Ang opsyong "--rules" ay ginagamit upang kontrolin kung aling mga pagsubok ang tatakbo nang sunud-sunod at alin ang tatakbo
kahanay, kung ang "--jobs" na opsyon ay tinukoy. Ang opsyon ay maaaring tukuyin ng maramihan
beses, at ang pagkakasunud-sunod ay mahalaga.

Ang pinaka-praktikal na paggamit ay malamang na tukuyin na ang ilang mga pagsubok ay hindi "parallel-ready".
Dahil ang pagbanggit ng file na may --rules ay hindi nagiging dahilan upang mapili itong tumakbo bilang pagsubok, ikaw
maaaring "itakda at kalimutan" ang ilang mga kagustuhan sa panuntunan sa iyong .proverc file. Pagkatapos ay magagawa mo
samantalahin nang husto ang mga benepisyo ng pagganap ng parallel testing, habang ang ilan
ang mga pagbubukod ay tumatakbo pa rin nang magkatulad.

--mga tuntunin halimbawa

# Lahat ng pagsubok ay pinapayagang tumakbo nang magkatulad, maliban sa mga nagsisimula sa "p"
--rules='seq=t/p*.t' --rules='par=**'

# Ang lahat ng mga pagsubok ay dapat tumakbo sa pagkakasunud-sunod maliban sa mga nagsisimula sa "p", na dapat ay tumakbo parallel
--rules='par=t/p*.t'

--mga tuntunin paglutas

· Bilang default, ang lahat ng mga pagsubok ay karapat-dapat na tumakbo nang magkatulad. Tinutukoy ang alinman sa iyong sarili
Tinatanggal ng mga panuntunan ang isang ito.

· "Nanalo ang unang laban". Ang unang panuntunan na tumutugma sa isang pagsubok ay ang isa na nalalapat.

· Anumang pagsubok na hindi tumutugma sa isang panuntunan ay tatakbo nang sunud-sunod sa pagtatapos ng pagtakbo.

· Ang pagkakaroon ng isang panuntunan ay hindi nagpapahiwatig ng pagpili ng isang pagsubok. Dapat mo pa ring tukuyin ang
mga pagsubok na tatakbo.

· Ang pagtukoy ng panuntunan upang payagan ang mga pagsubok na tumakbo nang magkatulad ay hindi magpapatakbo sa mga ito
parallel. Kailangan mo pa ring tukuyin ang bilang ng magkakatulad na "mga trabaho" sa iyong Harness object.

--mga tuntunin Glob-style huwaran pagtutugma

Ipinapatupad namin ang sarili naming glob-style pattern na tumutugma para sa --rules. Narito ang mga suportado
mga pattern:

** ay anumang bilang ng mga character, kabilang ang /, sa loob ng isang pathname
* ay zero o higit pang mga character sa loob ng isang filename/pangalan ng direktoryo
? ay eksaktong isang character sa loob ng isang filename/pangalan ng direktoryo
Ang {foo,bar,baz} ay alinman sa foo, bar o baz.
Ang \ ay isang karakter sa pagtakas

pa advanced pagtutukoy para pagtularin vs pagkakasunud-sunod tumakbo patakaran

Kung kailangan mo ng mas advanced na pamamahala ng kung ano ang tumatakbo sa parallel vs in sequence, tingnan ang
nauugnay na dokumentasyon ng 'mga panuntunan' sa TAP::Harness at TAP::Parser::Scheduler. Kung ano
posibleng direkta sa pamamagitan ng "patunayan" ay hindi sapat, maaari mong isulat ang iyong sariling harness sa
direktang i-access ang mga tampok na ito.

@INC
nagpapakilala ang prove ng isang paghihiwalay sa pagitan ng "mga opsyon na ipinasa sa perl na nagpapatakbo ng prove" at
"mga opsyon na ipinasa sa perl na nagpapatakbo ng mga pagsubok"; ang pagkakaibang ito ay ayon sa disenyo. Kaya, ang
perl na nagpapatakbo ng pagsubok ay nagsisimula sa default na @INC. Karagdagang mga direktoryo ng aklatan
maaaring idagdag sa pamamagitan ng "PERL5LIB" environment variable, sa pamamagitan ng -Ifoo sa "PERL5OPT" o sa pamamagitan ng
"-Ilib" na opsyon sa patunayan.

Taint paraan
Karaniwan kapag ang isang Perl program ay pinapatakbo sa taint mode ang mga nilalaman ng "PERL5LIB"
hindi lumalabas ang environment variable sa @INC.

Dahil ang "PERL5LIB" ay kadalasang ginagamit sa panahon ng pagsubok upang magdagdag ng mga direktoryo ng build sa @INC prove
ipinapasa ang mga pangalan ng anumang mga direktoryo na matatagpuan sa "PERL5LIB" habang lumilipat ako. Ang netong epekto ng
ito ay ang "PERL5LIB" ay pinarangalan kahit na ang prove ay tumakbo sa taint mode.

MGA FORMAT

Maaari kang mag-load ng custom na TAP::Parser::Formatter:

patunayan --formatter MyFormatter

SOURCE MGA HANDLERS

Maaari mong i-load ang custom na TAP::Parser::SourceHandlers, upang baguhin ang paraan ng pag-interpret ng parser
partikular na pinagkukunan ng TAP.

patunayan --source MyHandler --source YetAnother t

Kung nais mong magbigay ng config sa pinagmulan maaari mong gamitin ang:

patunayan --source MyCustom
--source Perl --perl-option 'foo=bar baz' --perl-option avg=0.278
--source File --file-option extensions=.txt --file-option extensions=.tmp t
--source pgTAP --pgtap-option pset=format=html --pgtap-option pset=border=2

Ang bawat opsyong "--$source-option" ay dapat tumukoy ng key/value pair na pinaghihiwalay ng "=". Kung ang
ang opsyon ay maaaring tumagal ng maraming halaga, tukuyin lamang ito nang maraming beses, tulad ng sa "mga extension="
mga halimbawa sa itaas. Kung ang opsyon ay dapat na hash reference, tukuyin ang value bilang isang segundo
pares na pinaghihiwalay ng "=", tulad ng sa "pset=" na mga halimbawa sa itaas (escape "=" na may backslash).

Ang lahat ng "--sources" ay pinagsama sa isang hash, at ipinapasa sa "bago" sa TAP::Harness's "sources"
parameter

Tingnan ang TAP::Parser::IteratorFactory para sa higit pang mga detalye kung paano ipinapasa ang configuration
SourceHandlers.

PLUGINS

Maaaring i-load ang mga plugin gamit ang "-Pisaksak" syntax, hal:

patunayan -PMyPlugin

Maghahanap ito ng module na pinangalanang "App::Prove::Plugin::MyPlugin", o kung hindi,
"MyPlugin". Kung hindi mahanap ang plugin, ang "patunayan" ay magrereklamo at lalabas.

Maaari kang magpasa ng mga argumento sa iyong plugin sa pamamagitan ng pagdaragdag ng "=arg1,arg2,etc" sa pangalan ng plugin:

patunayan -PMyPlugin=fou,du,fafa

Pakisuri ang indibidwal na dokumentasyon ng plugin para sa higit pang mga detalye.

Magagamit Plugins
Para sa up-to-date na listahan ng mga plugin na available, pakitingnan ang CPAN:

<http://search.cpan.org/search?query=App%3A%3AProve+Plugin>

Pagsulat Plugins
Pakitingnan ang "PLUGINS" sa App::Prove.

Gamitin ang prove online gamit ang mga serbisyo ng onworks.net