module Rainforest::Requester

Public Class Methods

delete(url, params, headers) click to toggle source
# File lib/rainforest/apibits/requester.rb, line 29
def self.delete(url, params, headers)
  self.request(:delete, url, params, headers)
end
escape(val) click to toggle source
# File lib/rainforest/apibits/requester.rb, line 99
def self.escape(val)
  URI.escape(val.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))
end
execute_request(opts) click to toggle source
# File lib/rainforest/apibits/requester.rb, line 21
def self.execute_request(opts)
  RestClient::Request.execute(opts)
end
get(url, params, headers) click to toggle source
# File lib/rainforest/apibits/requester.rb, line 25
def self.get(url, params, headers)
  self.request(:get, url, params, headers)
end
post(url, params, headers) click to toggle source
# File lib/rainforest/apibits/requester.rb, line 37
def self.post(url, params, headers)
  self.request(:post, url, params, headers)
end
prepare_params(method, url, params={}, headers={}) click to toggle source
# File lib/rainforest/apibits/requester.rb, line 41
def self.prepare_params(method, url, params={}, headers={})
  if [:get, :head, :delete].include?(method)
    unless params.empty?
      url += URI.parse(url).query ? '&' : '?' + query_string(params)
    end
    params = nil
  else
    if headers["Content-Type"] == "application/json" || headers[:"Content-Type"] == "application/json"
      params = JSON.generate(params)
    else
      headers["Content-Type"] = "application/x-www-form-urlencoded"
      if !RestClient::Payload.has_file?(params)
        params = query_string(params)
      end
    end
  end
  [url, params]
end
put(url, params, headers) click to toggle source
# File lib/rainforest/apibits/requester.rb, line 33
def self.put(url, params, headers)
  self.request(:put, url, params, headers)
end
query_array(params, key_prefix=nil) click to toggle source

Three major use cases (and nesting of them needs to be supported):

{ :a => { :b => "bvalue" } }  => ["a[b]=bvalue"]
{ :a => [1, 2] }           => ["a[]=1", "a[]=2"]
{ :a => "value" }          => ["a=value"]
# File lib/rainforest/apibits/requester.rb, line 73
def self.query_array(params, key_prefix=nil)
  ret = []
  params.each do |key, value|
    if params.is_a?(Array)
      value = key
      key = ''
    end
    key_suffix = escape(key)
    full_key = key_prefix ? "#{key_prefix}[#{key_suffix}]" : key_suffix

    if value.is_a?(Hash) || value.is_a?(Array)
      # Handles the following cases:
      #   { :a => { :b => "bvalue" } }  => ["a[b]=bvalue"]
      #   { :a => [1, 2] }           => ["a[]=1", "a[]=2"]
      ret += query_array(value, full_key)
    elsif value.is_a?(ApiObject)
      ret += query_array(value.json, full_key)
    else
      # Handles the base case with just key and value:
      #   { :a => "value" } => ["a=value"]
      ret << "#{full_key}=#{escape(value)}"
    end
  end
  ret
end
query_string(params) click to toggle source
# File lib/rainforest/apibits/requester.rb, line 60
def self.query_string(params)
  params ||= {}
  if params.any?
    query_array(params).join('&')
  else
    ""
  end
end
request(method, url, params={}, headers={}) click to toggle source
# File lib/rainforest/apibits/requester.rb, line 4
def self.request(method, url, params={}, headers={})
  method = method.to_sym
  url, params = prepare_params(method, url, params, headers)
  request_opts = {
    :method => method,
    :url => url,
    :headers => headers,
    :payload => params,

    :verify_ssl => false,
    :open_timeout => 30,
    :timeout => 60
  }

  execute_request(request_opts)
end