kashflow_api 0.0.1pre

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+spec/test_data.yml

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in kashflow_api.gemspec
+gemspec

data/README.markdown

@@ -0,0 +1,35 @@
+# KashflowApi
+
+KashflowApi provides an Active Record like interface to the Kashflow API.
+
+# Usage
+
+At the beginning of your program, or in an rails initializer call the configure block like so:
+
+    KashflowApi.configure do |c|
+        c.username = "Username"
+		c.password = "Password"
+		c.loggers = false
+	end
+	
+I recommend settings loggers to false so that you don't get all the soap exchanges echoed out.
+
+You can now call methods on the models e.g.
+
+	KashflowApi::Customer.all
+
+# Unimplemented Methods
+
+Some of the methods in the Kashflow API have not been implemented in this gem (yet)
+
+## Customers
+
+* GetCustomersModifiedSince
+* GetCustomerSources
+* GetCustomerVATNumber
+* SetCustomerVATNumber
+* GetCustomerCurrency
+* SetCustomerCurrency
+* GetCustomerAdvancePayments
+
+## Quotes

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/kashflow_api.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "kashflow_api/version"
+
+Gem::Specification.new do |s|
+  s.name        = "kashflow_api"
+  s.version     = KashflowApi::VERSION
+  s.authors     = ["Adam \"Arcath\" Laycock"]
+  s.email       = ["gems@arcath.net"]
+  s.homepage    = ""
+  s.summary     = %q{Provides an interface for the Kashflow API}
+  s.description = s.summary
+
+  s.rubyforge_project = "kashflow_api"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  # Development Dependencies
+  s.add_development_dependency "rspec"
+  
+  # Runtime Dependencies
+  s.add_runtime_dependency "savon"
+end

data/lib/kashflow_api/api.rb

@@ -0,0 +1,29 @@
+module KashflowApi
+    class Api        
+        def initialize
+            unless KashflowApi.config.username && KashflowApi.config.password
+               raise "Username and Password required" 
+            end
+        end
+        
+        def self.methods
+            @methods ||= generate_method_list
+        end
+        
+        # Main Handler
+        def method_missing(method, argument = nil)
+            methods = KashflowApi.api_methods
+            if methods.include?(method)
+                KashflowApi::ApiCall.new(method, argument).result
+            else
+                super
+            end
+        end
+        
+        private
+        
+        def self.generate_method_list
+            KashflowApi.client.client.wsdl.soap_actions
+        end
+    end
+end

data/lib/kashflow_api/api_call.rb

