tlconnor-xero_gateway 1.0.1 → 1.0.2

data/CHANGELOG.textile

@@ -1,3 +1,8 @@
+h2. 1.0.2, releases 04/12/2008
+
+* Added implementation of GET /api.xro/1.0/tracking
+
+
 h2. 1.0.1, releases 02/12/2008
 
 * Added implementation of GET /api.xro/1.0/accounts

data/README.textile

@@ -52,7 +52,7 @@ Gets all contact records for a particular Xero customer.
 
 h3. PUT /api.xro/1.0/contact
 
-Saves a contact record for a particular Xero customer. If the contact record does not exist (based on either ContactID or ContactNumber) then it’s created, otherwise it’s updated.
+Saves a contact record for a particular Xero customer.
 <pre><code>
     contact = XeroGateway::Contact.new
 	contact.name = "The contacts name"
@@ -69,6 +69,16 @@ Saves a contact record for a particular Xero customer. If the contact record doe
 </code></pre>
 
 
+h3. POST /api.xro/1.0/contact
+
+Updates an existing contact record.
+<pre><code>
+    contact_retrieved_from_xero.email = "something_new@something.com"
+	
+	gateway.update_contact(contact)
+</code></pre>
+
+
 
 h3. GET /api.xro/1.0/invoice (get_invoice_by_id)
 
@@ -92,7 +102,8 @@ h3. GET /api.xro/1.0/invoices (get_invoices)
 
 Gets all invoice records for a particular Xero customer.
 <pre><code>
-	gateway.get_invoices(modified_since = nil)
+	gateway.get_invoices
+	gateway.get_invoices(1.month.ago) # modified since 1 month ago
 </code></pre>
 
 
