aet - Online in de cloud

PROGRAMMA:

NAAM

auspiciën test - voer tests uit

KORTE INHOUD

aegis -Toets [ optie... ][ naam=waarde ][ bestandsnaam...]
aegis -Toets -Onafhankelijk [ optie... ][ naam=waarde ][ bestandsnaam...]
aegis -Toets -Lijst [ optie...]
aegis -Toets -Helpen

PRODUCTBESCHRIJVING

De aegis -Toets commando wordt gebruikt om tests uit te voeren. Als er geen bestanden zijn genoemd, worden alle relevante tests
worden gerund. Standaard worden zowel automatische als handmatige tests uitgevoerd.

U kunt mappen een naam geven op de opdrachtregel en alle relevante tests in die map
boom in de wijziging zal worden uitgevoerd. Het is een fout als er geen relevante tests zijn.

Elke architectuur moet afzonderlijk worden getest. Dit komt omdat er subtiel kan zijn
problemen die alleen op sommige architecturen worden onthuld. Sommige projecten kunnen ook hebben
verschillende code voor verschillende architecturen.

De status van de laatste testrun wordt onthouden, zodat er geen tests worden uitgevoerd als die er niet zijn
behoefte. (Dit geldt niet voor -REgressie tests, helaas.) Tests moeten opnieuw worden uitgevoerd
als de test eerder is mislukt, als het testbestand is gewijzigd, als er een build is geweest,
en voor elke architectuur.

naam = waarde
U kunt toevoegen naam=waarde paren naar de opdrachtregel, deze worden ongewijzigd doorgegeven aan de
commando testen. Meestal aan het einde van de opdrachtregel, maar dit kan worden gewijzigd in het
projectconfiguratiebestand.

De -dwingen optie resulteert in een impliciete force=1 variabele die wordt toegevoegd aan de lijst van
variabele toewijzingen, en dus toegevoegd aan het einde van de opdracht. Dit is het handigst wanneer
met de batch_test_opdracht opgeslagen van het projectconfiguratiebestand.

Dit kan er in eerste instantie uitzien als een end-run van een ontwikkelingsproces, waardoor testscripts kunnen worden uitgevoerd
zo geschreven dat ze alle juiste antwoorden geven zonder daadwerkelijk iets te doen. Jij
hebben dit altijd kunnen doen met omgevingsvariabelen, dus dit is niets nieuws.

Het is mogelijk om alle variabeletoewijzingen om te zetten in omgevingsvariabelen
door $var bij de begin van het commando, voor de naam van de shell, in plaats van at
de standaardlocatie aan het einde van de opdracht.

Dien in Naam Interpretatie
Het aegis-programma zal proberen de projectbestandsnamen te bepalen uit de bestandsnamen
gegeven op de opdrachtregel. Alle bestandsnamen worden binnen aegis-projecten als relatief opgeslagen
naar de hoofdmap van de basismapstructuur. De ontwikkelmap en de
integratiemap zijn schaduwen van deze basismap, en dus zijn deze relatieve namen
ook hier toepassen. Bestanden die op de opdrachtregel worden genoemd, worden eerst geconverteerd naar absolute paden
indien nodig. Ze worden vervolgens vergeleken met het basispad, de ontwikkelingsdirectory
pad en het pad van de integratiedirectory om een ​​relatieve naam aan de basislijn te bepalen. Het is
een fout als het genoemde bestand zich buiten een van deze directorystructuren bevindt.

De -BAse_RElatief optie kan worden gebruikt om ervoor te zorgen dat relatieve bestandsnamen worden geïnterpreteerd als
ten opzichte van het basislijnpad; absolute bestandsnamen worden nog steeds vergeleken met de verschillende
paden om een ​​basislijn-relatieve naam te bepalen.

De relatieve_bestandsnaam_voorkeur in het gebruikersconfiguratiebestand kan worden gebruikt om te wijzigen
dit standaardgedrag. Zien aeuconf(5) voor meer informatie.

TEST PROCES

Elke wijziging moet gepaard gaan met tests, en die tests moeten dat ook zijn
lopen tegen de ingebouwde ontwikkeldirectory en ze moeten slagen. Dit zorgt ervoor dat nieuw
functionaliteit gaat vergezeld van tests om de juistheid ervan te verifiëren, en bugfixes zijn
vergezeld van tests die bevestigen dat de bug is verholpen.

