lit - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

lit - LLVM Integrated Tester

ສະຫຼຸບສັງລວມ

lit [ທາງເລືອກໃນການ] [ການທົດສອບ]

ລາຍລະອຽດ

lit ເປັນ​ເຄື່ອງ​ມື​ເຄື່ອນ​ໄຫວ​ສໍາ​ລັບ​ການ​ປະ​ຕິ​ບັດ​ຊຸດ​ການ​ທົດ​ສອບ​ແບບ LLVM ແລະ Clang​, ສະ​ຫຼຸບ​ຂອງ​ເຂົາ​ເຈົ້າ​
ຜົນໄດ້ຮັບ, ແລະການສະຫນອງການຊີ້ໃຫ້ເຫັນເຖິງຄວາມລົ້ມເຫລວ. lit ໄດ້ຖືກອອກແບບເພື່ອໃຫ້ມີນ້ໍາຫນັກເບົາ
ເຄື່ອງມືການທົດສອບທີ່ມີການໂຕ້ຕອບຜູ້ໃຊ້ງ່າຍດາຍເທົ່າທີ່ເປັນໄປໄດ້.

lit ຄວນຈະດໍາເນີນການກັບຫນຶ່ງຫຼືຫຼາຍກວ່ານັ້ນ ການທົດສອບ ເພື່ອດໍາເນີນການທີ່ລະບຸໄວ້ໃນເສັ້ນຄໍາສັ່ງ. ການທົດສອບສາມາດເຮັດໄດ້
ເປັນໄຟລ໌ການທົດສອບສ່ວນບຸກຄົນຫຼືໄດເລກະທໍລີເພື່ອຊອກຫາການທົດສອບ (ເບິ່ງ TEST DISCOVERY).

ແຕ່ລະການທົດສອບທີ່ລະບຸຈະຖືກປະຕິບັດ (ມີທ່າແຮງໃນຂະຫນານ) ແລະເມື່ອການທົດສອບທັງຫມົດມີ
ໄດ້ດໍາເນີນການ lit ຈະພິມຂໍ້ມູນສະຫຼຸບກ່ຽວກັບຈໍານວນການທົດສອບທີ່ຜ່ານຫຼືລົ້ມເຫລວ
(ເບິ່ງ TEST STATUS ຜົນໄດ້ຮັບ) The lit ໂປຣແກຣມຈະດຳເນີນການດ້ວຍລະຫັດອອກທີ່ບໍ່ແມ່ນສູນ ຖ້າມີ
ການທົດສອບລົ້ມເຫລວ.

ໂດຍຄ່າເລີ່ມຕົ້ນ lit ຈະໃຊ້ການສະແດງຄວາມຄືບໜ້າແບບຫຍໍ້ໆ ແລະຈະພິມສະເພາະບົດສະຫຼຸບເທົ່ານັ້ນ
ຂໍ້​ມູນ​ສໍາ​ລັບ​ຄວາມ​ລົ້ມ​ເຫຼວ​ຂອງ​ການ​ທົດ​ສອບ​. ເບິ່ງ OUTPUT OPTIONS ສໍາ​ລັບ​ທາງ​ເລືອກ​ໃນ​ການ​ຄວບ​ຄຸມ​ lit
ການ​ສະ​ແດງ​ຄວາມ​ຄືບ​ຫນ້າ​ແລະ​ຜົນ​ຜະ​ລິດ​.

lit ນອກຈາກນີ້ຍັງປະກອບມີທາງເລືອກຈໍານວນຫນຶ່ງສໍາລັບການຄວບຄຸມວິທີການປະຕິບັດການທົດສອບ (ສະເພາະ
ຄຸນສົມບັດອາດຈະຂຶ້ນກັບຮູບແບບການທົດສອບສະເພາະ). ເບິ່ງ ການປະຕິບັດ OPTIONS ສໍາລັບການຫຼາຍ
ຂໍ້ມູນຂ່າວສານ.

ສຸດທ້າຍ, lit ຍັງສະຫນັບສະຫນູນທາງເລືອກເພີ່ມເຕີມສໍາລັບການດໍາເນີນການພຽງແຕ່ຊຸດຍ່ອຍຂອງທາງເລືອກ
ລະບຸໄວ້ໃນເສັ້ນຄໍາສັ່ງ, ເບິ່ງ SELECTION OPTIONS ສໍາລັບຂໍ້ມູນເພີ່ມເຕີມ.

ຜູ້​ໃຊ້​ທີ່​ສົນ​ໃຈ​ໃນ​ lit ສະຖາປັດຕະຍະກຳ ຫຼື ການອອກແບບ ກ lit ການ​ປະ​ຕິ​ບັດ​ການ​ທົດ​ສອບ​ຄວນ​ຈະ​
ເບິ່ງ ຕຽງ INFRASTRUCTURE.

ທົ່ວໄປ OPTIONS

-ຊ, - ຊ່ວຍ
ສະແດງ lit ຂໍ້​ຄວາມ​ຊ່ວຍ​ເຫຼືອ​.

