zoho_invoice 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+.rvmrc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage/*
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,6 @@
+bundler_args: --without development
+language: ruby
+rvm:
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,17 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+
+group :development do
+  gem 'pry'
+end
+
+group :test do
+  gem 'pry'
+  gem 'coveralls', :require => false
+  gem 'rspec', '>= 2.11'
+  gem 'simplecov', :require => false
+  gem 'webmock'
+end
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Rimas Silkaitis
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,29 @@
+# ZohoInvoice
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'zoho_invoice'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install zoho_invoice
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :test => :spec

data/lib/zoho_invoice.rb

@@ -0,0 +1,31 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'nokogiri'
+require 'multi_xml'
+
+require 'zoho_invoice/configurable'
+require 'zoho_invoice/auth_token'
+require 'zoho_invoice/defaults'
+
+require 'zoho_invoice/client'
+require 'zoho_invoice/version'
+require 'zoho_invoice/base'
+require 'zoho_invoice/customer'
+require 'zoho_invoice/item'
+require 'zoho_invoice/invoice_item'
+require 'zoho_invoice/invoice'
+
+module ZohoInvoice
+  class << self
+    include ZohoInvoice::Configurable
+  end
+
+  # Default for connecting to Zoho Invoice API
+  #
+  @client_options = {
+    :url => ZohoInvoice::Defaults::URL
+  }
+
+  @scope = ZohoInvoice::Defaults::SCOPE
+
+end

data/lib/zoho_invoice/api/customers.rb

@@ -0,0 +1,7 @@
+module ZohoInvoice
+  module API
+    module Customer
+
+    end
+  end
+end

data/lib/zoho_invoice/auth_token.rb

@@ -0,0 +1,28 @@
+module ZohoInvoice
+  module AuthToken
+    class AuthTokenResult < Struct.new(:authtoken, :cause)
+      def success?
+        return true if !authtoken.nil?
+        false
+      end
+    end
+
+    def self.generate_authtoken(email_id, password)
+      client = ZohoInvoice::Client.new(:client_options => {:url => 'https://accounts.zoho.com'})
+      response = client.request(
+        :get,
+        '/apiauthtoken/nb/create',
+        {
+          :SCOPE => 'invoiceapi',
+          :EMAIL_ID => email_id,
+          :PASSWORD => password
+        }
+      )
+
+      result = ZohoInvoice::AuthToken::AuthTokenResult.new(nil, nil)
+      result.cause = response.body.match(/\nCAUSE=(.+)\n/)[1] if response.body =~ /RESULT=FALSE/
+      result.authtoken = response.body.match(/AUTHTOKEN=(.+)\n/)[1] if response.body =~ /RESULT=TRUE/
+      result
+    end
+  end
+end

data/lib/zoho_invoice/base.rb

@@ -0,0 +1,151 @@
+module ZohoInvoice
+  class Error < Struct.new(:message, :code, :status, :http_status)
+  end
+
+  # Used for instances when some of the representations in zoho
+  # dont have their own end points in the API
+  #
+  class ActionNotSupportedError < StandardError; end
+
+  class Base
+
+    attr_reader :client
+
+    def self.define_object_attrs(*attrs)
+      @attributes = attrs
+      create_attributes(attrs)
+    end
+
+    # TODO Create an Association class to manage the relationship
+    #
+    def self.has_many(*attrs)
+      @reflections = attrs
+      create_attributes(attrs)
+    end
+
+    def self.create(client, options = {})
+      self.new(client, options).save
+    end
+
+    def initialize(client, options = {})
+      @client = client
+
+      # Assign all of the single attribtues
+      #
+      if !self.attributes.empty?
+        (self.attributes & options.keys).each do |attribute|
+          self.send("#{attribute}=", options[attribute])
+        end
+      end
+
+      # Assign all of the associations.  Not the most advanced
+      #
+      if self.reflections.is_a?(Array)
+        self.reflections.each { |r| self.send("#{r}=", []) }
+        (self.reflections & options.keys).each do |reflection|
+          options[reflection].each do |reflection_obj|
+            klass = Kernel.const_get(camel_case(reflection.to_s[0..-2]))
+            if reflection_obj.is_a?(Hash)
+              self.send("#{reflection}") << klass.new(@client, reflection_obj)
+            elsif reflection_obj.is_a?(klass)
+              self.send("#{reflection}") << reflection_obj
+            end
+          end
+        end
+      end
+    end
+
+    def reflections
+      self.class.instance_variable_get(:'@reflections') || []
+    end
+
+    def attributes
+      self.class.instance_variable_get(:'@attributes') || []
+    end
+
+    def errors
+      @errors ||= []
+    end
+
+    # TODO Determining the resource to use will need to change
+    #
+    def save
+      @errors = []
+
+      action = 'create'
+      action = 'update' if !send("#{self.class.to_s.downcase}_id").nil?
+
+      result = client.post("/api/#{self.class.to_s.downcase + 's'}/#{action}", :XMLString => self.to_xml)
+
+      if action == 'create' && !result.body.nil? && !result.body[self.class.to_s].nil?
+        self.send("#{self.class.to_s.downcase}_id=", result.body[self.class.to_s]["#{self.class}ID"])
+      end
+
+      self
+    rescue Faraday::Error::ClientError => e
+      if e.response[:body]
+        self.errors << process_error(e.response)
+      end
+      return self
+    end
+
+    # This needs to be a Nokogiri::XML::Builder
+    #
+    def to_xml(*args)
+      build_attributes.to_xml(*args)
+    end
+
+  protected
+
+    def process_error(request_result)
+      self.class.process_error(request_result)
+    end
+
+    def self.process_error(request_result)
+      error = Error.new
+      response_body = request_result[:body]
+      error.status  = response_body['Response']['status']
+      error.code    = response_body['Response']['Code']
+      error.message = response_body['Response']['Message']
+      error.http_status = request_result[:status]
+      error
+    end
+
+    def self.camel_case(str)
+      return str if str !~ /_/ && str =~ /[A-Z]+.*/
+      str.split('_').map{|e| e.capitalize}.join
+    end
+
+    def camel_case(str)
+      self.class.camel_case(str)
+    end
+
+    def build_attributes
+      Nokogiri::XML::Builder.new do |xml|
+        xml.send("#{self.class}") {
+          self.attributes.each do |attr|
+            vals = self.send(attr)
+            if !vals.nil? && !vals.is_a?(Array)
+              xml.send("#{camel_case(attr.to_s)}_", self.send(attr))
+            end
+          end
+          self.reflections.each do |refl|
+            if !refl.empty?
+              xml.send(camel_case(refl.to_s)) {
+                self.send(refl).each { |x| xml << x.to_xml(:save_with => Nokogiri::XML::Node::SaveOptions::NO_DECLARATION) }
+              }
+            end
+          end
+        }
+      end
+    end
+
+    private
+
+    def self.create_attributes(attrs)
+      attrs.each do |attr|
+        attr_accessor attr
+      end
+    end
+  end
+end

