aet - Online w chmurze

PROGRAM:

IMIĘ

test aegis - uruchom testy

STRESZCZENIE

egida -Test [ opcja...][ Nazwa=wartość ][ Nazwa pliku...]
egida -Test -Niezależny [ opcja...][ Nazwa=wartość ][ Nazwa pliku...]
egida -Test -Lista [ opcja...]
egida -Test -Pomoc

OPIS

Połączenia egida -Test polecenie służy do uruchamiania testów. Jeśli nie podano nazw plików, wszystkie odpowiednie testy
są uruchamiane. Domyślnie uruchamiane są zarówno testy automatyczne, jak i ręczne.

Możesz nazwać katalogi w wierszu poleceń i wszystkie odpowiednie testy w tym katalogu
drzewo w zmianie zostanie uruchomione. Brak odpowiednich testów jest błędem.

Każdą architekturę należy testować osobno. Dzieje się tak dlatego, że mogą być subtelne
problemy, które ujawniają się tylko w niektórych architekturach. Niektóre projekty mogą również mieć
inny kod dla różnych architektur.

Status ostatniego uruchomienia testu jest zapamiętywany, więc testy nie są uruchamiane, jeśli go nie ma
potrzebować. (Nie dotyczy to -Regresja testy, niestety.) Testy należy przeprowadzić ponownie
jeśli test wcześniej się nie powiódł, jeśli plik testowy został zmieniony, jeśli była kompilacja,
i dla każdej architektury.

nazwa=wartość
Możesz dodać Nazwa=wartość pary do wiersza poleceń, zostaną one przekazane bez zmian do
polecenie testowe. Zwykle na końcu wiersza poleceń, ale można to zmienić w pliku
plik konfiguracyjny projektu.

Połączenia -siła Opcja powoduje dodanie ukrytej zmiennej force=1 do listy
przypisania zmiennych i tym samym dodane na końcu polecenia. Jest to najbardziej przydatne, gdy
używając polecenie_testowe_wsadowe w pliku konfiguracyjnym projektu.

Może to początkowo wyglądać jak zakończenie procesu programowania, umożliwiające wykonanie skryptów testowych
napisane tak, aby udzielały właściwych odpowiedzi, nic nie robiąc. Ty
zawsze mogłem to zrobić ze zmiennymi środowiskowymi, więc nie jest to nic nowego.

Możliwe jest przekształcenie wszystkich przypisań zmiennych w zmienne środowiskowe
umieszczając $var w początek polecenia, przed nazwą powłoki, a nie at
domyślna lokalizacja na końcu polecenia.

filet Imię Interpretacja
Program aegis spróbuje określić nazwy plików projektu na podstawie nazw plików
podane w wierszu poleceń. Wszystkie nazwy plików są przechowywane w projektach aegis jako względne
do katalogu głównego drzewa katalogów linii bazowej. Katalog deweloperski i
katalog integracyjny to cienie tego katalogu bazowego, a więc te względne nazwy
tutaj również aplikuj. Pliki wymienione w wierszu poleceń są najpierw konwertowane na ścieżki bezwzględne
Jeśli to konieczne. Następnie są porównywane ze ścieżką bazową, katalogiem deweloperskim
ścieżka i ścieżka katalogu integracji, aby określić nazwę względną względem linii bazowej. To jest
błąd, jeśli nazwany plik znajduje się poza jednym z tych drzew katalogów.

Połączenia -BAse_REWzględny opcja może być użyta do spowodowania, że ​​względne nazwy plików będą interpretowane jako
względem ścieżki bazowej; bezwzględne nazwy plików będą nadal porównywane z różnymi
ścieżki w celu określenia nazwy względem linii bazowej.

Połączenia względna_nazwa_pliku_preferencje w pliku konfiguracyjnym użytkownika może służyć do modyfikacji
to domyślne zachowanie. Widzieć aeuconf(5), aby uzyskać więcej informacji.

TESTOWANIE PROCES

Każdej zmianie muszą towarzyszyć badania i takie badania muszą być
działają w oparciu o zbudowany katalog programistyczny i muszą przejść. To gwarantuje, że nowe
funkcjonalności towarzyszą testy sprawdzające jej poprawność oraz poprawki błędów
wraz z testami potwierdzającymi, że błąd został naprawiony.

Regresja Testy
Testy są traktowane jak każdy inny plik źródłowy i są utrzymywane w wersji bazowej i
history ze wszystkimi innymi plikami źródłowymi. Testy, które muszą towarzyszyć każdej zmianie
kumulują się w linii bazowej projektu, zapewniając definicję prawidłowej funkcji dla
linia bazowa. Te skumulowane testy można wykonać za pomocą polecenia „aegis -REGression”,
aby sprawdzić, czy projekt nie ulegnie „regresji” w wyniku zmiany.