Regressie Tests
Tests worden behandeld als elk ander bronbestand en worden onderhouden in de basislijn en
geschiedenis met alle andere bronbestanden. De tests die elke verandering moeten begeleiden
accumuleren in de basislijn van het project, waardoor een definitie wordt gegeven van de juiste functie voor de
basislijn. Deze geaccumuleerde tests kunnen worden uitgevoerd met behulp van een opdracht "aegis -REGRession",
om te verifiëren dat het project niet "terugvalt" als gevolg van een wijziging.

Baseline Tests
Bugfixes zijn vereist om getest te worden mislukken tegen de basislijn van het project (in tegenstelling
naar de ontwikkelingsmap). Dit zorgt ervoor dat de test de bug daadwerkelijk aantoont
in de basislijn, en om aan te tonen dat deze door de wijziging is opgelost. Nieuw
functionaliteit faalt triviaal tegen de basislijn, en daarom probeert aegis dat ook niet
raad eens of een test een bugfix-test of een nieuwe functionaliteitstest is, er zijn gewoon tests voor nodig
mislukken ten opzichte van de basislijn.

Deze eis geldt zowel voor nieuwe toetsen die ontstaan ​​door een wijziging als voor toetsen
die zijn gekopieerd naar een wijziging voor wijziging.

Herziening Tests
Beoordelaars kunnen erop vertrouwen dat auspiciën de testvereisten heeft afgedwongen; dat een verandering
moet tests hebben, dat de verandering moet bouwen, dat de tests slagen voor de ontwikkeling
directory, en dat de tests mislukken ten opzichte van de basislijn. Deze voorwaarden worden gehandhaafd
by aede(1) en de wijziging wordt niet doorgeschoven naar de wezen beoordeeld staat tot deze
aan de voorwaarden is voldaan. Beoordelaars moeten dus tests beoordelen voor volledigheid van dekking van
de code in de wijziging en ongevoeligheid voor wijzigingen in de uitvoeringsomgeving (bijv
niet datumgevoelig). Reviewers moeten ook "aegis -list change_details" gebruiken om te verifiëren
dat een wijziging wel of geen testvrijstellingen heeft.

vrijstellingen
Er kunnen verschillende toetsvrijstellingen worden verleend door projectbeheerders, zie aap(1) en
aepattr(5) voor meer informatie. Het kopiëren van toetsen naar een wijziging, of het toevoegen van nieuwe toetsen aan een
wijzigen, kunnen deze vrijstellingen annuleren.

TEST COMMAND CONFIGURATIE

De opdracht die wordt gebruikt om tests uit te voeren, wordt gedefinieerd door de test_opdracht veld in het project
configuratiebestand (zie aepconf(5) voor meer informatie), is dit standaard het gebruik van de
Bourne shell indien niet ingesteld. De huidige map is de top van de juiste
directory boom. Als tests tijdelijke bestanden vereisen, moeten ze deze in / tmp, als een
test kan niet verwachten schrijfrechten te hebben in de huidige directory.

Als u een geavanceerdere testengine wilt gebruiken in plaats van een eenvoudig shellscript,
maar deze testengine retourneert geen resultaatcodes die geschikt zijn voor gebruik met aegis, dat zou kunnen
verpak het in een shell-script dat de exit-status herschrijft in de waarden die aegis verwacht.
U kunt dezelfde resultaten ook bereiken door een complexer te schrijven test_opdracht in de
project config bestand.

Het is ook mogelijk om testcommando's te schrijven die meer dan één bestand tegelijk kunnen testen
eenmaal. Dit wordt gecontroleerd door de batch_test_opdracht gebied van het project config het dossier. In
in dit geval geeft de vervanging ${output} de naam aan van een bestand dat de testopdracht moet uitvoeren
creëren, erin aetest(5) formaat, om de resultaten van de uitgevoerde tests te bevatten. Hier wordt vaak gebruik van gemaakt
op systemen met meerdere CPU's of de mogelijkheid om taken over meerdere computers te verdelen
op een netwerk.

Vervangingen
Alle aesub(5) vervangingen zijn beschikbaar in de testcommando's. Sommige ervan zijn
van bijzonder belang:

ARCHitectuur
Deze vervanging wordt vervangen door de naam van de te testen architectuur.

Zoekpad
Deze vervanging wordt vervangen door een door dubbele punten gescheiden lijst met absolute paden naar
zoeken bij het zoeken naar testondersteuningsbestanden.

