balanced 0.2.5 → 0.3.0

data/lib/balanced/resources/resource.rb

@@ -0,0 +1,130 @@
+module Balanced
+  module Resource
+    attr_accessor :attributes
+
+    def initialize attributes = {}
+      @attributes = attributes
+    end
+
+    # delegate the query to the pager module
+
+    def find uri
+      self.class.find uri
+    end
+
+    def save
+      uri = @attributes.delete('uri')
+      method = :post
+      if uri.nil?
+        uri = self.class.collection_path
+      elsif !Balanced.is_collection(uri)
+        method = :put
+      end
+      response = Balanced.send(method, uri, self.attributes)
+      reload response
+    end
+
+    def destroy
+      Balanced.delete @attributes[:uri]
+    end
+
+    def reload response = nil
+      if response
+        return if response.body.to_s.length.zero?
+        fresh = self.class.construct_from_response response.body
+      else
+        fresh = self.find(@attributes[:uri])
+      end
+      fresh and copy_from fresh
+      self
+    end
+
+    def copy_from other
+      other.instance_variables.each do |ivar|
+        instance_variable_set ivar, other.instance_variable_get(ivar)
+      end
+    end
+
+    def method_missing(method, *args, &block)
+      case method
+        when /(.+)\=$/
+          attr = method.to_s.chop
+          @attributes[attr] = args[0]
+        else
+          super
+      end
+    end
+  def self.included(base)
+    base.extend ClassMethods
+  end
+
+  module ClassMethods
+    def resource_name
+      Utils.demodulize name
+    end
+
+    def collection_name
+      Utils.pluralize Utils.underscore(resource_name)
+    end
+
+    def collection_path
+      ["/v#{Balanced.config[:version]}", collection_name].compact.join '/'
+    end
+
+    def member_name
+      Utils.underscore resource_name
+    end
+
+    def construct_from_response payload
+      payload = Balanced::Utils.hash_with_indifferent_read_access payload
+      klass = Balanced.from_uri(payload[:uri])
+      instance = klass.new payload
+      payload.each do |name, value|
+        klass.class_eval {
+          attr_accessor name.to_s
+        }
+        # here is where our interpretations will begin.
+        # if the value is a sub-resource, lets instantiate the class
+        # and set it correctly
+        if value.instance_of? Hash and value.has_key? 'uri'
+          value = construct_from_response value
+        elsif name =~ /_uri$/
+          modified_name = name.sub(/_uri$/, '')
+          klass.instance_eval {
+            define_method(modified_name) {
+              values_class = Balanced.from_uri(value)
+               # if uri is a collection -> this would definitely be if it ends in a symbol
+              # then we should allow a lazy executor of the query pager
+              if Balanced.is_collection(value)
+                # TODO: return the pager
+                p "TODO: return the pager for this class: #{values_class}"
+                values_class.new
+              else
+                values_class.find(value)
+              end
+            }
+          }
+        end
+
+        instance.class.instance_eval {
+          define_method(name) { @attributes[name] }                       # Get.
+          define_method("#{name}=") { |value| @attributes[name] = value } # Set.
+          define_method("#{name}?") { !!@attributes[name].nil? }               # Present.
+        }
+        instance.send("#{name}=".to_s, value)
+      end
+      instance
+    end
+
+    def find uri
+      response = Balanced.get uri
+      construct_from_response response.body
+    end
+
+  end
+
+
+
+  end
+end
+

data/lib/balanced/resources/transaction.rb

@@ -0,0 +1,18 @@
+module Balanced
+  # Any transfer, or potential transfer of, funds from or to, your
+  # Marketplace. E.g. a Credit, Debit, Refund, or Hold.
+  #
+  class Transaction
+    include Balanced::Resource
+
+    def initialize attributes = {}
+      Balanced::Utils.stringify_keys! attributes
+      unless attributes.has_key? 'uri'
+        attributes['uri'] = Balanced::Marketplace.my_marketplace.send(self.class.collection_name + '_uri')
+      end
+      super attributes
+    end
+
+  end
+end
+

