1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
ruby--ruby/lib/yaml.rb
eregon 253f49dbc2 * lib/yaml.rb: Use another trick to define the YAML module.
https://twitter.com/n0kada/status/328342207511801856

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@40515 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
2013-04-28 14:34:22 +00:00

85 lines
2.3 KiB
Ruby

##
# The YAML module allows you to use one of the two YAML engines that ship with
# ruby. By default Psych is used but the old and unmaintained Syck may be
# chosen.
begin
require 'psych'
rescue LoadError
warn "#{caller[0]}:"
warn "It seems your ruby installation is missing psych (for YAML output)."
warn "To eliminate this warning, please install libyaml and reinstall your ruby."
raise
end
YAML = Psych
module Psych # :nodoc:
class EngineManager
# Returns the YAML engine in use.
#
# By default Psych is used but the old and unmaintained Syck may be chosen.
#
# See #yamler= for more information.
attr_reader :yamler
def initialize # :nodoc:
@yamler = 'psych'
end
def syck? # :nodoc:
false
end
# By default Psych is used but the old and unmaintained Syck may be chosen.
#
# After installing the 'syck' gem, you can set the YAML engine to syck:
#
# YAML::ENGINE.yamler = 'syck'
#
# To set the YAML engine back to psych:
#
# YAML::ENGINE.yamler = 'psych'
def yamler= engine
case engine
when 'syck' then warn "syck has been removed"
when 'psych' then @yamler = 'psych'
else
raise(ArgumentError, "bad engine")
end
engine
end
end
ENGINE = EngineManager.new # :nodoc:
end
# YAML Ain't Markup Language
#
# This module provides a Ruby interface for data serialization in YAML format.
#
# The underlying implementation depends on an engine to handle the parsing and
# serialization for Ruby, by default this will be using the libyaml wrapper
# Psych.
#
# See Psych::EngineManager for details on switching the default YAML engine.
#
# Working with YAML can be very simple, for example:
#
# require 'yaml' # STEP ONE, 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"
#
# Do not use YAML to load untrusted data. Doing so is unsafe and could allow
# malicious input to execute arbitrary code inside your application. Please see
# doc/security.rdoc for more information.
#
# For more advanced details on the implementation see Psych, and also check out
# yaml.org for spec details and other helpful information.
module YAML
end