Ishlab chiqish

picozero-ni yaratish (build) va joylashtirish (deploy) bo'yicha ko'rsatmalar.

Oldindan talablar

picozero-ni yaratish va joylashtirish uchun kerakli bog'liqliklarni o'rnatishingiz kerak:

pip3 install twine sphinx

Yaratish (Build)

  1. setup.py, picozero/__init__.py va docs/conf.py fayllaridagi versiya raqamlarini yangilang.

  2. docs/changelog.rst fayliga yangi versiya haqida ma'lumot qo'shing.

  3. setup.py-ni ishga tushiring va manba tarqatmasini (source distribution) yarating:

    python3 setup.py sdist
    
  4. PyPI-ga yuklang:

    twine upload dist/*
    
  5. Barcha o'zgarishlarni master tarmog'iga yuboring (push).

  6. GitHub-da release (versiya) yarating va picozero-#-#-#.tar.gz manba faylini ushbu relizga yuklang.

Hujjatlar

Hujjatlar sayti Sphinx yordamida yaratilgan.

Sphinx-ni quyidagicha o'rnating:

pip3 install sphinx

Hujjatlar yaratilishini sinab ko'rish uchun docs katalogidan quyidagi buyruqni ishga tushiring:

$ ./make html

Veb-sayt docs/_build/html katalogida yaratiladi.

Hujjatlarni picozero-rw.readthedocs.io saytida ko'rish mumkin va ular GitHub-ga yuborilganda (push) avtomatik ravishda yaratiladi va joylashtiriladi.

Sinovlar (Tests)

Sinovlar Raspberry Pi Pico-da ishlashga mo'ljallangan.

  1. picozero paketini o'rnating.

  2. micropython-unittest paketini o'rnating.

  3. test_picozero.py faylini Pico-ga nusxalang.

  4. test_picozero.py faylini ishga tushiring.

Agar biron bir sinov muvaffaqiyatsiz tugasa, batafsil xato xabarlarini ko'rish foydali bo'ladi. Xato xabarlarini ko'rish uchun Pico-dagi lib/unittest.py faylini o'zgartirishingiz kerak.

run_class funksiyasidan quyidagi kodni toping:

# Uncomment to investigate failure in detail
#raise

raise qatoridan izohni olib tashlang:

# Uncomment to investigate failure in detail
raise