-j N, --threads=N
ການດໍາເນີນງານ N ການທົດສອບຂະຫນານ. ໂດຍຄ່າເລີ່ມຕົ້ນ, ອັນນີ້ຖືກເລືອກໂດຍອັດຕະໂນມັດເພື່ອໃຫ້ກົງກັບ
ຈໍາ​ນວນ​ຂອງ CPU ທີ່​ມີ​ການ​ກວດ​ພົບ​.

--config-prefix=NAME
ຄົ້ນຫາສໍາລັບ NAME.cfg ແລະ NAME.site.cfg ໃນເວລາທີ່ ການຄົ້ນຫາ ສໍາລັບການ ການທົດສອບ ຊຸດ, ແທນທີ່ຈະເປັນ of
lit.cfg ແລະ lit.site.cfg.

-D NAME, -D NAME=VALUE, --param NAME, --param NAME=VALUE
ເພີ່ມພາລາມິເຕີທີ່ຜູ້ໃຊ້ກໍານົດ NAME ດ້ວຍການໃຫ້ ມູນຄ່າ (ຫຼື string ຫວ່າງເປົ່າຖ້າບໍ່ແມ່ນ
ມອບໃຫ້). ຄວາມຫມາຍແລະການນໍາໃຊ້ຕົວກໍານົດການເຫຼົ່ານີ້ແມ່ນຂຶ້ນກັບຊຸດທົດສອບ.

OUTPUT OPTIONS

-q, --ງຽບ
ສະກັດກັ້ນຜົນຜະລິດໃດໆຍົກເວັ້ນສໍາລັບຄວາມລົ້ມເຫຼວຂອງການທົດສອບ.

- ແມ່ນແລ້ວ, -- ຫຍໍ້
ສະແດງໃຫ້ເຫັນຜົນຜະລິດຫນ້ອຍລົງ, ຕົວຢ່າງ: ຢ່າສະແດງຂໍ້ມູນກ່ຽວກັບການທົດສອບທີ່ຜ່ານ.

- ໃນ​, -- verbose
ສະແດງຂໍ້ມູນເພີ່ມເຕີມກ່ຽວກັບຄວາມລົ້ມເຫຼວຂອງການທົດສອບ, ຕົວຢ່າງຜົນການທົດສອບທັງໝົດແທນ
ພຽງ​ແຕ່​ຜົນ​ການ​ທົດ​ສອບ​.

-ກ, --ສະແດງທັງໝົດ
ສະແດງຂໍ້ມູນເພີ່ມເຕີມກ່ຽວກັບການທົດສອບທັງໝົດ, ຕົວຢ່າງ ເສັ້ນຄໍາສັ່ງທົດສອບທັງໝົດ ແລະ
ຜົນຜະລິດ.

--no-progress-bar
ຢ່າໃຊ້ແຖບຄວາມຄືບໜ້າໂດຍອີງໃສ່ຄຳສາບແຊ່ງ.

--show-ບໍ່ຮອງຮັບ
ສະແດງຊື່ຂອງການທົດສອບທີ່ບໍ່ຮອງຮັບ.

--show-xfail
ສະແດງຊື່ຂອງການທົດສອບທີ່ຄາດວ່າຈະລົ້ມເຫລວ.

ການປະຕິບັດ OPTIONS

--path=PATH
ລະບຸເພີ່ມເຕີມ PATH ເພື່ອໃຊ້ໃນເວລາທີ່ຊອກຫາ executables ໃນການທົດສອບ.

--vg ດໍາເນີນການທົດສອບສ່ວນບຸກຄົນພາຍໃຕ້ valgrind (ການນໍາໃຊ້ເຄື່ອງມື memcheck). ໄດ້
--error-exitcode ການໂຕ້ຖຽງສໍາລັບ valgrind ຖືກນໍາໃຊ້ເພື່ອວ່າຄວາມລົ້ມເຫຼວຂອງ valgrind ຈະເຮັດໃຫ້ເກີດ
ໂຄງ​ການ​ທີ່​ຈະ​ອອກ​ດ້ວຍ​ສະ​ຖາ​ນະ​ພາບ​ທີ່​ບໍ່​ແມ່ນ​ສູນ​.

ເມື່ອຕົວເລືອກນີ້ຖືກເປີດໃຊ້, lit ຍັງຈະສະຫນອງອັດຕະໂນມັດ "valgrind"
ຄຸນ​ນະ​ສົມ​ບັດ​ທີ່​ສາ​ມາດ​ຖືກ​ນໍາ​ໃຊ້​ເພື່ອ​ປິດ​ການ​ທໍາ​ງານ​ເງື່ອນ​ໄຂ (ຫຼື​ຄາດ​ຫວັງ​ວ່າ​ຄວາມ​ລົ້ມ​ເຫຼວ​ໃນ​) ແນ່​ນອນ​
ການທົດສອບ.

--vg-arg=ARG
ເມື່ອ​ໃດ​ --vg ຖືກນໍາໃຊ້, ລະບຸການໂຕ້ຖຽງເພີ່ມເຕີມທີ່ຈະສົ່ງຕໍ່ valgrind ຕົວເອງ

