aet – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

Aegis-Test – Tests ausführen

ZUSAMMENFASSUNG

Ägide -Prüfung [ zu erhalten... ][ Name=Wert ][ Dateiname... ]
Ägide -Prüfung -Unabhängig [ zu erhalten... ][ Name=Wert ][ Dateiname... ]
Ägide -Prüfung -Aufführen [ zu erhalten... ]
Ägide -Prüfung -Hilfe

BESCHREIBUNG

Das Ägide -Prüfung Der Befehl wird zum Ausführen von Tests verwendet. Wenn keine Dateien benannt sind, werden alle relevanten Tests durchgeführt
werden ausgeführt. Standardmäßig werden sowohl automatische als auch manuelle Tests ausgeführt.

Sie können Verzeichnisse in der Befehlszeile und alle relevanten Tests in diesem Verzeichnis benennen
Baum in der Änderung wird ausgeführt. Es handelt sich um einen Fehler, wenn keine relevanten Tests vorliegen.

Jede Architektur muss separat getestet werden. Dies liegt daran, dass es subtil sein kann
Probleme, die nur auf einigen Architekturen auftreten. Einige Projekte haben möglicherweise auch
unterschiedlicher Code für unterschiedliche Architekturen.

Der Status des letzten Testlaufs wird gespeichert, sodass keine Tests ausgeführt werden, wenn dieser nicht vorhanden ist
brauchen. (Dies gilt nicht für -REgression Tests leider nicht.) Tests müssen erneut durchgeführt werden
wenn der Test zuvor fehlgeschlagen ist, wenn sich die Testdatei geändert hat, wenn ein Build stattgefunden hat,
und für jede Architektur.

Name = value
Sie können hinzufügen Name=Wert Paare an die Befehlszeile senden, werden diese unverändert an die übergeben
Testbefehl. Normalerweise am Ende der Befehlszeile, aber dies kann in geändert werden
Projektkonfigurationsdatei.

Das -Macht Die Option führt dazu, dass eine implizite Variable „force=1“ zur Liste hinzugefügt wird
Variablenzuweisungen und werden daher am Ende des Befehls hinzugefügt. Dies ist am nützlichsten, wenn
Verwendung der batch_test_command der Projektkonfigurationsdatei abgelegt.

Dies kann zunächst wie ein Endlauf des Entwicklungsprozesses aussehen, der die Durchführung von Testskripten ermöglicht
so geschrieben, dass sie alle richtigen Antworten geben, ohne tatsächlich etwas zu tun. Du
Ich war schon immer in der Lage, dies mit Umgebungsvariablen zu tun, daher ist das nichts Neues.

Es ist möglich, alle Variablenzuweisungen in Umgebungsvariablen umzuwandeln
durch Setzen von $var am Anfang des Befehls vor dem Namen der Shell und nicht bei
Der Standardspeicherort am Ende des Befehls.

Reichen Sie das Name und Vorname Dolmetschen
Das Programm aegis versucht, die Projektdateinamen aus den Dateinamen zu ermitteln
auf der Kommandozeile angegeben. Alle Dateinamen werden innerhalb von aegis-Projekten als relativ gespeichert
zum Stamm des Basisverzeichnisbaums. Das Entwicklungsverzeichnis und die
Integrationsverzeichnis sind Schatten dieses Basisverzeichnisses, daher diese relativen Namen
auch hier bewerben. In der Befehlszeile benannte Dateien werden zuerst in absolute Pfade konvertiert
Falls benötigt. Sie werden dann mit dem Baseline-Pfad, dem Entwicklungsverzeichnis, verglichen
path und den Integrationsverzeichnispfad, um einen baselinerelativen Namen zu bestimmen. es ist
ein Fehler, wenn sich die benannte Datei außerhalb einer dieser Verzeichnisbäume befindet.

Das -BAse_RElativ Option kann verwendet werden, um relative Dateinamen zu interpretieren als
relativ zum Basislinienpfad; absolute Dateinamen werden trotzdem mit den verschiedenen verglichen
Pfade, um einen baseline-relativen Namen zu ermitteln.

Das relativer_dateiname_präferenz in der Benutzerkonfigurationsdatei kann zum Ändern verwendet werden
dieses Standardverhalten. Sehen euconf(5) für weitere Informationen.

