lit-3.7 - Bulutta Çevrimiçi

Program:

ADI

yanıyor - LLVM Entegre Test Cihazı

SİNOPSİS

yatak [seçenekleri] [testleri]

TANIM

yatak LLVM ve Clang tarzı test takımlarını yürütmek için taşınabilir bir araçtır,
Sonuçlar ve başarısızlıkların belirtilmesi. yatak hafif olacak şekilde tasarlanmıştır
mümkün olduğunca basit bir kullanıcı arayüzü ile test aracı.

yatak bir veya daha fazla ile çalıştırılmalıdır testleri komut satırında belirtilen çalıştırmak için. Testler
testleri aramak için ayrı test dosyaları veya dizinler olabilir (bkz. TEST DISCOVERY).

Belirtilen her test (potansiyel olarak paralel olarak) ve tüm testler tamamlandıktan sonra yürütülecektir.
çalıştırıldı yatak geçen veya başarısız olan testlerin sayısı hakkında özet bilgi yazdıracaktır
(görmek TEST DURUMU SONUÇLAR.) yatak program, varsa sıfır olmayan bir çıkış koduyla yürütülür
testler başarısız olur.

Varsayılan olarak yatak kısa ve öz bir ilerleme ekranı kullanacak ve yalnızca özet yazdıracak
test hataları için bilgi. Görmek ÇIKTI SEÇENEKLER kontrol eden seçenekler için yatak
ilerleme görüntüleme ve çıktı.

yatak ayrıca testlerin nasıl yürütüldüğünü kontrol etmek için bir dizi seçenek içerir (belirli
özellikler, belirli test formatına bağlı olabilir). Görmek UYGULAMA SEÇENEKLER Daha fazla bilgi için
bilgiler.

En sonunda, yatak ayrıca seçeneklerin yalnızca bir alt kümesini çalıştırmak için ek seçenekleri de destekler
komut satırında belirtilen, bkz. SEÇİM SEÇENEKLER daha fazla bilgi için.

İlgilenen kullanıcılar yatak mimarlık veya tasarım yatak test uygulaması
görmek LIT ALTYAPI.

GENEL SEÇENEKLER

-H, --yardım et
Göster yatak yardım mesajı.

-j N, --threads=N
koşmak N paralel olarak test eder. Varsayılan olarak, bu otomatik olarak eşleşecek şekilde seçilir.
algılanan kullanılabilir CPU sayısı.

--config-prefix=AD
Aramak ADI.cfg ve ADI.site.cfg ne zaman arama için test suit, yerine of
aydınlatılmış.cfg ve lit.site.cfg.

-D İSİM, -D AD=DEĞER, --param İSİM, --param İSİM=DEĞER
Kullanıcı tanımlı bir parametre ekleyin ADI verilenlerle DEĞER (veya değilse boş dize
verildi). Bu parametrelerin anlamı ve kullanımı test takımına bağlıdır.

ÇIKTI SEÇENEKLER

-Q, --sessizlik
Test hataları dışında herhangi bir çıktıyı bastırın.

-Evet, --özlü
Daha az çıktı göster, örneğin geçen testler hakkında bilgi gösterme.

-içinde, --ayrıntılı
Test hataları hakkında daha fazla bilgi göster, örneğin bunun yerine tüm test çıktısı
sadece test sonucu.

--no-ilerleme çubuğu
Küfür tabanlı ilerleme çubuğu kullanmayın.

--show-desteklenmiyor
Desteklenmeyen testlerin adlarını göster.

--show-xfail
Başarısız olması beklenen testlerin adlarını gösterin.

UYGULAMA SEÇENEKLER

--yol=YOL
Ek belirtin PATH testlerde yürütülebilir dosyaları ararken kullanmak için.

--vg Valgrind altında bireysel testler çalıştırın (memcheck aracını kullanarak). NS
--hata-çıkış kodu valgrind argümanı, valgrind başarısızlıklarının neden olacağı şekilde kullanılır.
sıfır olmayan bir durumla çıkmak için program.

Bu seçenek etkinleştirildiğinde, yatak ayrıca otomatik olarak bir "sağlayacakValgrind"
belirli koşulları koşullu olarak devre dışı bırakmak (veya başarısız olmasını beklemek) için kullanılabilecek özellik
testleri.

