cashboard 1.0.1

data/test/unit/account_test.rb

@@ -0,0 +1,85 @@
+require File.dirname(__FILE__) + '/../test_helper.rb'
+
+class AccountTest < Test::Unit::TestCase
+  
+  def test_create_success
+    FakeWeb.register_uri(
+      :post,
+      url_with_auth("/#{Cashboard::Account.resource_name}"),
+      :status => ["201", "Created"],
+      :body => get_xml_for_fixture('account')
+    ) if MOCK_WEB_CONNECTIONS
+    
+    acct = Cashboard::Account.create({
+      :subdomain => generate_random_string,
+      :currency_type => 'USD',
+      :date_format => 'mm_dd_yyyy',
+      :owner => {
+        :email_address => 'rza@wutang.com',
+        :first_name => 'The',
+        :last_name => 'Rza',
+        :password => '36chambers'
+      },
+      :company => {
+        :name => 'Wu Tang',
+        :address => '1 Shogun Way',
+        :city => 'Shaolin',
+        :state => 'NY'
+      }
+    })
+    
+    assert_kind_of Cashboard::Struct, acct.owner
+    assert_kind_of Cashboard::Struct, acct.company
+    
+    assert !acct.owner.api_key.blank?
+  end
+  
+  def test_create_fail
+    FakeWeb.register_uri(
+      :post,
+      url_with_auth("/#{Cashboard::Account.resource_name}"),
+      :status => ["400", "Bad Request"],
+      :body => GENERIC_ERROR_XML
+    ) if MOCK_WEB_CONNECTIONS
+    
+    assert_raises Cashboard::BadRequest do
+      Cashboard::Account.create()
+    end
+  end
+  
+  def test_update_success  
+    acct = Cashboard::Account.new_from_url('/account')
+    
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth("/#{Cashboard::Account.resource_name}"), 
+      :status => ["200", "Ok"],
+      :body => get_xml_for_fixture('account')
+    ) if MOCK_WEB_CONNECTIONS
+    
+    acct.date_format = 'yyyy_mm_dd'
+    assert acct.update, "Account didn't save properly"
+  end
+  
+  def test_update_fail
+    acct = Cashboard::Account.new_from_url('/account')
+    
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth("/#{Cashboard::Account.resource_name}"), 
+      :status => ["400", "Bad Request"],
+      :body => GENERIC_ERROR_XML
+    ) if MOCK_WEB_CONNECTIONS
+    
+    acct.subdomain = ''
+    assert !acct.update, "Account shouldn't have saved with blank subdomain"
+  end
+  
+  def test_new_from_url
+    acct = Cashboard::Account.new_from_url('/account')
+    assert_kind_of Cashboard::Account, acct
+    assert_kind_of Cashboard::Struct, acct.owner
+    assert_kind_of Cashboard::Struct, acct.company
+  end
+  
+end

data/test/unit/document_template_test.rb

@@ -0,0 +1,18 @@
+require File.dirname(__FILE__) + '/../test_helper.rb'
+
+class DocumentTemplateTest < Test::Unit::TestCase
+
+  def test_list
+    templates = Cashboard::DocumentTemplate.list
+    assert templates.size > 0
+    templates.each do |dt|
+      assert_kind_of Cashboard::DocumentTemplate, dt
+    end
+  end
+
+  def test_href
+    tmpl = Cashboard::DocumentTemplate.list[0]
+    assert_kind_of String, tmpl.href
+  end
+
+end

data/test/unit/estimate_test.rb

