dirts

Dirts (sélection de la régression de régression de la dépendance))

DIRTS est un outil de recherche statique au niveau de la classe ou au niveau de la méthode (RTS) qui est conscient des mécanismes d'injection de dépendance (DI).

Condition préalable

• Jdk> = 11
• Maven SureFire> = 2,14 (bien que recommandé> = 3,0,0-m5)
• Toute version de Junit

Objectifs maven

Sélectionnez Mojos

Mojo	Description
class_level_select	Sélectionnez des tests à l'aide de l'approche au niveau de la classe
method_level_select	Sélectionnez des tests à l'aide de l'approche au niveau de la méthode

Graphique Mojos

Mojo	Description
class_level_graph	Afficher le graphique créé par l'approche au niveau de la classe
method_level_graph	Afficher le graphique créé par l'approche au niveau de la méthode

Mojos utilitaire

Mojo	Description
clean	Nettoyer des fichiers et répertoires temporaires

Options de configuration

Pertinent pour chaque mojo

Option	Description	Défaut
logging	Niveau de journalisation (valeurs dans java.util.logging.Level )	INFO
useSpringExtension	Analyser les dépendances induites par le printemps	false
useGuiceExtension	Analyser les dépendances induites par Guice	false
useCDIExtension	Analyser les dépendances induites par CDI	false

Pertinent pour sélectionner Mojos

Option	Description	Défaut
standalone	Exécuter en mode autonome - s'il n'est pas présent, Dirts s'attend à ce qu'un autre RTS-Tool ait déjà exclu certains tests dans les excludesFile	false
overrideExtension	En combinaison avec standalone=false , se comporter comme l'outil s'exécute autonome mais exclut uniquement les tests affectés par les modifications liées à la DI	false

Pertinent pour le graphique Mojos

Option	Description	Défaut
toFile	Stocker la représentation des graphiques sur le système de fichiers au lieu de l'imprimer à STDOUT	false
outputFile	Le nom du fichier, où le graphique est stocké si toFile est défini sur true	[class|method]_level

Cas d'utilisation

Autonome

Les dirts peuvent être utilisés complètement autonomes pour RTS en spécifiant standalone=true .

Comme extension à un autre outil RTS

Les Dirts peuvent également être utilisés pour s'exécuter après un autre outil RTS et ne corriger que les tests affectés par les modifications liées à la DI. L'autre outil est requis pour exclure les tests dans le fichier spécifié par la propriété excludesFile de SureFire. Dirts doit s'exécuter après l'autre outil RTS et commentera ensuite les tests qui sont affectés par les modifications liées à la DI, mais qui ont été exclues auparavant. Il s'agit du comportement par défaut des dirts.

Exemples d'utilisation

Dirts est conçu pour être utilisé avec Maven Surefire. La façon la plus simple d'utiliser les dirts dans un projet Maven passe par le plugin Dirts Maven:

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

Condition préalable

1. excludesFile de SureFire -Property doivent être définies, idéalement pour chaque sous-module séparément. Sinon, l'exclusion de test ne fonctionnera pas.
2. L'analyse des digrames de divins souhaités doit être activée, en définissant la propriété respective (par exemple, useSpringExtension ) sur true .

Compiler, sélectionner et tester en une seule fois

Même si Dirts analyse le code source simple, dans le cas de certaines dépendances intermodules, il peut être nécessaire de compiler avant d'exécuter la procédure de sélection.

$ mvn compile dirts:class_level_select test

Sélectionnez, puis compilez et testez uniquement les modules qui ont au moins un test sélectionné

Dirts crée une liste de ces modules dans .dirts/affected_modules à l'intérieur du dossier du module le plus extérieur.

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

Combiné avec Git - Sélection de test avant la fusion

1. Découvrez la branche principale.
2. Exécutez la sélection pour créer des sommes de contrôle et du graphique, si ces fichiers n'existent pas déjà. Par exemple: $ mvn dirts:class_level_select
3. Découvrez la branche des fonctionnalités.
4. Exécutez la sélection et les tests.

• Pour la compilation, la sélection et l'exécution des tests combinés: $ mvn compile dirts:class_level_select test
• Pour ne compiler et tester les modules affectés:

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

Installation

Pour construire des dirts, exécutez simplement:

$ mvn clean install

Cela créera le code pour tous les modules, exécutera tous les tests et installera les pots sur votre référentiel Maven local.