fat_zebra 0.0.1 → 0.0.3

data/lib/fat_zebra/gateway.rb

@@ -23,6 +23,7 @@ module FatZebra
 		# Public: Performs a purchase transaction against the gateway
 		#
 		# amount - the amount as an integer e.g. (1.00 * 100).to_i
+		# card_data - a hash of the card data (example: {:card_holder => "John Smith", :number => "...", :expiry => "...", :cvv => "123"} or {:token => "abcdefg1"})
 		# card_holder - the card holders name
 		# card_number - the customers credit card number
 		# card_expiry - the customers card expiry date (as Date or string [mm/yyyy])
@@ -30,29 +31,58 @@ module FatZebra
 		# reference - a reference for the purchase
 		# customer_ip - the customers IP address (for fraud prevention)
 		#
-		# Returns a new FatZebra::Models::Purchase object
-		def purchase(amount, card_holder, card_number, card_expiry, cvv, reference, customer_ip)
+		# Returns a new FatZebra::Models::Response (purchase) object
+		def purchase(amount, card_data, reference, customer_ip)
 			params = {
 				:amount => amount,
-				:card_holder => card_holder,
-				:card_number => card_number,
-				:card_expiry => extract_date(card_expiry),
-				:cvv => cvv,
+				:card_holder => card_data.delete(:card_holder),
+				:card_number => card_data.delete(:number),
+				:card_expiry => extract_date(card_data.delete(:expiry)),
+				:cvv => card_data.delete(:cvv),
+				:card_token => card_data.delete(:token),
 				:reference => reference,
 				:customer_ip => customer_ip
 			}
 
+			params.delete_if {|key, value| value.nil? } # If token is nil, remove, otherwise, remove card values
+
 			response = make_request(:post, "purchases", params)
 			FatZebra::Models::Response.new(response)
 		end
 
-		def purchases(id = nil)
+		# Retrieves purchases specified by the options hash
+		#
+		# @param [Hash] options for lookup
+		#               includes: 
+		#                 - id (unique purchase ID)
+		#                 - reference (merchant reference)
+		#                 - offset (defaults to 0) - for pagination
+		#                 - limit (defaults to 10) for pagination
+		# @return [Array<Purchase>] array of purchases
+		def purchases(options = {})
+			id = options.delete(:id)
+			options.merge!({offets: 0, limit: 10})
+
 			if id.nil?
-				response = make_request(:get, "purchases")
-				# handle list response
+				response = make_request(:get, "purchases", options)
+				if response["successful"]
+					purchases = []
+					response["response"].each do |purchase|
+						purchases << FatZebra::Models::Purchase.new(purchase)
+					end
+
+					purchases.size == 1 ? purchases.first : purchases
+				else
+					# TODO: This should raise a defined exception
+					raise StandardError, "Unable to query purchases, #{response["errors"].inspect}"
+				end
 			else
 				response = make_request(:get, "purchases/#{id}.json")
-				puts response.inspect
+				if response["successful"]
+					FatZebra::Models::Purchase.new(response["response"])
+				else
+					raise StandardError, "Unable to query purchases, #{response["errors"].inspect}"
+				end
 			end
 		end
 
@@ -116,6 +146,8 @@ module FatZebra
 		#
 		# Returns date string as MM/YYYY
 		def extract_date(value)
+			return nil if value.nil?
+
 			if value.is_a?(String)
 				return value
 			elsif value.respond_to?(:strftime)

data/lib/fat_zebra/models/base.rb

@@ -1,11 +1,31 @@
 module FatZebra
-	module Models
-		class Base
-			def initialize(attrs = {})
-				attrs.each do |key, val|
-					self.send("#{key}=", val) if self.respond_to?("#{key}=")
-				end
-			end
-		end
-	end
+  module Models
+    class Base
+      @@attributes = []
+      def self.attribute(*values)
+        @@attributes ||= []
+        values.each do |val|
+          @@attributes << val
+        end
+        attr_accessor *values
+      end
+
+      def initialize(attrs = {})
+        attrs.each do |key, val|
+          self.send("#{key}=", val) if self.respond_to?("#{key}=")
+        end
+      end
+
+      def inspect
+        inspection = @@attributes.collect { |name|
+                        "#{name}: #{instance_variable_get("@#{name}")}"
+                      }.compact.join(", ")
+        "#<#{self.class} #{inspection}>"
+      end
+
+      def to_s
+        inspect
+      end
+    end
+  end
 end