@@ -0,0 +1,102 @@
+module KashflowApi
+    class ApiCall
+        attr_reader :result, :xml, :method
+        
+        def initialize(method, argument)
+            set_method(method)
+            build_xml(argument)
+            raise xml if @raise
+            @result = make_call
+        end
+        
+        private
+        
+        def xml_header
+            "<?xml version=\"1.0\" encoding=\"utf-8\"?>
+            <soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">
+            <soap:Body>\n"
+        end
+        
+        def xml_footer
+            "</soap:Body>
+            </soap:Envelope>"
+        end
+        
+        def set_method(method)
+            words = method.to_s.split("_")
+            words.map { |word| word.capitalize! }
+            @action = words.first.downcase
+            @object = words[1].downcase
+            words[words.count - 1] = words.last.upcase if words.last == "Id"
+            @field = words.last
+            @field = "Code" if method == :get_customer || @field == "Balance" || method == :get_supplier
+            @method = words.join
+        end
+        
+        def build_xml(argument)
+            @xml = xml_header
+            @xml += "<#{@method} xmlns=\"KashFlow\">\n"
+            @xml += user_details
+            @xml += argument_xml(argument)
+            @xml += "</#{@method}>\n"
+            @xml += xml_footer
+        end
+        
+        def user_details
+            "<UserName>#{KashflowApi.config.username}</UserName>
+            <Password>#{KashflowApi.config.password}</Password>\n"
+        end
+        
+        def make_call
+            KashflowApi.client.call(self)
+        end
+        
+        def argument_xml(argument)
+            out = ""
+            if argument
+                if @action == "get"
+                    if @object == "customer" 
+                        out = "<Customer#{@field}>#{argument}</Customer#{@field}>"
+                    elsif @object == "customers"
+                        out = "<#{@field}>#{argument}</#{@field}>"
+                    elsif @object == "quote"
+                        out = "<Quote#{@field}>#{argument}</Quote#{@field}>"
+                    elsif @object == "supplier"
+                        out = "<Supplier#{@field}>#{argument}</Supplier#{@field}>"
+                    elsif @object == "receipt"
+                        out = "<ReceiptNumber>#{argument}</ReceiptNumber>"
+                    elsif @object == "invoice"
+                        out = "<InvoiceNumber>#{argument}</InvoiceNumber>"
+                    end
+                elsif @action == "update" || @action == "insert"
+                    if @object == "customer"
+                        out = "<custr>#{argument.to_xml}</custr>"
+                    elsif @object == "supplier"
+                        if @action == "insert"
+                            out = "<supl>#{argument.to_xml}</supl>"
+                        else
+                            out = "<sup>#{argument.to_xml}</sup>"
+                        end
+                    elsif @object == "receipt"
+                        if @field == "Line"
+                            out = "<ReceiptID>#{argument.receiptid}</ReceiptID><InvLine>#{argument.to_xml}</InvLine>"
+                        else
+                            out = "<Inv>#{argument.to_xml}</Inv>"
+                        end
+                    elsif @object == "invoice"
+                        if @field == "Line"
+                            out = "<InvoiceID>#{argument.invoiceid}</InvoiceID><InvLine>#{argument.to_xml}</InvLine>"
+                        else
+                            out = "<Inv>#{argument.to_xml}</Inv>"
+                        end
+                    end
+                elsif @action == "delete"
+                    if @object == "customer"
+                        out = "<CustomerID>#{argument}</CustomerID>"
+                    end
+                end
+            end
+            out
+        end
+    end
+end

data/lib/kashflow_api/client.rb

@@ -0,0 +1,25 @@
+module KashflowApi
+    class Client
+        def initialize(config)
+            @config = config
+            @url = "https://securedwebapp.com/api/service.asmx?WSDL"
+            
+            @client = Savon::Client.new @url
+        end
+        
+        def call(api_call)
+            result = @client.request("KashFlow/#{api_call.method}") do |soap|
+                soap.xml = api_call.xml
+            end
+            raise "Incorrect username or password" if result.to_hash.first.last[:status_detail] == "Incorrect username or password"
+            raise "Your IP Address is not in the access list!" if result.to_hash.first.last[:status_detail] =~ /The IP address of .*? is not in the access list/
+            #raise api_call.xml if result.to_hash.first.last[:status] == "NO"
+            raise "Kashflow Error: #{result.to_hash.first.last[:status_detail]}" if result.to_hash.first.last[:status] == "NO"
+            return result
+        end
+        
+        def client
+            @client
+        end
+    end
+end

data/lib/kashflow_api/config.rb

@@ -0,0 +1,14 @@
+module KashflowApi
+    class Config
+        attr_accessor :username, :password
+        
+        def initialize
+            @loggers = true
+        end
+        
+        def loggers=(i)
+            HTTPI.log = i
+            Savon.log = i
+        end
+    end
+end

data/lib/kashflow_api/models/customer.rb