TESTEN PROZESSE

Jede Änderung muss von Tests begleitet werden, und diese Tests müssen auch durchgeführt werden
werden gegen das erstellte Entwicklungsverzeichnis ausgeführt und müssen bestanden werden. Dies stellt sicher, dass neu
Die Funktionalität wird von Tests zur Überprüfung ihrer Richtigkeit und Fehlerbehebungen begleitet
begleitet von Tests, die bestätigen, dass der Fehler behoben wurde.

Regression Tests
Tests werden wie jede andere Quelldatei behandelt und in der Baseline und verwaltet
Verlauf mit allen anderen Quelldateien. Die Tests, die jede Veränderung begleiten müssen
akkumulieren sich in der Projektbasislinie und liefern eine Definition der korrekten Funktion für das
Grundlinie. Diese gesammelten Tests können mit dem Befehl „aegis -REGression“ ausgeführt werden.
um sicherzustellen, dass das Projekt aufgrund einer Änderung nicht „rückläufig“ wird.

Baseline Tests
Für die Tests sind Fehlerbehebungen erforderlich scheitern gegenüber der Projektbasislinie (im Gegensatz dazu).
ins Entwicklungsverzeichnis). Dadurch wird sichergestellt, dass der Test den Fehler tatsächlich demonstriert
in der Grundlinie sowie der Nachweis, dass es durch die Änderung behoben wird. Neu
Die Funktionalität schlägt gegenüber der Grundlinie trivial fehl, weshalb Aegis dies nicht versucht
Schätzen Sie, ob es sich bei einem Test um einen Bugfix-Test oder einen neuen Funktionstest handelt, es sind lediglich Tests erforderlich
gegen die Grundlinie scheitern.

Diese Anforderung gilt sowohl für neue Tests, die durch eine Änderung entstehen, als auch für Tests
die zur Änderung in eine Änderung kopiert wurden.

Reviewing Tests
Prüfer können darauf vertrauen, dass Aegis die Testanforderungen durchgesetzt hat; Das ist eine Veränderung
muss Tests haben, dass die Änderung erstellt werden muss, dass die Tests gegen die Entwicklung bestehen müssen
Verzeichnis und dass die Tests im Vergleich zur Baseline fehlschlagen. Diese Bedingungen werden durchgesetzt
by aede(1) und die Änderung wird nicht vorgezogen Sein bewertet Zustand bis diese
Bedingungen erfüllt sind. Gutachter sollten daher Tests überprüfen für Vollständigkeit der Berichterstattung von
der Code in der Änderung und Unempfindlichkeit gegenüber Änderungen in der Ausführungsumgebung (z. B
nicht datumsabhängig). Prüfer sollten zur Überprüfung auch „aegis -list change_details“ verwenden
dass eine Änderung Testausnahmen enthält oder nicht.

Ausnahmen
Verschiedene Testausnahmen können von Projektadministratoren gewährt werden, siehe aepa(1) und
aepattr(5) für weitere Informationen. Kopieren von Tests in eine Änderung oder Hinzufügen neuer Tests zu einer
Änderungen können diese Ausnahmen aufheben.

TESTEN COMMAND CONFIGURATION

Der zum Ausführen von Tests verwendete Befehl wird durch definiert test_command Feld im Projekt
Konfigurationsdatei (siehe aepconf(5) für weitere Informationen), wird standardmäßig die verwendet
Bourne-Shell, falls nicht festgelegt. Das aktuelle Verzeichnis befindet sich ganz oben im entsprechenden Verzeichnis
Verzeichnisbaum. Wenn Tests temporäre Dateien erfordern, sollten sie diese erstellen / Tmp, als ein
test kann nicht damit rechnen, im aktuellen Verzeichnis über Schreibrechte zu verfügen.

Wenn Sie statt eines einfachen Shell-Skripts eine anspruchsvollere Test-Engine verwenden möchten,
Aber diese Test-Engine gibt keine Ergebniscodes zurück, die für die Verwendung mit Aegis geeignet sind
Binden Sie es in ein Shell-Skript ein, das den Exit-Status in die von Aegis erwarteten Werte umschreibt.
Sie könnten die gleichen Ergebnisse auch erzielen, indem Sie einen komplexeren Text schreiben test_command der
Projekt Config Datei.

