blinksale 0.1.0 → 0.2.0

data/Gemfile

@@ -2,13 +2,15 @@ source "http://rubygems.org"
 # Add dependencies required to use your gem here.
 # Example:
 #   gem "activesupport", ">= 2.3.5"
-gem "rest-client"
-gem "nokogiri"
+gem "rest-client", "~> 1.6.3"
+gem "nokogiri", "~> 1.4.6"
 
 # Add dependencies to develop your gem here.
 # Include everything needed to run rake, tests, features, etc.
 group :development do
   gem "rspec", "~> 2.3.0"
+  gem "mocha", "~> 0.9.12"
   gem "bundler", "~> 1.0.0"
   gem "jeweler", "~> 1.6.2"
+  gem "simplecov", "~> 0.4.2"
 end

data/Gemfile.lock

@@ -8,7 +8,8 @@ GEM
       git (>= 1.2.5)
       rake
     mime-types (1.16)
-    nokogiri (1.4.4)
+    mocha (0.9.12)
+    nokogiri (1.4.6)
     rake (0.9.2)
     rest-client (1.6.3)
       mime-types (>= 1.16)
@@ -20,6 +21,9 @@ GEM
     rspec-expectations (2.3.0)
       diff-lcs (~> 1.1.2)
     rspec-mocks (2.3.0)
+    simplecov (0.4.2)
+      simplecov-html (~> 0.4.4)
+    simplecov-html (0.4.4)
 
 PLATFORMS
   ruby
@@ -27,6 +31,8 @@ PLATFORMS
 DEPENDENCIES
   bundler (~> 1.0.0)
   jeweler (~> 1.6.2)
-  nokogiri
-  rest-client
+  mocha (~> 0.9.12)
+  nokogiri (~> 1.4.6)
+  rest-client (~> 1.6.3)
   rspec (~> 2.3.0)
+  simplecov (~> 0.4.2)

data/Rakefile

@@ -38,8 +38,8 @@ end
 
 task :default => :spec
 
-require 'rake/rdoctask'
-Rake::RDocTask.new do |rdoc|
+require 'rdoc/task'
+RDoc::Task.new do |rdoc|
   version = File.exist?('VERSION') ? File.read('VERSION') : ""
 
   rdoc.rdoc_dir = 'rdoc'

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

data/blinksale.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{blinksale}
-  s.version = "0.1.0"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Tomasz Werbicki"]
-  s.date = %q{2011-06-27}
+  s.date = %q{2011-06-28}
   s.description = %q{Basic Blinksale invoice fetcher.}
   s.email = %q{tomasz@werbicki.net}
   s.extra_rdoc_files = [
@@ -27,7 +27,14 @@ Gem::Specification.new do |s|
     "VERSION",
     "blinksale.gemspec",
     "lib/blinksale.rb",
-    "lib/invoices.rb"
+    "lib/clients.rb",
+    "lib/invoices.rb",
+    "spec/blinksale_spec.rb",
+    "spec/fixtures/invoice_collection.xml",
+    "spec/fixtures/invoice_single.xml",
+    "spec/invoice_spec.rb",
+    "spec/invoices_spec.rb",
+    "spec/spec_helper.rb"
   ]
   s.homepage = %q{http://github.com/neaf/blinksale}
   s.licenses = ["MIT"]
@@ -40,24 +47,30 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<rest-client>, [">= 0"])
-      s.add_runtime_dependency(%q<nokogiri>, [">= 0"])
+      s.add_runtime_dependency(%q<rest-client>, ["~> 1.6.3"])
+      s.add_runtime_dependency(%q<nokogiri>, ["~> 1.4.6"])
       s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<mocha>, ["~> 0.9.12"])
       s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
       s.add_development_dependency(%q<jeweler>, ["~> 1.6.2"])
+      s.add_development_dependency(%q<simplecov>, ["~> 0.4.2"])
     else
-      s.add_dependency(%q<rest-client>, [">= 0"])
-      s.add_dependency(%q<nokogiri>, [">= 0"])
+      s.add_dependency(%q<rest-client>, ["~> 1.6.3"])
+      s.add_dependency(%q<nokogiri>, ["~> 1.4.6"])
       s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<mocha>, ["~> 0.9.12"])
       s.add_dependency(%q<bundler>, ["~> 1.0.0"])
       s.add_dependency(%q<jeweler>, ["~> 1.6.2"])
+      s.add_dependency(%q<simplecov>, ["~> 0.4.2"])
     end
   else
