Категории

Домашние задания

Настройка окружения

Часть проблем, с которыми сталкиваются студенты при выполнении домашних заданий, с самими заданиями никак не связана. Приводит к ним неправильная настройка окружения. Примеры таких проблем:

  • Ваша учетная запись на Хекслете подтверждена
  • «кракозябры» из-за имени пользователя на русском языке
  • несовместимость софта с системой нативно (например, Docker под Windows или МacOS)
  • ошибки при построении путей к каталогам
  • программа не запускается из-за некорректно прописанных путей в PATH.

Мы рекомендуем работать в *nix-системах, так как они наиболее совместимы с софтом, который вы будете изучать и применять при выполнении домашних заданий. Если вы уже используете Linux или Mac — отлично. Ознакомиться с рекомендуемыми требованиями к компьютеру и ОС можно в этой статье.

Либо если вы работаете в Windows 10 или старше, установите WSL (Windows Subsystem for Linux) или разверните виртуальную машину в VirtualBox. Это позволит получить все преимущества Linux без установки отдельной системы.

Пройдите курс по настройке окружения на Хекслете и настройте систему в соответствии с ним. Для каждого языка программирования это свой курс, его можно найти в соответствующей профессии.

Краткие инструкции по установке языков программирования мы сохранили в репозитории.

Для настройки вам понадобятся навыки работы с терминалом и Git. Получить их помогут наши бесплатные курсы:

Настройка утилиты Hexlet CLI

Чтобы упростить и автоматизировать работу с домашними заданиями, мы написали утилиту hexlet/cli. С её помощью можно связать аккаунты студента на Хекслете и на GitHub, создать репозиторий для сохранения решений и скачать домашние задания со всеми необходимыми файлами.

Чтобы ей воспользоваться:

  1. Установите Node.js по инструкции.
  2. Установите hexlet/cli командой npm install -g @hexlet/cli

Работа над домашними заданиями происходит на компьютере студента.

Для каждого домашнего задания мы подготовили отдельный набор файлов. Обычно в нем содержится:

  • Текст задачи (файл README.md)
  • Тесты кода
  • Линтер
  • Описание зависимостей
  • Пустой файл, в который студент запишет свое решение

Команды в утилите Hexlet CLI

Утилита вызывается по имени hexlet, и содержит несколько команд:

  • assignments init — создает репозиторий с именем hexlet-assignments в профиле студента на GitHubВ этот репозиторий будут отправляться все домашние задания, которые вы выполняете на Хекслете, независимо от учебной программы. Для всех учебных программ репозиторий будет один. Имя hexlet-assignments для репозитория должно быть свободно. Одновременно с созданием репозитория команда assignments init совершает еще два действия:
    • Создает конфигурационный файл
    • Создает директорию Hexlet/hexlet-assignments в домашней директории на компьютере студента
  • assignment download — скачивает домашнее задание

    Эта команда обращается к общей директории Hexlet/hexlet-assignments и создает там новые файлы:
    • Поддиректорию с именем курса
    • Поддиректорию с домашним заданием
      • Теперь там будет храниться все необходимое для домашнего задания: файлы для решения, текст задачи, тесты, линтер и прочее. То же самое можно сделать и без команды: надо зайти на страницу домашней работы, найти ссылку на нужное задание и скачать его.
  • assignment submit — отправляет текущее домашнее задание в репозиторий на GitHub

    Выполненное задание нужно отправить на проверку — именно это и делает команда submit. Она выполняется из локальной директории домашней работы и пушит в ваш удаленный репозиторий все файлы, связанные с текущим заданием. Когда решение студента готово, тесты и линтер локально пройдены, то можно выполнить submit. На GitHub также подключены тесты и линтер.
  • assignment reset — скачивает новую версию домашнего задания.

    Если уже во время выполнения домашнего задания появляется новая версия упражнения, нужно выполнить reset, чтобы повторно скачать ее.

Команды assignment download и assignment reset создают резервную копию домашнего задания, над которым идет работа. Если выполнить команду assignment reset или assignment download, то проделанная работа не потеряется. Старая версия с вашими наработками сохранится в новой директории с текущими датой и временем в названии.

Аргументы

У команд assignment download и assignment reset есть аргумент lesson-url. Ниже мы покажем, как он используется и где взять нужные значения:

  • lesson-url — адрес урока с домашним заданием. Можно взять его из адресной строки урока или скопировать уже готовую команду для скачивания на странице домашнего задания

