xero_gateway-float 2.0.15

data/test/integration/get_invoices_test.rb

@@ -0,0 +1,92 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class GetInvoicesTest < Test::Unit::TestCase
+  include TestHelper
+  
+  INVALID_INVOICE_ID = "99999999-9999-9999-9999-999999999999" unless defined?(INVALID_INVOICE_ID)
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(CONSUMER_KEY, CONSUMER_SECRET)
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_get).with {|client, url, params| url =~ /Invoices/ }.returns(get_file_as_string("invoices.xml"))
+      @gateway.stubs(:http_put).with {|client, url, body, params| url =~ /Invoices$/ }.returns(get_file_as_string("create_invoice.xml"))
+
+      # Get an invoice with an invalid ID number.
+      @gateway.stubs(:http_get).with {|client, url, params| url =~ Regexp.new("Invoices/#{INVALID_INVOICE_ID}") }.returns(get_file_as_string("invoice_not_found_error.xml"))
+    end
+  end
+  
+  def test_get_invoices
+    # Make sure there is an invoice in Xero to retrieve
+    invoice = @gateway.create_invoice(dummy_invoice).invoice
+    
+    result = @gateway.get_invoices
+    assert result.success?
+    assert !result.request_params.nil?
+    assert !result.response_xml.nil?  
+    assert result.invoices.collect {|i| i.invoice_number}.include?(invoice.invoice_number)
+    assert result.invoices[0].sent_to_contact == true
+    assert result.invoices[1].sent_to_contact == false
+  end
+  
+  def test_get_invoices_with_modified_since_date
+    # Create a test invoice
+    invoice = dummy_invoice
+    @gateway.create_invoice(invoice)
+    
+    # Check that it is returned
+    result = @gateway.get_invoices(:modified_since => Date.today - 1)
+    assert result.success?
+    assert !result.request_params.nil?
+    assert !result.response_xml.nil?    
+    assert result.request_params.keys.include?(:ModifiedAfter) # make sure the flag was sent
+    assert result.invoices.collect {|response_invoice| response_invoice.invoice_number}.include?(invoice.invoice_number)
+  end
+  
+  def test_line_items_downloaded_set_correctly
+    # No line items.
+    response = @gateway.get_invoices
+    assert_equal(true, response.success?)
+    
+    invoice = response.invoices.first
+    assert_kind_of(XeroGateway::Invoice, invoice)
+    assert_equal(false, invoice.line_items_downloaded?)
+  end
+  
+  # Make sure that a reference to gateway is passed when the get_invoices response is parsed.
+  def test_get_contacts_gateway_reference
+    result = @gateway.get_invoices
+    assert(result.success?)
+    assert_not_equal(0, result.invoices.size)
+    
+    result.invoices.each do | invoice |
+      assert(invoice.gateway === @gateway)
+    end
+  end
+  
+  # Test to make sure that we correctly error when an invoice doesn't have an ID.
+  # This should usually never be ecountered, but might if a draft invoice is deleted from Xero.
+  def test_to_ensure_that_an_invoice_with_invalid_id_errors
+    # Make sure there is an invoice to retrieve, even though we will mangle it later.
+    invoice = @gateway.create_invoice(dummy_invoice).invoice
+    
+    result = @gateway.get_invoices
+    assert_equal(true, result.success?)
+    
+    invoice = result.invoices.first
+    assert_equal(false, invoice.line_items_downloaded?)
+    
+    # Mangle invoice_id to invalid one.
+    invoice.invoice_id = INVALID_INVOICE_ID
+    
+    # Make sure we fail here.
+    line_items = nil
+    assert_raise(XeroGateway::InvoiceNotFoundError) { line_items = invoice.line_items }
+    assert_nil(line_items)
+    
+  end
+  
+end

data/test/integration/get_organisation_test.rb

@@ -0,0 +1,24 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class GetOrganisationTest < Test::Unit::TestCase
+  include TestHelper
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(CONSUMER_KEY, CONSUMER_SECRET)
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_get).with {|client, url, params| url =~ /Organisation$/ }.returns(get_file_as_string("organisation.xml"))          
+    end
+  end
+  
+  def test_get_organisation
+    result = @gateway.get_organisation
+    assert result.success?
+    assert !result.response_xml.nil?
+    
+    assert_equal XeroGateway::Organisation, result.organisation.class
+    assert_equal "Demo Company (NZ)", result.organisation.name
+  end
+end