data/lib/zoho_invoice/client.rb

@@ -0,0 +1,39 @@
+module ZohoInvoice
+  class Client
+    include ZohoInvoice::Configurable
+
+    def initialize(options = {})
+      ZohoInvoice::Configurable.keys.each do |key|
+        instance_variable_set(:"@#{key}", options[key] || ZohoInvoice.instance_variable_get(:"@#{key}"))
+      end
+      @client_options = ZohoInvoice.instance_variable_get(:'@client_options').merge(options[:client_options] || {})
+    end
+
+    def get(path, params={})
+      request(:get, path, credentials.merge(params))
+    end
+
+    def post(path, params={})
+      request(:post, path, credentials.merge(params))
+    end
+
+    def request(verb, path, params={})
+      connection.send(verb, path, params)
+    end
+
+    private
+
+    def connection
+      @connection ||= Faraday.new(@client_options) do |c|
+        c.use       Faraday::Response::RaiseError
+        c.response  :xml, :content_type => 'application/xml'
+
+        c.request :multipart
+        c.request :url_encoded
+
+        c.adapter Faraday.default_adapter
+      end
+    end
+
+  end
+end

data/lib/zoho_invoice/configurable.rb

@@ -0,0 +1,49 @@
+module ZohoInvoice
+  module Configurable
+
+    # @return [String] The permanent authtoken used to authenticate each API request
+    attr_accessor :authtoken
+
+    # @return [String] The value for this parameter has to be invoiceapi
+    attr_accessor :scope
+
+    # @return [String] The key used to authenticate the API caller
+    attr_accessor :apikey
+
+    # @return [Hash] Client configuration to pass to Faraday
+    attr_accessor :client_options
+
+    class << self
+
+      def keys
+        @keys ||= [
+          :authtoken,
+          :scope,
+          :apikey,
+          :client_options
+        ]
+      end
+
+    end
+
+    def configure
+      yield self
+      self
+    end
+
+    def config_hash
+      Hash[ZohoInvoice::Configurable.keys.map{ |key| [key, instance_variable_get(:"@#{key}")] }]
+    end
+
+    private
+
+    def credentials
+      {
+        :authtoken => @authtoken,
+        :scope     => @scope,
+        :apikey    => @apikey
+      }
+    end
+
+  end
+end

