stripe 4.24.0 → 5.36.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (216) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +169 -0
  3. data/CODE_OF_CONDUCT.md +77 -0
  4. data/Gemfile +10 -16
  5. data/README.md +111 -44
  6. data/Rakefile +8 -7
  7. data/VERSION +1 -1
  8. data/lib/stripe.rb +39 -130
  9. data/lib/stripe/api_operations/create.rb +1 -1
  10. data/lib/stripe/api_operations/delete.rb +7 -3
  11. data/lib/stripe/api_operations/list.rb +1 -12
  12. data/lib/stripe/api_operations/nested_resource.rb +29 -26
  13. data/lib/stripe/api_operations/request.rb +82 -6
  14. data/lib/stripe/api_operations/save.rb +7 -4
  15. data/lib/stripe/api_resource.rb +12 -3
  16. data/lib/stripe/connection_manager.rb +179 -0
  17. data/lib/stripe/error_object.rb +94 -0
  18. data/lib/stripe/errors.rb +24 -3
  19. data/lib/stripe/instrumentation.rb +82 -0
  20. data/lib/stripe/list_object.rb +34 -5
  21. data/lib/stripe/multipart_encoder.rb +131 -0
  22. data/lib/stripe/oauth.rb +8 -6
  23. data/lib/stripe/object_types.rb +12 -1
  24. data/lib/stripe/resources.rb +12 -1
  25. data/lib/stripe/resources/account.rb +6 -14
  26. data/lib/stripe/resources/account_link.rb +2 -1
  27. data/lib/stripe/resources/alipay_account.rb +1 -1
  28. data/lib/stripe/resources/apple_pay_domain.rb +2 -1
  29. data/lib/stripe/resources/application_fee.rb +2 -12
  30. data/lib/stripe/resources/application_fee_refund.rb +1 -1
  31. data/lib/stripe/resources/balance.rb +2 -1
  32. data/lib/stripe/resources/balance_transaction.rb +2 -1
  33. data/lib/stripe/resources/bank_account.rb +3 -2
  34. data/lib/stripe/resources/billing_portal/configuration.rb +14 -0
  35. data/lib/stripe/resources/billing_portal/session.rb +12 -0
  36. data/lib/stripe/resources/bitcoin_receiver.rb +2 -1
  37. data/lib/stripe/resources/bitcoin_transaction.rb +1 -1
  38. data/lib/stripe/resources/capability.rb +1 -1
  39. data/lib/stripe/resources/card.rb +2 -1
  40. data/lib/stripe/resources/charge.rb +8 -69
  41. data/lib/stripe/resources/checkout/session.rb +6 -1
  42. data/lib/stripe/resources/country_spec.rb +2 -1
  43. data/lib/stripe/resources/coupon.rb +2 -1
  44. data/lib/stripe/resources/credit_note.rb +12 -1
  45. data/lib/stripe/resources/credit_note_line_item.rb +7 -0
  46. data/lib/stripe/resources/customer.rb +9 -63
  47. data/lib/stripe/resources/customer_balance_transaction.rb +1 -1
  48. data/lib/stripe/resources/discount.rb +1 -1
  49. data/lib/stripe/resources/dispute.rb +2 -7
  50. data/lib/stripe/resources/ephemeral_key.rb +2 -1
  51. data/lib/stripe/resources/event.rb +2 -1
  52. data/lib/stripe/resources/exchange_rate.rb +2 -1
  53. data/lib/stripe/resources/file.rb +6 -14
  54. data/lib/stripe/resources/file_link.rb +2 -1
  55. data/lib/stripe/resources/identity/verification_report.rb +12 -0
  56. data/lib/stripe/resources/identity/verification_session.rb +35 -0
  57. data/lib/stripe/resources/invoice.rb +8 -2
  58. data/lib/stripe/resources/invoice_item.rb +2 -1
  59. data/lib/stripe/resources/invoice_line_item.rb +1 -1
  60. data/lib/stripe/resources/issuing/authorization.rb +2 -1
  61. data/lib/stripe/resources/issuing/card.rb +2 -1
  62. data/lib/stripe/resources/issuing/card_details.rb +1 -1
  63. data/lib/stripe/resources/issuing/cardholder.rb +2 -1
  64. data/lib/stripe/resources/issuing/dispute.rb +13 -1
  65. data/lib/stripe/resources/issuing/transaction.rb +2 -1
  66. data/lib/stripe/resources/line_item.rb +7 -0
  67. data/lib/stripe/resources/login_link.rb +1 -1
  68. data/lib/stripe/resources/mandate.rb +8 -0
  69. data/lib/stripe/resources/order.rb +2 -9
  70. data/lib/stripe/resources/order_return.rb +2 -1
  71. data/lib/stripe/resources/payment_intent.rb +2 -1
  72. data/lib/stripe/resources/payment_method.rb +2 -1
  73. data/lib/stripe/resources/payout.rb +10 -5
  74. data/lib/stripe/resources/person.rb +1 -1
  75. data/lib/stripe/resources/plan.rb +2 -1
  76. data/lib/stripe/resources/price.rb +12 -0
  77. data/lib/stripe/resources/product.rb +2 -1
  78. data/lib/stripe/resources/promotion_code.rb +12 -0
  79. data/lib/stripe/resources/quote.rb +95 -0
  80. data/lib/stripe/resources/radar/early_fraud_warning.rb +2 -1
  81. data/lib/stripe/resources/radar/value_list.rb +2 -1
  82. data/lib/stripe/resources/radar/value_list_item.rb +2 -1
  83. data/lib/stripe/resources/recipient.rb +2 -5
  84. data/lib/stripe/resources/recipient_transfer.rb +1 -1
  85. data/lib/stripe/resources/refund.rb +2 -1
  86. data/lib/stripe/resources/reporting/report_run.rb +2 -1
  87. data/lib/stripe/resources/reporting/report_type.rb +2 -1
  88. data/lib/stripe/resources/reversal.rb +1 -1
  89. data/lib/stripe/resources/review.rb +2 -1
  90. data/lib/stripe/resources/setup_attempt.rb +10 -0
  91. data/lib/stripe/resources/setup_intent.rb +2 -1
  92. data/lib/stripe/resources/sigma/scheduled_query_run.rb +2 -1
  93. data/lib/stripe/resources/sku.rb +2 -1
  94. data/lib/stripe/resources/source.rb +11 -10
  95. data/lib/stripe/resources/source_transaction.rb +1 -1
  96. data/lib/stripe/resources/subscription.rb +10 -9
  97. data/lib/stripe/resources/subscription_item.rb +8 -2
  98. data/lib/stripe/resources/subscription_schedule.rb +2 -1
  99. data/lib/stripe/resources/tax_code.rb +10 -0
  100. data/lib/stripe/resources/tax_id.rb +1 -1
  101. data/lib/stripe/resources/tax_rate.rb +2 -1
  102. data/lib/stripe/resources/terminal/connection_token.rb +2 -1
  103. data/lib/stripe/resources/terminal/location.rb +2 -1
  104. data/lib/stripe/resources/terminal/reader.rb +2 -1
  105. data/lib/stripe/resources/three_d_secure.rb +2 -1
  106. data/lib/stripe/resources/token.rb +2 -1
  107. data/lib/stripe/resources/topup.rb +2 -1
  108. data/lib/stripe/resources/transfer.rb +2 -6
  109. data/lib/stripe/resources/usage_record.rb +1 -17
  110. data/lib/stripe/resources/usage_record_summary.rb +1 -1
  111. data/lib/stripe/resources/webhook_endpoint.rb +2 -1
  112. data/lib/stripe/stripe_client.rb +608 -242
  113. data/lib/stripe/stripe_configuration.rb +194 -0
  114. data/lib/stripe/stripe_object.rb +30 -25
  115. data/lib/stripe/stripe_response.rb +87 -27
  116. data/lib/stripe/util.rb +37 -18
  117. data/lib/stripe/version.rb +1 -1
  118. data/lib/stripe/webhook.rb +39 -8
  119. data/stripe.gemspec +15 -11
  120. metadata +24 -216
  121. data/.editorconfig +0 -10
  122. data/.gitattributes +0 -4
  123. data/.github/ISSUE_TEMPLATE.md +0 -5
  124. data/.gitignore +0 -8
  125. data/.rubocop.yml +0 -43
  126. data/.rubocop_todo.yml +0 -38
  127. data/.travis.yml +0 -43
  128. data/.vscode/extensions.json +0 -7
  129. data/.vscode/settings.json +0 -8
  130. data/lib/stripe/resources/issuer_fraud_record.rb +0 -9
  131. data/test/api_stub_helpers.rb +0 -1
  132. data/test/openapi/README.md +0 -9
  133. data/test/stripe/account_link_test.rb +0 -18
  134. data/test/stripe/account_test.rb +0 -428
  135. data/test/stripe/alipay_account_test.rb +0 -37
  136. data/test/stripe/api_operations_test.rb +0 -80
  137. data/test/stripe/api_resource_test.rb +0 -621
  138. data/test/stripe/apple_pay_domain_test.rb +0 -46
  139. data/test/stripe/application_fee_refund_test.rb +0 -37
  140. data/test/stripe/application_fee_test.rb +0 -58
  141. data/test/stripe/balance_test.rb +0 -13
  142. data/test/stripe/balance_transaction_test.rb +0 -20
  143. data/test/stripe/bank_account_test.rb +0 -36
  144. data/test/stripe/capability_test.rb +0 -45
  145. data/test/stripe/charge_test.rb +0 -80
  146. data/test/stripe/checkout/session_test.rb +0 -41
  147. data/test/stripe/country_spec_test.rb +0 -20
  148. data/test/stripe/coupon_test.rb +0 -61
  149. data/test/stripe/credit_note_test.rb +0 -61
  150. data/test/stripe/customer_balance_transaction_test.rb +0 -37
  151. data/test/stripe/customer_card_test.rb +0 -42
  152. data/test/stripe/customer_test.rb +0 -269
  153. data/test/stripe/dispute_test.rb +0 -51
  154. data/test/stripe/ephemeral_key_test.rb +0 -93
  155. data/test/stripe/errors_test.rb +0 -20
  156. data/test/stripe/exchange_rate_test.rb +0 -20
  157. data/test/stripe/file_link_test.rb +0 -41
  158. data/test/stripe/file_test.rb +0 -97
  159. data/test/stripe/file_upload_test.rb +0 -79
  160. data/test/stripe/invoice_item_test.rb +0 -66
  161. data/test/stripe/invoice_line_item_test.rb +0 -8
  162. data/test/stripe/invoice_test.rb +0 -213
  163. data/test/stripe/issuer_fraud_record_test.rb +0 -20
  164. data/test/stripe/issuing/authorization_test.rb +0 -72
  165. data/test/stripe/issuing/card_test.rb +0 -62
  166. data/test/stripe/issuing/cardholder_test.rb +0 -53
  167. data/test/stripe/issuing/dispute_test.rb +0 -45
  168. data/test/stripe/issuing/transaction_test.rb +0 -48
  169. data/test/stripe/list_object_test.rb +0 -156
  170. data/test/stripe/login_link_test.rb +0 -37
  171. data/test/stripe/oauth_test.rb +0 -88
  172. data/test/stripe/order_return_test.rb +0 -21
  173. data/test/stripe/order_test.rb +0 -82
  174. data/test/stripe/payment_intent_test.rb +0 -107
  175. data/test/stripe/payment_method_test.rb +0 -84
  176. data/test/stripe/payout_test.rb +0 -57
  177. data/test/stripe/person_test.rb +0 -46
  178. data/test/stripe/plan_test.rb +0 -98
  179. data/test/stripe/product_test.rb +0 -59
  180. data/test/stripe/radar/early_fraud_warning_test.rb +0 -22
  181. data/test/stripe/radar/value_list_item_test.rb +0 -48
  182. data/test/stripe/radar/value_list_test.rb +0 -61
  183. data/test/stripe/recipient_test.rb +0 -62
  184. data/test/stripe/refund_test.rb +0 -39
  185. data/test/stripe/reporting/report_run_test.rb +0 -33
  186. data/test/stripe/reporting/report_type_test.rb +0 -22
  187. data/test/stripe/reversal_test.rb +0 -43
  188. data/test/stripe/review_test.rb +0 -27
  189. data/test/stripe/setup_intent_test.rb +0 -84
  190. data/test/stripe/sigma/scheduled_query_run_test.rb +0 -22
  191. data/test/stripe/sku_test.rb +0 -60
  192. data/test/stripe/source_test.rb +0 -99
  193. data/test/stripe/source_transaction_test.rb +0 -19
  194. data/test/stripe/stripe_client_test.rb +0 -842
  195. data/test/stripe/stripe_object_test.rb +0 -525
  196. data/test/stripe/stripe_response_test.rb +0 -49
  197. data/test/stripe/subscription_item_test.rb +0 -75
  198. data/test/stripe/subscription_schedule_test.rb +0 -82
  199. data/test/stripe/subscription_test.rb +0 -80
  200. data/test/stripe/tax_id_test.rb +0 -31
  201. data/test/stripe/tax_rate_test.rb +0 -43
  202. data/test/stripe/terminal/connection_token_test.rb +0 -16
  203. data/test/stripe/terminal/location_test.rb +0 -68
  204. data/test/stripe/terminal/reader_test.rb +0 -62
  205. data/test/stripe/three_d_secure_test.rb +0 -23
  206. data/test/stripe/topup_test.rb +0 -62
  207. data/test/stripe/transfer_test.rb +0 -88
  208. data/test/stripe/usage_record_summary_test.rb +0 -19
  209. data/test/stripe/usage_record_test.rb +0 -28
  210. data/test/stripe/util_test.rb +0 -402
  211. data/test/stripe/webhook_endpoint_test.rb +0 -59
  212. data/test/stripe/webhook_test.rb +0 -96
  213. data/test/stripe_mock.rb +0 -77
  214. data/test/stripe_test.rb +0 -63
  215. data/test/test_data.rb +0 -61
  216. data/test/test_helper.rb +0 -71
