aet - Dalam talian di Awan

JADUAL:

NAMA

ujian aegis - menjalankan ujian

SINOPSIS

naungan -Ujian [ pilihan... ][ nama=nilai ][ nama fail... ]
naungan -Ujian -Bebas [ pilihan... ][ nama=nilai ][ nama fail... ]
naungan -Ujian -Senarai [ pilihan... ]
naungan -Ujian -Tolong

DESCRIPTION

. naungan -Ujian arahan digunakan untuk menjalankan ujian. Jika tiada fail dinamakan, semua ujian yang berkaitan
sedang dijalankan. Secara lalai kedua-dua ujian automatik dan manual dijalankan.

Anda boleh menamakan direktori pada baris arahan, dan semua ujian yang berkaitan dalam direktori itu
pokok dalam perubahan akan dijalankan. Ia adalah ralat jika tiada ujian yang berkaitan.

Setiap seni bina mesti diuji secara berasingan. Ini kerana mungkin ada yang halus
masalah yang hanya didedahkan pada beberapa seni bina. Sesetengah projek mungkin juga mempunyai
kod yang berbeza untuk seni bina yang berbeza.

Status larian ujian terakhir diingati supaya ujian tidak dijalankan jika tiada
perlukan. (Ini tidak terpakai kepada -REGRESI ujian, malangnya.) Ujian mesti dijalankan semula
jika ujian sebelum ini gagal, jika fail ujian telah berubah, jika terdapat binaan,
dan untuk setiap seni bina.

nama=nilai
Anda boleh menambah nama=nilai pasangan ke baris arahan, ini akan dihantar tidak berubah kepada
perintah ujian. Biasanya pada penghujung baris arahan, tetapi ini boleh diubah dalam
fail konfigurasi projek.

. -paksa pilihan menghasilkan daya tersirat=1 pembolehubah ditambah ke senarai
tugasan berubah-ubah, dan dengan itu ditambah pada penghujung arahan. Ini adalah yang paling berguna apabila
menggunakan perintah_ujian_batch memfailkan fail konfigurasi projek.

Ini pada mulanya mungkin kelihatan seperti proses pembangunan yang dijalankan akhir, membenarkan skrip ujian
ditulis supaya mereka memberikan semua jawapan yang betul tanpa melakukan apa-apa. awak
sentiasa dapat melakukan ini dengan pembolehubah persekitaran, jadi ini bukan sesuatu yang baharu.

Adalah mungkin untuk mendapatkan semua tugasan pembolehubah untuk bertukar menjadi pembolehubah persekitaran
dengan meletakkan $var pada permulaan daripada arahan itu, sebelum nama shell, bukannya di
lokasi lalai pada akhir arahan.

File Nama Tafsiran
Program aegis akan cuba menentukan nama fail projek daripada nama fail
diberikan pada baris arahan. Semua nama fail disimpan dalam projek aegis sebagai relatif
kepada akar pokok direktori garis dasar. Direktori pembangunan dan
direktori integrasi adalah bayang-bayang direktori garis dasar ini, dan nama relatif ini
memohon di sini juga. Fail yang dinamakan pada baris arahan mula-mula ditukar kepada laluan mutlak
jika perlu. Mereka kemudiannya dibandingkan dengan laluan garis dasar, direktori pembangunan
laluan, dan laluan direktori penyepaduan, untuk menentukan nama relatif garis dasar. Ia adalah
ralat jika fail yang dinamakan berada di luar salah satu daripada pepohon direktori ini.

. -BAse_RElative pilihan boleh digunakan untuk menyebabkan nama fail relatif ditafsirkan sebagai
relatif kepada laluan garis dasar; nama fail mutlak masih akan dibandingkan dengan pelbagai
laluan untuk menentukan nama relatif garis dasar.

. relative_filename_preference dalam fail konfigurasi pengguna boleh digunakan untuk mengubah suai
tingkah laku lalai ini. Lihat aeuconf(5) untuk maklumat lanjut.