data/test/integration/get_tax_rates_test.rb

@@ -0,0 +1,25 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class GetTaxRatesTest < Test::Unit::TestCase
+  include TestHelper
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(CONSUMER_KEY, CONSUMER_SECRET)
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_get).with {|client, url, params| url =~ /TaxRates$/ }.returns(get_file_as_string("tax_rates.xml"))          
+    end
+  end
+  
+  def test_get_tax_rates
+    result = @gateway.get_tax_rates
+    assert result.success?
+    assert !result.response_xml.nil?
+    
+    assert result.tax_rates.size > 0
+    assert_equal XeroGateway::TaxRate, result.tax_rates.first.class
+    assert_equal "GST on Expenses", result.tax_rates.first.name
+  end
+end

data/test/integration/get_tracking_categories_test.rb

@@ -0,0 +1,27 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class GetTrackingCategoriesTest < Test::Unit::TestCase
+  include TestHelper
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(CONSUMER_KEY, CONSUMER_SECRET)
+
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_get).with {|client, url, params| url =~ /TrackingCategories$/ }.returns(get_file_as_string("tracking_categories.xml"))          
+    end
+  end
+  
+  def test_get_tracking_categories
+    result = @gateway.get_tracking_categories
+    assert result.success?
+    assert !result.response_xml.nil?
+    if STUB_XERO_CALLS
+      # When operating against the Xero test environment, there may not be any tracking categories present,
+      # so this assertion can only be done when operating against stub responses
+      assert_equal 1, result.tracking_categories.size
+      assert_equal 4, result.tracking_categories.first.options.size
+    end
+  end
+end

data/test/integration/update_bank_transaction_test.rb

@@ -0,0 +1,31 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class UpdateBankTransactionTest < Test::Unit::TestCase
+  include TestHelper
+
+  def setup
+    @gateway = XeroGateway::Gateway.new(CONSUMER_KEY, CONSUMER_SECRET)
+
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+
+      @gateway.stubs(:http_put).with {|client, url, body, params| url =~ /BankTransactions$/ }.returns(get_file_as_string("create_bank_transaction.xml"))
+      @gateway.stubs(:http_post).with {|client, url, body, params| url =~ /BankTransactions$/ }.returns(get_file_as_string("bank_transaction.xml"))
+    end
+  end
+
+  def test_update_bank_transaction
+    bank_transaction = @gateway.create_bank_transaction(create_test_bank_transaction).bank_transaction
+
+    today = Date.today
+    bank_transaction.date = today
+
+    result = @gateway.update_bank_transaction(bank_transaction)
+
+    assert result.success?
+    assert !result.request_xml.nil?
+    assert !result.response_xml.nil?
+    assert_equal bank_transaction.bank_transaction_id, result.bank_transaction.bank_transaction_id
+    assert_equal today, result.bank_transaction.date if !STUB_XERO_CALLS
+  end
+end

data/test/integration/update_contact_test.rb

@@ -0,0 +1,31 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class UpdateContactTest < Test::Unit::TestCase
+  include TestHelper
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(CONSUMER_KEY, CONSUMER_SECRET)
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_put).with {|client, url, body, params| url =~ /Contacts$/ }.returns(get_file_as_string("contact.xml"))          
+      @gateway.stubs(:http_post).with {|client, url, body, params| url =~ /Contacts$/ }.returns(get_file_as_string("contact.xml"))          
+    end
+  end
+  
+  def test_update_contact
+    # Make sure there is a contact in Xero to retrieve
+    contact = @gateway.create_contact(dummy_contact).contact
+
+    contact.phone.number = "123 4567"
+    
+    result = @gateway.update_contact(contact)
+
+    assert result.success?
+    assert !result.request_xml.nil?
+    assert !result.response_xml.nil?    
+    assert_equal contact.contact_id, result.contact.contact_id
+    assert_equal "123 4567", result.contact.phone.number if !STUB_XERO_CALLS
+  end
+end

data/test/integration/update_invoice_test.rb

