xero 0.0.1.1

data/lib/xero/models/item_detail.rb

@@ -0,0 +1,14 @@
+module Xero
+  module Models
+    class ItemDetail < BaseModel
+
+      attribute :unit_price, type: Float
+      attribute :account_code
+      attribute :tax_type
+
+      validates :unit_price, presence: true
+      validates :account_code, presence: true
+      validates :tax_type, presence: true
+    end
+  end
+end

data/lib/xero/models/line_item.rb

@@ -0,0 +1,16 @@
+module Xero
+  module Models
+    class LineItem < Xero::Models::BaseModel
+
+      attribute :description
+      attribute :quantity, type: Float
+      attribute :unit_amount, type: Float
+      attribute :account_code
+
+      validates :description, presence: true
+      validates :quantity, presence: true
+      validates :unit_amount, presence: true
+      validates :account_code, presence: true
+    end
+  end
+end

data/lib/xero/models/payment.rb

@@ -0,0 +1,21 @@
+module Xero
+  module Models
+    class Payment < Xero::Models::BaseModel
+
+      self.path = 'Payments'
+
+      attribute :date, type: Date
+      attribute :currency_rate, type: Float
+      attribute :amount, type: Float
+      attribute :reference
+
+      belongs_to :invoice
+      belongs_to :account
+
+      validates :amount, presence: true
+      validates :date, presence: true
+      validates :invoice, presence: true
+      validates :account, presence: true
+    end
+  end
+end

data/lib/xero/models/phone.rb

@@ -0,0 +1,18 @@
+module Xero
+  module Models
+    class Phone < BaseModel
+
+      attribute :phone_type
+      attribute :number
+      attribute :area_code
+      attribute :country_code
+
+      validates :phone_type, presence: true
+      validates :number, presence: true
+      validates :area_code, presence: true
+      validates :country_code, presence: true
+
+      belongs_to :invoice
+    end
+  end
+end

data/lib/xero/models/tracking_category.rb

@@ -0,0 +1,12 @@
+module Xero
+  module Models
+    class TrackingCategory < Xero::Models::BaseModel
+
+      self.path = 'TrackingCategories'
+
+      attribute :name
+
+      has_many :tracking_category_options
+    end
+  end
+end

data/lib/xero/models/tracking_category_option.rb

@@ -0,0 +1,12 @@
+module Xero
+  module Models
+    class TrackingCategoryOption < Xero::Models::BaseModel
+
+      attribute :name
+
+      validates :name, presence: true
+
+      belongs_to :tracking_category
+    end
+  end
+end

data/lib/xero/version.rb

@@ -0,0 +1,3 @@
+module Xero
+  VERSION = "0.0.1.1"
+end

data/lib/xero.rb

@@ -0,0 +1,39 @@
+require 'active_attr'
+require 'active_support/core_ext'
+require 'active_support/inflection_config'
+require 'oauth'
+require 'xero/associations/belongs_to'
+require 'xero/associations/has_many'
+require 'xero/associations/has_many_proxy'
+require 'xero/associations/has_one'
+require 'xero/associations'
+require 'xero/client'
+require 'xero/clients/partner_application'
+require 'xero/clients/private_application'
+require 'xero/configuration'
+require 'xero/connection'
+require 'xero/models/base_model'
+require 'xero/models/account'
+require 'xero/models/address'
+require 'xero/models/contact'
+require 'xero/models/invoice'
+require 'xero/models/item'
+require 'xero/models/item_detail'
+require 'xero/models/line_item'
+require 'xero/models/payment'
+require 'xero/models/phone'
+require 'xero/models/tracking_category'
+require 'xero/models/tracking_category_option'
+require 'xero/version'
+
+module Xero
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    self.configuration = Xero::Configuration.new
+    yield(configuration)
+    return self.configuration
+  end
+end

data/spec/lib/xero/client_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Xero::Client do
+end

data/spec/lib/xero/clients/private_application_spec.rb