@@ -0,0 +1,85 @@
+module KashflowApi
+    class Customer < KashflowApi::SoapObject    
+        def self.find(search)
+            self.find_by_customer_code(search)
+        end
+        
+        def self.find_by_customer_code(search)
+            result = KashflowApi.api.get_customer(search)
+            self.build_from_soap(result.basic_hash["soap:Envelope"]["soap:Body"]["GetCustomerResponse"]["GetCustomerResult"])
+        end
+        
+        def self.find_by_customer_id(search)
+            result = KashflowApi.api.get_customer_by_id(search)
+            self.build_from_soap(result.basic_hash["soap:Envelope"]["soap:Body"]["GetCustomerByIDResponse"]["GetCustomerByIDResult"])
+        end
+        
+        def self.find_by_customer_email(search)
+            result = KashflowApi.api.get_customer_by_email(search)
+            self.build_from_soap(result.basic_hash["soap:Envelope"]["soap:Body"]["GetCustomerByEmailResponse"]["GetCustomerByEmailResult"])
+        end
+        
+        def self.find_by_postcode(search)
+            result = KashflowApi.api.get_customers_by_postcode(search)
+            self.build_from_soap(result.basic_hash["soap:Envelope"]["soap:Body"]["GetCustomersByPostcodeResponse"]["GetCustomersByPostcode"])
+        end
+        
+        def self.all
+            result = KashflowApi.api.get_customers
+            customers = []
+            result.basic_hash["soap:Envelope"]["soap:Body"]["GetCustomersResponse"]["GetCustomersResult"]["Customer"].each do |customer|
+                customers.push self.build_from_soap customer
+            end
+            customers
+        end
+        
+        def save
+           if @hash["CustomerID"] == "0"
+               insert_customer
+           else
+               update_customer
+           end 
+        end
+        
+        def destroy
+            KashflowApi.api.delete_customer(self.customerid)
+        end
+        
+        def balance
+            KashflowApi::CustomerBalance.new(self)
+        end
+        
+        def to_xml
+            xml = []
+            id_line = ""
+            @hash.keys.each do |key|
+                if key == "CustomerID"
+                    id_line = "<#{key}>#{@hash[key]}</#{key}>" unless @hash[key] == "0"
+                else
+                    xml.push("<#{key}>#{@hash[key]}</#{key}>")
+                end
+            end
+            [id_line, xml.join].join
+        end
+        
+        private
+        
+        def blank_object_hash
+            {"Code" => "", "Name" => "", "Contact" => "", "Telephone" => "", "Mobile" => "", "Fax" => "", "Email" => "", "Address1" => "", "Address2" => "",
+                "Address3" => "", "Address4" => "", "Postcode" => "", "Website" => "", "Notes" => "", "ExtraText1" => "", "ExtraText2" => "",
+                "ExtraText3"  => "", "ExtraText4" => "", "ExtraText5" => "", "ExtraText6" => "", "ExtraText7" => "", "ExtraText8" => "", "ExtraText9"  => "",
+                "ExtraText10" => "", "ExtraText11" => "", "ExtraText12" => "", "ExtraText13" => "", "ExtraText14" => "", "ExtraText15" => "",
+                "ExtraText16" => "", "ExtraText17" => "", "ExtraText18" => "", "ExtraText19" => "", "ExtraText20" => "", "ContactTitle" => "",
+                "ContactFirstName" => "", "ContactLastName" => "", "CustHasDeliveryAddress" => "0", "DeliveryAddress1" => "",
+                "DeliveryAddress2" => "", "DeliveryAddress3" => "", "DeliveryAddress4" => "", "DeliveryPostcode"  => ""}.merge(KashflowApi::Customer.find("").hash)
+        end
+        
+        def update_customer
+            KashflowApi.api.update_customer(self)
+        end
+        
+        def insert_customer
+            KashflowApi.api.insert_customer(self)
+        end
+    end
+end

data/lib/kashflow_api/models/customer_balance.rb

@@ -0,0 +1,12 @@
+module KashflowApi
+    class CustomerBalance
+        attr_reader :customer, :value, :balance
+        
+        def initialize(customer)
+            result = KashflowApi.api.get_customer_balance(customer.code)
+            @customer = customer
+            @value = result.basic_hash["soap:Envelope"]["soap:Body"]["GetCustomerBalanceResponse"]["GetCustomerBalanceResult"]["Value"].to_f
+            @balance = result.basic_hash["soap:Envelope"]["soap:Body"]["GetCustomerBalanceResponse"]["GetCustomerBalanceResult"]["Balance"].to_f
+        end
+    end
+end

