Курс 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 →


💪 Або перейдіть одразу до вправ цього розділу.