data/lib/fat_zebra/models/purchase.rb

@@ -1,7 +1,7 @@
 module FatZebra
 	module Models
 		class Purchase < Base
-			attr_accessor :id, :amount, :reference
+			attribute :id, :amount, :reference
 		end
 	end
 end

data/lib/fat_zebra/models/refund.rb

@@ -1,7 +1,7 @@
 module FatZebra
 	module Models
 		class Refund < Base
-			attr_accessor :amonut, :reference, :transaction_id, :original_transaction_id
+			attribute :amount, :reference, :transaction_id, :original_transaction_id
 
 			def original_transaction
 				@original_transaction ||= Purchase.find(self.original_transaction_id)

data/lib/fat_zebra/version.rb

@@ -1,3 +1,3 @@
 module FatZebra
-  VERSION = "0.0.1"
+  VERSION = "0.0.3"
 end

data/spec/gateway_spec.rb

@@ -24,13 +24,18 @@ describe FatZebra::Gateway do
 	end
 
 	it "should perform a purchase" do
-		result = @gw.purchase(10000, "Matthew Savage", "5123456789012346", "05/2013", 123, "TEST#{rand}", "1.2.3.4")
+		result = @gw.purchase(10000, {:card_holder => "Matthew Savage", :number => "5555555555554444", :expiry => "05/2013", :cvv => 123}, "TEST#{rand}", "1.2.3.4")
 		result.should be_successful
 		result.errors.should be_empty
 	end
 
 	it "should fetch a purchase" do
-		result = @gw.purchase(10000, "Matthew Savage", "5123456789012346", "05/2013", 123, "TES#{rand}T", "1.2.3.4")
-		@gw.purchases(result.purchase.id)
+		result = @gw.purchase(10000, {:card_holder => "Matthew Savage", :number => "5555555555554444", :expiry => "05/2013", :cvv => 123}, "TES#{rand}T", "1.2.3.4")
+		purchase = @gw.purchases(:id => result.purchase.id)
+		purchase.id.should == result.purchase.id
+	end
+
+	it "should fetch a purchase within a date range" do
+		
 	end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fat_zebra
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-02 00:00:00.000000000 Z
+date: 2012-03-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70188364935140 !ruby/object:Gem::Requirement
+  requirement: &70267486703020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70188364935140
+  version_requirements: *70267486703020
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70188364933140 !ruby/object:Gem::Requirement
+  requirement: &70267486701460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70188364933140
+  version_requirements: *70267486701460
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &70188364931500 !ruby/object:Gem::Requirement
+  requirement: &70267486717220 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70188364931500
+  version_requirements: *70267486717220
 - !ruby/object:Gem::Dependency
   name: yard-tomdoc
-  requirement: &70188364947340 !ruby/object:Gem::Requirement
+  requirement: &70267486716700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70188364947340
+  version_requirements: *70267486716700
 - !ruby/object:Gem::Dependency
   name: rest-client
-  requirement: &70188364946820 !ruby/object:Gem::Requirement
+  requirement: &70267486716240 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70188364946820
+  version_requirements: *70267486716240
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: &70188364946360 !ruby/object:Gem::Requirement
+  requirement: &70267486715800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,7 +76,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70188364946360
+  version_requirements: *70267486715800
 description: Provides integration with the Fat Zebra internet payment gateway (www.fatzebra.com.au),
   including purchase, refund, auth, capture and recurring billing functionality.
 email:
@@ -119,7 +119,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2788965499772095038
+      hash: -822384591373257105
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -128,7 +128,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2788965499772095038
+      hash: -822384591373257105
 requirements: []
 rubyforge_project: fat_zebra
 rubygems_version: 1.8.10