Baseline Testy
Do testów wymagane są poprawki błędów nie względem założeń projektu (w przeciwieństwie do
do katalogu deweloperskiego). Gwarantuje to, że test faktycznie zademonstruje błąd
w wartości bazowej, a także wykazanie, że jest ona ustalona przez zmianę. Nowy
funkcjonalność w trywialny sposób zawodzi w stosunku do linii bazowej, dlatego aegis nie próbuje tego robić
zgadnij, czy test jest testem naprawiania błędów, czy testem nowej funkcjonalności, wymaga po prostu testów
ponieść porażkę w stosunku do linii bazowej.

Wymóg ten dotyczy zarówno nowych testów tworzonych w wyniku zmiany, jak i testów
które zostały skopiowane do zmiany w celu modyfikacji.

Przeglądanie Testy
Recenzenci mogą być pewni, że firma aegis wyegzekwowała wymagania testowe; to zmiana
musi mieć testy, musi zbudować zmianę, musi przejść testy przeciwko rozwojowi
katalogu i że testy nie powiodą się w stosunku do wersji bazowej. Warunki te są egzekwowane
by aed(1) i zmiana nie zostanie zaliczona do jest recenzja stan aż do tych
warunki są spełnione. Recenzenci powinni zatem dokonać przeglądu testów pod kątem kompletność pokrycia
kodu w zmianie oraz niewrażliwość na zmiany w środowisku wykonawczym (np
brak wrażliwości na datę). Recenzenci powinni również użyć „aegis -list zmiany_details” do weryfikacji
czy zmiana zawiera lub nie obejmuje wyjątków związanych z testowaniem.

zwolnienia
Administratorzy projektu mogą udzielić różnych zwolnień z testów, patrz apa(1) i
aepattr(5), aby uzyskać więcej informacji. Kopiowanie testów do zmiany lub dodawanie nowych testów do pliku
zmiany, może anulować te zwolnienia.

TESTOWANIE COMMAND KONFIGURACJA

Polecenie używane do wykonywania testów jest definiowane przez polecenie_testowe pole w projekcie
plik konfiguracyjny (zobacz aepconf(5), aby uzyskać więcej informacji), domyślnie jest to użycie
Powłoka Bourne’a, jeśli nie jest ustawiona. Bieżący katalog będzie na górze odpowiedniego
drzewo katalogów. Jeśli testy wymagają plików tymczasowych, powinny je utworzyć w / Tmp, jak
test nie może oczekiwać, że będzie miał uprawnienia do zapisu w bieżącym katalogu.

Jeśli chcesz użyć bardziej wyrafinowanego silnika testowego zamiast prostego skryptu powłoki,
ale ten silnik testowy nie zwraca kodów wyników odpowiednich do użycia z aegis, możesz
zawiń go w skrypt powłoki, który ponownie zapisuje status wyjścia do wartości, których oczekuje aegis.
Te same wyniki można również osiągnąć, pisząc bardziej złożony plik polecenie_testowe
projekt config plik.

Możliwe jest także pisanie poleceń testowych, które będą w stanie przetestować więcej niż jeden plik
raz. Jest to kontrolowane przez polecenie_testowe_wsadowe dziedzina projektu config plik. w
w tym przypadku podstawienie ${output} wskazuje nazwę pliku, którego musi używać polecenie testowe
stworzyć, w test(5) format zawierający wyniki przeprowadzonych testów. Jest to często używane
w systemach z wieloma procesorami lub możliwością dystrybucji zadań pomiędzy kilkoma komputerami
w sieci.

Zastępstwa
Wszystkie esub(5) w poleceniach testowych dostępne są podstawienia. Niektórzy z nich są
na szczególną uwagę:

Architektura
To podstawienie zostaje zastąpione nazwą testowanej architektury.

Szukaj_Ścieżka
To podstawienie zostaje zastąpione rozdzieloną dwukropkami listą bezwzględnych ścieżek do
szukaj, szukając plików obsługi testów.

Search_Path_Plik wykonywalny
To podstawienie zostaje zastąpione rozdzieloną dwukropkami listą bezwzględnych ścieżek do
szukaj wykonywalnych plików pomocniczych (plików bibliotecznych i pod-
polecenia).

