dirts

DIRTS (การเลือกการทดสอบการถดถอยของการฉีดยาขึ้นพึ่งพา)

DIRTS เป็นเครื่องมือวิจัยการเลือกการทดสอบการถดถอยแบบชั้นเรียนแบบสแตติกระดับ (RTS) ที่ตระหนักถึงกลไกการฉีดพึ่งพา (DI)

ข้อกำหนดเบื้องต้น

• jdk> = 11
• Maven Surefire> = 2.14 (แม้ว่าจะแนะนำ> = 3.0.0-M5)
• Junit รุ่นใดก็ได้

เป้าหมาย Maven

เลือก mojos

โมโจ	คำอธิบาย
class_level_select	เลือกการทดสอบโดยใช้วิธีการระดับคลาส
method_level_select	เลือกการทดสอบโดยใช้วิธีการระดับวิธี

กราฟ Mojos

โมโจ	คำอธิบาย
class_level_graph	แสดงกราฟที่สร้างโดยวิธีการระดับคลาส
method_level_graph	แสดงกราฟที่สร้างโดยวิธีการระดับวิธี

ยูทิลิตี้ Mojos

โมโจ	คำอธิบาย
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

เกี่ยวข้องกับกราฟ mojos

ตัวเลือก	คำอธิบาย	ค่าเริ่มต้น
toFile	จัดเก็บการแสดงกราฟบนระบบไฟล์แทนการพิมพ์ไปยัง stdout	false
outputFile	ชื่อของไฟล์ที่จัดเก็บกราฟหากตั้งค่า toFile เป็น TRUE	[class|method]_level

ใช้เคส

แบบสแตนด์อโลน

DIRTs สามารถใช้แบบสแตนด์อโลนได้อย่างสมบูรณ์สำหรับ RTS โดยการระบุ standalone=true

เป็นส่วนขยายไปยังเครื่องมือ RTS อื่น

DIRTS ยังสามารถใช้ในการทำงานหลังจากเครื่องมือ RTS อื่นและถูกต้องสำหรับการทดสอบที่ได้รับผลกระทบจากการเปลี่ยนแปลงที่เกี่ยวข้องกับ DI เครื่องมืออื่น ๆ จำเป็นต้องยกเว้นการทดสอบในไฟล์ที่ระบุโดยคุณสมบัติ excludesFile ของ SureFire DIRTS จำเป็นต้องทำงานหลังจากเครื่องมือ RTS อื่น ๆ และจากนั้นจะแสดงความคิดเห็นการทดสอบที่ได้รับผลกระทบจากการเปลี่ยนแปลงที่เกี่ยวข้องกับ DI แต่ได้รับการยกเว้นก่อนหน้านี้ นี่คือพฤติกรรมเริ่มต้นของ dirts

ตัวอย่างการใช้งาน

Dirts ถูกสร้างขึ้นเพื่อใช้กับ Maven Surefire วิธีที่ง่ายที่สุดในการใช้ Dirts ในโครงการ Maven คือผ่านปลั๊กอิน Dirts Maven:

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

ข้อกำหนดเบื้องต้น

1. ต้องมีการตั้งค่า excludesFile Surefire -พร็อพเพอร์ตี้ของ Surefire มิฉะนั้นการยกเว้นการทดสอบจะไม่ทำงาน
2. ควรเปิดใช้งานการวิเคราะห์สำหรับ di-frameworks ที่ต้องการโดยการตั้งค่าคุณสมบัติที่เกี่ยวข้อง (เช่น useSpringExtension ) เป็น true

รวบรวมเลือกและทดสอบในครั้งเดียว

แม้ว่า DIRTS จะวิเคราะห์ซอร์สโค้ดธรรมดา แต่ในกรณีที่มีการพึ่งพาระหว่างโมดูลบางอย่างก็อาจจำเป็นต้องรวบรวมก่อนที่จะดำเนินการตามขั้นตอนการเลือก

$ mvn compile dirts:class_level_select test

เลือกจากนั้นรวบรวมและทดสอบเฉพาะโมดูลที่มีการทดสอบอย่างน้อยหนึ่งรายการ

DIRTS สร้างรายการของโมดูลเหล่านี้ใน .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 

การตั้งค่า

เพื่อสร้าง dirts เพียงแค่วิ่ง:

$ mvn clean install

สิ่งนี้จะสร้างรหัสสำหรับโมดูลทั้งหมดเรียกใช้การทดสอบทั้งหมดและติดตั้งขวดไปยังที่เก็บ Maven ในพื้นที่ของคุณ