tidy_json 0.2.2 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e53774339fb56a01ae47f0dd087159e9a1d2fa070dccda937d5a7de399e07ba9
-  data.tar.gz: 9f6736f1c5ef84b2d4e89b507b7fa417b3ab713b01226c55c86afc54d07699ab
+  metadata.gz: 53537db0fe360e1e7d7fe1ba75cb91418c6efa9ee9f108c2f8a2e3020bffed39
+  data.tar.gz: f665d2faff39441554d62de9cf91a6af9462d146501f1ba979d0b5ea21785e9d
 SHA512:
-  metadata.gz: f35fe6a646a7e47c5926e04a10222cd483f45d177d3808d3de51040404b6d9ab4fdee940ceb077dba5e74b55ca171699331896485091e6c0c1a0f7c9f1ecb422
-  data.tar.gz: d599497adc2efb538341d2b4ad09b9b7b9f47ffd30ee056f9c47ceeda42953a6a23eb8266aa87c7ed220424a4a68ec323c864f10e7a78618bd1688dd4e4d627e
+  metadata.gz: 01d9f6899b775b39c1cad8acbdf9bdbf563f5a61bd74ca5e395c47d0acb0cc8f963328d5a617c2366aeccd70d5b2f2d423c59485e828055e8743b945e45afd52
+  data.tar.gz: ae1c4ce4ee8b0b123b3627c694bfb9a2acec49b53387d830ce6acd2215347305552e6fbe2248197991f47ab0be07cd2888c824bb71fee3f56a86678dd05a063c

data/.yardopts

@@ -1 +1,3 @@
---private lib/*.rb lib/tidy_json/version.rb - README.md LICENSE
+--exclude lib/tidy_json/dedication.rb
+--private lib/**/*.rb
+--files README.md,LICENSE

data/Gemfile

@@ -7,3 +7,10 @@ gemspec
 group :test do
   gem 'rake'
 end
+
+group :development do
+  install_if -> { ENV['COVERAGE'] } do
+    gem 'simplecov'
+    gem 'simplecov-cobertura'
+  end
+end

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019-2020 Robert Di Pardo
+Copyright (c) 2019-2021 Robert Di Pardo
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,6 +1,6 @@
 # tidy_json
 
-[![Build Status][travis_build_status_badge]][travis_build_status]  [![cci_build_status_badge]][cci_build_status]  [![Gem Version][gem_version_badge]][gem_version]
+![Gem Version][gem_version_badge]  ![Downloads][gem_downloads]  [![Travis CI][travis_build_status_badge]][travis_build_status]  [![codecov][codecov_badge]][codecov_status]
 
 A mixin providing (recursive) JSON serialization and pretty printing.
 
