EnglishFrenchSpanyol

Jalankan pelayan | Ubuntu > | Fedora > |


Favicon OnWorks

lit-3.7 - Dalam Talian di Awan

Jalankan lit-3.7 dalam penyedia pengehosan percuma OnWorks melalui Ubuntu Online, Fedora Online, emulator dalam talian Windows atau emulator dalam talian MAC OS

Ini ialah arahan lit-3.7 yang boleh dijalankan dalam penyedia pengehosan percuma OnWorks menggunakan salah satu daripada berbilang stesen kerja dalam talian percuma kami seperti Ubuntu Online, Fedora Online, emulator dalam talian Windows atau emulator dalam talian MAC OS.

JADUAL:

NAMA


menyala - Penguji Bersepadu LLVM

SINOPSIS


katil [pilihan] [ujian]

DESCRIPTION


katil ialah alat mudah alih untuk melaksanakan suite ujian gaya LLVM dan Clang, meringkaskannya
keputusan, dan memberikan petunjuk kegagalan. katil direka bentuk untuk menjadi ringan
alat ujian dengan antara muka pengguna yang semudah mungkin.

katil harus dijalankan dengan satu atau lebih ujian untuk dijalankan yang ditentukan pada baris arahan. Ujian boleh
sama ada fail ujian individu atau direktori untuk mencari ujian (lihat UJIAN PENEMUAN).

Setiap ujian yang ditentukan akan dilaksanakan (berpotensi selari) dan setelah semua ujian telah dilakukan
telah dijalankan katil akan mencetak maklumat ringkasan tentang bilangan ujian yang lulus atau gagal
(Lihat UJIAN STATUS KEPUTUSAN). The katil program akan dilaksanakan dengan kod keluar bukan sifar jika ada
ujian gagal.

Secara lalai katil akan menggunakan paparan kemajuan yang ringkas dan hanya akan mencetak ringkasan
maklumat untuk kegagalan ujian. Lihat OUTPUT PILIHAN untuk pilihan mengawal katil
paparan kemajuan dan output.

katil juga termasuk beberapa pilihan untuk mengawal cara ujian dilaksanakan (khusus
ciri mungkin bergantung pada format ujian tertentu). Lihat PERLAKSANAAN PILIHAN selama lebih
maklumat.

Akhirnya, katil juga menyokong pilihan tambahan untuk hanya menjalankan subset pilihan
dinyatakan pada baris arahan, lihat PEMILIHAN PILIHAN untuk maklumat lanjut.

Pengguna yang berminat dengan katil seni bina atau reka bentuk a katil pelaksanaan ujian harus
lihat LIT INFRASTRUCTURE.

UMUM PILIHAN


-h, - membantu
Tunjukkan katil mesej bantuan.

-j N, --benang=N
Main N ujian secara selari. Secara lalai, ini dipilih secara automatik untuk memadankan
bilangan CPU tersedia yang dikesan.

--config-prefix=NAME
Carian untuk NAMA.cfg dan NAMA.site.cfg apabila mencari untuk ujian suite, sebaliknya of
lit.cfg dan lit.site.cfg.

-D NAMA, -D NAME=VALUE, --param NAMA, --param NAMA = NILAI
Tambahkan parameter yang ditentukan pengguna NAMA dengan yang diberikan NILAI (atau rentetan kosong jika tidak
diberikan). Maksud dan penggunaan parameter ini adalah bergantung kepada suite ujian.

OUTPUT PILIHAN


-q, --senyap
Sekat sebarang output kecuali kegagalan ujian.

-ya, --ringkas
Tunjukkan kurang output, contohnya jangan tunjukkan maklumat tentang ujian yang lulus.

-v, --verbose
Tunjukkan lebih banyak maklumat tentang kegagalan ujian, contohnya keseluruhan output ujian
hanya hasil ujian.

--tiada-bar kemajuan
Jangan gunakan bar kemajuan berasaskan kutukan.

--tunjuk-tidak disokong
Tunjukkan nama ujian yang tidak disokong.

--tunjuk-xfail
Tunjukkan nama ujian yang dijangka gagal.

PERLAKSANAAN PILIHAN


--path=PATH
Nyatakan tambahan PATH untuk digunakan semasa mencari boleh laku dalam ujian.

--vg Jalankan ujian individu di bawah valgrind (menggunakan alat memcheck). The
--error-exitcode hujah untuk valgrind digunakan supaya kegagalan valgrind akan menyebabkan
program untuk keluar dengan status bukan sifar.