UJIAN PROSES

Setiap perubahan perlu disertakan dengan ujian, dan ujian tersebut diperlukan
dijalankan terhadap direktori pembangunan yang dibina, dan mereka mesti lulus. Ini memastikan bahawa baru
fungsi disertakan dengan ujian untuk mengesahkan ketepatannya, dan pembetulan pepijat
disertai dengan ujian yang mengesahkan bahawa pepijat telah diperbaiki.

Regresi Ujian
Ujian dianggap sebagai mana-mana fail sumber lain, dan dikekalkan dalam garis dasar dan
sejarah dengan semua fail sumber lain. Ujian yang mesti mengiringi setiap perubahan
terkumpul dalam garis dasar projek, memberikan definisi fungsi yang betul untuk
garis dasar. Ujian terkumpul ini boleh dilaksanakan menggunakan arahan "aegis -REGression",
untuk mengesahkan bahawa projek itu tidak akan "kembali" akibat daripada perubahan.

Baseline Ujian
Pembetulan pepijat diperlukan untuk menjalani ujian mereka gagal terhadap garis dasar projek (sebaliknya
ke direktori pembangunan). Ini memastikan bahawa ujian benar-benar menunjukkan pepijat
dalam garis dasar, serta menunjukkan bahawa ia ditetapkan oleh perubahan. Baru
kefungsian secara remeh gagal terhadap garis dasar, dan oleh itu aegis tidak cuba melakukannya
rasa jika ujian adalah ujian pembetulan pepijat atau ujian kefungsian baharu, ia hanya memerlukan ujian
gagal terhadap garis dasar.

Keperluan ini terpakai kepada kedua-dua ujian baharu yang dibuat oleh perubahan dan juga pada ujian
yang telah disalin ke dalam perubahan untuk pengubahsuaian.

Mengkaji Ujian
Penyemak mungkin yakin bahawa aegis telah menguatkuasakan keperluan ujian; itu perubahan
mesti ada ujian, perubahan mesti dibina, ujian itu melepasi pembangunan
direktori, dan bahawa ujian gagal terhadap garis dasar. Syarat-syarat ini dikuatkuasakan
by aede(1) dan perubahan itu tidak akan dimajukan kepada menjadi -Semula nyatakan sehingga ini
syarat dipenuhi. Oleh itu, penyemak hendaklah menyemak ujian untuk kesempurnaan liputan daripada
kod dalam perubahan, dan ketidakpekaan terhadap perubahan dalam persekitaran pelaksanaan (cth
tidak sensitif tarikh). Penyemak juga harus menggunakan "aegis -list change_details" untuk mengesahkan
bahawa perubahan mempunyai atau tidak mempunyai pengecualian ujian.

Pengecualian
Pelbagai pengecualian ujian boleh diberikan oleh pentadbir projek, lihat aepa(1) dan
aepattr(5) untuk maklumat lanjut. Menyalin ujian ke dalam perubahan, atau menambah ujian baharu pada a
perubahan, boleh membatalkan pengecualian tersebut.

UJIAN COMMAND CONFIGURATION

Perintah yang digunakan untuk melaksanakan ujian ditakrifkan oleh test_command lapangan dalam projek
fail konfigurasi (lihat aepconf(5) untuk maklumat lanjut), ini lalai untuk menggunakan
Bourne shell jika tidak ditetapkan. Direktori semasa akan menjadi bahagian atas yang sesuai
pokok direktori. Jika ujian memerlukan fail sementara, mereka harus menciptanya / tmp, sebagai
ujian tidak boleh mengharapkan untuk mempunyai kebenaran menulis dalam direktori semasa.

Jika anda ingin menggunakan enjin ujian yang lebih canggih, dan bukannya skrip shell mudah,
tetapi enjin ujian ini tidak mengembalikan kod hasil yang sesuai untuk digunakan dengan aegis, anda boleh
bungkusnya dalam skrip shell yang menulis semula status keluar ke dalam nilai yang diharapkan oleh aegis.
Anda juga boleh mencapai hasil yang sama dengan menulis yang lebih kompleks test_command dalam
projek config fail.