data/lib/kashflow_api/models/invoice.rb

@@ -0,0 +1,47 @@
+module KashflowApi
+    class Invoice < KashflowApi::SoapObject
+        def self.find(search)
+            result = KashflowApi.api.get_invoice(search)
+            self.build_from_soap(result.basic_hash["soap:Envelope"]["soap:Body"]["GetInvoiceResponse"]["GetInvoiceResult"])
+        end
+        
+        def customer
+            KashflowApi::Customer.find_by_customer_id(self.customerid)
+        end
+        
+        def save
+            if @hash["InvoiceDBID"] == "0"
+                insert_invoice
+            else
+                update_invoice
+            end
+        end
+        
+        def to_xml
+            xml = []
+            id_line = ""
+            @hash.keys.each do |key|
+                if key == "InvoiceDBID"
+                    id_line = "<#{key}>#{@hash[key]}</#{key}>" unless @hash[key] == "0"
+                else
+                    xml.push("<#{key}>#{@hash[key]}</#{key}>")
+                end
+            end
+            [id_line, xml.join].join
+        end
+        
+        private
+        
+        def blank_object_hash
+            { "InvoiceNumber" => "", "InvoiceDate" => "", "DueDate" => "", "CustomerID" => "", "CustomerReference" => "", "InvoiceDBID" => "0" }
+        end
+        
+        def update_invoice
+            KashflowApi.api.update_invoice(self)
+        end
+
+        def insert_invoice
+            KashflowApi.api.insert_invoice(self)
+        end
+    end
+end

data/lib/kashflow_api/models/line.rb

@@ -0,0 +1,38 @@
+module KashflowApi
+    class Line < KashflowApi::SoapObject
+        def save
+            if @hash["ReceiptID"] != ""
+                insert_receipt_line
+            elsif @hash["InvoiceID"] != ""
+                insert_invoice_line
+            end
+        end
+        
+        def to_xml
+            xml = []
+            id_line = ""
+            @hash.keys.each do |key|
+                if key == "LineID"
+                    id_line = "<#{key}>#{@hash[key]}</#{key}>" unless @hash[key] == "0"
+                elsif key != "ReceiptID" && key != "InvoiceID" && @hash[key] != ""
+                    xml.push("<#{key}>#{@hash[key]}</#{key}>")
+                end
+            end
+            [id_line, xml.join].join
+        end
+        
+        private
+        
+        def blank_object_hash
+            {"Quantity" => "", "Description" => "", "ChargeType" => "", "VatAmount" => "", "VatRate" => "", "Rate" => "", "ReceiptID" => "", "InvoiceID" => "" }
+        end
+        
+        def insert_receipt_line
+            KashflowApi.api.insert_receipt_line(self)
+        end
+        
+        def insert_invoice_line
+            KashflowApi.api.insert_invoice_line(self)
+        end
+    end
+end

data/lib/kashflow_api/models/nominal_code.rb

@@ -0,0 +1,12 @@
+module KashflowApi
+    class NominalCode < KashflowApi::SoapObject  
+        def self.all
+            result = KashflowApi.api.get_nominal_codes
+            codes = []
+            result.basic_hash["soap:Envelope"]["soap:Body"]["GetNominalCodesResponse"]["GetNominalCodesResult"]["NominalCode"].each do |code|
+                codes.push(self.build_from_soap(code))
+            end
+            codes
+        end
+    end
+end

data/lib/kashflow_api/models/quote.rb

@@ -0,0 +1,14 @@
+module KashflowApi
+    class Quote < KashflowApi::Invoice
+        def self.find_by_id(search)
+            result = KashflowApi.api.get_quote_by_id(search)
+            self.build_from_soap(result.basic_hash["soap:Envelope"]["soap:Body"]["GetQuoteByIDResponse"]["GetQuoteByIDResult"])
+        end
+        
+        private
+        
+        def blank_object_hash
+            {}.merge(KashflowApi::Quote.find_by_id("0").hash)
+        end
+    end
+end

