dirts

Drecks (Abhängigkeitsinjektionswahrerregressionstestauswahl)

Dirts ist ein statisches Forschungsinstrument der Klassen- oder Methodenebene (Regressionstestauswahl), das sich auf die DI-Mechanismen (DI-Injektions) der Abhängigkeit (DI) bewusst ist.

Voraussetzungen

• JDK> = 11
• Maven Surefire> = 2,14 (obwohl empfohlen> = 3,0,0 m5)
• Jede Version von Junit

Maven Ziele

Wählen Sie Mojos

Mojo	Beschreibung
class_level_select	Wählen Sie Tests mit dem Ansatz auf Klassenebene aus
method_level_select	Wählen Sie Tests mit dem Ansatz auf Methodenebene aus

Graph Mojos

Mojo	Beschreibung
class_level_graph	Graph anzeigen, die durch den Ansatz auf Klassenebene erstellt wurde
method_level_graph	Graph anzeigen, die durch den Ansatz auf Methodenebene erstellt wurden

Dienstprogramm Mojos

Mojo	Beschreibung
clean	Bereinigen Sie temporäre Dateien und Verzeichnisse

Konfigurationsoptionen

Relevant für jedes Mojo

Option	Beschreibung	Standard
logging	Protokollierungsstufe (Werte in java.util.logging.Level )	INFO
useSpringExtension	Analysieren Sie die Abhängigkeiten, die durch Frühling induziert werden	false
useGuiceExtension	Analysieren Sie die durch Guice induzierten Abhängigkeiten	false
useCDIExtension	Analysieren Sie die durch CDI induzierten Abhängigkeiten	false

Relevant für ausgewählte Mojos

Option	Beschreibung	Standard
standalone	Laufen im Standalone -Modus - Wenn nicht vorhanden, erwartet Dirts, dass ein anderer RTS -Tool bereits einige Tests in der excludesFile ausgeschlossen hat	false
overrideExtension	In Kombination mit standalone=false verhalten sich das Tool aus eigenem Ermessen, aber nur Tests ausschließen, die von DI-bezogenen Änderungen betroffen sind	false

Relevant für Graph Mojos

Option	Beschreibung	Standard
toFile	Speichern Sie die Grafikdarstellung auf dem Dateisystem, anstatt sie in STDOut zu drucken	false
outputFile	Der Name der Datei, in der das Diagramm gespeichert wird, wenn toFile auf true eingestellt ist	[class|method]_level

Anwendungsfälle

Eigenständig

Dirten können für RTs vollständig eigenständig verwendet werden, indem standalone=true angegeben wird.

Als Erweiterung eines anderen RTS -Tools

Dirten können auch verwendet werden, um nach einem anderen RTS-Tool zu laufen, und nur für Tests, die durch DI-bezogene Änderungen betroffen sind, korrekt sind. Das andere Tool ist erforderlich, um Tests in der von der SURFIRE excludesFile -Eigenschaft angegebenen Datei auszuschließen. Dirten muss nach dem anderen RTS-Tool laufen und kommentieren dann die Tests, die von DI-bezogenen Änderungen betroffen sind, aber bereits ausgeschlossen wurden. Dies ist das Standardverhalten von Dirten.

Nutzungsbeispiele

Dirten ist so gebaut, dass sie mit Maven -Selefire verwendet werden. Der einfachste Weg, Drecks in einem Maven -Projekt zu verwenden, ist das Dirten Maven Plugin:

< plugin >
    < groupId >edu.tum.sse.dirts</ groupId >
    < artifactId >dirts-maven-plugin</ artifactId >
    < version >${dirts.version}</ version >
    < configuration >
        ...
    </ configuration >
</ plugin >

Voraussetzungen

1. excludesFile -Property muss für jedes Submodul getrennt festgelegt werden. Andernfalls funktioniert der Testausschluss nicht.
2. Die Analyse für die gewünschten DI-Frameworks sollte aktiviert werden, indem die jeweilige Eigenschaft (z. B. useSpringExtension ) auf true festgelegt wird.

Kompilieren, auswählen und auf einmal testen

Auch wenn Dirten den Klartextcode analysiert, kann es bei bestimmten Abhängigkeiten zwischen den Moduls möglicherweise vor der Ausführung des Auswahlverfahrens kompiliert werden.

$ mvn compile dirts:class_level_select test

Wählen Sie und testen Sie dann nur die Module, die mindestens einen Test ausgewählt haben

Dirts erstellt eine Liste dieser Module in .dirts/affected_modules im Ordner des äußersten Moduls.

$ mvn dirts:class_level_select
$ mvn -am -pl " $( cat .dirts/affected_modules ) " test

Kombiniert mit Git - Testauswahl vor dem Zusammenführen

1. Checkout der Hauptzweig.
2. Führen Sie die Auswahl aus, um Prüfsummen und Grafiken zu erstellen, wenn diese Dateien noch nicht vorhanden sind. ZB: $ mvn dirts:class_level_select
3. Checkout in der Feature -Zweigstelle.
4. Auswahl und Tests ausführen.

• Für die kombinierte Zusammenstellung, Auswahl und Testausführung: $ mvn compile dirts:class_level_select test
• Nur um die betroffenen Module zu kompilieren und zu testen:

$ mvn dirts:class_level_select
$ mvn -am -pl " $( cat .dirts/affected_modules ) " test 

Aufstellen

Dirten bauen einfach rennen:

$ mvn clean install

Dadurch wird der Code für alle Module erstellt, alle Tests ausgeführt und die Gläser in Ihrem lokalen Maven -Repository installiert.