qbfc 0.3.0

data/spec/integration/add_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe "QBFC::Customer.new" do
+    
+  before(:each) do 
+    @integration = QBFC::Integration.new
+    @sess = @integration.session
+  end
+  
+  after(:each) do 
+    @integration.close
+  end
+  
+  it "should create a new customer" do
+    old_count = @sess.customers.find(:all).length
+
+    c = @sess.customers.new
+    c.name = "Cranky Customer"
+    c.is_active = true
+    c.last_name = "McCustomer"
+    c.save
+    
+    n = @sess.customers.find("Cranky Customer")
+    n.name.should == "Cranky Customer"
+    n.is_active.should be(true)
+    n.last_name.should == "McCustomer"
+    
+    @sess.customers.find(:all).length.should == old_count + 1
+  end
+  
+end

data/spec/integration/base_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe QBFC::Base do
+
+  before(:each) do 
+    @integration = QBFC::Integration::reader
+    @sess = @integration.session
+  end
+  
+  after(:each) do 
+    @integration.close
+  end
+  
+  it "should do nothing" do
+    true.should be_true
+  end
+  
+end

data/spec/integration/belongs_to_spec.rb

@@ -0,0 +1,64 @@
+require 'spec_helper'
+
+# This spec describes "belong to" style relationships,
+# that is where QuickBooks specifies a Ref to another object.
+
+describe "belongs to: " do
+
+  before(:each) do 
+    @integration = QBFC::Integration::reader
+    @sess = @integration.session
+  end
+  
+  after(:each) do 
+    @integration.close
+  end
+  
+  describe "Bob Customer" do
+    before(:each) do
+      @customer = @sess.customers.find("Bob Customer")
+    end
+  
+    it "has terms" do
+      @customer.terms.should be_kind_of(QBFC::Terms)
+      @customer.terms.id.should == @sess.terms.find("Net 30").id
+    end
+    
+    it "should not have a sales rep" do
+      @customer.sales_rep.should be_nil
+    end
+  end
+  
+  describe "Check to ABC Supplies" do
+    before(:each) do
+      @check = @sess.checks.find_by_ref("1000")
+    end
+  
+    it "has a payee" do
+      @check.payee.should be_kind_of(QBFC::Vendor)
+      @check.payee.id.should == @sess.vendors.find("ABC Supplies").id
+    end
+    
+    it "has an account" do
+      @check.account.should be_kind_of(QBFC::Account)
+      @check.account.id.should == @sess.accounts.find("Checking").id
+    end
+  end
+  
+  describe "Invoice to Customer Bob" do
+    before(:each) do
+      @invoice = @sess.invoices.find_by_ref("1")
+    end
+  
+    it "has a template" do
+      @invoice.template.should be_kind_of(QBFC::Template)
+      @invoice.template.id.should == @sess.templates.find("Intuit Service Invoice").id
+    end
+    
+    it "has a Customer" do
+      @invoice.customer.should be_kind_of(QBFC::Customer)
+      @invoice.customer.id.should == @sess.customers.find("Bob Customer").id
+    end
+  end
+  
+end

data/spec/integration/company_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe "QBFC::Company" do
+
+  before(:each) do 
+    @integration = QBFC::Integration::reader
+    @sess = @integration.session
+    @company = @sess.company
+  end
+  
+  after(:each) do 
+    @integration.close
+  end
+
+  it "should get name" do
+    @company.company_name.should == "Test Company"
+  end
+  
+  it "should get address" do
+    @company.address.addr1.should == "123 Address St"
+    @company.address.city.should == "Oklahoma City"
+    @company.address.state.should == "OK"
+    @company.address.postal_code.should == "73160"
+  end
+  
+  it "should get phone" do
+    @company.phone.should == "(555) 555-1212"
+  end
+
+end