Опции

  • --github-token – Personal access token из GitHub
  • --hexlet-token – Ваш персональный токен Хекслета

Использование

Перед тем, как начать работу с домашним заданием, нужно выполнить инициализацию проекта. Это можно сделать с помощью команды hexlet assignments init. У нее есть несколько опций:

  • --github-token – Обязательная. Personal access token (classic) из GitHub. Создайте свой Personal access token (classic) здесь. При создании токена сделайте его бессрочным и проставьте разрешения на repo и workflow

  • --hexlet-token – Обязательная. Ваш персональный токен Хекслета. Этот токен автоматически подставлен в команду на странице домашнего задания
  • --hexlet-dir – Необязательная. Директория, в которую будут скачиваться домашние задания. По умолчанию это будет директория Hexlet в вашей домашней директории

Перейдите на страницу домашней работы, которую нужно скачать. На странице по ссылке «Инициализация утилиты» идентификатор hexlet-token уже подставлен в команду для инициализации:hexlet assignments init --hexlet-token=<your hexlet="" token=""> --github-token=<token from="" github=""> </token></your>

Для инициализации проекта остаётся скопировать команду, вставить свой Personal access token (classic) из GitHub и выполнить ее:
# Можно вызывать из любого каталога
hexlet assignments init --hexlet-token=<your hexlet token> --github-token=<token from github> 


Инициализацию нужно выполнить один раз перед скачиванием первой домашней работы. Если потребуется изменить расположение локальной директории с домашними работами или восстановить настройки и конфиг локального репозитория, инициализацию нужно выполнить повторно.
Далее можно переходить к выполнению домашней работы. Для команд  assignment download и assignment reset аргументом нужно указать адрес урока с домашним заданием. Адрес урока можно скопировать из адресной строки. Также вы можете взять уже готовую команду на скачивание со страницы домашнего задания:
# Эта команда скачивает на компьютер домашнее задание с указанным lesson-url
hexlet assignment download <https://ru.hexlet.io/courses/java-collections/lessons/lists/assignment_unit>


# Если во время выполнения появилась новая версия
# Эта команда скачивает новую версию домашнего задания
# Предыдущую версию и ваши наработки она скопирует в новую директорию

hexlet assignment reset <https://ru.hexlet.io/courses/java-collections/lessons/lists/assignment_unit>


Команда assignment submit выполняется без аргументов из директории выполненного домашнего задания или любой его поддиректории:
# Отправляет выполненное домашнее задание на GitHub
# Выполняются команды git add, commit, push
hexlet assignment submit


Если вы хотите вспомнить весь список актуальных команд, можно вывести справочную информацию:
hexlet assignments --help


hexlet assignment --help</code><code>


Что-то не работает
Если возникают ошибки, убедитесь, что:
  • Персональный токен GitHub имеет необходимые разрешения. Если после отправки домашнего задания при помощи команды submit проверка на GitHub не начинается, проверьте, что токен имеет разрешение на запуск workflow.
  • Вы используете *nix-систему. В Windows (не считая WSL) могут быть такие проблемы: «кракозябры» в именах файлов, неправильный путь к домашнему каталогу, конфликты софта и пр. Если у вас Windows, установите Linux или настройте WSL.
  • У вас есть права администратора в операционной системе. Если какая-то команда возвращает ошибку доступа (permission denied), должна быть возможность выполнить её от имени администратора. Например, sudo в Linux.
  • Установлена актуальная версия hexlet/cli. Мы регулярно исправляем ошибки и дорабатываем утилиту, после обновления старая версия может перестать работать. В таком случае установите утилиту заново.
  • В командах утилиты нет опечаток. Сравните команды с теми, которые написаны в документации и внутренней справке утилиты, и если что-то не так — просто исправьте команду и попробуйте снова.
  • Провайдер разрешает запросы ко всем необходимым ресурсам. В вашем регионе могут быть заблокированы некоторые ресурсы, необходимые для работы с домашними заданиями, например, GitHub, и другие. Если есть ограничения, настройте VPN для всех приложений, не только в браузере — это может помочь.
  • Установите hexlet/cli командой npm install -g @hexlet/cli
  • Если ни один из пунктов выше вам не помог, то напишите в чат группы в Mattermost, наставник поможет вам разобраться.