mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
f511ff3b3a
The error here is confusing for users because JRuby does not use
libyaml and installing it will not help. Instead, JRuby directs
them to a wiki page that describes an issue when multiple
conflicting versions of SnakeYAML are installed.
This change allows us to use the yaml gem and delete our local
sources.
8122087ffb
69 lines
2.1 KiB
Ruby
69 lines
2.1 KiB
Ruby
# frozen_string_literal: false
|
|
|
|
begin
|
|
require 'psych'
|
|
rescue LoadError
|
|
case RUBY_ENGINE
|
|
when 'jruby'
|
|
warn "The Psych YAML extension failed to load.\n" \
|
|
"Check your env for conflicting versions of SnakeYAML\n" \
|
|
"See https://github.com/jruby/jruby/wiki/FAQs#why-does-the-psych-yaml-extension-fail-to-load-in-my-environment",
|
|
uplevel: 1
|
|
else
|
|
warn "It seems your ruby installation is missing psych (for YAML output).\n" \
|
|
"To eliminate this warning, please install libyaml and reinstall your ruby.\n",
|
|
uplevel: 1
|
|
end
|
|
raise
|
|
end
|
|
|
|
YAML = Psych # :nodoc:
|
|
|
|
# YAML Ain't Markup Language
|
|
#
|
|
# This module provides a Ruby interface for data serialization in YAML format.
|
|
#
|
|
# The YAML module is an alias of Psych, the YAML engine for Ruby.
|
|
#
|
|
# == 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"
|
|
#
|
|
# As the implementation is provided by the Psych library, detailed documentation
|
|
# can be found in that library's docs (also part of standard library).
|
|
#
|
|
# == 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 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.
|
|
#
|
|
# Psych is maintained by Aaron Patterson on github: https://github.com/ruby/psych
|
|
#
|
|
# Syck can also be found on github: https://github.com/ruby/syck
|
|
module YAML
|
|
end
|