Надсилання модуля в GitHub

Надсилання передає випущену версію модуля в репозиторій GitHub у вигляді пул-реквесту, готового до перегляду, — OdoMate ніколи не комітить напряму в гілку, яку ви вже використовуєте. Ця сторінка описує відкриття діалогу, призначення полів і те, що відбувається після того, як ви виберете надсилання. Спершу потрібен підключений обліковий запис GitHub; див. підключення вашого облікового запису GitHub, якщо ви ще цього не зробили.

Відкриття діалогу

1. Знайдіть кнопку Push to GitHub. Вона є на екрані завершення одразу після завершення генерації (див. генерація першого модуля), на картці модуля в бібліотеці модулів або на конкретному записі в історії версій цього модуля.
2. Кнопка з’являється лише для версії, чий ZIP-архів усе ще доступний — та сама умова, що керує кнопкою Download. Див. завантаження модуля, якщо архів уже прострочено.
3. Виберіть її, щоб відкрити діалог Push to GitHub.

Заувага

Якщо ви ще не підключили обліковий запис GitHub, діалог одразу відкриває процес підключення замість цього — див. підключення вашого облікового запису GitHub.

Вибір місця призначення

1. Якщо у вашого облікового запису є і особисте підключення до GitHub, і доступ до підключення команди, спершу з’являється селектор Push via — виберіть, через яке встановлення надсилати. Він прихований, коли обирати нема з чого; див. підключення вашого облікового запису GitHub, щоб дізнатися, коли так буває.
2. Використовуйте поле Repository, щоб шукати серед репозиторіїв, доступних обраному підключенню. Це список репозиторіїв, що вже існують, із можливістю фільтрації, — створити новий репозиторій звідси не можна. Приватні репозиторії позначені іконкою замка. Якщо потрібного репозиторію немає в списку, діалог показує: “The app has no repository access yet. Grant access on GitHub, then reopen this dialog.” — перейдіть за посиланням Manage repository access on GitHub, надайте доступ і знову відкрийте діалог.
3. За бажанням заповніть поле Target directory папкою всередині репозиторію, наприклад addons/. Якщо залишити поле порожнім, модуль потрапить у корінь репозиторію — в обох випадках він потрапляє у власну папку, названу на честь модуля.
4. Виберіть Open pull request.

Що робить надсилання

OdoMate ніколи не комітить у гілку, з якою ви вже працюєте, і ніколи не торкається гілки репозиторію за замовчуванням напряму. Кожне надсилання:

• Створює нову гілку з назвою odomate/<module-name>-v<version> від гілки репозиторію за замовчуванням. Якщо така назва вже зайнята — наприклад, тому що ви вже надсилали цю версію раніше, — пробує -2, -3 і так далі, доки не знайде вільну.
• Комітить файли модуля в цю гілку з повідомленням feat: <module name> v<version> (generated by OdoMate).
• Відкриває пул-реквест із цієї гілки в гілку репозиторію за замовчуванням, із заголовком Add <module name> v<version> (OdoMate) і описом, що підсумовує модуль і посилається на його запис у бібліотеці модулів.

Коли надсилання завершується

Спливне повідомлення підтверджує Pull request opened із назвою гілки та посиланням View pull request прямо на GitHub. Картка модуля — і його рядок в історії версій — тоді також показує кнопку GitHub PR, що посилається на той самий пул-реквест.

Обережно

OdoMate пам’ятає лише останній пул-реквест для певної версії. Повторне надсилання тієї самої версії відкриває цілком новий пул-реквест, і кнопка GitHub PR перемикається на нього; попередній пул-реквест усе ще відкритий на GitHub, але OdoMate більше на нього не посилається.

Якщо щось пішло не так

Замість спливного повідомлення про успіх діалог повідомляє про помилку надсилання, не закриваючись:

• “The GitHub App was uninstalled. Reconnect to continue.” — див. про повторне підключення в підключення вашого облікового запису GitHub.
• “The app cannot access that repository. Grant it access on GitHub and try again.” — встановлення втратило доступ до цього конкретного репозиторію; скористайтеся посиланням Manage repository access on GitHub у діалозі.
• “That repository has no commits yet. Push an initial commit (e.g. a README) first, then retry.” — OdoMate будує свій коміт поверх наявної історії гілки за замовчуванням, тож у репозиторії вже має бути щонайменше один коміт.
• “The stored archive for this version has expired. Re-run the generation to refresh it.” — див. вікно зберігання в завантаження модуля.
• “GitHub is having trouble right now. Please try again in a moment.” — власний API GitHub був недоступний або обмежений за швидкістю; повторна спроба пізніше зазвичай усуває це.
• “The push failed. Please try again.” — загальний варіант для всього іншого, зокрема для неналаштованої інтеграції з GitHub на сервері. Повторна спроба не потребує від вас інших даних, але якщо помилка повторюється, у цьому діалозі більше нічого змінити не можна.