--vg-ຮົ່ວ
ເມື່ອ​ໃດ​ --vg ຖືກນໍາໃຊ້, ເປີດການກວດສອບການຮົ່ວໄຫລຂອງຫນ່ວຍຄວາມຈໍາ. ເມື່ອຕົວເລືອກນີ້ຖືກເປີດໃຊ້, lit
ຍັງຈະສະຫນອງອັດຕະໂນມັດ "vg_leak"ຄຸນນະສົມບັດທີ່ສາມາດຖືກນໍາໃຊ້ເພື່ອ
ປິດການໃຊ້ງານຕາມເງື່ອນໄຂ (ຫຼືຄາດວ່າຈະລົ້ມເຫລວໃນ) ການທົດສອບບາງຢ່າງ.

-- ການ​ທົດ​ສອບ​ທີ່​ໃຊ້​ເວ​ລາ​
ຕິດ​ຕາມ​ກໍາ​ແພງ​ຫີນ​ທີ່​ໃຊ້​ເວ​ລາ​ການ​ທົດ​ສອບ​ບຸກ​ຄົນ​ທີ່​ໃຊ້​ເວ​ລາ​ເພື່ອ​ປະ​ຕິ​ບັດ​ແລະ​ລວມ​ເອົາ​ຜົນ​ໄດ້​ຮັບ​ໃນ
ຜົນ​ຜະ​ລິດ​ສະ​ຫຼຸບ​ໄດ້​. ນີ້ແມ່ນເປັນປະໂຫຍດສໍາລັບການກໍານົດການທົດສອບໃນຊຸດການທົດສອບ
ໃຊ້ເວລາຫຼາຍທີ່ສຸດເພື່ອປະຕິບັດ. ໃຫ້ສັງເກດວ່າທາງເລືອກນີ້ແມ່ນເປັນປະໂຫຍດທີ່ສຸດກັບ -j 1.

SELECTION OPTIONS

--max-tests=N
ແລ່ນຫຼາຍທີ່ສຸດ N ການທົດສອບແລະຫຼັງຈາກນັ້ນຢຸດເຊົາ.

--max-time=N
ໃຊ້ເວລາຫຼາຍທີ່ສຸດ N ວິນາທີ (ປະມານ) ການທົດສອບແລ່ນແລະຫຼັງຈາກນັ້ນຢຸດ.

--ສະຫຼັບ
ດໍາ​ເນີນ​ການ​ທົດ​ສອບ​ໃນ​ຄໍາ​ສັ່ງ Random​.

ເພີ່ມເຕີມ OPTIONS

--debug
ການດໍາເນີນງານ lit ໃນ​ຮູບ​ແບບ debug​, ສໍາ​ລັບ​ການ​ແກ້​ໄຂ​ບັນ​ຫາ​ການ​ຕັ້ງ​ຄ່າ​ແລະ​ lit ຕົວເອງ

--show-suites
ບອກຊຸດທົດສອບທີ່ຄົ້ນພົບ ແລະອອກ.

--show-tests
ບອກທັງໝົດຂອງການທົດສອບທີ່ຄົ້ນພົບ ແລະອອກ.

ອອກ STATUS

lit ຈະອອກດ້ວຍລະຫັດອອກຂອງ 1 ຖ້າມີຜົນໄດ້ຮັບ FAIL ຫຼື XPASS. ຖ້າບໍ່ດັ່ງນັ້ນ,
ມັນຈະອອກດ້ວຍສະຖານະ 0. ລະຫັດອອກອື່ນໆແມ່ນໃຊ້ສໍາລັບຄວາມລົ້ມເຫລວທີ່ກ່ຽວຂ້ອງກັບການທົດສອບ
(ເຊັ່ນ: ຂໍ້ຜິດພາດຂອງຜູ້ໃຊ້ ຫຼືຂໍ້ຜິດພາດຂອງໂປຣແກຣມພາຍໃນ).

TEST DISCOVERY

ວັດສະດຸປ້ອນໄດ້ຜ່ານໄປ lit ສາ​ມາດ​ເປັນ​ການ​ທົດ​ສອບ​ບຸກ​ຄົນ​, ຫຼື​ທັງ​ຫມົດ​ລະ​ບົບ​ຫຼື​
ລໍາດັບຊັ້ນຂອງການທົດສອບທີ່ຈະດໍາເນີນການ. ເມື່ອ​ໃດ​ lit ເລີ່ມຕົ້ນຂຶ້ນ, ສິ່ງທໍາອິດທີ່ມັນເຮັດແມ່ນການແປງ
ປ້ອນເຂົ້າໃນບັນຊີລາຍຊື່ເຕັມຂອງການທົດສອບທີ່ຈະດໍາເນີນການເປັນສ່ວນຫນຶ່ງຂອງ ການທົດສອບ ການຄົ້ນພົບ.