Ia juga mungkin untuk menulis arahan ujian yang dapat menguji lebih daripada satu fail di
sekali. Ini dikawal oleh perintah_ujian_batch bidang projek config fail. Dalam
kes ini, penggantian ${output} menunjukkan nama fail yang mesti dilakukan oleh arahan ujian
mencipta, dalam aetest(5) format, untuk mengandungi keputusan ujian yang dijalankan. Ini sering digunakan
pada sistem dengan berbilang CPU atau keupayaan untuk mengagihkan kerja merentasi beberapa komputer
pada rangkaian.

Penggantian
Semua aesub(5) penggantian tersedia dalam arahan ujian. Sebahagian daripada mereka adalah
perhatian khusus:

SENIBINA
Penggantian ini digantikan dengan nama seni bina yang akan diuji.

Search_Path
Penggantian ini digantikan dengan senarai laluan mutlak yang dipisahkan bertindih ke
cari apabila mencari fail sokongan ujian.

Search_Path_Executable
Penggantian ini digantikan dengan senarai laluan mutlak yang dipisahkan bertindih ke
cari apabila mencari fail sokongan boleh laku (fail perpustakaan dan sub-
perintah).

Selalunya $Search_Path_Executable adalah sama. Walau bagaimanapun, semasa “aegis -t
-bl” mereka akan berbeza, dengan $Seach_Path bermula pada direktori pembangunan (the
ujian sedang dijalankan) dan $Seach_Path_Executable bermula pada garis dasar (makhluk boleh laku
lari).

ujian Hasilnya Kod
Apabila setiap ujian dijalankan (melalui test_command lapangan dalam projek config fail), aegis
menentukan sama ada ujian itu berjaya atau gagal dengan melihat status keluarnya. Jalan keluar ini
status kebanyakannya seperti yang dijangkakan untuk arahan UNIX.

Kejayaan
Ujian harus keluar dari 0 untuk menunjukkan kejayaan, iaitu fungsi khusus yang sedang diuji
bekerja seperti yang diharapkan.

Kegagalan
Ujian harus keluar 1 untuk menunjukkan kegagalan, iaitu fungsi khusus yang sedang diuji
tidak berfungsi seperti yang diharapkan.

Tiada keputusan
Ujian harus keluar 2 untuk menunjukkan tiada keputusan, iaitu bahawa fungsi khusus di bawah
ujian tidak dapat dijalankan kerana ada masalah lain. Contohnya, berlari
kehabisan ruang cakera apabila mencipta fail input ujian dalam / tmp direktori.

Dilangkau
Ujian harus keluar 77 untuk menunjukkan bahawa ia telah dilangkau. Ini biasanya berkaitan dengan
seni bina semasa tidak bermakna. Apabila boleh, gunakan "Tiada Hasil"
sebaliknya. (Nilai telah dipilih untuk keserasian dengan sistem ujian lain.)

Sebenarnya, sebarang kod keluar selain 0, 1 atau 77 akan ditafsirkan sebagai "tiada hasil".
Walau bagaimanapun, sentiasa menggunakan 0, 1, 2 atau 77 bermakna jika kod keputusan baharu diperlukan oleh a
kemudian keluaran Aegis ujian sedia ada anda akan terus berfungsi.

UJIAN KORELASI

Perintah "aegis -Test -SUGgest" boleh digunakan untuk meminta aegis mencadangkan regresi yang sesuai
ujian untuk perubahan anda, berdasarkan fail sumber dalam perubahan anda. Ini secara automatik
memfokuskan usaha ujian kepada ujian yang berkaitan, mengurangkan bilangan ujian regresi
perlu untuk yakin bahawa anda tidak memperkenalkan pepijat.

