Module: Stripe::Util

Defined in:
lib/stripe/util.rb

Class Method Summary collapse

Class Method Details

.convert_to_stripe_object(resp, api_key) ⇒ Object



43
44
45
46
47
48
49
50
51
52
53
# File 'lib/stripe/util.rb', line 43

def self.convert_to_stripe_object(resp, api_key)
  case resp
  when Array
    resp.map { |i| convert_to_stripe_object(i, api_key) }
  when Hash
    # Try converting to a known object class.  If none available, fall back to generic StripeObject
    object_classes.fetch(resp[:object], StripeObject).construct_from(resp, api_key)
  else
    resp
  end
end

.file_readable(file) ⇒ Object



55
56
57
58
59
60
61
62
63
64
65
66
# File 'lib/stripe/util.rb', line 55

def self.file_readable(file)
  # This is nominally equivalent to File.readable?, but that can
  # report incorrect results on some more oddball filesystems
  # (such as AFS)
  begin
    File.open(file) { |f| }
  rescue
    false
  else
    true
  end
end

.flatten_params(params, parent_key = nil) ⇒ Object



88
89
90
91
92
93
94
95
96
97
98
99
100
101
# File 'lib/stripe/util.rb', line 88

def self.flatten_params(params, parent_key=nil)
  result = []
  params.each do |key, value|
    calculated_key = parent_key ? "#{parent_key}[#{url_encode(key)}]" : url_encode(key)
    if value.is_a?(Hash)
      result += flatten_params(value, calculated_key)
    elsif value.is_a?(Array)
      result += flatten_params_array(value, calculated_key)
    else
      result << [calculated_key, value]
    end
  end
  result
end

.flatten_params_array(value, calculated_key) ⇒ Object



103
104
105
106
107
108
109
110
111
112
113
114
115
# File 'lib/stripe/util.rb', line 103

def self.flatten_params_array(value, calculated_key)
  result = []
  value.each do |elem|
    if elem.is_a?(Hash)
      result += flatten_params(elem, calculated_key)
    elsif elem.is_a?(Array)
      result += flatten_params_array(elem, calculated_key)
    else
      result << ["#{calculated_key}[]", elem]
    end
  end
  result
end

.object_classesObject



18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# File 'lib/stripe/util.rb', line 18

def self.object_classes
  @object_classes ||= {
    # data structures
    'list' => ListObject,
    
    # business objects
    'application_fee' => ApplicationFee,
    'balance' => Balance,
    'balance_transaction' => BalanceTransaction,
    'card' => Card,
    'charge' => Charge,
    'coupon' => Coupon,
    'customer' => Customer,
    'event' => Event,
    'fee_refund' => ApplicationFeeRefund,
    'invoiceitem' => InvoiceItem,
    'invoice' => Invoice,
    'plan' => Plan,
    'recipient' => Recipient,
    'refund' => Refund,
    'subscription' => Subscription,        
    'transfer' => Transfer
  }
end

.objects_to_ids(h) ⇒ Object



3
4
5
6
7
8
9
10
11
12
13
14
15
16
# File 'lib/stripe/util.rb', line 3

def self.objects_to_ids(h)
  case h
  when APIResource
    h.id
  when Hash
    res = {}
    h.each { |k, v| res[k] = objects_to_ids(v) unless v.nil? }
    res
  when Array
    h.map { |v| objects_to_ids(v) }
  else
    h
  end
end

.parse_opts(opts) ⇒ Object

The secondary opts argument can either be a string or hash Turn this value into an api_key and a set of headers



119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
# File 'lib/stripe/util.rb', line 119

def self.parse_opts(opts)
  case opts
  when NilClass
    return nil, {}
  when String
    return opts, {}
  when Hash
    headers = {}
    if opts[:idempotency_key]
      headers[:idempotency_key] = opts[:idempotency_key] 
    end
    return opts[:api_key], headers
  else
    raise TypeError.new("parse_opts expects a string or a hash")
  end
end

.symbolize_names(object) ⇒ Object



68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
# File 'lib/stripe/util.rb', line 68

def self.symbolize_names(object)
  case object
  when Hash
    new_hash = {}
    object.each do |key, value|
      key = (key.to_sym rescue key) || key
      new_hash[key] = symbolize_names(value)
    end
    new_hash
  when Array
    object.map { |value| symbolize_names(value) }
  else
    object
  end
end

.url_encode(key) ⇒ Object



84
85
86
# File 'lib/stripe/util.rb', line 84

def self.url_encode(key)
  URI.escape(key.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))
end