Module: HTTParty::HashConversions

Defined in:
lib/httparty/hash_conversions.rb

Class Method Summary (collapse)

Class Method Details

+ (String) normalize_param(key, value)

Returns This key value pair as a param

Examples:

normalize_param(:name, “Bob Jones”) #=> “name=Bob%20Jones&”

Parameters:

  • key (Object)

    The key for the param.

  • value (Object)

    The value for the param.

Returns:

  • (String)

    This key value pair as a param



26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
# File 'lib/httparty/hash_conversions.rb', line 26

def self.normalize_param(key, value)
  param = ''
  stack = []

  if value.respond_to?(:to_ary)
    param << value.to_ary.map { |element| normalize_param("#{key}[]", element) }.join
  elsif value.respond_to?(:to_hash)
    stack << [key,value.to_hash]
  else
    param << "#{key}=#{URI.encode(value.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))}&"
  end

  stack.each do |parent, hash|
    hash.each do |k, v|
      if v.respond_to?(:to_hash)
        stack << ["#{parent}[#{k}]", v.to_hash]
      else
        param << normalize_param("#{parent}[#{k}]", v)
      end
    end
  end

  param
end

+ (String) to_params(hash)

Returns This hash as a query string

Examples:

{ name: "Bob",
  address: {
    street: '111 Ruby Ave.',
    city: 'Ruby Central',
    phones: ['111-111-1111', '222-222-2222']
  }
}.to_params
  #=> "name=Bob&address[city]=Ruby Central&address[phones][]=111-111-1111&address[phones][]=222-222-2222&address[street]=111 Ruby Ave."

Returns:

  • (String)

    This hash as a query string



14
15
16
17
18
# File 'lib/httparty/hash_conversions.rb', line 14

def self.to_params(hash)
  params = hash.to_hash.map { |k,v| normalize_param(k,v) }.join
  params.chop! # trailing &
  params
end