data/lib/balanced/version.rb

@@ -1,3 +1,3 @@
 module Balanced
-  VERSION = '0.2.5'
+  VERSION = '0.3.0'
 end

data/spec/balanced/resources/account_spec.rb

@@ -0,0 +1,422 @@
+require "spec_helper"
+
+describe Balanced::Account do
+  use_vcr_cassette
+  before do
+    api_key = Balanced::ApiKey.new.save
+    Balanced.configure api_key.secret
+    @marketplace = Balanced::Marketplace.new.save
+  end
+
+  describe "merchant" do
+    use_vcr_cassette
+
+    before do
+      @merchant_attributes = {
+        :type => "person",
+        :name => "Billy Jones",
+        :street_address => "801 High St.",
+        :postal_code => "94301",
+        :country => "USA",
+        :dob => "1842-01",
+        :phone_number => "+16505551234",
+      }
+    end
+
+    describe "new" do
+      use_vcr_cassette
+      before do
+        @bank_account = Balanced::BankAccount.new(
+          :account_number => "1234567890",
+          :bank_code => "321174851",
+          :name => "Jack Q Merchant"
+        ).save
+      end
+      it do
+        -> do
+          @merchant = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "merchant@example.org",
+            :merchant => @merchant_attributes,
+            :bank_account_uri => @bank_account.uri,
+            :name => "Jack Q Merchant"
+          )
+        end.should_not raise_error
+      end
+    end
+
+    describe "#save" do
+
+      describe "when creating" do
+        use_vcr_cassette
+        before do
+          bank_account = Balanced::BankAccount.new(
+            :account_number => "1234567890",
+            :bank_code => "321174851",
+            :name => "Jack Q Merchant"
+          ).save
+          @merchant = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "merchant@example.org",
+            :merchant => @merchant_attributes,
+            :bank_account_uri => bank_account.uri,
+            :name => "Jack Q Merchant"
+          )
+        end
+        it { -> { @merchant.save }.should_not raise_error }
+      end
+
+      describe "after #save" do
+        describe "attributes" do
+          use_vcr_cassette
+          before do
+            bank_account = Balanced::BankAccount.new(
+              :account_number => "1234567890",
+              :bank_code => "321174851",
+              :name => "Jack Q Merchant"
+            ).save
+            @merchant = Balanced::Account.new(
+              :uri => @marketplace.accounts_uri,
+              :email_address => "merchant2@example.org",
+              :merchant => @merchant_attributes,
+              :bank_account_uri => bank_account.uri,
+              :name => "Jack Q Merchant"
+            ).save
+          end
+
+          describe "#id" do
+            subject { @merchant.id }
+            it { should_not be_nil }
+            it { should_not be_empty }
+          end
+          describe "#roles" do
+            subject { @merchant.roles }
+            it { should include("merchant") }
+          end
+          describe "#email_address" do
+            subject { @merchant.email_address }
+            it { should eql "merchant2@example.org" }
+          end
+          describe "#name" do
+            subject { @merchant.name }
+            it { should eql "Jack Q Merchant" }
+          end
+          describe "#created_at" do
+            subject { @merchant.created_at }
+            it { should_not be_nil }
+            it { should_not be_empty }
+          end
+          describe "#uri" do
+            subject { @merchant.uri }
+            it { should match MERCHANT_URI_REGEX }
+          end
+          describe "#holds_uri" do
+            subject { @merchant.holds_uri }
+            it { should match HOLDS_URI_REGEX }
+          end
+          describe "#bank_accounts_uri" do
+            subject { @merchant.bank_accounts_uri }
+            it { should match BANK_ACCOUNTS_URI_REGEX }
+          end
+          describe "#refunds_uri" do
+            subject { @merchant.refunds_uri }
+            it { should match REFUNDS_URI_REGEX }
+          end
+          describe "#debits_uri" do
+            subject { @merchant.debits_uri }
+            it { should match DEBITS_URI_REGEX }
+          end
+          describe "#transactions_uri" do
+            subject { @merchant.transactions_uri }
+            it { should match TRANSACTIONS_URI_REGEX }
+          end
+          describe "#credits_uri" do
+            subject { @merchant.credits_uri }
+            it { should match CREDITS_URI_REGEX }
+          end
+          describe "#cards_uri" do
+            subject { @merchant.cards_uri }
+            it { should match CARDS_URI_REGEX }
+          end
+        end
+      end
+    end
+
+    describe "#add_bank_account" do
+      describe "when executing" do
+        use_vcr_cassette
+
+        before do
+          @bank_account = Balanced::BankAccount.new(
+            :account_number => "1234567890",
+            :bank_code => "321174851",
+            :name => "Jack Q Merchant"
+          ).save
+
+          @merchant = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "merchant1@example.org",
+            :merchant => @merchant_attributes,
+            :bank_account_uri => @bank_account.uri,
+            :name => "Jack Q Merchant"
+          ).save
+
+          @new_bank_account = Balanced::BankAccount.new(
+            :account_number => "53434533",
+            :bank_code => "12345678",
+            :name => "Jack Q Merchant"
+          ).save
+        end
+        it { -> { @merchant.add_bank_account(@new_bank_account.uri) }.should_not raise_error }
+      end
+
+      describe "after executing" do
+        use_vcr_cassette
+        before do
+          @bank_account = Balanced::BankAccount.new(
+            :account_number => "12345678901",
+            :bank_code => "321174851",
+            :name => "Jack Q Merchant"
+          ).save
+
+          @merchant = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "merchant4@example.org",
+            :merchant => @merchant_attributes,
+            :bank_account_uri => @bank_account.uri,
+            :name => "Jack Q Merchant"
+          ).save
+
+          @new_bank_account = Balanced::BankAccount.new(
+            :account_number => "53434533",
+            :bank_code => "12345678",
+            :name => "Jack Q Merchant"
+          ).save
+          @merchant.add_bank_account(@new_bank_account.uri)
+          @bank_accounts = Balanced::BankAccount.find(@merchant.bank_accounts_uri).items
+        end
+
+        subject { @bank_accounts.size }
+        it { should eql 2 }
+      end
+
+
+    end
+  end
+
+  describe "buyer" do
+    describe "#save" do
+      describe "when creating" do
+        use_vcr_cassette
+        before do
+          card = Balanced::Card.new(
+            :card_number => "5105105105105100",
+            :expiration_month => "12",
+            :expiration_year => "2015",
+          ).save
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          )
+        end
+        it { -> { @buyer.save }.should_not raise_error }
+      end
+
+      describe "after #save" do
+        describe "attributes" do
+          use_vcr_cassette
+          before do
+            card = Balanced::Card.new(
+              :card_number => "4111111111111111",
+              :expiration_month => "12",
+              :expiration_year => "2015",
+            ).save
+            @buyer = Balanced::Account.new(
+              :uri => @marketplace.accounts_uri,
+              :email_address => "buyer2@example.org",
+              :card_uri => card.uri,
+              :name => "Jack Q Buyer"
+            ).save
+          end
+
+          describe "#id" do
+            subject { @buyer.id }
+            it { should_not be_nil }
+            it { should_not be_empty }
+          end
+          describe "#roles" do
+            subject { @buyer.roles }
+            it { should include("buyer") }
+            it { should_not include("merchant") }
+          end
+          describe "#email_address" do
+            subject { @buyer.email_address }
+            it { should eql "buyer2@example.org" }
+          end
+          describe "#name" do
+            subject { @buyer.name }
+            it { should eql "Jack Q Buyer" }
+          end
+          describe "#created_at" do
+            subject { @buyer.created_at }
+            it { should_not be_nil }
+            it { should_not be_empty }
+          end
+          describe "#uri" do
+            subject { @buyer.uri }
+            it { should match MERCHANT_URI_REGEX }
+          end
+          describe "#holds_uri" do
+            subject { @buyer.holds_uri }
+            it { should match HOLDS_URI_REGEX }
+          end
+          describe "#bank_accounts_uri" do
+            subject { @buyer.bank_accounts_uri }
+            it { should match BANK_ACCOUNTS_URI_REGEX }
+          end
+          describe "#refunds_uri" do
+            subject { @buyer.refunds_uri }
+            it { should match REFUNDS_URI_REGEX }
+          end
+          describe "#debits_uri" do
+            subject { @buyer.debits_uri }
+            it { should match DEBITS_URI_REGEX }
+          end
+          describe "#transactions_uri" do
+            subject { @buyer.transactions_uri }
+            it { should match TRANSACTIONS_URI_REGEX }
+          end
+          describe "#credits_uri" do
+            subject { @buyer.credits_uri }
+            it { should match CREDITS_URI_REGEX }
+          end
+          describe "#cards_uri" do
+            subject { @buyer.cards_uri }
+            it { should match CARDS_URI_REGEX }
+          end
+        end
+      end
+    end
+
+
+    describe "#add_card" do
+
+      describe "when executing" do
+        use_vcr_cassette
+        before do
+          card = Balanced::Card.new(
+            :card_number => "4111111111111111",
+            :expiration_month => "12",
+            :expiration_year => "2015",
+          ).save
+          @new_card = Balanced::Card.new(
+            :card_number => "4111111111111111",
+            :expiration_month => "1",
+            :expiration_year => "2015",
+          ).save
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer3@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          ).save
+        end
+        it do
+          -> { @buyer.add_card(@new_card.uri) }.should_not raise_error
+        end
+      end
+      describe "after executing" do
+        use_vcr_cassette
+
+        before do
+          card = Balanced::Card.new(
+            :card_number => "4111111111111111",
+            :expiration_month => "12",
+            :expiration_year => "2015",
+          ).save
+          @new_card = Balanced::Card.new(
+            :card_number => "5105105105105100",
+            :expiration_month => "1",
+            :expiration_year => "2017",
+          ).save
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer4@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          ).save
+          @buyer.add_card(@new_card.uri)
+          @cards = Balanced::Card.find @buyer.cards_uri
+        end
+        subject { @cards.items.size }
+        it { should eql 2 }
+      end
+    end
+
+    describe "#promote_to_merchant" do
+
+      describe "when executing" do
+        use_vcr_cassette
+        before do
+
+          @merchant_attributes = {
+            :type => "person",
+            :name => "Billy Jones",
+            :street_address => "801 High St.",
+            :postal_code => "94301",
+            :country => "USA",
+            :dob => "1842-01",
+            :phone_number => "+16505551234",
+          }
+          card = Balanced::Card.new(
+            :card_number => "4111111111111111",
+            :expiration_month => "12",
+            :expiration_year => "2015",
+          ).save
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer5@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          ).save
+        end
+
+        it do
+          -> { @buyer.promote_to_merchant @merchant_attributes}.should_not raise_error
+        end
+      end
+      describe "after executing" do
+        use_vcr_cassette
+
+        before do
+          @merchant_attributes = {
+            :type => "person",
+            :name => "Billy Jones",
+            :street_address => "801 High St.",
+            :postal_code => "94301",
+            :country => "USA",
+            :dob => "1842-01",
+            :phone_number => "+16505551234",
+          }
+          card = Balanced::Card.new(
+            :card_number => "4111111111111111",
+            :expiration_month => "12",
+            :expiration_year => "2015",
+          ).save
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer6@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          ).save
+          @buyer.promote_to_merchant @merchant_attributes
+        end
+        subject { @buyer.roles }
+        it { should include("merchant") }
+      end
+
+    end
+  end
+end