--vg-arg=ARG
Ne zaman --vg kullanıldığında, iletilecek ek bir argüman belirtin Valgrind kendisi.

--vg sızıntısı
Ne zaman --vg kullanıldığında, bellek sızıntısı kontrollerini etkinleştirin. Bu seçenek etkinleştirildiğinde, yatak
ayrıca otomatik olarak bir "sağlayacakvg_leak" için kullanılabilecek özellik
belirli testleri koşullu olarak devre dışı bırakın (veya başarısız olmasını bekleyin).

--zaman testleri
Bireysel testlerin yürütülmesi için geçen duvar süresini takip edin ve sonuçları
özet çıktı. Bu, bir test takımında hangi testleri belirlemek için kullanışlıdır
yürütmek için en çok zaman ayırın. Bu seçeneğin en kullanışlı olduğunu unutmayın. -j 1.

SEÇİM SEÇENEKLER

--max-testleri=N
en fazla koş N test edin ve ardından sonlandırın.

--max-zaman=N
en fazla harca N saniye (yaklaşık olarak) çalışan testler ve ardından sonlandırın.

--Karıştır
Testleri rastgele bir sırayla çalıştırın.

EK SEÇENEKLER

- hata ayıklama
koşmak yatak hata ayıklama modunda, yapılandırma sorunlarını ayıklamak için ve yatak kendisi.

--gösteri süitleri
Keşfedilen test takımlarını listeleyin ve çıkın.

--göster testleri
Keşfedilen tüm testleri listeleyin ve çıkın.

EXIT DURUMU

yatak herhangi bir BAŞARISIZ veya XPASS sonucu varsa 1 çıkış koduyla çıkacaktır. Aksi halde,
0 durumu ile çıkacaktır. Testle ilgili olmayan hatalar için diğer çıkış kodları kullanılır.
(örneğin bir kullanıcı hatası veya dahili bir program hatası).

TEST DISCOVERY

geçirilen girdiler yatak bireysel testler veya tüm dizinler olabilir veya
çalıştırılacak testlerin hiyerarşileri. Ne zaman yatak başlar, yaptığı ilk şey dönüştürmektir.
parçası olarak çalıştırılacak testlerin tam listesine girer test keşif.

içinde yatak model, her test bazılarının içinde mevcut olmalıdır test süit. yatak girdileri çözer
giriş yolundan yukarı doğru arama yaparak takımları test etmek için komut satırında belirtilen
bir bulana kadar aydınlatılmış.cfg or lit.site.cfg dosya. Bu dosyalar hem bir test işareti olarak hizmet eder
süitler ve yapılandırma dosyaları olarak yatak nasıl bulunacağını anlamak için yükler ve
testleri test paketinin içinde çalıştırın.

bir Zamanlar yatak girdileri test takımlarına eşledi, eklenen girdilerin listesinden geçti
tek tek dosyalar için testler ve dizinlerdeki testleri yinelemeli olarak arar.

Bu davranış, çalıştırılacak testlerin bir alt kümesini belirlemeyi kolaylaştırırken,
testlerin tam olarak nasıl yorumlandığını kontrol etmek için test paketi yapılandırması. Ek olarak, yatak
testleri her zaman içinde bulundukları test paketine ve içindeki göreceli yollarına göre tanımlar.
test odası. Uygun şekilde yapılandırılmış projeler için bu, yatak uygun sağlamak
ve ağaç dışı yapılar için esnek destek.

TEST DURUMU SONUÇLAR

Her test nihayetinde aşağıdaki altı sonuçtan birini üretir:

PASS
Test başarılı oldu.

BAŞARISIZ
Test başarısız oldu, ancak bu bekleniyor. Bu, izin veren test formatları için kullanılır.
bir testin şu anda çalışmadığını, ancak test paketinde bırakmak istediğini belirterek.

XPASS
Test başarılı oldu, ancak başarısız olması bekleniyordu. Bu, yapılan testler için kullanılır
başarısız olması bekleniyor olarak belirtildi, ancak şimdi başarılı oluyorlar (genellikle özellik
test bozuldu ve düzeltildi).

FAIL
Test başarısız oldu.

ÇÖZÜMLENMEMİŞ
Test sonucu belirlenemedi. Örneğin, bu, testin mümkün olduğu durumlarda gerçekleşir.
çalıştırılamaz, testin kendisi geçersizdir veya test kesintiye uğramıştır.