@@ -128,10 +139,17 @@ Inserts an invoice for a specific organization in Xero. (Currently only adding n
 </code></pre>
 
 
-
 h3. GET /api.xro/1.0/accounts
 
 Gets all accounts for a specific organization in Xero.
 <pre><code>
 	gateway.get_accounts
+</code></pre>
+
+
+h3. GET /api.xro/1.0/tracking
+
+Gets all tracking categories and their options for a specific organization in Xero.
+<pre><code>
+	gateway.get_tracking_categories
 </code></pre>

data/init.rb

@@ -0,0 +1 @@
+require 'xero_gateway'

data/lib/xero_gateway/contact.rb

@@ -26,7 +26,11 @@ module XeroGateway
     end
     
     def phone
-      self.phones[0] ||= Phone.new
+      if @phones.size > 1
+        @phones.detect {|p| p.phone_type == 'DEFAULT'} || phones[0]
+      else
+        @phones[0] ||= Phone.new
+      end
     end
     
     def ==(other)

data/lib/xero_gateway/gateway.rb

@@ -51,7 +51,7 @@ module XeroGateway
       get_contact(nil, contact_number)
     end
     
-    
+    #
     # Creates a contact in Xero
     #
     # Usage : 
@@ -68,7 +68,7 @@ module XeroGateway
     # contact.address.country = "NEW ZEALAND"
     # contact.address.post_code = "6021"
     #
-    #    create_contact(contact)
+    # create_contact(contact)
     def create_contact(contact)
       request_xml = XeroGateway::Messages::ContactMessage.build_xml(contact)      
       response_xml = http_put("#{@xero_url}/contact", request_xml, {})
@@ -86,9 +86,40 @@ module XeroGateway
       # Add the request and response XML to the response object
       response.request_xml = request_xml
       response.response_xml = response_xml
-    
       response      
     end
+    
+    #
+    # Updates an existing Xero contact
+    #
+    # Usage : 
+    #
+    # contact = xero_gateway.get_contact(some_contact_id)
+    # contact.email = "a_new_email_ddress"
+    #
+    # xero_gateway.update_contact(contact)  
+    def update_contact(contact)
+      raise "contact_id or contact_number is required for updating contacts" if contact.contact_id.nil? and contact.contact_number.nil?
+      
+      request_xml = XeroGateway::Messages::ContactMessage.build_xml(contact)      
+      response_xml = http_post("#{@xero_url}/contact", request_xml, {})
+
+      doc = REXML::Document.new(response_xml)
+    
+      # Create the response object
+      response = build_response(doc)
+
+      # Add the invoice to the response
+      if response.success?
+        response.response_item = XeroGateway::Messages::ContactMessage.from_xml(REXML::XPath.first(doc, "/Response/Contact"))
+      end
+    
+      # Add the request and response XML to the response object
+      response.request_xml = request_xml
+      response.response_xml = response_xml
+    
+      response
+    end
 
     # Retrieves an invoice from Xero based on its GUID
     #
@@ -202,6 +233,27 @@ module XeroGateway
       response
     end
 
+    #
+    # Gets all tracking categories for a specific organization in Xero.
+    #
+    def get_tracking_categories
+      response_xml = http_get("#{xero_url}/tracking")
+      
+      doc = REXML::Document.new(response_xml)
+    
+      # Create the response object
+      response = build_response(doc)
+
+      # Add the accounts to the response
+      response.response_item = []
+      REXML::XPath.first(doc, "/Response/Tracking").children.each do |tracking_category_element|
+        response.response_item << XeroGateway::Messages::TrackingCategoryMessage.from_xml(tracking_category_element)
+      end
+      
+      # Add the request and response XML to the response object
+      response.response_xml = response_xml
+      response
+    end
 
 
     private

data/lib/xero_gateway/messages/account_message.rb

@@ -2,6 +2,18 @@ module XeroGateway
   module Messages
     class AccountMessage      
       
+      def self.build_xml(account)
+        b = Builder::XmlMarkup.new
+        
+        b.Account {
+          b.Code account.code
+          b.Name account.name
+          b.Type account.type
+          b.TaxType account.tax_type
+          b.Description account.description
+        }
+      end
+      
       # Take an Account element and convert it into an Account object
       def self.from_xml(account_element)        
         account = Account.new
@@ -16,30 +28,6 @@ module XeroGateway
         end      
         account
       end
-      
-      private
-      
-      def self.parse_line_item(line_item_element)
-        line_item = LineItem.new
-        line_item_element.children.each do |element|
-          case(element.name)
-            when "LineItemID" then line_item.line_item_id = element.text
-            when "Description" then line_item.description = element.text
-            when "Quantity" then line_item.quantity = element.text.to_i
-            when "UnitAmount" then line_item.unit_amount = BigDecimal.new(element.text)
-            when "TaxType" then line_item.tax_type = element.text
-            when "TaxAmount" then line_item.tax_amount = BigDecimal.new(element.text)
-            when "LineAmount" then line_item.line_amount = BigDecimal.new(element.text)
-            when "AccountCode" then line_item.account_code = element.text
-            when "Tracking" then
-            if element.elements['TrackingCategory']
-              line_item.tracking_category = element.elements['TrackingCategory/Name'].text
-              line_item.tracking_option = element.elements['TrackingCategory/Option'].text
-            end
-          end
-        end
-        line_item
-      end
     end
   end
 end

data/lib/xero_gateway/messages/tracking_category_message.rb

@@ -0,0 +1,32 @@
+module XeroGateway
+  module Messages
+    class TrackingCategoryMessage      
+      
+      def self.build_xml(tracking_category)
+        b = Builder::XmlMarkup.new
+        
+        b.TrackingCategory {
+          b.Name tracking_category.name
+          b.Options {
+            tracking_category.options.each do |option|
+              b.Option {
+                b.Name option
+              }
+            end
+          }
+        }
+      end
+      
+      def self.from_xml(tracking_category_element)
+        tracking_category = TrackingCategory.new
+        tracking_category_element.children.each do |element|
+          case(element.name)
+            when "Name" then tracking_category.name = element.text
+            when "Options" then element.children.each {|option| tracking_category.options << option.children.first.text}
+          end
+        end
+        tracking_category              
+      end
+    end
+  end
+end

data/lib/xero_gateway/response.rb

@@ -7,6 +7,7 @@ module XeroGateway
     alias_method :contact, :response_item
     alias_method :contacts, :response_item
     alias_method :accounts, :response_item
+    alias_method :tracking_categories, :response_item
 
 
     

data/lib/xero_gateway/tracking_category.rb

@@ -0,0 +1,20 @@
+module XeroGateway
+  class TrackingCategory
+    attr_accessor :name, :options
+    
+    def initialize(params = {})
+      @options = []
+      params.each do |k,v|
+        self.instance_variable_set("@#{k}", v)  ## create and initialize an instance variable for this key/value pair
+        self.send("#{k}=", v)
+      end
+    end
+    
+    def ==(other)
+      [:name, :options].each do |field|
+        return false if send(field) != other.send(field)
+      end
+      return true
+    end
+  end
+end

data/lib/xero_gateway.rb

@@ -15,7 +15,9 @@ require File.dirname(__FILE__) + "/xero_gateway/contact"
 require File.dirname(__FILE__) + "/xero_gateway/address"
 require File.dirname(__FILE__) + "/xero_gateway/phone"
 require File.dirname(__FILE__) + "/xero_gateway/account"
+require File.dirname(__FILE__) + "/xero_gateway/tracking_category"
 require File.dirname(__FILE__) + "/xero_gateway/messages/contact_message"
 require File.dirname(__FILE__) + "/xero_gateway/messages/invoice_message"
 require File.dirname(__FILE__) + "/xero_gateway/messages/account_message"
+require File.dirname(__FILE__) + "/xero_gateway/messages/tracking_category_message"
 require File.dirname(__FILE__) + "/xero_gateway/gateway"

data/test/integration/create_contact_test.rb

@@ -0,0 +1,27 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class CreateContactTest < Test::Unit::TestCase
+  include IntegrationTestMethods
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(
+      :customer_key => CUSTOMER_KEY,
+      :api_key => API_KEY    
+    )
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_put).with {|url, body, params| url =~ /contact$/ }.returns(get_file_as_string("contact.xml"))          
+    end
+  end
+  
+  def test_create_contact
+    example_contact = dummy_contact
+    
+    result = @gateway.create_contact(example_contact)
+    assert result.success?
+    assert !result.contact.contact_id.nil?
+    assert_equal result.contact.name, example_contact.name
+  end
+end