Korelasi ujian dijana oleh arahan "aegis -Integrate_Pass", yang
mengaitkan setiap ujian dalam perubahan dengan setiap fail sumber dalam perubahan. Justeru, setiap
fail sumber mengumpul senarai ujian yang telah dikaitkan dengannya pada masa lalu.
Ini tidak tepat seperti analisis liputan kod, tetapi merupakan anggaran yang munasabah dalam
amalan.

. aecp(1) dan aenf(1) arahan digunakan untuk mengaitkan fail dengan perubahan. Sedangkan mereka
tidak melakukan perkaitan secara aktif, ini adalah fail yang digunakan oleh aeipass(1) dan
aet(1) untuk menentukan fail sumber yang dikaitkan dengan ujian mana.

ujian Korelasi Ketepatan
Dengan mengandaikan bahawa korelasi ujian adalah tepat dan ujian adalah sama rata
diedarkan merentasi ruang fungsi, akan ada kurang daripada 1/nombor peluang bahawa a
ujian yang berkaitan belum dijalankan oleh “aegis -Test -SUGgest nombor” perintah. Kecil
jumlah hingar ditambah pada pemberat ujian, jadi kadangkala perkara yang tidak dijangka berlaku
diuji, dan ujian yang sama tidak dijalankan setiap kali.

Ketepatan korelasi ujian boleh dipertingkatkan dengan memastikan bahawa:

· Setiap perubahan harus difokuskan dengan kuat, tanpa kemasukan fail yang tidak sepatutnya. ini
mengelakkan korelasi palsu.

· Setiap item kefungsian baharu perlu ditambah dalam perubahan individu, bukannya
beberapa bersama-sama. Ini sangat mengaitkan ujian dengan kefungsian.

· Setiap pepijat harus diperbaiki dalam perubahan individu, bukannya beberapa bersama-sama. ini
sangat mengaitkan ujian dengan kefungsian.

· Perkaitan ujian akan hilang jika fail dialihkan. Ini kerana korelasi adalah oleh
nama.

Cara terbaik untuk ujian mengaitkan dengan tepat dengan fail sumber ialah apabila berlaku perubahan
mengandungi ujian dan betul-betul fail yang berkaitan dengan fungsi yang sedang diuji. Juga
banyak fail palsu akan melemahkan kegunaan korelasi ujian.

PILIHAN

Pilihan berikut difahami:

-AUTOmatik
Pilihan ini boleh digunakan untuk menentukan ujian automatik. Ujian automatik memerlukan no
bantuan manusia.

-Baseline
Pilihan ini boleh digunakan untuk menentukan bahawa garis dasar projek adalah subjek
perintah itu.

-BAse_RElative
Pilihan ini boleh digunakan untuk menyebabkan nama fail relatif dianggap relatif kepada
pangkal pokok sumber. Lihat aeuconf(5) untuk pengguna yang sepadan
keutamaan.

-CUrrent_RElative
Pilihan ini boleh digunakan untuk menyebabkan nama fail relatif dianggap relatif kepada
direktori semasa. Ini biasanya lalai. Lihat aeuconf(5) untuk
keutamaan pengguna yang sepadan.

-Ubah nombor
Pilihan ini boleh digunakan untuk menentukan perubahan tertentu dalam projek. Lihat
naungan(1) untuk penerangan lengkap tentang pilihan ini.

-Paksa Pilihan ini boleh digunakan untuk menentukan bahawa semua ujian harus dijalankan, walaupun jika
status larian ujian terakhir menunjukkan bahawa tidak ada keperluan untuk menjalankan tertentu
ujian.

-Tolong
Pilihan ini boleh digunakan untuk mendapatkan maklumat lanjut tentang cara menggunakan naungan
program.

-Bebas
Pilihan ini digunakan untuk menentukan bahawa ujian akan dijalankan secara bebas daripada mana-mana
perubahan tertentu. Jika tiada ujian dinamakan, semua ujian dalam garis dasar akan dijalankan.