DESTEKLENMEYEN
Test bu ortamda desteklenmiyor. Bu, aşağıdakileri yapabilen test formatları tarafından kullanılır:
desteklenmeyen testleri bildirin.

Test formatına bağlı olarak testler, durumları hakkında ek bilgiler üretebilir.
(genellikle sadece arızalar için). Bkz. ÇIKTI SEÇENEKLER daha fazla bilgi için bölüm.

LIT ALTYAPI

Bu bölüm aşağıdakileri açıklar: yatak yeni bir mimari oluşturmakla ilgilenen kullanıcılar için test mimarisi
yatak Uygulamayı test etmek veya mevcut olanı genişletmek.

yatak uygun, öncelikle keyfi testleri keşfetmek ve çalıştırmak için bir altyapıdır ve
Bu testlere tek bir uygun arayüz sunmak için. yatak kendisi koşmayı bilmiyor
testler, bunun yerine bu mantık tarafından tanımlanır test suit.

TEST SUİTLER
De tarif TEST DISCOVERY, testler her zaman bir test süit. Test takımları
içerdikleri testlerin formatını, bu testleri bulma mantığını tanımlamaya hizmet eder,
ve testleri çalıştırmak için ek bilgiler.

yatak test takımlarını içeren dizinler olarak tanımlar aydınlatılmış.cfg or lit.site.cfg dosyalar (bkz.
Ayrıca --config-ön eki). Test takımları başlangıçta yinelemeli olarak arama yapılarak keşfedilir.
komut satırından geçirilen tüm girdi dosyaları için dizin hiyerarşisi. Kullanabilirsiniz
--gösteri süitleri keşfedilen test takımlarını başlangıçta görüntülemek için.

Bir test paketi keşfedildiğinde, yapılandırma dosyası yüklenir. Yapılandırma dosyalarının kendileri
Yürütülecek Python modülleri. Yapılandırma dosyası yürütüldüğünde, iki önemli
global değişkenler önceden tanımlanmıştır:

lit_config
Küresel yatak yapılandırma nesnesi (bir LitConfig örnek), bu yerleşik tanımlar
için test formatları, global konfigürasyon parametreleri ve diğer yardımcı rutinler
test yapılandırmalarının uygulanması.

yapılandırma
Bu, yapılandırma nesnesidir (bir Test Yapılandırması örnek) test paketi için,
config dosyasının doldurulması bekleniyor. Ayrıca aşağıdaki değişkenler de mevcuttur:
yapılandırma bazıları yapılandırma tarafından ayarlanması gereken ve diğerleri isteğe bağlı veya
önceden tanımlanmış:

isim [gereklidir] Raporlarda ve tanılamalarda kullanım için test paketinin adı.

test_formatı [gereklidir] Keşfetmek ve çalıştırmak için kullanılacak test formatı nesnesi
test paketindeki testler. Genellikle bu, şu adresten edinilebilecek yerleşik bir test formatı olacaktır:
the lit.formatlar modülü.

test_source_root Test paketi köküne giden dosya sistemi yolu. Yön dışı yapılar için
bu, testler için taranacak dizindir.

test_exec_root Dizin dışı yapılar için, nesnenin içindeki test paketi kökünün yolu
dizin. Testlerin çalıştırılacağı ve geçici çıktı dosyalarının yerleştirileceği yer burasıdır.

çevre Testler yürütülürken kullanılacak ortamı temsil eden bir sözlük
süit.

ekleri İçin yatak testler için dizinleri tarayan test formatları, bu değişken bir listedir
Test dosyalarını tanımlamak için son ekler. Tarafından kullanılan: ShTest.

değiştirmelerin İçin yatak değişkenleri bir test komut dosyasında değiştiren test biçimleri,
gerçekleştirilecek ikamelerin listesi. Tarafından kullanılan: ShTest.

desteklenmeyen Desteklenmeyen bir dizini işaretleyin, içindeki tüm testler şu şekilde rapor edilecektir:
desteksiz. Tarafından kullanılan: ShTest.

ebeveyn Üst yapılandırma, bu, dizini içeren yapılandırma nesnesidir.
test paketi veya Hiçbiri.

kök Kök yapılandırması. Bu en üst yatak projede yapılandırma.