data/test/integration/create_invoice_test.rb

@@ -0,0 +1,27 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class CreateInvoiceTest < Test::Unit::TestCase
+  include IntegrationTestMethods
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(
+      :customer_key => CUSTOMER_KEY,
+      :api_key => API_KEY    
+    )
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_put).with {|url, body, params| url =~ /invoice$/ }.returns(get_file_as_string("invoice.xml"))          
+    end
+  end
+  
+  def test_create_invoice
+    example_invoice = dummy_invoice
+    
+    result = @gateway.create_invoice(example_invoice)
+    assert result.success?
+    assert !result.invoice.invoice_id.nil?
+    assert result.invoice.invoice_number == example_invoice.invoice_number
+  end
+end

data/test/integration/get_accounts_test.rb

@@ -0,0 +1,25 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class GetAccountsTest < Test::Unit::TestCase
+  include IntegrationTestMethods
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(
+      :customer_key => CUSTOMER_KEY,
+      :api_key => API_KEY    
+    )
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_get).with {|url, params| url =~ /accounts$/ }.returns(get_file_as_string("accounts.xml"))          
+    end
+  end
+  
+  def test_get_accounts
+    result = @gateway.get_accounts
+    assert result.success?
+    assert result.accounts.size > 0
+    assert_equal XeroGateway::Account, result.accounts.first.class
+  end
+end