@@ -0,0 +1,166 @@
+require File.dirname(__FILE__) + '/../test_helper.rb'
+
+class EstimateTest < Test::Unit::TestCase
+  
+  # CUSTOM ASSERTIONS ---------------------------------------------------------
+  
+  def assert_list_type(method, type)
+    mock_sub_resource(
+      Cashboard::Estimate.resource_name, 
+      'line_items',
+      'line_items'
+    ) if MOCK_WEB_CONNECTIONS
+    
+    est = Cashboard::Estimate.list[0]
+    collection = est.send(method)
+    assert collection.size > 0
+    collection.each do |item|
+      assert_kind_of Cashboard::LineItem, item
+      assert_equal Cashboard::LineItem::TYPE_CODES[type], item.type_code.to_i
+    end    
+  end
+
+  
+  # TESTS ---------------------------------------------------------------------
+  
+  def test_list
+    estimates = Cashboard::Estimate.list
+    assert estimates.size > 0
+    estimates.each do |est|
+      assert_kind_of Cashboard::Estimate, est
+    end
+  end
+  
+  def test_create
+    FakeWeb.register_uri(
+      :post,
+      url_with_auth("/#{Cashboard::Estimate.resource_name}"),
+      :status => ["201", "Created"],
+      :body => Cashboard::Estimate.list[0].to_xml
+    ) if MOCK_WEB_CONNECTIONS  
+    
+    client = Cashboard::ClientCompany.list[0]
+    
+    # Create random estimate name so even if not destroyed on 
+    # a live connection we don't run into duplicate name validation errors.
+    est_name = "Test estimate - " + generate_random_string
+    assert_nothing_raised do
+      estimate = Cashboard::Estimate.create(
+        :name => est_name, 
+        :client_id => client.id,
+        :client_type => 'Company'
+      )
+    end
+  end
+  
+  def test_update_success
+    est = Cashboard::Estimate.list[0]
+    
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth(est.href), 
+      :status => ["200", "Ok"],
+      :body => est.to_xml
+    ) if MOCK_WEB_CONNECTIONS
+    
+    est.name = 'Some new name'
+    assert est.update, "Estimate didn't save properly"
+  end
+  
+  def test_update_fail
+    est = Cashboard::Estimate.list[0]
+    
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth(est.href), 
+      :status => ["400", "Bad Request"],
+      :body => GENERIC_ERROR_XML
+    ) if MOCK_WEB_CONNECTIONS
+    
+    est.name = 'Some new name'
+    assert !est.update, "Estimate saved when it shouldn't have"
+  end
+  
+  def test_delete_success
+    est = Cashboard::Estimate.list[0]
+    
+    FakeWeb.register_uri(
+      :delete, 
+      url_with_auth(est.href), 
+      :status => ["200", "Ok"]
+    ) if MOCK_WEB_CONNECTIONS
+
+    assert est.delete, "Estimate wasn't deleted."
+  end
+  
+  def test_delete_fail
+    est = Cashboard::Estimate.list[0]
+    
+    FakeWeb.register_uri(
+      :delete, 
+      url_with_auth(est.href), 
+      :status => ["404", "Not found"]
+    ) if MOCK_WEB_CONNECTIONS
+
+    assert !est.delete, "Estimate was deleted when it shouldn't have been."
+  end
+  
+  def test_toggle_status_success
+    est = Cashboard::Estimate.list[0]
+    assert_equal false, est.is_active
+    
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth(est.links[:toggle_status]), 
+      :status => ["200", "Ok"]
+    ) if MOCK_WEB_CONNECTIONS
+    
+    initial_status = est.is_active
+    
+    assert est.toggle_status
+    assert true, est.is_active
+  end
+  
+  def test_toggle_status_failure
+    est = Cashboard::Estimate.list[0]
+        
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth(est.links[:toggle_status]), 
+      :status => ["401", "Unauthorized"]
+    ) if MOCK_WEB_CONNECTIONS
+    
+    initial_status = est.is_active
+    
+    assert !est.toggle_status
+    assert est.is_active == initial_status
+  end
+  
+  def test_line_items
+    mock_sub_resource(
+      Cashboard::Project.resource_name, 
+      'line_items',
+      'line_items'
+    ) if MOCK_WEB_CONNECTIONS
+    
+    est = Cashboard::Estimate.list[0]
+    line_items = est.line_items
+    assert line_items.size > 0
+    line_items.each do |li|
+      assert_kind_of Cashboard::LineItem, li
+    end
+  end
+  
+  def test_tasks
+    assert_list_type :tasks, :task
+  end
+  
+  def test_products
+    assert_list_type :products, :product
+  end
+  
+  def test_custom_items
+    assert_list_type :custom_items, :custom
+  end
+  
+end

