Курс по Raku / Напреднали / Модули / Разпространение на модули 🆕

Публикуване с fez

Предишната тема представи fez като начин за качване на дистрибуция в екосистемата на Raku. Не е задължително да използвате fez — това не е единственият начин за публикуване — но е най-разпространеният избор, а освен качване може и да подготви нова дистрибуция за вас и да управлява вашия авторски акаунт. Инсталирайте го с zef:

zef install fez

Стартиране на дистрибуция

Вместо да подготвяте META6.json и директориите lib/ и t/ на ръка, можете да оставите fez да ги създаде:

fez init My::Greeting

fez init инициализира нова дистрибуция, върху която да надграждате — проектна директория с готов META6.json и стандартното оформление вече на място — така можете направо да започнете да пишете код под lib/ и тестове под t/, вместо да подготвяте метаданните сами.

Регистрация и влизане

Публикуването изисква акаунт в екосистемата. Създавате го еднократно с fez register (пита за потребителско име, имейл и парола) и влизате с fez login, който съхранява вашия ключ, така че следващите команди да бъдат удостоверени:

fez register
fez login

Потребителското ви име е важно: META6.json на дистрибуцията трябва да съдържа поле auth, зададено като zef:<username>, което е начинът, по който екосистемата знае, че качването наистина е ваше.

Качване

С готов акаунт и подготвена дистрибуция, fez upload пакетира текущата директория и я изпраща:

fez upload

След това всеки може да я инсталира по име с zef install My::Greeting. Всяка версия може да бъде качена само веднъж, затова не забравяйте да увеличите version в META6.json преди публикуване на актуализация.

Други полезни команди

Още няколко команди на fez, за които ще посегнете:

  • fez review — проверява дистрибуцията за вероятни проблеми преди качване;
  • fez list — показва дистрибуциите, които вече сте публикували;
  • fez refresh — преизгражда META6.json от файловете, които в момента са на диска.

Всички те изискват инсталиран fez и достъп до мрежата, а всичко след init изисква акаунт в екосистемата.

Навигация в курса

← zef и екосистемата   |   Файл META6 →


💪 Или преминете направо към упражненията в този раздел.