data/lib/kashflow_api/models/receipt.rb

@@ -0,0 +1,43 @@
+module KashflowApi
+    class Receipt < KashflowApi::SoapObject
+            def self.find(search)
+                result = KashflowApi.api.get_receipt(search)
+                self.build_from_soap(result.basic_hash["soap:Envelope"]["soap:Body"]["GetReceiptResponse"]["GetReceiptResult"])
+            end
+
+            def save
+                if @hash["InvoiceDBID"] == "0"
+                    insert_receipt
+                else
+                    update_receipt
+                end
+            end
+
+            def to_xml
+                xml = []
+                id_line = ""
+                @hash.keys.each do |key|
+                    if key == "InvoiceDBID"
+                        id_line = "<#{key}>#{@hash[key]}</#{key}>" unless @hash[key] == "0"
+                    else
+                        xml.push("<#{key}>#{@hash[key]}</#{key}>")
+                    end
+                end
+                [id_line, xml.join].join
+            end
+
+            private
+
+            def blank_object_hash
+                { "InvoiceNumber" => "", "InvoiceDate" => "", "DueDate" => "", "CustomerID" => "", "CustomerReference" => "", "InvoiceDBID" => "0" }
+            end
+            
+            def update_receipt
+                KashflowApi.api.update_receipt(self)
+            end
+
+            def insert_receipt
+                KashflowApi.api.insert_receipt(self)
+            end
+    end
+end

data/lib/kashflow_api/models/supplier.rb

@@ -0,0 +1,62 @@
+module KashflowApi
+    class Supplier < KashflowApi::SoapObject
+        def self.find(search)
+            self.find_by_supplier_code(search)
+        end
+        
+        def self.find_by_supplier_code(search)
+            result = KashflowApi.api.get_supplier(search)
+            self.build_from_soap(result.basic_hash["soap:Envelope"]["soap:Body"]["GetSupplierResponse"]["GetSupplierResult"])
+        end
+        
+        def self.find_by_supplier_id(search)
+            result = KashflowApi.api.get_supplier_by_id(search)
+            self.build_from_soap(result.basic_hash["soap:Envelope"]["soap:Body"]["GetSupplierByIDResponse"]["GetSupplierByIDResult"])
+        end
+        
+        def self.all
+            result = KashflowApi.api.get_suppliers
+            suppliers = []
+            result.basic_hash["soap:Envelope"]["soap:Body"]["GetSuppliersResponse"]["GetSuppliersResult"]["Supplier"].each do |supplier|
+                suppliers.push self.build_from_soap supplier
+            end
+            suppliers.sort { |x, y| x.name <=> y.name }
+        end
+        
+        def save
+           if @hash["SupplierID"] == "0"
+               insert_supplier
+           else
+               update_supplier
+           end 
+        end
+        
+        def to_xml
+            xml = []
+            id_line = ""
+            @hash.keys.each do |key|
+                if key == "SupplierID"
+                    id_line = "<#{key}>#{@hash[key]}</#{key}>" unless @hash[key] == "0"
+                else
+                    xml.push("<#{key}>#{@hash[key]}</#{key}>")
+                end
+            end
+            [id_line, xml.join].join
+        end
+        
+        private
+        
+        def blank_object_hash
+            {"Code" => "", "Name" => "", "Contact" => "", "Telephone" => "", "Mobile" => "", "Fax" => "", "Email" => "", "Address1" => "", "Address2" => "",
+                "Address3" => "", "Address4" => "", "Postcode" => "", "Website" => "", "VATNumber" => "", "Notes" => ""}.merge(KashflowApi::Supplier.find("").hash)
+        end
+        
+        def update_supplier
+            KashflowApi.api.update_supplier(self)
+        end
+        
+        def insert_supplier
+            KashflowApi.api.insert_supplier(self)
+        end
+    end
+end