data/test/unit/expense_test.rb

@@ -0,0 +1,16 @@
+require File.dirname(__FILE__) + '/../test_helper.rb'
+
+class ExpenseTest < Test::Unit::TestCase
+  
+  def test_list
+    expenses = Cashboard::Expense.list
+    assert expenses.size > 0
+    expenses.each do |exp|
+      assert_kind_of Cashboard::Expense, exp
+      assert_kind_of DateTime, exp.created_on
+      assert_kind_of Float, exp.amount
+      assert exp.is_billable.class == TrueClass || exp.is_billable.class == FalseClass
+    end
+  end
+  
+end

data/test/unit/invoice_test.rb

@@ -0,0 +1,185 @@
+require File.dirname(__FILE__) + '/../test_helper.rb'
+
+class InvoiceTest < Test::Unit::TestCase
+
+  def test_list
+    invoices = Cashboard::Invoice.list
+    assert invoices.size > 0
+    invoices.each do |inv|
+      assert_kind_of Cashboard::Invoice, inv
+    end
+  end
+  
+  def test_create_success
+    FakeWeb.register_uri(
+      :post,
+      url_with_auth("/#{Cashboard::Invoice.resource_name}"),
+      :status => ["201", "Created"],
+      :body => Cashboard::Invoice.list[0].to_xml
+    ) if MOCK_WEB_CONNECTIONS  
+    
+    client = Cashboard::ClientCompany.list[0]
+
+    assert_nothing_raised do
+      inv = Cashboard::Invoice.create(
+        :client_id => client.id,
+        :client_type => 'Company'
+      )
+      assert_kind_of Cashboard::Invoice, inv
+    end
+  end
+  
+  def test_create_fail
+    FakeWeb.register_uri(
+      :post,
+      url_with_auth("/#{Cashboard::Project.resource_name}"),
+      :status => ["400", "Bad Request"],
+      :body => GENERIC_ERROR_XML
+    ) if MOCK_WEB_CONNECTIONS  
+    
+    assert_raise Cashboard::BadRequest do
+      prj = Cashboard::Project.create()
+    end
+  end
+
+  def test_update_success
+    inv = Cashboard::Invoice.list[0]
+    
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth(inv.href), 
+      :status => ["200", "Ok"],
+      :body => inv.to_xml
+    ) if MOCK_WEB_CONNECTIONS
+    
+    inv.created_on = Date.today
+    inv.due_date = Date.today + 1.week
+    assert inv.update, "Invoice didn't save properly"
+  end
+  
+  def test_update_fail
+    inv = Cashboard::Invoice.list[0]
+    
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth(inv.href), 
+      :status => ["400", "Bad Request"],
+      :body => GENERIC_ERROR_XML
+    ) if MOCK_WEB_CONNECTIONS
+    
+    inv.client_id = nil
+    assert !inv.update, "Invoice saved when it shouldn't have"
+  end
+  
+  def test_delete_success
+    inv = Cashboard::Invoice.list[0]
+    
+    FakeWeb.register_uri(
+      :delete, 
+      url_with_auth(inv.href), 
+      :status => ["200", "Ok"]
+    ) if MOCK_WEB_CONNECTIONS
+
+    assert inv.delete, "Invoice wasn't deleted."
+  end
+  
+  def test_delete_fail
+    inv = Cashboard::Invoice.list[0]
+    
+    FakeWeb.register_uri(
+      :delete, 
+      url_with_auth(inv.href), 
+      :status => ["404", "Not found"]
+    ) if MOCK_WEB_CONNECTIONS
+
+    assert !inv.delete, "Invoice was deleted when it shouldn't have been."
+  end
+  
+  def test_line_items
+    mock_sub_resource(
+      Cashboard::Invoice.resource_name, 
+      'line_items',
+      'invoice_line_items'
+    ) if MOCK_WEB_CONNECTIONS
+    
+    inv = Cashboard::Invoice.list[0]
+  
+    line_items = inv.line_items
+    assert line_items.size > 0
+    
+    line_items.each do |li|
+      assert_kind_of Cashboard::InvoiceLineItem, li
+    end
+  end
+  
+  def mock_import_items_response
+    FakeWeb.register_uri(
+      :put, 
+      get_sub_url_regexp(Cashboard::Invoice.resource_name, 'import_uninvoiced_items'), 
+      :body => get_xml_for_fixture('invoice_line_items'),
+      :status => ['200', 'OK']
+    ) if MOCK_WEB_CONNECTIONS
+  end
+  
+  def test_import_uninvoiced_items_no_options
+    mock_import_items_response
+    inv = Cashboard::Invoice.list[0]
+    
+    assert_nothing_raised do
+      items = inv.import_uninvoiced_items
+      assert items.size > 0
+      items.each do |li|
+        assert_kind_of Cashboard::InvoiceLineItem, li
+      end
+    end
+  end
+  
+  def test_import_uninvoiced_items_with_projects
+    mock_import_items_response
+    inv = Cashboard::Invoice.list[0]
+    
+    inv.expects(:get_import_xml_options).with([12345], nil, nil)
+
+    inv.import_uninvoiced_items([12345])
+  end
+
+  def test_get_import_xml_options_project_id
+    xml_options = %Q\
+      <?xml version="1.0" encoding="UTF-8"?>
+      <projects>
+        <id>12345</id>
+      </projects>
+      <start_date></start_date>
+      <end_date></end_date>
+    \
+    inv = Cashboard::Invoice.list[0]
+
+    opts = inv.get_import_xml_options([12345], nil, nil)
+
+    assert_equal(
+      xml_options.gsub(/\s/, ''),
+      opts.gsub(/\s/, '')
+    )
+  end
+  
+  def test_get_import_xml_options_start_end_date
+    d1 = Date.today-1.week
+    d2 = Date.today
+    xml_options = %Q\
+      <?xml version="1.0" encoding="UTF-8"?>
+      <projects>
+      </projects>
+      <start_date>#{d1.to_s}</start_date>
+      <end_date>#{d2.to_s}</end_date>
+    \
+    inv = Cashboard::Invoice.list[0]
+
+    opts = inv.get_import_xml_options(nil, d1, d2)
+
+    assert_equal(
+      xml_options.gsub(/\s/, ''),
+      opts.gsub(/\s/, '')
+    )
+  end
+  
+end

