Diese Seite zeigt, wie Sie JaCoCo (Test-Coverage) und PIT (Mutationstests) direkt lokal ausführen – ohne Commit und Push. Die Werkzeuge sind in der pom.xml bereits vorkonfiguriert und liefern dieselben Zahlen wie die Pipeline.

• Maven-Targets für JaCoCo und PIT anlegen
• Ausführen und Ergebnisse interpretieren
  • JaCoCo
  • PIT

Auf Ihrer Testseite laufen JaCoCo und PIT automatisch in der Pipeline. Sie können dieselbe Analyse aber auch lokal ausführen — direkt in Ihrem Projekt, ohne erst zu committen und zu pushen. Das ist der schnelle Weg, um die Qualität Ihrer Tests zu beurteilen und zu verbessern: Sie sehen sofort, wo Ihre Tests noch Lücken haben, und müssen nicht auf die Aktualisierung der Testseite warten.

Die beiden Werkzeuge sind im Projekt (pom.xml) bereits passend vorkonfiguriert. Sie müssen nur ein maven-Target in der IDE (hier demonstriert für IntelliJ) einrichten, um die Analyse zu starten.

Maven-Targets für JaCoCo und PIT anlegen

(1) Im Dropdown-Menü, wo das zuletzt angezeigte Target dargestellt wird, “Edit Configurations” auswählen (Mein IntelliJ ist auf Englisch eingestellt. Wenn Sie das auf Deutsch haben, heißt es dann entsprechend anders bei Ihnen.)

(2) Auf das “+”-Symbol klicken, um eine neue Konfiguration hinzuzufügen, und “Maven” auswählen.

(3) Im Feld “Name” einen Namen eingeben, z.B. “JaCoCo/PIT lokal”. Im Feld “Command line” den folgenden Befehl eingeben:

test jacoco:report org.pitest:pitest-maven:mutationCoverage 
-DtargetClasses=thkoeln.archilab.restaurant.domainprimitives.* 
-DtargetTests=thkoeln.archilab.restaurant.unit_and_integration_tests.domainprimitives.* 
-Dtest=thkoeln.archilab.restaurant.unit_and_integration_tests.**.*Test

-DtargetClasses und -DtargetTests sorgen dafür, dass nur bestimmte Klassen und bestimmte Tests analysiert werden. Das können Sie dann je nach Aufgabenstellung anpassen und natürlich auch mehrere solche Maven-Commands nebeneinander anlegen, wenn Sie möchten.

Ausführen und Ergebnisse interpretieren

Laufen lassen Sie JaCoCo und PIT dann, indem Sie einfach das Target auswählen und auf Run klicken (beziehungsweise auf den kleinen grünen Pfeil, der neben dem Dropdown-Feld ist.) Voraussetzung: Ihr Projekt muss compilieren.

Beide Tools schreiben anschließend einen HTML-Report, den Sie im Browser öffnen können. JaCoCo zeigt Ihnen die Test-Coverage, während PIT die Ergebnisse der Mutationstests anzeigt. Die Links führen zu dedizierten Info-Pages für die beiden Tools. Dort können Sie erfahren, wie Sie die Ergebnisse interpretieren und was Sie tun können, um Ihre Tests zu verbessern.

JaCoCo

Die JaCoCo-Ergebnisse liegen als HTML-Report unter target/site/jacoco/index.html. Wenn Sie über die rechte Maustaste den Run-Befehl auswählen, dann ist es ein Shortcut dazu, den Browser auf index.html zu öffnen und das dann gleichzeitig als Target in Ihren Runtime Configurations abzulegen. Mit Ctrl+Shift+F10 können Sie dann jederzeit direkt diesen Report aufrufen, ohne erst die Runtime Configuration zu öffnen.

PIT

Auch PIT schreibt einen HTML Report, der liegt unter target/pit-reports/index.html. Auch hier können Sie über die Runtime Configuration einen Shortcut anlegen, um diesen Report direkt aufzurufen (oder Ctrl+Shift+F10).