dirts

污垢（依赖注入意识回归测试选择）

污垢是一种静态类或方法级回归测试选择（RTS）研究工具，它意识到依赖注入（DI）机制。

先决条件

• JDK> = 11
• maven surefire> = 2.14（尽管建议> = 3.0.0-m5）
• 任何版本的junit

Maven目标

选择Mojos

Mojo	描述
class_level_select	使用类级方法选择测试
method_level_select	使用方法级方法选择测试

图莫霍斯

Mojo	描述
class_level_graph	通过类级方法创建的显示图
method_level_graph	通过方法级方法创建的显示图

公用事业莫霍斯

Mojo	描述
clean	清理临时文件和目录

配置选项

与每个Mojo相关

选项	描述	默认
logging	记录级别（ java.util.logging.Level中的值）	INFO
useSpringExtension	分析春季诱导的依赖性	false
useGuiceExtension	分析GUICE诱导的依赖性	false
useCDIExtension	分析CDI诱导的依赖性	false

与选择的莫霍斯有关

选项	描述	默认
standalone	在独立模式下运行 - 如果不存在，则污垢预计另一个RTS工具已经排除了excludesFile中的一些测试	false
overrideExtension	结合standalone=false ，表现得像工具是独立运行的，但仅排除受DI相关更改影响的测试	false

与图形莫霍斯相关

选项	描述	默认
toFile	将图形表示形式存储在文件系统上，而不是将其打印到stdout	false
outputFile	文件的名称，如果将toFile设置为true，则存储图形的名称	[class|method]_level

用例

独立

通过指定standalone=true ，可以完全独立用于RT。

作为另一个RTS工具的扩展

污垢也可用于在另一个RTS工具之后运行，并且仅适用于受DI相关更改影响的测试。需要另一个工具以在Surefire的excludesFile属性指定的文件中排除测试。污垢需要追随其他RTS工具，然后评论那些受DI相关更改影响但以前被排除的测试。这是污垢的默认行为。

用法示例

污垢是与Maven Surefire一起使用的。在Maven项目中使用污垢的最简单方法是通过污垢Maven插件：

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

先决条件

1. Surefire的excludesFile -property需要设置，理想情况下，分别针对每个子模块。否则，测试排除将不起作用。
2. 应通过将各个属性（例如useSpringExtension ）设置为true来启用所需的Di-FrameWorks的分析。

一口气编译，选择和测试

即使污垢分析了普通源代码，但如果某些模块间依赖关系，则可能需要在执行选择过程之前进行编译。

$ mvn compile dirts:class_level_select test

选择，然后编译并仅测试那些至少选择一个测试的模块

污垢在最.dirts/affected_modules模块的文件夹中创建了这些模块的列表。

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

合并之前与GIT - 测试选择结合

1. 结帐主分支。
2. 如果这些文件尚不存在，则运行选择以创建校验和图形。例如： $ mvn dirts:class_level_select
3. 结帐功能分支。
4. 运行选择和测试。

• 用于组合编译，选择和测试执行： $ mvn compile dirts:class_level_select test
• 仅编译和测试受影响的模块：

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

设置

要建造污垢，只需运行：

$ mvn clean install

这将构建所有模块的代码，运行所有测试，然后将罐子安装到您本地的Maven存储库中。