data/test/unit/project_test.rb

@@ -0,0 +1,198 @@
+require File.dirname(__FILE__) + '/../test_helper.rb'
+
+class ProjectTest < Test::Unit::TestCase  
+  
+  # CUSTOM ASSERTIONS ---------------------------------------------------------
+  
+  def assert_list_type(method, type)
+    mock_sub_resource(
+      Cashboard::Project.resource_name, 
+      'line_items',
+      'line_items'
+    ) if MOCK_WEB_CONNECTIONS
+    
+    prj = Cashboard::Project.list[0]
+    collection = prj.send(method)
+    assert collection.size > 0
+    collection.each do |item|
+      assert_kind_of Cashboard::LineItem, item
+      assert_equal Cashboard::LineItem::TYPE_CODES[type], item.type_code.to_i
+    end    
+  end
+  
+  
+  # TESTS ---------------------------------------------------------------------
+  
+  def test_list    
+    projects = Cashboard::Project.list
+    assert projects.size > 0
+    projects.each do |prj|
+      assert_kind_of Cashboard::Project, prj
+    end
+  end
+  
+  def test_create_success
+    FakeWeb.register_uri(
+      :post,
+      url_with_auth("/#{Cashboard::Project.resource_name}"),
+      :status => ["201", "Created"],
+      :body => Cashboard::Project.list[0].to_xml
+    ) if MOCK_WEB_CONNECTIONS  
+    
+    client = Cashboard::ClientCompany.list[0]
+    # Create random project name so even if not destroyed on 
+    # a live connection we don't run into duplicate name validation errors.
+    project_name = "Test project - " + generate_random_string
+    assert_nothing_raised do
+      project = Cashboard::Project.create(
+        :name => project_name, 
+        :client_id => client.id,
+        :client_type => 'Company'
+      )
+      assert_kind_of Cashboard::Project, project
+    end
+  end
+  
+  def test_create_fail
+    FakeWeb.register_uri(
+      :post,
+      url_with_auth("/#{Cashboard::Project.resource_name}"),
+      :status => ["400", "Bad Request"],
+      :body => GENERIC_ERROR_XML
+    ) if MOCK_WEB_CONNECTIONS  
+    
+    assert_raise Cashboard::BadRequest do
+      prj = Cashboard::Project.create()
+    end
+  end
+  
+  def test_update_success
+    prj = Cashboard::Project.list[0]
+    
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth(prj.href), 
+      :status => ["200", "Ok"],
+      :body => prj.to_xml
+    ) if MOCK_WEB_CONNECTIONS
+    
+    prj.name = 'Some new name'
+    assert prj.update, "Project didn't save properly"
+  end
+  
+  def test_update_fail
+    prj = Cashboard::Project.list[0]
+    
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth(prj.href), 
+      :status => ["400", "Bad Request"],
+      :body => GENERIC_ERROR_XML
+    ) if MOCK_WEB_CONNECTIONS
+    
+    prj.name = 'Some new name'
+    assert !prj.update, "Project saved when it shouldn't have"
+  end
+  
+  def test_delete_success
+    prj = Cashboard::Project.list[0]
+    
+    FakeWeb.register_uri(
+      :delete, 
+      url_with_auth(prj.href), 
+      :status => ["200", "Ok"]
+    ) if MOCK_WEB_CONNECTIONS
+
+    assert prj.delete, "Project wasn't deleted."
+  end
+  
+  def test_delete_fail
+    prj = Cashboard::Project.list[0]
+    
+    FakeWeb.register_uri(
+      :delete, 
+      url_with_auth(prj.href), 
+      :status => ["404", "Not found"]
+    ) if MOCK_WEB_CONNECTIONS
+
+    assert !prj.delete, "Project was deleted when it shouldn't have been."
+  end
+  
+  def test_toggle_status_success
+    prj = Cashboard::Project.list[0]
+    assert_equal false, prj.is_active
+    
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth(prj.links[:toggle_status]), 
+      :status => ["200", "Ok"]
+    ) if MOCK_WEB_CONNECTIONS
+    
+    initial_status = prj.is_active
+    
+    assert prj.toggle_status
+    assert true, prj.is_active
+  end
+  
+  def test_toggle_status_failure
+    prj = Cashboard::Project.list[0]
+        
+    FakeWeb.register_uri(
+      :put, 
+      url_with_auth(prj.links[:toggle_status]), 
+      :status => ["401", "Unauthorized"]
+    ) if MOCK_WEB_CONNECTIONS
+    
+    initial_status = prj.is_active
+    
+    assert !prj.toggle_status
+    assert prj.is_active == initial_status
+  end
+
+  def test_employee_project_assignments
+    mock_sub_resource(
+      Cashboard::Project.resource_name, 
+      'assigned_employees',
+      'project_assignments'
+    ) if MOCK_WEB_CONNECTIONS
+    
+    prj = Cashboard::Project.list[0]
+    assignments = prj.employee_project_assignments
+    assert assignments.size > 0
+    assignments.each do |assn|
+      assert_kind_of Cashboard::ProjectAssignment, assn
+    end
+  end
+  
+  def test_line_items
+    mock_sub_resource(
+      Cashboard::Project.resource_name, 
+      'line_items',
+      'line_items'
+    ) if MOCK_WEB_CONNECTIONS
+    
+    prj = Cashboard::Project.list[0]
+    line_items = prj.line_items
+    assert line_items.size > 0
+    line_items.each do |li|
+      assert_kind_of Cashboard::LineItem, li
+    end
+  end
+  
+  def test_tasks
+    assert_list_type :tasks, :task
+  end
+  
+  def test_products
+    assert_list_type :products, :product
+  end
+  
+  def test_custom_items
+    assert_list_type :custom_items, :custom
+  end
+  
+  def test_href
+    assert Cashboard::Project.list[0].href.include?(Cashboard::Base.api_url)
+  end
+  
+end