dirts

Dirts (selección de la prueba de regresión consciente de la inyección de dependencia)

DIRTS es una herramienta de investigación de prueba de regresión de clase o de regresión de nivel de método (RTS) estática que es consciente de los mecanismos de inyección de dependencia (DI).

Requisitos previos

• Jdk> = 11
• Maven SureFire> = 2.14 (aunque recomendado> = 3.0.0-m5)
• Cualquier versión de Junit

Metas maven

Seleccionar mojos

Mojo	Descripción
class_level_select	Seleccione pruebas utilizando el enfoque de nivel de clase
method_level_select	Seleccione pruebas utilizando el enfoque de nivel de método

Gráficos mojos

Mojo	Descripción
class_level_graph	Mostrar gráfico creado por el enfoque a nivel de clase
method_level_graph	Mostrar gráfico creado por el enfoque de nivel de método

Mojos de servicios públicos

Mojo	Descripción
clean	Limpiar archivos y directorios temporales

Opciones de configuración

Relevante para cada mojo

Opción	Descripción	Por defecto
logging	Nivel de registro (valores en java.util.logging.Level )	INFO
useSpringExtension	Analizar dependencias inducidas por la primavera	false
useGuiceExtension	Analizar dependencias inducidas por Guice	false
useCDIExtension	Analizar dependencias inducidas por CDI	false

Relevante para los mojos seleccionados

Opción	Descripción	Por defecto
standalone	Ejecutar en modo independiente: si no está presente, Dirts espera que otra herramienta RTS ya haya excluido algunas pruebas en excludesFile	false
overrideExtension	En combinación con standalone=false , BORTS Like Tool se ejecuta independiente, pero solo excluye las pruebas afectadas por cambios relacionados con DI	false

Relevante para gráficos mojos

Opción	Descripción	Por defecto
toFile	Almacene la representación de gráficos en el sistema de archivos en lugar de imprimirlo en stdout	false
outputFile	El nombre del archivo, donde se almacena el gráfico si toFile se establece en True	[class|method]_level

Casos de uso

Autónomo

Las sucias se pueden usar completamente independientes para RTS especificando standalone=true .

Como una extensión de otra herramienta RTS

Las DIRT también se pueden usar para ejecutarse después de otra herramienta RTS y solo corregir las pruebas afectadas por cambios relacionados con DI. Se requiere la otra herramienta para excluir las pruebas en el archivo especificado por la propiedad excludesFile de SureFire. DIRTS debe ejecutarse después de la otra herramienta RTS y luego comentará las pruebas afectadas por cambios relacionados con DI, pero se han excluido antes. Este es el comportamiento predeterminado de las sucias.

Ejemplos de uso

Las dirtas están construidas para ser utilizadas con Maven Surefire. La forma más sencilla de usar DIRTS en un proyecto Maven es a través del complemento Maven Dirts:

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

Requisitos previos

1. excludesFile -Property de Surfire debe establecerse, idealmente para cada submódulo por separado. De lo contrario, la exclusión de la prueba no funcionará.
2. El análisis para el DI-FrameWorks deseado debe habilitarse, estableciendo la propiedad respectiva (por ejemplo, useSpringExtension ) en true .

Compilar, seleccionar y probar de una vez

Aunque DIRTS analiza el código fuente simple, en el caso de ciertas dependencias entre módulos, puede ser necesario compilar antes de ejecutar el procedimiento de selección.

$ mvn compile dirts:class_level_select test

Seleccione, luego compile y pruebe solo aquellos módulos que tienen al menos una prueba seleccionada

Dirts crea una lista de estos módulos en .dirts/affected_modules dentro de la carpeta del módulo más externo.

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

Combinado con git - selección de pruebas antes de fusionar

1. Vea la rama principal.
2. Ejecute la selección para crear suma de verificación y gráfico, si estos archivos aún no existen. Por ejemplo: $ mvn dirts:class_level_select
3. Vea la rama de la función.
4. Ejecutar selección y pruebas.

• Para la ejecución combinada de compilación, selección y prueba: $ mvn compile dirts:class_level_select test
• Para compilar y probar módulos afectados:

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

Configuración

Para construir Dirts simplemente ejecutar:

$ mvn clean install

Esto construirá el código para todos los módulos, ejecutará todas las pruebas e instalará los frascos en su repositorio Maven local.