модуль 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