ПРАКТИЧНИЙ ПОСІБНИК / 01
Від джему —до власногопроєкту.
Як створювати, перевіряти та публікувати код у PITMA.
Переглянути пояснення — перший крок. Наступний — застосувати ідею у власному коді.
У PITMA ти можеш створити проєкт на основі джему, написати й запустити код у Google Colab, отримати рев’ю від інших учасників та додати завершену роботу до свого портфоліо. Ця інструкція проведе тебе через увесь процес.
Твій шлях: обрати джем → створити проєкт → підготувати й перевірити код → надіслати на рев’ю → опрацювати зауваження → завершити проєкт → за бажанням опублікувати на GitHub.
Обери джем та ідею для реалізації
Відкрий розділ «Джеми» й знайди тему, яку хочеш спробувати на практиці. Переглянь джем і зверни увагу на приклади та матеріали.
Не обов’язково одразу створювати великий застосунок. Почни з конкретного результату: побудуй графік на власних даних, реалізуй алгоритм із пояснення або перевір, як модель поводиться з іншими параметрами.
Коли визначишся, натисни «Винести в проєкт» біля відповідного джему.
ДжемиПроєктиСпільнотаНАВЧАЛЬНИЙ ПРИКЛАДФункції
Від повторюваного коду до власних функцій. Розбери параметри, повернення значень та декомпозицію задач.
Створи проєкт
На наступному екрані вкажи назву проєкту. Краще назвати його за результатом, який плануєш отримати: наприклад, «Візуалізація щомісячних продажів» або «Класифікація текстів за допомогою sklearn».
Перевір пов’язаний джем і завдання, а потім натисни «Створити проєкт».
До відкриття Pull Request проєкт бачиш лише ти. Після надсилання рішення на рев’ю код стане доступним іншим учасникам для перевірки.
Якщо ти вже створював проєкт для цього джему, PITMA відкриє наявний.
ДжемиПроєктиСпільнотаНАВЧАЛЬНИЙ ПРИКЛАДВинести в проєкт
Від джему — до власної реалізації. Твій код, один Pull Request і рев’ю спільноти в одному місці.
Python для Data Science
Пов’язане завдання доступне в робочому просторі проєкту.
До відкриття Pull Request проєкт бачиш лише ти.
Створити проєктОзнайомся з робочим простором
У проєкті є кілька вкладок:
- «Завдання й код» — тут ти готуєш реалізацію та пояснюєш своє рішення.
- «Pull request» — тут відбувається перевірка: обговорення, перегляд змін і висновки рев’юерів.
- «Матеріали» — матеріали, які допомагають працювати над проєктом.
- «Обговорення» — запитання та обмін ідеями навколо проєкту. Цей розділ стає доступним після надсилання на рев’ю.
Щоб повернутися до джему, скористайся посиланням «Джем і матеріали».
ДжемиПроєктиСпільнотаНАВЧАЛЬНИЙ ПРИКЛАДВізуалізація щомісячних продажів
Джем і матеріали
Твоя реалізація
Підготуй код, перевір результат і поясни своє рішення.
import matplotlib.pyplot as plt
months = ["Січ", "Лют", "Бер", "Кві", "Тра"]
sales = [12, 18, 15, 28, 36]
plt.plot(months, sales, marker="o")
plt.title("Продажі за місяцями")
plt.show()Напиши та запусти код
На вкладці «Завдання й код» можна обрати один із двох способів роботи.
Через Google Colab
Google Colab дає змогу писати й запускати Python у браузері, працювати з бібліотеками, переглядати графіки та результати обчислень.
Щоб почати:
- Обери вкладку «Google Colab».
- Якщо це перше підключення, натисни «Підключити Google Drive» та пройди авторизацію Google.
- Натисни «Відкрити у Colab».
- Працюй у відкритому ноутбуці: додавай код, запускай комірки й перевіряй результати.
Під час першого відкриття PITMA створить ноутбук у твоєму Google Drive на основі поточного коду проєкту. Наступні відкриття ведуть до цього ж ноутбука.
У редакторі PITMA
Якщо хочеш підготувати код без переходу до Colab, обери «Редактор Python».
Тут можна редагувати реалізацію, але PITMA не запускає код. Перед надсиланням платформа перевіряє синтаксис Python; роботу алгоритму та результати потрібно перевірити самостійно — наприклад, у Colab або на своєму комп’ютері.
ДжемиПроєктиСпільнотаНАВЧАЛЬНИЙ ПРИКЛАДВізуалізація щомісячних продажів
Джем і матеріали
Твій ноутбук у браузері.
Пиши код, запускай комірки, перевіряй результат.
PITMA ↔ GOOGLE COLABПеренеси результат із Colab у PITMA
Коли код готовий:
- Запусти потрібні комірки в Colab і перевір результат.
- Збережи ноутбук через Ctrl+S / Cmd+S та дочекайся завершення збереження.
- Повернися до проєкту в PITMA.
- Натисни іконку з круговими стрілками. При наведенні вона має підказку «Синхронізувати».
- Переглянь імпортований код і результати.
Синхронізація переносить у PITMA збережену версію ноутбука. Якщо після цього ти щось змінив у Colab, знову збережи ноутбук і натисни «Синхронізувати».
Рев’юер побачить імпортовану версію безпосередньо в PITMA: код, пояснення та підтримувані результати, зокрема текст і графіки. Інтерактивні віджети й деякі інші формати виводу можуть не переноситися.
Перед надсиланням переконайся, що в коді та результатах немає паролів, API-ключів або приватних даних.
ДжемиПроєктиСпільнотаНАВЧАЛЬНИЙ ПРИКЛАДВізуалізація щомісячних продажів
Джем і матеріали
Версію імпортовано. Переглянь код і результати перед надсиланням на рев’ю.
import matplotlib.pyplot as plt
months = ["Січ", "Лют", "Бер", "Кві", "Тра"]
sales = [12, 18, 15, 28, 36]
plt.plot(months, sales, marker="o")
plt.title("Продажі за місяцями")
plt.show()Поясни рішення та надішли його на рев’ю
У полі «Що зроблено» коротко поясни:
- яку ідею джему ти реалізував;
- як працює рішення;
- на яких прикладах ти його перевірив;
- який результат отримав і які обмеження помітив.
Наприклад:
Реалізував функцію побудови графіка продажів за місяцями. Вона приймає список місяців і відповідні значення, перевіряє однакову довжину списків та будує графік. Перевірив звичайні дані, нульові значення й порожній список.
Після цього натисни «Надіслати на рев’ю».
PITMA перевірить синтаксис Python. Якщо перевірка знайде помилку, виправ її та надішли рішення повторно. Якщо синтаксис коректний, відкриється Pull Request, а робота потрапить у чергу на перевірку спільнотою.
Pull Request, або PR, — це твоя версія рішення, яку ти пропонуєш перевірити перед завершенням проєкту.
Позначка Checks passed означає, що автоматична перевірка пройшла успішно. Правильність рішення ще має оцінити рев’юер.
ДжемиПроєктиСпільнотаНАВЧАЛЬНИЙ ПРИКЛАДВізуалізація щомісячних продажів
Джем і матеріали
import matplotlib.pyplot as plt
months = ["Січ", "Лют", "Бер", "Кві", "Тра"]
sales = [12, 18, 15, 28, 36]
plt.plot(months, sales, marker="o")
plt.title("Продажі за місяцями")
plt.show()Отримай рев’ю та опрацюй зауваження
На вкладці «Pull request» можна переглянути обговорення, зміни в коді через Files changed та, якщо ти працював у Colab, збережену версію у вкладці «Ноутбук».
Рев’юер може перевірити код у PITMA, а за потреби — відкрити власну копію ноутбука в Colab і запустити її.
Після перевірки можливі два висновки:
- Approve — рев’юер схвалив поточну версію.
- Request changes — рев’юер просить внести зміни та пояснює, що саме потрібно виправити.
Якщо отримав запит на зміни:
- Прочитай зауваження й за потреби уточни їх в обговоренні PR.
- Повернися до «Завдання й код».
- Виправ рішення. Якщо працюєш у Colab — збережи ноутбук і синхронізуй його з PITMA.
- Онови пояснення: напиши, що змінилося.
- Повторно натисни «Надіслати на рев’ю».
У PR з’явиться нова версія. Висновки щодо попередньої залишаться в історії, але нову версію потрібно перевірити знову.
Поки поточна версія очікує рев’ю, повторне надсилання недоступне. Наступну версію можна подати після запиту на зміни.
ДжемиПроєктиСпільнотаНАВЧАЛЬНИЙ ПРИКЛАДВізуалізація щомісячних продажів
Джем і матеріали
Графік продажів #a12b34
Open Автор пропонує зміни sales · v1 → main
Збережено версію v1Додав функцію побудови графіка та приклад її використання.
Рев’юер · Requested changes · v1Перевір випадок, коли списки місяців і продажів мають різну довжину. Додай перевірку до побудови графіка.
Checks passed
Заверши проєкт через Merge
Для завершення поточної версії потрібні:
- успішна перевірка синтаксису;
- щонайменше один Approve;
- відсутність запитів на зміни для цієї версії.
Коли умови виконані, тобі як автору стане доступна кнопка «Merge pull request».
Натисни її, щоб прийняти перевірену реалізацію як завершену версію проєкту. Статус зміниться на Merged, а робота з’явиться в «Реалізаціях спільноти» та серед реалізацій у твоєму PITBOOK.
Історія обговорення й рев’ю залишиться в проєкті.
ДжемиПроєктиСпільнотаНАВЧАЛЬНИЙ ПРИКЛАДВізуалізація щомісячних продажів
Джем і матеріали
Графік продажів #a12b34
Open Автор пропонує зміни sales · v2 → main
Збережено версію v2Додав перевірку довжини списків і обробку порожніх даних.
Рев’юер · Approved · v2Перевірив звичайні дані, порожній список та списки різної довжини. Результати коректні.
Checks passed
Опублікуй прийнятий код на GitHub
Після Merge можна натиснути «Опублікувати на GitHub».
У вікні публікації:
- Вкажи назву репозиторію.
- За бажанням додай опис.
- Обери видимість: Public або Private.
- Якщо потрібно, підключи GitHub і надай запитаний дозвіл.
- Заверши публікацію кнопкою «Створити репозиторій».
PITMA експортує прийнятий Python-код у форматі .py, README та файл залежностей. Навіть якщо ти працював у Colab, на GitHub публікується код, а не ноутбук.
Експортується версія після Merge. Подальші зміни в GitHub автоматично не повертаються до PITMA.
Цей крок необов’язковий: завершена реалізація вже доступна на платформі.
ДжемиПроєктиСпільнотаНАВЧАЛЬНИЙ ПРИКЛАДТвій код.
Твій GitHub.
Прийнята реалізація, README та залежності — у власному репозиторії.
sales.py
README.md
requirements.txtТакож можна обрати Private — приватний репозиторій.
Створити репозиторійЕкспортується версія після Merge. Подальші зміни в GitHub не синхронізуються з PITMA.
Спробуй себе в ролі рев’юера
У PITMA ти можеш не лише отримувати зворотний зв’язок, а й допомагати іншим.
Відкрий «Проєкти» → «Потрібне рев’ю» та обери роботу, тему якої розумієш.
Якщо ще не перевіряв проєкти, натисни «Стати рев’юером» і пройди три короткі запитання. Після успішного проходження можна брати PR на перевірку.
У чужому відкритому PR натисни «Взяти на рев’ю», переглянь рішення та перевір:
- чи відповідає код заявленій ідеї;
- чи працює він на звичайних і граничних прикладах;
- чи зрозумілі назви, структура та пояснення;
- чи відповідають показані результати реалізації.
Для роботи з ноутбуком скористайся кнопкою «Запустити свою копію». Якщо Google Drive ще не підключений, платформа запропонує його підключити.
Потім обери Approve або Request changes, напиши конкретний висновок і натисни «Надіслати рев’ю».
Замість «усе добре» краще написати: «Запустив приклад із джему та перевірив порожній список. Результати коректні, повідомлення про помилку зрозуміле». Якщо знайшов проблему — додай приклад, на якому її можна відтворити.
Власний проєкт схвалити не можна: його перевіряє інший учасник.
ДжемиПроєктиСпільнотаНАВЧАЛЬНИЙ ПРИКЛАДГрафік продажів #a12b34
Open Проєкт іншого учасника · версія v2
Перевір відповідність завданню, граничні випадки, читабельність коду та пояснення автора.
Почни з однієї невеликої реалізації. Обери джем, перевір ідею на власному прикладі та надішли результат на рев’ю. Так у твоєму PITBOOK з’являтимуться роботи, за якими можна побачити твій код, підхід до розв’язання задач і вміння працювати зі зворотним зв’язком.