พิสูจน์ - ออนไลน์ใน Cloud

โครงการ:

ชื่อ

พิสูจน์ - ทำการทดสอบผ่านสายรัด TAP

การใช้

พิสูจน์ [ตัวเลือก] [ไฟล์หรือไดเรกทอรี]

OPTIONS

ตัวเลือกบูลีน:

-v, --verbose พิมพ์บรรทัดทดสอบทั้งหมด
-l, --lib เพิ่ม 'lib' ไปยังเส้นทางสำหรับการทดสอบของคุณ (-Ilib)
-b, --blib เพิ่ม 'blib/lib' และ 'blib/arch' ไปยังเส้นทางสำหรับ
แบบทดสอบของคุณ
-s, --shuffle ทำการทดสอบแบบสุ่ม
-c, --color เอาต์พุตการทดสอบสี (ค่าเริ่มต้น)
--nocolor อย่าส่งออกการทดสอบสี
--count แสดงจำนวนการทดสอบ X/Y เมื่อไม่ใช้ verbose
(เริ่มต้น)
--nocount ปิดใช้งานจำนวนการทดสอบ X/Y
-D --dry วิ่งแบบแห้ง แสดงการทดสอบที่จะเรียกใช้
-f, --failures แสดงการทดสอบที่ล้มเหลว
-o, --comments แสดงความเห็น
--ignore-exit ละเว้นสถานะการออกจากสคริปต์ทดสอบ
-m, --merge รวมสคริปต์ทดสอบของ STDERR กับ STDOUT
-r, --recurse ลงซ้ำในไดเร็กทอรี
--reverse เรียกใช้การทดสอบในลำดับที่กลับกัน
-q, --quiet ระงับเอาต์พุตการทดสอบบางส่วนขณะรันการทดสอบ
-Q, --QUIET พิมพ์เฉพาะผลลัพธ์สรุป
-p, --parse แสดงรายการข้อผิดพลาดในการแยกวิเคราะห์ TAP ทั้งหมด หากมี
--directives แสดงผลด้วยคำสั่ง TODO หรือ SKIP เท่านั้น
--timer พิมพ์เวลาที่ผ่านไปหลังจากการทดสอบแต่ละครั้ง
--trap Trap Ctrl-C และพิมพ์สรุปการขัดจังหวะ
--normalize Normalize เอาท์พุท TAP ใน verbose output
-T เปิดใช้งานการตรวจสอบมลทิน
-t เปิดใช้งานคำเตือนการทำให้เสีย
-W เปิดใช้งานการเตือนที่ร้ายแรง
-w เปิดใช้งานคำเตือน
-h, --help แสดงความช่วยเหลือนี้
-?, แสดงความช่วยเหลือนี้
-V, --version แสดงเวอร์ชัน
-H, --man อีกต่อไป manpage สำหรับพิสูจน์
--norc อย่าประมวลผลค่าเริ่มต้น .proverc

ตัวเลือกที่ใช้อาร์กิวเมนต์:

-I ห้องสมุดเส้นทางที่จะรวม
-P Load plugin (ค้นหา App::Prove::Plugin::*.)
-M โหลดโมดูล
-e, --exec Interpreter เพื่อรันการทดสอบ ('' สำหรับคอมไพล์
การทดสอบ)
--ext ตั้งค่าส่วนขยายสำหรับการทดสอบ (ค่าเริ่มต้น '.t')
--harness กำหนดสายรัดทดสอบที่จะใช้ ดู TAP::สายรัด.
--formatter ตัวจัดรูปแบบผลลัพธ์ที่จะใช้ ดูรูปแบบ
--source Load และ/หรือกำหนดค่า SourceHandler ดู
ตัวจัดการแหล่งที่มา
-a, --archive out.tgz เก็บ TAP ที่ได้ไว้ในไฟล์เก็บถาวร
-j, --jobs N รัน N งานทดสอบแบบขนาน (ลอง 9)
--state=opts ควบคุมพิสูจน์สถานะคงอยู่
--rc=rcfile ตัวเลือกกระบวนการจาก rcfile
--rules กฎสำหรับการประมวลผลแบบขนานและแบบต่อเนื่อง

หมายเหตุ

.proverc
If ~/.proverc or ./.proverc ที่มีอยู่ พวกเขาจะถูกอ่านและตัวเลือกใด ๆ ที่มีการประมวลผล
ก่อนตัวเลือกบรรทัดคำสั่ง ตัวเลือกใน .proverc ระบุไว้ในลักษณะเดียวกับ
ตัวเลือกบรรทัดคำสั่ง:

# .โปรเวิร์ก
--state=ร้อนเร็วประหยัด
-j9

ไฟล์ตัวเลือกเพิ่มเติมสามารถระบุได้ด้วยตัวเลือก "--rc" ไฟล์ตัวเลือกเริ่มต้น
การประมวลผลถูกปิดใช้งานโดยตัวเลือก "--norc"

ภายใต้ Windows และ VMS ไฟล์ตัวเลือกมีชื่อว่า _โปรวร์ก มากกว่า .proverc และถูกแสวงหา
เฉพาะในไดเร็กทอรีปัจจุบัน

การอ่าน จาก "STDIN"
หากคุณมีรายการการทดสอบ (หรือ URL หรือสิ่งอื่นที่คุณต้องการทดสอบ) ในไฟล์ คุณ
สามารถเพิ่มลงในการทดสอบของคุณโดยใช้ '-':

พิสูจน์ - < my_list_of_things_to_test.txt

ดู "README" ในไดเร็กทอรี "ตัวอย่าง" ของการแจกจ่ายนี้

ค่าเริ่มต้น เอกสาร ค้นหาสถานที่
หากไม่มีไฟล์หรือไดเร็กทอรีให้มา "พิสูจน์" จะค้นหาไฟล์ทั้งหมดที่ตรงกับรูปแบบ
"t/*.t".

สี เอกสาร เอาท์พุต
เอาต์พุตการทดสอบสีโดยใช้ TAP::Formatter::Color เป็นค่าเริ่มต้น แต่ถ้าเอาต์พุตไม่ใช่ a
เทอร์มินัล สีถูกปิดใช้งาน คุณสามารถแทนที่ได้โดยเพิ่มสวิตช์ "--color"

การสนับสนุนสีต้องใช้ Term::ANSIColor บนแพลตฟอร์มที่เหมือน Unix และ Win32::Console on
หน้าต่าง หากไม่ได้ติดตั้งโมดูลที่จำเป็น เอาต์พุตสีจะไม่สามารถใช้ได้

ทางออก รหัส
หากการทดสอบล้มเหลว "พิสูจน์" จะปิดด้วยสถานะที่ไม่ใช่ศูนย์

ข้อโต้แย้ง ไปยัง การทดสอบ
เป็นไปได้ที่จะจัดหาอาร์กิวเมนต์ให้กับการทดสอบ ให้แยกพวกเขาออกจากการพิสูจน์ของตัวเอง
อาร์กิวเมนต์กับอริสดอตเติล '::' ตัวอย่างเช่น

พิสูจน์ -vt/mytest.t :: --url http://example.com

จะวิ่ง t/mytest.t ด้วยตัวเลือก '--url http://example.com'. เมื่อรันหลายตัว
การทดสอบแต่ละคนจะได้รับอาร์กิวเมนต์เดียวกัน

"--ผู้บริหาร"
โดยปกติคุณสามารถผ่านรายการการทดสอบ Perl และสายรัดจะรู้วิธีดำเนินการ
พวกเขา. อย่างไรก็ตาม หากการทดสอบของคุณไม่ได้เขียนด้วยภาษา Perl หรือหากคุณต้องการเรียกใช้การทดสอบทั้งหมด
วิธีเดียวกันทุกประการ ใช้สวิตช์ "-e" หรือ "--exec":

พิสูจน์ --exec '/usr/bin/รูบี้ -w't/
พิสูจน์ --exec '/usr/bin/perl -Tw -mstrict -Ilib' t/
พิสูจน์ --exec '/path/to/my/customer/exec'

"--ผสาน"
หากคุณต้องการตรวจสอบให้แน่ใจว่าการวินิจฉัยของคุณแสดงตามลำดับที่ถูกต้องสัมพันธ์กับ
ผลการทดสอบ คุณสามารถใช้ตัวเลือก "--merge" เพื่อรวม STDERR ของสคริปต์ทดสอบเข้ากับ
STDOUT.

สิ่งนี้รับประกันได้ว่า STDOUT (ซึ่งผลการทดสอบปรากฏ) และ STDERR (โดยที่
การวินิจฉัยจะปรากฏขึ้น) จะยังคงซิงค์ สายรัดจะแสดงการวินิจฉัยการทดสอบของคุณ
ปล่อยบน STDERR

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

