buktikan - Dalam talian di Awan

JADUAL:

NAMA

buktikan - Jalankan ujian melalui abah-abah TAP.

PENGGUNAAN

buktikan [pilihan] [fail atau direktori]

PILIHAN

Pilihan Boolean:

-v, --verbose Cetak semua baris ujian.
-l, --lib Tambahkan 'lib' pada laluan untuk ujian anda (-Ilib).
-b, --blib Tambah 'blib/lib' dan 'blib/arch' pada laluan untuk
ujian anda
-s, --shuffle Jalankan ujian dalam susunan rawak.
-c, --color Keluaran ujian berwarna (lalai).
--nocolor Jangan warnakan output ujian.
--count Tunjukkan kiraan ujian X/Y apabila bukan verbose
(lalai)
--nocount Lumpuhkan kiraan ujian X/Y.
-D --lari kering kering. Tunjukkan ujian yang akan berjalan.
-f, --failures Tunjukkan ujian yang gagal.
-o, --komen Tunjukkan ulasan.
--ignore-exit Abaikan status keluar daripada skrip ujian.
-m, --merge Cantumkan skrip ujian 'STDERR dengan STDOUT mereka.
-r, --recurse Secara rekursif turun ke dalam direktori.
--reverse Jalankan ujian dalam susunan terbalik.
-q, --quiet Sekat beberapa output ujian semasa menjalankan ujian.
-Q, --TENANG Hanya cetak hasil ringkasan.
-p, --parse Tunjukkan senarai penuh ralat parse TAP, jika ada.
--directives Hanya tunjukkan hasil dengan arahan TODO atau SKIP.
--pemasa Cetak masa berlalu selepas setiap ujian.
--trap Trap Ctrl-C dan cetak ringkasan pada gangguan.
--normalize Normalize TAP output dalam output verbose
-T Membolehkan pemeriksaan mencemarkan.
-t Dayakan amaran mengotorkan.
-W Dayakan amaran maut.
-w Dayakan amaran.
-h, --help Paparkan bantuan ini
-?, Paparkan bantuan ini
-V, --version Paparkan versi
-H, --man Halaman manual yang lebih panjang untuk membuktikan
--norc Jangan proses lalai .proverc

Pilihan yang mengambil hujah:

-I Laluan Perpustakaan untuk disertakan.
-P Muatkan pemalam (mencari Apl::Bukti::Plugin::*.)
-M Muatkan modul.
-e, --exec Jurubahasa untuk menjalankan ujian ('' untuk compiled
ujian.)
--ext Tetapkan sambungan untuk ujian (lalai '.t')
--harness Tentukan abah-abah ujian untuk digunakan. Lihat TAP::Abah-abah.
--formatter Pemformat hasil untuk digunakan. Lihat FORMAT.
--source Muatkan dan/atau konfigurasikan SourceHandler. Lihat
PENGENDALI SUMBER.
-a, --archive out.tgz Simpan TAP yang terhasil dalam fail arkib.
-j, --jobs N Jalankan N kerja ujian secara selari (cuba 9.)
--state=opts Kawalan membuktikan keadaan berterusan.
--rc=rcfile Pilihan proses daripada rcfile
--rules Peraturan untuk pemprosesan selari vs berjujukan.

NOTA

.proverc
If ~/.proverc or ./.proverc wujud ia akan dibaca dan sebarang pilihan yang terkandung di dalamnya akan diproses
sebelum pilihan baris arahan. Pilihan dalam .proverc dinyatakan dengan cara yang sama seperti
pilihan baris arahan:

# .proverc
--state=panas,cepat,jimat
-j9

Fail pilihan tambahan boleh ditentukan dengan pilihan "--rc". Fail pilihan lalai
pemprosesan dilumpuhkan oleh pilihan "--norc".

Di bawah Windows dan VMS fail pilihan dinamakan _prorc daripada .proverc dan dicari
hanya dalam direktori semasa.

Reading dari "STDIN"
Jika anda mempunyai senarai ujian (atau URL, atau apa-apa lagi yang anda mahu uji) dalam fail, anda
boleh menambahkannya pada ujian anda dengan menggunakan '-':