data/lib/zoho_invoice/contact.rb

@@ -0,0 +1,22 @@
+require 'zoho_invoice/base'
+
+module ZohoInvoice
+  class Contact < Base
+
+    define_object_attrs :salutation,
+      :first_name,
+      :last_name,
+      :e_mail,
+      :phone,
+      :mobile
+
+    def self.create(client, options = {})
+      raise ZohoInvoice::ActionNotSupportedError
+    end
+
+    def save
+      raise ZohoInvoice::ActionNotSupportedError
+    end
+
+  end
+end

data/lib/zoho_invoice/customer.rb

@@ -0,0 +1,29 @@
+require 'zoho_invoice/base'
+require 'zoho_invoice/contact'
+
+module ZohoInvoice
+  class Customer < Base
+
+    define_object_attrs :name,
+      :payments_due,
+      :currency_code,
+      :billing_address,
+      :billing_city,
+      :billing_zip,
+      :billing_country,
+      :billing_fax,
+      :shipping_address,
+      :shipping_city,
+      :shipping_state,
+      :shipping_country,
+      :shipping_fax,
+      :customer_id
+
+    has_many :contacts
+
+    def self.search(client, input_text)
+
+    end
+
+  end
+end

data/lib/zoho_invoice/defaults.rb

@@ -0,0 +1,9 @@
+module ZohoInvoice
+  module Defaults
+
+    URL = 'https://invoice.zoho.com'
+
+    SCOPE = 'invoiceapi'
+
+  end
+end

data/lib/zoho_invoice/error.rb

@@ -0,0 +1,7 @@
+module ZohoInvoice
+  class Error
+
+    attr_accessor :message, :code
+
+  end
+end

data/lib/zoho_invoice/invoice.rb

@@ -0,0 +1,25 @@
+require 'zoho_invoice/invoice_item'
+
+module ZohoInvoice
+  class Invoice < Base
+
+    define_object_attrs :invoice_id,
+      :created_time,          :exchange_rate,
+      :last_modified_time,    :l_f_name,
+      :last_sync_time,        :late_fee_amount,
+      :source,                :total,
+      :reference_id,          :invoice_item_total,
+      :invoice_number,        :tax_total,
+      :p_o_number,            :balance,
+      :status,
+      :customer_id,
+      :customer_name,
+      :invoice_date,
+      :payments_due,
+      :due_date,
+      :currency_code
+
+    has_many :invoice_items
+
+  end
+end

data/lib/zoho_invoice/invoice_item.rb

@@ -0,0 +1,7 @@
+module ZohoInvoice
+  class InvoiceItem < Item
+
+    primary_key :item_id
+
+  end
+end

data/lib/zoho_invoice/item.rb

