stripe 1.7.0 → 1.7.1

data/lib/stripe/account.rb

@@ -0,0 +1,4 @@
+module Stripe
+  class Account < SingletonAPIResource
+  end
+end

data/lib/stripe/api_operations/create.rb

@@ -0,0 +1,16 @@
+module Stripe
+  module APIOperations
+    module Create
+      module ClassMethods
+        def create(params={}, api_key=nil)
+          response, api_key = Stripe.request(:post, self.url, api_key, params)
+          Util.convert_to_stripe_object(response, api_key)
+        end
+      end
+
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+    end
+  end
+end

data/lib/stripe/api_operations/delete.rb

@@ -0,0 +1,11 @@
+module Stripe
+  module APIOperations
+    module Delete
+      def delete
+        response, api_key = Stripe.request(:delete, url, @api_key)
+        refresh_from(response, api_key)
+        self
+      end
+    end
+  end
+end

data/lib/stripe/api_operations/list.rb

@@ -0,0 +1,16 @@
+module Stripe
+  module APIOperations
+    module List
+      module ClassMethods
+        def all(filters={}, api_key=nil)
+          response, api_key = Stripe.request(:get, url, api_key, filters)
+          Util.convert_to_stripe_object(response, api_key)
+        end
+      end
+
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+    end
+  end
+end

data/lib/stripe/api_operations/update.rb

@@ -0,0 +1,15 @@
+module Stripe
+  module APIOperations
+    module Update
+      def save
+        if @unsaved_values.length > 0
+          values = {}
+          @unsaved_values.each { |k| values[k] = @values[k] }
+          response, api_key = Stripe.request(:post, url, @api_key, values)
+          refresh_from(response, api_key)
+        end
+        self
+      end
+    end
+  end
+end

data/lib/stripe/api_resource.rb

@@ -0,0 +1,33 @@
+module Stripe
+  class APIResource < StripeObject
+    def self.class_name
+      self.name.split('::')[-1]
+    end
+
+    def self.url()
+      if self == APIResource
+        raise NotImplementedError.new('APIResource is an abstract class.  You should perform actions on its subclasses (Charge, Customer, etc.)')
+      end
+      "/#{CGI.escape(class_name.downcase)}s"
+    end
+
+    def url
+      unless id = self['id']
+        raise InvalidRequestError.new("Could not determine which URL to request: #{self.class} instance has invalid ID: #{id.inspect}", 'id')
+      end
+      "#{self.class.url}/#{CGI.escape(id)}"
+    end
+
+    def refresh
+      response, api_key = Stripe.request(:get, url, @api_key)
+      refresh_from(response, api_key)
+      self
+    end
+
+    def self.retrieve(id, api_key=nil)
+      instance = self.new(id, api_key)
+      instance.refresh
+      instance
+    end
+  end
+end

data/lib/stripe/charge.rb

@@ -0,0 +1,29 @@
+module Stripe
+  class Charge < APIResource
+    include Stripe::APIOperations::List
+    include Stripe::APIOperations::Create
+    include Stripe::APIOperations::Update
+
+    def refund(params={})
+      response, api_key = Stripe.request(:post, refund_url, @api_key, params)
+      refresh_from(response, api_key)
+      self
+    end
+
+    def capture(params={})
+      response, api_key = Stripe.request(:post, capture_url, @api_key, params)
+      refresh_from(response, api_key)
+      self
+    end
+
+    private
+
+    def refund_url
+      url + '/refund'
+    end
+
+    def capture_url
+      url + '/capture'
+    end
+  end
+end

data/lib/stripe/coupon.rb

@@ -0,0 +1,7 @@
+module Stripe
+  class Coupon < APIResource
+    include Stripe::APIOperations::Create
+    include Stripe::APIOperations::Delete
+    include Stripe::APIOperations::List
+  end
+end

data/lib/stripe/customer.rb

@@ -0,0 +1,51 @@
+module Stripe
+  class Customer < APIResource
+    include Stripe::APIOperations::Create
+    include Stripe::APIOperations::Delete
+    include Stripe::APIOperations::Update
+    include Stripe::APIOperations::List
+
+    def add_invoice_item(params)
+      InvoiceItem.create(params.merge(:customer => id), @api_key)
+    end
+
+    def invoices
+      Invoice.all({ :customer => id }, @api_key)
+    end
+
+    def invoice_items
+      InvoiceItem.all({ :customer => id }, @api_key)
+    end
+
+    def charges
+      Charge.all({ :customer => id }, @api_key)
+    end
+
+    def cancel_subscription(params={})
+      response, api_key = Stripe.request(:delete, subscription_url, @api_key, params)
+      refresh_from({ :subscription => response }, api_key, true)
+      subscription
+    end
+
+    def update_subscription(params)
+      response, api_key = Stripe.request(:post, subscription_url, @api_key, params)
+      refresh_from({ :subscription => response }, api_key, true)
+      subscription
+    end
+
+    def delete_discount
+      Stripe.request(:delete, discount_url, @api_key)
+      refresh_from({ :discount => nil }, api_key, true)
+    end
+
+    private
+
+    def discount_url
+      url + '/discount'
+    end
+
+    def subscription_url
+      url + '/subscription'
+    end
+  end
+end