@@ -0,0 +1,216 @@
+require 'spec_helper'
+
+describe Xero::Clients::PrivateApplication do
+
+  let(:client) { Xero::Clients::PrivateApplication.new }
+
+  describe '#contacts' do
+    before { configure }
+
+    let(:contacts) do
+      VCR.use_cassette('contacts') { client.contacts }
+    end
+
+    it 'should return an array' do
+      contacts.should be_a(Array)
+    end
+
+    it 'should contain contacts' do
+      contacts.first.should be_a(Xero::Models::Contact)
+    end
+
+    it 'should populate the contacts id' do
+      contacts.first.id.should_not be_blank
+    end
+  end
+
+  describe '#get_contact' do
+    before { configure }
+
+    let(:contacts) do
+      VCR.use_cassette('contacts') { client.contacts }
+    end
+
+    let(:contact) do
+      VCR.use_cassette('contact') do
+        client.get_contact(contacts.first.id)
+      end
+    end
+
+    it 'should return a contact' do
+      contact.should be_a(Xero::Models::Contact)
+    end
+
+    it 'should populate the contact id' do
+      contact.id.should_not be_blank
+    end
+
+    it 'should populate the contact addresses' do
+      contact.addresses.first.should be_a(Xero::Models::Address)
+    end
+  end
+
+  describe '#get_invoice' do
+    before { configure }
+
+    let(:invoice) do
+      VCR.use_cassette('get_invoice') do
+        client.get_invoice('7f9e9823-f6d7-4302-90a1-ba59f6884ce9')
+      end
+    end
+
+    it 'should return an invoice' do
+      invoice.should be_a(Xero::Models::Invoice)
+    end
+
+    it 'should populate the type' do
+      invoice.type.should_not be_blank
+    end
+
+    it 'should populate the date' do
+      invoice.date.should_not be_blank
+    end
+
+    it 'should populate the due date' do
+      invoice.due_date.should_not be_blank
+    end
+
+    it 'should populate the invoice number' do
+      invoice.invoice_number.should_not be_blank
+    end
+
+    it 'should populate the total' do
+      invoice.total.should_not be_blank
+    end
+
+    it 'should populate the currency code' do
+      invoice.currency_code.should_not be_blank
+    end
+
+    it 'should populate the id' do
+      invoice.id.should_not be_blank
+    end
+
+    it 'should populate the total tax' do
+      invoice.total_tax.should_not be_blank
+    end
+
+    it 'should populate the invoice status' do
+      invoice.status.should eql('AUTHORISED')
+    end
+
+    it 'should populate the invoice contact' do
+      invoice.contact.should be_a(Xero::Models::Contact)
+    end
+
+    it 'should populate the contact data' do
+      invoice.contact.id.should_not be_blank
+    end
+  end
+
+  describe '#invoices' do
+    before { configure }
+
+    let(:invoices) do
+      VCR.use_cassette('invoices') { client.invoices }
+    end
+
+    it 'should return an array' do
+      invoices.should be_a(Array)
+    end
+
+    it 'should contain invoices' do
+      invoices.first.should be_a(Xero::Models::Invoice)
+    end
+
+    it 'should populate the invoice data' do
+      invoices.first.id.should_not be_blank
+    end
+  end
+
+  describe '#save' do
+    before { configure }
+
+    let(:item) do
+      Xero::Models::Item.new code: 'test-product',
+        description: 'just testing',
+        purchase_details: purchase_detail_attributes,
+        sales_details: sales_detail_attributes
+    end
+
+    let(:purchase_detail_attributes) do
+      { unit_price: 100, account_code: '620', tax_type: 'NONE' }
+    end
+
+    let(:sales_detail_attributes) do
+      { unit_price: 550, account_code: '200', tax_type: 'NONE' }
+    end
+
+    before do
+      VCR.use_cassette('create_item') { client.save(item) }
+    end
+
+    it 'should populate the item id' do
+      item.id.should_not be_blank
+    end
+
+    it 'should be persisted' do
+      item.should be_persisted
+    end
+  end
+
+  describe '#get_item' do
+
+    before { configure }
+
+    let(:item) do
+      client.get_item '99213658-83c4-438a-b104-1172b1e69790'
+    end
+
+    it 'should return an item' do
+      VCR.use_cassette('get_item') do
+        item.should be_a(Xero::Models::Item)
+      end
+    end
+  end
+
+  describe '#items' do
+    before { configure }
+
+    let(:items) do
+      VCR.use_cassette('get_items') { client.items }
+    end
+
+    it 'should return an array' do
+      items.should be_a(Array)
+    end
+
+    it 'should contain items' do
+      items.first.should be_a(Xero::Models::Item)
+    end
+
+    it 'should populate the id' do
+      items.first.id.should_not be_blank
+    end
+
+    it 'should populate the item code' do
+      items.first.code.should_not be_blank
+    end
+
+    it 'should populate the item description' do
+      items.first.description.should_not be_blank
+    end
+
+    it 'should populate the item purchase detail' do
+      items.first.purchase_details.should be_a(Xero::Models::ItemDetail)
+    end
+
+    it 'should populate the item sales detail' do
+      items.first.sales_details.should be_a(Xero::Models::ItemDetail)
+    end
+
+    it 'should populate the item purchase detail account code' do
+      items.first.purchase_details.account_code.should_not be_blank
+    end
+  end
+end