-Senarai
Pilihan ini boleh digunakan untuk mendapatkan senarai subjek yang sesuai untuk arahan ini.
Senarai itu mungkin lebih umum daripada yang dijangkakan.

-Manual Pilihan ini boleh digunakan untuk menentukan ujian manual. Ujian manual memerlukan beberapa manusia
campur tangan, cth: pengesahan beberapa kelakuan skrin (X11, contohnya), atau
beberapa tindakan pengguna, "cabut kabel ethernet sekarang".

-Bukan_Logging
Pilihan ini boleh digunakan untuk melumpuhkan pengelogan automatik output dan ralat ke
sebuah fail. Ini selalunya berguna apabila beberapa arahan aegis digabungkan dalam shell
skrip.

-Tabah
Pilihan ini boleh digunakan untuk menentukan bahawa semua ujian harus dijalankan, walaupun beberapa
gagal. Lalai kepada pengguna tabah_keutamaan jika tidak dinyatakan, lihat
aeuconf(5) untuk maklumat lanjut.

-Tiada_PERSevere
Pilihan ini boleh digunakan untuk menentukan bahawa larian ujian harus berhenti selepas yang pertama
kegagalan. Lalai kepada pengguna tabah_keutamaan jika tidak dinyatakan, lihat
aeuconf(5) untuk maklumat lanjut.

-Projek nama
Pilihan ini boleh digunakan untuk memilih projek yang diminati. Apabila tidak -Projek
pilihan ditentukan, iaitu AEGIS_PROJECT pembolehubah persekitaran dirujuk. Jika
yang tidak wujud, milik pengguna $HOME/.aegisrc fail diperiksa untuk lalai
bidang projek (lihat aeuconf(5) untuk maklumat lanjut). Jika itu tidak wujud,
apabila pengguna hanya mengusahakan perubahan dalam satu projek, projek
nama lalai kepada projek itu. Jika tidak, ia adalah satu kesilapan.

-KEMAJUAN
Pilihan ini boleh digunakan untuk menentukan bahawa mesej kemajuan harus dikeluarkan sebelum ini
setiap ujian dijalankan atau sebelum setiap ujian kelompok dijalankan sekiranya berlaku perintah_ujian_batch bidang
dinyatakan dalam projek config fail (lihat aeuconf(5) untuk maklumat lanjut).

-Tiada_PROGress
Pilihan ini boleh digunakan untuk menentukan bahawa mesej kemajuan harus ditindas.
Ini adalah lalai.

-REGRESI
Pilihan ini digunakan untuk menentukan bahawa suite ujian regresi akan dijalankan. The
suite ujian regresi terdiri daripada semua ujian dalam garis dasar yang tidak muncul
dalam perubahan. Ia adalah ralat jika tiada ujian regresi. Anda mungkin tidak
ujian nama pada baris arahan apabila menggunakan pilihan -REGression. Anda boleh namakan
ujian individu untuk dijalankan pada baris arahan, tanpa menggunakan -REGression
pilihan; jika mereka bukan sebahagian daripada perubahan, ujian dengan nama yang sama dalam
garis dasar akan dijalankan.

-CADANGAN [ nombor ]
The "naungan -Integrate_Pass” perintah mengumpul statistik korelasi ujian apabila
perubahan disepadukan. Pilihan ini boleh digunakan untuk meminta cadangan aegis
ujian mana yang harus dijalankan, menggunakan korelasi ujian ini. Jika tiada nombor
dinyatakan, 10 ujian akan dicadangkan. Pilihan ini membayangkan -REGRESI
pilihan.

-SUGgest_Limit minit
Pilihan ini boleh digunakan untuk mengehadkan bilangan ujian kepada bilangan tertentu
minit. Ia akan dijalankan daripada yang paling relevan kepada paling kurang relevan.

