Сравнение структур и слайсов в тестах

У assert.Equal нет собственной математики сравнения — вся работа делается в функции ObjectsAreEqual, и она устроена в три шага. Шаг первый: если один из аргументов nil, равенство возможно только при двух nil сразу. Шаг второй: ожидаемое значение проверяется на тип []byte, и если это слайс байтов, включается bytes.Equal — сравнение содержимого байт за байтом, без отражений. Шорт-кат добавлен ради скорости на больших данных: JSON-ответы, чек-суммы, сериализованные тела. Нюанс в том, что срабатывает он только на паре []byte против []byte: assert.Equal(t, []byte("abc"), "abc") вернёт false, потому что строка под шорт-кат не попадает. Шаг третий для всего остального — reflect.DeepEqual: рекурсивный обход полей структур, элементов слайсов и ключей карт. В обсуждениях testify эту связку зовут assert.DeepEqual, и именно её правила порождают все ловушки ниже: DeepEqual сравнивает типы, поля и элементы, но ничего не знает про «момент времени», «деньги» или намерения разработчика.

Сравнение структур в тестах ведётся двумя стилями, и у каждого есть цена. Стиль «целиком»: одна проверка на весь объект. Плюс — незапланированные изменения не пройдут мимо: добавили поле или оно начало заполняться — Equal упадёт, и это сигнал пересмотреть ожидания. Минус — отчёт: при провале печатается дифф всей структуры, и для объекта на двадцать полей виновника приходится искать глазами. Минус второй, коварнее: волатильные поля вроде createdAt заставляют выкинуть их из want, потом из него же выпадает id, и через месяц want описывает не объект, а огрызок. Стиль «по полям»: проверка на каждое значимое поле. Отчёт точный — упало конкретное поле с конкретным значением, волатильные поля осознанно пропущены. Плата — слепая зона: новое поле в структуру добавили, контракт изменился, тест остался зелёным и ничего не заметил. Для больших диффов в экосистеме есть google/go-cmp с cmpopts.IgnoreFields — отдельная зависимость; внутри testify рабочая замена — EqualExportedValues, о нём ниже.

time.Time — самая частая причина ложного красного. Снаружи это одно значение, внутри — структура с приватными полями: wall и ext хранят момент (а ext иногда ещё и монотонные часы), loc — указатель на тайм-зону. Отсюда два расхождения с интуицией. Первое: одно и то же мгновение в разных зонах не равно. time.Date с time.UTC и time.Date с time.FixedZone("MSK", 3*3600) могут описывать один момент — метод t1.Equal(t2) скажет true, а DeepEqual — false: поля loc хранят разные указатели. Второе: монотонные часы. time.Now() на Linux, macOS и Windows несёт дополнительную метку; Round(0) и Truncate(0) — документированный способ её снять. DeepEqual(now, now.Round(0)) — false при одном мгновении. Практические правила: фикстуры собирайте через time.Date с фиксированным моментом, а не time.Now(); инстанты сверяйте методом .Equal через assert.True, Unix-метками или приводите обе стороны к .UTC().

reflect.DeepEqual сравнивает и типы: значения разных типов не равны никогда. int64(42) против 42 — красный, и дифф честно сообщит, что типы не совпали. В реальных тестах разные типы приходят сами: константа 42 имеет тип int, из базы драйвер отдаёт int64, а json.Unmarshal в interface{} превращает все числа в float64 — assert.Equal(t, 42, payload["age"]) краснеет на float64(42), хотя значение то же. Лечение — явное приведение ожидания к типу факта или assert.EqualValues, который приводит числовые типы друг к другу; правда, у него ниже строгость: float64(1.5) против int(1) он может счесть равными — для точных значений надёжнее Equal с приведением. Второй принципиальный случай — func. DeepEqual считает функции несравнимыми: равны только два nil, любые другие пары — false. Структура с полем-коллбэком не пройдёт Equal, пока оба коллбэка nil: обнуляйте поле в фикстуре или сравнивайте по остальным полям. А напрямую Equal(t, f1, f2) откажется вовсе: testify запрещает func в аргументах Equal с сообщением cannot take func type as argument.

Структуры и время подчинились — очередь за коллекциями, где к вопросу о равенстве добавляется вопрос о составе. Следующий урок — ElementsMatch, Subset и Len: сравнение слайсов без оглядки на порядок, подмножества и контроль объёма, плюс ловушка nil против пустого слайса. Числа с плавающей точкой — 0.1+0.2 не равно 0.3 — разобраны отдельно в уроке про InDelta и InEpsilon: Equal на них краснеет заслуженно, там нужны дельты. Все примеры урока собираются в тестовый пакет и прогоняются локально через go test — песочница сайта тестовые пакеты не исполняет, зато интерактивы на странице закрепляют каждую ловушку. Полный маршрут из двадцати пяти тем — на странице курса по testify.