Тема 1 из 6

Установка

До сих пор код из уроков выполнялся прямо в браузере. Но многие библиотеки так не работают: arcade нужен ваш компьютер — настоящие окна, клавиатура, звук или доступ в интернет. Поэтому этот курс работает по-другому — код запускается на вашем компьютере, а сайт показывает задания и проверяет результат.

Задачи здесь устроены как в CodinGame: вам дают готовую работающую программу, в которой что-то сломано. Менять можно только подсвеченный участок — нужно понять, как устроен код вокруг, и починить его.

Настройка делается один раз и займёт минут 15.

1. Установите Python

Windows

  1. Откройте python.org/downloads и скачайте последнюю версию Python 3.
  2. Запустите установщик. Обязательно поставьте галочку «Add python.exe to PATH» внизу первого окна, затем нажмите «Install Now».
  3. Откройте «Командную строку» или PowerShell (Пуск → введите cmd) и проверьте:
py --version

Должно появиться что-то вроде Python 3.12.4. На Windows команда py надёжнее, чем python: она всегда находит установленный Python.

macOS

  1. Скачайте установщик с python.org/downloads и установите его.
  2. Откройте «Терминал» и проверьте: python3 --version.

На macOS команда называется python3 (а не python). В примерах ниже подставляйте её.

Linux

Python обычно уже установлен. Проверьте python3 --version. Если нужна установка: sudo apt install python3 python3-pip (Ubuntu, Debian) или аналог для вашего дистрибутива.

2. Выберите редактор кода

Писать код можно в любом текстовом редакторе, но удобнее в IDE — редакторе с подсветкой, подсказками и кнопкой запуска.

Редактор Кому подходит
VS Code Рекомендуем: бесплатный, быстрый, подходит для любых языков
PyCharm Community Мощная IDE только для Python, тяжелее, но всё «из коробки»
Thonny Самый простой, создан для начинающих, Python уже внутри

Настройка VS Code

  1. Скачайте с code.visualstudio.com и установите.
  2. Слева откройте «Расширения» (значок из четырёх квадратиков), найдите Python от Microsoft и установите.
  3. «Файл → Открыть папку» — создайте папку для уроков, например codewithme.
  4. Создайте файл hello.py с текстом print("Привет!").
  5. Нажмите ▶ в правом верхнем углу. Внизу откроется терминал, и в нём появится Привет!.

Если VS Code спросит, какой Python использовать (Select Interpreter), выберите установленную версию Python 3.

3. Установите arcade

Библиотеки ставятся программой pip. В терминале (в том числе внутри VS Code: «Терминал → Создать терминал») выполните:

py -m pip install arcade

На macOS и Linux: python3 -m pip install arcade.

Проверьте, что всё установилось: py -c "import arcade; print('ok')".

Частые проблемы:

  • «py / python не является внутренней или внешней командой» — при установке не стояла галочка PATH. Запустите установщик снова, выберите «Modify» и включите «Add Python to environment variables».
  • «pip не найден» — используйте форму py -m pip …, а не просто pip ….
  • Ошибка прав доступа — добавьте --user: py -m pip install --user arcade.
  • Библиотека «установлена», но не импортируется — у вас несколько версий Python. Ставьте командой py -m pip, а запускайте той же py.

4. Запустите мост CodeWithMe

Мост — маленькая программа на Python, которая связывает сайт с вашим компьютером: сайт присылает ей код задания, она запускает его вашим Python и возвращает результат.

  1. Скачайте файл cwm_bridge.py (19.6 КБ) в папку с уроками. Это обычный текстовый файл на Python — его можно открыть и прочитать. Контрольная сумма SHA-256: c204827d526040c559c5e0ffaa01ed911b03742c6529070af03dda72ae4a288a.
  2. В терминале перейдите в эту папку и запустите:
py cwm_bridge.py
  1. Мост напишет код из 6 цифр. Откройте любую задачу курса и введите его в поле «Код из окна моста».
  2. Браузер может спросить, разрешить ли сайту доступ к устройствам в локальной сети — нажмите «Разрешить»: так сайт достучится до моста на вашем же компьютере.

Пока окно моста открыто, задачи можно запускать и отправлять. Закончили заниматься — закройте окно или нажмите Ctrl+C. После перезапуска мост покажет новый код.

Насколько это безопасно

  • Мост принимает запросы только со страниц codewithme.app и только с вашего компьютера — другие сайты и другие устройства в сети к нему подключиться не могут.
  • Без кода из окна моста запустить ничего нельзя. После 5 неверных кодов мост перестаёт принимать попытки.
  • Сайт может передать только программу задания и входные данные. Каждый запуск виден в окне моста.
  • Мост не «песочница»: программа работает с вашими правами — так же, как если бы вы запустили её сами. Поэтому держите мост включённым, только пока занимаетесь.

Рекомендуемые браузеры — Chrome, Edge, Яндекс Браузер или Firefox.

5. Кнопки в задачах

  • Запустить у себя — запускает программу на вашем компьютере; в курсах про игры откроется окно игры. Остановить можно кнопкой «Стоп».
  • Отправить — проверка тестами: программа запускается несколько раз без окна, и сайт сравнивает результаты с правильными.
  • Скачать файл — вся программа файлом: можно открыть её в VS Code, поэкспериментировать и разобраться.

Чтобы убедиться, что всё работает, решите проверочную задачу этой темы.