Ini ialah arahan api-sanity-checker 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
api-sanity-checker - penjana automatik ujian unit asas untuk API perpustakaan C/C++.
DESCRIPTION
NAMA:
API Sanity Checker (api-sanity-checker) Hasilkan ujian unit asas untuk C/C++
API perpustakaan
HURAIAN:
API Sanity Checker ialah penjana automatik ujian unit asas untuk C/C++
perpustakaan. Ia membantu untuk menjana ujian mudah ("kewarasan" atau "cetek" kualiti) dengan cepat
untuk setiap fungsi dalam API menggunakan tandatangan mereka, definisi jenis data dan
perhubungan antara fungsi terus daripada fail pengepala perpustakaan
("Generasi Didorong Pengepala"). Setiap kes ujian mengandungi panggilan fungsi dengan
munasabah (dalam kebanyakan, tetapi malangnya tidak semua, kes) parameter input. The
kualiti ujian yang dijana membolehkan seseorang menyemak ketiadaan ralat kritikal secara ringkas
kes penggunaan dan boleh dipertingkatkan dengan lebih baik dengan melibatkan kepakaran yang boleh diguna semula
jenis untuk perpustakaan.
Alat ini boleh melaksanakan ujian yang dijana dan mengesan ranap sistem, membatalkan, semua jenis
isyarat yang dipancarkan, kod pulangan program bukan sifar, gantung program dan keperluan
kegagalan (jika dinyatakan). Alat ini boleh dianggap sebagai alat untuk keluar dari kotak
pemeriksaan kewarasan kos rendah API perpustakaan atau sebagai rangka kerja pembangunan ujian untuk
penjanaan awal templat untuk ujian lanjutan. Juga ia menyokong universal
Format ujian Template2Code, spesifikasi splint, mod penjanaan ujian rawak
dan ciri berguna lain.
Alat ini adalah perisian percuma: anda boleh mengedarkannya semula dan/atau mengubah suainya di bawah
syarat GNU LGPL atau GNU GPL.
PENGGUNAAN:
api-sanity-checker [pilihan]
CONTOH:
api-kewarasan-pemeriksa -lib NAMA -d VER.xml -gen -membina -run
VERSION.xml ialah deskriptor XML:
1.0
/path1/to/header(s)/ /path2/to/header(s)/
...
/path1/to/library(ies)/ /path2/to/library(ies)/
...
SYARIKAT PILIHAN:
-h|-bantuan
Cetak bantuan ini.
-maklumat
Cetak maklumat lengkap.
-v|-versi
Maklumat versi cetakan.
-pembuangan
Cetak versi alat (1.98.7) dan jangan lakukan apa-apa lagi.
UMUM PILIHAN:
-l|-lib|-perpustakaan NAMA
Nama perpustakaan (tanpa versi).
-d|-deskriptor PATH
Laluan ke deskriptor perpustakaan (fail VER.xml):
1.0
/path1/to/header(s)/ /path2/to/header(s)/ ...
/path1/to/library(ies)/ /path2/to/library(ies)/ ...
Untuk maklumat lanjut, sila lihat:
http://lvc.github.com/api-sanity-checker/Xml-Descriptor.html
-gen|-menjana
Hasilkan ujian. Pilihan -l and -d hendaklah dinyatakan. Untuk menjana ujian untuk
fungsi tertentu menggunakannya dengan -f pilihan. Kod keluar: bilangan kes ujian gagal
bina.
-membina|-buat
Membina ujian. Pilihan -l and -d hendaklah dinyatakan. Untuk membina ujian untuk
fungsi tertentu menggunakannya dengan -f pilihan. Kod keluar: bilangan kes ujian gagal
untuk menjana.
-run
Jalankan ujian, buat laporan ujian. Pilihan -l and -d hendaklah dinyatakan. Untuk berlari
menguji untuk fungsi tertentu menggunakannya dengan -f pilihan. Kod keluar: bilangan
kes ujian gagal.
-bersih
Ujian bersih. Pilihan -l and -d hendaklah dinyatakan. Untuk membersihkan ujian untuk
fungsi tertentu menggunakannya dengan -f pilihan.
EXTRA PILIHAN:
-vnum NUM
Tentukan versi perpustakaan di luar deskriptor.
-s|-simbol NAMA
Ujian Generate/Build/Run untuk fungsi yang ditentukan (nama hancur dalam C++).
-simbol-senarai PATH
Pilihan ini membolehkan seseorang menentukan fail dengan senarai fungsi (satu setiap baris,
nama hancur dalam C++) yang harus diuji, fungsi perpustakaan lain tidak akan
diuji.
-kepala NAMA
Pilihan ini membolehkan seseorang menyekat senarai fungsi yang harus diuji oleh
menyediakan nama fail pengepala di mana ia diisytiharkan. Pilihan ini bertujuan
untuk pembangunan ujian langkah demi langkah.
-semua
Hasilkan ujian untuk semua simbol yang disertakan secara rekursif dalam fail pengepala.
-xvfb
Gunakan Xvfb-server dan bukannya X-server semasa (lalai) untuk menjalankan ujian.
-t2c|-template2code
Hasilkan ujian dalam format Template2Code universal. Untuk maklumat lanjut, sila
lihat:
http://sourceforge.net/projects/template2code/
-ketat-gen
Tamatkan proses menjana ujian dan kembalikan kod ralat '1' jika tidak boleh
menjana sekurang-kurangnya satu kes ujian.
-ketat-bina
Tamatkan proses membina ujian dan kembalikan kod ralat '1' jika tidak dapat dibina
sekurang-kurangnya satu kes ujian.
-lari ketat
Tamatkan proses menjalankan ujian dan kembalikan kod ralat '1' jika sekurang-kurangnya satu
kes ujian gagal.
-ketat
Pilihan ini membolehkan semua -ketat-* pilihan.
-r|-rawak
Mod penjanaan ujian rawak.
-min
Hasilkan kod minimun, fungsi panggilan dengan bilangan minimum parameter untuk
mulakan parameter fungsi lain.
-maks
Hasilkan kod maksimum, fungsi panggilan dengan bilangan maksimum parameter untuk
mulakan parameter fungsi lain.
-pertunjukkan semula
Tunjukkan jenis pemulangan fungsi dalam laporan.
-semak-semula
Masukkan keperluan pada nilai pulangan (retval!=NULL) untuk setiap fungsi yang dipanggil.
-st|-jenis-khusus PATH
Laluan ke fail dengan koleksi jenis khusus. Untuk maklumat lanjut,
sila lihat:
http://lvc.github.com/api-sanity-checker/Specialized-Type.html
-td|-test-data PATH
Laluan ke direktori dengan fail data ujian. Untuk maklumat lanjut, sila lihat:
http://lvc.github.com/api-sanity-checker/Specialized-Type.html
-tajuk-sahaja
Jika perpustakaan terdiri daripada fungsi sebaris sahaja dan tidak mempunyai objek kongsi maka anda
harus menentukan pilihan ini.
-tiada sebaris
Jangan jana ujian untuk fungsi sebaris.
-simpan-dalaman
Hasilkan ujian untuk simbol dalaman (fungsi dengan awalan '__' dan kaedah
kelas yang diisytiharkan di dalam kelas lain).
-terpencil
Benarkan untuk menyekat penggunaan fungsi oleh senarai yang ditentukan oleh -senarai-fungsi
pilihan atau oleh pembahagian kumpulan dalam deskriptor.
-lihat sahaja
Alih keluar semua fail daripada suite ujian kecuali fail *.html. Pilihan ini membolehkan seseorang untuk
buat indeks-html yang ringan untuk semua ujian.
-disable-default-values
Lumpuhkan penggunaan nilai lalai untuk parameter fungsi.
-optimumkan-termasuk LEVEL
Dayakan pengoptimuman senarai pengepala yang disertakan dalam setiap kes ujian. Tersedia
tahap:
Tinggi (lalai) Sederhana Rendah Tiada - lumpuhkan
-p|-params LALUAN
Laluan ke fail dengan nama parameter fungsi. Ia boleh digunakan untuk penambahbaikan
menjana ujian jika fail pengepala perpustakaan tidak mengandungi nama parameter. Fail
format:
func1;param1;param2;param3 ... func2;param1;param2;param3 ... ...
-tajuk NAMA
Nama perpustakaan dalam tajuk laporan.
-relpath|-reldir LALUAN
Gantikan {RELPATH} dalam deskriptor pustaka dengan PATH.
-bahasa BAHASA
Tetapkan bahasa perpustakaan (C atau C++). Anda boleh menggunakan pilihan ini jika alat itu tidak boleh
auto-kesan bahasa.
-sasaran PENYUSUN
Pengkompil yang harus digunakan untuk membina ujian yang dijana di bawah Windows.
Disokong:
gcc - Pengkompil GNU cl - Pengkompil MS (lalai)
-nyahpepijat
Tulis log lanjutan untuk nyahpepijat.
-cache
Cache pembuangan ABI dan gunakannya pada larian seterusnya.
LAIN PILIHAN:
-test
Jalankan ujian dalaman. Buat perpustakaan ringkas dan jalankan alat padanya. Pilihan ini
membolehkan seseorang menyemak sama ada alat berfungsi dengan betul pada sistem.
-disable-variable-reuse
Lumpuhkan penggunaan semula pembolehubah yang dibuat sebelum ini dalam ujian.
-nama-pembolehubah-panjang
Dayakan nama pembolehubah panjang (kompleks) dan bukannya nama pendek.
EXIT KOD:
0 - Ujian yang berjaya. Alat telah berjalan tanpa sebarang ralat. bukan sifar - Ujian gagal
atau alat telah berjalan dengan ralat.
MORE MAKLUMAT:
http://lvc.github.com/api-sanity-checker/
Gunakan api-sanity-checker dalam talian menggunakan perkhidmatan onworks.net