Większość czasu $Search_Path_Plik wykonywalny są dokładnie takie same. Jednak podczas „aegis -t
-bl” będą inne, z $Seach_Path zaczynając od katalogu rozwojowego (plik
przeprowadzany test) i $Seach_Path_Plik wykonywalny zaczynając od linii bazowej (plik wykonywalny
biegać).

Testowanie Wynik Kody
Po uruchomieniu każdego testu (za pośrednictwem pliku polecenie_testowe pole w projekcie config plik), egis
określa, czy test zakończył się sukcesem, czy niepowodzeniem, sprawdzając jego status wyjścia. To wyjście
status jest w większości zgodny z oczekiwaniami dla poleceń UNIX.

sukces
Test powinien zakończyć się wynikiem 0, aby wskazać sukces, tj. wykonanie określonej funkcji poddawanej testowi
działało zgodnie z oczekiwaniami.

Brak
Test powinien zakończyć się numerem 1, aby wskazać awarię, tj. testowaną konkretną funkcję
nie działało zgodnie z oczekiwaniami.

Brak wyników
Test powinien wyjść 2, aby wskazać brak wyniku, tj. że konkretna funkcja pod
testu nie można było wykonać, ponieważ coś poszło nie tak. Na przykład bieganie
brak miejsca na dysku podczas tworzenia testowych plików wejściowych w formacie / Tmp katalogiem.

Pominięte
Test powinien wyjść 77, aby wskazać, że został pominięty. Zwykle ma to związek z
obecna architektura nie ma znaczenia. Jeśli to możliwe, użyj opcji „Brak wyniku”
Zamiast. (Wartość została wybrana ze względu na zgodność z innymi systemami testowymi.)

Właściwie każdy kod zakończenia inny niż 0, 1 lub 77 będzie interpretowany jako „brak wyniku”.
Jednak zawsze użycie 0, 1, 2 lub 77 oznacza, że ​​jeśli a. wymaga nowego kodu wyniku
w późniejszej wersji Aegis istniejące testy będą nadal działać.

TESTOWANIE KORELACJE

Polecenie „egida -Test -SUGgest” może być użyte do sugerowania przez egidę odpowiedniej regresji
testuje Twoją zmianę na podstawie plików źródłowych w Twojej zmianie. To automatycznie
skupia wysiłek testowy na odpowiednich testach, zmniejszając liczbę testów regresji
musisz mieć pewność, że nie wprowadziłeś błędu.

Korelacje testowe są generowane przez polecenie „aegis -Integrate_Pass”, które:
kojarzy każdy test w zmianie z każdym plikiem źródłowym w zmianie. Tak więc każdy
plik źródłowy gromadzi listę testów, które były z nim powiązane w przeszłości.
Nie jest to tak dokładne jak analiza pokrycia kodu, ale jest rozsądnym przybliżeniem w
ćwiczyć.

Połączenia aekp(1) i aenf(1) komendy służą do kojarzenia plików ze zmianą. Podczas gdy oni
nie realizuj aktywnie skojarzenia, są to pliki używane przez aeipass(1) i
aet(1) w celu określenia, które pliki źródłowe są powiązane z jakimi testami.

Testowanie Korelacja Dokładność
Zakładając, że testowe korelacje są dokładne i że testy są równomierne
rozłożone w przestrzeni funkcjonalnej, będzie mniej niż 1/liczba szansa, że
odpowiedni test nie został przeprowadzony przez „aegis -Test -SUGgest numer" Komenda. Mały
ilość szumu jest dodawana do wagi testu, więc czasami zdarzają się nieoczekiwane rzeczy
przetestowane, a te same testy nie są uruchamiane za każdym razem.

Dokładność korelacji testów można poprawić, zapewniając, że:

· Każda zmiana powinna być mocno skoncentrowana, bez nieuzasadnionych wtrąceń plików. Ten
unika fałszywych korelacji.

· Każdy element nowej funkcjonalności powinien być dodany w indywidualnej zmianie, a nie
kilka razem. To silnie koreluje testy z funkcjonalnością.

· Każdy błąd powinien być naprawiany w ramach indywidualnej zmiany, a nie kilku razem. Ten
silnie koreluje testy z funkcjonalnością.

· Korelacje testowe zostaną utracone, jeśli pliki zostaną przeniesione. Dzieje się tak, ponieważ korelacje są przez
nazwa.

Najlepszym sposobem na dokładne skorelowanie testów z plikami źródłowymi jest zmiana
zawiera test i dokładnie te pliki, które odnoszą się do testowanej funkcjonalności. Także
wiele fałszywych plików osłabi użyteczność korelacji testowych.

OPCJE

Rozumie się następujące opcje:

