День 15 · Контрольная точка 3: функции, тесты и репозиторий · страница 4 из 4

Контрольная точка 3

Восемь задач по блоку 3: свои функции, несколько результатов, error, разбиение задачи, тесты. По ним видно, какие темы осели. Блок 4 — срезы и карты — строится поверх функций: значения там начинают ходить между функциями пачками, и незасчитанная задача показывает, что повторить до него.

Задачи

Условие — в TASK.txt папки задачи, числа у каждого стажёра свои.

stagiaire@lab:~$ cd ~/gocourse/day15/kt1
stagiaire@lab:~/gocourse/day15/kt1$ cat TASK.txt
Контрольная точка 3. Задача 1 — тариф и цена одной функцией.

Программа читает вес посылок в граммах, по строке на посылку. Пустые
строки и строки из одних пробелов пропускаются, пробелы по краям числа
не мешают. Не чисел во вводе не бывает, отрицательных весов тоже.

Дальше в TASK.txt — что должна делать программа, главное требование задачи, примеры с вашими числами и как задача проверяется.

Как сдаётся

Всё проверяет course check 15. Отдельно сдаётся только ответ на задачу 8 — два числа через пробел вместо слова ЧИСЛА; отправить заново можно:

stagiaire@lab:~/gocourse/day15/kt8$ course answer day15.kt8 40 12
Принято: day15.kt8 = 40 12

Вместо 40 12 — два своих числа.

Программы с вводом (задачи 1–3) проверка запускает на наборе вводов. Первые случаи — примеры из TASK.txt, на них при расхождении видно и то, что было нужно. Остальные скрыты: видно только ввод и то, что напечатала программа.

  ✘  Задача 1 — тариф и цена функцией с двумя результатами
       Условие: cat ~/gocourse/day15/kt1/TASK.txt — проверьте границы тарифов.
       следующий уровень подсказки: course hint 15 kt1
         случай 4 из 11, ввод: 900
         строка 1, программа напечатала: «Посылка 1: средний, 230 руб.»

Нужный ответ решаете вы по правилам из TASK.txt. Проверка останавливается на первом неверном случае — после починки может всплыть следующий. В задаче 2 обычный вывод, поток ошибок и код возврата сверяются отдельно, и проверка называет, что именно не совпало.

Задачи 1 и 2 дополнительно смотрят на устройство программы, а не только на вывод: функция, про которую задача, должна быть не только объявлена, но и вызвана, и её результаты приняты в переменные. В задаче 2 проверяется ещё, что ошибка именно возвращается: os.Exit и печать в поток ошибок — в main, а не внутри функции разбора. Мёртвая функция-заглушка рядом с расчётом в main зачёта не даёт.

Задача 3 дополнительно считает свои функции и строки тел: в main не больше 32 строк, своих функций не меньше трёх, и ни одна функция не длиннее 20 строк. Пустые func x() {} и функции, которых никто не вызывает, за свои не считаются, а весь main, переложенный в одну функцию, — это та же простыня. Вывод при этом обязан остаться прежним — это и есть смысл задачи. Эти числа — не правило «функция не длиннее N строк», которого в курсе нет (день 13, страница 1): это порог, которым проверка отличает разрезанную программу от переложенной. Внутри порога длина не оценивается.

Ваши тесты (задачи 4 и 5) проверяются подменой. Сначала go test запускается на вашей работе — он обязан пройти. Потом проверка берёт копию каталога, подменяет в ней реализацию заведомо неверной и запускает ваш тест ещё раз — теперь он обязан упасть. Ваши файлы при этом не трогаются.

  ✘  Задача 4 — свой тест на orderCost ловит подмену
       Тест проходит и на заведомо неверной программе — значит, он ничего не проверяет. Добавьте случай, на котором ошибка видна, и сравнивайте результат с ожидаемым.
       следующий уровень подсказки: course hint 15 kt4

Вторая подмена — другая запись той же логики: функция считает ровно то же самое, но другими строками. На ней ваш тест обязан пройти. Тест, который вместо результата вызова разглядывает текст cost.go или fee.go, на такой подмене падает и зачёта не получает.

  ✘  Задача 5 — табличный тест на packFee ловит подмену на границе
       Тест падает на другой записи той же логики: он проверяет не поведение функции, а её текст или окружение. Сравнивайте результат вызова с ожидаемым.
       следующий уровень подсказки: course hint 15 kt5

В задаче 5 подмена отличается от верной функции ровно на границе бесплатной упаковки: таблица без случая «ровно на границе» её не заметит. Реализации (cost.go, fee.go, limits.go) менять не нужно — проверка сверяет их с оригиналом.

Задача 6 проверяется скрытым авторским тестом: в нём другие числа, чем в stock_test.go. Файл stock_test.go менять нельзя, в stock.go можно изменить не больше двух строк — чинят программу, а не тест.

Таблица в kt7 сверяется целиком: одна неверная клетка — задача не засчитана, и какая именно, проверка не говорит. Правила таблицы — те же, что весь курс: новых правил контрольная не вводит, действуют правила 1–24. Все двадцать четыре собраны списком в памятке блока 3 — course page 15 2, раздел «Трассировка: правила 1–24»; держите его открытым рядом. Для вызовов главные — 16–20, и самое забываемое из них — правило 18: строка заголовка функции тоже шаг.

kt7/main.go и kt8/main.go менять не нужно: номера строк в таблице и ответ на задачу 8 считаются по тем файлам, какие положил стенд, — проверка сверяет их с оригиналом. Отладочная печать — в копии в scratch.

Коммиты

Работа дня должна лежать в репозитории ~/gocourse/day15: не меньше восьми коммитов — начальные плюс по одному на задачу. Это отдельный пункт дня, в контрольную точку он не входит, но на порог дня влияет.

  ✘  Работа дня лежит в репозитории ~/gocourse/day15 (коммитов: 3, нужно от 8)

Порог и пересдача

Задача засчитана целиком или не засчитана. Порог — 6 задач из 8. Итог по точке на пустом стенде:

--- контрольная точка 3 ---
Задач сдано: 0 из 8. Порог — 6. Пересдача — доделайте задачи и повторите course check 15.

День закрывается при трёх условиях: сдано 10 пунктов из 13 — ритуал перед коммитом и задачи вместе; точка взята; сданы контрольные вопросы. Без точки день не закроется при любом числе пунктов:

Контрольная точка не взята: 5 из 8 при пороге 6.
День не закрыт: пункты контрольной обязательны.

Когда пункты и точка сданы, проверка отправит к course quiz 15; после вопросов — ещё раз course check 15.

Пересдача — повторный course check 15, попыток сколько угодно. Между проверками — не меньше 15 секунд, каждая попытка пишется в ~/.course/checks. Свой прогон — go test . и примеры из TASK.txt — быстрее паузы.

Подсказки и время

course hint 15 kt3 работает и на контрольной. Третий уровень — готовое решение, он попадает в отчёт: задача засчитается, но тему, которая не осела, уже не покажет. Застряли — по порядку: перечитать TASK.txt; прогнать примеры или написать тест на спорный случай; памятка; двадцать минут своей отладки; только потом первый уровень подсказки.

На контрольную заложите около трёх часов. Первые десять минут прочитайте все восемь TASK.txt. Начните с задач, в которых уверены. Получас на задачу — это не норма, а сигнал: просидели над одной полчаса без движения — отложите её и берите следующую, вернётесь потом. course check 15 — после каждой решённой задачи, и коммит.

Что может пойти не так

Материал дня закончен. Задания — course lab 15, дополнительное чтение — course extra 15