# File ext/json/lib/json/common.rb, line 13
def [](object, opts = {})
  if object.respond_to? :to_str
    JSON.parse(object.to_str, opts)
  else
    JSON.generate(object, opts)
  end
end

Если object — строка, разобрать строку и вернуть результат разбора как структуру данных Ruby. В противном случае сгенерировать текстовое представление JSON из объекта структуры данных Ruby и вернуть его.

Аргумент opts передаётся в метод генерации/разбора соответственно. См. документацию по методам generate и parse.

# File ext/json/lib/json/common.rb, line 406
def self.iconv(to, from, string)
  string.encode(to, from)
end

Кодирует строку с помощью метода String.encode Ruby.

# File ext/json/lib/json/common.rb, line 384
def dump(obj, anIO = nil, limit = nil)
  if anIO and limit.nil?
    anIO = anIO.to_io if anIO.respond_to?(:to_io)
    unless anIO.respond_to?(:write)
      limit = anIO
      anIO = nil
    end
  end
  opts = JSON.dump_default_options
  opts = opts.merge(:max_nesting => limit) if limit
  result = generate(obj, opts)
  if anIO
    anIO.write result
    anIO
  else
    result
  end
rescue JSON::NestingError
  raise ArgumentError, "exceed depth limit"
end

Преобразует obj в строку JSON, т. е. вызывает generate для объекта и возвращает результат.

Если был передан anIO (объект типа IO или объект, отвечающий на метод write), полученная строка JSON будет записана в него.

Если количество вложенных массивов или объектов превышает limit, будет выброшено исключение ArgumentError. Этот аргумент аналогичен (но не точно такой же!), как аргумент limit в Marshal.dump.

Значения по умолчанию для генератора можно изменить с помощью метода dump_default_options.

Этот метод является частью реализации интерфейса load/dump для Marshal и YAML.

# File ext/json/lib/json/common.rb, line 239
def fast_generate(obj, opts = nil)
  if State === opts
    state, opts = opts, nil
  else
    state = FAST_STATE_PROTOTYPE.dup
  end
  if opts
    if opts.respond_to? :to_hash
      opts = opts.to_hash
    elsif opts.respond_to? :to_h
      opts = opts.to_h
    else
      raise TypeError, "can't convert #{opts.class} into Hash"
    end
    state.configure(opts)
  end
  state.generate(obj)
end

Генерирует документ JSON из структуры данных Ruby obj и возвращает его. Этот метод отключает проверки на циклы в объектах Ruby.

ВНИМАНИЕ: Будьте осторожны, не передавайте структуры данных Ruby с циклами в качестве аргумента obj, так как это может привести к тому, что JSON уйдёт в бесконечный цикл.

# File ext/json/lib/json/common.rb, line 208
def generate(obj, opts = nil)
  if State === opts
    state, opts = opts, nil
  else
    state = SAFE_STATE_PROTOTYPE.dup
  end
  if opts
    if opts.respond_to? :to_hash
      opts = opts.to_hash
    elsif opts.respond_to? :to_h
      opts = opts.to_h
    else
      raise TypeError, "can't convert #{opts.class} into Hash"
    end
    state = state.configure(opts)
  end
  state.generate(obj)
end

Генерирует документ JSON из структуры данных Ruby obj и возвращает его. state — это:

• объект JSON::State,

• или объект типа Hash (отвечающий на to_hash),

• объект, преобразуемый в хэш с помощью метода to_h,

который используется как или для конфигурации объекта State.

По умолчанию используется объект состояния, создающий максимально короткий JSON текст в одной строке, проверяющий структуры данных на циклы и не допускающий NaN, Infinity и -Infinity.

Хэш state может содержать следующие ключи:

• indent: строка для отступа уровней (по умолчанию: ''),

• space: строка, вставляемая после : или , разделителей (по умолчанию: ''),

• space_before: строка, вставляемая перед : разделителем пар (по умолчанию: ''),

• object_nl: строка, вставляемая в конце объекта JSON (по умолчанию: ''),

• array_nl: строка, вставляемая в конце массива JSON (по умолчанию: ''),

• allow_nan: true, если NaN, Infinity и -Infinity должны быть сгенерированы; в противном случае, если эти значения встретятся, будет выброшено исключение. По умолчанию равно false.

• max_nesting: Максимальная глубина вложения в структурах данных, из которых генерируется JSON. Отключить проверку глубины с помощью :max_nesting => false, по умолчанию 100.

См. также fast_generate для самого быстрого метода создания с минимальным количеством проверок и pretty_generate метод для некоторых значений по умолчанию для красивого вывода.

