Перейти к содержанию
ERITKOM
Open SourceНовость

go-yaml v4 RC9 вернул проверки ограничений при декодировании узлов

Кандидат от 2 ноября исправляет проверки глубины и псевдонимов. Финальная v4 ещё не выпущена; новые API и совместимость со старым кодом требуют отдельной проверки.

Кадр официальной терминальной демонстрации go-yaml CLI
The go-yaml Project Contributors, официальная запись CLI, Apache 2.0, NOTICE. GIF→статический WebP, изменение размера; не независимый тест редакции.

RC9 — ещё не окончательная версия

В репозитории go-yaml доступен кандидат v4.0.0-rc.9 от 2 ноября. Эту же дату и соответствующий коммит показывает реестр модулей Go. На момент проверки README прямо предупреждает, что окончательная версия 4.0.0 ещё не выпущена. Поэтому сообщение о подготовке релиза нельзя читать как объявление готовой стабильной библиотеки.

Изменение RC9 восстанавливает стандартные ограничения глубины и количества псевдонимов при Node.Decode. Они применяются в том числе при вызове декодирования из пользовательского UnmarshalYAML. В описании коммита перечислены проверки вложенности, псевдонимов и явного переопределения лимитов. Это конкретное исправление поведения кандидата, а не заявление о новой уязвимости всех приложений на YAML или о необходимости немедленно менять каждый рабочий сервис.

Новые имена не отменяют старые интерфейсы

В документации v4 наряду с привычными Unmarshal и Marshal представлены Load и Dump. Для потоков появились Loader и Dumper. Их конструкторы возвращают ошибку, которую нужно обработать до чтения или записи документов. Сохранение классических точек входа позволяет отделить смену пакета от перехода на новые способы настройки.

Import path новой ветки — go.yaml.in/yaml/v4. Руководство миграции отдельно обращает внимание на методы, принимающие yaml.Node: тип из третьей версии и тип из четвёртой не взаимозаменяемы. Простая замена строки импорта не доказывает, что пользовательский обработчик продолжает работать. Поэтому документация описывает постепенный переход с проверкой собственных тестов, ошибок и результатов сериализации.

Форматирование и строгая загрузка

У новых Load и Dump другие настройки по умолчанию. Для вывода используются отступ в два пробела и компактное расположение последовательностей. Это может изменить текст файла даже при сохранении его смысла. Для проектов, сравнивающих готовый YAML посимвольно, различие заметно в тестах, истории изменений и автоматически создаваемых конфигурациях.

Пресеты позволяют выбрать настройки прежней версии, а затем изменить отдельные параметры. Однако руководство не обещает восстановления каждого старого пути исполнения. При замене Marshal на Dump для близкого форматирования отдельно оговаривается отключение переноса строк. Для загрузки предусмотрены проверки известных полей и уникальности ключей. Обычный Load отвергает лишние документы, тогда как потоковый интерфейс предназначен для их последовательной обработки.

CLI показывает этапы обработки документа

В комплекте есть командный инструмент go-yaml, использующий тот же конвейер обработки. Он умеет показывать не только итоговый YAML или JSON, но и токены, события парсера и дерево узлов. Так можно отделить ошибку синтаксического разбора от преобразования уже разобранного документа в структуру Go. Это особенно полезно для небольшого воспроизводимого примера ошибки.

Официальная демонстрация команд включена в репозиторий вместе с исходным сценарием записи. В руководстве CLI настройки вывода и подключаемые реализации выбираются явно; инструмент не загружает произвольные плагины во время работы. Поддержка узлов позволяет сохранять поддерживаемые стили и комментарии, но не обещает побайтового совпадения с исходным текстом. Это ограничение существенно для программ, которые редактируют чужую конфигурацию, а не просто читают её значения.

Источники

Принципы журнала и исправления.

ERITKOM / НОВЫЙ ПРОЕКТ

Расскажите о задаче и оставьте контакты. Мы свяжемся с вами, чтобы обсудить проект.

  1. 01 Контакты
  2. 02 Ваша задача