"--กับดัก"
ตัวเลือก "--trap" จะพยายามดักจับ SIGINT (Ctrl-C) ระหว่างการทดสอบรันและแสดง
สรุปการทดสอบแม้ว่าการวิ่งจะถูกขัดจังหวะ

"--สถานะ"
คุณสามารถขอให้ "พิสูจน์" เพื่อจำสถานะของการทดสอบครั้งก่อนและเลือกและ/หรือสั่งซื้อ
การทดสอบที่จะดำเนินการตามสถานะที่บันทึกไว้

สวิตช์ "--state" ต้องการอาร์กิวเมนต์ซึ่งต้องเป็นรายการที่คั่นด้วยเครื่องหมายจุลภาคของหนึ่งหรือ
ตัวเลือกเพิ่มเติมต่อไปนี้

"ล่าสุด"
เรียกใช้การทดสอบเดียวกันกับครั้งล่าสุดที่มีการบันทึกสถานะ สิ่งนี้ทำให้เป็นไปได้สำหรับ
ตัวอย่าง เพื่อสร้างลำดับการทดสอบแบบสับเปลี่ยน

# ทำการทดสอบทั้งหมดแบบสุ่ม
$ พิสูจน์ -b --state=save --shuffle

#เรียกใช้อีกครั้งในลำดับเดิม
$ พิสูจน์ -b --state=last

"ล้มเหลว"
รันเฉพาะการทดสอบที่ล้มเหลวในการรันครั้งล่าสุด

# ทำการทดสอบทั้งหมด
$ พิสูจน์ -b --state=save

#วิ่งล้มเหลว
$ พิสูจน์ -b --state=ล้มเหลว

หากคุณระบุตัวเลือก "บันทึก" ด้วย การทดสอบที่ผ่านใหม่จะถูกยกเว้นจาก
วิ่งต่อไป.

#ย้ำจนไม่มีล้ม
$ พิสูจน์ -b --state=ล้มเหลว, บันทึก

"ผ่านไป"
เรียกใช้เฉพาะการทดสอบที่ผ่านจากครั้งที่แล้ว มีประโยชน์เพื่อให้แน่ใจว่าไม่มีปัญหาใหม่
ได้รับการแนะนำ

"ทั้งหมด"
ทำการทดสอบทั้งหมดตามลำดับปกติ อาจมีการระบุตัวเลือกหลายตัว เพื่อเรียกใช้การทดสอบทั้งหมด
กับความล้มเหลวจากครั้งที่แล้วครั้งแรก:

$ พิสูจน์ -b --state=ล้มเหลว ทั้งหมด บันทึก

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

$ พิสูจน์ -b --state = ร้อนบันทึก

การทดสอบที่ไม่เคยล้มเหลวจะไม่ถูกเลือก เพื่อเรียกใช้การทดสอบทั้งหมดที่มีมากที่สุด
เพิ่งใช้งานครั้งแรกล้มเหลว

$ พิสูจน์ -b --state=hot,all,save

การรวมกันของตัวเลือกนี้อาจระบุได้เช่นกัน

$ พิสูจน์ -b --state=adrian

"ทำ"
ทำการทดสอบด้วย todos

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

$ พิสูจน์ -b --state=ช้า -j9

"เร็ว"
เรียกใช้การทดสอบการทดสอบในลำดับที่เร็วที่สุดไปช้าที่สุด

"ใหม่"
เรียกใช้การทดสอบในลำดับที่ใหม่ที่สุดไปเก่าที่สุดตามเวลาที่แก้ไขของการทดสอบ
สคริปต์

"เก่า"
เรียกใช้การทดสอบในลำดับที่เก่าที่สุดไปหาใหม่ที่สุด

"สด"
เรียกใช้สคริปต์ทดสอบที่ได้รับการแก้ไขตั้งแต่การทดสอบครั้งล่าสุด

"บันทึก"
บันทึกสถานะเมื่อออก สถานะถูกเก็บไว้ในไฟล์ชื่อ .พิสูจน์ (_พิสูจน์ บน Windows
และ VMS) ในไดเร็กทอรีปัจจุบัน

อาจใช้สวิตช์ "--state" มากกว่าหนึ่งครั้ง

$ พิสูจน์ -b --state=hot --state=all,save