-Automatyczny
Opcji tej można użyć do określenia testów automatycznych. Testy automatyczne nie wymagają
pomoc ludzka.

-Linia bazowa
Tej opcji można użyć do określenia, że ​​przedmiotem projektu jest plan bazowy
Komenda.

-BAse_REWzględny
Ta opcja może być użyta do spowodowania, aby względne nazwy plików były uważane za względne do
podstawa drzewa źródłowego. Widzieć aeuconf(5) dla odpowiedniego użytkownika
pierwszeństwo.

-CUrrent_REWzględny
Ta opcja może być użyta do spowodowania, aby względne nazwy plików były uważane za względne do
bieżący katalog. Jest to zwykle ustawienie domyślne. Widzieć aeuconf(5) dla
odpowiednie preferencje użytkownika.

-Zmiana numer
Ta opcja może służyć do określenia konkretnej zmiany w projekcie. Widzieć
egida(1) pełny opis tej opcji.

-Siła Opcji tej można użyć do określenia, że ​​wszystkie testy powinny zostać uruchomione, nawet jeśli
status ostatniego uruchomienia testowego wskazuje, że nie ma potrzeby uruchamiania konkretnego
test.

-Pomoc
Ta opcja może być wykorzystana do uzyskania dodatkowych informacji o tym, jak używać egida
program.

-Niezależny
Opcja ta służy do określenia, że ​​test ma być wykonywany niezależnie od innych
konkretna zmiana. Jeśli nie zostaną podane żadne nazwy testów, zostaną uruchomione wszystkie testy w linii bazowej.

-Lista
Ta opcja może być użyta do uzyskania listy odpowiednich tematów dla tego polecenia.
Lista może być bardziej ogólna niż oczekiwano.

-Podręcznik Opcji tej można użyć do określenia testów ręcznych. Testy ręczne wymagają obecności człowieka
interwencja, np.: potwierdzenie jakiegoś zachowania ekranu (np. X11), lub
jakaś akcja użytkownika, „odłącz teraz kabel Ethernet”.

-Nie_logowanie
Ta opcja może być użyta do wyłączenia automatycznego rejestrowania danych wyjściowych i błędów do
plik. Jest to często przydatne, gdy kilka poleceń aegis jest połączonych w powłoce
skrypt.

-Wytrwać
Opcji tej można użyć do określenia, że ​​powinny zostać uruchomione wszystkie testy, nawet jeśli niektóre
ponieść porażkę. Domyślnie jest to użytkownik preferencje_wytrwałości jeśli nie określono, zobacz
aeuconf(5), aby uzyskać więcej informacji.

-Nie_Wytrwały
Opcji tej można użyć do określenia, czy przebieg testowy powinien zostać zatrzymany po pierwszym
awaria. Domyślnie jest to użytkownik preferencje_wytrwałości jeśli nie określono, zobacz
aeuconf(5), aby uzyskać więcej informacji.

-Projekt Nazwa
Ta opcja może być wykorzystana do wybrania interesującego Cię projektu. Kiedy nie -Projekt
opcja jest określona, PROJEKT AEGIS konsultowana jest zmienna środowiskowa. Gdyby
który nie istnieje, użytkownika $HOME/.aegisrc plik jest sprawdzany pod kątem wartości domyślnych
pole projektu (patrz aeuconf(5), aby uzyskać więcej informacji). Jeśli to nie istnieje,
gdy użytkownik pracuje tylko nad zmianami w ramach jednego projektu, projekt
domyślna nazwa tego projektu. W przeciwnym razie jest to błąd.

-Postęp
Opcji tej można użyć do określenia, czy komunikaty o postępie powinny być wysyłane wcześniej
w każdym przypadku przed każdym uruchomieniem testowym lub przed każdym uruchomieniem testowym partii polecenie_testowe_wsadowe pole
określone w projekcie config plik (patrz aeuconf(5), aby uzyskać więcej informacji).

-Brak postępu
Opcji tej można użyć do określenia, że ​​komunikaty o postępie powinny być pomijane.
To jest ustawienie domyślne.

-Regresja
Ta opcja służy do określenia, czy ma zostać uruchomiony zestaw testów regresji. The
zestaw testów regresyjnych składa się ze wszystkich testów w linii bazowej, które się nie pojawiają
w zmianie. Brak testów regresji jest błędem. Nie możesz
testy nazw w wierszu poleceń podczas korzystania z opcji -REGression. Możesz nazwać
poszczególne testy można uruchomić w wierszu poleceń, bez użycia opcji -REGression
opcja; jeśli nie są one częścią zmiany, testy o tej samej nazwie w
linia bazowa zostanie uruchomiona.

