json_pure 1.1.7 → 1.1.8

data/CHANGES

@@ -1,3 +1,11 @@
+2009-08-23 (1.1.8)
+  * Applied a patch by OZAWA Sakuro <sakuro@2238club.org> to make json/pure
+    work in environments that don't provide iconv.
+  * Applied patch by okkez_ in order to fix Ruby Bug #1768:
+      http://redmine.ruby-lang.org/issues/show/1768.
+  * Finally got around to avoid the rather paranoid escaping of ?/ characters
+    in the generator's output. The parsers aren't affected by this change.
+    Thanks to Rich Apodaca <rapodaca@metamolecular.com> for the suggestion.
 2009-06-29 (1.1.7)
   * Security Fix for JSON::Pure::Parser. A specially designed string could
     cause catastrophic backtracking in one of the parser's regular expressions

data/{RUBY → COPYING}

@@ -1,6 +1,6 @@
 Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.co.jp>.
 You can redistribute it and/or modify it under either the terms of the GPL
-(see COPYING.txt file), or the conditions below:
+(see GPL file), or the conditions below:
 
   1. You may make and give away verbatim copies of the source form of the
      software without restriction, provided that you duplicate all of the

data/GPL

@@ -1,12 +1,12 @@
-		    GNU GENERAL PUBLIC LICENSE
-		       Version 2, June 1991
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 2, June 1991
 
  Copyright (C) 1989, 1991 Free Software Foundation, Inc.
                        59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  Everyone is permitted to copy and distribute verbatim copies
  of this license document, but changing it is not allowed.
 
-			    Preamble
+                            Preamble
 
   The licenses for most software are designed to take away your
 freedom to share and change it.  By contrast, the GNU General Public
@@ -56,7 +56,7 @@ patent must be licensed for everyone's free use or not licensed at all.
   The precise terms and conditions for copying, distribution and
 modification follow.
 
-		    GNU GENERAL PUBLIC LICENSE
+                    GNU GENERAL PUBLIC LICENSE
    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
 
   0. This License applies to any program or other work which contains
@@ -255,7 +255,7 @@ make exceptions for this.  Our decision will be guided by the two goals
 of preserving the free status of all derivatives of our free software and
 of promoting the sharing and reuse of software generally.
 
-			    NO WARRANTY
+                            NO WARRANTY
 
   11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
 FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
@@ -277,9 +277,9 @@ YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
 PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
 POSSIBILITY OF SUCH DAMAGES.
 
-		     END OF TERMS AND CONDITIONS
+                     END OF TERMS AND CONDITIONS
 
-	    How to Apply These Terms to Your New Programs
+            How to Apply These Terms to Your New Programs
 
   If you develop a new program, and you want it to be of the greatest
 possible use to the public, the best way to achieve this is to make it

data/README

@@ -73,6 +73,6 @@ Florian Frank <flori@ping.de>
 License
 =======
 
-Ruby License, see the RUBY file included in the source distribution. The Ruby
-License includes the GNU General Public License (GPL), Version 2, so see the
-file GPL as well.
+Ruby License, see the COPYING file included in the source distribution. The
+Ruby License includes the GNU General Public License (GPL), Version 2, so see
+the file GPL as well.

data/Rakefile

@@ -4,10 +4,12 @@ begin
 rescue LoadError
 end
 require 'rake/clean'
+CLOBBER.include Dir['benchmarks/data/*.{dat,log}']
 
 require 'rbconfig'
 include Config
 