--กฎ
ตัวเลือก "--กฎ" ใช้เพื่อควบคุมว่าการทดสอบใดที่จะรันตามลำดับและการทดสอบใดที่จะรัน
ควบคู่กันไป หากระบุตัวเลือก "--งาน" ตัวเลือกอาจระบุได้หลายรายการ
ครั้งและลำดับมีความสำคัญ

การใช้งานจริงมากที่สุดมักจะระบุว่าการทดสอบบางอย่างไม่ "พร้อมใช้แบบขนาน"
เนื่องจากการกล่าวถึงไฟล์ที่มี --rules ไม่ได้ทำให้ไฟล์ถูกเลือกให้รันเป็นแบบทดสอบ คุณ
สามารถ "ตั้งค่าและลืม" ค่ากำหนดกฎบางอย่างในไฟล์ .proverc ของคุณได้ แล้วคุณจะสามารถ
ใช้ประโยชน์สูงสุดจากประโยชน์ด้านประสิทธิภาพของการทดสอบแบบคู่ขนาน ในขณะที่บางส่วน
ข้อยกเว้นยังคงทำงานแบบขนาน

--กฎ ตัวอย่าง

# การทดสอบทั้งหมดได้รับอนุญาตให้ทำงานแบบขนาน ยกเว้นการทดสอบที่ขึ้นต้นด้วย "p"
--rules='seq=t/p*.t' --rules='par=**'

# การทดสอบทั้งหมดต้องดำเนินการตามลำดับยกเว้นการทดสอบที่ขึ้นต้นด้วย "p" ซึ่งควรรันแบบขนาน
--rules='par=t/p*.t'

--กฎ ความละเอียด

· โดยค่าเริ่มต้น การทดสอบทั้งหมดมีสิทธิ์ที่จะรันพร้อมกัน ระบุใด ๆ ของคุณเอง
กฎจะลบสิ่งนี้

· "นัดแรกชนะ" กฎข้อแรกที่ตรงกับการทดสอบจะเป็นกฎที่ใช้บังคับ

· การทดสอบใดๆ ที่ไม่ตรงกับกฎจะถูกรันตามลำดับเมื่อสิ้นสุดการรัน

· การมีอยู่ของกฎไม่ได้หมายความถึงการเลือกการทดสอบ คุณยังต้องระบุ
การทดสอบการทำงาน

· การระบุกฎเพื่อให้การทดสอบทำงานแบบขนานไม่ได้ทำให้การทดสอบดำเนินการใน
ขนาน. คุณยังต้องระบุจำนวน "งาน" แบบคู่ขนานในวัตถุ Harness ของคุณ

--กฎ สไตล์โลก Belt hold การจับคู่

เราใช้การจับคู่รูปแบบสไตล์โกลบอลสำหรับ --rules นี่คือการสนับสนุน
รูปแบบ:

** คือจำนวนอักขระใดๆ รวมทั้ง / ภายในชื่อพาธ
* เป็นศูนย์หรือมากกว่าอักขระภายในชื่อไฟล์/ชื่อไดเร็กทอรี
? เป็นอักขระหนึ่งตัวในชื่อไฟล์/ชื่อไดเร็กทอรี
{foo,bar,baz} คือ foo, bar หรือ baz ใดๆ
\ เป็นอักขระหลีก

เพิ่มเติม สูง ข้อกำหนด สำหรับ ขนาน vs ลำดับ วิ่ง กฎระเบียบ

หากคุณต้องการการจัดการขั้นสูงของสิ่งที่ทำงานแบบคู่ขนานและแบบเรียงตามลำดับ โปรดดูที่
เอกสาร 'กฎ' ที่เกี่ยวข้องใน TAP::Harness และ TAP::Parser::Scheduler ถ้าอะไรคือ
เป็นไปได้โดยตรงผ่านการ "พิสูจน์" ไม่เพียงพอคุณสามารถเขียนสายรัดของคุณเองถึง
เข้าถึงคุณสมบัติเหล่านี้โดยตรง

@ไอเอ็นซี
พิสูจน์ แนะนำการแยกระหว่าง "ตัวเลือกที่ส่งผ่านไปยัง Perl ซึ่งทำงานพิสูจน์" และ
"ตัวเลือกส่งผ่านไปยัง Perl ซึ่งรันการทดสอบ"; ความแตกต่างนี้เกิดจากการออกแบบ ดังนั้น
perl ที่กำลังรันการทดสอบเริ่มต้นด้วย @INC เริ่มต้น ไดเรกทอรีห้องสมุดเพิ่มเติม
สามารถเพิ่มได้ผ่านตัวแปรสภาพแวดล้อม "PERL5LIB" ผ่าน -Ifoo ใน "PERL5OPT" หรือผ่านทาง
ตัวเลือก "-Ilib" เป็น พิสูจน์.