Zoekpad_uitvoerbaar
Deze vervanging wordt vervangen door een door dubbele punten gescheiden lijst met absolute paden naar
zoeken bij het zoeken naar uitvoerbare ondersteuningsbestanden (bibliotheekbestanden en
commando's).

Meestal $Search_Path_Executable zijn precies hetzelfde. Echter, tijdens “aegis -t
-bl” zullen ze anders zijn, met $Zoekpad beginnend bij de ontwikkelingsmap (de
test wordt uitgevoerd) en $Search_Path_Executable beginnend bij de basislijn (het uitvoerbare bestand is
loop).

test Resultaat Codes
Terwijl elke test wordt uitgevoerd (via de test_opdracht veld in het project config bestand), auspiciën
bepaalt of de test is geslaagd of mislukt door naar de exit-status te kijken. Deze uitgang
status is meestal zoals verwacht voor UNIX-commando's.

Succes
Een test moet eindigen op 0 om succes aan te geven, dat wil zeggen dat de specifieke functie wordt getest
werkte zoals verwacht.

Storing
Een test moet eindigen op 1 om een ​​storing aan te geven, dat wil zeggen dat de specifieke functie die wordt getest
werkte niet zoals verwacht.

Geen resultaat
Een test moet 2 verlaten om geen resultaat aan te geven, dat wil zeggen dat de specifieke functie onder
test kon niet worden uitgevoerd omdat er iets anders mis ging. Bijvoorbeeld hardlopen
onvoldoende schijfruimte bij het maken van de testinvoerbestanden in het / tmp directory.

overgeslagen
Een test moet 77 afsluiten om aan te geven dat deze is overgeslagen. Dit heeft meestal te maken met
de huidige architectuur is niet zinvol. Gebruik waar mogelijk "Geen resultaat"
in plaats van. (De waarde is gekozen vanwege compatibiliteit met andere testsystemen.)

In feite wordt elke andere exitcode dan 0, 1 of 77 geïnterpreteerd als "geen resultaat".
Het altijd gebruiken van 0, 1, 2 of 77 betekent echter dat als een nieuwe resultaatcode vereist is door a
latere release van Aegis zullen uw bestaande tests blijven werken.

TEST CORRELATIES

De opdracht "aegis -Test -SUGgest" kan worden gebruikt om auspiciën geschikte regressie te laten voorstellen
test voor uw wijziging, op basis van de bronbestanden in uw wijziging. Dit automatisch
richt de testinspanning op relevante tests, waardoor het aantal regressietests wordt verminderd
nodig om er zeker van te zijn dat u geen bug hebt geïntroduceerd.

De testcorrelaties worden gegenereerd door de opdracht "aegis -Integrate_Pass", die
koppelt elke test in de wijziging aan elk bronbestand in de wijziging. Dus elk
bronbestand verzamelt een lijst met tests die er in het verleden aan zijn gekoppeld.
Dit is niet zo exact als codedekkingsanalyse, maar is een redelijke benadering in
praktijk.

De acp(1) en aenf(1) commando's worden gebruikt om bestanden aan een wijziging te koppelen. Terwijl ze
voer de koppeling niet actief uit, dit zijn de bestanden die worden gebruikt door aeipas(1) en
aet(1) om te bepalen welke bronbestanden aan welke tests zijn gekoppeld.

test Correlatie Nauwkeurigheid
Ervan uitgaande dat de testcorrelaties nauwkeurig zijn en dat de tests gelijkmatig zijn
verdeeld over de functieruimte komt er een kleiner dan 1/nummer kans dat een
relevante test is niet uitgevoerd door de "aegis -Test -SUGgest aantal” commando. Een kleine
hoeveelheid ruis wordt toegevoegd aan de toetsweging, zodat er soms onverwachte zaken zijn
getest en worden niet elke keer dezelfde tests uitgevoerd.

De nauwkeurigheid van de testcorrelatie kan worden verbeterd door ervoor te zorgen dat:

· Elke verandering moet sterk gefocust zijn, zonder onnodige bestandsinsluitingen. Dit
vermijdt valse correlaties.

· Elk item met nieuwe functionaliteit moet worden toegevoegd in een individuele wijziging, in plaats van
meerdere bij elkaar. Dit correleert testen sterk met functionaliteit.

· Elke bug moet worden opgelost in een individuele wijziging, in plaats van meerdere samen. Dit
correleert tests sterk met functionaliteit.

· Testcorrelaties gaan verloren als bestanden worden verplaatst. Dit komt omdat correlaties door zijn
naam.

De beste manier voor tests om nauwkeurig te correleren met bronbestanden is wanneer er een wijziging is
bevat een test en precies die bestanden die betrekking hebben op de geteste functionaliteit. Te
veel valse bestanden zullen het nut van de testcorrelaties verzwakken.

OPTIES

De volgende opties worden begrepen:

-AUTOmatisch
Deze optie kan worden gebruikt om automatische tests te specificeren. Automatische tests vereisen geen
menselijke hulp.

-Basislijn
Deze optie kan worden gebruikt om te specificeren dat de baseline van het project het onderwerp is van:
het bevel.

-BAse_RElatief
Deze optie kan worden gebruikt om ervoor te zorgen dat relatieve bestandsnamen worden beschouwd als relatief ten opzichte van
de basis van de bronboom. Zien aeuconf(5) voor de corresponderende gebruiker
voorkeur.

-CUrrent_RElatief
Deze optie kan worden gebruikt om ervoor te zorgen dat relatieve bestandsnamen worden beschouwd als relatief ten opzichte van
de huidige map. Dit is meestal de standaardinstelling. Zien aeuconf(5) voor de
overeenkomstige gebruikersvoorkeur.

-Verandering aantal
Deze optie kan worden gebruikt om een ​​bepaalde wijziging binnen een project te specificeren. Zien
aegis(1) voor een volledige beschrijving van deze optie.

-Kracht Deze optie kan worden gebruikt om aan te geven dat alle tests moeten worden uitgevoerd, zelfs als de
status van de laatste testrun geeft aan dat het niet nodig is om een ​​specifieke test uit te voeren
test.

-Helpen
Deze optie kan worden gebruikt om meer informatie te verkrijgen over het gebruik van de aegis
programma.

-Onafhankelijk
Deze optie wordt gebruikt om aan te geven dat de test onafhankelijk van welke test dan ook moet worden uitgevoerd
bepaalde verandering. Als er geen tests zijn genoemd, worden alle tests in de basislijn uitgevoerd.

-Lijst
Deze optie kan worden gebruikt om een ​​lijst met geschikte onderwerpen voor deze opdracht te verkrijgen.
De lijst is mogelijk algemener dan verwacht.

-Handmatig Deze optie kan worden gebruikt om handmatige tests op te geven. Handmatige tests vereisen wat mensen
interventie, bijv.: bevestiging van bepaald schermgedrag (bijvoorbeeld X11), of
enige actie van de gebruiker, "ontkoppel nu de ethernetkabel".

-Niet_Loggen
Deze optie kan worden gebruikt om het automatisch loggen van uitvoer en fouten uit te schakelen naar:
een bestand. Dit is vaak handig wanneer verschillende aegis-commando's in een shell worden gecombineerd
scripts.

-Volhouden
Deze optie kan worden gebruikt om aan te geven dat alle tests moeten worden uitgevoerd, zelfs als er enkele zijn
mislukking. Standaard ingesteld op die van de gebruiker volharden_voorkeur indien niet gespecificeerd, zie
aeuconf(5) voor meer informatie.

-Geen_PERsevere
Deze optie kan worden gebruikt om aan te geven dat de testrun na de eerste moet stoppen
mislukking. Standaard ingesteld op die van de gebruiker volharden_voorkeur indien niet gespecificeerd, zie
aeuconf(5) voor meer informatie.

-Project naam
Deze optie kan worden gebruikt om het gewenste project te selecteren. wanneer nee? -Project
optie is opgegeven, de AEGIS_PROJECT omgevingsvariabele wordt geraadpleegd. Indien
die niet bestaat, die van de gebruiker $HOME/.aegisrc bestand wordt onderzocht op een standaard
projectveld (zie aeuconf(5) voor meer informatie). Als dat niet bestaat,
wanneer de gebruiker alleen aan wijzigingen binnen een enkel project werkt, wordt het project
naam is standaard voor dat project. Anders is het een fout.

-Voortgang
Deze optie kan worden gebruikt om aan te geven dat voortgangsberichten eerder moeten worden verzonden
elke testrun of voor elke batchtest in het geval dat batch_test_opdracht veld-
gespecificeerd in project config bestand (zie aeuconf(5) voor meer informatie).

-Geen vooruitgang
Deze optie kan worden gebruikt om aan te geven dat voortgangsberichten moeten worden onderdrukt.
Dit is de standaardinstelling.

-REgressie
Deze optie wordt gebruikt om aan te geven dat de regressietestsuite moet worden uitgevoerd. De
regressietestreeks bestaat uit alle tests in de basislijn die niet verschijnen
bij de verandering. Het is een fout als er geen regressietesten zijn. Je mag niet
naamtests op de opdrachtregel bij gebruik van de optie -REGression. U mag noemen
individuele tests die op de opdrachtregel kunnen worden uitgevoerd, zonder gebruik te maken van -REGression
keuze; als ze geen deel uitmaken van de wijziging, worden de tests met dezelfde naam in de
basislijn zal worden uitgevoerd.

-Voorstellen [ aantal ]
De "aegis -Integreer_Pass” commando verzamelt testcorrelatiestatistieken wanneer
veranderingen zijn geïntegreerd. Deze optie kan worden gebruikt om te vragen dat auspiciën voorstellen doen
welke tests moeten worden uitgevoerd, met behulp van deze testcorrelaties. Als er geen nummer is
gespecificeerd, worden 10 tests voorgesteld. Deze optie impliceert de -REgressie
optie.

-SUGgest_Limiet minuten
Deze optie kan worden gebruikt om het aantal tests te beperken tot een bepaald aantal
minuten. Ze worden uitgevoerd van meest relevant naar minst relevant.

-SUGgest_Lawaai aantal
Deze optie kan worden gebruikt om de hoeveelheid ruis die in de test wordt geïnjecteerd te regelen
selectie uitgevoerd door de -Voorstellen keuze. Het getal is een percentage van de ruis
geïnjecteerd worden. Standaard ingesteld op 10 indien niet opgegeven. De injectie van geluid zorgt voor
dat er verschillende tests worden uitgevoerd bij volgende runs, en ook enkele van het linkerveld
als een gezondheidscheck.

-TERZ
Deze optie kan worden gebruikt om ervoor te zorgen dat vermeldingen het absolute minimum aan
informatie. Het is meestal handig voor shellscripts.

Verbaasd
Deze optie kan worden gebruikt om ervoor te zorgen dat aegis meer output produceert. Standaard aegis
produceert alleen output bij fouten. Bij gebruik met de -Lijst optie deze optie
zorgt ervoor dat kolomkoppen worden toegevoegd.

-Wachten Deze optie kan worden gebruikt om Aegis-commando's te laten wachten op toegangsvergrendelingen, als:
ze kunnen niet onmiddellijk worden verkregen. Standaard ingesteld op de gebruiker lock_wait_preference
indien niet gespecificeerd, zie aeuconf(5) voor meer informatie.

-Nee wacht
Deze optie kan worden gebruikt om te eisen dat Aegis-commando's een fatale fout afgeven als toegang:
sloten kunnen niet direct worden verkregen. Standaard ingesteld op de gebruiker
lock_wait_preference indien niet gespecificeerd, zie aeuconf(5) voor meer informatie.

Zie ook aegis(1) voor opties die alle aegis-commando's gemeen hebben.

Alle opties kunnen worden afgekort; de afkorting is gedocumenteerd als de hoofdletters,
alle kleine letters en underscores (_) zijn optioneel. U moet opeenvolgend . gebruiken
reeksen van optionele letters.

Alle opties zijn niet hoofdlettergevoelig, u kunt ze typen in hoofdletters of kleine letters of a
combinatie van beide, case is niet belangrijk.

Bijvoorbeeld: de argumenten "-project, "-PROJ" en "-p" worden allemaal geïnterpreteerd als de
-Project optie. Het argument "-prj" wordt niet begrepen, omdat consecutief
optionele tekens zijn niet meegeleverd.

Opties en andere opdrachtregelargumenten kunnen willekeurig worden gemengd op de opdrachtregel,
na de functiekiezers.

De GNU lange optienamen worden begrepen. Aangezien alle optienamen voor aegis zijn lang,
dit betekent het negeren van de extra leidende '-'. De "--optie=waarde"conventie is ook"
begrepen.

AANBEVOLEN ALIAS

De aanbevolen alias voor deze opdracht is
csh% alias aet 'aegis -t \!* -v'
sh$ aet(){aegis -t "$@" -v}

FOUTEN

Het is een fout als de wijziging niet in een van de wezen ontwikkelde or wezen geïntegreerde
staten.
Het is een fout als de wijziging niet is toegewezen aan de huidige gebruiker.
Het is een vergissing als u geen relevante toetsen en geen relevante vrijstelling heeft.

EXIT STATUS

De aegis commando wordt afgesloten met een status van 1 bij elke fout. De aegis commando zal alleen
sluit af met een status van 0 als er geen fouten zijn.

MILIEU VARIABELEN

Bekijk aegis(1) voor een lijst met omgevingsvariabelen die van invloed kunnen zijn op deze opdracht. Zien
aepconf(5) voor de projectconfiguratiebestanden project_specifiek veld voor hoe in te stellen
omgevingsvariabelen voor alle opdrachten die door Aegis worden uitgevoerd.

Gebruik aet online met behulp van onworks.net-services