@@ -1,525 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require ::File.expand_path("../test_helper", __dir__)
4
-
5
- module Stripe
6
- class StripeObjectTest < Test::Unit::TestCase
7
- should "implement #==" do
8
- obj1 = Stripe::StripeObject.construct_from(id: 1, foo: "bar")
9
- obj2 = Stripe::StripeObject.construct_from(id: 1, foo: "bar")
10
- obj3 = Stripe::StripeObject.construct_from(id: 1, foo: "rab")
11
-
12
- assert obj1 == obj2
13
- refute obj1 == obj3
14
- end
15
-
16
- should "implement #deleted?" do
17
- obj = Stripe::StripeObject.construct_from({})
18
- refute obj.deleted?
19
-
20
- obj = Stripe::StripeObject.construct_from(deleted: false)
21
- refute obj.deleted?
22
-
23
- obj = Stripe::StripeObject.construct_from(deleted: true)
24
- assert obj.deleted?
25
- end
26
-
27
- should "implement #respond_to" do
28
- obj = Stripe::StripeObject.construct_from(id: 1, foo: "bar")
29
- assert obj.respond_to?(:id)
30
- assert obj.respond_to?(:foo)
31
- assert !obj.respond_to?(:baz)
32
- end
33
-
34
- should "marshal be insensitive to strings vs. symbols when constructin" do
35
- obj = Stripe::StripeObject.construct_from(:id => 1, "name" => "Stripe")
36
- assert_equal 1, obj[:id]
37
- assert_equal "Stripe", obj[:name]
38
- end
39
-
40
- context "#deep_copy" do
41
- should "produce a deep copy" do
42
- opts = {
43
- api_base: Stripe.api_base,
44
- api_key: "apikey",
45
- }
46
- values = {
47
- id: 1,
48
- name: "Stripe",
49
- arr: [
50
- StripeObject.construct_from({ id: "index0" }, opts),
51
- "index1",
52
- 2,
53
- ],
54
- map: {
55
- :"0" => StripeObject.construct_from({ id: "index0" }, opts),
56
- :"1" => "index1",
57
- :"2" => 2,
58
- },
59
- }
60
-
61
- # it's not good to test methods with `#send` like this, but I've done
62
- # it in the interest of trying to keep `.deep_copy` as internal as
63
- # possible
64
- copy_values = Stripe::StripeObject.send(:deep_copy, values)
65
-
66
- # we can't compare the hashes directly because they have embedded
67
- # objects which are different from each other
68
- assert_equal values[:id], copy_values[:id]
69
- assert_equal values[:name], copy_values[:name]
70
-
71
- assert_equal values[:arr].length, copy_values[:arr].length
72
-
73
- # internal values of the copied StripeObject should be the same
74
- # (including opts), but the object itself should be new (hence the
75
- # refutation of equality on #object_id)
76
- assert_equal values[:arr][0][:id], copy_values[:arr][0][:id]
77
- refute_equal values[:arr][0].object_id, copy_values[:arr][0].object_id
78
- assert_equal values[:arr][0].instance_variable_get(:@opts),
79
- copy_values[:arr][0].instance_variable_get(:@opts)
80
-
81
- # scalars however, can be compared
82
- assert_equal values[:arr][1], copy_values[:arr][1]
83
- assert_equal values[:arr][2], copy_values[:arr][2]
84
-
85
- # and a similar story with the hash
86
- assert_equal values[:map].keys, copy_values[:map].keys
87
- assert_equal values[:map][:"0"][:id], copy_values[:map][:"0"][:id]
88
- refute_equal values[:map][:"0"].object_id, copy_values[:map][:"0"].object_id
89
- assert_equal values[:map][:"0"].instance_variable_get(:@opts),
90
- copy_values[:map][:"0"].instance_variable_get(:@opts)
91
- assert_equal values[:map][:"1"], copy_values[:map][:"1"]
92
- assert_equal values[:map][:"2"], copy_values[:map][:"2"]
93
- end
94
-
95
- should "not copy a client" do
96
- opts = {
97
- api_key: "apikey",
98
- client: StripeClient.active_client,
99
- }
100
- values = { id: 1, name: "Stripe" }
101
-
102
- obj = Stripe::StripeObject.construct_from(values, opts)
103
- copy_obj = Stripe::StripeObject.send(:deep_copy, obj)
104
-
105
- assert_equal values, copy_obj.instance_variable_get(:@values)
106
- assert_equal opts.reject { |k, _v| k == :client },
107
- copy_obj.instance_variable_get(:@opts)
108
- end
109
-
110
- should "return an instance of the same class" do
111
- class TestObject < Stripe::StripeObject; end
112
-
113
- obj = TestObject.construct_from(id: 1)
114
- copy_obj = obj.class.send(:deep_copy, obj)
115
-
116
- assert_equal obj.class, copy_obj.class
117
- end
118
- end
119
-
120
- context "#eql?" do
121
- should "produce true for two equivalent Stripe objects" do
122
- obj1 = Stripe::StripeObject.construct_from(id: 1, name: "Stripe")
123
- obj2 = Stripe::StripeObject.construct_from(id: 1, name: "Stripe")
124
- assert obj1.eql?(obj2)
125
- end
126
-
127
- should "produce false for non-equivalent Stripe objects" do
128
- obj1 = Stripe::StripeObject.construct_from(id: 1, name: "Stripe")
129
- obj2 = Stripe::StripeObject.construct_from(id: 2, name: "Stripe")
130
- refute obj1.eql?(obj2)
131
- end
132
-
133
- should "produce false for different types" do
134
- obj1 = Stripe::StripeObject.construct_from(id: 1, name: "Stripe")
135
- obj2 = 7
136
- refute obj1.eql?(obj2)
137
- end
138
- end
139
-
140
- context "#hash" do
141
- should "produce the same hash for two equivalent Stripe objects" do
142
- obj1 = Stripe::StripeObject.construct_from(id: 1, name: "Stripe")
143
- obj2 = Stripe::StripeObject.construct_from(id: 1, name: "Stripe")
144
- assert_equal obj1.hash, obj2.hash
145
- end
146
-
147
- should "produce different hashes for non-equivalent Stripe objects" do
148
- obj1 = Stripe::StripeObject.construct_from(id: 1, name: "Stripe")
149
- obj2 = Stripe::StripeObject.construct_from(id: 2, name: "Stripe")
150
- refute_equal obj1.hash, obj2.hash
151
- end
152
-
153
- should "produce different hashes for different types" do
154
- obj1 = Stripe::StripeObject.construct_from(id: 1, name: "Stripe")
155
- obj2 = 7
156
- refute_equal obj1.hash, obj2.hash
157
- end
158
- end
159
-
160
- context "#to_hash" do
161
- should "skip calling to_hash on nil" do
162
- begin
163
- module NilWithToHash
164
- def to_hash
165
- raise "Can't call to_hash on nil"
166
- end
167
- end
168
- ::NilClass.include NilWithToHash
169
-
170
- hash_with_nil = { id: 3, foo: nil }
171
- obj = StripeObject.construct_from(hash_with_nil)
172
- expected_hash = { id: 3, foo: nil }
173
- assert_equal expected_hash, obj.to_hash
174
- ensure
175
- ::NilClass.send(:undef_method, :to_hash)
176
- end
177
- end
178
-
179
- should "recursively call to_hash on its values" do
180
- # deep nested hash (when contained in an array) or StripeObject
181
- nested_hash = { id: 7, foo: "bar" }
182
- nested = Stripe::StripeObject.construct_from(nested_hash)
183
-
184
- obj = Stripe::StripeObject.construct_from(id: 1,
185
- # simple hash that contains a StripeObject to help us test deep
186
- # recursion
187
- nested: { object: "list", data: [nested] },
188
- list: [nested])
189
-
190
- expected_hash = {
191
- id: 1,
192
- nested: { object: "list", data: [nested_hash] },
193
- list: [nested_hash],
194
- }
195
- assert_equal expected_hash, obj.to_hash
196
- end
197
- end
198
-
199
- should "assign question mark accessors for booleans" do
200
- obj = Stripe::StripeObject.construct_from(id: 1, bool: true, not_bool: "bar")
201
- assert obj.respond_to?(:bool?)
202
- assert obj.bool?
203
- refute obj.respond_to?(:not_bool?)
204
- end
205
-
206
- should "assign question mark accessors for booleans added after initialization" do
207
- obj = Stripe::StripeObject.new
208
- obj.bool = true
209
- assert obj.respond_to?(:bool?)
210
- assert obj.bool?
211
- end
212
-
213
- should "mass assign values with #update_attributes" do
214
- obj = Stripe::StripeObject.construct_from(id: 1, name: "Stripe")
215
- obj.update_attributes(name: "STRIPE")
216
- assert_equal "STRIPE", obj.name
217
-
218
- # unfortunately, we even assign unknown properties to duplicate the
219
- # behavior that we currently have via magic accessors with
220
- # method_missing
221
- obj.update_attributes(unknown: "foo")
222
- assert_equal "foo", obj.unknown
223
- end
224
-
225
- should "#update_attributes with a hash" do
226
- obj = Stripe::StripeObject.construct_from({})
227
- obj.update_attributes(metadata: { foo: "bar" })
228
- assert_equal Stripe::StripeObject, obj.metadata.class
229
- end
230
-
231
- should "create accessors when #update_attributes is called" do
232
- obj = Stripe::StripeObject.construct_from({})
233
- assert_equal false, obj.send(:metaclass).method_defined?(:foo)
234
- obj.update_attributes(foo: "bar")
235
- assert_equal true, obj.send(:metaclass).method_defined?(:foo)
236
- end
237
-
238
- should "warn that #refresh_from is deprecated" do
239
- old_stderr = $stderr
240
- $stderr = StringIO.new
241
- begin
242
- obj = Stripe::StripeObject.construct_from({})
243
- obj.refresh_from({}, {})
244
- message = "NOTE: Stripe::StripeObject#refresh_from is " \
245
- "deprecated; use #update_attributes instead"
246
- assert_match Regexp.new(message), $stderr.string
247
- ensure
248
- $stderr = old_stderr
249
- end
250
- end
251
-
252
- should "pass opts down to children when initializing" do
253
- opts = { custom: "opts" }
254
-
255
- # customer comes with a `sources` list that makes a convenient object to
256
- # perform tests on
257
- obj = Stripe::StripeObject.construct_from({
258
- sources: [
259
- {},
260
- ],
261
- }, opts)
262
-
263
- source = obj.sources.first
264
- # Pulling `@opts` as an instance variable here is not ideal, but it's
265
- # important enough argument that the test here is worth it. we should
266
- # consider exposing it publicly on a future pull (and possibly renaming
267
- # it to something more useful).
268
- assert_equal opts, source.instance_variable_get(:@opts)
269
- end
270
-
271
- should "#serialize_params on an empty object" do
272
- obj = Stripe::StripeObject.construct_from({})
273
- assert_equal({}, obj.serialize_params)
274
- end
275
-
276
- should "#serialize_params on a new object with a subobject" do
277
- obj = Stripe::StripeObject.new
278
- obj.metadata = { foo: "bar" }
279
- assert_equal({ metadata: { foo: "bar" } },
280
- obj.serialize_params)
281
- end
282
-
283
- should "#serialize_params on a basic object" do
284
- obj = Stripe::StripeObject.construct_from(foo: nil)
285
- obj.update_attributes(foo: "bar")
286
- assert_equal({ foo: "bar" }, obj.serialize_params)
287
- end
288
-
289
- should "#serialize_params on a more complex object" do
290
- obj = Stripe::StripeObject.construct_from(foo: Stripe::StripeObject.construct_from(bar: nil,
291
- baz: nil))
292
- obj.foo.bar = "newbar"
293
- assert_equal({ foo: { bar: "newbar" } },
294
- obj.serialize_params)
295
- end
296
-
297
- should "#serialize_params on an array" do
298
- obj = Stripe::StripeObject.construct_from(foo: nil)
299
- obj.foo = ["new-value"]
300
- assert_equal({ foo: ["new-value"] },
301
- obj.serialize_params)
302
- end
303
-
304
- should "#serialize_params on an array that shortens" do
305
- obj = Stripe::StripeObject.construct_from(foo: ["0-index", "1-index", "2-index"])
306
- obj.foo = ["new-value"]
307
- assert_equal({ foo: ["new-value"] },
308
- obj.serialize_params)
309
- end
310
-
311
- should "#serialize_params on an array that lengthens" do
312
- obj = Stripe::StripeObject.construct_from(foo: ["0-index", "1-index", "2-index"])
313
- obj.foo = ["new-value"] * 4
314
- assert_equal({ foo: ["new-value"] * 4 },
315
- obj.serialize_params)
316
- end
317
-
318
- should "#serialize_params on an array of hashes" do
319
- obj = Stripe::StripeObject.construct_from(foo: nil)
320
- obj.foo = [
321
- Stripe::StripeObject.construct_from(bar: nil),
322
- ]
323
- obj.foo[0].bar = "baz"
324
- assert_equal({ foo: [{ bar: "baz" }] },
325
- obj.serialize_params)
326
- end
327
-
328
- should "#serialize_params doesn't include unchanged values" do
329
- obj = Stripe::StripeObject.construct_from(foo: nil)
330
- assert_equal({}, obj.serialize_params)
331
- end
332
-
333
- should "#serialize_params on an array that is unchanged" do
334
- obj = Stripe::StripeObject.construct_from(foo: ["0-index", "1-index", "2-index"])
335
- obj.foo = ["0-index", "1-index", "2-index"]
336
- assert_equal({}, obj.serialize_params)
337
- end
338
-
339
- should "#serialize_params with a StripeObject" do
340
- obj = Stripe::StripeObject.construct_from({})
341
-
342
- # using an #update_attributes will end up converting a Hash into a
343
- # StripeObject
344
- obj.metadata =
345
- Stripe::StripeObject.construct_from(foo: "bar")
346
-
347
- serialized = obj.serialize_params
348
- assert_equal({ foo: "bar" }, serialized[:metadata])
349
- end
350
-
351
- should "#serialize_params with StripeObject that's been replaced" do
352
- obj = Stripe::StripeObject.construct_from(source: Stripe::StripeObject.construct_from(bar: "foo"))
353
-
354
- # Here we replace the object wholesale.
355
- obj.source =
356
- Stripe::StripeObject.construct_from(baz: "foo")
357
-
358
- serialized = obj.serialize_params
359
- assert_equal({ baz: "foo" }, serialized[:source])
360
- end
361
-
362
- should "#serialize_params with StripeObject that's been replaced which is `metadata`" do
363
- class WithAdditiveObjectParam < Stripe::StripeObject
364
- additive_object_param :metadata
365
- end
366
-
367
- obj = WithAdditiveObjectParam.construct_from(metadata: Stripe::StripeObject.construct_from(bar: "foo"))
368
-
369
- # Here we replace the object wholesale. Because it's `metadata`, the
370
- # client must be able to blank out the values that were in the old
371
- # object, but which are no longer present in the new one.
372
- obj.metadata =
373
- Stripe::StripeObject.construct_from(baz: "foo")
374
-
375
- serialized = obj.serialize_params
376
- assert_equal({ bar: "", baz: "foo" }, serialized[:metadata])
377
- end
378
-
379
- should "#serialize_params with an array of StripeObjects" do
380
- obj = Stripe::StripeObject.construct_from({})
381
- obj.metadata = [
382
- Stripe::StripeObject.construct_from(foo: "bar"),
383
- ]
384
-
385
- serialized = obj.serialize_params
386
- assert_equal([{ foo: "bar" }], serialized[:metadata])
387
- end
388
-
389
- should "#serialize_params and embed an API resource that's been set and has an ID" do
390
- customer = Customer.construct_from(id: "cus_123")
391
- obj = Stripe::StripeObject.construct_from({})
392
-
393
- # the key here is that the property is set explicitly (and therefore
394
- # marked as unsaved), which is why it gets included below
395
- obj.customer = customer
396
-
397
- serialized = obj.serialize_params
398
- assert_equal({ customer: customer }, serialized)
399
- end
400
-
401
- should "#serialize_params and not include API resources that have not been set" do
402
- customer = Customer.construct_from(id: "cus_123")
403
- obj = Stripe::StripeObject.construct_from(customer: customer)
404
-
405
- serialized = obj.serialize_params
406
- assert_equal({}, serialized)
407
- end
408
-
409
- should "#serialize_params serializes API resources flagged with save_with_parent" do
410
- c = Customer.construct_from({})
411
- c.save_with_parent = true
412
-
413
- obj = Stripe::StripeObject.construct_from(customer: c)
414
-
415
- serialized = obj.serialize_params
416
- assert_equal({ customer: {} }, serialized)
417
- end
418
-
419
- should "#serialize_params should raise an error on other embedded API resources" do
420
- # This customer doesn't have an ID and therefore the library doesn't know
421
- # what to do with it and throws an ArgumentError because it's probably
422
- # not what the user expected to happen.
423
- customer = Customer.construct_from({})
424
-
425
- obj = Stripe::StripeObject.construct_from({})
426
- obj.customer = customer
427
-
428
- e = assert_raises(ArgumentError) do
429
- obj.serialize_params
430
- end
431
- assert_equal "Cannot save property `customer` containing " \
432
- "an API resource. It doesn't appear to be persisted and is " \
433
- "not marked as `save_with_parent`.", e.message
434
- end
435
-
436
- should "#serialize_params takes a force option" do
437
- obj = Stripe::StripeObject.construct_from(id: "id",
438
- metadata: Stripe::StripeObject.construct_from(foo: "bar"))
439
-
440
- serialized = obj.serialize_params(force: true)
441
- assert_equal({ id: "id", metadata: { foo: "bar" } }, serialized)
442
- end
443
-
444
- should "#dirty! forces an object and its subobjects to be saved" do
445
- obj = Stripe::StripeObject.construct_from(id: "id",
446
- metadata: Stripe::StripeObject.construct_from(foo: "bar"))
447
-
448
- # note that `force` and `dirty!` are for different things, but are
449
- # functionally equivalent
450
- obj.dirty!
451
-
452
- serialized = obj.serialize_params
453
- assert_equal({ id: "id", metadata: { foo: "bar" } }, serialized)
454
- end
455
-
456
- should "#to_s will call to_s for all embedded stripe objects" do
457
- obj = Stripe::StripeObject.construct_from(id: "id",
458
- # embedded list object
459
- refunds: Stripe::ListObject.construct_from(data: [
460
- # embedded object in list
461
- Stripe::StripeObject.construct_from(id: "id",
462
- # embedded object in an object in a list object
463
- metadata: Stripe::StripeObject.construct_from(foo: "bar")),
464
- ]),
465
- # embedded stripe object
466
- metadata: Stripe::StripeObject.construct_from(foo: "bar"))
467
- expected = JSON.pretty_generate(id: "id",
468
- refunds: {
469
- data: [
470
- { id: "id", metadata: { foo: "bar" } },
471
- ],
472
- },
473
- metadata: { foo: "bar" })
474
-
475
- assert_equal(expected, obj.to_s)
476
- end
477
-
478
- should "warn that .serialize_params is deprecated" do
479
- old_stderr = $stderr
480
- $stderr = StringIO.new
481
- begin
482
- obj = Stripe::StripeObject.construct_from({})
483
- Stripe::StripeObject.serialize_params(obj)
484
- message = "NOTE: Stripe::StripeObject.serialize_params is " \
485
- "deprecated; use #serialize_params instead"
486
- assert_match Regexp.new(message), $stderr.string
487
- ensure
488
- $stderr = old_stderr
489
- end
490
- end
491
-
492
- should "error on setting a property to an empty string" do
493
- obj = Stripe::StripeObject.construct_from(foo: "bar")
494
- e = assert_raises ArgumentError do
495
- obj.foo = ""
496
- end
497
- assert_match(/\(object\).foo = nil/, e.message)
498
- end
499
-
500
- should "marshal and unmarshal using custom encoder and decoder" do
501
- obj = Stripe::StripeObject.construct_from(
502
- { id: 1, name: "Stripe" },
503
- api_key: "apikey",
504
- client: StripeClient.active_client
505
- )
506
- m = Marshal.load(Marshal.dump(obj))
507
- assert_equal 1, m.id
508
- assert_equal "Stripe", m.name
509
- expected_hash = { api_key: "apikey" }
510
- assert_equal expected_hash, m.instance_variable_get("@opts")
511
- end
512
-
513
- context "#method" do
514
- should "act as a getter if no arguments are provided" do
515
- obj = Stripe::StripeObject.construct_from(id: 1, method: "foo")
516
- assert_equal "foo", obj.method
517
- end
518
-
519
- should "call Object#method if an argument is provided" do
520
- obj = Stripe::StripeObject.construct_from(id: 1, method: "foo")
521
- assert obj.method(:id).is_a?(Method)
522
- end
523
- end
524
- end
525
- end