+MAKE = ENV['MAKE'] || %w[gmake make].find { |c| system(c, '-v') }
 PKG_NAME          = 'json'
 PKG_VERSION       = File.read('VERSION').chomp
 PKG_FILES         = FileList["**/*"].exclude(/CVS|pkg|tmp|coverage|Makefile/).exclude(/\.(so|bundle|o|#{CONFIG['DLEXT']})$/)
@@ -54,7 +56,7 @@ task :compile_ext => [ EXT_PARSER_DL, EXT_GENERATOR_DL ]
 file EXT_PARSER_DL => EXT_PARSER_SRC do
   cd EXT_PARSER_DIR do
     ruby 'extconf.rb'
-    system 'make'
+    system MAKE
   end
   cp "#{EXT_PARSER_DIR}/parser.#{CONFIG['DLEXT']}", EXT_ROOT_DIR
 end
@@ -62,7 +64,7 @@ end
 file EXT_GENERATOR_DL => EXT_GENERATOR_SRC do
   cd EXT_GENERATOR_DIR do
     ruby 'extconf.rb'
-    system 'make'
+    system MAKE
   end
   cp "#{EXT_GENERATOR_DIR}/generator.#{CONFIG['DLEXT']}", EXT_ROOT_DIR
 end
@@ -147,14 +149,9 @@ end
 desc "Benchmarking library"
 task :benchmark => [ :benchmark_parser, :benchmark_generator ]
 
-desc "Clean benchmark data"
-task :clean_benchmark_data do
-  rm_rf Dir['benchmarks/data/*.{dat,log}']
-end
-
 desc "Create RDOC documentation"
 task :doc => [ :version, EXT_PARSER_SRC ] do
-  system "rdoc -S -o doc -m main.txt doc-templates/main.txt lib/json.rb #{FileList['lib/json/**/*.rb']} #{EXT_PARSER_SRC} #{EXT_GENERATOR_SRC}"
+  system "rdoc -o doc -m doc-main.txt doc-main.txt lib/json.rb #{FileList['lib/json/**/*.rb']} #{EXT_PARSER_SRC} #{EXT_GENERATOR_SRC}"
 end
 
 if defined?(Gem) and defined?(Rake::GemPackageTask) and defined?(Rake::ExtensionTask)
@@ -174,8 +171,7 @@ if defined?(Gem) and defined?(Rake::GemPackageTask) and defined?(Rake::Extension
 
     s.has_rdoc = true
     s.rdoc_options <<
-      '--title' <<  'JSON -- A JSON implemention' <<
-      '--main' << 'JSON' << '--line-numbers'
+      '--title' <<  'JSON -- A JSON implemention' << '--main' << 'doc-main.txt'
     s.test_files.concat Dir['tests/*.rb']
 
     s.author = "Florian Frank"
@@ -209,8 +205,7 @@ if defined?(Gem) and defined?(Rake::GemPackageTask) and defined?(Rake::Extension
 
     s.has_rdoc = true
     s.rdoc_options <<
-      '--title' <<  'JSON -- A JSON implemention' <<
-      '--main' << 'JSON' << '--line-numbers'
+      '--title' <<  'JSON -- A JSON implemention' << '--main' << 'doc-main.txt'
     s.test_files.concat Dir['tests/*.rb']
 
     s.author = "Florian Frank"
@@ -260,11 +255,11 @@ EOT
   end
 end
 
-# TODO task :release => [ :version, :clean, :package_win ]
 desc "Build all gems and archives for a new release."
 task :release => [ :clean, :version, :cross, :native, :gem ] do
   system "#$0 clean native gem"
   system "#$0 clean package"
 end
 
+desc "Compile in the the source directory"
 task :default => [ :version, :compile_ext ]

data/VERSION

@@ -1 +1 @@
-1.1.7
+1.1.8

data/benchmarks/generator_benchmark.rb

@@ -147,7 +147,7 @@ if $0 == __FILE__
     system "#{RAKE_PATH} clean"
     system "#{RUBY_PATH} #$0 rails"
     system "#{RUBY_PATH} #$0 pure"
-    system "#{RAKE_PATH} compile"
+    system "#{RAKE_PATH} compile_ext"
     system "#{RUBY_PATH} #$0 ext"
     Bullshit.compare do
       output_filename File.join(File.dirname(__FILE__), 'data', 'GeneratorBenchmarkComparison.log')

data/benchmarks/parser_benchmark.rb

@@ -183,7 +183,7 @@ if $0 == __FILE__
     system "#{RUBY_PATH} #$0 yaml"
     system "#{RUBY_PATH} #$0 rails"
     system "#{RUBY_PATH} #$0 pure"
-    system "#{RAKE_PATH} compile"
+    system "#{RAKE_PATH} compile_ext"
     system "#{RUBY_PATH} #$0 ext"
     Bullshit.compare do
       output_filename File.join(File.dirname(__FILE__), 'data', 'ParserBenchmarkComparison.log')

data/doc-main.txt

@@ -0,0 +1,283 @@
+== json - JSON Implementation for Ruby
+
+=== Description
+
+This is a implementation of the JSON specification according to RFC 4627
+(http://www.ietf.org/rfc/rfc4627.txt). Starting from version 1.0.0 on there
+will be two variants available:
+
+* A pure ruby variant, that relies on the iconv and the stringscan
+  extensions, which are both part of the ruby standard library.
+* The quite a bit faster C extension variant, which is in parts implemented
+  in C and comes with its own unicode conversion functions and a parser
+  generated by the ragel state machine compiler
+  (http://www.cs.queensu.ca/~thurston/ragel).
+
+Both variants of the JSON generator escape all non-ASCII an control
+characters with \uXXXX escape sequences, and support UTF-16 surrogate pairs
+in order to be able to generate the whole range of unicode code points. This
+means that generated JSON text is encoded as UTF-8 (because ASCII is a subset
+of UTF-8) and at the same time avoids decoding problems for receiving
+endpoints, that don't expect UTF-8 encoded texts. On the negative side this
+may lead to a bit longer strings than necessarry.
+
+All strings, that are to be encoded as JSON strings, should be UTF-8 byte
+sequences on the Ruby side. To encode raw binary strings, that aren't UTF-8
+encoded, please use the to_json_raw_object method of String (which produces
+an object, that contains a byte array) and decode the result on the receiving
+endpoint.
+
+=== Author
+
+Florian Frank <mailto:flori@ping.de>
+
+=== License
+
+This software is distributed under the same license as Ruby itself, see
+http://www.ruby-lang.org/en/LICENSE.txt.
+
+=== Download
+
+The latest version of this library can be downloaded at
+
+* http://rubyforge.org/frs?group_id=953
+
+Online Documentation should be located at
+
+* http://json.rubyforge.org
+
+=== Usage
+
+To use JSON you can
+  require 'json'
+to load the installed variant (either the extension 'json' or the pure
+variant 'json_pure'). If you have installed the extension variant, you can
+pick either the extension variant or the pure variant by typing
+  require 'json/ext'
+or
+  require 'json/pure'
+
+You can choose to load a set of common additions to ruby core's objects if
+you
+  require 'json/add/core'
+
+After requiring this you can, e. g., serialise/deserialise Ruby ranges:
+
+  JSON JSON(1..10) # => 1..10
+
+To find out how to add JSON support to other or your own classes, read the
+Examples section below.
+
+To get the best compatibility to rails' JSON implementation, you can
+  require 'json/add/rails'
+
+Both of the additions attempt to require 'json' (like above) first, if it has
+not been required yet.
+
+=== Speed Comparisons
+
+I have created some benchmark results (see the benchmarks/data-p4-3Ghz
+subdir of the package) for the JSON-parser to estimate the speed up in the C
+extension:
+
+ Comparing times (call_time_mean):
+  1 ParserBenchmarkExt#parser   900 repeats:
+        553.922304770 (  real) ->   21.500x 
+          0.001805307
+  2 ParserBenchmarkYAML#parser  1000 repeats:
+        224.513358139 (  real) ->    8.714x 
+          0.004454078
+  3 ParserBenchmarkPure#parser  1000 repeats:
+         26.755020642 (  real) ->    1.038x 
+          0.037376163
+  4 ParserBenchmarkRails#parser 1000 repeats:
+         25.763381731 (  real) ->    1.000x 
+          0.038814780
+            calls/sec (  time) ->    speed  covers
+            secs/call
+
+In the table above 1 is JSON::Ext::Parser, 2 is YAML.load with YAML
+compatbile JSON document, 3 is is JSON::Pure::Parser, and 4 is
+ActiveSupport::JSON.decode. The ActiveSupport JSON-decoder converts the
+input first to YAML and then uses the YAML-parser, the conversion seems to
+slow it down so much that it is only as fast as the JSON::Pure::Parser!
+
+If you look at the benchmark data you can see that this is mostly caused by
+the frequent high outliers - the median of the Rails-parser runs is still
+overall smaller than the median of the JSON::Pure::Parser runs:
+
+ Comparing times (call_time_median):
+  1 ParserBenchmarkExt#parser   900 repeats:
+        800.592479481 (  real) ->   26.936x 
+          0.001249075
+  2 ParserBenchmarkYAML#parser  1000 repeats:
+        271.002390644 (  real) ->    9.118x 
+          0.003690004
+  3 ParserBenchmarkRails#parser 1000 repeats:
+         30.227910865 (  real) ->    1.017x 
+          0.033082008
+  4 ParserBenchmarkPure#parser  1000 repeats:
+         29.722384421 (  real) ->    1.000x 
+          0.033644676
+            calls/sec (  time) ->    speed  covers
+            secs/call
+
+I have benchmarked the JSON-Generator as well. This generated a few more
+values, because there are different modes that also influence the achieved
+speed:
+
+ Comparing times (call_time_mean):
+  1 GeneratorBenchmarkExt#generator_fast    1000 repeats:
+        547.354332608 (  real) ->   15.090x 
+          0.001826970
+  2 GeneratorBenchmarkExt#generator_safe    1000 repeats:
+        443.968212317 (  real) ->   12.240x 
+          0.002252414
+  3 GeneratorBenchmarkExt#generator_pretty  900 repeats:
+        375.104545883 (  real) ->   10.341x 
+          0.002665923
+  4 GeneratorBenchmarkPure#generator_fast   1000 repeats:
+         49.978706968 (  real) ->    1.378x 
+          0.020008521
+  5 GeneratorBenchmarkRails#generator       1000 repeats:
+         38.531868759 (  real) ->    1.062x 
+          0.025952543
+  6 GeneratorBenchmarkPure#generator_safe   1000 repeats:
+         36.927649925 (  real) ->    1.018x 7 (>=3859)
+          0.027079979
+  7 GeneratorBenchmarkPure#generator_pretty 1000 repeats:
+         36.272134441 (  real) ->    1.000x 6 (>=3859)
+          0.027569373
+            calls/sec (  time) ->    speed  covers
+            secs/call
+
+In the table above 1-3 are JSON::Ext::Generator methods. 4, 6, and 7 are
+JSON::Pure::Generator methods and 5 is the Rails JSON generator. It is now a
+bit faster than the generator_safe and generator_pretty methods of the pure
+variant but slower than the others.
+
+To achieve the fastest JSON text output, you can use the fast_generate
+method. Beware, that this will disable the checking for circular Ruby data
+structures, which may cause JSON to go into an infinite loop.
+
+Here are the median comparisons for completeness' sake:
+
+ Comparing times (call_time_median):
+  1 GeneratorBenchmarkExt#generator_fast    1000 repeats:
+        708.258020939 (  real) ->   16.547x 
+          0.001411915
+  2 GeneratorBenchmarkExt#generator_safe    1000 repeats:
+        569.105020353 (  real) ->   13.296x 
+          0.001757145
+  3 GeneratorBenchmarkExt#generator_pretty  900 repeats:
+        482.825371244 (  real) ->   11.280x 
+          0.002071142
+  4 GeneratorBenchmarkPure#generator_fast   1000 repeats:
+         62.717626652 (  real) ->    1.465x 
+          0.015944481
+  5 GeneratorBenchmarkRails#generator       1000 repeats:
+         43.965681162 (  real) ->    1.027x 
+          0.022745013
+  6 GeneratorBenchmarkPure#generator_safe   1000 repeats:
+         43.929073409 (  real) ->    1.026x 7 (>=3859)
+          0.022763968
+  7 GeneratorBenchmarkPure#generator_pretty 1000 repeats:
+         42.802514491 (  real) ->    1.000x 6 (>=3859)
+          0.023363113
+            calls/sec (  time) ->    speed  covers
+            secs/call
+
+=== Examples
+
+To create a JSON text from a ruby data structure, you can call JSON.generate
+like that:
+
+ json = JSON.generate [1, 2, {"a"=>3.141}, false, true, nil, 4..10]
+ # => "[1,2,{\"a\":3.141},false,true,null,\"4..10\"]"
+
+To create a valid JSON text you have to make sure, that the output is
+embedded in either a JSON array [] or a JSON object {}. The easiest way to do
+this, is by putting your values in a Ruby Array or Hash instance.
+
+To get back a ruby data structure from a JSON text, you have to call
+JSON.parse on it:
+
+ JSON.parse json
+ # => [1, 2, {"a"=>3.141}, false, true, nil, "4..10"]
+
+Note, that the range from the original data structure is a simple
+string now. The reason for this is, that JSON doesn't support ranges
+or arbitrary classes. In this case the json library falls back to call
+Object#to_json, which is the same as #to_s.to_json.
+
+It's possible to add JSON support serialization to arbitrary classes by
+simply implementing a more specialized version of the #to_json method, that
+should return a JSON object (a hash converted to JSON with #to_json) like
+this (don't forget the *a for all the arguments):
+
+ class Range
+   def to_json(*a)
+     {
+       'json_class'   => self.class.name, # = 'Range'
+       'data'         => [ first, last, exclude_end? ]
+     }.to_json(*a)
+   end
+ end
+
+The hash key 'json_class' is the class, that will be asked to deserialise the
+JSON representation later. In this case it's 'Range', but any namespace of
+the form 'A::B' or '::A::B' will do. All other keys are arbitrary and can be
+used to store the necessary data to configure the object to be deserialised.
+
+If a the key 'json_class' is found in a JSON object, the JSON parser checks
+if the given class responds to the json_create class method. If so, it is
+called with the JSON object converted to a Ruby hash. So a range can
+be deserialised by implementing Range.json_create like this:
+
+ class Range
+   def self.json_create(o)
+     new(*o['data'])
+   end
+ end
+
+Now it possible to serialise/deserialise ranges as well:
+
+ json = JSON.generate [1, 2, {"a"=>3.141}, false, true, nil, 4..10]
+ # => "[1,2,{\"a\":3.141},false,true,null,{\"json_class\":\"Range\",\"data\":[4,10,false]}]"
+ JSON.parse json
+ # => [1, 2, {"a"=>3.141}, false, true, nil, 4..10]
+
+JSON.generate always creates the shortest possible string representation of a
+ruby data structure in one line. This good for data storage or network
+protocols, but not so good for humans to read. Fortunately there's also
+JSON.pretty_generate (or JSON.pretty_generate) that creates a more
+readable output:
+
+ puts JSON.pretty_generate([1, 2, {"a"=>3.141}, false, true, nil, 4..10])
+ [
+   1,
+   2,
+   {
+     "a": 3.141
+   },
+   false,
+   true,
+   null,
+   {
+     "json_class": "Range",
+     "data": [
+       4,
+       10,
+       false
+     ]
+   }
+ ]
+
+There are also the methods Kernel#j for generate, and Kernel#jj for
+pretty_generate output to the console, that work analogous to Core Ruby's p
+and the pp library's pp methods.
+
+The script tools/server.rb contains a small example if you want to test, how
+receiving a JSON object from a webrick server in your browser with the
+javasript prototype library (http://www.prototypejs.org) works.
+

data/ext/json/ext/generator/unicode.c

@@ -144,8 +144,6 @@ void JSON_convert_UTF8_to_JSON(VALUE buffer, VALUE string, ConversionFlags flags
                     rb_str_buf_cat2(buffer, "\\\"");
                 } else if (ch == '\\') {
                     rb_str_buf_cat2(buffer, "\\\\");
-                } else if (ch == '/') {
-                    rb_str_buf_cat2(buffer, "\\/");
                 } else if (ch >= 0x20 && ch <= 0x7f) {
                     rb_str_buf_cat(buffer, (char *) source - 1, 1);
                 } else if (ch == '\n') {

data/ext/json/ext/parser/parser.c

@@ -80,7 +80,7 @@ static char *JSON_parse_object(JSON_Parser *json, char *p, char *pe, VALUE *resu
     VALUE object_class = json->object_class;
 
     if (json->max_nesting && json->current_nesting > json->max_nesting) {
-        rb_raise(eNestingError, "nesting of %d is to deep", json->current_nesting);
+        rb_raise(eNestingError, "nesting of %d is too deep", json->current_nesting);
     }
 
     *result = NIL_P(object_class) ? rb_hash_new() : rb_class_new_instance(0, 0, object_class);
@@ -1012,7 +1012,7 @@ static char *JSON_parse_array(JSON_Parser *json, char *p, char *pe, VALUE *resul
     VALUE array_class = json->array_class;
 
     if (json->max_nesting && json->current_nesting > json->max_nesting) {
-        rb_raise(eNestingError, "nesting of %d is to deep", json->current_nesting);
+        rb_raise(eNestingError, "nesting of %d is too deep", json->current_nesting);
     }
     *result = NIL_P(array_class) ? rb_ary_new() : rb_class_new_instance(0, 0, array_class);
 

data/ext/json/ext/parser/parser.rl

@@ -123,7 +123,7 @@ static char *JSON_parse_object(JSON_Parser *json, char *p, char *pe, VALUE *resu
     VALUE object_class = json->object_class;
 
     if (json->max_nesting && json->current_nesting > json->max_nesting) {
-        rb_raise(eNestingError, "nesting of %d is to deep", json->current_nesting);
+        rb_raise(eNestingError, "nesting of %d is too deep", json->current_nesting);
     }
 
     *result = NIL_P(object_class) ? rb_hash_new() : rb_class_new_instance(0, 0, object_class);
@@ -336,7 +336,7 @@ static char *JSON_parse_array(JSON_Parser *json, char *p, char *pe, VALUE *resul
     VALUE array_class = json->array_class;
 
     if (json->max_nesting && json->current_nesting > json->max_nesting) {
-        rb_raise(eNestingError, "nesting of %d is to deep", json->current_nesting);
+        rb_raise(eNestingError, "nesting of %d is too deep", json->current_nesting);
     }
     *result = NIL_P(array_class) ? rb_ary_new() : rb_class_new_instance(0, 0, array_class);
 

data/lib/json/common.rb

@@ -310,6 +310,8 @@ module JSON
 end
 
 module ::Kernel
+  private
+
   # Outputs _objs_ to STDOUT as JSON strings in the shortest form, that is in
   # one line.
   def j(*objs)

data/lib/json/pure.rb

@@ -10,6 +10,9 @@ module JSON
     # An iconv instance to convert from UTF16 Big Endian to UTF8.
     UTF8toUTF16 = Iconv.new('utf-16be', 'utf-8') # :nodoc:
     UTF8toUTF16.iconv('no bom')
+  rescue LoadError
+    raise MissingUnicodeSupport,
+      "iconv couldn't be loaded, which is required for UTF-8/UTF-16 conversions"
   rescue Errno::EINVAL, Iconv::InvalidEncoding
     # Iconv doesn't support big endian utf-16. Let's try to hack this manually
     # into the converters.
@@ -51,9 +54,6 @@ module JSON
     ensure
       $VERBOSE = old_verbose
     end
-  rescue LoadError
-    raise MissingUnicodeSupport,
-      "iconv couldn't be loaded, which is required for UTF-8/UTF-16 conversions"
   end
 
   # Swap consecutive bytes of _string_ in place.

data/lib/json/pure/generator.rb

@@ -34,7 +34,6 @@ module JSON
     "\x1f" => '\u001f',
     '"'   =>  '\"',
     '\\'  =>  '\\\\',
-    '/'   =>  '\/',
   } # :nodoc:
 
   # Convert a UTF8 encoded Ruby string _string_ to a JSON string, encoded with
@@ -44,7 +43,7 @@ module JSON
       string = string.dup
       string << '' # XXX workaround: avoid buffer sharing
       string.force_encoding(Encoding::ASCII_8BIT)
-      string.gsub!(/["\\\/\x0-\x1f]/) { MAP[$&] }
+      string.gsub!(/["\\\x0-\x1f]/) { MAP[$&] }
       string.gsub!(/(
                       (?:
                         [\xc2-\xdf][\x80-\xbf]    |
@@ -64,7 +63,7 @@ module JSON
     end
   else
     def utf8_to_json(string) # :nodoc:
-      string = string.gsub(/["\\\/\x0-\x1f]/) { MAP[$&] }
+      string = string.gsub(/["\\\x0-\x1f]/) { MAP[$&] }
       string.gsub!(/(
                       (?:
                         [\xc2-\xdf][\x80-\xbf]    |

data/lib/json/pure/parser.rb

@@ -188,7 +188,7 @@ module JSON
       end
 
       def parse_array
-        raise NestingError, "nesting of #@current_nesting is to deep" if
+        raise NestingError, "nesting of #@current_nesting is too deep" if
           @max_nesting.nonzero? && @current_nesting > @max_nesting
         result = @array_class.new
         delim = false
@@ -220,7 +220,7 @@ module JSON
       end
 
       def parse_object
-        raise NestingError, "nesting of #@current_nesting is to deep" if
+        raise NestingError, "nesting of #@current_nesting is too deep" if
           @max_nesting.nonzero? && @current_nesting > @max_nesting
         result = @object_class.new
         delim = false

data/lib/json/version.rb

@@ -1,6 +1,6 @@
 module JSON
   # JSON version
-  VERSION         = '1.1.7'
+  VERSION         = '1.1.8'
   VERSION_ARRAY   = VERSION.split(/\./).map { |x| x.to_i } # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/tests/test_json.rb

@@ -230,7 +230,7 @@ EOT
     assert_equal json, JSON.unparse(data)
     assert_equal data, JSON.parse(json)
     #
-    json = '["\/"]'
+    json = '["/"]'
     data = JSON.parse(json)
     assert_equal ['/'], data
     assert_equal json, JSON.unparse(data)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: json_pure
 version: !ruby/object:Gem::Version 
-  version: 1.1.7
+  version: 1.1.8
 platform: ruby
 authors: 
 - Florian Frank
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-06-30 00:00:00 +02:00
+date: 2009-08-31 00:00:00 +02:00
 default_executable: edit_json.rb
 dependencies: []
 
@@ -23,131 +23,147 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- RUBY
 - CHANGES
-- bin/edit_json.rb
-- bin/prettify_json.rb
-- VERSION
+- COPYING
 - GPL
-- TODO
 - README
-- benchmarks/parser_benchmark.rb
-- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkPure.log
+- Rakefile
+- TODO
+- VERSION
+- benchmarks
+- benchmarks/data-p4-3GHz-ruby18
 - benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkComparison.log
-- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkYAML#parser.dat
-- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt#generator_safe.dat
-- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkExt#parser.dat
-- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt#generator_fast.dat
 - benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt#generator_fast-autocorrelation.dat
-- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkPure.log
-- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkExt#parser-autocorrelation.dat
-- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkRails#generator-autocorrelation.dat
+- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt#generator_fast.dat
+- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt#generator_pretty-autocorrelation.dat
+- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt#generator_pretty.dat
+- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt#generator_safe-autocorrelation.dat
+- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt#generator_safe.dat
 - benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt.log
 - benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkPure#generator_fast-autocorrelation.dat
 - benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkPure#generator_fast.dat
-- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkRails#parser.dat
 - benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkPure#generator_pretty-autocorrelation.dat
-- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkPure#parser-autocorrelation.dat
-- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt#generator_pretty.dat
+- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkPure#generator_pretty.dat
+- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkPure#generator_safe-autocorrelation.dat
+- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkPure#generator_safe.dat
+- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkPure.log
+- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkRails#generator-autocorrelation.dat
+- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkRails#generator.dat
 - benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkRails.log
+- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkComparison.log
+- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkExt#parser-autocorrelation.dat
+- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkExt#parser.dat
 - benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkExt.log
+- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkPure#parser-autocorrelation.dat
+- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkPure#parser.dat
+- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkPure.log
+- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkRails#parser-autocorrelation.dat
+- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkRails#parser.dat
 - benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkRails.log
-- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkComparison.log
-- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkPure#generator_safe.dat
-- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkRails#generator.dat
-- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt#generator_safe-autocorrelation.dat
-- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkPure#generator_pretty.dat
-- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkYAML.log
 - benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkYAML#parser-autocorrelation.dat
-- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkExt#generator_pretty-autocorrelation.dat
-- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkRails#parser-autocorrelation.dat
-- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkPure#parser.dat
-- benchmarks/data-p4-3GHz-ruby18/GeneratorBenchmarkPure#generator_safe-autocorrelation.dat
+- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkYAML#parser.dat
+- benchmarks/data-p4-3GHz-ruby18/ParserBenchmarkYAML.log
+- benchmarks/data
 - benchmarks/generator_benchmark.rb
+- benchmarks/parser_benchmark.rb
+- bin
+- bin/edit_json.rb
+- bin/prettify_json.rb
+- data
+- data/example.json
+- data/index.html
+- data/prototype.js
+- diagrams
+- doc-main.txt
+- ext
+- ext/json
+- ext/json/ext
+- ext/json/ext/generator
 - ext/json/ext/generator/extconf.rb
-- ext/json/ext/generator/unicode.c
 - ext/json/ext/generator/generator.c
+- ext/json/ext/generator/unicode.c
 - ext/json/ext/generator/unicode.h
+- ext/json/ext/parser
 - ext/json/ext/parser/extconf.rb
+- ext/json/ext/parser/parser.c
 - ext/json/ext/parser/parser.rl
 - ext/json/ext/parser/unicode.c
-- ext/json/ext/parser/parser.c
 - ext/json/ext/parser/unicode.h
-- Rakefile
-- tools/fuzz.rb
-- tools/server.rb
-- doc-templates/main.txt
+- install.rb
+- lib
 - lib/json.rb
-- lib/json/json.xpm
+- lib/json
+- lib/json/Array.xpm
+- lib/json/FalseClass.xpm
+- lib/json/Hash.xpm
 - lib/json/Key.xpm
-- lib/json/String.xpm
+- lib/json/NilClass.xpm
 - lib/json/Numeric.xpm
-- lib/json/Hash.xpm
-- lib/json/add/rails.rb
+- lib/json/String.xpm
+- lib/json/TrueClass.xpm
+- lib/json/add
 - lib/json/add/core.rb
+- lib/json/add/rails.rb
 - lib/json/common.rb
-- lib/json/Array.xpm
-- lib/json/FalseClass.xpm
+- lib/json/editor.rb
+- lib/json/ext.rb
+- lib/json/ext
+- lib/json/json.xpm
+- lib/json/pure.rb
+- lib/json/pure
 - lib/json/pure/generator.rb
 - lib/json/pure/parser.rb
-- lib/json/TrueClass.xpm
-- lib/json/pure.rb
 - lib/json/version.rb
-- lib/json/ext.rb
-- lib/json/editor.rb
-- lib/json/NilClass.xpm
-- data/example.json
-- data/index.html
-- data/prototype.js
-- tests/test_json_addition.rb
-- tests/fixtures/pass16.json
-- tests/fixtures/fail4.json
+- tests
+- tests/fixtures
 - tests/fixtures/fail1.json
-- tests/fixtures/fail28.json
-- tests/fixtures/fail8.json
-- tests/fixtures/fail19.json
-- tests/fixtures/pass2.json
-- tests/fixtures/pass26.json
-- tests/fixtures/pass1.json
-- tests/fixtures/fail3.json
-- tests/fixtures/fail20.json
-- tests/fixtures/pass3.json
-- tests/fixtures/pass15.json
+- tests/fixtures/fail10.json
+- tests/fixtures/fail11.json
 - tests/fixtures/fail12.json
 - tests/fixtures/fail13.json
+- tests/fixtures/fail14.json
+- tests/fixtures/fail18.json
+- tests/fixtures/fail19.json
+- tests/fixtures/fail2.json
+- tests/fixtures/fail20.json
+- tests/fixtures/fail21.json
 - tests/fixtures/fail22.json
+- tests/fixtures/fail23.json
 - tests/fixtures/fail24.json
-- tests/fixtures/fail9.json
-- tests/fixtures/fail2.json
-- tests/fixtures/fail14.json
+- tests/fixtures/fail25.json
+- tests/fixtures/fail27.json
+- tests/fixtures/fail28.json
+- tests/fixtures/fail3.json
+- tests/fixtures/fail4.json
+- tests/fixtures/fail5.json
 - tests/fixtures/fail6.json
-- tests/fixtures/fail21.json
 - tests/fixtures/fail7.json
+- tests/fixtures/fail8.json
+- tests/fixtures/fail9.json
+- tests/fixtures/pass1.json
+- tests/fixtures/pass15.json
+- tests/fixtures/pass16.json
 - tests/fixtures/pass17.json
-- tests/fixtures/fail11.json
-- tests/fixtures/fail25.json
-- tests/fixtures/fail5.json
-- tests/fixtures/fail18.json
-- tests/fixtures/fail27.json
-- tests/fixtures/fail10.json
-- tests/fixtures/fail23.json
-- tests/test_json_rails.rb
+- tests/fixtures/pass2.json
+- tests/fixtures/pass26.json
+- tests/fixtures/pass3.json
 - tests/test_json.rb
+- tests/test_json_addition.rb
+- tests/test_json_fixtures.rb
 - tests/test_json_generate.rb
+- tests/test_json_rails.rb
 - tests/test_json_unicode.rb
-- tests/test_json_fixtures.rb
-- install.rb
+- tools
+- tools/fuzz.rb
+- tools/server.rb
 has_rdoc: true
 homepage: http://json.rubyforge.org
-licenses: []
-
 post_install_message: 
 rdoc_options: 
 - --title
 - JSON -- A JSON implemention
 - --main
-- JSON
-- --line-numbers
+- doc-main.txt
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -165,14 +181,14 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: json
-rubygems_version: 1.3.2
+rubygems_version: 1.3.1
 signing_key: 
-specification_version: 3
+specification_version: 2
 summary: A JSON implementation in Ruby
 test_files: 
-- tests/test_json_addition.rb
-- tests/test_json_rails.rb
 - tests/test_json.rb
+- tests/test_json_addition.rb
+- tests/test_json_fixtures.rb
 - tests/test_json_generate.rb
+- tests/test_json_rails.rb
 - tests/test_json_unicode.rb
-- tests/test_json_fixtures.rb

data/doc-templates/main.txt

@@ -1,283 +0,0 @@
-# = json - JSON for Ruby
-#
-# == Description
-#
-# This is a implementation of the JSON specification according to RFC 4627
-# (http://www.ietf.org/rfc/rfc4627.txt). Starting from version 1.0.0 on there
-# will be two variants available:
-#
-# * A pure ruby variant, that relies on the iconv and the stringscan
-#   extensions, which are both part of the ruby standard library.
-# * The quite a bit faster C extension variant, which is in parts implemented
-#   in C and comes with its own unicode conversion functions and a parser
-#   generated by the ragel state machine compiler
-#   (http://www.cs.queensu.ca/~thurston/ragel).
-#
-# Both variants of the JSON generator escape all non-ASCII an control
-# characters with \uXXXX escape sequences, and support UTF-16 surrogate pairs
-# in order to be able to generate the whole range of unicode code points. This
-# means that generated JSON text is encoded as UTF-8 (because ASCII is a subset
-# of UTF-8) and at the same time avoids decoding problems for receiving
-# endpoints, that don't expect UTF-8 encoded texts. On the negative side this
-# may lead to a bit longer strings than necessarry.
-#
-# All strings, that are to be encoded as JSON strings, should be UTF-8 byte
-# sequences on the Ruby side. To encode raw binary strings, that aren't UTF-8
-# encoded, please use the to_json_raw_object method of String (which produces
-# an object, that contains a byte array) and decode the result on the receiving
-# endpoint.
-#
-# == Author
-#
-# Florian Frank <mailto:flori@ping.de>
-#
-# == License
-#
-# This software is distributed under the same license as Ruby itself, see
-# http://www.ruby-lang.org/en/LICENSE.txt.
-#
-# == Download
-#
-# The latest version of this library can be downloaded at
-#
-# * http://rubyforge.org/frs?group_id=953
-#
-# Online Documentation should be located at
-#
-# * http://json.rubyforge.org
-#
-# == Usage
-# 
-# To use JSON you can
-#   require 'json'
-# to load the installed variant (either the extension 'json' or the pure
-# variant 'json_pure'). If you have installed the extension variant, you can
-# pick either the extension variant or the pure variant by typing
-#   require 'json/ext'
-# or
-#   require 'json/pure'
-#
-# You can choose to load a set of common additions to ruby core's objects if
-# you
-#   require 'json/add/core'
-#
-# After requiring this you can, e. g., serialise/deserialise Ruby ranges:
-#
-#   JSON JSON(1..10) # => 1..10
-#
-# To find out how to add JSON support to other or your own classes, read the
-# Examples section below.
-#
-# To get the best compatibility to rails' JSON implementation, you can
-#   require 'json/add/rails'
-#
-# Both of the additions attempt to require 'json' (like above) first, if it has
-# not been required yet.
-#
-# == Speed Comparisons
-#
-# I have created some benchmark results (see the benchmarks/data-p4-3Ghz
-# subdir of the package) for the JSON-parser to estimate the speed up in the C
-# extension:
-#
-#  Comparing times (call_time_mean):
-#   1 ParserBenchmarkExt#parser   900 repeats:
-#         553.922304770 (  real) ->   21.500x 
-#           0.001805307
-#   2 ParserBenchmarkYAML#parser  1000 repeats:
-#         224.513358139 (  real) ->    8.714x 
-#           0.004454078
-#   3 ParserBenchmarkPure#parser  1000 repeats:
-#          26.755020642 (  real) ->    1.038x 
-#           0.037376163
-#   4 ParserBenchmarkRails#parser 1000 repeats:
-#          25.763381731 (  real) ->    1.000x 
-#           0.038814780
-#             calls/sec (  time) ->    speed  covers
-#             secs/call
-#
-# In the table above 1 is JSON::Ext::Parser, 2 is YAML.load with YAML
-# compatbile JSON document, 3 is is JSON::Pure::Parser, and 4 is
-# ActiveSupport::JSON.decode. The ActiveSupport JSON-decoder converts the
-# input first to YAML and then uses the YAML-parser, the conversion seems to
-# slow it down so much that it is only as fast as the JSON::Pure::Parser!
-#
-# If you look at the benchmark data you can see that this is mostly caused by
-# the frequent high outliers - the median of the Rails-parser runs is still
-# overall smaller than the median of the JSON::Pure::Parser runs:
-#
-#  Comparing times (call_time_median):
-#   1 ParserBenchmarkExt#parser   900 repeats:
-#         800.592479481 (  real) ->   26.936x 
-#           0.001249075
-#   2 ParserBenchmarkYAML#parser  1000 repeats:
-#         271.002390644 (  real) ->    9.118x 
-#           0.003690004
-#   3 ParserBenchmarkRails#parser 1000 repeats:
-#          30.227910865 (  real) ->    1.017x 
-#           0.033082008
-#   4 ParserBenchmarkPure#parser  1000 repeats:
-#          29.722384421 (  real) ->    1.000x 
-#           0.033644676
-#             calls/sec (  time) ->    speed  covers
-#             secs/call
-#
-# I have benchmarked the JSON-Generator as well. This generated a few more
-# values, because there are different modes that also influence the achieved
-# speed:
-#
-#  Comparing times (call_time_mean):
-#   1 GeneratorBenchmarkExt#generator_fast    1000 repeats:
-#         547.354332608 (  real) ->   15.090x 
-#           0.001826970
-#   2 GeneratorBenchmarkExt#generator_safe    1000 repeats:
-#         443.968212317 (  real) ->   12.240x 
-#           0.002252414
-#   3 GeneratorBenchmarkExt#generator_pretty  900 repeats:
-#         375.104545883 (  real) ->   10.341x 
-#           0.002665923
-#   4 GeneratorBenchmarkPure#generator_fast   1000 repeats:
-#          49.978706968 (  real) ->    1.378x 
-#           0.020008521
-#   5 GeneratorBenchmarkRails#generator       1000 repeats:
-#          38.531868759 (  real) ->    1.062x 
-#           0.025952543
-#   6 GeneratorBenchmarkPure#generator_safe   1000 repeats:
-#          36.927649925 (  real) ->    1.018x 7 (>=3859)
-#           0.027079979
-#   7 GeneratorBenchmarkPure#generator_pretty 1000 repeats:
-#          36.272134441 (  real) ->    1.000x 6 (>=3859)
-#           0.027569373
-#             calls/sec (  time) ->    speed  covers
-#             secs/call
-#
-# In the table above 1-3 are JSON::Ext::Generator methods. 4, 6, and 7 are
-# JSON::Pure::Generator methods and 5 is the Rails JSON generator. It is now a
-# bit faster than the generator_safe and generator_pretty methods of the pure
-# variant but slower than the others.
-#
-# To achieve the fastest JSON text output, you can use the fast_generate
-# method. Beware, that this will disable the checking for circular Ruby data
-# structures, which may cause JSON to go into an infinite loop.
-#
-# Here are the median comparisons for completeness' sake:
-#
-#  Comparing times (call_time_median):
-#   1 GeneratorBenchmarkExt#generator_fast    1000 repeats:
-#         708.258020939 (  real) ->   16.547x 
-#           0.001411915
-#   2 GeneratorBenchmarkExt#generator_safe    1000 repeats:
-#         569.105020353 (  real) ->   13.296x 
-#           0.001757145
-#   3 GeneratorBenchmarkExt#generator_pretty  900 repeats:
-#         482.825371244 (  real) ->   11.280x 
-#           0.002071142
-#   4 GeneratorBenchmarkPure#generator_fast   1000 repeats:
-#          62.717626652 (  real) ->    1.465x 
-#           0.015944481
-#   5 GeneratorBenchmarkRails#generator       1000 repeats:
-#          43.965681162 (  real) ->    1.027x 
-#           0.022745013
-#   6 GeneratorBenchmarkPure#generator_safe   1000 repeats:
-#          43.929073409 (  real) ->    1.026x 7 (>=3859)
-#           0.022763968
-#   7 GeneratorBenchmarkPure#generator_pretty 1000 repeats:
-#          42.802514491 (  real) ->    1.000x 6 (>=3859)
-#           0.023363113
-#             calls/sec (  time) ->    speed  covers
-#             secs/call
-#
-# == Examples
-#
-# To create a JSON text from a ruby data structure, you can call JSON.generate
-# like that:
-#
-#  json = JSON.generate [1, 2, {"a"=>3.141}, false, true, nil, 4..10]
-#  # => "[1,2,{\"a\":3.141},false,true,null,\"4..10\"]"
-#
-# To create a valid JSON text you have to make sure, that the output is
-# embedded in either a JSON array [] or a JSON object {}. The easiest way to do
-# this, is by putting your values in a Ruby Array or Hash instance.
-#
-# To get back a ruby data structure from a JSON text, you have to call
-# JSON.parse on it:
-#
-#  JSON.parse json
-#  # => [1, 2, {"a"=>3.141}, false, true, nil, "4..10"]
-# 
-# Note, that the range from the original data structure is a simple
-# string now. The reason for this is, that JSON doesn't support ranges
-# or arbitrary classes. In this case the json library falls back to call
-# Object#to_json, which is the same as #to_s.to_json.
-#
-# It's possible to add JSON support serialization to arbitrary classes by
-# simply implementing a more specialized version of the #to_json method, that
-# should return a JSON object (a hash converted to JSON with #to_json) like
-# this (don't forget the *a for all the arguments):
-#
-#  class Range
-#    def to_json(*a)
-#      {
-#        'json_class'   => self.class.name, # = 'Range'
-#        'data'         => [ first, last, exclude_end? ]
-#      }.to_json(*a)
-#    end
-#  end
-#
-# The hash key 'json_class' is the class, that will be asked to deserialise the
-# JSON representation later. In this case it's 'Range', but any namespace of
-# the form 'A::B' or '::A::B' will do. All other keys are arbitrary and can be
-# used to store the necessary data to configure the object to be deserialised.
-#
-# If a the key 'json_class' is found in a JSON object, the JSON parser checks
-# if the given class responds to the json_create class method. If so, it is
-# called with the JSON object converted to a Ruby hash. So a range can
-# be deserialised by implementing Range.json_create like this:
-# 
-#  class Range
-#    def self.json_create(o)
-#      new(*o['data'])
-#    end
-#  end
-#
-# Now it possible to serialise/deserialise ranges as well:
-#
-#  json = JSON.generate [1, 2, {"a"=>3.141}, false, true, nil, 4..10]
-#  # => "[1,2,{\"a\":3.141},false,true,null,{\"json_class\":\"Range\",\"data\":[4,10,false]}]"
-#  JSON.parse json
-#  # => [1, 2, {"a"=>3.141}, false, true, nil, 4..10]
-#
-# JSON.generate always creates the shortest possible string representation of a
-# ruby data structure in one line. This good for data storage or network
-# protocols, but not so good for humans to read. Fortunately there's also
-# JSON.pretty_generate (or JSON.pretty_generate) that creates a more
-# readable output:
-#
-#  puts JSON.pretty_generate([1, 2, {"a"=>3.141}, false, true, nil, 4..10])
-#  [
-#    1,
-#    2,
-#    {
-#      "a": 3.141
-#    },
-#    false,
-#    true,
-#    null,
-#    {
-#      "json_class": "Range",
-#      "data": [
-#        4,
-#        10,
-#        false
-#      ]
-#    }
-#  ]
-#
-# There are also the methods Kernel#j for generate, and Kernel#jj for
-# pretty_generate output to the console, that work analogous to Core Ruby's p
-# and the pp library's pp methods.
-#
-# The script tools/server.rb contains a small example if you want to test, how
-# receiving a JSON object from a webrick server in your browser with the
-# javasript prototype library (http://www.prototypejs.org) works.
-#