Es ist auch möglich, Testbefehle zu schreiben, die mehr als eine Datei gleichzeitig testen können
einmal. Dies wird durch die gesteuert batch_test_command Bereich des Projekts Config Datei. In
In diesem Fall gibt die Ersetzung ${output} den Namen einer Datei an, die der Testbefehl enthalten muss
erstellen, in aetest(5) Format, um die Ergebnisse der durchgeführten Tests zu enthalten. Dies wird häufig verwendet
auf Systemen mit mehreren CPUs oder die Möglichkeit, Jobs auf mehrere Computer zu verteilen
in einem Netzwerk.

Auswechslungen
Alle der aesub(5) Ersetzungen sind in den Testbefehlen verfügbar. Einige von ihnen sind
Besonders hervorzuheben:

Die Architektur
Diese Ersetzung wird durch den Namen der zu testenden Architektur ersetzt.

Suchpfad
Diese Ersetzung wird durch eine durch Doppelpunkte getrennte Liste absoluter Pfade zu ersetzt
Suchen Sie bei der Suche nach Testunterstützungsdateien.

Search_Path_Executable
Diese Ersetzung wird durch eine durch Doppelpunkte getrennte Liste absoluter Pfade zu ersetzt
Suche bei der Suche nach ausführbaren Unterstützungsdateien (Bibliotheksdateien und Unterdateien)
Befehle).

Meistens $Search_Path_Executable sind genau gleich. Während „aegis -t
-bl“ werden sie anders sein, mit $Search_Path Beginnend im Entwicklungsverzeichnis (der
Test läuft) und $Search_Path_Executable Beginnend bei der Basislinie (dem ausführbaren Wesen).
Lauf).

Test Ergebnis Codes
Während jeder Test ausgeführt wird (über die test_command Feld im Projekt Config Datei), aegis
Bestimmt anhand seines Beendigungsstatus, ob der Test erfolgreich war oder fehlgeschlagen ist. Dieser Ausgang
Der Status entspricht größtenteils den Erwartungen für UNIX-Befehle.

Erfolge
Ein Test sollte 0 beenden, um den Erfolg anzuzeigen, d. h. dass die spezifische Funktion getestet wird
funktionierte wie erwartet.

Scheitern
Ein Test sollte 1 beenden, um einen Fehler anzuzeigen, d. h. dass die spezifische Funktion getestet wird
hat nicht wie erwartet funktioniert.

Keine Ergebnisse
Ein Test sollte 2 beenden, um anzuzeigen, dass kein Ergebnis vorliegt. dh dass die spezifische Funktion unter
Der Test konnte nicht durchgeführt werden, weil etwas anderes schief gelaufen ist. Zum Beispiel Laufen
Nicht genügend Speicherplatz beim Erstellen der Testeingabedateien im / Tmp Verzeichnis.

Übersprungen
Ein Test sollte 77 beenden, um anzuzeigen, dass er übersprungen wurde. Dies hat normalerweise damit zu tun
Die aktuelle Architektur ist nicht sinnvoll. Verwenden Sie nach Möglichkeit „Kein Ergebnis“.
stattdessen. (Der Wert wurde aus Gründen der Kompatibilität mit anderen Testsystemen gewählt.)

Tatsächlich wird jeder andere Exit-Code als 0, 1 oder 77 als „kein Ergebnis“ interpretiert.
Die Verwendung von immer 0, 1, 2 oder 77 bedeutet jedoch, dass ein neuer Ergebniscode erforderlich ist
Mit einer späteren Veröffentlichung von Aegis funktionieren Ihre vorhandenen Tests weiterhin.

TESTEN ZUSAMMENHANG

Der Befehl „aegis -Test -SUGgest“ kann verwendet werden, damit Aegis eine geeignete Regression vorschlägt
Tests für Ihre Änderung, basierend auf den Quelldateien in Ihrer Änderung. Dies automatisch
Konzentriert den Testaufwand auf relevante Tests und reduziert so die Anzahl der Regressionstests
Sie müssen sicher sein, dass Sie keinen Fehler eingeführt haben.