data/spec/lib/xero/models/account_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+describe Xero::Models::Account do
+
+  # describe '.from_xml' do
+  #   let(:account) do
+  #     Xero::Models::Account.from_xml(File.read('spec/support/find_account.xml'))
+  #   end
+
+  #   it 'should populate the account id' do
+  #     account.id.should eql('297c2dc5-cc47-4afd-8ec8-74990b8761e9')
+  #   end
+
+  #   it 'should populate the name' do
+  #     account.name.should eql('BNZ  Cheque  Account')
+  #   end
+
+  #   it 'should populate the account type' do
+  #     account.account_type.should eql('BANK')
+  #   end
+
+  #   it 'should populate the tax type' do
+  #     account.tax_type.should eql('NONE')
+  #   end
+
+  #   it 'should populate enable payments to account' do
+  #     account.enable_payments_to_account.should eql(false)
+  #   end
+
+  #   it 'should populate bank account number' do
+  #     account.bank_account_number.should eql('3809087654321500')
+  #   end
+
+  #   it 'should populate the currency code' do
+  #     account.currency_code.should eql('NZD')
+  #   end
+  # end
+end

data/spec/lib/xero/models/address_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe Xero::Models::Address do
+
+  describe 'validations' do
+
+    it { should validate_presence_of(:address_type) }
+
+    it { should validate_presence_of(:attention_to) }
+
+    it { should validate_presence_of(:address_line1) }
+
+    it { should validate_presence_of(:city) }
+
+    it { should validate_presence_of(:region) }
+
+    it { should validate_presence_of(:postal_code) }
+
+    it { should validate_presence_of(:country) }
+  end
+end

data/spec/lib/xero/models/base_model_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+describe Xero::Models::BaseModel do
+
+  describe '#initialize' do
+    let(:model) { Xero::Models::BaseModel.new }
+
+    it 'should set new_record to true' do
+      model.new_record.should be_true
+    end
+  end
+
+  describe '#save' do
+    context 'when client is blank' do
+      let(:model) { Xero::Models::BaseModel.new }
+
+      it 'should raise an error' do
+        expect { model.save }.to raise_error
+      end
+    end
+  end
+
+  describe '#xero_attributes' do
+    let(:model) do
+      Xero::Models::BaseModel.new id: 'asdf'
+    end
+
+
+    it 'should not include the id' do
+      model.xero_attributes['BaseModelId'].should be_blank
+    end
+
+    it 'should camelize the attributes' do
+      model.xero_attributes(x_attr: 'something')['XAttr'].should eql('something')
+    end
+  end
+end

data/spec/lib/xero/models/contact_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Xero::Models::Contact do
+end

data/spec/lib/xero/models/invoice_spec.rb

@@ -0,0 +1,6 @@
+require 'spec_helper'
+
+describe Xero::Models::Invoice do
+
+  it { should validate_presence_of(:type) }
+end

data/spec/lib/xero/models/item_detail_spec.rb

@@ -0,0 +1,10 @@
+require 'spec_helper'
+
+describe Xero::Models::ItemDetail do
+
+  it { should validate_presence_of(:unit_price) }
+
+  it { should validate_presence_of(:account_code) }
+
+  it { should validate_presence_of(:tax_type) }
+end

data/spec/lib/xero/models/item_spec.rb

