Посібник із Playground

Як користуватися Pyroom

Запускайте Python у браузері, готуйте завдання для класу, завантажуйте файли й бібліотеки, поширюйте роботу та знаходьте помилки через налагоджувач або ШІ-помічник.

Відкрити Playground

Початок роботи

Pyroom запускає Python прямо у браузері. Не потрібно створювати обліковий запис або встановлювати Python.

  1. Відкрийте Playground.
  2. Напишіть код Python у редакторі або завантажте наявний файл.
  3. Натисніть Старт (або F5) і перегляньте результат у консолі.

Режим учителя

Режим учителя додає панель завдання: учні бачать інструкції поруч зі стартовим кодом.

  1. Відкрийте меню Playground, виберіть Більше, а потім Режим вчителя.
  2. На панелі завдання вкажіть назву та опишіть роботу. Опис підтримує форматований текст і Markdown.
  3. Підготуйте стартовий код для учнів і поширте його за інструкцією нижче.

Блокування завдання

Через кнопку стану завдання або його налаштування можна заблокувати редагування, встановити PIN і ввімкнути Блокувати при поширенні.

Важливо: PIN зберігається лише на пристрої, де його створено. Захищене завдання, відкрите на іншому пристрої, буде доступне тільки для перегляду. Блокування захищає інструкцію, а не приховує розв'язок: Python-код у поширеному завданні бачать учні. Поширюйте стартовий код, а не готові відповіді.

Завантаження бібліотек Python

Стандартна бібліотека Python доступна одразу. Для пакетів на кшталт numpy, pandas і matplotlib відкрийте Меню → НалаштуванняНалаштування бібліотек.

  1. Введіть назву пакета, наприклад pandas.
  2. Натисніть Завантажити бібліотеку.
  3. Імпортуйте та використовуйте її у коді.
import pandas as pd
print(pd.DataFrame({"score": [8, 10, 9]}))

Якщо скрипт імпортує підтримуваний, але ще не готовий пакет, Pyroom також може запропонувати його завантажити. Завантажена онлайн бібліотека кешується для подальшої роботи офлайн.

Зверніть увагу: для першого завантаження потрібен інтернет. Не кожен пакет PyPI працює у браузері: пакети з нативними бінарними залежностями, процесами, потоками, сокетами чи реальною файловою системою можуть бути недоступні. Перегляньте список пакетів.

Поширення коду та завдань

Відкрийте Меню → ПоділитисьВідкрити діалог поширення. За потреби додайте назву завдання та автора, а потім виберіть спосіб поширення.

Коли використовуватиОберітьЩо отримають учні
Невелика програма або немає інтернетуОфлайн (QR)Повне посилання або QR-код; серверне зберігання не використовується.
Посилання для класу або довший кодОнлайнКоротке посилання, 8-символьний код, QR-код і готове повідомлення.
Вбудовування на сайт або в LMSПоділитись як iframeКод для вбудовування з налаштуваннями інтерфейсу.

Офлайн-поширення

Скопіюйте повне посилання або створіть QR-код. Для цього не потрібен сервер, але великий код може не поміститися у QR-код — тоді використайте посилання.

Онлайн-поширення

Виберіть термін дії та створіть посилання. Учні можуть відкрити коротке посилання або вибрати Меню → Поділитись → Введіть код доступу і ввести 8-символьний код.

Перед відкриттям поширення: Pyroom просить підтвердження, бо воно замінить поточний код. Спочатку експортуйте важливу роботу. Посилання містить код та дані завдання, але не додані файли ресурсів або кеш бібліотек.

Завантаження й збереження файлів

Файли з кодом Python

Відкрийте Меню → Імпорт файлу / Експорт файлуІмпорт файлу, щоб завантажити .py або .txt. Імпорт замінює код у редакторі. Виберіть Експорт файлу, щоб завантажити поточний код як .py.

Дані, зображення та ресурси

Відкрийте Меню → РесурсиДодати файли або Керувати ресурсами. Додайте один чи кілька файлів і читайте їх у Python за шляхом resources/.

with open("resources/my_file.txt", encoding="utf-8") as file:
    print(file.read())
Ресурси діють протягом сесії. Це не повна файлова система проєкту, і ресурси не потрапляють до посилання для поширення. Додайте їх знову після відкриття нової сесії або поширеного завдання. Для завантаження та запуску повного проєкту Tkinter використовуйте LaunchPad.

Покрокове налагодження

  1. Увімкніть налагоджувач кнопкою з жуком на панелі інструментів комп'ютера. На мобільному пристрої відкрийте Меню → НалагодженняУвімкнути відладчик.
  2. Поставте точку зупину: на комп'ютері клацніть номер рядка або поле ліворуч. На мобільному пристрої торкніться номера/поля рядка або довго натисніть рядок за ввімкненого налагоджувача.
  3. Запустіть програму — вона зупиниться на точці зупину.
  4. Перевірте підсвічений рядок і панель Змінні. Виберіть З коду для власних змінних або Всі для всіх видимих значень.
  5. Натисніть Крок вперед, щоб виконати наступну операцію, або Продовжити, щоб іти до наступної точки зупину чи завершення.
total = 0
for number in [2, 4, 6]:
    total += number  # Поставте тут точку зупину
print(total)
Точки зупину тимчасові й діють лише в поточній сесії редактора. Налагоджувач має «Крок вперед», але не має переходу всередину функції або повного стеку викликів. Для синтаксичних помилок чи збою до точки зупину спершу прочитайте traceback у консолі.

Пояснення помилок через ШІ-помічник

ШІ-помічник — експериментальний інструмент у браузері, який пояснює невдалі запуски Python зрозумілою мовою.

  1. Запустіть програму.
  2. Якщо вона завершується помилкою, натисніть ШІ-помічник у консолі.
  3. Прочитайте, що сталося, чому і яку зміну варто зробити.
  4. Внесіть зміни та запустіть код знову.

Якщо кнопки немає, відкрийте Меню → НалаштуванняUI & Plugins, увімкніть ШІ-помічник і повторно запустіть код.

Експериментальна можливість: під час першого використання може знадобитися інтернет для завантаження моделі у браузері; після кешування вона може працювати офлайн у підтримуваних випадках. Швидкість і доступність залежать від браузера та пам'яті пристрою. API-ключ не потрібен, але поради є навчальною допомогою, а не автоматичним виправленням — завжди перевіряйте та запускайте код повторно.