s21_tetris/materials/instructions_for_testing_uzb.md

Sinovlarni ishga tushirish bo’yicha ko’rsatmalar

To’g’ri chiqish ma’lumotlarini sinovdan o’tkazishga qo’shimcha ravishda, ushbu avtotest tizimi dasturing va uning manba kodini quyidagi bandlar bo’yicha tekshiradi:

• Uslubiy testlar. Kodingning go’zalligi standartlarga naqadar mos kelishini tekshirish uchun sen clang-format utiliti yordamida dasturidan foydalanib kodingni sinab ko’rishing mumkin. materials/linters papkasida uslub testi uchun kerakli sozlamalarni o’z ichiga olgan .clang-format fayli mavjud. Ushbu konfiguratsiya fayli o’z ta’sirini direktoriyada yoki pastroqdagi direktoriyalarda joylashgan barcha fayllarga qo’llaydi. Shuning uchun, ushbu sozlamalar asosiy koding bo’lgan fayllaringga qo’llanilishi uchun.
  clang-format src papkasiga nusxala.
  
  Uslubni tekshirish uchun quyidagi buyruqni bajar:
  clang-format -n src/sourcefile_name.c

  clang-format yuklab olish uchun terminalga quyidagi buyruqlardan birini kirit:
  brew install clang-format
  yoki, agar senda root huquqlari bo’lsa (Ubuntu / Linux Mint / Debian uchun)
  sudo apt install clang-format

  Kerakli clang-format versiyasi:
  Mac 18.1.8
  Linux 18.1.8

  Google Style: https://google.github.io/styleguide/cppguide.html

• Xotiraning to'g'ri ishlashini sinash. C dasturlarini yozishda xotiraning oqishiga e'tibor berish juda muhimdir. Buning uchun Unix-ga o'xshash operatsion tizimlarda ko'pincha valgrind utilitasi qo'llaniladi. Biroq, OS X da valgrind qo’llab-quvvatlashda muammolar mavjud, shuning uchun uning o’rniga leaks utilitasidan foydalanish mumkin.

  Hozir ushbu utilitalar ishlash mexanizmini ko’rib chiqmaymiz - agar qiziq bo’lda, Googleda o'qishing mumkin.

LEAKS

Ushbu yordamchi dastur yordamida bajariladigan faylni ishga tushirish uchun terminalga kirit: leaks -atExit -- ./main.out | grep LEAK:

| grep LEAK: buyrug’iga e’tibor ber. Biz uni qisqa chiqish uchun ishlatamiz, shunda biz agar mavjud bo'lsa faqat oqishlar bo’lgan chiziqlarni ko'rishimiz mumkin. Agar sen butun chiqarishni ko’rishni istasang, shunchaki bu buyruqni o’chirib tashla.

leaks yordamida bajariladigan faylni ishga tushirishda, xatolik to’g’risidagi xabar paydo bo’lishi mumkin:

dyld: could not load inserted library ‘/usr/local/lib/libLeaksAtExit.dylib’ because image not found

leaks kutubxonani topa olmaganligi sababli xatolik yuzaga keladi libLeaksAtExit.dylib. \
Bunday holda quyidagi buyruqlarni kiritish kerak:

cd /usr/local/lib
sudo ln -s /Applications/Xcode.app/Contents/Developer/usr/lib/libLeaksAtExit.dylib

Qo’shimcha:
Xotirada oqish borligi maʼlum boʻlgan funksiyalardagi oqib chiqishlarni filtrlash uchun leaks utilitasining -exclude bayrogʻidan foydalan. Bu bayroq leaks tomonidan berilayotgan ma’lumotlarning oqishini kamaytirish imkonini beradi.

VALGRIND

valgrind kompyuterga o’rnatish uchun quyidagi buyruqlardan birini kirit:
brew install valgrind
yoki, agar sizda ildiz huquqlari bo'lsa (Ubuntu / Linux Mint / Debian uchun)
sudo apt install valgrind
Ushbu utilita yordamida bajariladigan faylni ishga tushirish uchun terminalga kirit:
valgrind --tool=memcheck --leak-check=yes ./main.out

OS X da valgrind foydalanish tavsiya etilmaydi, buning o’rniga leaks ishlatish yaxshiroqdir

• Qo‘shimcha xotiraning to’g’ri ishlashini tekshirish. Yana bir variant sifatida xotirani qayta ishlashning to'g'riligini tekshirish va xotira oqishini kuzatish - gcc ichiga o'rnatilgan AddressSanitizer utilitalaridan foydalanish. Shu o’rinda ta’kidlab o’tamizki, uni leaks yoki valgrind alohida ishlatish kerak, chunki u kompilyatsiyadan keyin avtomatik ravishda binary faylga o’rnatiladi va ushbu utilitalar bilan mos kelmasligi mumkin.

Uni kompilyatsiyalash paytida ishlatish uchun -fsanitize=address bayrog'ini belgilaymiz.

Masalan:

gcc -o main main.c -fsanitize=address

Va yig’ilgan dasturni odatdagi tarzda ishga tushiramiz. Bunday holda, xotira bilan bog’liq xatolar mavjud bo’lsa, ular konsolda ko’rsatiladi.

-fsanitize=address bayrog'idan tashqari quyidagi bayroqlardan ham foydalanish mumkin:

• -fsanitize=leak - xotira oqishini kuzatish uchun. Shuningdek, qo’shimcha ravishda leaks yoki valgrind yordamida oqishlarni tekshirishni ham unutma.
• -fsanitize=undefined - aniqlanmagan dastur harakati joylarini aniqlash uchun (masalan, massiv chegarasidan tashqariga chiqish yoki int’ni haddan tashqari to’lishi).
• -fsanitize=unreachable - erishib bo'lmaydigan dastur nuqtalarini aniqlash uchun.

Yanada ko’proq bayroqlarni gcc va AddressSanitizer hujjatlarida topishing mumkin.