data/lib/kashflow_api/soap_object.rb

@@ -0,0 +1,40 @@
+module KashflowApi
+    class SoapObject
+        attr_accessor :hash
+        
+        def initialize(hash = nil)
+            if hash
+                @hash = hash
+                build_field_hash
+            else
+                @hash = blank_object_hash
+                build_field_hash
+            end
+        end
+        
+        def method_missing(method, set = nil)
+            if @fields.keys.include? method
+                @hash[@fields[method]]
+            elsif method.to_s.scan(/.$/).join == "="
+                if @fields.keys.include? method.to_s.gsub(/\=/,'').to_sym
+                    @hash[@fields[method.to_s.gsub(/\=/,'').to_sym]] = set
+                end
+            else
+                super
+            end
+        end
+        
+        def self.build_from_soap(hash)
+            self.new(hash)
+        end
+        
+        private
+        
+        def build_field_hash
+            @fields = {}
+            @hash.keys.each do |key|
+                @fields[key.downcase.to_sym] = key
+            end
+        end
+    end
+end

data/lib/kashflow_api/version.rb

@@ -0,0 +1,3 @@
+module KashflowApi
+  VERSION = "0.0.1pre"
+end

data/lib/kashflow_api.rb

@@ -0,0 +1,44 @@
+# Gems
+require "savon"
+# Kashflow Main Clases
+require "kashflow_api/soap_object"      # Soap Object Class
+require "kashflow_api/config"           # Config Class
+# Kashflow Api Modules & Classes
+require "kashflow_api/api"              # Api Class
+require "kashflow_api/api_call"         # ApiCall Class
+require "kashflow_api/client"           # Client Class
+# Models
+require "kashflow_api/models/customer"  # Customer Class
+require "kashflow_api/models/customer_balance" # Customer Balance
+require "kashflow_api/models/invoice"   # Invoice Class
+require "kashflow_api/models/line"      # Invoice Line 
+require "kashflow_api/models/nominal_code" # Nominal Code
+require "kashflow_api/models/quote"     # Quote Class
+require "kashflow_api/models/receipt"   # Receipt Class
+require "kashflow_api/models/supplier"  # Supplier
+# Version
+require "kashflow_api/version"
+
+module KashflowApi
+    def self.configure
+        @config = Config.new
+        yield @config
+        @api = Api.new
+    end
+    
+    def self.config
+        @config
+    end
+    
+    def self.api
+        @api
+    end
+    
+    def self.api_methods
+        @api_methods ||= Api.methods
+    end
+    
+    def self.client
+        @client ||= Client.new(@config)
+    end
+end

data/spec/kashflow_api_customer_balance_spec.rb

@@ -0,0 +1,20 @@
+require 'spec/spec_helper'
+# Require the gem
+require 'lib/kashflow_api'
+
+describe KashflowApi::CustomerBalance do
+    before :each do
+        default_config
+    end
+    
+    it "should create a new balance object" do
+       customer = KashflowApi::Customer.find(test_data("customer_code"))
+       customer.balance.should be_a KashflowApi::CustomerBalance 
+    end
+    
+    it "should have a balance and a value" do
+        customer = KashflowApi::Customer.find(test_data("customer_code"))
+        customer.balance.value.should be_a Float
+        customer.balance.balance.should be_a Float
+    end
+end

data/spec/kashflow_api_customer_spec.rb