@@ -0,0 +1,9 @@
+module ZohoInvoice
+  class Item < Base
+
+    define_object_attrs :name,
+      :description,
+      :rate
+
+  end
+end

data/lib/zoho_invoice/version.rb

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

data/spec/fixtures/500_internal_server_error

@@ -0,0 +1 @@
+<Response status="0"><Code>2</Code><Message><![CDATA[Invalid value passed for XMLString]]></Message></Response>

data/spec/fixtures/incorrect_verb_used

@@ -0,0 +1 @@
+<Response status="0"><Code>1</Code><Message><![CDATA[API can be called only over an HTTPS Post request]]></Message></Response>

data/spec/fixtures/invalid_customer_id

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8"?><Response status="0"><Code>3004</Code><Message>The Customer field can neither be blank nor be incorrect. Please enter a correct customer name.</Message></Response>

data/spec/fixtures/invalid_password

@@ -0,0 +1,4 @@
+#
+#Mon Mar 18 15:33:32 PDT 2013
+CAUSE=INVALID_PASSWORD
+RESULT=FALSE

data/spec/fixtures/invalid_url_passed

@@ -0,0 +1 @@
+<Response status="0"><Code>5</Code><Message><![CDATA[Invalid URL Passed]]></Message></Response>

data/spec/fixtures/invalid_user

@@ -0,0 +1,4 @@
+#
+#Mon Mar 18 15:34:33 PDT 2013
+CAUSE=NO_SUCH_USER
+RESULT=FALSE

data/spec/fixtures/please_select_an_item

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8"?><Response status="0"><Code>4016</Code><Message>Please select an item</Message></Response>

data/spec/fixtures/successful_authtoken

@@ -0,0 +1,4 @@
+#
+#Mon Mar 18 15:30:44 PDT 2013
+AUTHTOKEN=aaaa2222bbbb3333cccc4444dddd5555
+RESULT=TRUE

data/spec/spec_helper.rb

@@ -0,0 +1,55 @@
+# Get everything loaded up per gemspec
+#
+require 'simplecov'
+require 'coveralls'
+
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start
+
+require 'rspec'
+require 'zoho_invoice'
+require 'webmock/rspec'
+require 'pry'
+
+WebMock.disable_net_connect!
+
+RSpec.configure do |config|
+  config.expect_with(:rspec) do |c|
+    c.syntax = :expect
+  end
+end
+
+def stub_get(path)
+  stub_request(:get, ZohoInvoice::Defaults::URL + path)
+end
+
+def a_get(path)
+  a_request(:get, ZohoInvoice::Defaults::URL + path)
+end
+
+def stub_post(path)
+  stub_request(:post, ZohoInvoice::Defaults::URL + path)
+end
+
+def a_post(path)
+  a_request(:post, ZohoInvoice::Defaults::URL + path)
+end
+
+def fixture_path
+  File.expand_path('../fixtures', __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + '/' + file)
+end
+
+def default_credentials
+  {
+    :authtoken => '1234',
+    :scope     => ZohoInvoice::Defaults::SCOPE,
+    :apikey    => '5678'
+  }
+end

data/spec/zoho_invoice/auth_token_spec.rb