@@ -0,0 +1,119 @@
+require 'spec_helper'
+
+describe Xero::Models::Item do
+
+  describe 'validations' do
+    it { should validate_presence_of(:code) }
+  end
+
+  describe 'to_xero_xml' do
+    let(:item) do
+      Xero::Models::Item.new(
+        purchase_details: purchase_detail_attributes,
+        sales_details: sales_detail_attributes,
+        id: '34b3fc86-483e-4112-8106-9b23d36f925c',
+        code: 'Monster',
+        description: 'Test description'
+      )
+    end
+
+    let(:purchase_detail_attributes) do
+      { unit_price: 100, account_code: '620', tax_type: 'NONE' }
+    end
+
+    let(:sales_detail_attributes) do
+      { unit_price: 550, account_code: '200', tax_type: 'NONE' }
+    end
+
+    subject { item.to_xero_xml }
+
+    it 'should include the purchase detail' do
+      subject.should match(/PurchaseDetails/)
+    end
+
+    it 'should include the sales detail' do
+      subject.should match(/SalesDetails/)
+    end
+
+    it 'should not include the id' do
+      subject.should_not match(/ItemId/)
+    end
+
+    it 'should not include the id value' do
+      subject.should_not match(/34b3fc86\-483e\-4112\-8106\-9b23d36f925c/)
+    end
+
+    it 'should include the code' do
+      subject.should match(/Code/)
+    end
+
+    it 'should include the code value' do
+      subject.should match(/Monster/)
+    end
+
+    it 'should include the unit price' do
+      subject.should match(/UnitPrice/)
+    end
+
+    it 'should include the description' do
+      subject.should match(/Description/)
+    end
+
+    it 'should include the description value' do
+      subject.should match(/Test description/)
+    end
+  end
+
+  describe '#purchase_details=' do
+
+    let(:item) { Xero::Models::Item.new }
+
+    before do
+      item.purchase_details = {
+        unit_price: 100, account_code: '620', tax_type: 'NONE'
+      }
+    end
+
+    it 'should add a new item detail to the item' do
+      item.purchase_details.should be_a(Xero::Models::ItemDetail)
+    end
+
+    it 'should set the unit price' do
+      item.purchase_details.unit_price.should eql(100.0)
+    end
+
+    it 'should set the account code' do
+      item.purchase_details.account_code.should eql('620')
+    end
+
+    it 'should set the tax type' do
+      item.purchase_details.tax_type.should eql('NONE')
+    end
+  end
+
+  describe '#sales_details=' do
+    let(:item) { Xero::Models::Item.new }
+
+    before do
+      item.sales_details = {
+        unit_price: 550, account_code: '200', tax_type: 'NONE'
+      }
+    end
+
+    it 'should add a new item detail to the item' do
+      item.sales_details.should be_a(Xero::Models::ItemDetail)
+    end
+
+    it 'should set the unit price' do
+      item.sales_details.unit_price.should eql(550.0)
+    end
+
+    it 'should set the account code' do
+      item.sales_details.account_code.should eql('200')
+    end
+
+    it 'should set the tax type' do
+      item.sales_details.tax_type.should eql('NONE')
+    end
+  end
+end

data/spec/lib/xero/models/line_item_spec.rb

@@ -0,0 +1,12 @@
+require 'spec_helper'
+
+describe Xero::Models::LineItem do
+
+  it { should validate_presence_of(:description) }
+
+  it { should validate_presence_of(:quantity) }
+
+  it { should validate_presence_of(:unit_amount) }
+
+  it { should validate_presence_of(:account_code) }
+end

data/spec/lib/xero/models/payment_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Xero::Models::Payment do
+end

data/spec/lib/xero/models/phone_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe Xero::Models::Phone do
+
+  describe 'validations' do
+
+    it { should validate_presence_of(:phone_type) }
+
+    it { should validate_presence_of(:number) }
+
+    it { should validate_presence_of(:area_code) }
+
+    it { should validate_presence_of(:country_code) }
+  end
+end

data/spec/lib/xero/models/tracking_category_option_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Xero::Models::TrackingCategoryOption do
+end

data/spec/lib/xero/models/tracking_category_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Xero::Models::TrackingCategory do
+end

data/spec/spec_helper.rb

@@ -0,0 +1,28 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require 'active_attr/rspec'
+require 'bundler/setup'
+require 'xero'
+require 'rubygems'
+require 'shoulda-matchers'
+require 'support/helpers'
+require 'support/vcr'
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+
+  config.include Helpers
+end