Apabila pilihan ini didayakan, katil juga secara automatik akan memberikan "valgrind"
ciri yang boleh digunakan untuk melumpuhkan secara bersyarat (atau mengharapkan kegagalan dalam) tertentu
ujian.

--vg-arg=ARG
Bila --vg digunakan, nyatakan hujah tambahan untuk dihantar ke valgrind sendiri.

--vg-bocor
Bila --vg digunakan, dayakan semakan kebocoran memori. Apabila pilihan ini didayakan, katil
juga secara automatik akan memberikan "vg_leak" ciri yang boleh digunakan untuk
lumpuhkan (atau jangkakan kegagalan dalam) ujian tertentu secara bersyarat.

--ujian masa
Jejaki masa dinding yang diambil oleh ujian individu untuk dilaksanakan dan masukkan hasilnya
keluaran ringkasan. Ini berguna untuk menentukan ujian dalam suite ujian
mengambil masa yang paling banyak untuk melaksanakan. Ambil perhatian bahawa pilihan ini paling berguna dengan -j 1.

PEMILIHAN PILIHAN


--ujian-maks=N
Lari paling banyak N ujian dan kemudian ditamatkan.

--masa-maks=N
Berbelanja paling banyak N saat (kira-kira) menjalankan ujian dan kemudian tamatkan.

--kocok
Jalankan ujian dalam susunan rawak.

TAMBAHAN PILIHAN


--nyahpepijat
Main katil dalam mod nyahpepijat, untuk isu konfigurasi penyahpepijatan dan katil sendiri.

--show-suite
Senaraikan suite ujian yang ditemui dan keluar.

--tunjuk-ujian
Senaraikan semua ujian yang ditemui dan keluar.

EXIT STATUS


katil akan keluar dengan kod keluar 1 jika terdapat sebarang keputusan FAIL atau XPASS. Jika tidak,
ia akan keluar dengan status 0. Kod keluar lain digunakan untuk kegagalan berkaitan bukan ujian
(contohnya ralat pengguna atau ralat program dalaman).

UJIAN PENEMUAN


Input diserahkan kepada katil boleh sama ada ujian individu, atau keseluruhan direktori atau
hierarki ujian untuk dijalankan. Bila katil bermula, perkara pertama yang dilakukan ialah menukar
input ke dalam senarai lengkap ujian untuk dijalankan sebagai sebahagian daripada ujian penemuan.

Dalam katil model, setiap ujian mesti wujud dalam beberapa ujian suite. katil menyelesaikan input
ditentukan pada baris arahan untuk menguji suite dengan mencari ke atas dari laluan input
sehingga ia mendapati a lit.cfg or lit.site.cfg fail. Fail ini berfungsi sebagai kedua-dua penanda ujian
suite dan sebagai fail konfigurasi yang katil memuatkan untuk memahami cara mencari dan
jalankan ujian di dalam suite ujian.

Apabila katil telah memetakan input ke dalam suite ujian yang merentasi senarai penambahan input
ujian untuk fail individu dan secara rekursif mencari ujian dalam direktori.

Tingkah laku ini memudahkan untuk menentukan subset ujian untuk dijalankan, sementara masih membenarkan
konfigurasi suite ujian untuk mengawal dengan tepat cara ujian ditafsirkan. Sebagai tambahan, katil
sentiasa mengenal pasti ujian mengikut suite ujian yang mereka sertai, dan laluan relatifnya di dalam
suite ujian. Untuk projek yang dikonfigurasikan dengan betul, ini membolehkan katil untuk menyediakan kemudahan
dan sokongan fleksibel untuk binaan luar pokok.

UJIAN STATUS KEPUTUSAN


Setiap ujian akhirnya menghasilkan satu daripada enam keputusan berikut:

PAS
Ujian itu berjaya.

XFAIL
Ujian itu gagal, tetapi itu dijangka. Ini digunakan untuk format ujian yang membenarkan
menyatakan bahawa ujian tidak berfungsi pada masa ini, tetapi ingin meninggalkannya dalam suite ujian.

XPASS
Ujian itu berjaya, tetapi ia dijangka gagal. Ini digunakan untuk ujian yang
ditentukan seperti dijangka gagal, tetapi kini berjaya (biasanya kerana ciri
mereka ujian telah rosak dan telah ditetapkan).