@@ -0,0 +1,73 @@
+require 'spec_helper'
+
+describe ZohoInvoice::AuthToken do
+
+  it "should be able to generate a new authtoken" do
+    email_id = 'big_tuna@example.com'
+    password = 'tuna'
+
+    stub_request(:get, 'https://accounts.zoho.com/apiauthtoken/nb/create').
+      with(:query => default_auth_options(email_id, password)).
+      to_return(:body => fixture('successful_authtoken'))
+
+    result = ZohoInvoice::AuthToken.generate_authtoken(email_id, password)
+    expect(result.success?).to be_true
+    expect(result).to be_a ZohoInvoice::AuthToken::AuthTokenResult
+    expect(a_request(:get, 'https://accounts.zoho.com/apiauthtoken/nb/create')
+      .with(:query => default_auth_options(email_id, password)))
+      .to have_been_made
+  end
+
+  describe "failure cases" do
+
+    it "should be unccessful if user name is incorrect" do
+      bad_request('invalid_user', 'tuna@example.com', 'tuna') do |auth_token_result|
+        expect(auth_token_result.cause).to eq('NO_SUCH_USER')
+      end
+    end
+
+    it "should be unccessful if user name is incorrect" do
+      bad_request('invalid_password', 'big_tuna@example.com', 'tu') do |auth_token_result|
+        expect(auth_token_result.cause).to eq('INVALID_PASSWORD')
+      end
+    end
+
+    def bad_request(fixture_to_use, email_id, password)
+      stub_request(:get, 'https://accounts.zoho.com/apiauthtoken/nb/create').
+        with(:query => default_auth_options(email_id, password)).
+        to_return(:body => fixture(fixture_to_use))
+
+      result = ZohoInvoice::AuthToken.generate_authtoken(email_id, password)
+      expect(result.success?).to be_false
+      expect(result).to be_a ZohoInvoice::AuthToken::AuthTokenResult
+      expect(a_request(:get, 'https://accounts.zoho.com/apiauthtoken/nb/create')
+        .with(:query => default_auth_options(email_id, password)))
+        .to have_been_made
+
+      yield result
+    end
+
+  end
+
+  it "should define an auth token result" do
+    result = ZohoInvoice::AuthToken::AuthTokenResult.new(nil, nil)
+    expect(result.respond_to?(:authtoken)).to be_true
+    expect(result.respond_to?(:cause)).to be_true
+
+    expect(result.success?).to be_false
+
+    result.authtoken = 'asdf'
+    expect(result.success?).to be_true
+  end
+
+  private
+
+  def default_auth_options(email, password)
+    {
+      :SCOPE => 'invoiceapi',
+      :EMAIL_ID => email,
+      :PASSWORD => password
+    }
+  end
+
+end

data/spec/zoho_invoice/base_spec.rb