boru arızası Normalde, borudaki komutlardan herhangi biri varsa, kabuk boru kullanan bir test başarısız olur.
hata. Bu istenmiyorsa, bu değişkeni false olarak ayarlamak testin yalnızca başarısız olmasına neden olur.
borudaki son komut başarısız olursa.

TEST DISCOVERY
Test süitleri bulunduğunda, yatak kaynak dizini özyinelemeli olarak geçer (aşağıdaki
test_source_root) testler arıyor. Ne zaman yatak bir alt dizine girer, önce
bu dizinde iç içe bir test paketinin tanımlanıp tanımlanmadığına bakın. Eğer öyleyse, o test paketini yükler
aksi takdirde dizin için yerel bir test yapılandırması başlatır (bkz. YEREL
YAPILANDIRMA DOSYALAR).

Testler, içerdikleri test paketi ve göreli yol ile tanımlanır.
o süitin içinde. Göreceli yolun diskteki gerçek bir dosyaya atıfta bulunmayabileceğini unutmayın;
bazı test formatları (örneğin Google Testi) bir yolu olan "sanal testleri" tanımlayın.
hem gerçek test dosyasının yolunu hem de sanal testi tanımlamak için bir alt yolu içerir.

YEREL YAPILANDIRMA DOSYALAR
Ne zaman yatak bir test paketine bir alt dizin yükler, yerel bir test yapılandırmasını başlatır
ana dizinin konfigürasyonunu klonlayarak --- bu konfigürasyonun kökü
zincir her zaman bir test takımı olacaktır. Test yapılandırması klonlandıktan sonra yatak bir için kontrol eder
lit.yerel.cfg alt dizindeki dosya. Varsa, bu dosya yüklenecek ve
her bir dizin için yapılandırmayı özelleştirmek için kullanılır. Bu tesis olabilir
isteğe bağlı testlerin alt dizinlerini tanımlamak veya diğer yapılandırmayı değiştirmek için kullanılır
parametreler --- örneğin, test biçimini veya testi tanımlayan son ekleri değiştirmek için
dosyaları.

TEST KOŞMAK ÇIKTI FORMAT
The yatak bir test çalıştırması için çıktı, hem kısa hem de ayrıntılı olarak aşağıdaki şemaya uygundur
modları (kısa modda hiçbir PASS satırı gösterilmemesine rağmen). Bu şema seçildi
bir makine tarafından güvenilir bir şekilde ayrıştırılması nispeten kolay (örneğin, buildbot günlüğünde)
kazıma) ve oluşturulacak diğer araçlar için.

Her test sonucunun aşağıdakilerle eşleşen bir satırda görünmesi beklenir:

: ( )

nerede GEÇTİ, BAŞARISIZ, XFAIL, XPASS gibi standart bir test sonucudur,
ÇÖZÜMLENMEMİŞ veya DESTEKLENMEMİŞTİR. GELİŞMİŞ ve GERİ DÖNDÜ performans sonuç kodları şunlardır:
Ayrıca izin.

The <test isim> alan, yeni satır içermeyen rastgele bir dizeden oluşabilir.

The <ilerleme bilgi> alanı (1/300) gibi ilerleme bilgilerini raporlamak için kullanılabilir veya
boş olabilir, ancak boş olduğunda bile parantezler gereklidir.

Her test sonucu, aşağıdakilerde ek (çok satırlı) günlük bilgilerini içerebilir:
biçimi:

ÖLÇEK '( )'
... günlük mesajı ...


nerede <test isim> önceden bildirilen bir testin adı olmalıdır, <günlük sınırlayıcı> bir
"*" karakter dizisi at en az dört karakter uzunluğunda (önerilen uzunluk 20'dir) ve
<sondaki sınırlayıcı> keyfi (çözülmemiş) bir dizedir.

Aşağıda, A, B, C ve
D ve başarısız olan C testi için bir günlük mesajı:

GEÇİŞ: A (1/4)
GEÇİŞ: B (2/4)
BAŞARISIZ: C (3/4)
******************** TEST 'C' BAŞARISIZ ********************
Çıkış kodu 1'in sonucu olarak 'C' testi başarısız oldu.
********************
GEÇTİ: D (4/4)

LIT ÖRNEK TESTLERİ
The yatak dağıtım, test paketlerinin birkaç örnek uygulamasını içerir.
ÖrnekTestler dizin.

onworks.net hizmetlerini kullanarak lit-3.7'i çevrimiçi kullanın