mirror of
https://github.com/stripe/stripe-ruby.git
synced 2025-10-15 00:00:44 -04:00
863da48398
Adds the magic `frozen_string_literal: true` comment to every file and enables a Rubocop rule to make sure that it's always going to be there going forward as well. See here for more background [1], but the basic idea is that unlike many other languages, static strings in code are mutable by default. This has since been acknowledged as not a particularly good idea, and the intention is to rectify the mistake when Ruby 3 comes out, where all string literals will be frozen. The `frozen_string_literal` magic comment was introduced in Ruby 2.3 as a way of easing the transition, and allows libraries and projects to freeze their literals in advance. I don't think this is breaking in any way: it's possible that users might've been pulling out one of are literals somehow and mutating it, but that would probably not have been useful for anything and would certainly not be recommended, so I'm quite comfortable pushing this change through as a minor version. As discussed in #641. [1] https://stackoverflow.com/a/37799399
91 lines
2.6 KiB
Ruby
91 lines
2.6 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
module Stripe
|
|
class Customer < APIResource
|
|
extend Stripe::APIOperations::Create
|
|
include Stripe::APIOperations::Delete
|
|
include Stripe::APIOperations::Save
|
|
extend Stripe::APIOperations::List
|
|
extend Stripe::APIOperations::NestedResource
|
|
|
|
OBJECT_NAME = "customer".freeze
|
|
|
|
save_nested_resource :source
|
|
nested_resource_class_methods :source,
|
|
operations: %i[create retrieve update delete list]
|
|
|
|
# The API request for deleting a card or bank account and for detaching a
|
|
# source object are the same.
|
|
class << self
|
|
alias detach_source delete_source
|
|
end
|
|
|
|
def add_invoice_item(params, opts = {})
|
|
opts = @opts.merge(Util.normalize_opts(opts))
|
|
InvoiceItem.create(params.merge(customer: id), opts)
|
|
end
|
|
|
|
def invoices(params = {}, opts = {})
|
|
opts = @opts.merge(Util.normalize_opts(opts))
|
|
Invoice.all(params.merge(customer: id), opts)
|
|
end
|
|
|
|
def invoice_items(params = {}, opts = {})
|
|
opts = @opts.merge(Util.normalize_opts(opts))
|
|
InvoiceItem.all(params.merge(customer: id), opts)
|
|
end
|
|
|
|
def upcoming_invoice(params = {}, opts = {})
|
|
opts = @opts.merge(Util.normalize_opts(opts))
|
|
Invoice.upcoming(params.merge(customer: id), opts)
|
|
end
|
|
|
|
def charges(params = {}, opts = {})
|
|
opts = @opts.merge(Util.normalize_opts(opts))
|
|
Charge.all(params.merge(customer: id), opts)
|
|
end
|
|
|
|
def create_upcoming_invoice(params = {}, opts = {})
|
|
opts = @opts.merge(Util.normalize_opts(opts))
|
|
Invoice.create(params.merge(customer: id), opts)
|
|
end
|
|
|
|
def cancel_subscription(params = {}, opts = {})
|
|
resp, opts = request(:delete, subscription_url, params, opts)
|
|
initialize_from({ subscription: resp.data }, opts, true)
|
|
subscription
|
|
end
|
|
|
|
def update_subscription(params = {}, opts = {})
|
|
resp, opts = request(:post, subscription_url, params, opts)
|
|
initialize_from({ subscription: resp.data }, opts, true)
|
|
subscription
|
|
end
|
|
|
|
def create_subscription(params = {}, opts = {})
|
|
resp, opts = request(:post, subscriptions_url, params, opts)
|
|
initialize_from({ subscription: resp.data }, opts, true)
|
|
subscription
|
|
end
|
|
|
|
def delete_discount
|
|
_, opts = request(:delete, discount_url)
|
|
initialize_from({ discount: nil }, opts, true)
|
|
end
|
|
|
|
private
|
|
|
|
def discount_url
|
|
resource_url + "/discount"
|
|
end
|
|
|
|
def subscription_url
|
|
resource_url + "/subscription"
|
|
end
|
|
|
|
def subscriptions_url
|
|
resource_url + "/subscriptions"
|
|
end
|
|
end
|
|
end
|