@@ -0,0 +1,182 @@
+require 'spec_helper'
+
+describe ZohoInvoice::Base do
+
+  before do
+    @client = ZohoInvoice::Client.new(default_credentials)
+  end
+
+  it "requires a client upon initialization" do
+    expect{ ZohoInvoice::Base.new }.to raise_error(StandardError)
+  end
+
+  it "can define the attributes of an instance object and assign them on initialization" do
+    class TestClass < ZohoInvoice::Base
+      define_object_attrs :test_it
+    end
+
+    test_obj = TestClass.new(@client)
+    expect(test_obj.respond_to?('test_it')).to be_true
+    expect(test_obj.respond_to?('test_it=')).to be_true
+    expect(test_obj.attributes).to eq([:test_it])
+
+    test_obj1 = TestClass.new(@client, :test_it => 1)
+    expect(test_obj1.test_it).to eq(1)
+  end
+
+  it "can define associations to itself" do
+    class TestClass < ZohoInvoice::Base
+      has_many :things,
+        :more_things
+    end
+
+    test_obj = TestClass.new(@client)
+    expect(test_obj.things.is_a?(Array)).to be_true
+    expect(test_obj.things.length).to eq(0)
+    expect(test_obj.reflections).to eq([:things, :more_things])
+  end
+
+  describe "generating an xml representation" do
+    before do
+      class Something < ZohoInvoice::Base
+        define_object_attrs :test_it,
+          :blah,
+          :something_id
+
+        has_many :things,
+          :more_things
+      end
+
+      @test_obj = Something.new(@client)
+    end
+
+    it "should specific an xml doctype" do
+      xml = @test_obj.to_xml
+      expect(xml).to include("<?xml version=\"1.0\"?>")
+    end
+
+    it "should have a root element" do
+      xml = Nokogiri::XML(@test_obj.to_xml)
+      expect(xml.children.length).to eq(1)
+      expect(xml.children.first.name).to eq("Something")
+
+      @test_obj.test_it = 1234
+      xml = Nokogiri::XML(@test_obj.to_xml)
+      expect(xml.children.length).to eq(1)
+      expect(xml.children.first.name).to eq("Something")
+    end
+
+    it "should create the attributes correctly" do
+      @test_obj.test_it = 1234
+      xml = Nokogiri::XML(@test_obj.to_xml)
+      expect(xml.xpath('//TestIt').length).to eq(1)
+      expect(xml.xpath('//TestIt').first.text).to eq('1234')
+
+      @test_obj.test_it = nil
+      xml = Nokogiri::XML(@test_obj.to_xml)
+      expect(xml.xpath('//TestIt')).to be_empty
+    end
+
+    it "should create the associations correctly" do
+      class Thing < Struct.new(:stuff)
+        def to_xml(*args)
+          "<Thing>#{stuff}</Thing>"
+        end
+      end
+      @test_obj.things << Thing.new('asdf')
+      @test_obj.things << Thing.new('asdf')
+
+      @test_obj.more_things << Thing.new('1234')
+
+      xml = Nokogiri::XML(@test_obj.to_xml)
+      expect(xml.xpath('//Things').length).to eq(1)
+      expect(xml.xpath('//Things/Thing').length).to eq(2)
+      expect(xml.xpath('//MoreThings/Thing').length).to eq(1)
+    end
+  end
+
+  describe "saving an object" do
+    before do
+      class Something < ZohoInvoice::Base
+        define_object_attrs :something_id, :blah
+      end
+      @test_obj = Something.new(@client)
+    end
+
+    it "calls the create path if its a new record" do
+      @test_obj.something_id = nil
+      body_params = default_credentials.merge(:XMLString => @test_obj.to_xml)
+      stub_post('/api/somethings/create').
+        with(:body => body_params).
+        to_return(:status => 200, :body => successful_something_response('5555'), :headers => {:content_type => 'application/xml'})
+      @test_obj.save
+      expect(a_post('/api/somethings/create').with(:body => body_params)).to have_been_made
+    end
+
+    it "calls the update path if its a dirty record" do
+      @test_obj.something_id = '123456'
+      body_params = default_credentials.merge(:XMLString => @test_obj.to_xml)
+      stub_post('/api/somethings/update').
+        with(:body => body_params).
+        to_return(:status => 200, :body => successful_something_response('123456'), :headers => {:content_type => 'application/xml'})
+      @test_obj.save
+      expect(a_post('/api/somethings/update').with(:body => body_params)).to have_been_made
+    end
+
+    it "can happen via .create" do
+      @test_obj.blah = '1234'
+      body_params = default_credentials.merge(:XMLString => @test_obj.to_xml)
+      stub_post('/api/somethings/create').
+        with(:body => body_params).
+        to_return(:status => 200, :body => successful_something_response("1234"), :headers => { :content_type => 'application/xml' })
+      test_obj = Something.create(@client, :blah => '1234')
+      expect(a_post('/api/somethings/create').with(:body => body_params)).to have_been_made
+      expect(test_obj.something_id).to eq('1')
+    end
+
+    it "returns the object and has an error method" do
+      @test_obj.blah = '1234'
+      body_params = default_credentials.merge(:XMLString => @test_obj.to_xml)
+      stub_post('/api/somethings/create').with(:body => body_params).to_return(:status => 500, :body => fixture('500_internal_server_error'), :headers => { :content_type => 'application/xml' })
+      test_obj = Something.create(@client, :blah => '1234')
+      expect(test_obj.something_id).to be_nil
+      expect(test_obj.errors.length).to eq(1)
+      error = test_obj.errors.first
+      expect(error.message).to eq("Invalid value passed for XMLString")
+      expect(error.code).to eq('2')
+      expect(error.status).to eq('0')
+      expect(error.http_status).to eq(500)
+    end
+
+    def successful_something_response(blah_payload)
+      "<Something><SomethingID>1</SomethingID><Blah>#{blah_payload}</Blah></Something>"
+    end
+  end
+
+  describe "nested associations" do
+    class Tuna < ZohoInvoice::Base
+      define_object_attrs :blah
+    end
+    class TestIt < ZohoInvoice::Base
+      has_many :tunas
+    end
+
+    before do
+      @client = ZohoInvoice::Client.new(default_credentials)
+    end
+
+    it "can be created at initialization" do
+      test = TestIt.new(@client, :tunas => [{:blah => 1234}, Tuna.new(@client, :blah => 5678)])
+      expect(test.tunas.length).to eq(2)
+      expect(test.tunas.first.blah).to eq(1234)
+      expect(test.tunas.last.blah).to eq(5678)
+    end
+
+    it "outputted when coverted to xml", :focus => true do
+      test = TestIt.new(@client, :tunas => [{:blah => 1234}])
+      doc  = Nokogiri::XML(test.to_xml)
+      expect(doc.xpath('//Tunas').length).to be >= 1
+      expect(doc.xpath('//Tuna').length).to eq(1)
+    end
+  end
+end

