psych 3.3.4 → 5.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CONTRIBUTING.md +24 -0
- data/README.md +6 -5
- data/ext/psych/depend +13 -1
- data/ext/psych/extconf.rb +40 -30
- data/ext/psych/psych_parser.c +19 -33
- data/lib/psych/class_loader.rb +5 -5
- data/lib/psych/core_ext.rb +1 -1
- data/lib/psych/exception.rb +16 -2
- data/lib/psych/handlers/document_stream.rb +1 -1
- data/lib/psych/handlers/recorder.rb +1 -1
- data/lib/psych/json/stream.rb +2 -2
- data/lib/psych/json/tree_builder.rb +1 -1
- data/lib/psych/nodes/node.rb +4 -4
- data/lib/psych/nodes.rb +7 -7
- data/lib/psych/parser.rb +13 -0
- data/lib/psych/scalar_scanner.rb +20 -14
- data/lib/psych/syntax_error.rb +1 -1
- data/lib/psych/tree_builder.rb +3 -3
- data/lib/psych/versions.rb +2 -2
- data/lib/psych/visitors/json_tree.rb +1 -1
- data/lib/psych/visitors/to_ruby.rb +8 -8
- data/lib/psych/visitors/yaml_tree.rb +57 -10
- data/lib/psych/visitors.rb +6 -6
- data/lib/psych.rb +183 -103
- metadata +22 -25
- data/.gitignore +0 -16
- data/Gemfile +0 -9
- data/Mavenfile +0 -7
- data/Rakefile +0 -41
- data/bin/console +0 -7
- data/bin/setup +0 -6
- data/ext/psych/yaml/LICENSE +0 -19
- data/ext/psych/yaml/api.c +0 -1393
- data/ext/psych/yaml/config.h +0 -80
- data/ext/psych/yaml/dumper.c +0 -394
- data/ext/psych/yaml/emitter.c +0 -2358
- data/ext/psych/yaml/loader.c +0 -544
- data/ext/psych/yaml/parser.c +0 -1375
- data/ext/psych/yaml/reader.c +0 -469
- data/ext/psych/yaml/scanner.c +0 -3598
- data/ext/psych/yaml/writer.c +0 -141
- data/ext/psych/yaml/yaml.h +0 -1985
- data/ext/psych/yaml/yaml_private.h +0 -688
- data/psych.gemspec +0 -67
@@ -1,7 +1,7 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
|
-
|
3
|
-
|
4
|
-
|
2
|
+
require_relative '../tree_builder'
|
3
|
+
require_relative '../scalar_scanner'
|
4
|
+
require_relative '../class_loader'
|
5
5
|
|
6
6
|
module Psych
|
7
7
|
module Visitors
|
@@ -15,30 +15,29 @@ module Psych
|
|
15
15
|
class YAMLTree < Psych::Visitors::Visitor
|
16
16
|
class Registrar # :nodoc:
|
17
17
|
def initialize
|
18
|
-
@obj_to_id = {}
|
19
|
-
@obj_to_node = {}
|
18
|
+
@obj_to_id = {}.compare_by_identity
|
19
|
+
@obj_to_node = {}.compare_by_identity
|
20
20
|
@targets = []
|
21
21
|
@counter = 0
|
22
22
|
end
|
23
23
|
|
24
24
|
def register target, node
|
25
|
-
return unless target.respond_to? :object_id
|
26
25
|
@targets << target
|
27
|
-
@obj_to_node[target
|
26
|
+
@obj_to_node[target] = node
|
28
27
|
end
|
29
28
|
|
30
29
|
def key? target
|
31
|
-
@obj_to_node.key? target
|
30
|
+
@obj_to_node.key? target
|
32
31
|
rescue NoMethodError
|
33
32
|
false
|
34
33
|
end
|
35
34
|
|
36
35
|
def id_for target
|
37
|
-
@obj_to_id[target
|
36
|
+
@obj_to_id[target] ||= (@counter += 1)
|
38
37
|
end
|
39
38
|
|
40
39
|
def node_for target
|
41
|
-
@obj_to_node[target
|
40
|
+
@obj_to_node[target]
|
42
41
|
end
|
43
42
|
end
|
44
43
|
|
@@ -272,6 +271,8 @@ module Psych
|
|
272
271
|
tag = 'tag:yaml.org,2002:str'
|
273
272
|
plain = false
|
274
273
|
quote = false
|
274
|
+
elsif o == 'y' || o == 'n'
|
275
|
+
style = Nodes::Scalar::DOUBLE_QUOTED
|
275
276
|
elsif @line_width && o.length > @line_width
|
276
277
|
style = Nodes::Scalar::FOLDED
|
277
278
|
elsif o =~ /^[^[:word:]][^"]*$/
|
@@ -535,5 +536,51 @@ module Psych
|
|
535
536
|
end
|
536
537
|
end
|
537
538
|
end
|
539
|
+
|
540
|
+
class RestrictedYAMLTree < YAMLTree
|
541
|
+
DEFAULT_PERMITTED_CLASSES = {
|
542
|
+
TrueClass => true,
|
543
|
+
FalseClass => true,
|
544
|
+
NilClass => true,
|
545
|
+
Integer => true,
|
546
|
+
Float => true,
|
547
|
+
String => true,
|
548
|
+
Array => true,
|
549
|
+
Hash => true,
|
550
|
+
}.compare_by_identity.freeze
|
551
|
+
|
552
|
+
def initialize emitter, ss, options
|
553
|
+
super
|
554
|
+
@permitted_classes = DEFAULT_PERMITTED_CLASSES.dup
|
555
|
+
Array(options[:permitted_classes]).each do |klass|
|
556
|
+
@permitted_classes[klass] = true
|
557
|
+
end
|
558
|
+
@permitted_symbols = {}.compare_by_identity
|
559
|
+
Array(options[:permitted_symbols]).each do |symbol|
|
560
|
+
@permitted_symbols[symbol] = true
|
561
|
+
end
|
562
|
+
@aliases = options.fetch(:aliases, false)
|
563
|
+
end
|
564
|
+
|
565
|
+
def accept target
|
566
|
+
if !@aliases && @st.key?(target)
|
567
|
+
raise BadAlias, "Tried to dump an aliased object"
|
568
|
+
end
|
569
|
+
|
570
|
+
unless Symbol === target || @permitted_classes[target.class]
|
571
|
+
raise DisallowedClass.new('dump', target.class.name || target.class.inspect)
|
572
|
+
end
|
573
|
+
|
574
|
+
super
|
575
|
+
end
|
576
|
+
|
577
|
+
def visit_Symbol sym
|
578
|
+
unless @permitted_classes[Symbol] || @permitted_symbols[sym]
|
579
|
+
raise DisallowedClass.new('dump', "Symbol(#{sym.inspect})")
|
580
|
+
end
|
581
|
+
|
582
|
+
super
|
583
|
+
end
|
584
|
+
end
|
538
585
|
end
|
539
586
|
end
|
data/lib/psych/visitors.rb
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
|
-
|
3
|
-
|
4
|
-
|
5
|
-
|
6
|
-
|
7
|
-
|
2
|
+
require_relative 'visitors/visitor'
|
3
|
+
require_relative 'visitors/to_ruby'
|
4
|
+
require_relative 'visitors/emitter'
|
5
|
+
require_relative 'visitors/yaml_tree'
|
6
|
+
require_relative 'visitors/json_tree'
|
7
|
+
require_relative 'visitors/depth_first'
|
data/lib/psych.rb
CHANGED
@@ -1,8 +1,8 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
|
-
|
2
|
+
require_relative 'psych/versions'
|
3
3
|
case RUBY_ENGINE
|
4
4
|
when 'jruby'
|
5
|
-
|
5
|
+
require_relative 'psych_jars'
|
6
6
|
if JRuby::Util.respond_to?(:load_ext)
|
7
7
|
JRuby::Util.load_ext('org.jruby.ext.psych.PsychLibrary')
|
8
8
|
else
|
@@ -12,28 +12,28 @@ when 'jruby'
|
|
12
12
|
else
|
13
13
|
require 'psych.so'
|
14
14
|
end
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
15
|
+
require_relative 'psych/nodes'
|
16
|
+
require_relative 'psych/streaming'
|
17
|
+
require_relative 'psych/visitors'
|
18
|
+
require_relative 'psych/handler'
|
19
|
+
require_relative 'psych/tree_builder'
|
20
|
+
require_relative 'psych/parser'
|
21
|
+
require_relative 'psych/omap'
|
22
|
+
require_relative 'psych/set'
|
23
|
+
require_relative 'psych/coder'
|
24
|
+
require_relative 'psych/core_ext'
|
25
|
+
require_relative 'psych/stream'
|
26
|
+
require_relative 'psych/json/tree_builder'
|
27
|
+
require_relative 'psych/json/stream'
|
28
|
+
require_relative 'psych/handlers/document_stream'
|
29
|
+
require_relative 'psych/class_loader'
|
30
30
|
|
31
31
|
###
|
32
32
|
# = Overview
|
33
33
|
#
|
34
34
|
# Psych is a YAML parser and emitter.
|
35
35
|
# Psych leverages libyaml [Home page: https://pyyaml.org/wiki/LibYAML]
|
36
|
-
# or [
|
36
|
+
# or [git repo: https://github.com/yaml/libyaml] for its YAML parsing
|
37
37
|
# and emitting capabilities. In addition to wrapping libyaml, Psych also
|
38
38
|
# knows how to serialize and de-serialize most Ruby objects to and from
|
39
39
|
# the YAML format.
|
@@ -234,9 +234,6 @@ require 'psych/class_loader'
|
|
234
234
|
module Psych
|
235
235
|
# The version of libyaml Psych is using
|
236
236
|
LIBYAML_VERSION = Psych.libyaml_version.join('.').freeze
|
237
|
-
# Deprecation guard
|
238
|
-
NOT_GIVEN = Object.new.freeze
|
239
|
-
private_constant :NOT_GIVEN
|
240
237
|
|
241
238
|
###
|
242
239
|
# Load +yaml+ in to a Ruby data structure. If multiple documents are
|
@@ -249,11 +246,11 @@ module Psych
|
|
249
246
|
#
|
250
247
|
# Example:
|
251
248
|
#
|
252
|
-
# Psych.
|
253
|
-
# Psych.
|
249
|
+
# Psych.unsafe_load("--- a") # => 'a'
|
250
|
+
# Psych.unsafe_load("---\n - a\n - b") # => ['a', 'b']
|
254
251
|
#
|
255
252
|
# begin
|
256
|
-
# Psych.
|
253
|
+
# Psych.unsafe_load("--- `", filename: "file.txt")
|
257
254
|
# rescue Psych::SyntaxError => ex
|
258
255
|
# ex.file # => 'file.txt'
|
259
256
|
# ex.message # => "(file.txt): found character that cannot start any token"
|
@@ -262,26 +259,20 @@ module Psych
|
|
262
259
|
# When the optional +symbolize_names+ keyword argument is set to a
|
263
260
|
# true value, returns symbols for keys in Hash objects (default: strings).
|
264
261
|
#
|
265
|
-
# Psych.
|
266
|
-
# Psych.
|
262
|
+
# Psych.unsafe_load("---\n foo: bar") # => {"foo"=>"bar"}
|
263
|
+
# Psych.unsafe_load("---\n foo: bar", symbolize_names: true) # => {:foo=>"bar"}
|
267
264
|
#
|
268
265
|
# Raises a TypeError when `yaml` parameter is NilClass
|
269
266
|
#
|
270
267
|
# NOTE: This method *should not* be used to parse untrusted documents, such as
|
271
268
|
# YAML documents that are supplied via user input. Instead, please use the
|
272
|
-
# safe_load method.
|
269
|
+
# load method or the safe_load method.
|
273
270
|
#
|
274
|
-
def self.unsafe_load yaml,
|
275
|
-
if legacy_filename != NOT_GIVEN
|
276
|
-
warn_with_uplevel 'Passing filename with the 2nd argument of Psych.load is deprecated. Use keyword argument like Psych.load(yaml, filename: ...) instead.', uplevel: 1 if $VERBOSE
|
277
|
-
filename = legacy_filename
|
278
|
-
end
|
279
|
-
|
271
|
+
def self.unsafe_load yaml, filename: nil, fallback: false, symbolize_names: false, freeze: false, strict_integer: false
|
280
272
|
result = parse(yaml, filename: filename)
|
281
273
|
return fallback unless result
|
282
|
-
result.to_ruby(symbolize_names: symbolize_names, freeze: freeze)
|
274
|
+
result.to_ruby(symbolize_names: symbolize_names, freeze: freeze, strict_integer: strict_integer)
|
283
275
|
end
|
284
|
-
class << self; alias :load :unsafe_load; end
|
285
276
|
|
286
277
|
###
|
287
278
|
# Safely load the yaml string in +yaml+. By default, only the following
|
@@ -290,7 +281,8 @@ module Psych
|
|
290
281
|
# * TrueClass
|
291
282
|
# * FalseClass
|
292
283
|
# * NilClass
|
293
|
-
# *
|
284
|
+
# * Integer
|
285
|
+
# * Float
|
294
286
|
# * String
|
295
287
|
# * Array
|
296
288
|
# * Hash
|
@@ -315,7 +307,7 @@ module Psych
|
|
315
307
|
# A Psych::DisallowedClass exception will be raised if the yaml contains a
|
316
308
|
# class that isn't in the +permitted_classes+ list.
|
317
309
|
#
|
318
|
-
# A Psych::
|
310
|
+
# A Psych::AliasesNotEnabled exception will be raised if the yaml contains aliases
|
319
311
|
# but the +aliases+ keyword argument is set to false.
|
320
312
|
#
|
321
313
|
# +filename+ will be used in the exception message if any exception is raised
|
@@ -327,33 +319,13 @@ module Psych
|
|
327
319
|
# Psych.safe_load("---\n foo: bar") # => {"foo"=>"bar"}
|
328
320
|
# Psych.safe_load("---\n foo: bar", symbolize_names: true) # => {:foo=>"bar"}
|
329
321
|
#
|
330
|
-
def self.safe_load yaml,
|
331
|
-
if legacy_permitted_classes != NOT_GIVEN
|
332
|
-
warn_with_uplevel 'Passing permitted_classes with the 2nd argument of Psych.safe_load is deprecated. Use keyword argument like Psych.safe_load(yaml, permitted_classes: ...) instead.', uplevel: 1 if $VERBOSE
|
333
|
-
permitted_classes = legacy_permitted_classes
|
334
|
-
end
|
335
|
-
|
336
|
-
if legacy_permitted_symbols != NOT_GIVEN
|
337
|
-
warn_with_uplevel 'Passing permitted_symbols with the 3rd argument of Psych.safe_load is deprecated. Use keyword argument like Psych.safe_load(yaml, permitted_symbols: ...) instead.', uplevel: 1 if $VERBOSE
|
338
|
-
permitted_symbols = legacy_permitted_symbols
|
339
|
-
end
|
340
|
-
|
341
|
-
if legacy_aliases != NOT_GIVEN
|
342
|
-
warn_with_uplevel 'Passing aliases with the 4th argument of Psych.safe_load is deprecated. Use keyword argument like Psych.safe_load(yaml, aliases: ...) instead.', uplevel: 1 if $VERBOSE
|
343
|
-
aliases = legacy_aliases
|
344
|
-
end
|
345
|
-
|
346
|
-
if legacy_filename != NOT_GIVEN
|
347
|
-
warn_with_uplevel 'Passing filename with the 5th argument of Psych.safe_load is deprecated. Use keyword argument like Psych.safe_load(yaml, filename: ...) instead.', uplevel: 1 if $VERBOSE
|
348
|
-
filename = legacy_filename
|
349
|
-
end
|
350
|
-
|
322
|
+
def self.safe_load yaml, permitted_classes: [], permitted_symbols: [], aliases: false, filename: nil, fallback: nil, symbolize_names: false, freeze: false, strict_integer: false
|
351
323
|
result = parse(yaml, filename: filename)
|
352
324
|
return fallback unless result
|
353
325
|
|
354
326
|
class_loader = ClassLoader::Restricted.new(permitted_classes.map(&:to_s),
|
355
327
|
permitted_symbols.map(&:to_s))
|
356
|
-
scanner = ScalarScanner.new class_loader
|
328
|
+
scanner = ScalarScanner.new class_loader, strict_integer: strict_integer
|
357
329
|
visitor = if aliases
|
358
330
|
Visitors::ToRuby.new scanner, class_loader, symbolize_names: symbolize_names, freeze: freeze
|
359
331
|
else
|
@@ -363,6 +335,47 @@ module Psych
|
|
363
335
|
result
|
364
336
|
end
|
365
337
|
|
338
|
+
###
|
339
|
+
# Load +yaml+ in to a Ruby data structure. If multiple documents are
|
340
|
+
# provided, the object contained in the first document will be returned.
|
341
|
+
# +filename+ will be used in the exception message if any exception
|
342
|
+
# is raised while parsing. If +yaml+ is empty, it returns
|
343
|
+
# the specified +fallback+ return value, which defaults to +false+.
|
344
|
+
#
|
345
|
+
# Raises a Psych::SyntaxError when a YAML syntax error is detected.
|
346
|
+
#
|
347
|
+
# Example:
|
348
|
+
#
|
349
|
+
# Psych.load("--- a") # => 'a'
|
350
|
+
# Psych.load("---\n - a\n - b") # => ['a', 'b']
|
351
|
+
#
|
352
|
+
# begin
|
353
|
+
# Psych.load("--- `", filename: "file.txt")
|
354
|
+
# rescue Psych::SyntaxError => ex
|
355
|
+
# ex.file # => 'file.txt'
|
356
|
+
# ex.message # => "(file.txt): found character that cannot start any token"
|
357
|
+
# end
|
358
|
+
#
|
359
|
+
# When the optional +symbolize_names+ keyword argument is set to a
|
360
|
+
# true value, returns symbols for keys in Hash objects (default: strings).
|
361
|
+
#
|
362
|
+
# Psych.load("---\n foo: bar") # => {"foo"=>"bar"}
|
363
|
+
# Psych.load("---\n foo: bar", symbolize_names: true) # => {:foo=>"bar"}
|
364
|
+
#
|
365
|
+
# Raises a TypeError when `yaml` parameter is NilClass. This method is
|
366
|
+
# similar to `safe_load` except that `Symbol` objects are allowed by default.
|
367
|
+
#
|
368
|
+
def self.load yaml, permitted_classes: [Symbol], permitted_symbols: [], aliases: false, filename: nil, fallback: nil, symbolize_names: false, freeze: false, strict_integer: false
|
369
|
+
safe_load yaml, permitted_classes: permitted_classes,
|
370
|
+
permitted_symbols: permitted_symbols,
|
371
|
+
aliases: aliases,
|
372
|
+
filename: filename,
|
373
|
+
fallback: fallback,
|
374
|
+
symbolize_names: symbolize_names,
|
375
|
+
freeze: freeze,
|
376
|
+
strict_integer: strict_integer
|
377
|
+
end
|
378
|
+
|
366
379
|
###
|
367
380
|
# Parse a YAML string in +yaml+. Returns the Psych::Nodes::Document.
|
368
381
|
# +filename+ is used in the exception message if a Psych::SyntaxError is
|
@@ -382,22 +395,12 @@ module Psych
|
|
382
395
|
# end
|
383
396
|
#
|
384
397
|
# See Psych::Nodes for more information about YAML AST.
|
385
|
-
def self.parse yaml,
|
386
|
-
if legacy_filename != NOT_GIVEN
|
387
|
-
warn_with_uplevel 'Passing filename with the 2nd argument of Psych.parse is deprecated. Use keyword argument like Psych.parse(yaml, filename: ...) instead.', uplevel: 1 if $VERBOSE
|
388
|
-
filename = legacy_filename
|
389
|
-
end
|
390
|
-
|
398
|
+
def self.parse yaml, filename: nil
|
391
399
|
parse_stream(yaml, filename: filename) do |node|
|
392
400
|
return node
|
393
401
|
end
|
394
402
|
|
395
|
-
|
396
|
-
warn_with_uplevel 'Passing the `fallback` keyword argument of Psych.parse is deprecated.', uplevel: 1 if $VERBOSE
|
397
|
-
fallback
|
398
|
-
else
|
399
|
-
false
|
400
|
-
end
|
403
|
+
false
|
401
404
|
end
|
402
405
|
|
403
406
|
###
|
@@ -446,12 +449,7 @@ module Psych
|
|
446
449
|
# Raises a TypeError when NilClass is passed.
|
447
450
|
#
|
448
451
|
# See Psych::Nodes for more information about YAML AST.
|
449
|
-
def self.parse_stream yaml,
|
450
|
-
if legacy_filename != NOT_GIVEN
|
451
|
-
warn_with_uplevel 'Passing filename with the 2nd argument of Psych.parse_stream is deprecated. Use keyword argument like Psych.parse_stream(yaml, filename: ...) instead.', uplevel: 1 if $VERBOSE
|
452
|
-
filename = legacy_filename
|
453
|
-
end
|
454
|
-
|
452
|
+
def self.parse_stream yaml, filename: nil, &block
|
455
453
|
if block_given?
|
456
454
|
parser = Psych::Parser.new(Handlers::DocumentStream.new(&block))
|
457
455
|
parser.parse yaml, filename
|
@@ -515,6 +513,79 @@ module Psych
|
|
515
513
|
visitor.tree.yaml io, options
|
516
514
|
end
|
517
515
|
|
516
|
+
###
|
517
|
+
# call-seq:
|
518
|
+
# Psych.safe_dump(o) -> string of yaml
|
519
|
+
# Psych.safe_dump(o, options) -> string of yaml
|
520
|
+
# Psych.safe_dump(o, io) -> io object passed in
|
521
|
+
# Psych.safe_dump(o, io, options) -> io object passed in
|
522
|
+
#
|
523
|
+
# Safely dump Ruby object +o+ to a YAML string. Optional +options+ may be passed in
|
524
|
+
# to control the output format. If an IO object is passed in, the YAML will
|
525
|
+
# be dumped to that IO object. By default, only the following
|
526
|
+
# classes are allowed to be serialized:
|
527
|
+
#
|
528
|
+
# * TrueClass
|
529
|
+
# * FalseClass
|
530
|
+
# * NilClass
|
531
|
+
# * Integer
|
532
|
+
# * Float
|
533
|
+
# * String
|
534
|
+
# * Array
|
535
|
+
# * Hash
|
536
|
+
#
|
537
|
+
# Arbitrary classes can be allowed by adding those classes to the +permitted_classes+
|
538
|
+
# keyword argument. They are additive. For example, to allow Date serialization:
|
539
|
+
#
|
540
|
+
# Psych.safe_dump(yaml, permitted_classes: [Date])
|
541
|
+
#
|
542
|
+
# Now the Date class can be dumped in addition to the classes listed above.
|
543
|
+
#
|
544
|
+
# A Psych::DisallowedClass exception will be raised if the object contains a
|
545
|
+
# class that isn't in the +permitted_classes+ list.
|
546
|
+
#
|
547
|
+
# Currently supported options are:
|
548
|
+
#
|
549
|
+
# [<tt>:indentation</tt>] Number of space characters used to indent.
|
550
|
+
# Acceptable value should be in <tt>0..9</tt> range,
|
551
|
+
# otherwise option is ignored.
|
552
|
+
#
|
553
|
+
# Default: <tt>2</tt>.
|
554
|
+
# [<tt>:line_width</tt>] Max character to wrap line at.
|
555
|
+
#
|
556
|
+
# Default: <tt>0</tt> (meaning "wrap at 81").
|
557
|
+
# [<tt>:canonical</tt>] Write "canonical" YAML form (very verbose, yet
|
558
|
+
# strictly formal).
|
559
|
+
#
|
560
|
+
# Default: <tt>false</tt>.
|
561
|
+
# [<tt>:header</tt>] Write <tt>%YAML [version]</tt> at the beginning of document.
|
562
|
+
#
|
563
|
+
# Default: <tt>false</tt>.
|
564
|
+
#
|
565
|
+
# Example:
|
566
|
+
#
|
567
|
+
# # Dump an array, get back a YAML string
|
568
|
+
# Psych.safe_dump(['a', 'b']) # => "---\n- a\n- b\n"
|
569
|
+
#
|
570
|
+
# # Dump an array to an IO object
|
571
|
+
# Psych.safe_dump(['a', 'b'], StringIO.new) # => #<StringIO:0x000001009d0890>
|
572
|
+
#
|
573
|
+
# # Dump an array with indentation set
|
574
|
+
# Psych.safe_dump(['a', ['b']], indentation: 3) # => "---\n- a\n- - b\n"
|
575
|
+
#
|
576
|
+
# # Dump an array to an IO with indentation set
|
577
|
+
# Psych.safe_dump(['a', ['b']], StringIO.new, indentation: 3)
|
578
|
+
def self.safe_dump o, io = nil, options = {}
|
579
|
+
if Hash === io
|
580
|
+
options = io
|
581
|
+
io = nil
|
582
|
+
end
|
583
|
+
|
584
|
+
visitor = Psych::Visitors::RestrictedYAMLTree.create options
|
585
|
+
visitor << o
|
586
|
+
visitor.tree.yaml io, options
|
587
|
+
end
|
588
|
+
|
518
589
|
###
|
519
590
|
# Dump a list of objects as separate documents to a document stream.
|
520
591
|
#
|
@@ -552,12 +623,7 @@ module Psych
|
|
552
623
|
# end
|
553
624
|
# list # => ['foo', 'bar']
|
554
625
|
#
|
555
|
-
def self.load_stream yaml,
|
556
|
-
if legacy_filename != NOT_GIVEN
|
557
|
-
warn_with_uplevel 'Passing filename with the 2nd argument of Psych.load_stream is deprecated. Use keyword argument like Psych.load_stream(yaml, filename: ...) instead.', uplevel: 1 if $VERBOSE
|
558
|
-
filename = legacy_filename
|
559
|
-
end
|
560
|
-
|
626
|
+
def self.load_stream yaml, filename: nil, fallback: [], **kwargs
|
561
627
|
result = if block_given?
|
562
628
|
parse_stream(yaml, filename: filename) do |node|
|
563
629
|
yield node.to_ruby(**kwargs)
|
@@ -583,7 +649,6 @@ module Psych
|
|
583
649
|
self.unsafe_load f, filename: filename, **kwargs
|
584
650
|
}
|
585
651
|
end
|
586
|
-
class << self; alias :load_file :unsafe_load_file; end
|
587
652
|
|
588
653
|
###
|
589
654
|
# Safely loads the document contained in +filename+. Returns the yaml contained in
|
@@ -596,6 +661,17 @@ module Psych
|
|
596
661
|
}
|
597
662
|
end
|
598
663
|
|
664
|
+
###
|
665
|
+
# Loads the document contained in +filename+. Returns the yaml contained in
|
666
|
+
# +filename+ as a Ruby object, or if the file is empty, it returns
|
667
|
+
# the specified +fallback+ return value, which defaults to +false+.
|
668
|
+
# See load for options.
|
669
|
+
def self.load_file filename, **kwargs
|
670
|
+
File.open(filename, 'r:bom|utf-8') { |f|
|
671
|
+
self.load f, filename: filename, **kwargs
|
672
|
+
}
|
673
|
+
end
|
674
|
+
|
599
675
|
# :stopdoc:
|
600
676
|
def self.add_domain_type domain, type_tag, &block
|
601
677
|
key = ['tag', domain, type_tag].join ':'
|
@@ -618,26 +694,8 @@ module Psych
|
|
618
694
|
dump_tags[klass] = tag
|
619
695
|
end
|
620
696
|
|
621
|
-
# Workaround for emulating `warn '...', uplevel: 1` in Ruby 2.4 or lower.
|
622
|
-
def self.warn_with_uplevel(message, uplevel: 1)
|
623
|
-
at = parse_caller(caller[uplevel]).join(':')
|
624
|
-
warn "#{at}: #{message}"
|
625
|
-
end
|
626
|
-
|
627
|
-
def self.parse_caller(at)
|
628
|
-
if /^(.+?):(\d+)(?::in `.*')?/ =~ at
|
629
|
-
file = $1
|
630
|
-
line = $2.to_i
|
631
|
-
[file, line]
|
632
|
-
end
|
633
|
-
end
|
634
|
-
private_class_method :warn_with_uplevel, :parse_caller
|
635
|
-
|
636
697
|
class << self
|
637
698
|
if defined?(Ractor)
|
638
|
-
require 'forwardable'
|
639
|
-
extend Forwardable
|
640
|
-
|
641
699
|
class Config
|
642
700
|
attr_accessor :load_tags, :dump_tags, :domain_types
|
643
701
|
def initialize
|
@@ -651,7 +709,29 @@ module Psych
|
|
651
709
|
Ractor.current[:PsychConfig] ||= Config.new
|
652
710
|
end
|
653
711
|
|
654
|
-
|
712
|
+
def load_tags
|
713
|
+
config.load_tags
|
714
|
+
end
|
715
|
+
|
716
|
+
def dump_tags
|
717
|
+
config.dump_tags
|
718
|
+
end
|
719
|
+
|
720
|
+
def domain_types
|
721
|
+
config.domain_types
|
722
|
+
end
|
723
|
+
|
724
|
+
def load_tags=(value)
|
725
|
+
config.load_tags = value
|
726
|
+
end
|
727
|
+
|
728
|
+
def dump_tags=(value)
|
729
|
+
config.dump_tags = value
|
730
|
+
end
|
731
|
+
|
732
|
+
def domain_types=(value)
|
733
|
+
config.domain_types = value
|
734
|
+
end
|
655
735
|
else
|
656
736
|
attr_accessor :load_tags
|
657
737
|
attr_accessor :dump_tags
|
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: psych
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version:
|
4
|
+
version: 5.1.2
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Aaron Patterson
|
@@ -10,8 +10,22 @@ authors:
|
|
10
10
|
autorequire:
|
11
11
|
bindir: bin
|
12
12
|
cert_chain: []
|
13
|
-
date:
|
14
|
-
dependencies:
|
13
|
+
date: 2023-12-19 00:00:00.000000000 Z
|
14
|
+
dependencies:
|
15
|
+
- !ruby/object:Gem::Dependency
|
16
|
+
name: stringio
|
17
|
+
requirement: !ruby/object:Gem::Requirement
|
18
|
+
requirements:
|
19
|
+
- - ">="
|
20
|
+
- !ruby/object:Gem::Version
|
21
|
+
version: '0'
|
22
|
+
type: :runtime
|
23
|
+
prerelease: false
|
24
|
+
version_requirements: !ruby/object:Gem::Requirement
|
25
|
+
requirements:
|
26
|
+
- - ">="
|
27
|
+
- !ruby/object:Gem::Version
|
28
|
+
version: '0'
|
15
29
|
description: |
|
16
30
|
Psych is a YAML parser and emitter. Psych leverages libyaml[https://pyyaml.org/wiki/LibYAML]
|
17
31
|
for its YAML parsing and emitting capabilities. In addition to wrapping libyaml,
|
@@ -26,14 +40,9 @@ extensions:
|
|
26
40
|
extra_rdoc_files:
|
27
41
|
- README.md
|
28
42
|
files:
|
29
|
-
-
|
30
|
-
- Gemfile
|
43
|
+
- CONTRIBUTING.md
|
31
44
|
- LICENSE
|
32
|
-
- Mavenfile
|
33
45
|
- README.md
|
34
|
-
- Rakefile
|
35
|
-
- bin/console
|
36
|
-
- bin/setup
|
37
46
|
- ext/psych/depend
|
38
47
|
- ext/psych/extconf.rb
|
39
48
|
- ext/psych/psych.c
|
@@ -46,18 +55,6 @@ files:
|
|
46
55
|
- ext/psych/psych_to_ruby.h
|
47
56
|
- ext/psych/psych_yaml_tree.c
|
48
57
|
- ext/psych/psych_yaml_tree.h
|
49
|
-
- ext/psych/yaml/LICENSE
|
50
|
-
- ext/psych/yaml/api.c
|
51
|
-
- ext/psych/yaml/config.h
|
52
|
-
- ext/psych/yaml/dumper.c
|
53
|
-
- ext/psych/yaml/emitter.c
|
54
|
-
- ext/psych/yaml/loader.c
|
55
|
-
- ext/psych/yaml/parser.c
|
56
|
-
- ext/psych/yaml/reader.c
|
57
|
-
- ext/psych/yaml/scanner.c
|
58
|
-
- ext/psych/yaml/writer.c
|
59
|
-
- ext/psych/yaml/yaml.h
|
60
|
-
- ext/psych/yaml/yaml_private.h
|
61
58
|
- lib/psych.rb
|
62
59
|
- lib/psych/class_loader.rb
|
63
60
|
- lib/psych/coder.rb
|
@@ -95,11 +92,11 @@ files:
|
|
95
92
|
- lib/psych/visitors/visitor.rb
|
96
93
|
- lib/psych/visitors/yaml_tree.rb
|
97
94
|
- lib/psych/y.rb
|
98
|
-
- psych.gemspec
|
99
95
|
homepage: https://github.com/ruby/psych
|
100
96
|
licenses:
|
101
97
|
- MIT
|
102
|
-
metadata:
|
98
|
+
metadata:
|
99
|
+
msys2_mingw_dependencies: libyaml
|
103
100
|
post_install_message:
|
104
101
|
rdoc_options:
|
105
102
|
- "--main"
|
@@ -110,14 +107,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
110
107
|
requirements:
|
111
108
|
- - ">="
|
112
109
|
- !ruby/object:Gem::Version
|
113
|
-
version: 2.
|
110
|
+
version: 2.5.0
|
114
111
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
115
112
|
requirements:
|
116
113
|
- - ">="
|
117
114
|
- !ruby/object:Gem::Version
|
118
115
|
version: '0'
|
119
116
|
requirements: []
|
120
|
-
rubygems_version: 3.
|
117
|
+
rubygems_version: 3.5.1
|
121
118
|
signing_key:
|
122
119
|
specification_version: 4
|
123
120
|
summary: Psych is a YAML parser and emitter
|
data/.gitignore
DELETED
data/Gemfile
DELETED