balanced 0.3.4 → 0.3.5

data/examples/examples.rb

@@ -1,5 +1,6 @@
 $:.unshift("/Users/mahmoud/code/poundpay/ruby/balanced-ruby/lib")
 require 'balanced'
+
 begin
   Balanced::Card
 rescue NameError
@@ -19,12 +20,17 @@ Balanced.configure(nil, options)
 puts "create our new api key"
 api_key = Balanced::ApiKey.new.save
 puts "Our secret is: ", api_key.secret
+secret = api_key.secret
 
-puts "configure with our secret #{api_key}"
-Balanced.configure(api_key.secret)
+puts "configure with our secret #{secret}"
+Balanced.configure(secret)
 
 puts "create our marketplace"
-marketplace = Balanced::Marketplace.new.save
+begin
+  marketplace = Balanced::Marketplace.new.save
+rescue Balanced::Conflict => ex
+  marketplace = Balanced::Marketplace.my_marketplace
+end
 
 raise "Merchant.me should not be nil" if Balanced::Merchant.me.nil?
 puts "what's my merchant?, easy: Merchant.me: ", Balanced::Merchant.me
@@ -34,11 +40,12 @@ raise "Marketplace.my_marketplace should not be nil" if Balanced::Marketplace.my
 puts "what's my marketplace?, easy: Marketplace.my_marketplace: ", Balanced::Marketplace.my_marketplace
 
 puts "My marketplace's name is: #{marketplace.name}"
-puts "Changing it to TestFooey"
-marketplace.name = "TestFooey"
+random_name = (0...10).map{ ('a'..'z').to_a[rand(26)] }.join
+puts "Changing it to #{random_name}"
+marketplace.name = random_name
 marketplace.save
 puts "My marketplace name is now: #{Balanced::Marketplace.my_marketplace.name}"