data/spec/zoho_invoice/client_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+
+describe ZohoInvoice::Client do
+
+  subject do
+    ZohoInvoice::Client.new(default_credentials)
+  end
+
+  describe "#get" do
+    it "can create custom requests" do
+      query_hash = default_credentials.merge({:rad => 'object'})
+      stub_get('/something/sweet').with(:query => query_hash)
+      subject.get('/something/sweet', {:rad => 'object'})
+      expect(a_get('/something/sweet').with(:query => query_hash)).to have_been_made
+    end
+  end
+
+  describe "#post" do
+    it "can create custom requests" do
+      query_hash = default_credentials.merge({:rad => 'object'})
+      stub_post('/something/awesome').with(:body => query_hash)
+      subject.post('/something/awesome', {:rad => 'object'})
+      expect(a_post('/something/awesome').with(:body => query_hash)).to have_been_made
+    end
+  end
+
+  describe "#request" do
+    it "can create custom requests" do
+      stub_post('/awesome').with(:body => {:rad => 'object'})
+      subject.request(:post, '/awesome', {:rad => 'object'})
+      expect(a_post('/awesome').with({:rad => 'object'})).to have_been_made
+    end
+
+    it "does not include default credentials in params" do
+      stub_get('/awesome')
+      subject.request(:get, '/awesome')
+      expect(a_get('/awesome')).to have_been_made
+    end
+  end
+
+  describe "initialization" do
+    it "can pass options to faraday" do
+      client = ZohoInvoice::Client.new(
+        default_credentials.merge({
+          :client_options => {
+            :url => 'http://something.com'
+          }
+        })
+      )
+      stub_request(:get, 'http://something.com/awesome').with(:query => default_credentials)
+      client.get('/awesome')
+      expect(a_request(:get, 'http://something.com/awesome').with(:query => default_credentials)).to have_been_made
+    end
+
+    it "will inherit config from defaults" do
+      client = ZohoInvoice::Client.new
+      expect(client.scope).to eq(ZohoInvoice::Defaults::SCOPE)
+      expect(client.client_options).to eq({ :url => ZohoInvoice::Defaults::URL })
+    end
+  end
+
+end

data/spec/zoho_invoice/contact_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe ZohoInvoice::Contact do
+
+  before do
+    @client = ZohoInvoice::Client.new(default_credentials)
+  end
+
+  it ".create should raise an error" do
+    expect{ ZohoInvoice::Contact.create(@client) }.to raise_error(ZohoInvoice::ActionNotSupportedError)
+  end
+
+  it "#save should raise an error" do
+    contact = ZohoInvoice::Contact.new(@client)
+    expect{ contact.save }.to raise_error(ZohoInvoice::ActionNotSupportedError)
+  end
+
+end

