@htmlacademy/courses-task-checks

courses-task-checks

Модуль экспортирует функцию createTaskChecker() и объект Logger.

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

Функция createTaskChecker() принимает один параметр, объект с ключами:

• bin, содержит объект {compare: '/usr/bin/compare'}, где значение ключа compare указывает на расположение утилиты командной строки compare
• checks, содержит объект с ключами:
  • baseDir — каталог в котором будут расположены закешированные данные
  • storeFileName — как правило, содержит значение result.json, имя файла, куда будет сохранён результат
  • cacheFileName — как правило, содержит значение cache.json, имя файла-метки
  • baseUrl — базовый url для вычисления адресов картинок в испытаниях
  • logCliDir — каталог, в котором будут сохраняться логи серверных проверок. Если значение не передано, будет использоваться ./log/cli
• debug — по умолчанию имеет значение Logger.ERROR, управляет тем, что будет выводиться в лог. Чтобы изменить это значение, нужно проимпортировать объект Logger

Функция возвращает другую функцию, которая принимает на вход два параметра.

Первый параметр — объект с ключами:

• type — тип задания (html-css, html-css-challenge и т.д.)
• solutionOnly — используется для случаев, когда нужно получить только картинку с образцом для испытания
• code — код, приходящий от клиента. Это объект, имеющий ключи html, css, js и svg (от одного до трёх) со строковыми значениями (если solutionOnly имеет значение true, не нужен)
• goals — состояние целей, полученные с клиента. Для каждой цели приходит объект с ключом status и одним из значений: created, solved или answered (если solutionOnly имеет значение true, не нужен)
• solution — код решения задания. Присутствует не во всех типах заданий, может быть html или js кодом
• location — объект, который может быть передан из запускающей программы. Может содержать ключи:
  • dir — каталог, в котором будут сохраняться файлы
  • resultJson — путь к файлу, в который будет сохраняться результат (если файл не указан, предполагается, что сохранять его на диск не нужно)
  • cacheJson — путь к файлу, в который будет сохраняться отметка о запуске проверки
  • baseUrl — базовый путь, начиная от которого будут сохраняться картинки для испытаний
  • url — url, по которому можно будет получить результат

В случае, если ключ location не передан, каталог для сохранения данных вычисляется на основе checks.baseDir и md5-суммы полученного кода. В этом случае считается, что файлы result.json и cache.json нужно сохранять.

В случае, если ключ solutionOnly имеет значение true, достаточно передать type (или task.type) — тип задания и solution.

Второй параметр — колбэк, в который передаётся два параметра:

• Первый — текст ошибки, если она случилась
• Второй — результат проверки