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