GAGAL
Ujian itu gagal.

TIDAK DISELESAIKAN
Keputusan ujian tidak dapat ditentukan. Sebagai contoh, ini berlaku apabila ujian boleh
tidak dijalankan, ujian itu sendiri tidak sah, atau ujian telah terganggu.

TANPA SOKONGAN
Ujian tidak disokong dalam persekitaran ini. Ini digunakan oleh format ujian yang boleh
laporkan ujian yang tidak disokong.

Bergantung pada format ujian ujian boleh menghasilkan maklumat tambahan tentang status mereka
(biasanya hanya untuk kegagalan). Lihat OUTPUT PILIHAN seksyen untuk maklumat lanjut.

LIT INFRASTRUCTURE


Bahagian ini menerangkan tentang katil menguji seni bina untuk pengguna yang berminat untuk mencipta yang baharu
katil pelaksanaan ujian, atau melanjutkan pelaksanaan yang sedia ada.

katil proper adalah terutamanya infrastruktur untuk menemui dan menjalankan ujian sewenang-wenangnya, dan
untuk mendedahkan satu antara muka mudah kepada ujian ini. katil sendiri tidak tahu bagaimana untuk berlari
ujian, sebaliknya logik ini ditakrifkan oleh ujian suite.

UJIAN SUITES
Seperti yang dinyatakan dalam UJIAN PENEMUAN, ujian sentiasa terletak di dalam a ujian suite. Suite ujian
berfungsi untuk menentukan format ujian yang terkandung di dalamnya, logik untuk mencari ujian tersebut,
dan sebarang maklumat tambahan untuk menjalankan ujian.

katil mengenal pasti suite ujian sebagai direktori yang mengandungi lit.cfg or lit.site.cfg fail (lihat
Juga --config-prefix). Suite ujian pada mulanya ditemui dengan mencari secara rekursif
hierarki direktori untuk semua fail input yang dihantar pada baris arahan. Anda boleh gunakan
--show-suite untuk memaparkan suite ujian yang ditemui pada permulaan.

Setelah suite ujian ditemui, fail konfigurasinya dimuatkan. Fail konfigurasi sendiri adalah
Modul Python yang akan dilaksanakan. Apabila fail konfigurasi dilaksanakan, dua perkara penting
pembolehubah global dipratentukan:

lit_config
The global katil objek konfigurasi (a LitConfig instance), yang mentakrifkan builtin
format ujian, parameter konfigurasi global dan rutin pembantu lain untuk
melaksanakan konfigurasi ujian.

config
Ini ialah objek konfigurasi (a TestingConfig contoh) untuk suite ujian, yang
fail konfigurasi dijangka akan diisi. Pembolehubah berikut juga tersedia pada
config objek, sebahagian daripadanya mesti ditetapkan oleh konfigurasi dan yang lain adalah pilihan atau
pratakrif:

nama [diperlukan] Nama suite ujian, untuk digunakan dalam laporan dan diagnostik.

format_ujian [diperlukan] Objek format ujian yang akan digunakan untuk menemui dan dijalankan
ujian dalam suite ujian. Secara amnya ini akan menjadi format ujian terbina yang tersedia daripada
yang lit.formats modul.

test_source_root Laluan sistem fail ke root suite ujian. Untuk binaan di luar direktori
ini ialah direktori yang akan diimbas untuk ujian.

test_exec_root Untuk binaan luar dir, laluan ke akar suite ujian di dalam objek
direktori. Di sinilah ujian akan dijalankan dan fail output sementara diletakkan.

persekitaran Kamus yang mewakili persekitaran untuk digunakan semasa melaksanakan ujian dalam
suite.

akhiran Bagi katil format ujian yang mengimbas direktori untuk ujian, pembolehubah ini ialah senarai
akhiran untuk mengenal pasti fail ujian. Digunakan oleh: ShTest.

penggantian Bagi katil format ujian yang menggantikan pembolehubah ke dalam skrip ujian, the
senarai penggantian yang perlu dilakukan. Digunakan oleh: ShTest.

tidak disokong Tandai direktori yang tidak disokong, semua ujian di dalamnya akan dilaporkan sebagai
tidak disokong. Digunakan oleh: ShTest.

ibu bapa Konfigurasi induk, ini ialah objek konfigurasi untuk direktori yang mengandungi
suite ujian, atau Tiada.