@@ -0,0 +1,70 @@
+require 'spec/spec_helper'
+# Require the gem
+require 'lib/kashflow_api'
+
+describe KashflowApi::Customer do
+    before :each do
+        default_config
+    end
+    
+    it "should find a customer" do
+        KashflowApi::Customer.find_by_customer_code(test_data("customer_code")).should be_a KashflowApi::Customer
+        KashflowApi::Customer.find(test_data("customer_code")).should be_a KashflowApi::Customer
+    end
+    
+    it "a found customer should have a name" do
+        KashflowApi::Customer.find_by_customer_code(test_data("customer_code")).name.should eq(test_data("customer_name"))
+    end
+    
+    it "should return an array for .all" do
+        all = KashflowApi::Customer.all
+        all.should be_a Array
+        all.first.should be_a KashflowApi::Customer
+    end
+    
+    it "should find a customer by kashflowid" do
+        KashflowApi::Customer.find_by_customer_id(test_data("customer_id")).should be_a KashflowApi::Customer 
+    end
+    
+    it "should find a customer by email" do
+        KashflowApi::Customer.find_by_customer_email(test_data("customer_email")).should be_a KashflowApi::Customer
+    end
+    
+    it "should find a customer by postcode" do
+        KashflowApi::Customer.find_by_postcode(test_data("customer_postcode")).should be_a KashflowApi::Customer
+    end
+    
+    it "should create a blank customer for a new" do
+        customer = KashflowApi::Customer.new
+        customer.should be_a KashflowApi::Customer
+        customer.name.should eq("")
+    end
+    
+    it "should set values" do
+        customer = KashflowApi::Customer.find(test_data("customer_code"))
+        check = customer.name
+        customer.name = "testing"
+        customer.name.should_not eq check
+    end
+    
+    it "should update a customer" do
+       prechange = KashflowApi::Customer.find(test_data("customer_code"))
+       change_back_to = prechange.address2
+       prechange.address2 = "rspec_tests"
+       prechange.save
+       postchange = KashflowApi::Customer.find(test_data("customer_code"))
+       postchange.address2.should eq "rspec_tests"
+       postchange.address2 = change_back_to
+       postchange.save
+    end
+    
+    it "should create a new customer and then destroy it" do
+        customer = KashflowApi::Customer.new
+        customer.name = "Rspec Test School"
+        customer.code = "RSPEC"
+        customer.save
+        search = KashflowApi::Customer.find("RSPEC")
+        search.name.should eq "Rspec Test School"
+        search.destroy
+    end
+end

data/spec/kashflow_api_nominal_codes_spec.rb

@@ -0,0 +1,15 @@
+require 'spec/spec_helper'
+# Require the gem
+require 'lib/kashflow_api'
+
+describe KashflowApi::CustomerBalance do
+    before :each do
+        default_config
+    end
+    
+    it "should find all nominal codes" do
+        all = KashflowApi::NominalCode.all
+        all.should be_a Array
+        all.first.should be_a KashflowApi::NominalCode
+    end
+end

data/spec/kashflow_api_quote_spec.rb

@@ -0,0 +1,14 @@
+require 'spec/spec_helper'
+# Require the gem
+require 'lib/kashflow_api'
+
+describe KashflowApi::Quote do
+    before :each do
+       default_config 
+    end
+    
+    it "should create a blank quote for new" do
+        quote = KashflowApi::Quote.new
+        quote.should be_a KashflowApi::Quote
+    end
+end

data/spec/kashflow_api_spec.rb

@@ -0,0 +1,51 @@
+require 'spec/spec_helper'
+# Require the gem
+require 'lib/kashflow_api'
+
+describe KashflowApi do
+    it "should raise an exception if username and password are not present" do
+        lambda{
+            KashflowApi.configure do |c|
+            end
+        }.should raise_error
+    end
+    
+    it "should take a username and password" do
+        KashflowApi.configure do |c|
+            c.username = "Test"
+            c.password = "test"
+        end
+    end
+    
+    it "should return an array of symbols for .api_methods" do
+        KashflowApi.configure do |c|
+            c.username = "Test"
+            c.password = "test"
+        end
+        
+        KashflowApi.api_methods.should be_a Array
+        KashflowApi.api_methods.first.should be_a Symbol
+    end
+    
+    it "should raise an exception if username and password are wrong" do
+        lambda{
+            KashflowApi.configure do |c|
+                c.username = "Test"
+                c.password = "test"
+                c.loggers = false
+            end
+            
+            KashflowApi::Customer.all
+        }.should raise_error
+    end
+    
+    it "should disable the loggers if requested" do
+        KashflowApi.configure do |c|
+            c.username = "Test"
+            c.password = "test"
+            c.loggers = false
+        end
+        
+        KashflowApi.api_methods
+    end
+end