@@ -19,6 +19,13 @@ gem 'tidy_json'
 # ...
 ```
 
+### Formatting Options
+
+As of version [0.3.0][], most of the same options accepted by [`JSON.generate`][]
+can be passed to `#write_json`, `#to_tidy_json`, or `TidyJson.tidy`.
+
+See [the docs][] for a current list of options and their default values.
+
 ### Example
 
 ```ruby
@@ -27,22 +34,27 @@ require 'tidy_json'
 class Jsonable
   attr_reader :a, :b
   def initialize
-    @a = { a: 'uno', f: ['I', 'II', 'III', ['i.', 'ii.', 'iii.', { 'ichi': "\u{4e00}", 'ni': "\u{4e8c}", 'san': "\u{4e09}", 'yon': "\u{56db}" }]], b: 'dos' }
-    @b = { z: { iv: 4, ii: 'duos', iii: 3, i: 'one' }, b: ['two', 3, '<abbr title="four">IV</abbr>'], a: 1, f: %w[x y z] }
+    @a = { a: 'uno', f: ['I', 'II', 'III', ['i.', 'ii.', 'iii.', { 'ichi': "\u{4e00}", 'ni': "\u{4e8c}", 'san': "\u{4e09}", 'yon': "\u{56db}" }]], c: {}, b: 'dos', e: [[]] }
+    @b = { z: { iv: 4, ii: 'dos', iii: 3, i: 'uno' }, b: ['deux', 3, '<abbr title="four">IV</abbr>'], a: 1, g: [{ none: [] }], f: %w[x y z] }
   end
 end
 
 my_jsonable = Jsonable.new
+# => #<Jsonable:0x000055790c93e768 @a={:a=>"uno", :f=>["I", "II", "III", ["i.", "ii.", "iii.", {:ichi=>"一", :ni=>"二", :san=>"三", :yon=>"四"}]], :c=>{}, :b=>"dos", :e=>[[]]}, @b={:z=>{:iv=>4, :ii=>"dos", :iii=>3, :i=>"uno"}, :b=>["deux", 3, "<abbr title=\"four\">IV</abbr>"], :a=>1, :g=>[{:none=>[]}], :f=>["x", "y", "z"]}>
 
 JSON.parse my_jsonable.stringify
-# => {"class"=>"Jsonable", "a"=>{"a"=>"uno", "f"=>["I", "II", "III", ["i.", "ii.", "iii.", {"ichi"=>"一", "ni"=>"二", "san"=>"三", "yon"=>"四"}]], "b"=>"dos"}, "b"=>{"z"=>{"iv"=>4, "ii"=>"duos", "iii"=>3, "i"=>"one"}, "b"=>["two", 3, "<abbr title=\"four\">IV</abbr>"], "a"=>1, "f"=>["x", "y", "z"]}}
+# => "{\"class\":\"Jsonable\",\"a\":{\"a\":\"uno\",\"f\":[\"I\",\"II\",\"III\",[\"i.\",\"ii.\",\"iii.\",{\"ichi\":\"一\",\"ni\":\"二\",\"san\":\"三\",\"yon\":\"四\"}]],\"c\":{},\"b\":\"dos\",\"e\":[[]]},\"b\":{\"z\":{\"iv\":4,\"ii\":\"dos\",\"iii\":3,\"i\":\"uno\"},\"b\":[\"deux\",3,\"<abbr title=\\\"four\\\">IV</abbr>\"],\"a\":1,\"g\":[{\"none\":[]}],\"f\":[\"x\",\"y\",\"z\"]}}"
 
-puts my_jsonable.to_tidy_json(indent: 4, sort: true)
+puts my_jsonable.to_tidy_json(indent: 4, sort: true, space_before: 2, ascii_only: true)
 # {
-#     "a": {
-#         "a": "uno",
-#         "b": "dos",
-#         "f": [
+#     "a"  : {
+#         "a"  : "uno",
+#         "b"  : "dos",
+#         "c"  : {},
+#         "e"  : [
+#             []
+#         ],
+#         "f"  : [
 #             "I",
 #             "II",
 #             "III",
@@ -51,54 +63,88 @@ puts my_jsonable.to_tidy_json(indent: 4, sort: true)
 #                 "ii.",
 #                 "iii.",
 #                 {
-#                     "ichi": "一",
-#                     "ni": "二",
-#                     "san": "三",
-#                     "yon": "四"
+#                     "ichi"  : "\u4e00",
+#                     "ni"  : "\u4e8c",
+#                     "san"  : "\u4e09",
+#                     "yon"  : "\u56db"
 #                 }
 #             ]
 #         ]
 #     },
-#     "b": {
-#         "a": 1,
-#         "b": [
-#             "two",
+#     "b"  : {
+#         "a"  : 1,
+#         "b"  : [
+#             "deux",
 #             3,
 #             "<abbr title=\"four\">IV</abbr>"
 #         ],
-#         "f": [
+#         "f"  : [
 #             "x",
 #             "y",
 #             "z"
 #         ],
-#         "z": {
-#             "i": "one",
-#             "ii": "duos",
-#             "iii": 3,
-#             "iv": 4
+#         "g"  : [
+#             {
+#                 "none"  : []
+#             }
+#         ],
+#         "z"  : {
+#             "i"  : "uno",
+#             "ii"  : "dos",
+#             "iii"  : 3,
+#             "iv"  : 4
 #         }
 #     },
-#     "class": "Jsonable"
+#     "class"  : "Jsonable"
 # }
 # => nil
 ```
 
-### Dependencies
+### Command Line Usage
 
