ນີ້ແມ່ນຄໍາສັ່ງ lit-3.6 ທີ່ສາມາດດໍາເນີນການໄດ້ໃນ OnWorks ຜູ້ໃຫ້ບໍລິການໂຮດຕິ້ງຟຣີໂດຍໃຊ້ຫນຶ່ງໃນຫຼາຍໆບ່ອນເຮັດວຽກອອນໄລນ໌ຂອງພວກເຮົາເຊັ່ນ Ubuntu Online, Fedora Online, Windows online emulator ຫຼື MAC OS online emulator
ໂຄງການ:
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.
--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 ການແຈກຢາຍປະກອບມີການປະຕິບັດຕົວຢ່າງຫຼາຍຢ່າງຂອງຊຸດທົດສອບໃນ
ການທົດສອບຕົວຢ່າງ ລະບົບ.
ໃຊ້ lit-3.6 ອອນລາຍໂດຍໃຊ້ບໍລິການ onworks.net
