This class is used to create State instances, that are use to hold data while generating a JSON text from a a Ruby data structure.
This integer returns the maximum level of data structure nesting in the generated JSON, max_nesting = 0 if no maximum is checked.
Creates a State object from opts, which ought to be Hash to create a new State instance configured by opts, something else to create an unconfigured instance. If opts is a State object, it is just returned.
# File lib/json/pure/generator.rb, line 108 def self.from_state(opts) case opts when self opts when Hash new(opts) else SAFE_STATE_PROTOTYPE.dup end end
Instantiates a new State object, configured by opts.
opts can have the following keys:
indent: a string used to indent levels (default: "),
space: a string that is put after, a : or , delimiter (default: "),
space_before: a string that is put before a : pair delimiter (default: "),
object_nl: a string that is put at the end of a JSON object (default: "),
array_nl: a string that is put at the end of a JSON array (default: "),
check_circular: is deprecated now, use the :max_nesting option instead,
max_nesting: sets the maximum level of data structure nesting in the generated JSON, max_nesting = 0 if no maximum should be checked.
allow_nan: true if NaN, Infinity, and -Infinity should be generated, otherwise an exception is thrown, if these values are encountered. This options defaults to false.
# File lib/json/pure/generator.rb, line 134 def initialize(opts = {}) @indent = '' @space = '' @space_before = '' @object_nl = '' @array_nl = '' @allow_nan = false @ascii_only = false configure opts end
Return the value returned by method name.
# File lib/json/pure/generator.rb, line 236 def [](name) __send__ name end
Returns true if NaN, Infinity, and -Infinity should be considered as valid JSON and output.
# File lib/json/pure/generator.rb, line 185 def allow_nan? @allow_nan end
# File lib/json/pure/generator.rb, line 189 def ascii_only? @ascii_only end
Returns true, if circular data structures are checked, otherwise returns false.
# File lib/json/pure/generator.rb, line 179 def check_circular? !@max_nesting.zero? end
Configure this State instance with the Hash opts, and return itself.
# File lib/json/pure/generator.rb, line 195 def configure(opts) @indent = opts[:indent] if opts.key?(:indent) @space = opts[:space] if opts.key?(:space) @space_before = opts[:space_before] if opts.key?(:space_before) @object_nl = opts[:object_nl] if opts.key?(:object_nl) @array_nl = opts[:array_nl] if opts.key?(:array_nl) @allow_nan = !!opts[:allow_nan] if opts.key?(:allow_nan) @ascii_only = opts[:ascii_only] if opts.key?(:ascii_only) @depth = opts[:depth] || 0 if !opts.key?(:max_nesting) # defaults to 19 @max_nesting = 19 elsif opts[:max_nesting] @max_nesting = opts[:max_nesting] else @max_nesting = 0 end self end
Generates a valid JSON document from object obj and returns the result. If no valid JSON document can be created this method raises a GeneratorError exception.
# File lib/json/pure/generator.rb, line 227 def generate(obj) result = obj.to_json(self) if result !~ /\A\s*(?:\[.*\]|\{.*\})\s*\Z/ raise GeneratorError, "only generation of JSON objects or arrays allowed" end result end
Returns the configuration instance variables as a hash, that can be passed to the configure method.
# File lib/json/pure/generator.rb, line 216 def to_h result = {} for iv in ]indent space space_before object_nl array_nl allow_nan max_nesting ascii_only depth] result[iv.intern] = instance_variable_get("@#{iv}") end result end
Generated with the Darkfish Rdoc Generator 2.