buktikan - < my_list_of_things_to_test.txt

Lihat "README" dalam direktori "contoh" pengedaran ini.

Lalai ujian Direktori
Jika tiada fail atau direktori dibekalkan, "buktikan" mencari semua fail yang sepadan dengan corak
"t/*.t".

Berwarna ujian Output
Output ujian berwarna menggunakan TAP::Formatter::Color ialah lalai, tetapi jika output bukan kepada a
terminal, warna dilumpuhkan. Anda boleh mengatasi ini dengan menambahkan suis "--color".

Sokongan warna memerlukan Term::ANSIColor pada platform seperti Unix dan Win32::Console pada
tingkap. Jika modul yang diperlukan tidak dipasang output berwarna tidak akan tersedia.

Keluar Kod
Jika ujian gagal "buktikan" akan keluar dengan status bukan sifar.

Argumen kepada Ujian
Adalah mungkin untuk membekalkan hujah kepada ujian. Untuk berbuat demikian, pisahkan mereka daripada bukti sendiri
hujah dengan arisdot, '::'. Sebagai contoh

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

akan berjalan t/mytest.t dengan pilihan '--url http://example.com'. Apabila menjalankan berbilang
ujian mereka masing-masing akan menerima hujah yang sama.

"--exec"
Biasanya anda hanya boleh lulus senarai ujian Perl dan abah-abah akan tahu cara untuk melaksanakan
mereka. Walau bagaimanapun, jika ujian anda tidak ditulis dalam Perl atau jika anda mahu semua ujian digunakan
dengan cara yang sama, gunakan suis "-e", atau "--exec":

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

"--bercantum"
Jika anda perlu memastikan diagnostik anda dipaparkan dalam susunan yang betul berbanding dengan
keputusan ujian anda boleh menggunakan pilihan "--merge" untuk menggabungkan skrip ujian 'STDERR ke dalam mereka
STDOUT.

Ini menjamin bahawa STDOUT (di mana keputusan ujian muncul) dan STDERR (di mana
diagnostik muncul) akan kekal segerak. Abah-abah akan memaparkan sebarang diagnostik ujian anda
dipancarkan pada STDERR.

Kaveat: ini adalah sedikit kludge. Khususnya ambil perhatian bahawa jika apa-apa yang muncul pada
STDERR kelihatan seperti keputusan ujian, abah ujian akan keliru. Gunakan pilihan ini sahaja
jika anda memahami akibatnya dan boleh hidup dengan risiko.

"--perangkap"
Pilihan "--trap" akan cuba memerangkap SIGINT (Ctrl-C) semasa ujian dijalankan dan memaparkan
ringkasan ujian walaupun larian terganggu

"--negeri"
Anda boleh meminta "buktikan" untuk mengingati keadaan larian ujian sebelumnya dan memilih dan/atau memesan
ujian yang akan dijalankan berdasarkan keadaan yang disimpan itu.

Suis "--state" memerlukan hujah yang mestilah senarai dipisahkan koma bagi satu atau
lebih banyak pilihan berikut.

"terakhir"
Jalankan ujian yang sama seperti kali terakhir keadaan disimpan. Ini memungkinkan, untuk
contoh, untuk mencipta semula susunan ujian yang dikocok.

# Jalankan semua ujian dalam susunan rawak
$ prove -b --state=save --shuffle

# Jalankan semula dalam susunan yang sama
$ buktikan -b --state=last

"gagal"
Jalankan hanya ujian yang gagal pada larian terakhir.

# Jalankan semua ujian
$ buktikan -b --state=save

# Kegagalan jalankan
$ prove -b --state=failed

Jika anda juga menentukan pilihan "simpan" ujian yang baru lulus akan dikecualikan daripada
larian seterusnya.

# Ulang sehingga tiada lagi kegagalan
$ prove -b --state=gagal,simpan

"lulus"
Jalankan hanya ujian yang lulus dari kali terakhir. Berguna untuk memastikan tiada masalah baru
telah diperkenalkan.

"semua"
Jalankan semua ujian dalam susunan biasa. Pelbagai pilihan boleh ditentukan, jadi untuk menjalankan semua ujian
dengan kegagalan dari kali terakhir dahulu:

$ prove -b --state=gagal,semua,simpan

"panas"
Jalankan ujian yang terbaharu gagal dahulu. Masa kegagalan terakhir setiap ujian ialah
disimpan. Pilihan "panas" menyebabkan ujian dijalankan dalam susunan kegagalan terbaharu.

$ prove -b --state=hot,save

Ujian yang tidak pernah gagal tidak akan dipilih. Untuk menjalankan semua ujian dengan paling banyak
baru-baru ini gagal penggunaan pertama

$ buktikan -b --state=panas,semua,simpan

Gabungan pilihan ini juga boleh ditentukan demikian

$ buktikan -b --state=adrian

"todo"
Jalankan sebarang ujian dengan todos.

"lambat"
Jalankan ujian dalam susunan paling perlahan hingga terpantas. Ini berguna bersama dengan "-j"
suis ujian selari untuk memastikan ujian anda yang paling perlahan mula dijalankan terlebih dahulu.

$ buktikan -b --state=slow -j9

"cepat"
Jalankan ujian ujian dalam susunan terpantas hingga paling perlahan.

"baru"
Jalankan ujian dalam susunan terkini hingga tertua berdasarkan masa pengubahsuaian ujian
skrip.

"tua"
Jalankan ujian dalam susunan tertua hingga terbaharu.

"segar"
Jalankan skrip ujian yang telah diubah suai sejak ujian terakhir dijalankan.

"simpan"
Simpan negeri semasa keluar. Keadaan disimpan dalam fail yang dipanggil .buktikan (_membuktikan pada Windows
dan VMS) dalam direktori semasa.

Suis "--state" boleh digunakan lebih daripada sekali.

$ prove -b --state=hot --state=semua,simpan

--peraturan
Pilihan "--rules" digunakan untuk mengawal ujian yang dijalankan secara berurutan dan yang dijalankan
selari, jika pilihan "--jobs" ditentukan. Pilihan boleh ditentukan berbilang
kali, dan perintah itu penting.

Penggunaan yang paling praktikal mungkin menyatakan bahawa sesetengah ujian tidak "sedia selari".
Memandangkan menyebut fail dengan --rules tidak menyebabkan ia dipilih untuk dijalankan sebagai ujian, anda
boleh "menetapkan dan melupakan" beberapa keutamaan peraturan dalam fail .proverc anda. Kemudian anda akan dapat
mengambil kesempatan maksimum daripada faedah prestasi ujian selari, manakala beberapa
pengecualian masih dijalankan secara selari.

--peraturan contoh

# Semua ujian dibenarkan berjalan selari, kecuali yang bermula dengan "p"
--rules='seq=t/p*.t' --rules='par=**'

# Semua ujian mesti dijalankan mengikut urutan kecuali yang bermula dengan "p", yang sepatutnya dijalankan selari
--rules='par=t/p*.t'

--peraturan resolusi

· Secara lalai, semua ujian layak dijalankan secara selari. Menentukan mana-mana anda sendiri
peraturan membuang yang ini.

· "Perlawanan pertama menang". Peraturan pertama yang sepadan dengan ujian ialah peraturan yang terpakai.

· Sebarang ujian yang tidak sepadan dengan peraturan akan dijalankan mengikut urutan pada penghujung larian.

· Kewujudan peraturan tidak membayangkan memilih ujian. Anda masih mesti menyatakan
ujian untuk dijalankan.

· Menentukan peraturan untuk membenarkan ujian dijalankan secara selari tidak menjadikannya berjalan masuk
selari. Anda masih perlu menentukan bilangan "pekerjaan" selari dalam objek Harness anda.

--peraturan Gaya glob pola sepadan

Kami melaksanakan padanan corak gaya glob kami sendiri untuk --rules. Berikut adalah yang disokong
corak:

** ialah sebarang bilangan aksara, termasuk /, dalam nama laluan
* ialah sifar atau lebih aksara dalam nama fail/nama direktori
? adalah betul-betul satu aksara dalam nama fail/nama direktori
{foo,bar,baz} ialah mana-mana foo, bar atau baz.
\ ialah watak melarikan diri