-raise "Marketplace name is NOT TestFooey!" if Balanced::Marketplace.my_marketplace.name != "TestFooey"
+raise "Marketplace name is NOT #{random_name}!" if Balanced::Marketplace.my_marketplace.name != random_name
 
 puts "cool! let's create a new card."
 card = Balanced::Card.new(
@@ -49,17 +56,20 @@ card = Balanced::Card.new(
 puts "Our card uri: #{card.uri}"
 
 puts "create our **buyer** account"
-buyer = marketplace.create_buyer("buyer@example.org", card.uri)
+buyer = marketplace.create_buyer(
+    :email_address => "buyer@example.org",
+    :card_uri => card.uri
+)
 puts "our buyer account: #{buyer.uri}"
 
 puts "hold some amount of funds on the buyer, lets say 15$"
-the_hold = buyer.hold(1500)
+the_hold = buyer.hold(:amount => 1500)
 
-puts "the hold has a fee of 35c, here's the fee #{the_hold.fee}"
-raise "The hold's fee is incorrect" if the_hold.fee != 35
+puts "the hold has a fee of 30c, here's the fee #{the_hold.fee}"
+raise "The hold's fee is incorrect" if the_hold.fee != 30
 
 puts "ok, no more holds! lets just capture it (for the full amount)"
-debit = the_hold.capture()
+debit = the_hold.capture
 
 puts "hmm, how much money do i have in escrow? should equal the debit amount"
 marketplace = marketplace.reload
@@ -82,8 +92,8 @@ bank_account = Balanced::BankAccount.new(
 ).save
 
 merchant = marketplace.create_merchant(
-    "merchant@example.org",
-    {
+    :email_address => "merchant@example.org",
+    :merchant => {
       :type => "person",
       :name => "Billy Jones",
       :street_address => "801 High St.",
@@ -92,27 +102,34 @@ merchant = marketplace.create_merchant(
       :dob => "1842-01",
       :phone_number => "+16505551234",
     },
-    bank_account.uri,
-    "Jack Q Merchant",
+    :bank_account_uri => bank_account.uri,
+    :name => "Jack Q Merchant",
 )
 
 puts "oh our buyer is interested in buying something for 130.00$"
-another_debit = buyer.debit(13000, "MARKETPLACE.COM")
+another_debit = buyer.debit(
+    :amount => 13000,
+    :appears_on_statement_as => "MARKETPLACE.COM"
+)
 
 puts "lets credit our merchant 110.00$"
-credit = merchant.credit(11000, "Buyer purchased something on MARKETPLACE.COM")
+credit = merchant.credit(
+    :amount => 11000,
+    :description => "Buyer purchased something on MARKETPLACE.COM"
+)
 
 puts "lets assume the marketplace charges 15%, so it earned ~20"
-mp_credit = marketplace.owner_account.credit(2000, "Our commission from MARKETPLACE.COM")
+mp_credit = marketplace.owner_account.credit(
+    :amount => 2000,
+    :description => "Our commission from MARKETPLACE.COM"
+)
 
 puts "ok lets invalid a card"
-card['is_valid'] = false
-card.save
+card.invalidate
 
 raise "This card is INCORRECTLY VALID" if card.is_valid
 
 puts "invalidating a bank account"
-bank_account['is_valid'] = false
-bank_account.save
+bank_account.invalidate
 
 raise "This card is INCORRECTLY VALID" if bank_account.is_valid

data/lib/balanced.rb

@@ -13,6 +13,7 @@ module Balanced
   @client = nil
   @config = {
       :scheme => 'https',
+
       :host => 'api.balancedpayments.com',
       :port => 443,
       :version => '1',
@@ -27,6 +28,10 @@ module Balanced
       @client = Balanced::Client.new(api_key, @config.merge(options))
     end
 
+    def is_configured_with_api_key?
+      !@client.api_key.nil?
+    end
+
     def split_the_uri uri
       URI.parse(uri).path.sub(/\/$/, '').split('/')
     end

data/lib/balanced/pager.rb

@@ -0,0 +1,152 @@
+require "cgi"
+
+module Balanced
+  class Pager
+    include Enumerable
+
+    # A pager for paginating through resource records.
+    def initialize uri, options = {}
+      @uri = uri
+      @options = options
+      @page = nil
+      @resource_class = nil
+    end
+
+    def resource_class
+      return @resource_class unless @resource_class.nil?
+      load! unless @page
+      @resource_class = Balanced.from_uri items.first[:uri]
+    end
+
+    def first
+      load! unless @page
+      items.first.nil? ? nil : resource_class.construct_from_response(items.first)
+=begin
+      if items.first.nil?
+        return nil
+      end
+      resource_class.construct_from_response items.first
+=end
+    end
+
+    def total
+      load! unless @page
+      @page[:total]
+    end
+
+    def limit
+      load! unless @page
+      @page[:limit]
+    end
+
+    def offset
+      load! unless @page
+      @page[:offset]
+    end
+
+    def items
+      load! unless @page
+      @page[:items]
+    end
+
+    # @return [Array] Iterates through the current page of records.
+    # @yield [record]
+    def each
+      return enum_for :each unless block_given?
+
+      load! unless @page
+
+      loop do
+        @page[:items].each do |record|
+          yield resource_class.construct_from_response record
+        end
+        break if @page[:next_uri].nil?
+        self.next
+      end
+
+    end
+
+    # @return [nil]
+    # @see Resource.find_each
+    # @yield [record]
+    def find_each
+      return enum_for :find_each unless block_given?
+      begin
+        each { |record| yield record }
+      end while self.next
+    end
+
+    # @return [Array, nil] Refreshes the pager's collection of records with
+    #   the next page.
+    def next
+      load! unless @page
+      next_uri = @page[:next_uri]
+      load_from next_uri, nil unless next_uri.nil?
+    end
+
+    # @return [Array, nil] Refreshes the pager's collection of records with
+    #   the previous page.
+    def prev
+      load! unless @page
+      prev_uri = @page[:prev_uri]
+      load_from prev_uri, nil unless prev_uri.nil?
+    end
+
+    # @return [Array, nil] Refreshes the pager's collection of records with
+    #   the first page.
+    def start
+      load! unless @page
+      first_page = @page[:first_page]
+      load_from first_page, nil unless first_page.nil?
+    end
+
+    # @return [Array, nil] Load (or reload) the pager's collection from the
+    #   original, supplied options.
+    def load!
+      load_from @uri, @options
+    end
+    alias reload load!
+
+    # @return [Pager] Duplicates the pager, updating it with the options
+    #   supplied. Useful for resource scopes.
+    # @see #initialize
+    def paginate options = {}
+      dup.instance_eval {
+        @page = nil
+        @options.update options and self
+      }
+    end
+    alias scoped paginate
+    alias where  paginate
+
+    def all options = {}
+      paginate(options).to_a
+    end
+
+    def find uri
+      if resource_class.respond_to? :find
+        raise NoMethodError,
+            "#find must be called on #{resource_class} directly"
+      end
+
+      resource_class.find uri
+    end
+
+
+    private
+
+    def load_from uri, params
+      parsed_uri = URI.parse(uri)
+
+      unless parsed_uri.query.nil?
+        params.merge! CGI::parse(parsed_uri.query)
+        parsed_uri.query = nil
+      end
+
+      response = Balanced.get parsed_uri.to_s, params
+      @page = Balanced::Utils.hash_with_indifferent_read_access response.body
+      @uri = @page[:uri]
+    end
+
+  end
+end

data/lib/balanced/resources/account.rb

@@ -10,7 +10,7 @@ module Balanced
     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')
+        attributes['uri'] = self.class.uri
       end
       super attributes
     end
@@ -21,33 +21,26 @@ module Balanced
     # @return [Account] if buyer is found
     # @return [nil] if buyer is not found
     def self.find_by_email email
-      response = Balanced.get Balanced::Marketplace.my_marketplace.accounts_uri, {email_address: email}
-      record = response.body["items"].first
-      construct_from_response(record) unless record.nil?
-    end
-
-    def save
-      the_response = super
-      if response.status == 300
-        raise MoreInformationRequiredError, response
-      end
-      the_response
+      self.find(:first, :email_address => email)
     end
 
     # Returns a new Debit that represents a flow of money from this
     # Account to your Marketplace's escrow account.
     #
     # @return [Debit]
-    def debit (amount=nil,
-        appears_on_statement_as=nil,
-        hold_uri=nil,
-        meta={},
-        description=nil,
-        source_uri=nil)
+    def debit *args
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      amount = args[0] || options.fetch(:amount) { nil }
+      soft_descriptor = args[1] || options.fetch(:appears_on_statement_as) { nil }
+      hold_uri = args[2] || options.fetch(:hold_uri) { nil }
+      meta = args[3] || options.fetch(:meta) { nil }
+      description = args[4] || options.fetch(:description) { nil }
+      source_uri = args[5] || options.fetch(:source_uri) { nil }
+
       debit = Debit.new(
           :uri => self.debits_uri,
           :amount => amount,
-          :appears_on_statement_as => appears_on_statement_as,
+          :appears_on_statement_as => soft_descriptor,
           :hold_uri => hold_uri,
           :meta => meta,
           :description => description,
@@ -65,7 +58,12 @@ module Balanced
     #    added Card is used.
     # @return [Hold] A Hold representing the reservation of funds from
     #    this Account to your Marketplace.
-    def hold amount, meta={}, source_uri=nil
+    def hold *args
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      amount = args[0] || options.fetch(:amount) { }
+      meta = args[1] || options.fetch(:meta) { nil }
+      source_uri = args[2] || options.fetch(:source_uri) { nil }
+
       hold = Hold.new(
           :uri => self.holds_uri,
           :amount => amount,
@@ -82,7 +80,13 @@ module Balanced
     #    a BankAccount already associated with this account.
     # @return [Credit] A Credit representing the transfer of funds from
     #    your Marketplace to this Account.
-    def credit amount, description=nil, meta={}, destination_uri=nil
+    def credit *args
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      amount = args[0] || options.fetch(:amount) { }
+      description = args[1] || options.fetch(:description) { nil }
+      meta = args[2] || options.fetch(:meta) { nil }
+      destination_uri = args[3] || options.fetch(:destination_uri) { nil }
+
       credit = Credit.new(
           :uri => self.credits_uri,
           :amount => amount,

data/lib/balanced/resources/api_key.rb

@@ -12,7 +12,7 @@ module Balanced
       Balanced.configure nil
       super
     end
-    def wut; end;
+
   end
 
 end

data/lib/balanced/resources/bank_account.rb

@@ -10,7 +10,7 @@ module Balanced
     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')
+        attributes['uri'] = self.class.uri
       end
       super attributes
     end
@@ -20,15 +20,32 @@ module Balanced
     # @param [String] appears_on_statement_as If nil then Balanced will use
     #    the +domain_name+ property from your Marketplace.
     # @return [Debit]
-    def debit amount, appears_on_statement_as=nil, meta={}, description=nil
-      self.account.debit(amount, appears_on_statement_as, meta, description, self.uri)
+    def debit *args
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      amount = args[0] || options.fetch(:amount) { nil }
+      soft_descriptor = args[1] || options.fetch(:appears_on_statement_as) { nil }
+      meta = args[2] || options.fetch(:meta) { nil }
+      description = args[3] || options.fetch(:description) { nil }
+
+      self.account.debit(amount, soft_descriptor, meta, description, self.uri)
     end
 
     # Creates a Credit of funds from your Marketplace's escrow account to this Account.
     #
     # @return [Credit]
-    def credit amount, description=nil, meta={}
+    def credit *args
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      amount = args[0] || options.fetch(:amount) { nil }
+      description = args[1] || options.fetch(:description) { nil }
+      meta = args[2] || options.fetch(:meta) { nil }
+
       self.account.credit(amount, description, meta, self.uri)
     end
+
+    def invalidate
+      self.is_valid = false
+      save
+    end
+
   end
 end

data/lib/balanced/resources/card.rb

@@ -8,7 +8,7 @@ module Balanced
     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')
+        attributes['uri'] = self.class.uri
       end
       super attributes
     end
@@ -19,16 +19,33 @@ module Balanced
     # +domain_name+ property from your Marketplace.
     #
     # @return [Debit]
-    def debit amount=nil, appears_on_statement_as=nil, holds_uri=nil, meta={}, description=nil
+    def debit *args
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      amount = args[0] || options.fetch(:amount) { nil }
+      appears_on_statement_as = args[1] || options.fetch(:appears_on_statement_as) { nil }
+      holds_uri = args[2] || options.fetch(:holds_uri) { nil }
+      meta = args[3] || options.fetch(:meta) { nil }
+      description = args[3] || options.fetch(:description) { nil }
+
       self.account.debit(amount, appears_on_statement_as, holds_uri, meta, description, self.uri)
     end
 
     # Creates a Hold of funds from this Card to your Marketplace.
     #
     # @return [Hold]
-    def hold amount=nil, meta=nil
+    def hold *args
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      amount = args[0] || options.fetch(:amount) { nil }
+      meta = args[3] || options.fetch(:meta) { nil }
+
       self.account.hold(amount, meta, self.uri)
     end
+
+    def invalidate
+      self.is_valid = false
+      save
+    end
+
   end
 
 end

data/lib/balanced/resources/credit.rb

@@ -11,7 +11,7 @@ module Balanced
     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')
+        attributes['uri'] = self.class.uri
       end
       super attributes
     end

data/lib/balanced/resources/debit.rb

@@ -17,7 +17,7 @@ module Balanced
     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')
+        attributes['uri'] = self.class.uri
       end
       super attributes
     end
@@ -27,7 +27,11 @@ module Balanced
     # of the original Debit's amount.
     #
     # @return [Refund]
-    def refund amount=nil, description=nil
+    def refund *args
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      amount = args[0] || options.fetch(:amount) { nil }
+      description = args[1] || options.fetch(:description) { nil }
+
       refund = Refund.new(
           :uri => self.refunds_uri,
           :debit_uri => self.uri,

data/lib/balanced/resources/hold.rb

@@ -16,7 +16,7 @@ module Balanced
     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')
+        attributes['uri'] = self.class.uri
       end
       super attributes
     end
@@ -32,7 +32,13 @@ module Balanced
     # funds from the buyer's Account to your Marketplace.
     #
     # @return [Debit]
-    def capture amount=nil, appears_on_statement_as=nil, meta={}, description=nil
+    def capture *args
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      amount = args[0] || options.fetch(:amount) { nil }
+      appears_on_statement_as = args[1] || options.fetch(:appears_on_statement_as) { nil }
+      meta = args[2] || options.fetch(:meta) { nil }
+      description = args[3] || options.fetch(:description) { nil }
+
       amount ||= self.amount
       self.account.debit(amount, appears_on_statement_as, self.uri, meta, description)
     end

data/lib/balanced/resources/marketplace.rb

@@ -9,11 +9,7 @@ module Balanced
     #
     # @return [Marketplace]
     def self.my_marketplace
-      # TODO: use query
-      response = Balanced.get collection_path
-      return nil if response.body.to_s.length.zero? or response.body['total'] == 0
-      payload = response.body
-      construct_from_response payload['items'][0]
+      Balanced::Merchant.me.marketplace
     end
 
     # Returns an instance representing the marketplace associated with
@@ -27,7 +23,13 @@ module Balanced
     # Create a buyer Account associated with this Marketplace.
     #
     # @return [Account]
-    def create_buyer email_address, card_uri, name=nil, meta={}
+    def create_buyer *args
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      email_address = args[0] || options.fetch(:email_address) { nil }
+      card_uri = args[1] || options.fetch(:card_uri) { nil }
+      name = args[2] || options.fetch(:name) { nil }
+      meta = args[3] || options.fetch(:meta) { nil }
+
       account = Account.new(
         :uri => self.accounts_uri,
         :email_address => email_address,
@@ -51,7 +53,14 @@ module Balanced
     #   Account.create_merchant('bob@example.com', '/v1/TEST-MRxxxx')
     #
     # @return [Account]
-    def create_merchant email_address, merchant, bank_account_uri=nil, name=nil, meta={}
+    def create_merchant *args
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      email_address = args[0] || options.fetch(:email_address) { nil }
+      merchant = args[1] || options.fetch(:merchant) { nil }
+      bank_account_uri = args[2] || options.fetch(:bank_account_uri) { nil }
+      name = args[3] || options.fetch(:name) { nil }
+      meta = args[4] || options.fetch(:meta) { nil }
+
       account_attributes = {
           :uri => self.accounts_uri,
           :email_address => email_address,

data/lib/balanced/resources/merchant.rb

@@ -6,11 +6,7 @@ module Balanced
     #
     # @return [Merchant]
     def self.me
-      # TODO: use query
-      response = Balanced.get collection_path
-      return nil if response.body.to_s.length.zero? or response.body['total'] == 0
-      payload = response.body
-      construct_from_response payload['items'][0]
+      self.all.first
     end
 
     # Returns the Merchant associated with your Marketplace.

data/lib/balanced/resources/refund.rb

@@ -10,7 +10,7 @@ module Balanced
     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')
+        attributes['uri'] = self.class.uri
       end
       super attributes
     end

data/lib/balanced/resources/resource.rb

@@ -1,3 +1,6 @@
+require_relative "../pager"
+
+
 module Balanced
   module Resource
     attr_accessor :attributes
@@ -8,8 +11,8 @@ module Balanced
 
     # delegate the query to the pager module
 
-    def find uri
-      self.class.find uri
+    def find *arguments
+      self.class.find *arguments
     end
 
     def save
@@ -80,6 +83,23 @@ module Balanced
       Utils.underscore resource_name
     end
 
+    def uri
+      # the uri of a particular resource depends if there's a marketplace created or not
+      # if there's a marketplace, then all resources have their own uri from there and the top level ones
+      # if there's not a marketplace
+      #    if there's an api key, then the merchant is available
+      #    if there's no api key, the only resources exposed are purely top level
+      if self == Balanced::Merchant or self == Balanced::Marketplace or self == Balanced::ApiKey
+        collection_path
+      else
+        if Balanced::Marketplace.my_marketplace.nil?
+          raise Balanced::Error, "#{self.name} is nested under a marketplace, which is not created or configured."
+        else
+          Balanced::Marketplace.my_marketplace.send(collection_name + '_uri')
+        end
+      end
+    end
+
     def construct_from_response payload
       payload = Balanced::Utils.hash_with_indifferent_read_access payload
       return payload if payload[:uri].nil?
@@ -102,9 +122,7 @@ module Balanced
                # 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
+                values_class.all
               else
                 values_class.find(value)
               end
@@ -122,14 +140,30 @@ module Balanced
       instance
     end
 
-    def find uri
-      response = Balanced.get uri
-      construct_from_response response.body
+    def find *arguments
+      scope   = arguments.slice!(0)
+      options = arguments.slice!(0) || {}
+      case scope
+        when :all   then all(options)
+        when :first then paginate(options).first
+        else
+          response = Balanced.get scope, options
+          construct_from_response response.body
+      end
     end
 
-  end
+    def paginate options = {}
+      Pager.new uri, options
+    end
+    alias scoped paginate
+    alias where  paginate
 
+    def all options = {}
+      pager = paginate(options)
+      pager.to_a
+    end
 
+  end
 
   end
 end

data/lib/balanced/resources/transaction.rb

@@ -8,7 +8,7 @@ module Balanced
     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')
+        attributes['uri'] = self.class.uri
       end
       super attributes
     end

data/lib/balanced/utils.rb

@@ -37,6 +37,13 @@ module Balanced
       base.each_pair do |key, value|
         if value.is_a? Hash
           value = hash_with_indifferent_read_access value
+        elsif value.respond_to? :each
+          value.map! do |v|
+            if v.is_a? Hash
+               v = hash_with_indifferent_read_access v
+            end
+            v
+          end
         end
         indifferent[key.to_s] = value
       end

data/lib/balanced/version.rb

@@ -1,3 +1,3 @@
 module Balanced
-  VERSION = '0.3.4'
+  VERSION = '0.3.5'
 end

data/spec/balanced/resources/account_spec.rb

@@ -8,6 +8,38 @@ describe Balanced::Account do
     @marketplace = Balanced::Marketplace.new.save
   end
 
+  describe "Account.uri" do
+    use_vcr_cassette
+
+    context "when ApiKey is not configured" do
+      use_vcr_cassette
+      before do
+        Balanced.configure nil
+      end
+
+      it "throw an exception that it can not generate the URI" do
+        expect {
+          Balanced::Account.uri
+        }.to raise_error Balanced::Error
+      end
+    end
+
+    context "when ApiKey is configured" do
+      use_vcr_cassette
+      before do
+        api_key = Balanced::ApiKey.new.save
+        Balanced.configure api_key.secret
+        @marketplace = Balanced::Marketplace.new.save
+      end
+
+      it "it matches the resource's uri structure" do
+        uri = Balanced::Account.uri
+        uri.should_not be_nil
+        uri.should match ACCOUNTS_URI_REGEX
+      end
+    end
+  end
+
   describe "merchant" do
     use_vcr_cassette
 
@@ -207,7 +239,7 @@ describe Balanced::Account do
   describe "buyer" do
     describe "#save" do
       describe "when creating" do
-        use_vcr_cassette
+        use_vcr_cassette :record => :new_episodes
         before do
           card = Balanced::Card.new(
             :card_number => "5105105105105100",
@@ -226,7 +258,7 @@ describe Balanced::Account do
 
       describe "after #save" do
         describe "attributes" do
-          use_vcr_cassette
+          use_vcr_cassette :record => :new_episodes
           before do
             card = Balanced::Card.new(
               :card_number => "4111111111111111",
@@ -296,11 +328,16 @@ describe Balanced::Account do
             subject { @buyer.cards_uri }
             it { should match CARDS_URI_REGEX }
           end
+          describe "#cards" do
+            subject { @buyer.cards }
+            it { should be_instance_of Array }
+            it { should_not be_empty }
+            it { subject.first.should be_instance_of Balanced::Card }
+          end
         end
       end
     end
 
-
     describe "#add_card" do
 
       describe "when executing" do
@@ -418,10 +455,85 @@ describe Balanced::Account do
       end
 
     end
+
+    describe "#debit" do
+      use_vcr_cassette :match_requests_on => [:body], :record => :new_episodes
+      before do
+        card = Balanced::Card.new(
+          :card_number => "4111111111111111",
+          :expiration_month => "12",
+          :expiration_year => "2015",
+        ).save
+        begin
+          @buyer = Balanced::Account.new(
+            :uri => @marketplace.accounts_uri,
+            :email_address => "buyer7@example.org",
+            :card_uri => card.uri,
+            :name => "Jack Q Buyer"
+          ).save
+        rescue Balanced::Conflict => ex
+          @buyer = Balanced::Account.find(ex.extras[:account_uri])
+        end
+      end
+      it "takes optional parameters"  do
+        debit = @buyer.debit(
+          :amount => 500,
+          :appears_on_statement_as => "BOBS BURGERS",
+        )
+        debit.should be_instance_of Balanced::Debit
+        debit.amount.should eql 500
+        debit.appears_on_statement_as.should eql "BOBS BURGERS"
+      end
+      it "takes positional parameters" do
+        debit = @buyer.debit(500, "FOO FIGHTER")
+        debit.should be_instance_of Balanced::Debit
+        debit.amount.should eql 500
+        debit.appears_on_statement_as.should eql "FOO FIGHTER"
+      end
+
+    end
   end
 
-  describe ".find_by_email" do
+  describe ".find" do
     use_vcr_cassette
+
+    before do
+      api_key = Balanced::ApiKey.new.save
+      Balanced.configure api_key.secret
+      @marketplace = Balanced::Marketplace.new.save
+      card = Balanced::Card.new(
+        :card_number => "5105105105105100",
+        :expiration_month => "12",
+        :expiration_year => "2015",
+      ).save
+      Balanced::Marketplace.my_marketplace.create_buyer(
+        "john.doe@example.com",
+        card.uri
+      )
+    end
+
+    context "(:all, :some_field => 'op')" do
+      use_vcr_cassette
+      it "should find the account by returning a page with items of one" do
+        response = Balanced::Account.find(:all, :email_address => "john.doe@example.com")
+        response.should be_instance_of Array
+        response[0].should be_instance_of Balanced::Account
+      end
+    end
+
+    context "(:first, :some_field => 'op')" do
+      use_vcr_cassette
+      it "should find the account by returning the first item" do
+        response = Balanced::Account.find(:first, :email_address => "john.doe@example.com")
+        response.should be_instance_of Balanced::Account
+      end
+    end
+
+
+  end
+
+  describe ".find_by_email" do
+    use_vcr_cassette  :record => :new_episodes
     before do
       api_key = Balanced::ApiKey.new.save
       Balanced.configure api_key.secret
@@ -438,14 +550,14 @@ describe Balanced::Account do
     end
 
     context "email address is in system" do
-      use_vcr_cassette
+      use_vcr_cassette  :record => :new_episodes
       it "should return account object" do
         Balanced::Account.find_by_email("john.doe@example.com").should be_instance_of Balanced::Account
       end
     end
 
     context "email address does not exist" do
-      use_vcr_cassette
+      use_vcr_cassette  :record => :new_episodes
       it "should return nil" do
         Balanced::Account.find_by_email("foo@bar.com").should be_nil
       end

data/spec/spec_helper.rb

@@ -20,6 +20,7 @@ RSpec.configure do |c|
 end
 
 
+ACCOUNTS_URI_REGEX = /\/v1\/marketplaces\/TEST-\w*\/accounts/
 MERCHANT_URI_REGEX = /\/v1\/marketplaces\/TEST-\w*\/accounts\/\w*/
 HOLDS_URI_REGEX = /\/v1\/marketplaces\/TEST-\w*\/accounts\/\w*\/holds/
 BANK_ACCOUNTS_URI_REGEX = /\/v1\/marketplaces\/TEST-\w*\/accounts\/\w*\/bank_accounts/

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: balanced
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.3.5
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-28 00:00:00.000000000 Z
+date: 2012-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -77,6 +77,7 @@ files:
 - lib/balanced.rb
 - lib/balanced/client.rb
 - lib/balanced/error.rb
+- lib/balanced/pager.rb
 - lib/balanced/resources.rb
 - lib/balanced/resources/account.rb
 - lib/balanced/resources/api_key.rb