data/lib/stripe/errors/api_connection_error.rb

@@ -0,0 +1,4 @@
+module Stripe
+  class APIConnectionError < StripeError
+  end
+end

data/lib/stripe/errors/api_error.rb

@@ -0,0 +1,4 @@
+module Stripe
+  class APIError < StripeError
+  end
+end

data/lib/stripe/errors/authentication_error.rb

@@ -0,0 +1,4 @@
+module Stripe
+  class AuthenticationError < StripeError
+  end
+end

data/lib/stripe/errors/card_error.rb

@@ -0,0 +1,11 @@
+module Stripe
+  class CardError < StripeError
+    attr_reader :param, :code
+
+    def initialize(message, param, code, http_status=nil, http_body=nil, json_body=nil)
+      super(message, http_status, http_body, json_body)
+      @param = param
+      @code = code
+    end
+  end
+end

data/lib/stripe/errors/invalid_request_error.rb

@@ -0,0 +1,10 @@
+module Stripe
+  class InvalidRequestError < StripeError
+    attr_accessor :param
+
+    def initialize(message, param, http_status=nil, http_body=nil, json_body=nil)
+      super(message, http_status, http_body, json_body)
+      @param = param
+    end
+  end
+end

data/lib/stripe/errors/stripe_error.rb

@@ -0,0 +1,20 @@
+module Stripe
+  class StripeError < StandardError
+    attr_reader :message
+    attr_reader :http_status
+    attr_reader :http_body
+    attr_reader :json_body
+
+    def initialize(message=nil, http_status=nil, http_body=nil, json_body=nil)
+      @message = message
+      @http_status = http_status
+      @http_body = http_body
+      @json_body = json_body
+    end
+
+    def to_s
+      status_string = @http_status.nil? ? "" : "(Status #{@http_status}) "
+      "#{status_string}#{@message}"
+    end
+  end
+end

data/lib/stripe/event.rb

@@ -0,0 +1,5 @@
+module Stripe
+  class Event < APIResource
+    include Stripe::APIOperations::List
+  end
+end

data/lib/stripe/invoice.rb

@@ -0,0 +1,16 @@
+module Stripe
+  class Invoice < APIResource
+    include Stripe::APIOperations::List
+
+    def self.upcoming(params)
+      response, api_key = Stripe.request(:get, upcoming_url, @api_key, params)
+      Util.convert_to_stripe_object(response, api_key)
+    end
+
+    private
+
+    def self.upcoming_url
+      url + '/upcoming'
+    end
+  end
+end

data/lib/stripe/invoice_item.rb

@@ -0,0 +1,8 @@
+module Stripe
+  class InvoiceItem < APIResource
+    include Stripe::APIOperations::List
+    include Stripe::APIOperations::Create
+    include Stripe::APIOperations::Delete
+    include Stripe::APIOperations::Update
+  end
+end

data/lib/stripe/json.rb

@@ -0,0 +1,21 @@
+module Stripe
+  module JSON
+    if MultiJson.respond_to?(:dump)
+      def self.dump(*args)
+        MultiJson.dump(*args)
+      end
+
+      def self.load(*args)
+        MultiJson.load(*args)
+      end
+    else
+      def self.dump(*args)
+        MultiJson.encode(*args)
+      end
+
+      def self.load(*args)
+        MultiJson.decode(*args)
+      end
+    end
+  end
+end

data/lib/stripe/plan.rb

@@ -0,0 +1,8 @@
+module Stripe
+  class Plan < APIResource
+    include Stripe::APIOperations::Create
+    include Stripe::APIOperations::Delete
+    include Stripe::APIOperations::List
+    include Stripe::APIOperations::Update
+  end
+end

data/lib/stripe/singleton_api_resource.rb

