kcov - ออนไลน์ในคลาวด์

โครงการ:

ชื่อ

kcov - การวิเคราะห์ความครอบคลุมโค้ดสำหรับโปรแกรมที่คอมไพล์และสคริปต์ Python

เรื่องย่อ

กิโลวัตต์ [ตัวเลือก] คนนอก ปฏิบัติการ [ args for ปฏิบัติการ ]

DESCRIPTION

หน้าคู่มือนี้จัดทำเอกสารโดยสังเขปเกี่ยวกับ กิโลวัตต์ คำสั่ง กิโลวัตต์ เป็นผู้ทดสอบความครอบคลุมรหัสสำหรับ
ไบนารีของ ELF, สคริปต์ Python และเชลล์สคริปต์ อนุญาตให้รวบรวมรหัสครอบคลุม
ข้อมูลจาก executables ที่ไม่มีคำสั่งคอมไพเลอร์พิเศษและต่อเนื่อง
ให้ผลผลิตจากแอพพลิเคชั่นที่ใช้เวลานาน

OPTIONS

-p, --ปิด=PID
ติดตาม PID แทนการเรียกทำงาน เรียกใช้งานได้เป็นทางเลือกในกรณีนี้

-l, --ขีดจำกัด=สูงต่ำ
ขีดจำกัดการตั้งค่าสำหรับการครอบคลุมต่ำ/สูง (ค่าเริ่มต้น: 16,50)

--include-เส้นทาง=P1[,ป2... ]
รายการพาธที่คั่นด้วยเครื่องหมายจุลภาคที่จะรวมไว้ในรายงาน

--exclude-เส้นทาง=P1[,ป2... ]
รายการพาธที่คั่นด้วยเครื่องหมายจุลภาคที่จะแยกออกจากรายงาน

--include-รูปแบบ=P1[,ป2... ]
รายการรูปแบบเส้นทางที่คั่นด้วยเครื่องหมายจุลภาคที่จะรวมไว้ในรายงาน

--exclude-รูปแบบ=P1[,ป2... ]
รายการรูปแบบเส้นทางที่คั่นด้วยเครื่องหมายจุลภาคที่จะแยกออกจากรายงาน

--สะสมเท่านั้น
รวบรวมข้อมูลความครอบคลุมเท่านั้น อย่าสร้างเอาต์พุต HTML/Cobertura

--รายงานเท่านั้น
รายงานเฉพาะเอาต์พุต HTML/Cobertura อย่ารวบรวมข้อมูล

--coveralls-id=id
อัปโหลดข้อมูลไปยัง coveralls.io โดยใช้ secret repo_token หรือ Travis CI service job ID id.
รหัสจะถูกใช้เป็น repo_token หากยาวกว่าหรือเท่ากับ 32 อักขระ

เรื่องผิดปกติ OPTIONS

--เส้นทางแถบระดับ=N
จำนวนระดับพาธที่จะแสดงสำหรับพาธทั่วไป (ค่าเริ่มต้น: 2)

--ข้าม-solibs
ข้ามคอลเลคชันความครอบคลุมสำหรับไลบรารีที่แชร์ (ปรับปรุงประสิทธิภาพ)

--ทางออกแรก-กระบวนการ
ออกเมื่อกระบวนการแรกออก กล่าวคือ ให้เกียรติพฤติกรรมของภูต ค่าเริ่มต้น
พฤติกรรมคือการกลับไปที่คอนโซลเมื่อออกจากกระบวนการสุดท้าย

--หลาม-parser=พาร์เซอร์
ตั้งค่า python parser เพื่อใช้กับโปรแกรม Python (ค่าดีฟอลต์คือ python) เป็นไปได้
ใช้เพื่อรันด้วย Python 3 บนระบบที่ Python 2 เป็นค่าเริ่มต้น

--ทุบตี parser=พาร์เซอร์
ตั้งค่า bash parser เพื่อใช้สำหรับเชลล์สคริปต์ (ค่าเริ่มต้นคือ / bin / bash).

--replace-src-เส้นทาง=P1:P2
แทนที่พาธไฟล์ต้นทาง P1 ด้วย P2 หากพบ

ตัวอย่าง

ตรวจสอบความครอบคลุมสำหรับ ./frodo และสร้างเอาต์พุต HTML ใน /tmp/kcov และเอาต์พุต cobertura ใน
/tmp/kcov/โฟรโด/cobertura.xml

kcov /tmp/kcov ./โฟรโด

ตรวจสอบความครอบคลุมสำหรับ ./frodo แต่รวมเฉพาะชื่อไฟล์ต้นฉบับที่มีสตริง src/frodo

kcov --include-pattern=src/frodo /tmp/kcov ./frodo

เหมือนข้างบนแต่แยกการรวบรวมและการรายงาน (อาจบนคอมพิวเตอร์สองเครื่องที่แตกต่างกัน)

kcov --collect-only /tmp/kcov ./frodo

kcov -- รายงานเท่านั้น -- รวมรูปแบบ = src/frodo /tmp/kcov ./frodo

HTML เอาท์พุท

เอาต์พุต HTML แสดงบรรทัดของซอร์สโค้ดที่ดำเนินการแล้วและไม่ได้ดำเนินการ บางบรรทัดสามารถ
แมปไปยังจุดเครื่องมือวัดหลายจุด ตัวอย่างเช่น สำหรับฟังก์ชันแบบอินไลน์ (โดยที่ every
การฝังในของพวกมันจะสร้างจุดเครื่องมือแยกจากกัน) นี้แสดงให้เห็นใน
คอลัมน์ด้านซ้ายเช่น 1/3 ซึ่งหมายความว่าหนึ่งในสามจุดเครื่องมือ
ถูกประหารชีวิต

ลิงค์เอาท์พุตพิเศษคือ [ผสาน] ซึ่งแสดงให้เห็นการรวมของโปรแกรมที่ครอบคลุมทั้งหมด นี้
อาจมีประโยชน์ เช่น เมื่อคุณมีการทดสอบหน่วยในหลายไบนารีซึ่งใช้ a
ชุดย่อยของไฟล์ต้นทาง

โคเบอร์ตูรา เอาท์พุท

Kcov ยังแสดงข้อมูลในรูปแบบ Cobertura XML ซึ่งช่วยให้สามารถรวมเอาท์พุต kcov ได้
ในเจนกินส์ (ดู http://cobertura.sf.net และ http://jenkins-ci.org).

เอาต์พุต Cobertura อยู่ในไฟล์ชื่อ out-path/exec-filename/cobertura.xml

ใช้ kcov ออนไลน์โดยใช้บริการ onworks.net