-    s.add_dependency(%q<rest-client>, [">= 0"])
-    s.add_dependency(%q<nokogiri>, [">= 0"])
+    s.add_dependency(%q<rest-client>, ["~> 1.6.3"])
+    s.add_dependency(%q<nokogiri>, ["~> 1.4.6"])
     s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<mocha>, ["~> 0.9.12"])
     s.add_dependency(%q<bundler>, ["~> 1.0.0"])
     s.add_dependency(%q<jeweler>, ["~> 1.6.2"])
+    s.add_dependency(%q<simplecov>, ["~> 0.4.2"])
   end
 end
 

data/lib/blinksale.rb

@@ -1,25 +1,27 @@
 require 'rest-client'
 require 'invoices'
+require 'clients'
 
 module Blinksale
-  class Client
+  class Service
     attr_reader :subdomain, :username, :password, :rest_resource
+    attr_reader :invoices, :clients
 
     def initialize(subdomain, username, password)
       @subdomain = subdomain
       @username = username
       @password = password
+
       @rest_resource = RestClient::Resource.new(base_url,
-                                                username,
-                                                password)
+                                                :user => username,
+                                                :password => password)
+
+      @invoices = Blinksale::Invoices.new(self)
+      @clients = Blinksale::Clients.new(self)
     end
 
     def base_url
       "https://#{ subdomain }.blinksale.com"
     end
-
-    def invoices
-      @invoices ||= Blinksale::Invoices.new(self)
-    end
   end
 end

data/lib/clients.rb

@@ -0,0 +1,57 @@
+require "nokogiri"
+
+module Blinksale
+  class Client
+    attr_accessor :name, :address1, :address2, :city, :state, :zip_code, :country, :phone
+
+    def self.from_node(node)
+      self.new.tap do |i|
+        i.id = node.attributes["uri"].content[/\d+$/].to_i
+        i.name = node.xpath('xmlns:name').first.content
+        i.address1 = node.xpath("xmlns:address1").first.content.to_f
+        i.address2 = node.xpath("xmlns:address2").first.content.to_f
+        i.city = node.xpath("xmlns:city").first.content.to_f
+        i.state = node.xpath("xmlns:state").first.content.to_f
+        i.zip_code = node.xpath("xmlns:zip").first.content.to_f
+        i.country = node.xpath("xmlns:country").first.content.to_f
+        i.phone = node.xpath("xmlns:phone").first.content.to_f
+      end
+    end
+  end
+
+  class Clients
+    attr_reader :service
+
+    def initialize(service)
+      @service = service
+    end
+
+    def all(params = {})
+      headers = {
+        :content_type => "application/vnd.blinksale+xml",
+        :accept => "application/vnd.blinksale+xml"
+      }
+      xml = service.rest_resource["clients"].get(
+        :params => params,
+        :headers => headers
+      )
+      doc = Nokogiri::XML(xml)
+      doc.xpath('//xmlns:client').map do |node|
+        Client.from_node(node)
+      end
+    end
+
+    def get(id, params = {})
+      headers = {
+        :content_type => "application/vnd.blinksale+xml",
+        :accept => "application/vnd.blinksale+xml"
+      }
+      xml = service.rest_resource["clients/#{ id }"].get(
+        :params => params,
+        :headers => headers
+      )
+      doc = Nokogiri::XML(xml)
+      Invoice.from_node(doc.xpath('//xmlns:client').first)
+    end
+  end
+end

data/lib/invoices.rb

@@ -18,10 +18,10 @@ module Blinksale
   end
 
   class Invoices
-    attr_reader :client
+    attr_reader :service
 
-    def initialize(client)
-      @client = client
+    def initialize(service)
+      @service = service
     end
 
     def all(params = {})
@@ -29,7 +29,7 @@ module Blinksale
         :content_type => "application/vnd.blinksale+xml",
         :accept => "application/vnd.blinksale+xml"
       }
-      xml = client.rest_resource["invoices"].get(
+      xml = service.rest_resource["invoices"].get(
         :params => params,
         :headers => headers
       )
@@ -44,7 +44,7 @@ module Blinksale
         :content_type => "application/vnd.blinksale+xml",
         :accept => "application/vnd.blinksale+xml"
       }