data/spec/integration/conditions_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+# This spec describes use of the :conditions option to Element.find
+# The implementation that this tests is Request#apply_options
+
+describe "conditions: " do
+
+  before(:each) do 
+    @integration = QBFC::Integration::reader
+    @sess = @integration.session
+  end
+  
+  after(:each) do 
+    @integration.close
+  end
+  
+  describe "Check" do
+    it "should limit records returned" do
+      checks = @sess.checks.find(:all, :limit => 2)
+      checks.length.should == 2
+    end
+    
+    it "should filter on date range" do
+      @sess.checks.find(:all, :conditions => {:txn_date_range => '2008-02-23'..'2008-02-25'}).length.should == 1
+      @sess.checks.find(:all, :conditions => {:txn_date_range => '2008-02-26'}).length.should == 3
+      @sess.checks.find(:all, :conditions => {:txn_date_range => Date.parse('2008-02-26')}).length.should == 3
+    end
+    
+    it "should filter on modified time" do
+      @sess.checks.find(:all, :conditions => {:modified_date_range => '2008-02-23'..'2008-02-25'}).length.should == 1
+      @sess.checks.find(:all, :conditions => {:modified_date_range => '2008-02-26'}).length.should == 3
+      @sess.checks.find(:all, :conditions => {:modified_date_range => Date.parse('2008-02-26')}).length.should == 3
+    end
+    
+    it "should filter on ref number criteria" do
+      checks = @sess.checks.find(:all, :conditions => {:ref_number_list => %w{1000 1002}})
+      checks.length.should == 2
+      checks[0].ref_number.should == '1000'
+      checks[1].ref_number.should == '1002'
+    end
+    
+    it "should filter on ref number range" do
+      @sess.checks.find(:all, :conditions => {:ref_number_range => '1000'..'1001'}).length.should == 2
+      @sess.checks.find(:all, :conditions => {:ref_number_range => 1000..1001}).length.should == 2
+      @sess.checks.find(:all, :conditions => {:ref_number_range => '1003'}).length.should >= 1
+    end
+    
+    it "should filter on Entity" do
+      @sess.checks.find(:all, :conditions => {:entity => 'ABC Supplies'}).length.should >= 2
+      @sess.checks.find(:first, :conditions => {:entity => 'Computer Shop'}).ref_number.should == '1002'
+    end
+    
+    it "should filter on Account" do
+      @sess.checks.find(:all, :conditions => {:account => 'Checking'}).length.should >= 4
+      @sess.checks.find(:all, :conditions => {:account => 'Accounts Receivable'}).length.should == 0
+    end
+  end
+  
+end

data/spec/integration/customer_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+
+describe "QBFC::Customer" do
+
+  before(:each) do 
+    @integration = QBFC::Integration::reader
+    @sess = @integration.session
+    @bob = @sess.customers.find_by_name("Bob Customer")
+    @sue = @sess.customers.find_by_name("Sue Customer")
+  end
+  
+  after(:each) do 
+    @integration.close
+  end
+
+  it "should get name" do
+    @bob.name.should == "Bob Customer"
+    @sue.name.should == "Sue Customer"
+
+    @bob.full_name.should == "Bob Customer"
+    @sue.full_name.should == "Sue Customer"
+  end
+  
+end
+
+describe "QBFC::Customer(setters)" do
+    
+  before(:each) do 
+    @integration = QBFC::Integration.new
+    @sess = @integration.session
+    @bob = @sess.customers.find_by_name("Bob Customer")
+  end
+  
+  after(:each) do 
+    @integration.close
+  end
+  
+  it "should set name" do
+    new_name = "New Customer"
+    @bob.name = new_name
+    @bob.name.should == new_name
+    @bob.save
+    
+    @sess.customers.find(new_name).name.should == new_name
+  end
+end

data/spec/integration/element_finders_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe "QBFC::Element(finders)" do
+
+  before(:each) do 
+    @integration = QBFC::Integration::reader
+    @sess = @integration.session
+  end
+  
+  after(:each) do 
+    @integration.close
+  end
+  
+  it "should return a subclass of a base_class (e.g. Entity)" do
+    entity = QBFC::Entity.find(@sess, "Bob Customer")
+    entity.should be_kind_of(QBFC::Customer)
+    entity.name.should == "Bob Customer"
+  end
+  
+end

data/spec/integration/quick_test.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+# This spec describes use of the :conditions option to Element.find
+# The implementation that this tests is Request#apply_options
+
+def run_test
+          @sess.report('ProfitAndLossStandard',
+            :conditions => {
+              :report_date_range => [Date.parse("2007-08-01"), Date.parse("2007-08-31")]},
+            :report_basis => QBFC_CONST::RbAccrual)
+end
+
+# Setup
+use_open = true
+
+if use_open
+  @sess = QBFC::Session.new
+else
+  @integration = QBFC::Integration::reader
+  @sess = @integration.session
+end
+
+begin
+  puts run_test
+ensure
+  if use_open
+    @sess.close
+  else
+    @integration.close
+  end
+end