-#### Runtime
-- [json](https://rubygems.org/gems/json) ~> 2.2
+After [installing the gem][], pass the name of a file containing JSON to `jtidy`
+(with or without a file extension). Run `jtidy -h` for a complete list of
+formatting options:
 
-#### Building
-- [test-unit](https://rubygems.org/gems/test-unit) ~> 3.3
-- [yard](https://rubygems.org/gems/yard) ~> 0.9
+```
+jtidy FILE[.json] [-d out[.json]] [-i [2,4,6,8,10,12]] [-p [1..8]] [-v [1..8]] [-o D] [-a D] [-m N] [-e] [-A] [-N] [-s] [-f] [-P]
+    -d, --dest out[.json]            Name of output file
+    -i, --indent [2,4,6,8,10,12]     The number of spaces to indent each object member [2]
+    -p, --prop-name-space [1..8]     The number of spaces to put after property names [0]
+    -v, --value-space [1..8]         The number of spaces to put before property values [1]
+    -o, --object-delim D             A string of whitespace to delimit object members [\n]
+    -a, --array-delim D              A string of whitespace to delimit array elements [\n]
+    -m, --max-nesting N              The maximum level of data structure nesting in the generated JSON; 0 == "no depth checking" [100]
+    -e, --escape                     Escape /'s [false]
+    -A, --ascii                      Generate ASCII characters only [false]
+    -N, --nan                        Allow NaN, Infinity and -Infinity [false]
+    -s, --sort                       Sort property names [false]
+    -f, --force                      Overwrite source file [false]
+    -P, --preview                    Show preview of output [false]
+    -V, --version                    Show version
+    -h, --help                       Show this help message
+```
 
-### License
-[MIT](https://github.com/rdipardo/tidy_json/blob/master/LICENSE)
+### Notice
+The `jtidy` executable bundled with this gem is in no way affiliated with, nor based on,
+the HTML parser and pretty printer [of the same name](https://github.com/jtidy/jtidy).
 
+The JTidy source code and binaries are licensed under the terms of the Zlib-Libpng License.
+More information is available [here](https://github.com/jtidy/jtidy/blob/master/LICENSE.txt).
 
-[travis_build_status]: https://travis-ci.com/rdipardo/tidy_json
-[cci_build_status]: https://circleci.com/gh/rdipardo/tidy_json/tree/master
-[cci_build_status_badge]: https://circleci.com/gh/rdipardo/tidy_json.svg?style=svg
-[travis_build_status_badge]: https://travis-ci.com/rdipardo/tidy_json.svg?branch=master
-[gem_version]: https://badge.fury.io/rb/tidy_json
-[gem_version_badge]: https://badge.fury.io/rb/tidy_json.svg
+### License
+Distributed under the terms of the [MIT License][].
+
+
+[travis_build_status]: https://app.travis-ci.com/github/rdipardo/tidy_json
+[travis_build_status_badge]: https://app.travis-ci.com/rdipardo/tidy_json.svg?branch=master
+[codecov_status]: https://codecov.io/gh/rdipardo/tidy_json/branch/master
+[codecov_badge]: https://codecov.io/gh/rdipardo/tidy_json/branch/master/graph/badge.svg
+[gem_version_badge]: https://img.shields.io/gem/v/tidy_json?color=%234ec820&label=gem%20version&logo=ruby&logoColor=%23e9573f
+[gem_downloads]: https://img.shields.io/gem/dt/tidy_json?logo=ruby&logoColor=%23e9573f
+[MIT License]: https://github.com/rdipardo/tidy_json/blob/master/LICENSE
+[installing the gem]: https://github.com/rdipardo/tidy_json#installation
+<!-- API spec -->
+[`JSON.generate`]: https://github.com/flori/json/blob/d49c5de49e54a5ad3f6fcf587f98d63266ef9439/lib/json/pure/generator.rb#L111
+[the docs]: https://rubydoc.org/github/rdipardo/tidy_json/TidyJson/Formatter#initialize-instance_method
+[0.3.0]: https://github.com/rdipardo/tidy_json/releases/tag/v0.3.0

data/bin/jtidy

@@ -0,0 +1,143 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'optparse'
+require 'tidy_json'
+require_relative 'jtidy_info'
+
+class Jtidy # :nodoc:
+  OPTIONS = {
+    '-d out[.json]': [:dest, String, '--dest', 'Name of output file'],
+    '-i [2,4,6,8,10,12]': [:indent, Integer, '--indent [2,4,6,8,10,12]',
+                           'The number of spaces to indent each object member [2]'],
+    '-p [1..8]': [:space_before, Integer, '--prop-name-space [1..8]',
+                  'The number of spaces to put after property names [0]'],
+    '-v [1..8]': [:space, Integer, '--value-space [1..8]',
+                  'The number of spaces to put before property values [1]'],
+    '-o D': [:object_nl, String, '--object-delim D',
+             'A string of whitespace to delimit object members [\n]'],
+    '-a D': [:array_nl, String, '--array-delim D',
+             'A string of whitespace to delimit array elements [\n]'],
+    '-m N': [:max_nesting, Integer, '--max-nesting N',
+             'The maximum level of data structure nesting in the generated ' \
+             'JSON; 0 == "no depth checking" [100]'],
+    '-e': [:escape_slash, nil, '--escape', 'Escape /\'s [false]'],
+    '-A': [:ascii_only, nil, '--ascii', 'Generate ASCII characters only [false]'],
+    '-N': [:allow_nan, nil, '--nan', 'Allow NaN, Infinity and -Infinity [false]'],
+    '-s': [:sort, nil, '--sort', 'Sort property names [false]'],
+    '-f': [:force, nil, '--force', 'Overwrite source file [false]'],
+    # script-only options
+    '-P': [:preview, nil, '--preview', 'Show preview of output [false]']
+  }.freeze
+
+  def self.unescape(str)
+    str.gsub(/\\b|\\h|\\n|\\r|\\s|\\t|\\v/,
+             {
+               '\\b': "\b",
+               '\\h': "\h",
+               '\\n': "\n",
+               '\\r': "\r",
+               '\\s': "\s",
+               '\\t': "\t",
+               '\\v': "\v"
+             })
+  end
+
+  def self.show_unused(opts)
+    return if opts.empty?
+
+    ignored = opts.keys.map do |key|
+      (OPTIONS.keys.select do |k|
+        OPTIONS[k][0].eql? key
+      end.first || '')[0..1]
+    end
+    warn "Ignoring options: #{(ignored.join ', ')}"
+  end
+
+  def self.parse(options)
+    format_options = {}
+    OptionParser.new do |opts|
+      opts.banner = \
+        "#{File.basename __FILE__} FILE[.json] " \
+        "#{(OPTIONS.keys.map { |k| "[#{k}]" }).join ' '}"
+      OPTIONS.each_key do |k|
+        opt, type, long_name, desc = OPTIONS[k]
+        opts.on(k, long_name, type, desc) do |v|
+          format_options[opt] = (type == String ? unescape(v) : v)
+        end
+      end
+
+      opts.on_tail('-V', '--version', 'Show version') do
+        show_unused format_options
+        puts ::JtidyInfo.new.to_s
+        exit 0
+      end
+
+      opts.on_tail('-h', '--help', 'Show this help message') do
+        show_unused format_options
+        puts opts
+        exit 0
+      end
+    end.parse! options
+
+    format_options
+  end
+
+  private_class_method :unescape, :show_unused
+end
+
+begin
+  begin
+    OPTS = Jtidy.parse(ARGV).freeze
+    INPUT_FILE = ARGV[0].freeze
+  rescue OptionParser::InvalidOption => e
+    warn e.message.capitalize
+    raise OptionParser::InvalidArgument
+  end
+
+  if !(INPUT_FILE.nil? || INPUT_FILE.strip.empty?)
+    tidy = ''
+    fname = INPUT_FILE.strip.gsub('\\', '/')
+    ext = File.extname(fname)
+    input = File.join(
+      File.expand_path(File.dirname(fname)), File.basename(fname, ext)
+    ).to_s
+    outfile = unless OPTS[:dest].nil? || OPTS[:dest].strip.empty?
+                fname = OPTS[:dest].strip.gsub('\\', '/')
+                ext = File.extname(fname)
+                File.join(
+                  File.expand_path(File.dirname(fname)), File.basename(fname, ext)
+                ).to_s
+              end
+
+    begin
+      File.open((input + '.json'), 'r') do |json|
+        begin
+          tidy = TidyJson.tidy(JSON.parse(json.read.strip), OPTS)
+        rescue JSON::JSONError => e
+          warn "#{__FILE__}.#{__LINE__}: #{e.message}"
+        end
+      end
+
+      if tidy.length.positive?
+        output = (if OPTS[:force]
+                    outfile.nil? ? input : outfile
+                  elsif Regexp.new("(#{outfile})", Regexp::IGNORECASE) =~ input
+                    warn "Can't overwrite #{input}.json without '--force' option"
+                    "#{input}-tidy"
+                  else outfile
+                  end) + '.json'
+        File.open(output, 'w') { |fd| fd.write(tidy) }
+        puts "\nWrote: #{output}"
+        puts "#{tidy[0..1024]}\n . . ." if OPTS[:preview]
+      end
+    rescue Errno::ENOENT, Errno::EACCES, IOError => e
+      warn "#{__FILE__}.#{__LINE__}: #{e.message}"
+    end
+
+  else
+    Jtidy.parse %w[--help]
+  end
+rescue OptionParser::InvalidArgument, OptionParser::MissingArgument
+  Jtidy.parse %w[--help]
+end

data/bin/jtidy_info.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module TidyJson # :nodoc:
+  class JtidyInfo
+    NOTICE = [
+      '#',
+      '# jtidy is in no way affiliated with, nor based on, ',
+      '# the HTML parser and pretty printer of the same name.',
+      '#',
+      '# The JTidy source code and binaries are licensed under',
+      '# the terms of the Zlib-Libpng License.',
+      '#',
+      '# More information is available here:',
+      '# https://github.com/jtidy/jtidy/blob/master/LICENSE.txt',
+      '#'
+    ].join("\n").freeze
+
+    attr_reader :meta
+
+    def initialize
+      gem = Gem::Specification.find_by_name('tidy_json')
+      @meta = {
+        name: "# jtidy #{gem.version}",
+        license: "# License: #{gem.license}",
+        bugs: "# Bugs: #{gem.metadata['bug_tracker_uri']}",
+        notice: NOTICE
+      }
+    end
+
+    def to_s
+      (@meta.values.join "\n").freeze
+    end
+  end
+end

data/lib/tidy_json/dedication.rb

@@ -7,8 +7,14 @@ module TidyJson # :nodoc:
                "#{'.' * 17} to the memory of #{'.' * 17}\n#{'.' * 52}\n" \
                "#{'.' * 17} MICHAEL DI PARDO #{'.' * 17}\n#{'.' * 52}\n" \
                "#{'.' * 12} Please consider supporting #{'.' * 12}\n" \
-               "#{'.' * 13} the MS Society of Canada #{'.' * 13}\n" \
+               "#{'.' * 11} multiple sclerosis research: #{'.' * 11}\n" \
                "#{'.' * 52}\n" \
+               "#{'.' * 23} (US) #{'.' * 23}\n" \
+               "#{'.' * 5} https://www.nationalmssociety.org/Donate " \
+               "#{'.' * 5}\n" \
+               "#{'.' * 21} (Canada) #{'.' * 21}\n" \
                "#{'.' * 8} https://mssociety.ca/get-involved #{'.' * 9}\n" \
-               "#{'.' * 52}\n\n"
+               "#{'.' * 23} (UK) #{'.' * 23}\n" \
+               "#{'.' * 4} https://www.mssociety.org.uk/get-involved "\
+               "#{'.' * 5}\n#{'.' * 52}\n\n"
 end

data/lib/tidy_json/formatter.rb

@@ -0,0 +1,238 @@
+# frozen_string_literal: false
+
+module TidyJson
+  ##
+  # A purpose-built JSON formatter.
+  #
+  # @api private
+  class Formatter
+    # @return [Hash] the JSON format options specified by this +Formatter+
+    #   instance.
+    attr_reader :format
+
+    ##
+    # Returns a new instance of +Formatter+.
+    #
+    # @param opts [Hash] Formatting options.
+    # @option opts [[2,4,6,8,10,12]] :indent (2) The number of spaces to indent
+    #   each object member.
+    # @option opts [[1..8]] :space_before (0) The number of spaces to put after
+    #   property names.
+    # @option opts [[1..8]] :space (1) The number of spaces to put before
+    #   property values.
+    # @option opts [String] :object_nl ("\n") A string of whitespace to delimit
+    #   object members.
+    # @option opts [String] :array_nl ("\n") A string of whitespace to delimit
+    #   array elements.
+    # @option opts [Numeric] :max_nesting (100) The maximum level of data
+    #   structure nesting in the generated JSON. Disable depth checking by
+    #   passing +max_nesting: 0+.
+    # @option opts [Boolean] :escape_slash (false) Whether or not a forward
+    #   slash (/) should be escaped.
+    # @option opts [Boolean] :ascii_only (false) Whether or not only ASCII
+    #   characters should be generated.
+    # @option opts [Boolean] :allow_nan (false) Whether or not to allow +NaN+,
+    #   +Infinity+ and +-Infinity+. If +false+, an exception is thrown if one
+    #   of these values is encountered.
+    # @option opts [Boolean] :sort (false) Whether or not object members should
+    #   be sorted by property name.
+    # @see https://github.com/flori/json/blob/b8c1c640cd375f2e2ccca1b18bf943f80ad04816/lib/json/pure/generator.rb#L111 JSON::Pure::Generator
+    def initialize(opts = {})
+      # The number of times to reduce the left indent of a nested array's
+      # opening bracket
+      @left_bracket_offset = 0
+
+      # True if printing a nested array
+      @need_offset = false
+
+      valid_indent = (2..12).step(2).include?(opts[:indent])
+      valid_space_before = (1..8).include?(opts[:space_before])
+      valid_space_after = (1..8).include?(opts[:space])
+      # don't test for the more explicit :integer? method because it's defined
+      # for floating point numbers also
+      valid_depth = opts[:max_nesting] >= 0 \
+                    if opts[:max_nesting].respond_to?(:times)
+      valid_newline = ->(str) { str.respond_to?(:strip) && str.strip.empty? }
+      @format = {
+        indent: "\s" * (valid_indent ? opts[:indent] : 2),
+        space_before: "\s" * (valid_space_before ? opts[:space_before] : 0),
+        space: "\s" * (valid_space_after ? opts[:space] : 1),
+        object_nl: (valid_newline.call(opts[:object_nl]) ? opts[:object_nl] : "\n"),
+        array_nl: (valid_newline.call(opts[:array_nl]) ? opts[:array_nl] : "\n"),
+        max_nesting: valid_depth ? opts[:max_nesting] : 100,
+        escape_slash: opts[:escape_slash] || false,
+        ascii_only: opts[:ascii_only] || false,
+        allow_nan: opts[:allow_nan] || false,
+        sorted: opts[:sort] || false
+      }
+    end
+    # ~Formatter#initialize
+
+    ##
+    # Returns the given +node+ as pretty-printed JSON.
+    #
+    # @param node [#to_s] A visible attribute of +obj+.
+    # @param obj [{Object => #to_s}, <#to_s>] The enumerable object
+    #   containing +node+.
+    # @return [String] A formatted string representation of +node+.
+    def format_node(node, obj)
+      str = ''
+      indent = @format[:indent]
+
+      is_last = (obj.length <= 1) ||
+                (obj.length > 1 &&
+                  (obj.instance_of?(Array) &&
+                    !(node === obj.first) &&
+                      (obj.size.pred == obj.rindex(node))))
+
+      if node.instance_of?(Array)
+        str << '['
+        str << "\n" unless node.empty?
+
+        # format array elements
+        node.each do |elem|
+          if elem.instance_of?(Hash)
+            str << "#{indent * 2}{"
+            str << "\n" unless elem.empty?
+
+            elem.each_with_index do |inner_h, h_idx|
+              str << "#{indent * 3}\"#{inner_h.first}\": "
+              str << node_to_str(inner_h.last, 4)
+              str << ',' unless h_idx == elem.to_a.length.pred
+              str << "\n"
+            end
+
+            str << (indent * 2).to_s unless elem.empty?
+            str << '}'
+
+          # element a scalar, or a nested array
+          else
+            is_nested_array = elem.instance_of?(Array) &&
+                              elem.any? { |e| e.instance_of?(Array) }
+            if is_nested_array
+              @left_bracket_offset = \
+                elem.take_while { |e| e.instance_of?(Array) }.size
+            end
+
+            str << (indent * 2) << node_to_str(elem)
+          end
+
+          str << ",\n" unless node.index(elem) == node.length.pred
+        end
+
+        str << "\n#{indent}" unless node.empty?
+        str << ']'
+        str << ",\n" unless is_last
+
+      elsif node.instance_of?(Hash)
+        str << '{'
+        str << "\n" unless node.empty?
+
+        # format elements as key-value pairs
+        node.each_with_index do |h, idx|
+          # format values which are hashes themselves
+          if h.last.instance_of?(Hash)
+            key = if h.first.eql? ''
+                    "#{indent * 2}\"<##{h.last.class.name.downcase}>\": "
+                  else
+                    "#{indent * 2}\"#{h.first}\": "
+                  end
+
+            str << key << '{'
+            str << "\n" unless h.last.empty?
+
+            h.last.each_with_index do |inner_h, inner_h_idx|
+              str << "#{indent * 3}\"#{inner_h.first}\": "
+              str << node_to_str(inner_h.last, 4)
+              str << ",\n" unless inner_h_idx == h.last.to_a.length.pred
+            end
+
+            str << "\n#{indent * 2}" unless h.last.empty?
+            str << '}'
+
+          # format scalar values
+          else
+            str << "#{indent * 2}\"#{h.first}\": " << node_to_str(h.last)
+          end
+
+          str << ",\n" unless idx == node.to_a.length.pred
+        end
+
+        str << "\n#{indent}" unless node.empty?
+        str << '}'
+        str << ',' unless is_last
+        str << "\n"
+
+      # scalars
+      else
+        str << node_to_str(node)
+        str << ',' unless is_last
+        str << "\n"
+      end
+
+      trim str.gsub(/(#{indent})+[\n\r]+/, '')
+              .gsub(/\}\,+/, '},')
+              .gsub(/\]\,+/, '],')
+    end
+    # ~Formatter#format_node
+
+    ##
+    # Returns a JSON-appropriate string representation of +node+.
+    #
+    # @param node [#to_s] A visible attribute of a Ruby object.
+    # @param tabs [Integer] Tab width at which to start printing this node.
+    # @return [String] A formatted string representation of +node+.
+    def node_to_str(node, tabs = 0)
+      graft = ''
+      tabs += 2 if tabs.zero?
+
+      if @need_offset
+        tabs -= 1
+        @left_bracket_offset -= 1
+      end
+
+      indent = @format[:indent] * (tabs / 2)
+
+      if node.nil? then graft << 'null'
+
+      elsif node.instance_of?(Hash)
+
+        format_node(node, node).scan(/.*$/) do |n|
+          graft << "\n" << indent << n
+        end
+
+      elsif node.instance_of?(Array)
+        @need_offset = @left_bracket_offset.positive?
+
+        format_node(node, {}).scan(/.*$/) do |n|
+          graft << "\n" << indent << n
+        end
+
+      elsif !node.instance_of?(String) then graft << node.to_s
+
+      else graft << "\"#{node.gsub(/\"/, '\\"')}\""
+      end
+
+      graft.strip
+    end
+    # ~Formatter#node_to_str
+
+    ##
+    # Removes any trailing comma from serialized object members.
+    #
+    # @param node [String] A serialized object member.
+    # @return [String] A copy of +node+ without a trailing comma.
+    def trim(node)
+      if (extra_comma = /(?<trail>,\s*[\]\}]\s*)$/.match(node))
+        node.sub(extra_comma[:trail],
+                 extra_comma[:trail]
+                 .slice(1, node.length.pred)
+                 .sub(/^\s/, "\n"))
+      else node
+      end
+    end
+    # ~Formatter#trim
+  end
+
+  private_constant :Formatter
+end