ໃນ lit ຮູບແບບ, ທຸກໆການທົດສອບຕ້ອງມີຢູ່ໃນບາງ ການທົດສອບ suite. lit ແກ້ໄຂວັດສະດຸປ້ອນ
ລະບຸໄວ້ໃນເສັ້ນຄໍາສັ່ງເພື່ອທົດສອບຊຸດໂດຍການຊອກຫາຂຶ້ນໄປຈາກເສັ້ນທາງການປ້ອນຂໍ້ມູນ
ຈົນກ່ວາມັນພົບເຫັນເປັນ lit.cfg or lit.site.cfg ໄຟລ໌. ໄຟລ໌ເຫຼົ່ານີ້ຮັບໃຊ້ເປັນທັງເຄື່ອງໝາຍການທົດສອບ
suites ແລະ​ເປັນ​ໄຟລ​໌​ການ​ຕັ້ງ​ຄ່າ​ທີ່​ lit loads ເພື່ອເຂົ້າໃຈວິທີການຊອກຫາແລະ
ດໍາເນີນການທົດສອບພາຍໃນຊຸດທົດສອບ.

ເມື່ອໃດທີ່ lit ໄດ້ສ້າງແຜນທີ່ວັດສະດຸປ້ອນເຂົ້າໄປໃນຊຸດທົດສອບມັນຂ້າມບັນຊີລາຍຊື່ຂອງວັດສະດຸປ້ອນ
ການ​ທົດ​ສອບ​ສໍາ​ລັບ​ໄຟລ​໌​ແຕ່​ລະ​ຄົນ​ແລະ recursively ຊອກ​ຫາ​ສໍາ​ລັບ​ການ​ທົດ​ສອບ​ໃນ​ລາຍ​ການ​.

ພຶດຕິກໍານີ້ເຮັດໃຫ້ມັນງ່າຍທີ່ຈະລະບຸຊຸດຍ່ອຍຂອງການທົດສອບທີ່ຈະດໍາເນີນການ, ໃນຂະນະທີ່ຍັງອະນຸຍາດໃຫ້
ການຕັ້ງຄ່າຊຸດທົດສອບເພື່ອຄວບຄຸມຢ່າງແນ່ນອນວ່າການທົດສອບຖືກຕີຄວາມໝາຍແນວໃດ. ເພີ່ມ​ເຕີມ, lit
ສະ​ເຫມີ​ກໍາ​ນົດ​ການ​ທົດ​ສອບ​ໂດຍ​ຊຸດ​ທົດ​ສອບ​ທີ່​ເຂົາ​ເຈົ້າ​ຢູ່​ໃນ​, ແລະ​ເສັ້ນ​ທາງ​ພີ່​ນ້ອງ​ຂອງ​ເຂົາ​ເຈົ້າ​ຢູ່​ໃນ​
ຊຸດ​ທົດ​ສອບ​. ສໍາລັບໂຄງການທີ່ກໍາຫນົດຄ່າທີ່ເຫມາະສົມ, ນີ້ອະນຸຍາດໃຫ້ lit ເພື່ອສະຫນອງຄວາມສະດວກ
ແລະການສະຫນັບສະຫນູນທີ່ຍືດຫຍຸ່ນສໍາລັບການກໍ່ສ້າງນອກຕົ້ນໄມ້.

TEST STATUS ຜົນໄດ້ຮັບ

ການທົດສອບແຕ່ລະຄັ້ງສຸດທ້າຍຜະລິດຫນຶ່ງໃນຫົກຜົນໄດ້ຮັບຕໍ່ໄປນີ້:

ຜ່ານ
ການທົດສອບປະສົບຜົນສໍາເລັດ.

XFAIL
ການທົດສອບລົ້ມເຫລວ, ແຕ່ວ່າຄາດວ່າ. ນີ້ແມ່ນໃຊ້ສໍາລັບຮູບແບບການທົດສອບທີ່ອະນຸຍາດໃຫ້
ລະບຸວ່າການທົດສອບບໍ່ໄດ້ຜົນໃນຂະນະນີ້, ແຕ່ຕ້ອງການປ່ອຍໃຫ້ມັນຢູ່ໃນຊຸດທົດສອບ.

XPASS
ການທົດສອບປະສົບຜົນສໍາເລັດ, ແຕ່ຄາດວ່າຈະລົ້ມເຫລວ. ນີ້​ແມ່ນ​ການ​ນໍາ​ໃຊ້​ສໍາ​ລັບ​ການ​ທົດ​ສອບ​ທີ່​ໄດ້​
ລະບຸວ່າຄາດວ່າຈະລົ້ມເຫລວ, ແຕ່ຕອນນີ້ປະສົບຜົນສໍາເລັດ (ໂດຍທົ່ວໄປແລ້ວເນື່ອງຈາກວ່າຄຸນສົມບັດ
ພວກ​ເຂົາ​ເຈົ້າ​ທົດ​ສອບ​ໄດ້​ຖືກ​ແຍກ​ແລະ​ໄດ້​ຮັບ​ການ​ແກ້​ໄຂ​)​.

ປະຕິບັດ
ການທົດສອບລົ້ມເຫລວ.