data/spec/kashflow_api_supplier_spec.rb

@@ -0,0 +1,24 @@
+require 'spec/spec_helper'
+# Require the gem
+require 'lib/kashflow_api'
+
+describe KashflowApi::Supplier do
+    before :each do
+        default_config
+    end
+    
+    it "should find a supplier" do
+        KashflowApi::Supplier.find(test_data("supplier_code")).should be_a KashflowApi::Supplier
+        KashflowApi::Supplier.find_by_supplier_code(test_data("supplier_code")).should be_a KashflowApi::Supplier
+    end
+    
+    it "should return an array for .all" do
+        all = KashflowApi::Supplier.all
+        all.should be_a Array
+        all.first.should be_a KashflowApi::Supplier
+    end
+    
+    it "should find a supplier by kashflowid" do
+        KashflowApi::Supplier.find_by_supplier_id(test_data("supplier_id")).should be_a KashflowApi::Supplier
+    end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,18 @@
+require 'yaml'
+
+
+def default_config
+    KashflowApi.configure do |c|
+        c.username = yaml["username"]
+        c.password = yaml["password"]
+        c.loggers = false
+    end
+end
+
+def yaml
+    @yaml ||= YAML::load(File.open('spec/test_data.yml'))
+end
+
+def test_data(field)
+    @yaml[field]
+end

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification 
+name: kashflow_api
+version: !ruby/object:Gem::Version 
+  hash: 961915968
+  prerelease: 5
+  segments: 
+  - 0
+  - 0
+  - 1
+  - pre
+  version: 0.0.1pre
+platform: ruby
+authors: 
+- Adam "Arcath" Laycock
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-02-17 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: savon
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: Provides an interface for the Kashflow API
+email: 
+- gems@arcath.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.markdown
+- Rakefile
+- kashflow_api.gemspec
+- lib/kashflow_api.rb
+- lib/kashflow_api/api.rb
+- lib/kashflow_api/api_call.rb
+- lib/kashflow_api/client.rb
+- lib/kashflow_api/config.rb
+- lib/kashflow_api/models/customer.rb
+- lib/kashflow_api/models/customer_balance.rb
+- lib/kashflow_api/models/invoice.rb
+- lib/kashflow_api/models/line.rb
+- lib/kashflow_api/models/nominal_code.rb
+- lib/kashflow_api/models/quote.rb
+- lib/kashflow_api/models/receipt.rb
+- lib/kashflow_api/models/supplier.rb
+- lib/kashflow_api/soap_object.rb
+- lib/kashflow_api/version.rb
+- spec/kashflow_api_customer_balance_spec.rb
+- spec/kashflow_api_customer_spec.rb
+- spec/kashflow_api_nominal_codes_spec.rb
+- spec/kashflow_api_quote_spec.rb
+- spec/kashflow_api_spec.rb
+- spec/kashflow_api_supplier_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      hash: 25
+      segments: 
+      - 1
+      - 3
+      - 1
+      version: 1.3.1
+requirements: []
+
+rubyforge_project: kashflow_api
+rubygems_version: 1.4.2
+signing_key: 
+specification_version: 3
+summary: Provides an interface for the Kashflow API
+test_files: 
+- spec/kashflow_api_customer_balance_spec.rb
+- spec/kashflow_api_customer_spec.rb
+- spec/kashflow_api_nominal_codes_spec.rb
+- spec/kashflow_api_quote_spec.rb
+- spec/kashflow_api_spec.rb
+- spec/kashflow_api_supplier_spec.rb
+- spec/spec_helper.rb