Тесты правил: таблицы кейсов

Каркас собирается из трёх деталей: срез кейсов, цикл с t.Run и сверка. Каждый кейс — структура с четырьмя полями: name для отчёта, in — кандидат, wantField и wantTag — ожидаемая пара; пустая пара означает «ошибки не ждали». В цикле validate.Struct исполняет теги над кандидатом, дальше развилка: ошибок нет и пара пустая — кейс зелёный; ошибка есть — errors.As вытаскивает ValidationErrors, и первая запись сверяется по Field() и Tag(). Сверка по обоим значениям принципиальна: Field() защищает от тега на чужом поле, Tag() — от снесённого правила, и обе ловушки остаются незамеченными при проверке одного только err != nil. Имя кейса — не украшение, а инструмент: провалившийся t.Run называет сценарий словами, и его цитируют в баг-репорте. Правило роста: новый тег — новая строка таблицы, а не новый тест-файл; правило поменяли — меняется ожидание в строке; правило снесли — таблица краснеет, и это ровно то, что нужно. И никакого переиспользования кандидатов: каждый кейс собирает свежую структуру, иначе независимые кейсы становятся зависимыми от порядка исполнения, а зависимость от порядка — самый дорогой баг тестового набора.

Сравнивайте Field() и Tag(), а не текст Error(). Текст принадлежит слою сообщений: каталог русских текстов из шестого урока переписывает формулировки, локализация меняет язык целиком — тест на текст сломается при первой правке стиля, тест на Tag() переживёт всё, потому что это имя правила, а не формулировка. Уточнение для алиасов: Tag() возвращает имя, под которым правило зарегистрировано, — если свой тег из десятого урока живёт под именем slug, тест ждёт slug; ActualTag() понадобится, когда алиас разворачивается в цепочку встроенных правил, и нужно имя исходного. Param() иногда стоит зафиксировать тоже: min=8 даёт параметр «8», oneof — перечень значений; строка таблицы с ожидаемым параметром ловит не только снесённое правило, но и переписанное условие, когда правило формально живо, а договор уже другой. И всегда конкретное поле: Field() в сверке — страховка от «тег тот же, но поле переехало», когда после рефакторинга min проверяет ник вместо пароля, а зелёный тест не замечает подмены. Сообщения, согласование числительных, RegisterTagNameFunc — всё это проверяется слоем каталога отдельно, и его тесты сравнивают строки сознательно: там текст и есть контракт. Разделение простое: тесты правил держат имена правил, тесты сообщений — формулировки, и смешивать их в одной таблице не стоит.

Таблица обязана содержать четыре рода кейсов. Первый — граница: min=5 проходит на значении ровно пять, границы включительные, и строка «на границе» отличает нестрогое правило от строгих gt и lt. Второй — пустота: пустая строка при required падает, строка из пробелов проходит — required проверяет не-нулевость, и эта нестрогость из урока про нормализацию заслуживает собственного кейса, потому что её иначе не увидишь. Третий — nil и omitempty: указатель nil под omitempty проходит все правила, omitempty глушит их на нулевом поле — кейс с nil фиксирует, что пустота легальна, а указатель на строку из ста одного символа падает на max; пара кейсов не даст снести omitempty при рефакторинге незаметно. Четвёртый — dive: срез тегов, где ломается второй элемент. Правила после dive исполняются по элементам слева направо, ошибки приезжают отдельными записями, и Field() вернёт имя с индексом — Tags[1], то есть запись относится именно ко второму элементу. Кейс, где первая строка валидна, а вторая — нет, ловит ровно поэлементность: без него тест не отличит проверку контейнера от проверки элементов — с этой путаницы начинался восьмой урок, и кейс с индексом — его прямое продолжение в тестах. Четыре рода кейсов — минимальный алфавит таблицы: правило, прошедшее только «счастливый путь», не тестировано вовсе.

Свой тег из десятого урока тестируется в два слоя. Первый — предикат: чистая логика выносится из функции-обёртки в обычную функцию validSlug(s string) bool, и таблица гоняет её напрямую — без reflect, FieldLevel и валидатора; границы, пробелы, пустота — всё в маленькой таблице ожиданий. Второй — проводка: структура с тегом slug, validate.Struct, стандартная сверка Field() и Tag() — так проверяется, что регистрация случилась и правило подключено к полю. Ошибка «функция считает не то» и ошибка «тег не зарегистрирован» диагностируются раздельно, и каждая лечится в своём месте: первая — правкой логики, вторая — правкой регистраций. Тот же подход переносится на StructLevel из одиннадцатого урока: структурное правило тестируется через кандидата с расхождением и ожидание вашего тега в ValidationErrors — Field() вернёт имя поля из ReportError, и его стоит зафиксировать в таблице. Про пере-регистрацию держите в памяти контракт замены: повторная регистрация того же имени на общем экземпляре молча заменит правило для всего приложения — в тесте это способ тихо сломать соседние кейсы, а попытка занять служебное имя вроде required падает паникой ещё на регистрации.

Четырнадцатый урок закрепил: экземпляр валидатора один на приложение, регистрации — до первых проверок. Для тестов из этого следуют три правила. Первое: тесты переиспользуют пакетный экземпляр или зовут один конструктор buildValidator(), собирающий полный набор регистраций, — тестируется именно словарь приложения, а не параллельный мир со своим тегом phone: у нового экземпляра свои кэши, и прогрев приложение и тест платят дважды. Второе: пере-регистрация тега в тесте на общем экземпляре — мутация общего состояния: правило заменится для всего процесса, и порядок запуска тестов станет скрытой зависимостью; если тесту нужен особый словарь — собирайте отдельный экземпляр тем же конструктором, а не правьте общий. Третье: InvalidValidationError — тоже кейс. validate.Struct(nil) возвращает ошибку декодера, не ValidationErrors, и тест на это поведение занимает одну строку в той же таблице — errors.As с InvalidValidationError вместо FieldError. Регистрации в тестовом init подчиняются тому же порядку, что и в приложении: до первой проверки, потому что правило, зарегистрированное после разбора типа, в разбор не попадёт — кэш из четырнадцатого урока работает и в тестах, и это одна из самых тихих ловушек всей библиотеки.