-Sugerować [ numer ]
"egida -Integracja_Pass” zbiera statystyki korelacji testowej, gdy
zmiany są zintegrowane. Opcji tej można użyć do zażądania sugestii egidy
które testy należy przeprowadzić, korzystając z tych korelacji testowych. Jeśli nie ma numeru
zostanie określony, zasugerowanych zostanie 10 testów. Ta opcja oznacza -Regresja
opcja.

-SUGgest_Limit minuty
Opcji tej można użyć do ograniczenia liczby testów do określonej liczby
minuty. Zostaną one uporządkowane od najbardziej odpowiednich do najmniej istotnych.

-SUGgest_Noise numer
Opcji tej można użyć do kontrolowania ilości szumu wprowadzanego do testu
selekcja dokonana przez -Sugerować opcja. Liczba oznacza procent szumu
do wstrzyknięcia. Wartość domyślna to 10, jeśli nie została określona. Zapewnia zastrzyk hałasu
że w kolejnych seriach przeprowadzane są różne testy, a także niektóre z lewego pola
jako kontrola zdrowego rozsądku.

-Lakoniczny
Ta opcja może być używana, aby aukcje generowały minimum
Informacja. Jest to zwykle przydatne w przypadku skryptów powłoki.

-Gadatliwy
Ta opcja może być użyta, aby spowodować, że aegis będzie produkować więcej. Domyślnie egida
generuje dane wyjściowe tylko w przypadku błędów. W przypadku użycia z -Lista opcja ta opcja
powoduje dodanie nagłówków kolumn.

-Czekać Ta opcja może być użyta do zażądania, aby komendy Aegis czekały na blokady dostępu, jeśli:
nie można ich uzyskać natychmiast. Domyślnie do użytkownika preferencje_blokady_oczekiwania
jeśli nie określono, zobacz aeuconf(5), aby uzyskać więcej informacji.

-Nie, czekaj
Ta opcja może być użyta do zażądania, aby polecenia Aegis wyemitowały błąd krytyczny w przypadku dostępu
zamków nie można uzyskać natychmiast. Domyślnie do użytkownika
preferencje_blokady_oczekiwania jeśli nie określono, zobacz aeuconf(5), aby uzyskać więcej informacji.

Zobacz też egida(1) dla opcji wspólnych dla wszystkich komend egidy.

Wszystkie opcje mogą być skrócone; skrót jest dokumentowany jako wielkie litery,
wszystkie małe litery i podkreślenia (_) są opcjonalne. Musisz użyć kolejnego
sekwencje opcjonalnych liter.

Wszystkie opcje nie uwzględniają wielkości liter, można je wpisywać wielkimi lub małymi literami lub a
połączenie obu, przypadek nie jest ważny.

Na przykład: argumenty „-project”, „-PROJ” i „-p” są interpretowane jako
-Projekt opcja. Argument "-prj" nie zostanie zrozumiany, ponieważ konsekutywne
nie podano znaków opcjonalnych.

Opcje i inne argumenty wiersza poleceń mogą być dowolnie mieszane w wierszu poleceń,
po selektorach funkcji.

Długie nazwy opcji GNU są zrozumiałe. Ponieważ wszystkie nazwy opcji dla egida są długie,
oznacza to ignorowanie dodatkowego początkowego „-”. Ten "--opcja=wartość„Konwencja też jest
zrozumiany.

POLECAMY ALIAS

Zalecany alias dla tego polecenia to
csh% alias aet 'aegis -t \!* -v'
sh$ aet(){aegis -t "$@" -v}

BŁĘDY

Błędem jest, jeśli zmiana nie znajduje się w jednym z jest rozwinięty or jest zintegrowany
stany.
Jest to błąd, jeśli zmiana nie jest przypisana do bieżącego użytkownika.
Błędem jest brak odpowiednich badań i odpowiedniego zwolnienia.

EXIT STATUS

Połączenia egida polecenie zakończy się ze statusem 1 w przypadku każdego błędu. ten egida polecenie będzie tylko
zakończ ze statusem 0, jeśli nie ma błędów.

ŚRODOWISKO ZMIENNE

See egida(1) dla listy zmiennych środowiskowych, które mogą mieć wpływ na to polecenie. Widzieć
aepconf(5) dla pliku konfiguracyjnego projektu specyficzny dla projektu pole jak ustawić
zmienne środowiskowe dla wszystkich poleceń wykonywanych przez Aegis.

Korzystaj z aet online, korzystając z usług onworks.net