Die Testkorrelationen werden durch den Befehl „aegis -Integrate_Pass“ generiert, der
Ordnet jeden Test in der Änderung jeder Quelldatei in der Änderung zu. Also jeder
Die Quelldatei sammelt eine Liste von Tests, die ihr in der Vergangenheit zugeordnet wurden.
Dies ist nicht so genau wie die Codeabdeckungsanalyse, stellt aber eine vernünftige Annäherung dar
trainieren.

Das aecp(1) und aenf(1) Befehle werden verwendet, um Dateien einer Änderung zuzuordnen. Während sie
Führen Sie die Zuordnung nicht aktiv durch. Dies sind die Dateien, die von verwendet werden aeipass(1) und
aet(1) um zu bestimmen, welche Quelldateien mit welchen Tests verknüpft sind.

Test Korrelation Genauigkeit
Vorausgesetzt, dass die Testkorrelationen korrekt und die Tests gleichmäßig sind
Über den Veranstaltungsraum verteilt entsteht ein Kleiner als 1/Anzahl Chance, dass a
Der relevante Test wurde nicht von „aegis -Test -SUGgest“ ausgeführt Anzahl" Befehl. Ein kleines
Der Testgewichtung wird eine Menge Rauschen hinzugefügt, so dass es manchmal zu unerwarteten Dingen kommt
getestet und es werden nicht jedes Mal dieselben Tests durchgeführt.

Die Genauigkeit der Testkorrelation kann verbessert werden, indem Folgendes sichergestellt wird:

· Jede Änderung sollte stark fokussiert sein und keine unnötigen Dateieinschlüsse enthalten. Das
vermeidet falsche Korrelationen.

· Jedes Element neuer Funktionalität sollte in einer einzelnen Änderung hinzugefügt werden, anstatt
mehrere zusammen. Dies korreliert Tests stark mit der Funktionalität.

· Jeder Fehler sollte in einer einzelnen Änderung behoben werden und nicht in mehreren zusammen. Das
korreliert Tests stark mit der Funktionalität.

· Testkorrelationen gehen verloren, wenn Dateien verschoben werden. Dies liegt daran, dass Korrelationen durch sind
Namen.

Die beste Möglichkeit für Tests, genau mit den Quelldateien zu korrelieren, ist eine Änderung
enthält einen Test und genau die Dateien, die sich auf die zu testende Funktionalität beziehen. Zu
Viele falsche Dateien schwächen den Nutzen der Testkorrelationen.

OPTIONAL

Folgende Optionen werden verstanden:

-AUTOmatisch
Mit dieser Option können automatische Tests festgelegt werden. Automatische Tests erfordern keine
menschliche Hilfe.

-Basislinie
Diese Option kann verwendet werden, um anzugeben, dass die Projekt-Baseline Gegenstand von
der Befehl.

-BAse_RElativ
Diese Option kann verwendet werden, um relative Dateinamen als relativ zu zu betrachten
die Basis des Quellbaums. Sehen euconf(5) für den entsprechenden Benutzer
Präferenz.

-CUrrent_RElative
Diese Option kann verwendet werden, um relative Dateinamen als relativ zu zu betrachten
das aktuelle Verzeichnis. Dies ist normalerweise die Standardeinstellung. Sehen euconf(5) für die
entsprechende Benutzerpräferenz.

-Veränderung Anzahl
Diese Option kann verwendet werden, um eine bestimmte Änderung innerhalb eines Projekts anzugeben. Sehen
Ägide(1) für eine vollständige Beschreibung dieser Option.

-Gewalt Diese Option kann verwendet werden, um anzugeben, dass alle Tests ausgeführt werden sollen, auch wenn die
Der Status des letzten Testlaufs zeigt an, dass kein Bedarf besteht, einen bestimmten Testlauf auszuführen
Test.

-Hilfe
Diese Option kann verwendet werden, um weitere Informationen zur Verwendung des Ägide


-Unabhängig
Mit dieser Option wird angegeben, dass der Test unabhängig von anderen ausgeführt werden soll
besondere Veränderung. Wenn keine Tests benannt sind, werden alle Tests in der Baseline ausgeführt.