data/test/integration/get_contact_test.rb

@@ -0,0 +1,29 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class GetContactTest < Test::Unit::TestCase
+  include IntegrationTestMethods
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(
+      :customer_key => CUSTOMER_KEY,
+      :api_key => API_KEY    
+    )
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_get).with {|url, params| url =~ /contact$/ }.returns(get_file_as_string("contact.xml"))          
+      @gateway.stubs(:http_put).with {|url, body, params| url =~ /contact$/ }.returns(get_file_as_string("contact.xml"))          
+    end
+  end
+  
+  def test_get_contact
+    # Make sure there is an contact in Xero to retrieve
+    contact = @gateway.create_contact(dummy_contact).contact
+    flunk "get_contact could not be tested because create_contact failed" if contact.nil?
+
+    result = @gateway.get_contact_by_id(contact.contact_id)
+    assert result.success?
+    assert_equal result.contact.name, contact.name
+  end
+end

data/test/integration/get_contacts_test.rb

@@ -0,0 +1,29 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class GetContactsTest < Test::Unit::TestCase
+  include IntegrationTestMethods
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(
+      :customer_key => CUSTOMER_KEY,
+      :api_key => API_KEY    
+    )
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_get).with {|url, params| url =~ /contacts$/ }.returns(get_file_as_string("contacts.xml"))          
+      @gateway.stubs(:http_put).with {|url, body, params| url =~ /contact$/ }.returns(get_file_as_string("contact.xml"))          
+    end
+  end
+  
+  def test_get_contacts
+    # Make sure there is an contact in Xero to retrieve
+    contact = @gateway.create_contact(dummy_contact).contact
+    flunk "get_contacts could not be tested because create_contact failed" if contact.nil?
+
+    result = @gateway.get_contacts
+    assert result.success?
+    assert result.contacts.collect {|c| c.contact_id}.include?(contact.contact_id)
+  end  
+end

data/test/integration/get_invoice_test.rb

@@ -0,0 +1,32 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class GetInvoiceTest < Test::Unit::TestCase
+  include IntegrationTestMethods
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(
+      :customer_key => CUSTOMER_KEY,
+      :api_key => API_KEY    
+    )
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_get).with {|url, params| url =~ /invoice$/ }.returns(get_file_as_string("invoice.xml"))          
+      @gateway.stubs(:http_put).with {|url, body, params| url =~ /invoice$/ }.returns(get_file_as_string("invoice.xml"))          
+    end
+  end
+  
+  def test_get_invoice
+    # Make sure there is an invoice in Xero to retrieve
+    invoice = @gateway.create_invoice(dummy_invoice).invoice
+
+    result = @gateway.get_invoice_by_id(invoice.invoice_id)
+    assert result.success?
+    assert_equal result.invoice.invoice_number, invoice.invoice_number
+
+    result = @gateway.get_invoice_by_number(invoice.invoice_number)
+    assert result.success?
+    assert_equal result.invoice.invoice_id, invoice.invoice_id
+  end
+end