@@ -0,0 +1,20 @@
+module Stripe
+  class SingletonAPIResource < APIResource
+    def self.url()
+      if self == SingletonAPIResource
+        raise NotImplementedError.new('SingletonAPIResource is an abstract class.  You should perform actions on its subclasses (Account, etc.)')
+      end
+      "/#{CGI.escape(class_name.downcase)}"
+    end
+
+    def url
+      self.class.url
+    end
+
+    def self.retrieve(api_key=nil)
+      instance = self.new(nil, api_key)
+      instance.refresh
+      instance
+    end
+  end
+end

data/lib/stripe/stripe_object.rb

@@ -0,0 +1,150 @@
+module Stripe
+  class StripeObject
+    include Enumerable
+
+    attr_accessor :api_key
+    @@permanent_attributes = Set.new([:api_key])
+
+    # The default :id method is deprecated and isn't useful to us
+    if method_defined?(:id)
+      undef :id
+    end
+
+    def initialize(id=nil, api_key=nil)
+      @api_key = api_key
+      @values = {}
+      # This really belongs in APIResource, but not putting it there allows us
+      # to have a unified inspect method
+      @unsaved_values = Set.new
+      @transient_values = Set.new
+      self.id = id if id
+    end
+
+    def self.construct_from(values, api_key=nil)
+      obj = self.new(values[:id], api_key)
+      obj.refresh_from(values, api_key)
+      obj
+    end
+
+    def to_s(*args)
+      Stripe::JSON.dump(@values, :pretty => true)
+    end
+
+    def inspect()
+      id_string = (self.respond_to?(:id) && !self.id.nil?) ? " id=#{self.id}" : ""
+      "#<#{self.class}:0x#{self.object_id.to_s(16)}#{id_string}> JSON: " + Stripe::JSON.dump(@values, :pretty => true)
+    end
+
+    def refresh_from(values, api_key, partial=false)
+      @api_key = api_key
+
+      removed = partial ? Set.new : Set.new(@values.keys - values.keys)
+      added = Set.new(values.keys - @values.keys)
+      # Wipe old state before setting new.  This is useful for e.g. updating a
+      # customer, where there is no persistent card parameter.  Mark those values
+      # which don't persist as transient
+
+      instance_eval do
+        remove_accessors(removed)
+        add_accessors(added)
+      end
+      removed.each do |k|
+        @values.delete(k)
+        @transient_values.add(k)
+        @unsaved_values.delete(k)
+      end
+      values.each do |k, v|
+        @values[k] = Util.convert_to_stripe_object(v, api_key)
+        @transient_values.delete(k)
+        @unsaved_values.delete(k)
+      end
+    end
+
+    def [](k)
+      k = k.to_sym if k.kind_of?(String)
+      @values[k]
+    end
+
+    def []=(k, v)
+      send(:"#{k}=", v)
+    end
+
+    def keys
+      @values.keys
+    end
+
+    def values
+      @values.values
+    end
+
+    def to_json(*a)
+      Stripe::JSON.dump(@values)
+    end
+
+    def as_json(*a)
+      @values.as_json(*a)
+    end
+
+    def to_hash
+      @values
+    end
+
+    def each(&blk)
+      @values.each(&blk)
+    end
+
+    protected
+
+    def metaclass
+      class << self; self; end
+    end
+
+    def remove_accessors(keys)
+      metaclass.instance_eval do
+        keys.each do |k|
+          next if @@permanent_attributes.include?(k)
+          k_eq = :"#{k}="
+          remove_method(k) if method_defined?(k)
+          remove_method(k_eq) if method_defined?(k_eq)
+        end
+      end
+    end
+
+    def add_accessors(keys)
+      metaclass.instance_eval do
+        keys.each do |k|
+          next if @@permanent_attributes.include?(k)
+          k_eq = :"#{k}="
+          define_method(k) { @values[k] }
+          define_method(k_eq) do |v|
+            @values[k] = v
+            @unsaved_values.add(k)
+          end
+        end
+      end
+    end
+
+    def method_missing(name, *args)
+      # TODO: only allow setting in updateable classes.
+      if name.to_s.end_with?('=')
+        attr = name.to_s[0...-1].to_sym
+        @values[attr] = args[0]
+        @unsaved_values.add(attr)
+        add_accessors([attr])
+        return
+      else
+        return @values[name] if @values.has_key?(name)
+      end
+
+      begin
+        super
+      rescue NoMethodError => e
+        if @transient_values.include?(name)
+          raise NoMethodError.new(e.message + ".  HINT: The '#{name}' attribute was set in the past, however.  It was then wiped when refreshing the object with the result returned by Stripe's API, probably as a result of a save().  The attributes currently available on this object are: #{@values.keys.join(', ')}")
+        else
+          raise
+        end
+      end
+    end
+  end
+end