dirts

Kotoran (Pemilihan Uji Regresi Sadar Injeksi Ketergantungan)

Dirts adalah alat penelitian Tes Regresi (RTS) statis kelas atau metode yang menyadari mekanisme injeksi ketergantungan (DI).

Prasyarat

• JDK> = 11
• Maven Surefire> = 2.14 (meskipun direkomendasikan> = 3.0.0-m5)
• versi JUnit apa pun

Tujuan Maven

Pilih Mojos

Mojo	Keterangan
class_level_select	Pilih tes menggunakan pendekatan tingkat kelas
method_level_select	Pilih tes menggunakan pendekatan level metode

Grafik mojos

Mojo	Keterangan
class_level_graph	Tampilkan grafik yang dibuat oleh pendekatan tingkat kelas
method_level_graph	Tampilkan grafik yang dibuat oleh pendekatan tingkat metode

Utilitas Mojos

Mojo	Keterangan
clean	Bersihkan file dan direktori sementara

Opsi Konfigurasi

Relevan untuk setiap mojo

Pilihan	Keterangan	Bawaan
logging	Level Logging (Nilai di java.util.logging.Level )	INFO
useSpringExtension	Menganalisis dependensi yang disebabkan oleh pegas	false
useGuiceExtension	Menganalisis dependensi yang disebabkan oleh guice	false
useCDIExtension	Menganalisis dependensi yang disebabkan oleh CDI	false

Relevan untuk mojos pilih

Pilihan	Keterangan	Bawaan
standalone	Jalankan dalam mode mandiri - jika tidak ada, kotoran mengharapkan bahwa alat RTS lain telah mengecualikan beberapa tes di excludesFile	false
overrideExtension	Dalam kombinasi dengan standalone=false , behave like tool berjalan mandiri tetapi hanya mengecualikan tes yang dipengaruhi oleh perubahan terkait DI	false

Relevan untuk grafik mojos

Pilihan	Keterangan	Bawaan
toFile	Simpan representasi grafik pada sistem file alih -alih mencetaknya ke stdout	false
outputFile	Nama file, di mana grafik disimpan jika toFile diatur ke true	[class|method]_level

Menggunakan kasus

Mandiri

Kotoran dapat digunakan sepenuhnya mandiri untuk RT dengan menentukan standalone=true .

Sebagai ekstensi ke alat RTS lain

Kotoran juga dapat digunakan untuk berjalan setelah alat RTS lain dan hanya benar untuk tes yang dipengaruhi oleh perubahan terkait di. Alat lain diperlukan untuk mengecualikan tes dalam file yang ditentukan oleh properti Surefire excludesFile . Kotoran perlu berjalan setelah alat RTS lainnya dan kemudian akan mengomentari tes yang dipengaruhi oleh perubahan terkait DI, tetapi telah dikecualikan sebelumnya. Ini adalah perilaku default kotoran.

Contoh penggunaan

Kotoran dibangun untuk digunakan dengan Maven Surefire. Cara paling sederhana untuk menggunakan kotoran dalam proyek Maven adalah melalui Dirts Maven Plugin:

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

Prasyarat

1. SureFire's excludesFile -Property perlu ditetapkan, idealnya untuk setiap submodule secara terpisah. Kalau tidak, uji pengecualian tidak akan berfungsi.
2. Analisis untuk di-Frameworks yang diinginkan harus diaktifkan, dengan mengatur properti masing-masing (misalnya useSpringExtension ) ke true .

Kompilasi, pilih dan uji dalam sekali jalan

Meskipun Dirts menganalisis kode sumber sederhana, dalam hal dependensi antar-modul tertentu, mungkin diperlukan untuk menyusun sebelum menjalankan prosedur seleksi.

$ mvn compile dirts:class_level_select test

Pilih, lalu kompilasi dan uji hanya modul -modul yang memiliki setidaknya satu tes yang dipilih

Dirt membuat daftar modul ini di .dirts/affected_modules di dalam folder modul terluar.

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

Dikombinasikan dengan git - pemilihan uji sebelum penggabungan

1. Periksa cabang utama.
2. Jalankan pilihan untuk membuat checksum dan grafik, jika file -file ini belum ada. Misalnya: $ mvn dirts:class_level_select
3. Lihat cabang fitur.
4. Jalankan seleksi dan tes.

• Untuk kompilasi gabungan, seleksi dan eksekusi uji: $ mvn compile dirts:class_level_select test
• Untuk hanya menyusun dan menguji modul yang terpengaruh:

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

Pengaturan

Untuk membangun kotoran, cukup jalankan:

$ mvn clean install

Ini akan membangun kode untuk semua modul, menjalankan semua tes, dan memasang stoples ke repositori Maven lokal Anda.