data/spec/integration/request_options_spec.rb

@@ -0,0 +1,68 @@
+require 'spec_helper'
+
+# This spec describes use of the options to Element.find
+# (except :conditions, which is in conditions_spec.rb)
+# The implementation that this tests is Request#apply_options
+
+describe "Request options: " do
+
+  before(:each) do 
+    @integration = QBFC::Integration::reader
+    @sess = @integration.session
+  end
+  
+  after(:each) do 
+    @integration.close
+  end
+  
+  describe "Invoice" do
+    def assert_line_items(inv)
+      inv.ORInvoiceLineRetList[0].InvoiceLineRet.desc == "First Line"
+      inv.ORInvoiceLineRetList[1].InvoiceLineRet.desc == "Second Line"
+      inv.ORInvoiceLineRetList[2].InvoiceLineRet.desc == "3rd Line"
+    end
+    
+    def assert_linked_txns(inv)
+      inv.LinkedTxnList[0].ref_number.should == '1972'
+      inv.LinkedTxnList[0].amount.should == -300.00   
+    end
+  
+    it "should include line items" do
+      inv = @sess.invoices.find_by_ref('2', :include => [:line_items])
+      assert_line_items(inv)
+    end
+    
+    it "should include linked txns" do
+      inv = @sess.invoices.find_by_ref('2', :include => [:linked_txns])
+      assert_linked_txns(inv)
+    end
+    
+    it "should include include all (line items and linked txns)" do
+      inv = @sess.invoices.find_by_ref('2', :include => [:all])
+      assert_line_items(inv)
+      assert_linked_txns(inv)
+    end
+    
+    it "should include a subset of elements" do
+      inv = @sess.invoices.find_by_ref('2',
+          :include => [:txn_id, :customer_ref, :bill_address])
+      inv.txn_id.should_not be_nil
+      inv.customer_ref.full_name.should_not be_nil
+      inv.bill_address.addr1.should_not be_nil
+      
+      inv.ref_number.should be_nil
+      inv.class_ref.should be_nil
+      inv.bill_address_block.should be_nil
+    end
+    
+    it "should only txn_id" do
+      inv = @sess.invoices.find_by_ref('2',
+          :include => [:txn_id])
+      inv.txn_id.should_not be_nil
+
+      inv.customer_ref.should be_nil
+      inv.bill_address.should be_nil
+    end
+  end
+  
+end

data/spec/rcov.opts

@@ -0,0 +1 @@
+--exclude "spec/*,gems/*" 

data/spec/spec.opts

@@ -0,0 +1,6 @@
+--colour
+--format
+progress
+--loadby
+mtime
+--reverse

data/spec/spec_helper.rb

@@ -0,0 +1,62 @@
+require 'rubygems'
+require 'spec'
+require 'qbfc'
+
+Spec::Runner.configure do |config|
+
+end
+
+module QBFC
+  class Integration
+    FIXTURE_DIRNAME = File.dirname(__FILE__) + "\\fixtures"
+    FIXTURE_FILENAME = FIXTURE_DIRNAME + "\\test.qbw"
+    TMP_DIRNAME = File.dirname(__FILE__) + "\\tmp"
+    
+    class << self
+      def reader
+        @@reader ||= new(true)
+        @@reader.open_sess
+        @@reader
+      end
+    end
+
+    def initialize(is_reader = false)
+      FileUtils.mkdir_p(TMP_DIRNAME)
+
+      @is_reader = is_reader
+      @@i ||= 0
+      @@i += 1
+      @dirname = TMP_DIRNAME + "\\fixture_#{@@i}"
+      FileUtils.rm_rf(@dirname)
+      FileUtils.mkdir_p(@dirname)
+      
+      ['lgb', 'qbw', 'qbw.ND', 'qbw.TLG'].each do |ext|
+        FileUtils.cp FIXTURE_DIRNAME + "\\test.#{ext}", @dirname
+      end
+      
+      open_sess
+    end
+    
+    def filename
+      File.expand_path(@dirname + "\\test.qbw").gsub(/\//, "\\")
+    end
+    
+    def open_sess
+      @sess = QBFC::Session.new(:filename => filename)
+    end
+    
+    def session
+      @sess
+    end
+    
+    def close
+      @sess.close
+      sleep(1)
+      unless @is_reader
+        sleep(3)
+        FileUtils.rm_rf(@dirname) 
+      end
+    end
+  end
+
+end