dirts

汚れ（依存関係噴射意識回帰テストの選択）

DIRTSは、依存関係注入（DI）メカニズムを認識している静的クラスまたはメソッドレベルの回帰テスト選択（RTS）研究ツールです。

前提条件

• JDK> = 11
• Maven SureFire> = 2.14（推奨> = 3.0.0-M5）
• Junitの任意のバージョン

メイブンの目標

Mojosを選択します

モジョ	説明
class_level_select	クラスレベルのアプローチを使用してテストを選択します
method_level_select	メソッドレベルのアプローチを使用してテストを選択します

グラフモホス

モジョ	説明
class_level_graph	クラスレベルのアプローチによって作成されたグラフを表示します
method_level_graph	メソッドレベルのアプローチによって作成されたグラフを表示します

ユーティリティモホス

モジョ	説明
clean	一時的なファイルとディレクトリをクリーンアップします

構成オプション

すべてのモジョに関連する

オプション	説明	デフォルト
logging	ロギングレベル（ java.util.logging.Levelの値）	INFO
useSpringExtension	春までに誘導される依存関係を分析します	false
useGuiceExtension	Guiceによって誘導される依存関係を分析します	false
useCDIExtension	CDIによって引き起こされる依存関係を分析します	false

選択されたMojosに関連します

オプション	説明	デフォルト
standalone	スタンドアロンモードで実行 - 存在しない場合、Dirtsは、別のRTS -Toolが既にexcludesFileでいくつかのテストを除外していることを期待しています	false
overrideExtension	standalone=falseと組み合わせて、動作のように動作するツールはスタンドアロンを実行していますが、DI関連の変更の影響を受けるテストのみを除外します	false

グラフモホスに関連しています

オプション	説明	デフォルト
toFile	ファイルシステムにグラフ表現をstdoutに印刷する代わりに保存します	false
outputFile	ファイルの名前。ここで、グラフがtoFileがtrueに設定されている場合に保存されます	[class|method]_level

ユースケース

スタンドアロン

汚れはstandalone=trueを指定することにより、RTSに完全にスタンドアロンを使用できます。

別のRTSツールへの拡張として

汚れは、別のRTSツールを追跡するためにも使用でき、DI関連の変更の影響を受けるテストのみを修正することもできます。他のツールは、SureFireのexcludesFileプロパティによって指定されたファイル内のテストを除外する必要があります。汚れは他のRTSツールを追跡する必要があり、その後、DI関連の変更の影響を受けるが、以前に除外されたテストをコメントします。これは、汚れのデフォルトの動作です。

使用例

汚れは、Maven Surefireで使用されるように構築されています。 Mavenプロジェクトで汚れを使用する最も簡単な方法は、Dirts 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フレームワークの分析を有効にする必要があります。

コンパイル、選択、テストで一度にテストします

Dirtsはプレーンソースコードを分析しますが、特定のモジュール間依存性の場合、選択手順を実行する前にコンパイルする必要がある場合があります。

$ mvn compile dirts:class_level_select test

選択してから、少なくとも1つのテストを選択したモジュールのみを選択してテストします

Dirtsは、最も外側のモジュールのフォルダー内にある.dirts/affected_modulesにこれらのモジュールのリストを作成します。

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

gitと組み合わせて - マージする前のテスト選択

1. メインブランチをチェックアウトします。
2. 選択を実行して、これらのファイルがまだ存在しない場合は、チェックサムとグラフを作成します。 EG： $ 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リポジトリにJARをインストールします。