ບໍ່ໄດ້ແກ້ໄຂ
ຜົນການສອບເສັງບໍ່ສາມາດກຳນົດໄດ້. ຕົວຢ່າງ, ນີ້ເກີດຂື້ນເມື່ອການທົດສອບສາມາດເຮັດໄດ້
ບໍ່ໄດ້ດໍາເນີນການ, ການທົດສອບຕົວມັນເອງບໍ່ຖືກຕ້ອງ, ຫຼືການທົດສອບຖືກລົບກວນ.

ສະ ໜັບ ສະ ໜູນ
ບໍ່ຮອງຮັບການທົດສອບໃນສະພາບແວດລ້ອມນີ້. ນີ້​ແມ່ນ​ການ​ນໍາ​ໃຊ້​ໂດຍ​ຮູບ​ແບບ​ການ​ທົດ​ສອບ​ທີ່​ສາ​ມາດ​ເຮັດ​ໄດ້​
ລາຍງານການທົດສອບທີ່ບໍ່ຮອງຮັບ.

ອີງຕາມການທົດສອບຮູບແບບການທົດສອບອາດຈະຜະລິດຂໍ້ມູນເພີ່ມເຕີມກ່ຽວກັບສະຖານະພາບຂອງເຂົາເຈົ້າ
(ໂດຍທົ່ວໄປແລ້ວພຽງແຕ່ສໍາລັບຄວາມລົ້ມເຫລວ). ເບິ່ງ OUTPUT OPTIONS ສ່ວນ ສຳ ລັບຂໍ້ມູນເພີ່ມເຕີມ.

ຕຽງ INFRASTRUCTURE

ພາກນີ້ອະທິບາຍເຖິງ lit ການທົດສອບສະຖາປັດຕະຍະກໍາສໍາລັບຜູ້ໃຊ້ທີ່ສົນໃຈໃນການສ້າງໃຫມ່
lit ການທົດສອບການປະຕິບັດ, ຫຼືຂະຫຍາຍອັນທີ່ມີຢູ່ແລ້ວ.

lit ທີ່ເຫມາະສົມຕົ້ນຕໍແມ່ນພື້ນຖານໂຄງລ່າງສໍາລັບການຄົ້ນພົບແລະແລ່ນການທົດສອບທີ່ມັກ, ແລະ
ເພື່ອເປີດເຜີຍການໂຕ້ຕອບທີ່ສະດວກດຽວກັບການທົດສອບເຫຼົ່ານີ້. lit ຕົວຂອງມັນເອງບໍ່ຮູ້ວິທີການແລ່ນ
ການທົດສອບ, ແທນທີ່ຈະຕາມເຫດຜົນນີ້ຖືກກໍານົດໂດຍ ການທົດສອບ ເຫມາະສົມ.

TEST ຊຸດ
ດັ່ງທີ່ໄດ້ອະທິບາຍໄວ້ໃນ TEST DISCOVERY, ການທົດສອບແມ່ນຢູ່ສະເຫມີພາຍໃນ a ການທົດສອບ suite. ຊຸດທົດສອບ
ຮັບ​ໃຊ້​ເພື່ອ​ກໍາ​ນົດ​ຮູບ​ແບບ​ຂອງ​ການ​ທົດ​ສອບ​ທີ່​ເຂົາ​ເຈົ້າ​ມີ​, ມີ​ເຫດ​ຜົນ​ສໍາ​ລັບ​ການ​ຊອກ​ຫາ​ການ​ທົດ​ສອບ​ເຫຼົ່າ​ນັ້ນ​,
ແລະຂໍ້ມູນເພີ່ມເຕີມເພື່ອດໍາເນີນການທົດສອບ.

lit ກໍານົດຊຸດທົດສອບເປັນໄດເລກະທໍລີທີ່ປະກອບດ້ວຍ lit.cfg or lit.site.cfg ໄຟລ໌ (ເບິ່ງ
ຍັງ --config-prefix). ຊຸດທົດສອບໄດ້ຖືກຄົ້ນພົບໃນເບື້ອງຕົ້ນໂດຍການຄົ້ນຫາ recursively
ລໍາດັບຊັ້ນຂອງໄດເລກະທໍລີສໍາລັບໄຟລ໌ປ້ອນຂໍ້ມູນທັງຫມົດຜ່ານເສັ້ນຄໍາສັ່ງ. ທ່ານສາມາດນໍາໃຊ້
--show-suites ເພື່ອສະແດງຊຸດທົດສອບທີ່ຄົ້ນພົບໃນຕອນເລີ່ມຕົ້ນ.

ເມື່ອຊຸດທົດສອບຖືກຄົ້ນພົບ, ໄຟລ໌ config ຂອງມັນຈະຖືກໂຫລດ. Config ໄຟລ໌ດ້ວຍຕົນເອງແມ່ນ
ໂມດູນ Python ທີ່ຈະຖືກປະຕິບັດ. ເມື່ອໄຟລ໌ config ຖືກປະຕິບັດ, ສອງອັນສໍາຄັນ
ຕົວແປທົ່ວໂລກແມ່ນຖືກກໍານົດໄວ້ລ່ວງໜ້າ:

lit_config
ໃນທົ່ວໂລກ lit ຈຸດ​ປະ​ສົງ​ການ​ຕັ້ງ​ຄ່າ (ກ LitConfig instance), ເຊິ່ງກໍານົດ buildin
ຮູບ​ແບບ​ການ​ທົດ​ສອບ​, ຕົວ​ກໍາ​ນົດ​ການ​ຕັ້ງ​ຄ່າ​ທົ່ວ​ໂລກ​, ແລະ​ກິດ​ຈະ​ກໍາ​ການ​ຊ່ວຍ​ເຫຼືອ​ອື່ນໆ​ສໍາ​ລັບ​ການ​
ການ​ປະ​ຕິ​ບັດ​ການ​ຕັ້ງ​ຄ່າ​ການ​ທົດ​ສອບ​.

config
ນີ້ແມ່ນວັດຖຸ config (a TestingConfig ຕົວຢ່າງ) ສໍາລັບຊຸດທົດສອບ, ເຊິ່ງ
ຄາດວ່າຈະເພີ່ມໄຟລ໌ config. ຕົວແປຕໍ່ໄປນີ້ຍັງມີຢູ່ໃນ
config object, ບາງອັນຈະຕ້ອງຖືກຕັ້ງຄ່າໂດຍ config ແລະອື່ນ ໆ ແມ່ນທາງເລືອກຫຼື
ກຳນົດລ່ວງໜ້າ:

ຊື່ [ຕ້ອງການ] ຊື່ຂອງຊຸດທົດສອບ, ສໍາລັບການນໍາໃຊ້ໃນບົດລາຍງານແລະການວິນິດໄສ.

test_format [ຕ້ອງການ] ການທົດສອບຮູບແບບວັດຖຸທີ່ຈະຖືກນໍາໃຊ້ເພື່ອຄົ້ນພົບແລະດໍາເນີນການ
ການທົດສອບໃນຊຸດທົດສອບ. ໂດຍ​ທົ່ວ​ໄປ​ນີ້​ຈະ​ເປັນ​ຮູບ​ແບບ​ການ​ທົດ​ສອບ​ທີ່​ມີ​ຢູ່​ໃນ​
ໄດ້ lit.formats module

test_source_root ເສັ້ນທາງລະບົບໄຟລ໌ໄປຫາຮາກຊຸດທົດສອບ. ສໍາລັບການກໍ່ສ້າງນອກ-dir
ນີ້ແມ່ນບັນຊີລາຍການທີ່ຈະຖືກສະແກນສໍາລັບການທົດສອບ.

test_exec_root ສໍາລັບການກໍ່ສ້າງນອກ-dir, ເສັ້ນທາງໄປຫາຮາກຊຸດທົດສອບພາຍໃນວັດຖຸ
ໄດເລກະທໍລີ. ນີ້​ແມ່ນ​ບ່ອນ​ທີ່​ການ​ທົດ​ສອບ​ຈະ​ໄດ້​ຮັບ​ການ​ດໍາ​ເນີນ​ການ​ແລະ​ໄຟລ​໌​ຜົນ​ຜະ​ລິດ​ຊົ່ວ​ຄາວ​ວາງ​ໄວ້​.

ສະພາບແວດລ້ອມ ວັດຈະນານຸກົມທີ່ເປັນຕົວແທນຂອງສະພາບແວດລ້ອມທີ່ຈະໃຊ້ໃນເວລາທີ່ປະຕິບັດການທົດສອບໃນ
ຊຸດ.

បច្ច័យ ສໍາລັບການ lit ຮູບແບບການທົດສອບທີ່ສະແກນໄດເລກະທໍລີສໍາລັບການທົດສອບ, ຕົວແປນີ້ແມ່ນບັນຊີລາຍຊື່
ຂອງ suffixes ເພື່ອກໍານົດໄຟລ໌ການທົດສອບ. ໃຊ້ໂດຍ: ShTest.

ການທົດແທນ ສໍາລັບການ lit ຮູບ​ແບບ​ການ​ທົດ​ສອບ​ທີ່​ທົດ​ແທນ​ຕົວ​ປ່ຽນ​ເປັນ​ສະ​ຄຣິ​ບ​ການ​ທົດ​ສອບ​, ໄດ້​
ບັນຊີລາຍຊື່ຂອງການທົດແທນທີ່ຈະປະຕິບັດ. ໃຊ້ໂດຍ: ShTest.

ບໍ່ຮອງຮັບ ໝາຍລາຍຊື່ທີ່ບໍ່ຮອງຮັບ, ການທົດສອບທັງໝົດພາຍໃນມັນຈະຖືກລາຍງານເປັນ
ບໍ່ຮອງຮັບ. ໃຊ້ໂດຍ: ShTest.

ພໍ່ແມ່ ການຕັ້ງຄ່າຫຼັກ, ນີ້ແມ່ນວັດຖຸ config ສໍາລັບໄດເລກະທໍລີທີ່ປະກອບດ້ວຍ
ຊຸດການທົດສອບ, ຫຼືບໍ່ມີ.

