модуль YAML

YAML Язык разметки

Этот модуль предоставляет Ruby-интерфейс для сериализации данных в формате YAML.

Модуль YAML является псевдонимом для Psych, движка YAML для Ruby.

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

Работа с YAML может быть очень простой, например:

require 'yaml'
# Parse a YAML string
YAML.load("--- foo") #=> "foo"

# Emit some YAML
YAML.dump("foo")     # => "--- foo\n...\n"
{ :a => 'b'}.to_yaml  # => "---\n:a: b\n"

Так как реализация предоставляется библиотекой Psych, подробная документация может быть найдена в документации этой библиотеки (также входит в стандартную библиотеку).

Безопасность

Не используйте YAML для загрузки данных, не являющихся надёжными. Это небезопасно и может позволить вредоносным данным выполнить произвольный код внутри вашего приложения. Более подробная информация представлена в doc/security.rdoc.

История

Syck была оригинальной реализацией YAML в стандартной библиотеке Ruby, разработанной почему-то.

Вы по-прежнему можете использовать Syck, если хотите, для парсинга и генерации YAML, но для этого необходимо установить gem ‘syck’.

В более старых версиях Ruby, т.е. <= 1.9, Syck по-прежнему предоставляется, но был полностью удалён с выпуском Ruby 2.0.0.

Дополнительная информация

Для более подробной информации о реализации см. Psych, а также посетите yaml.org для получения спецификаций и другой полезной информации.

Psych поддерживается Aaron Patterson на github: github.com/ruby/psych

Syck также можно найти на github: github.com/ruby/syck