# File ext/json/lib/json/common.rb, line 323
def load(source, proc = nil, options = {})
  opts = load_default_options.merge options
  if source.respond_to? :to_str
    source = source.to_str
  elsif source.respond_to? :to_io
    source = source.to_io.read
  elsif source.respond_to?(:read)
    source = source.read
  end
  if opts[:allow_blank] && (source.nil? || source.empty?)
    source = 'null'
  end
  result = parse(source, opts)
  recurse_proc(result, &proc) if proc
  result
end

Загружает структуру данных Ruby из JSON source и возвращает её. Источник может быть строковым объектом, объектом типа IO или объектом, отвечающим на метод read. Если proc был передан, он будет вызываться с любым вложенным объектом Ruby в качестве аргумента рекурсивно в порядке обхода в глубину. Чтобы изменить значения по умолчанию, передайте необязательный аргумент options.

ВНИМАНИЕ: Этот метод предназначен для сериализации данных из надёжного источника, например, из собственного сервера базы данных или клиентов, находящихся под вашим контролем. Опасно допускать, чтобы ненадежные пользователи передавали в него JSON источники. Значения по умолчанию для парсера можно изменить с помощью метода load_default_options.

Этот метод является частью реализации интерфейса load/dump для Marshal и YAML.

# File ext/json/lib/json/common.rb, line 155
def parse(source, opts = {})
  Parser.new(source, **(opts||{})).parse
end

Парсит документ JSON source в структуру данных Ruby и возвращает её.

opts может содержать следующие ключи:

• max_nesting: Максимальная глубина вложения в парсируемых структурах данных. Отключить проверку глубины с помощью :max_nesting => false. По умолчанию 100.

• allow_nan: Если установлено в true, разрешает NaN, Infinity и -Infinity для парсинга парсером вопреки RFC 7159. По умолчанию false.

• symbolize_names: Если установлено в true, возвращает символы для имён (ключей) в объекте JSON. В противном случае возвращаются строки. По умолчанию строки.

• create_additions: Если установлено в false, парсер не создаёт добавления, даже если был найден соответствующий класс и create_id. По умолчанию false.

• object_class: По умолчанию Hash

• array_class: По умолчанию Array

# File ext/json/lib/json/common.rb, line 174
def parse!(source, opts = {})
  opts = {
    :max_nesting  => false,
    :allow_nan    => true
  }.merge(opts)
  Parser.new(source, **(opts||{})).parse
end

Парсит документ JSON source в структуру данных Ruby и возвращает её. Версия метода parse с восклицательным знаком по умолчанию устанавливает более опасные значения для хэша opts, поэтому убедитесь, что вы парсите только надёжные документы source.

opts может содержать следующие ключи:

• max_nesting: Максимальная глубина вложения в парсируемых структурах данных. Включить проверку глубины с помощью :max_nesting => anInteger. Методы parse! по умолчанию не выполняют проверку максимальной глубины: это может быть опасно, если кто-то пытается заполнить ваш стек.

• allow_nan: Если установлено в true, разрешает NaN, Infinity и -Infinity для парсинга парсером вопреки RFC 7159. По умолчанию true.

• create_additions: Если установлено в false, парсер не создаёт добавления, даже если был найден соответствующий класс и create_id. По умолчанию false.

# File ext/json/lib/json/common.rb, line 270
def pretty_generate(obj, opts = nil)
  if State === opts
    state, opts = opts, nil
  else
    state = PRETTY_STATE_PROTOTYPE.dup
  end
  if opts
    if opts.respond_to? :to_hash
      opts = opts.to_hash
    elsif opts.respond_to? :to_h
      opts = opts.to_h
    else
      raise TypeError, "can't convert #{opts.class} into Hash"
    end
    state.configure(opts)
  end
  state.generate(obj)
end

Генерирует документ JSON из структуры данных Ruby obj и возвращает его. Возвращаемый документ — это более удобочитаемая форма документа, возвращаемого методом unparse.

Аргумент opts можно использовать для конфигурирования генератора. Для более подробного объяснения см. метод generate.

# File ext/json/lib/json/common.rb, line 341
def recurse_proc(result, &proc)
  case result
  when Array
    result.each { |x| recurse_proc x, &proc }
    proc.call result
  when Hash
    result.each { |x, y| recurse_proc x, &proc; recurse_proc y, &proc }
    proc.call result
  else
    proc.call result
  end
end

Рекурсивно вызывает переданный Proc, если парсируемая структура данных является массивом или хэш.