@@ -0,0 +1,31 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class UpdateInvoiceTest < Test::Unit::TestCase
+  include TestHelper
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(CONSUMER_KEY, CONSUMER_SECRET)
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_put).with {|client, url, body, params| url =~ /Invoices$/ }.returns(get_file_as_string("create_invoice.xml"))          
+      @gateway.stubs(:http_post).with {|client, url, body, params| url =~ /Invoices$/ }.returns(get_file_as_string("invoice.xml"))          
+    end
+  end
+  
+  def test_update_invoice
+    invoice = @gateway.create_invoice(dummy_invoice).invoice
+    
+    today = Date.today
+    invoice.due_date = today
+    
+    result = @gateway.update_invoice(invoice)
+    
+    assert result.success?
+    assert !result.request_xml.nil?
+    assert !result.response_xml.nil?    
+    assert_equal invoice.invoice_id, result.invoice.invoice_id
+    assert_equal today, result.invoice.due_date if !STUB_XERO_CALLS
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,179 @@
+require "rubygems"
+
+require 'test/unit'
+require 'mocha'
+require 'shoulda'
+
+require 'libxml'
+
+require File.dirname(__FILE__) + '/../lib/xero_gateway.rb'
+
+module TestHelper
+  # The integration tests can be run against the Xero test environment.  You mush have a company set up in the test
+  # environment, and you must have set up a customer key for that account.
+  #
+  # You can then run the tests against the test environment using the commands (linux or mac):
+  # export STUB_XERO_CALLS=false  
+  # rake test
+  # (this probably won't work under OAuth?)
+  #
+  
+  STUB_XERO_CALLS = ENV["STUB_XERO_CALLS"].nil? ? true : (ENV["STUB_XERO_CALLS"] == "true") unless defined? STUB_XERO_CALLS
+  
+  CONSUMER_KEY    = ENV["CONSUMER_KEY"]    || "fake_key"    unless defined?(CONSUMER_KEY)
+  CONSUMER_SECRET = ENV["CONSUMER_SECRET"] || "fake_secret" unless defined?(CONSUMER_SECRET)
+  
+  # Helper constant for checking regex
+  GUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/ unless defined?(GUID_REGEX)
+
+  
+  def dummy_invoice(with_line_items = true)
+     invoice = XeroGateway::Invoice.new({
+       :invoice_type => "ACCREC",
+       :date => Time.now,
+       :due_date => Date.today + 20,
+       :invoice_number => STUB_XERO_CALLS ? "INV-0001" : "#{Time.now.to_f}",
+       :reference => "YOUR REFERENCE (NOT NECESSARILY UNIQUE!)",
+       :line_items_downloaded => with_line_items
+     })
+     invoice.contact = dummy_contact
+     if with_line_items
+       invoice.line_items << XeroGateway::LineItem.new(
+         :description => "THE DESCRIPTION OF THE LINE ITEM",
+         :unit_amount => 1000,
+         :tax_amount => 125,
+         :tracking => [
+            XeroGateway::TrackingCategory.new(:name => "THE FIRST  TRACKING CATEGORY FOR THE LINE ITEM", :options => ["a", "b"]),
+            XeroGateway::TrackingCategory.new(:name => "THE SECOND TRACKING CATEGORY FOR THE LINE ITEM", :options => "c")
+         ]
+       )
+     end
+     invoice
+  end
+      
+  def dummy_credit_note(with_line_items = true)
+     credit_note = XeroGateway::CreditNote.new({
+       :type => "ACCRECCREDIT",
+       :date => Time.now,
+       :credit_note_number => STUB_XERO_CALLS ? "CN-0153" : "#{Time.now.to_f}",
+       :reference => "YOUR REFERENCE (NOT NECESSARILY UNIQUE!)",
+       :line_items_downloaded => with_line_items
+     })
+     credit_note.contact = dummy_contact
+     if with_line_items
+       credit_note.line_items << XeroGateway::LineItem.new(
+         :description => "THE DESCRIPTION OF THE LINE ITEM",
+         :unit_amount => 1000,
+         :tax_amount => 125,
+         :tracking => [
+            XeroGateway::TrackingCategory.new(:name => "THE FIRST  TRACKING CATEGORY FOR THE LINE ITEM", :options => ["a", "b"]),
+            XeroGateway::TrackingCategory.new(:name => "THE SECOND TRACKING CATEGORY FOR THE LINE ITEM", :options => "c")
+         ]
+       )
+     end
+     credit_note
+  end
+      
+  def dummy_contact
+    unique_id = Time.now.to_f
+    contact = XeroGateway::Contact.new(:name => STUB_XERO_CALLS ? "CONTACT NAME" : "THE NAME OF THE CONTACT #{unique_id}")
+    contact.email = "bob#{unique_id}@example.com"
+    contact.phone.number = "12345"
+    contact.address.line_1 = "LINE 1 OF THE ADDRESS"
+    contact.address.line_2 = "LINE 2 OF THE ADDRESS"
+    contact.address.line_3 = "LINE 3 OF THE ADDRESS"
+    contact.address.line_4 = "LINE 4 OF THE ADDRESS"
+    contact.address.city = "WELLINGTON"
+    contact.address.region = "WELLINGTON"
+    contact.address.country = "NEW ZEALAND"
+    contact.address.post_code = "6021"
+
+    contact
+  end
+  
+  def get_file_as_string(filename)
+    data = ''
+    f = File.open(File.dirname(__FILE__) + "/stub_responses/" + filename, "r") 
+    f.each_line do |line|
+      data += line
+    end
+    f.close
+    return data
+  end
+
+  def create_test_bank_transaction(params={}, contact_params={}, line_item_params={})
+    params = {
+      :type       => 'RECEIVE',
+      :date       => Date.today,
+      :reference  => '12345',
+      :status     => 'ACTIVE',
+    }.merge(params)
+    bank_transaction = XeroGateway::BankTransaction.new(params)
+
+    bank_transaction.contact = create_test_contact(contact_params)
+    add_test_line_items(bank_transaction, line_item_params)
+    bank_transaction.bank_account = create_test_account
+
+    bank_transaction
+  end
+
+  def add_test_line_items(bank_transaction, line_item_params={})
+    if line_item_params
+      line_item_params = [line_item_params].flatten # always use an array, even if only a single hash passed in
+
+      # At least one line item, make first have some defaults.
+      line_item_params << {} if line_item_params.size == 0
+      line_item_params[0] = {
+        :description  => "A LINE ITEM",
+        :account_code => "200",
+        :unit_amount  => BigDecimal.new("100"),
+        :tax_amount   => BigDecimal.new("12.5"),
+        :tracking     => XeroGateway::TrackingCategory.new(:name => "blah", :options => "hello")
+      }.merge(line_item_params[0])
+
+      # Create line_items from line_item_params
+      line_item_params.each do |line_item|
+        bank_transaction.add_line_item(line_item)
+      end
+    end
+    bank_transaction
+  end
+
+  def create_test_account
+    account = XeroGateway::Account.new(:account_id => "57cedda9")
+    account.code = "200"
+    account.name = "Sales"
+    account.type = "REVENUE"
+    account.tax_type = "OUTPUT"
+    account.description = "Income from any normal business activity"
+    account.enable_payments_to_account = false
+    account
+  end
+
+  def create_test_contact(contact_params={})
+    # Strip out :address key from contact_params to use as the default address.
+    stripped_address = {
+      :address_type => 'STREET',
+      :line_1       => 'LINE 1 OF THE ADDRESS'
+    }.merge(contact_params.delete(:address) || {})
+
+    # Strip out :phone key from contact_params to use at the default phone.
+    stripped_phone = {
+      :phone_type => 'DEFAULT',
+      :number     => '12345678'
+    }.merge(contact_params.delete(:phone) || {})
+
+    contact_params = {
+      :contact_id => '00000000-0000-0000-0000-000000000000', # Just any valid GUID
+      :name       => "CONTACT NAME",
+      :first_name => "Bob",
+      :last_name  => "Builder"
+    }.merge(contact_params)
+
+    contact = XeroGateway::Contact.new(contact_params)
+    contact.address = XeroGateway::Address.new(stripped_address)
+    contact.phone = XeroGateway::Phone.new(stripped_phone)
+    contact
+  end
+
+end