data/test/integration/get_invoices_test.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class GetInvoicesTest < Test::Unit::TestCase
+  include IntegrationTestMethods
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(
+      :customer_key => CUSTOMER_KEY,
+      :api_key => API_KEY    
+    )
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_get).with {|url, params| url =~ /invoices$/ }.returns(get_file_as_string("invoices.xml"))          
+      @gateway.stubs(:http_put).with {|url, body, params| url =~ /invoice$/ }.returns(get_file_as_string("invoice.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.invoices.collect {|i| i.invoice_number}.include?(invoice.invoice_number)
+  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(Date.today - 1)
+    assert result.success?
+    assert result.request_params.keys.include?(:modifiedSince) # make sure the flag was sent
+    assert result.invoices.collect {|response_invoice| response_invoice.invoice_number}.include?(invoice.invoice_number)
+  end  
+end

data/test/integration/get_tracking_categories_test.rb

@@ -0,0 +1,23 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class GetTrackingCategoriesTest < Test::Unit::TestCase
+  include IntegrationTestMethods
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(:customer_key => CUSTOMER_KEY, :api_key => API_KEY)
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_get).with {|url, params| url =~ /tracking$/ }.returns(get_file_as_string("tracking_categories.xml"))          
+    end
+  end
+  
+  def test_get_tracking_categories
+    result = @gateway.get_tracking_categories
+    assert result.success?
+    if STUB_XERO_CALLS
+      assert result.tracking_categories.size == 2
+    end
+  end
+end

data/test/integration/integration_test_methods.rb

@@ -0,0 +1,64 @@
+module IntegrationTestMethods
+  # 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
+  # export API_KEY=[your_api_key]
+  # export CUSTOMER_KEY=[your_customer_key]
+  # rake test
+  STUB_XERO_CALLS = ENV["STUB_XERO_CALLS"].nil? ? true : (ENV["STUB_XERO_CALLS"] == "true") unless defined? STUB_XERO_CALLS
+  
+  API_KEY = ENV["API_KEY"] unless defined? API_KEY
+  CUSTOMER_KEY = ENV["CUSTOMER_KEY"] unless defined? CUSTOMER_KEY
+
+  
+  def dummy_invoice
+     invoice = XeroGateway::Invoice.new({
+       :invoice_type => "ACCREC",
+       :due_date => Date.today + 20,
+       :invoice_number => STUB_XERO_CALLS ? "INV-0001" : "#{Time.now.to_f}",
+       :reference => "YOUR REFERENCE (NOT NECESSARILY UNIQUE!)",
+       :sub_total => 1000,
+       :total_tax => 125,
+       :total => 1125
+     })
+     invoice.contact = dummy_contact
+     invoice.line_items << XeroGateway::LineItem.new(
+       :description => "THE DESCRIPTION OF THE LINE ITEM",
+       :unit_amount => 1000,
+       :tax_amount => 125,
+       :line_amount => 1000,
+       :tracking_category => "THE TRACKING CATEGORY FOR THE LINE ITEM",
+       :tracking_option => "THE TRACKING OPTION FOR THE LINE ITEM"
+     )
+     invoice
+  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
+end

data/test/integration/stub_responses/tracking_categories.xml

@@ -0,0 +1 @@
+<?xml version="1.0"?><Response><ID>89a1d50c-f528-470c-b924-c10281ff67d6</ID><Status>OK</Status><ProviderName>XeroTest</ProviderName><DateTimeUTC>2008-04-20T20:16:51.7072529Z</DateTimeUTC><Tracking><TrackingCategory><Name>Activity/Workstream</Name><Options><Option><Name>Documentation</Name></Option><Option><Name>Onsite consultancy</Name></Option><Option><Name>Publications</Name></Option><Option><Name>Support</Name></Option><Option><Name>Training</Name></Option><Option><Name>Website management</Name></Option></Options></TrackingCategory><TrackingCategory><Name>Consultant/Sales person</Name><Options><Option><Name>Felix Wilson</Name></Option><Option><Name>Martin Hudson</Name></Option><Option><Name>Orlena Greenville</Name></Option></Options></TrackingCategory></Tracking></Response>

data/test/integration/update_contact_test.rb

@@ -0,0 +1,32 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class UpdateContactTest < Test::Unit::TestCase
+  include IntegrationTestMethods
+  
+  def setup
+    @gateway = XeroGateway::Gateway.new(
+      :customer_key => CUSTOMER_KEY,
+      :api_key => API_KEY    
+    )
+    
+    if STUB_XERO_CALLS
+      @gateway.xero_url = "DUMMY_URL"
+      
+      @gateway.stubs(:http_put).with {|url, body, params| url =~ /contact$/ }.returns(get_file_as_string("contact.xml"))          
+      @gateway.stubs(:http_post).with {|url, body, params| url =~ /contact$/ }.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_equal contact.contact_id, result.contact.contact_id
+    assert_equal "123 4567", result.contact.phone.number if !STUB_XERO_CALLS
+  end
+end

data/test/unit/messages/account_message_test.rb

@@ -0,0 +1,34 @@
+require File.join(File.dirname(__FILE__), '../../test_helper.rb')
+
+class AccountMessageTest < Test::Unit::TestCase
+  # Tests that an account can be converted into XML that Xero can understand, and then converted back to an account
+  def test_build_and_parse_xml
+    account = create_test_account
+    
+    # Generate the XML message
+    account_as_xml = XeroGateway::Messages::AccountMessage.build_xml(account)
+
+    # Parse the XML message and retrieve the account element
+    account_element = REXML::XPath.first(REXML::Document.new(account_as_xml), "/Account")
+
+    # Build a new account from the XML
+    result_account = XeroGateway::Messages::AccountMessage.from_xml(account_element)
+    
+    # Check the account details
+    assert_equal account, result_account
+  end
+  
+  
+  private
+  
+  def create_test_account
+    account = XeroGateway::Account.new
+    account.code = "200"
+    account.name = "Sales"
+    account.type = "REVENUE"
+    account.tax_type = "OUTPUT"
+    account.description = "Income from any normal business activity"
+    
+    account
+  end
+end

data/test/unit/messages/tracking_category_message_test.rb

@@ -0,0 +1,30 @@
+require File.join(File.dirname(__FILE__), '../../test_helper.rb')
+
+class TrackingCategoryMessageTest < Test::Unit::TestCase
+  # Tests that a tracking category can be converted into XML that Xero can understand, and then converted back to a tracking category
+  def test_build_and_parse_xml
+    tracking_category = create_test_tracking_category
+    
+    # Generate the XML message
+    tracking_category_as_xml = XeroGateway::Messages::TrackingCategoryMessage.build_xml(tracking_category)
+
+    # Parse the XML message and retrieve the tracking category element
+    tracking_category_element = REXML::XPath.first(REXML::Document.new(tracking_category_as_xml), "/TrackingCategory")
+
+    # Build a new tracking category from the XML
+    result_tracking_category = XeroGateway::Messages::TrackingCategoryMessage.from_xml(tracking_category_element)
+    
+    # Check the tracking category details
+    assert_equal tracking_category, result_tracking_category
+  end
+  
+  
+  private
+  
+  def create_test_tracking_category
+    tracking_category = XeroGateway::TrackingCategory.new
+    tracking_category.name = "REGION"
+    tracking_category.options = ["NORTH", "SOUTH", "CENTRAL"]
+    tracking_category
+  end
+end

data/xero_gateway.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
   s.name     = "xero_gateway"
-  s.version  = "1.0.1"
-  s.date     = "2008-12-01"
+  s.version  = "1.0.2"
+  s.date     = "2008-12-04"
   s.summary  = "Enables ruby based applications to communicate with the Xero API"
   s.email    = "tlconnor@gmail.com"
   s.homepage = "http://github.com/tlconnor/xero_gateway"
@@ -9,10 +9,11 @@ Gem::Specification.new do |s|
   s.has_rdoc = false
   s.authors  = ["Tim Connor"]
   s.add_dependency('builder', '>= 2.1.2')
-  s.files    = ["README.textile", 
-    "CHANGELOG.textile",
+  s.files    = ["CHANGELOG.textile",
+    "init.rb",
     "LICENSE",
     "Rakefile",
+    "README.textile", 
     "lib/xero_gateway.rb",
     "lib/xero_gateway/account.rb",
     "lib/xero_gateway/address.rb",
@@ -25,18 +26,32 @@ Gem::Specification.new do |s|
     "lib/xero_gateway/money.rb",
     "lib/xero_gateway/phone.rb",
     "lib/xero_gateway/response.rb",
+    "lib/xero_gateway/tracking_category.rb",
     "lib/xero_gateway/messages/account_message.rb",
     "lib/xero_gateway/messages/contact_message.rb",
     "lib/xero_gateway/messages/invoice_message.rb",
+    "lib/xero_gateway/messages/tracking_category_message.rb",
     "test/test_helper.rb",
-    "test/unit/messages/contact_message_test.rb",
-    "test/unit/messages/invoice_message_test.rb",
-    "test/integration/gateway_test.rb",
+    "test/integration/create_contact_test.rb",
+    "test/integration/create_invoice_test.rb",
+    "test/integration/get_accounts_test.rb",
+    "test/integration/get_contact_test.rb",
+    "test/integration/get_contacts_test.rb",
+    "test/integration/get_invoice_test.rb",
+    "test/integration/get_invoices_test.rb",
+    "test/integration/get_tracking_categories_test.rb",
+    "test/integration/integration_test_methods.rb",
     "test/integration/stub_responses/accounts.xml",
     "test/integration/stub_responses/contact.xml",
     "test/integration/stub_responses/contacts.xml",
     "test/integration/stub_responses/invoice.xml",
     "test/integration/stub_responses/invoices.xml",
+    "test/integration/stub_responses/tracking_categories.xml",
+    "test/integration/update_contact_test.rb",
+    "test/unit/messages/account_message_test.rb",
+    "test/unit/messages/contact_message_test.rb",
+    "test/unit/messages/invoice_message_test.rb",
+    "test/unit/messages/tracking_category_message_test.rb",
     "test/xsd/README",
     "test/xsd/create_contact.xsd",
     "test/xsd/create_invoice.xsd",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: tlconnor-xero_gateway
 version: !ruby/object:Gem::Version 
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors: 
 - Tim Connor
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-12-01 00:00:00 -08:00
+date: 2008-12-04 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -30,10 +30,11 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- README.textile
 - CHANGELOG.textile
+- init.rb
 - LICENSE
 - Rakefile
+- README.textile
 - lib/xero_gateway.rb
 - lib/xero_gateway/account.rb
 - lib/xero_gateway/address.rb
@@ -46,18 +47,32 @@ files:
 - lib/xero_gateway/money.rb
 - lib/xero_gateway/phone.rb
 - lib/xero_gateway/response.rb
+- lib/xero_gateway/tracking_category.rb
 - lib/xero_gateway/messages/account_message.rb
 - lib/xero_gateway/messages/contact_message.rb
 - lib/xero_gateway/messages/invoice_message.rb
+- lib/xero_gateway/messages/tracking_category_message.rb
 - test/test_helper.rb
-- test/unit/messages/contact_message_test.rb
-- test/unit/messages/invoice_message_test.rb
-- test/integration/gateway_test.rb
+- test/integration/create_contact_test.rb
+- test/integration/create_invoice_test.rb
+- test/integration/get_accounts_test.rb
+- test/integration/get_contact_test.rb
+- test/integration/get_contacts_test.rb
+- test/integration/get_invoice_test.rb
+- test/integration/get_invoices_test.rb
+- test/integration/get_tracking_categories_test.rb
+- test/integration/integration_test_methods.rb
 - test/integration/stub_responses/accounts.xml
 - test/integration/stub_responses/contact.xml
 - test/integration/stub_responses/contacts.xml
 - test/integration/stub_responses/invoice.xml
 - test/integration/stub_responses/invoices.xml
+- test/integration/stub_responses/tracking_categories.xml
+- test/integration/update_contact_test.rb
+- test/unit/messages/account_message_test.rb
+- test/unit/messages/contact_message_test.rb
+- test/unit/messages/invoice_message_test.rb
+- test/unit/messages/tracking_category_message_test.rb
 - test/xsd/README
 - test/xsd/create_contact.xsd
 - test/xsd/create_invoice.xsd