Lagi maju spesifikasi khususnya selari vs turutan menjalankan peraturan

Jika anda memerlukan pengurusan yang lebih maju tentang perkara yang berjalan secara selari vs dalam urutan, lihat
dokumentasi 'peraturan' yang berkaitan dalam TAP::Harness dan TAP::Parser::Scheduler. Jika apa
mungkin terus melalui "buktikan" tidak mencukupi, anda boleh menulis abah-abah anda sendiri ke
mengakses ciri-ciri ini secara langsung.

@INC
prove memperkenalkan pemisahan antara "pilihan yang diserahkan kepada perl yang menjalankan prove" dan
"pilihan diserahkan kepada perl yang menjalankan ujian"; perbezaan ini adalah dengan reka bentuk. Justeru itu
perl yang menjalankan ujian bermula dengan @INC lalai. Direktori perpustakaan tambahan
boleh ditambah melalui pembolehubah persekitaran "PERL5LIB", melalui -Ifoo dalam "PERL5OPT" atau melalui
"-Ilib" pilihan untuk membuktikan.

Taint mod
Biasanya apabila program Perl dijalankan dalam mod taint kandungan "PERL5LIB"
pembolehubah persekitaran tidak muncul dalam @INC.

Kerana "PERL5LIB" sering digunakan semasa ujian untuk menambah direktori binaan ke @INC prove
melepasi nama mana-mana direktori yang terdapat dalam "PERL5LIB" semasa -I bertukar. Kesan bersih daripada
ini ialah "PERL5LIB" dihormati walaupun bukti dijalankan dalam mod taint.

FORMAT

Anda boleh memuatkan TAP tersuai::Parser::Formatter:

buktikan --formatter MyFormatter

SUMBER PENGENDALI

Anda boleh memuatkan TAP::Parser::SourceHandlers tersuai, untuk menukar cara penghurai mentafsir
tertentu sumber daripada TAP.

buktikan --sumber MyHandler --sumber YetAnother t

Jika anda ingin memberikan konfigurasi kepada sumber yang anda boleh gunakan:

buktikan --sumber MyCustom \
--source Perl --perl-option 'foo=bar baz' --perl-option avg=0.278 \
--source Fail --fail-pilihan sambungan=.txt --fail-pilihan sambungan=.tmp t
--sumber pgTAP --pgtap-option pset=format=html --pgtap-option pset=border=2

Setiap pilihan "--$source-option" mesti menentukan pasangan kunci/nilai yang dipisahkan oleh "=". Jika an
pilihan boleh mengambil berbilang nilai, hanya tentukan beberapa kali, seperti dengan "extensions="
contoh di atas. Jika pilihan mestilah rujukan cincang, nyatakan nilai sebagai saat
pasangan dipisahkan dengan "=", seperti dalam contoh "pset=" di atas (escape "=" dengan garis miring ke belakang).

Semua "--sources" digabungkan menjadi cincang dan dihantar kepada "baharu" dalam "sumber" TAP::Harness
parameter.

Lihat TAP::Parser::IteratorFactory untuk mendapatkan butiran lanjut tentang cara konfigurasi dihantar kepada
Pengendali Sumber.

plugin

Pemalam boleh dimuatkan menggunakan "-Ppasangkan" sintaks, cth:

buktikan -PMyPlugin

Ini akan mencari modul bernama "App::Prove::Plugin::MyPlugin", atau jika gagal,
"MyPlugin". Jika pemalam tidak ditemui, "buktikan" akan mengadu & keluar.

Anda boleh menghantar argumen kepada pemalam anda dengan menambahkan "=arg1,arg2,etc" pada nama pemalam:

buktikan -PMyPlugin=fou,du,fafa

Sila semak dokumentasi pemalam individu untuk butiran lanjut.

Boleh didapati Plugin
Untuk senarai pemalam terkini yang tersedia, sila semak CPAN:

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

Penulisan Plugin
Sila lihat "PLUGINS" dalam App::Prove.

Gunakan bukti dalam talian menggunakan perkhidmatan onworks.net