ຮາກ ການຕັ້ງຄ່າຮາກ. ນີ້ແມ່ນອັນສູງສຸດ lit ການ​ຕັ້ງ​ຄ່າ​ໃນ​ໂຄງ​ການ​.

pipefail ປົກກະຕິແລ້ວການທົດສອບໂດຍໃຊ້ທໍ່ແກະລົ້ມເຫລວຖ້າຫາກວ່າຄໍາສັ່ງໃດໆກ່ຽວກັບທໍ່
ລົ້ມເຫລວ. ຖ້າອັນນີ້ບໍ່ຕ້ອງການ, ການຕັ້ງຄ່າຕົວແປນີ້ເປັນຜິດເຮັດໃຫ້ການທົດສອບລົ້ມເຫລວເທົ່ານັ້ນ
ຖ້າຄໍາສັ່ງສຸດທ້າຍໃນທໍ່ລົ້ມເຫລວ.

TEST DISCOVERY
ເມື່ອຊຸດທົດສອບຕັ້ງຢູ່, lit recursively traverses ໄດເລກະທໍລີແຫຼ່ງ (ດັ່ງຕໍ່ໄປນີ້
test_source_root) ຊອກ​ຫາ​ການ​ທົດ​ສອບ​. ເມື່ອ​ໃດ​ lit ເຂົ້າໄປໃນໄດເລກະທໍລີຍ່ອຍ, ມັນທໍາອິດກວດເບິ່ງ
ກວດເບິ່ງວ່າຊຸດທົດສອບທີ່ຕັ້ງໄວ້ໄດ້ຖືກກໍານົດໄວ້ໃນໄດເລກະທໍລີນັ້ນ. ຖ້າເປັນດັ່ງນັ້ນ, ມັນຈະໂຫລດຊຸດທົດສອບນັ້ນ
recursively, ຖ້າບໍ່ດັ່ງນັ້ນມັນ instantiates ການທົດສອບ config ທ້ອງຖິ່ນສໍາລັບໄດເລກະທໍລີ (ເບິ່ງ ທ້ອງຖິ່ນ
CONFIGURATION ເອກະສານ).

ການທົດສອບແມ່ນຖືກກໍານົດໂດຍຊຸດການທົດສອບທີ່ພວກມັນຖືກບັນຈຸຢູ່ພາຍໃນ, ແລະເສັ້ນທາງທີ່ກ່ຽວຂ້ອງ
ພາຍໃນຊຸດນັ້ນ. ໃຫ້ສັງເກດວ່າເສັ້ນທາງທີ່ກ່ຽວຂ້ອງອາດຈະບໍ່ຫມາຍເຖິງໄຟລ໌ຕົວຈິງໃນແຜ່ນ;
ບາງ​ຮູບ​ແບບ​ການ​ທົດ​ສອບ (ເຊັ່ນ​: ການທົດສອບ Google) ກໍານົດ "ການທົດສອບ virtual" ທີ່ມີເສັ້ນທາງທີ່
ປະກອບມີທັງເສັ້ນທາງໄປຫາໄຟລ໌ການທົດສອບຕົວຈິງແລະເສັ້ນທາງຍ່ອຍເພື່ອກໍານົດການທົດສອບ virtual.

ທ້ອງຖິ່ນ CONFIGURATION ເອກະສານ
ເມື່ອ​ໃດ​ lit ໂຫຼດໄດເລກະທໍລີຍ່ອຍຢູ່ໃນຊຸດທົດສອບ, ມັນເຮັດໃຫ້ການຕັ້ງຄ່າການທົດສອບໃນທ້ອງຖິ່ນທັນທີ
ໂດຍ cloning ການ​ຕັ້ງ​ຄ່າ​ສໍາ​ລັບ​ບັນ​ຊີ​ຂອງ​ແມ່ --- ຮາກ​ຂອງ​ການ​ຕັ້ງ​ຄ່າ​ນີ້​
ລະບົບຕ່ອງໂສ້ຈະເປັນຊຸດທົດສອບສະເໝີ. ເມື່ອ​ການ​ຕັ້ງ​ຄ່າ​ການ​ທົດ​ສອບ​ແມ່ນ cloned​ lit ກວດ​ສອບ​ສໍາ​ລັບ​ການ a
lit.local.cfg ໄຟລ໌ຢູ່ໃນໄດເລກະທໍລີຍ່ອຍ. ຖ້າມີ, ໄຟລ໌ນີ້ຈະຖືກໂຫລດແລະສາມາດເປັນ
ໃຊ້ເພື່ອຊ່ຽວຊານການຕັ້ງຄ່າສໍາລັບແຕ່ລະໄດເລກະທໍລີສ່ວນບຸກຄົນ. ສະຖານທີ່ນີ້ສາມາດເປັນ
ນໍາໃຊ້ເພື່ອກໍານົດ subdirectories ຂອງການທົດສອບທາງເລືອກ, ຫຼືການປ່ຽນແປງການຕັ້ງຄ່າອື່ນໆ
ຕົວກໍານົດການ --- ສໍາລັບການຍົກຕົວຢ່າງ, ການປ່ຽນແປງຮູບແບບການທົດສອບ, ຫຼື suffixes ທີ່ກໍານົດການທົດສອບ
ໄຟລ໌.