data/spec/zoho_invoice_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe ZohoInvoice do
+
+  it "should be able to define global options on the module" do
+    ZohoInvoice.configure do |config|
+      config.authtoken = '11111'
+      config.scope     = 'scope'
+      config.apikey    = 'apikey'
+      config.client_options = { :url => 'http://example.com' }
+    end
+    expect(ZohoInvoice.authtoken).to eq('11111')
+    expect(ZohoInvoice.scope).to eq('scope')
+    expect(ZohoInvoice.apikey).to eq('apikey')
+    expect(ZohoInvoice.client_options).to eq({ :url => 'http://example.com' })
+  end
+
+  it "should be able to return its current options" do
+    ZohoInvoice.configure do |config|
+      config.authtoken = '22222'
+    end
+    expect(ZohoInvoice.config_hash[:authtoken]).to eq('22222')
+  end
+end

data/zoho_invoice.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'zoho_invoice/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "zoho_invoice"
+  gem.version       = ZohoInvoice::VERSION
+  gem.authors       = ["Rimas Silkaitis"]
+  gem.email         = ["neovintage@gmail.com"]
+  gem.summary       = %q{Zoho Invoice API}
+  gem.description   = %q{Ruby wrapper for the Zoho Invoice API.  Documentation for the Zoho Invoice API can be found at http://zoho.com}
+  gem.homepage      = "https://github.com/neovintage/zoho_invoice"
+
+  gem.required_ruby_version     = ">= 1.9.3"
+  gem.required_rubygems_version = ">= 1.3.6"
+
+  gem.add_development_dependency 'bundler', '~> 1.0'
+
+  gem.add_runtime_dependency "faraday", ">= 0.8.0"
+  gem.add_runtime_dependency "faraday_middleware", ">= 0.8.7"
+  gem.add_runtime_dependency "nokogiri"
+  gem.add_runtime_dependency "multi_xml"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,175 @@
+--- !ruby/object:Gem::Specification
+name: zoho_invoice
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Rimas Silkaitis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_xml
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby wrapper for the Zoho Invoice API.  Documentation for the Zoho Invoice
+  API can be found at http://zoho.com
+email:
+- neovintage@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/zoho_invoice.rb
+- lib/zoho_invoice/api/customers.rb
+- lib/zoho_invoice/auth_token.rb
+- lib/zoho_invoice/base.rb
+- lib/zoho_invoice/client.rb
+- lib/zoho_invoice/configurable.rb
+- lib/zoho_invoice/contact.rb
+- lib/zoho_invoice/customer.rb
+- lib/zoho_invoice/defaults.rb
+- lib/zoho_invoice/error.rb
+- lib/zoho_invoice/invoice.rb
+- lib/zoho_invoice/invoice_item.rb
+- lib/zoho_invoice/item.rb
+- lib/zoho_invoice/version.rb
+- spec/fixtures/500_internal_server_error
+- spec/fixtures/incorrect_verb_used
+- spec/fixtures/invalid_customer_id
+- spec/fixtures/invalid_password
+- spec/fixtures/invalid_url_passed
+- spec/fixtures/invalid_user
+- spec/fixtures/please_select_an_item
+- spec/fixtures/successful_authtoken
+- spec/spec_helper.rb
+- spec/zoho_invoice/auth_token_spec.rb
+- spec/zoho_invoice/base_spec.rb
+- spec/zoho_invoice/client_spec.rb
+- spec/zoho_invoice/contact_spec.rb
+- spec/zoho_invoice_spec.rb
+- zoho_invoice.gemspec
+homepage: https://github.com/neovintage/zoho_invoice
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: Zoho Invoice API
+test_files:
+- spec/fixtures/500_internal_server_error
+- spec/fixtures/incorrect_verb_used
+- spec/fixtures/invalid_customer_id
+- spec/fixtures/invalid_password
+- spec/fixtures/invalid_url_passed
+- spec/fixtures/invalid_user
+- spec/fixtures/please_select_an_item
+- spec/fixtures/successful_authtoken
+- spec/spec_helper.rb
+- spec/zoho_invoice/auth_token_spec.rb
+- spec/zoho_invoice/base_spec.rb
+- spec/zoho_invoice/client_spec.rb
+- spec/zoho_invoice/contact_spec.rb
+- spec/zoho_invoice_spec.rb