มลทิน โหมด
โดยปกติเมื่อโปรแกรม Perl ทำงานในโหมด taint เนื้อหาของ "PERL5LIB"
ตัวแปรสภาพแวดล้อมไม่ปรากฏใน @INC

เนื่องจากมักใช้ "PERL5LIB" ในระหว่างการทดสอบเพื่อเพิ่มไดเร็กทอรี build ให้กับ @INCprove
ส่งผ่านชื่อของไดเร็กทอรีใด ๆ ที่พบใน "PERL5LIB" เมื่อ -I สลับ ผลกระทบสุทธิของ
นี่คือการที่ "PERL5LIB" ได้รับเกียรติ แม้ว่าจะรันการพิสูจน์ในโหมด taint ก็ตาม

รูปแบบ

คุณสามารถโหลด TAP::Parser::Formatter:

พิสูจน์ --formatter MyFormatter

แหล่งที่มา แฮนด์เลอร์

คุณสามารถโหลด TAP::Parser::SourceHandlers แบบกำหนดเองเพื่อเปลี่ยนวิธีที่ parser ตีความได้
ในสิ่งที่สนใจ แหล่งที่มา ของแท็ป

พิสูจน์ --source MyHandler --source YetAnother t

หากคุณต้องการกำหนดค่าให้กับแหล่งที่มา คุณสามารถใช้:

พิสูจน์ --source MyCustom \
--source Perl --perl-option 'foo=bar baz' --perl-option avg=0.278 \
--ไฟล์แหล่งที่มา --นามสกุลไฟล์ตัวเลือก=.txt --นามสกุลไฟล์ตัวเลือก=.tmp t
-- แหล่งที่มา pgTAP --pgtap-option pset=format=html --pgtap-option pset=border=2

แต่ละตัวเลือก "--$source-option" ต้องระบุคู่คีย์/ค่าโดยคั่นด้วย "=" ถ้า
ตัวเลือกสามารถรับค่าได้หลายค่า เพียงแค่ระบุหลายๆ ค่า เช่น กับ "extensions="
ตัวอย่างข้างต้น หากตัวเลือกควรเป็นการอ้างอิงแฮช ให้ระบุค่าเป็นวินาที
คู่คั่นด้วย "=" เช่นเดียวกับในตัวอย่าง "pset=" ด้านบน (หลีกเลี่ยง "=" ด้วยแบ็กสแลช)

"--sources" ทั้งหมดรวมกันเป็นแฮช และส่งผ่านไปยัง "ใหม่" ใน "แหล่งที่มา" ของ TAP::Harness
พารามิเตอร์.

ดู TAP::Parser::IteratorFactory สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการส่งการกำหนดค่าไปยัง
ตัวจัดการแหล่งที่มา.

PLUGINS

ปลั๊กอินสามารถโหลดได้โดยใช้ "-Pเสียบเข้าไป" ไวยากรณ์ เช่น:

พิสูจน์ -PMyPlugin

สิ่งนี้จะค้นหาโมดูลชื่อ "App::Prove::Plugin::MyPlugin" หรือล้มเหลว
"ปลั๊กอินของฉัน" หากไม่พบปลั๊กอิน "พิสูจน์" จะบ่นและออก

คุณสามารถส่งอาร์กิวเมนต์ไปยังปลั๊กอินของคุณโดยผนวก "=arg1,arg2,etc" ต่อท้ายชื่อปลั๊กอิน:

พิสูจน์ -PMyPlugin=fou,du,fafa

โปรดตรวจสอบเอกสารประกอบของปลั๊กอินแต่ละรายการสำหรับรายละเอียดเพิ่มเติม

Available ปลั๊กอิน
สำหรับรายการปลั๊กอินที่เป็นปัจจุบัน โปรดตรวจสอบ CPAN:

<http://search.cpan.org/search?query=App%3A%3AProve+Plugin>

การเขียน ปลั๊กอิน
โปรดดู "PLUGINS" ในแอป :: พิสูจน์

ใช้พิสูจน์ออนไลน์โดยใช้บริการ onworks.net