akar Konfigurasi akar. Ini adalah yang paling tinggi katil konfigurasi dalam projek.

paip gagal Biasanya ujian menggunakan paip shell gagal jika mana-mana arahan pada paip
gagal. Jika ini tidak diingini, menetapkan pembolehubah ini kepada palsu menjadikan ujian gagal sahaja
jika arahan terakhir dalam paip gagal.

UJIAN PENEMUAN
Setelah suite ujian ditemui, katil secara rekursif melintasi direktori sumber (berikut
test_source_root) mencari ujian. Bila katil memasuki sub-direktori, ia mula-mula menyemak ke
lihat jika suite ujian bersarang ditakrifkan dalam direktori itu. Jika ya, ia memuatkan suite ujian itu
secara rekursif, jika tidak, ia membuat konfigurasi ujian tempatan untuk direktori (lihat LOKAL
CONFIGURATION FILES).

Ujian dikenal pasti oleh suite ujian yang terkandung di dalamnya, dan laluan relatif
di dalam suite itu. Ambil perhatian bahawa laluan relatif mungkin tidak merujuk kepada fail sebenar pada cakera;
beberapa format ujian (seperti GoogleTest) mentakrifkan "ujian maya" yang mempunyai laluan itu
mengandungi kedua-dua laluan ke fail ujian sebenar dan sublaluan untuk mengenal pasti ujian maya.

LOKAL CONFIGURATION FILES
Bila katil memuatkan subdirektori dalam suite ujian, ia mewujudkan konfigurasi ujian tempatan
dengan mengklonkan konfigurasi untuk direktori induk --- punca konfigurasi ini
rantai akan sentiasa menjadi suite ujian. Setelah konfigurasi ujian diklon katil memeriksa untuk a
lit.local.cfg fail dalam subdirektori. Jika ada, fail ini akan dimuatkan dan boleh
digunakan untuk mengkhususkan konfigurasi bagi setiap direktori individu. Kemudahan ini boleh
digunakan untuk menentukan subdirektori ujian pilihan, atau untuk menukar konfigurasi lain
parameter --- sebagai contoh, untuk menukar format ujian, atau akhiran yang mengenal pasti ujian
fail.

UJIAN RUN OUTPUT FORMAT
. katil output untuk larian ujian mematuhi skema berikut, dalam kedua-dua pendek dan verbose
mod (walaupun dalam mod pendek tiada garis LULUS akan ditunjukkan). Skema ini telah dipilih
menjadi agak mudah untuk dihuraikan dengan pasti oleh mesin (contohnya dalam log buildbot
mengikis), dan alat lain untuk menjana.

Setiap keputusan ujian dijangka muncul pada baris yang sepadan:

: ( )

di mana ialah keputusan ujian standard seperti LULUS, GAGAL, ​​XFAIL, XPASS,
TIDAK DISELESAIKAN, atau TIDAK DISOKONG. Kod hasil prestasi IPROVED dan REGRESSED ialah
juga dibenarkan.

. <test nama> medan boleh terdiri daripada rentetan arbitrari yang tidak mengandungi baris baharu.

. <progress maklumat> medan boleh digunakan untuk melaporkan maklumat kemajuan seperti (1/300) atau
boleh kosong, tetapi walaupun kosong, kurungan diperlukan.

Setiap keputusan ujian mungkin termasuk maklumat log tambahan (berbilang baris) dalam perkara berikut
format:

UJIAN '( )'
... mesej log ...


di mana <test nama> hendaklah nama ujian yang dilaporkan sebelumnya, <log delineator> ialah
rentetan aksara "*". at kurangnya empat aksara panjang (panjang yang disyorkan ialah 20), dan
<trailing delineator> ialah rentetan arbitrari (tidak dihuraikan).

Berikut ialah contoh keluaran ujian yang terdiri daripada empat ujian A, B, C dan
D, dan mesej log untuk ujian yang gagal C:

LULUS: A (1 daripada 4)
LULUS: B (2 daripada 4)
GAGAL: C (3 daripada 4)
****************** UJIAN 'C' GAGAL ******************
Ujian 'C' gagal akibat kod keluar 1.
********************
LULUS: D (4 daripada 4)

LIT CONTOH UJIAN
. katil pengedaran mengandungi beberapa contoh pelaksanaan suite ujian dalam
ContohUjian direktori.

Gunakan lit-3.7 dalam talian menggunakan perkhidmatan onworks.net


Ad


Ad