-Aufführen
Diese Option kann verwendet werden, um eine Liste geeigneter Themen für diesen Befehl zu erhalten.
Die Liste ist möglicherweise allgemeiner als erwartet.

-Handbuch Mit dieser Option können manuelle Tests angegeben werden. Manuelle Tests erfordern etwas menschliches Personal
Eingriff, z. B.: Bestätigung eines Bildschirmverhaltens (z. B. X11) oder
Einige Benutzeraktionen: „Jetzt Ethernet-Kabel abziehen“.

-Not_Logging
Diese Option kann verwendet werden, um die automatische Protokollierung von Ausgaben und Fehlern zu deaktivieren
eine Datei. Dies ist oft nützlich, wenn mehrere aegis-Befehle in einer Shell zusammengefasst sind
Skripte.

-BEharrlich
Diese Option kann verwendet werden, um anzugeben, dass alle Tests ausgeführt werden sollen, auch wenn einige davon vorhanden sind
scheitern. Standardmäßig wird die des Benutzers verwendet beharren_präferenz wenn nicht angegeben, siehe
euconf(5) für weitere Informationen.

-No_PEsevere
Mit dieser Option kann festgelegt werden, dass der Testlauf nach dem ersten beendet werden soll
Versagen. Standardmäßig wird die des Benutzers verwendet beharren_präferenz wenn nicht angegeben, siehe
euconf(5) für weitere Informationen.

-Projekt Name
Diese Option kann verwendet werden, um das gewünschte Projekt auszuwählen. Wenn nein -Projekt
Option angegeben ist, die AEGIS_PROJEKT Umgebungsvariable wird konsultiert. Wenn
die nicht existiert, die des Benutzers $HOME/.aegisrc Datei wird auf einen Standard untersucht
Projektfeld (siehe euconf(5) für weitere Informationen). Wenn das nicht existiert,
Wenn der Benutzer nur an Änderungen innerhalb eines einzelnen Projekts arbeitet, wird das Projekt
Der Name ist standardmäßig auf dieses Projekt eingestellt. Andernfalls handelt es sich um einen Fehler.

-Fortschritt
Mit dieser Option kann festgelegt werden, dass vorher Fortschrittsmeldungen ausgegeben werden sollen
bei jedem Testlauf oder ggf. vor jedem Batch-Testlauf batch_test_command Feld
im Projekt angegeben Config Datei (siehe euconf(5) für weitere Informationen).

-Keine Fortschritte
Mit dieser Option kann festgelegt werden, dass Fortschrittsmeldungen unterdrückt werden sollen.
Dies ist der Standardwert.

-REgression
Mit dieser Option wird angegeben, dass die Regressionstestsuite ausgeführt werden soll. Der
Die Regressionstestsuite besteht aus allen Tests in der Basislinie, die nicht angezeigt werden
im Wandel. Es handelt sich um einen Fehler, wenn keine Regressionstests vorhanden sind. Möglicherweise nicht
Namenstests auf der Befehlszeile bei Verwendung der Option -REGression. Sie dürfen benennen
Einzelne Tests können auf der Befehlszeile ausgeführt werden, ohne die -REgression zu verwenden
Möglichkeit; wenn sie nicht Teil der Änderung sind, werden die gleichnamigen Tests in der
Die Grundlinie wird ausgeführt.

-Vorschlagen [ Anzahl ]
Das "Ägide -Integrate_PassDer Befehl sammelt Testkorrelationsstatistiken, wenn
Änderungen werden integriert. Diese Option kann verwendet werden, um einen Vorschlag von Aegis anzufordern
welche Tests anhand dieser Testkorrelationen durchgeführt werden sollen. Wenn keine Nummer vorhanden ist
angegeben, werden 10 Tests vorgeschlagen. Diese Option impliziert die -REgression
.

-SUGgest_Limit Minuten
Mit dieser Option kann die Anzahl der Tests auf eine bestimmte Anzahl begrenzt werden
Protokoll. Sie werden vom relevantesten zum am wenigsten relevanten ausgeführt.