-CADANGAN_Bunyi nombor
Pilihan ini boleh digunakan untuk mengawal jumlah bunyi yang disuntik ke dalam ujian
pemilihan yang dilakukan oleh -CADANGAN pilihan. Nombornya ialah peratusan bunyi
untuk disuntik. Lalai kepada 10 jika tidak dinyatakan. Suntikan bunyi bising memastikan
bahawa pelbagai ujian dijalankan pada larian berikutnya, dan juga beberapa dari medan kiri
sebagai pemeriksaan kewarasan.

-TERse
Pilihan ini boleh digunakan untuk menyebabkan penyenaraian menghasilkan sekurang-kurangnya
maklumat. Ia biasanya berguna untuk skrip shell.

-Verbose
Pilihan ini boleh digunakan untuk menyebabkan aegis menghasilkan lebih banyak output. Secara lalai aegis
hanya menghasilkan output pada ralat. Apabila digunakan dengan -Senarai pilihan pilihan ini
menyebabkan tajuk lajur ditambah.

-Tunggu Pilihan ini boleh digunakan untuk meminta arahan Aegis menunggu kunci akses, jika
mereka tidak boleh diperolehi dengan segera. Lalai kepada pengguna lock_wait_preference
jika tidak dinyatakan, lihat aeuconf(5) untuk maklumat lanjut.

-Tidak_Tunggu
Pilihan ini boleh digunakan untuk menghendaki arahan Aegis untuk mengeluarkan ralat maut jika akses
kunci tidak boleh diperolehi dengan segera. Lalai kepada pengguna
lock_wait_preference jika tidak dinyatakan, lihat aeuconf(5) untuk maklumat lanjut.

Lihat juga naungan(1) untuk pilihan biasa kepada semua arahan aegis.

Semua pilihan boleh dipendekkan; singkatan didokumentasikan sebagai huruf besar,
semua huruf kecil dan garis bawah (_) adalah pilihan. Anda mesti menggunakan berturut-turut
urutan huruf pilihan.

Semua pilihan adalah tidak sensitif huruf besar-besaran, anda boleh menaipnya dalam huruf besar atau huruf kecil atau a
gabungan kedua-duanya, kes tidak penting.

Contohnya: hujah "-project, "-PROJ" dan "-p" semuanya ditafsirkan bermaksud
-Projek pilihan. Hujah "-prj" tidak akan difahami, kerana berturut-turut
aksara pilihan tidak dibekalkan.

Pilihan dan argumen baris arahan lain boleh dicampur sewenang-wenangnya pada baris arahan,
selepas pemilih fungsi.

Nama pilihan panjang GNU difahami. Oleh kerana semua nama pilihan untuk naungan panjang,
ini bermakna mengabaikan tambahan terkemuka '-'. "--pilihan=nilai"konvensyen juga
faham.

RECOMMENDED ALIAS

Alias ​​yang disyorkan untuk arahan ini ialah
csh% alias aet 'aegis -t \!* -v'
sh$ aet(){aegis -t "$@" -v}

KESALAHAN

Ia adalah ralat jika perubahan itu bukan dalam salah satu daripada menjadi maju or menjadi bersepadu
negeri.
Ia adalah ralat jika perubahan tidak diberikan kepada pengguna semasa.
Ia adalah ralat jika anda tidak mempunyai ujian yang berkaitan dan tiada pengecualian yang berkaitan.

EXIT STATUS

. naungan arahan akan keluar dengan status 1 pada sebarang ralat. The naungan perintah akan sahaja
keluar dengan status 0 jika tiada ralat.

PERSEKITARAN PELBAGAI

Lihat naungan(1) untuk senarai pembolehubah persekitaran yang boleh menjejaskan arahan ini. Lihat
aepconf(5) untuk fail konfigurasi projek projek_khusus medan untuk cara menetapkan
pembolehubah persekitaran untuk semua arahan yang dilaksanakan oleh Aegis.

Gunakan aet dalam talian menggunakan perkhidmatan onworks.net