diff options
Diffstat (limited to 'jni/ruby/lib/yaml.rb')
-rw-r--r-- | jni/ruby/lib/yaml.rb | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/jni/ruby/lib/yaml.rb b/jni/ruby/lib/yaml.rb new file mode 100644 index 0000000..c0ffcf8 --- /dev/null +++ b/jni/ruby/lib/yaml.rb @@ -0,0 +1,59 @@ +## +# The YAML module is an alias of Psych, the YAML engine for Ruby. + +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 # :nodoc: + +# YAML Ain't Markup Language +# +# This module provides a Ruby interface for data serialization in YAML format. +# +# The underlying implementation is the libyaml wrapper Psych. +# +# == Usage +# +# Working with YAML can be very simple, for example: +# +# 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" +# +# == Security +# +# 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. +# +# == History +# +# Syck was the original for YAML implementation in Ruby's standard library +# developed by why the lucky stiff. +# +# You can still use Syck, if you prefer, for parsing and emitting YAML, but you +# must install the 'syck' gem now in order to use it. +# +# In older Ruby versions, ie. <= 1.9, Syck is still provided, however it was +# completely removed with the release of Ruby 2.0.0. +# +# == More info +# +# For more advanced details on the implementation see Psych, and also check out +# http://yaml.org for spec details and other helpful information. +# +# Pysch is maintained by Aaron Patterson on github: https://github.com/tenderlove/psych +# +# Syck can also be found on github: https://github.com/tenderlove/syck +module YAML +end |