-      xml = client.rest_resource["invoices/#{ id }"].get(
+      xml = service.rest_resource["invoices/#{ id }"].get(
         :params => params,
         :headers => headers
       )

data/spec/blinksale_spec.rb

@@ -0,0 +1,49 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+describe Blinksale::Service do
+  let(:service) do
+    Blinksale::Service.new("test-host", "test-username", "test-password")
+  end
+
+  describe "#base_url" do
+    it "returns full url for given subdomain" do
+      service.base_url.should eql("https://test-host.blinksale.com")
+    end
+  end
+
+  describe "#rest_resource" do
+    it "returns instantiated RestClient resource" do
+      service.rest_resource.should be_an_instance_of(RestClient::Resource)
+    end
+
+    describe "resource" do
+      let(:resource) { service.rest_resource }
+
+      it "has proper credentials set" do
+        resource.url.should eql(service.base_url)
+        resource.options[:user].should eql("test-username")
+        resource.options[:password].should eql("test-password")
+      end
+    end
+  end
+
+  describe "#invoices" do
+    it "returns Invoices instance" do
+      service.invoices.should be_an_instance_of(Blinksale::Invoices)
+    end
+    
+    describe "Invoices instance" do
+      let(:invoices) { service.invoices }
+
+      it "has proper service set" do
+        invoices.service.should eql(service)
+      end
+    end
+  end
+
+  describe "#clients" do
+    it "returns Clients instance" do
+      service.clients.should be_an_instance_of(Blinksale::Clients)
+    end
+  end
+end

data/spec/fixtures/invoice_collection.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<invoices xmlns="http://www.blinksale.com/api">
+  <invoice status="open" uri="http://example.blinksale.com/invoices/1" total="20.00" total_due="10.00">
+    <client name="Acme">http://example.blinksale.com/clients/1</client>
+
+    <number>100001</number>
+    <date>2006-09-19</date>
+    <terms due_date="2006-10-04">15</terms>
+    <currency>USD</currency>
+
+    <tags>brian, consulting</tags>
+  </invoice>
+  <invoice status="open" uri="http://example.blinksale.com/invoices/1" total="20.00" total_due="10.00">
+    <client name="Acme">http://example.blinksale.com/clients/2</client>
+
+    <number>100002</number>
+    <date>2006-09-19</date>
+    <terms due_date="2006-10-04">15</terms>
+    <currency>USD</currency>
+
+    <tags>brian, consulting</tags>
+  </invoice>
+</invoices>

data/spec/fixtures/invoice_single.xml

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<invoice xmlns="http://www.blinksale.com/api" uri="http://example.blinksale.com/invoices/1"
+         status="pastdue" subtotal="20.00" total="20.00" paid="10.00" total_due="10.00"
+         surplus="0.00" updated_at="2006-09-20T17:27:48Z" created_at="2006-06-27T22:43:13Z">
+  <client name="Acme">http://example.blinksale.com/clients/2</client>
+  <number>100001</number>
+
+  <po_number>123456</po_number>
+  <date>2006-06-27</date>
+  <terms due_date="2006-07-12">15</terms>
+  <currency>USD</currency>
+
+  <tax amount="0.00">8.75%</tax>
+  <freight>0.00</freight>
+  <late_fee amount="0.00">0%</late_fee>
+  <tags>bob, scott</tags>
+
+  <lines total="882.00">
+    <line>
+      <name>French Hens</name>
+      <quantity>3.0</quantity>
+      <units>Product</units>
+
+      <unit_price>19.00</unit_price>
+      <taxed>false</taxed>
+    </line>
+    <line>
+      <name>Piper-Piping</name>
+
+      <quantity>11.0</quantity>
+      <units>Service</units>
+      <unit_price>75.00</unit_price>
+      <taxed>false</taxed>
+
+    </line>
+  </lines>
+  <deliveries uri="http://example.blinksale.com/invoices/1/deliveries">
+    <delivery uri="http://example.blinksale.com/invoices/1/deliveries/3" created_at="2006-09-22T23:51:42Z">
+      <body>Here's the invoice for the latest work - thanks!</body>
+
+      <recipient name="John Doe" email="john@acme.com">http://example.blinksale.com/clients/2/people/2</recipient>
+      <recipient name="Bob Smith" email="bob@example.com">http://example.blinksale.com/users/1</recipient>
+    </delivery>
+  </deliveries>
+  <payments uri="http://example.blinksale.com/invoices/1/payments" total="10.00">
+
+    <payment uri="http://example.blinksale.com/invoices/1/payments/5" created_at="2006-09-25T18:01:33Z">
+      <amount>10.00</amount>
+      <date>2006-09-25</date>
+      <payment_method>Check</method>
+
+      <number>10001</number>
+    </payment>
+  </payments>
+  <notes>Please reference this invoice number in your check memo.</notes>
+  <include_payment_link>true</include_payment_link>
+
+</invoice>

data/spec/invoice_spec.rb

@@ -0,0 +1,31 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+single_xml = File.read(File.expand_path(File.dirname(__FILE__) + "/fixtures/invoice_single.xml"))
+
+describe Blinksale::Invoice do
+  describe ".from_node" do
+    let(:node) do
+      Nokogiri::XML(single_xml).xpath("//xmlns:invoice").first
+    end
+
+    it "returns Invoice instance" do
+      Blinksale::Invoice.from_node(node).should be_an_instance_of(Blinksale::Invoice)
+    end
+
+    describe "invoice" do
+      let(:invoice) do
+        Blinksale::Invoice.from_node(node)
+      end
+
+      it "has proper attributes set" do
+        invoice.id.should eql(1)
+        invoice.number.should eql("100001")
+        invoice.total_amount.should eql(20.0)
+        invoice.due_amount.should eql(10.0)
+        invoice.issued_on.should eql(Date.new(2006, 6, 27))
+        invoice.due_on.should eql(Date.new(2006, 7, 12))
+        invoice.currency.should eql("USD")
+      end
+    end
+  end
+end

data/spec/invoices_spec.rb

@@ -0,0 +1,54 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+single_xml = File.read(File.expand_path(File.dirname(__FILE__) + "/fixtures/invoice_single.xml"))
+collection_xml = File.read(File.expand_path(File.dirname(__FILE__) + "/fixtures/invoice_collection.xml"))
+
+describe Blinksale::Invoices do
+  let(:service) do
+    Blinksale::Service.new("test-host", "test-username", "test-password")
+  end
+
+  let(:invoices) { service.invoices }
+
+  it "has proper service set" do
+    invoices.service.should eql(service)
+  end
+
+  describe "#all" do
+    before(:each) do
+      RestClient::Resource.any_instance.stubs(:get).returns(collection_xml)
+    end
+
+    it "returns invoices collection" do
+      invoices.all.first.should be_an_instance_of(Blinksale::Invoice)
+    end
+
+    describe "invoices" do
+      let(:invoice) { invoices.all.first }
+
+      it "have proper attributes set" do
+        invoice.number = "100001"
+        invoice.issued_on = Date.new(2006, 9, 19)
+      end
+    end
+  end
+
+  describe "#get" do
+    before(:each) do
+      RestClient::Resource.any_instance.stubs(:get).returns(single_xml)
+    end
+
+    it "returns invoice instance" do
+      invoices.get(1).should be_an_instance_of(Blinksale::Invoice)
+    end
+
+    describe "invoice" do
+      let(:invoice) { invoices.get(1) }
+
+      it "have proper attributes set" do
+        invoice.number = "100001"
+        invoice.issued_on = Date.new(2006, 9, 19)
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'blinksale'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.mock_with :mocha
+end

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Tomasz Werbicki
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-06-27 00:00:00 +02:00
+date: 2011-06-28 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -22,11 +22,13 @@ dependencies:
   requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
         segments: 
-        - 0
-        version: "0"
+        - 1
+        - 6
+        - 3
+        version: 1.6.3
   type: :runtime
   prerelease: false
   version_requirements: *id001
@@ -35,11 +37,13 @@ dependencies:
   requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
         segments: 
-        - 0
-        version: "0"
+        - 1
+        - 4
+        - 6
+        version: 1.4.6
   type: :runtime
   prerelease: false
   version_requirements: *id002
@@ -59,8 +63,23 @@ dependencies:
   prerelease: false
   version_requirements: *id003
 - !ruby/object:Gem::Dependency 
-  name: bundler
+  name: mocha
   requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 9
+        - 12
+        version: 0.9.12
+  type: :development
+  prerelease: false
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  requirement: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -72,10 +91,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *id004
+  version_requirements: *id005
 - !ruby/object:Gem::Dependency 
   name: jeweler
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  requirement: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -87,7 +106,22 @@ dependencies:
         version: 1.6.2
   type: :development
   prerelease: false
-  version_requirements: *id005
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: simplecov
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 4
+        - 2
+        version: 0.4.2
+  type: :development
+  prerelease: false
+  version_requirements: *id007
 description: Basic Blinksale invoice fetcher.
 email: tomasz@werbicki.net
 executables: []
@@ -108,7 +142,14 @@ files:
 - VERSION
 - blinksale.gemspec
 - lib/blinksale.rb
+- lib/clients.rb
 - lib/invoices.rb
+- spec/blinksale_spec.rb
+- spec/fixtures/invoice_collection.xml
+- spec/fixtures/invoice_single.xml
+- spec/invoice_spec.rb
+- spec/invoices_spec.rb
+- spec/spec_helper.rb
 has_rdoc: true
 homepage: http://github.com/neaf/blinksale
 licenses: 
@@ -123,7 +164,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 2365357788582503070
+      hash: -1490968728677671447
       segments: 
       - 0
       version: "0"