TEST RUN OUTPUT ຮູບແບບ
ໄດ້ lit ຜົນ​ຜະ​ລິດ​ສໍາ​ລັບ​ການ​ດໍາ​ເນີນ​ການ​ທົດ​ສອບ​ສອດ​ຄ່ອງ​ກັບ schema ດັ່ງ​ຕໍ່​ໄປ​ນີ້​, ໃນ​ທັງ​ສັ້ນ​ແລະ verbose​
ໂຫມດ (ເຖິງແມ່ນວ່າໃນໂຫມດສັ້ນຈະບໍ່ມີສາຍ PASS ສະແດງໃຫ້ເຫັນ). schema ນີ້ໄດ້ຖືກເລືອກ
ຂ້ອນຂ້າງງ່າຍຕໍ່ການວິເຄາະໂດຍເຄື່ອງຈັກ (ຕົວຢ່າງໃນ buildbot log
scraping), ແລະສໍາລັບເຄື່ອງມືອື່ນໆທີ່ຈະສ້າງ.

ຜົນການທົດສອບແຕ່ລະອັນຄາດວ່າຈະປາກົດຢູ່ໃນເສັ້ນທີ່ກົງກັນ:

: ( )

ບ່ອນທີ່ ເປັນຜົນການທົດສອບມາດຕະຖານເຊັ່ນ: PASS, FAIL, XFAIL, XPASS,
ບໍ່ໄດ້ຮັບການແກ້ໄຂ, ຫຼືບໍ່ໄດ້ຮັບການສະຫນັບສະຫນູນ. ລະຫັດຜົນການປະຕິບັດຂອງ IMPROVED ແລະ REGRESSED ແມ່ນ
ຍັງອະນຸຍາດ.

ໄດ້ <ການທົດສອບ ຊື່> ຊ່ອງຂໍ້ມູນສາມາດປະກອບດ້ວຍ string arbitrary ທີ່ບໍ່ມີເສັ້ນໃຫມ່.

ໄດ້ <ຄວາມຄືບໜ້າ ຂໍ້ມູນ> ພາກສະຫນາມສາມາດຖືກນໍາໃຊ້ເພື່ອລາຍງານຂໍ້ມູນຄວາມຄືບຫນ້າເຊັ່ນ: (1/300) ຫຼື
ສາມາດຫວ່າງເປົ່າໄດ້, ແຕ່ເຖິງແມ່ນວ່າເມື່ອຫວ່າງເປົ່າ ວົງເລັບແມ່ນຕ້ອງການ.

ແຕ່ລະຜົນການທົດສອບອາດຈະປະກອບມີຂໍ້ມູນບັນທຶກເພີ່ມເຕີມ (multiline) ໃນຕໍ່ໄປນີ້
ຮູບແບບ:

ທົດສອບ '( )'
... ບັນທຶກຂໍ້ຄວາມ ...


ບ່ອນທີ່ <ການທົດສອບ ຊື່> ຄວນເປັນຊື່ຂອງການທົດສອບລາຍງານກ່ອນໜ້າ, <ບັນທຶກ ຜູ່ກຳນົດ > ເປັນ
ສະຕຣິງຂອງຕົວອັກສອນ "*". at ຢ່າງຫນ້ອຍ ສີ່ຕົວອັກສອນຍາວ (ຄວາມຍາວທີ່ແນະນໍາແມ່ນ 20), ແລະ
<ຕາມຫຼັງ ຜູ່ກຳນົດ > ເປັນສະຕຣິງທີ່ບໍ່ໄດ້ວິເຄາະ.

ຕໍ່​ໄປ​ນີ້​ແມ່ນ​ຕົວ​ຢ່າງ​ຂອງ​ຜົນ​ຜະ​ລິດ​ການ​ທົດ​ສອບ​ທີ່​ປະ​ກອບ​ດ້ວຍ​ສີ່​ທົດ​ສອບ A​, B​, C​, ແລະ​
D, ແລະຂໍ້ຄວາມບັນທຶກສໍາລັບການທົດສອບລົ້ມເຫລວ C:

ຜ່ານ: A (1 ຈາກທັງໝົດ 4)
ຜ່ານ: B (2 ຈາກທັງໝົດ 4)
FAIL: C (3 ຈາກທັງໝົດ 4)
******************** ການທົດສອບ 'C' ລົ້ມເຫລວ ********************
ການທົດສອບ 'C' ລົ້ມເຫລວເນື່ອງຈາກລະຫັດອອກ 1.
********************
ຜ່ານ: D (4 ຈາກທັງໝົດ 4)

ຕຽງ EXAMPLE TESTS
ໄດ້ lit ການແຈກຢາຍປະກອບມີການປະຕິບັດຕົວຢ່າງຫຼາຍຢ່າງຂອງຊຸດທົດສອບໃນ
ການທົດສອບຕົວຢ່າງ ລະບົບ.

ໃຊ້ໄຟອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net