ruby-changes:62092
From: BurdetteLamar <ko1@a...>
Date: Wed, 1 Jul 2020 18:51:19 +0900 (JST)
Subject: [ruby-changes:62092] 99980b3034 (master): [flori/json] RDoc enhancements
https://git.ruby-lang.org/ruby.git/commit/?id=99980b3034 From 99980b3034f59eb1253411f1220e1591f47a49c1 Mon Sep 17 00:00:00 2001 From: BurdetteLamar <burdettelamar@y...> Date: Thu, 25 Jun 2020 12:09:28 -0500 Subject: [flori/json] RDoc enhancements https://github.com/flori/json/commit/7bee2c7c13 diff --git a/ext/json/lib/json.rb b/ext/json/lib/json.rb index a96f4bc..8fc7e83 100644 --- a/ext/json/lib/json.rb +++ b/ext/json/lib/json.rb @@ -150,8 +150,8 @@ require 'json/common' https://github.com/ruby/ruby/blob/trunk/ext/json/lib/json.rb#L150 # # When the source is a Ruby \Integer or \Float, JSON.generate returns # a \String containing a \JSON number: -# JSON.generate(Integer(0)) # => "0"" -# JSON.generate(Float(1.0)) # => "1.0" +# JSON.generate(42) # => "42" +# JSON.generate(0.42) # => "0.42" # # When the source is a Ruby \String, JSON.generate returns # a \String containing a \JSON string (with double-quotes): diff --git a/ext/json/lib/json/common.rb b/ext/json/lib/json/common.rb index 0e69050..db50b33 100644 --- a/ext/json/lib/json/common.rb +++ b/ext/json/lib/json/common.rb @@ -201,9 +201,6 @@ module JSON https://github.com/ruby/ruby/blob/trunk/ext/json/lib/json/common.rb#L201 # source = '[NaN, Infinity, -Infinity]' # ruby = JSON.parse(source, {allow_nan: true}) # ruby # => [NaN, Infinity, -Infinity] - # With a truthy value: - # ruby = JSON.parse(source, {allow_nan: :foo}) - # ruby # => [NaN, Infinity, -Infinity] # # ====== Output Options # @@ -232,12 +229,6 @@ module JSON https://github.com/ruby/ruby/blob/trunk/ext/json/lib/json/common.rb#L229 # Use class \OpenStruct: # ruby = JSON.parse(source, {object_class: OpenStruct}) # ruby # => #<OpenStruct a="foo", b=1.0, c=true, d=false, e=nil> - # Try class \Object: - # # Raises NoMethodError (undefined method `[]=' for #<Object:>): - # JSON.parse(source, {object_class: Object}) - # Bad value: - # # Raises TypeError (wrong argument type Symbol (expected Class)): - # JSON.parse(source, {object_class: :foo}) # # --- # @@ -319,7 +310,6 @@ module JSON https://github.com/ruby/ruby/blob/trunk/ext/json/lib/json/common.rb#L310 # obj = ["foo", 1.0, true, false, nil] # json = JSON.generate(obj) # json # => "[\"foo\",1.0,true,false,null]" - # json.class # => String # # When +obj+ is a # {Hash-convertible object}[doc/implicit_conversion_rdoc.html#label-Hash-Convertible+Objects], @@ -346,7 +336,7 @@ module JSON https://github.com/ruby/ruby/blob/trunk/ext/json/lib/json/common.rb#L336 # JSON.generate(JSON::MinusInfinity) # # Allow: - # ruby = [JSON::NaN, JSON::Infinity, JSON::MinusInfinity] + # ruby = [Float::NaN, Float::Infinity, Float::MinusInfinity] # JSON.generate(ruby, allow_nan: true) # => "[NaN,Infinity,-Infinity]" # # --- @@ -362,10 +352,6 @@ module JSON https://github.com/ruby/ruby/blob/trunk/ext/json/lib/json/common.rb#L352 # # Raises JSON::NestingError (nesting of 2 is too deep): # JSON.generate(obj, max_nesting: 2) # - # Bad Value: - # # Raises TypeError (can't convert Symbol into Hash): - # JSON.generate(obj, :foo) - # # ====== Output Options # # The default formatting options generate the most compact @@ -427,22 +413,11 @@ module JSON https://github.com/ruby/ruby/blob/trunk/ext/json/lib/json/common.rb#L413 # # ====== Exceptions # - # Raises an exception if +obj+ is not a valid Ruby object: - # # Raises NameError (uninitialized constant Foo): - # JSON.generate(Foo) - # # Raises NameError (undefined local variable or method `foo' for main:Object): - # JSON.generate(foo) - # # Raises an exception if +obj+ contains circular references: # a = []; b = []; a.push(b); b.push(a) # # Raises JSON::NestingError (nesting of 100 is too deep): # JSON.generate(a) # - # Raises an exception if +opts is not a - # {Hash-convertible object}[doc/implicit_conversion_rdoc.html#label-Hash-Convertible+Objects] - # (implementing +to_hash+): - # # Raises TypeError (can't convert Symbol into Hash): - # JSON.generate('x', :foo) def generate(obj, opts = nil) if State === opts state, opts = opts, nil -- cgit v0.10.2 -- ML: ruby-changes@q... Info: http://www.atdot.net/~ko1/quickml/