-SUGgest_Noise Anzahl
Diese Option kann verwendet werden, um die Menge des in den Test eingespeisten Rauschens zu steuern
Auswahl durch die durchgeführt -Vorschlagen Möglichkeit. Die Zahl ist ein Prozentsatz des Lärms
injiziert werden. Der Standardwert ist 10, wenn nicht angegeben. Die Einspeisung von Lärm sorgt dafür
dass bei nachfolgenden Läufen verschiedene Tests durchgeführt werden, einige auch aus dem linken Feld
als Gesundheitscheck.

-Knapp
Diese Option kann verwendet werden, um zu veranlassen, dass Listings das absolute Minimum an
Information. Es ist normalerweise für Shell-Skripte nützlich.

-Ausführlich
Diese Option kann verwendet werden, um aegis zu veranlassen, mehr Ausgabe zu erzeugen. Standardmäßig aegis
erzeugt nur bei Fehlern eine Ausgabe. Bei Verwendung mit dem -Aufführen Option diese Option
bewirkt, dass Spaltenüberschriften hinzugefügt werden.

-Warten Diese Option kann verwendet werden, um zu verlangen, dass Aegis-Befehle auf Zugriffssperren warten, wenn
sie sind nicht sofort erhältlich. Standardmäßig die des Benutzers lock_wait_preference
wenn nicht angegeben, siehe euconf(5) für weitere Informationen.

-Nein_Warten
Diese Option kann verwendet werden, um zu verlangen, dass Aegis-Befehle einen schwerwiegenden Fehler ausgeben, wenn Zugriff
Schlösser sind nicht sofort erhältlich. Standardmäßig die des Benutzers
lock_wait_preference wenn nicht angegeben, siehe euconf(5) für weitere Informationen.

[VORLÄUFIGE VOLLAUTOMATISCHE TEXTÜBERSETZUNG - muss noch überarbeitet werden. Wir bitten um Ihr Verständnis.] Ägide(1) für Optionen, die allen aegis-Befehlen gemeinsam sind.

Alle Optionen können abgekürzt werden; die Abkürzung wird als Großbuchstaben dokumentiert,
alle Kleinbuchstaben und Unterstriche (_) sind optional. Sie müssen aufeinanderfolgend verwenden
Folgen von optionalen Buchstaben.

Bei allen Optionen wird die Groß-/Kleinschreibung nicht beachtet, Sie können sie in Groß- oder Kleinschreibung oder a . eingeben
Kombination von beiden, Groß-/Kleinschreibung ist nicht wichtig.

Zum Beispiel: Die Argumente "-project, "-PROJ" und "-p" werden alle so interpretiert, dass sie die
-Projekt Möglichkeit. Das Argument "-prj" wird nicht verstanden, da aufeinanderfolgend
optionale Zeichen wurden nicht angegeben.

Optionen und andere Befehlszeilenargumente können auf der Befehlszeile beliebig gemischt werden,
nach den Funktionswählern.

Die langen Optionsnamen von GNU werden verstanden. Da alle Optionsnamen für Ägide sind lang,
Dies bedeutet, dass das zusätzliche führende '-' ignoriert wird. Die "--zu erhalten=Wert"Konvention ist auch
verstanden.

EMPFOHLEN ALIAS

Der empfohlene Alias ​​für diesen Befehl ist
csh% alias aet 'aegis -t \!* -v'
sh$ aet(){aegis -t "$@" -v}

FEHLER

Es handelt sich um einen Fehler, wenn sich die Änderung nicht in einem der folgenden befindet Sein entwickelt or Sein integriert
Zustände.
Es ist ein Fehler, wenn die Änderung nicht dem aktuellen Benutzer zugewiesen ist.
Es ist ein Fehler, wenn Sie keine relevanten Tests und keine relevante Ausnahmegenehmigung haben.

EXIT STATUS

Das Ägide Der Befehl wird bei jedem Fehler mit dem Status 1 beendet. Die Ägide Befehl wird nur
mit dem Status 0 beenden, wenn keine Fehler vorliegen.

VARIABLEN

See Ägide(1) für eine Liste von Umgebungsvariablen, die diesen Befehl beeinflussen können. Sehen
aepconf(5) für die Projektkonfigurationsdatei projektspezifisch Feld für die Einstellung
Umgebungsvariablen für alle von Aegis ausgeführten Befehle.

Nutzen Sie aet online über die Dienste von onworks.net