kounta_rest 0.0.1

data/lib/kounta/price_list.rb

@@ -0,0 +1,10 @@
+module Kounta
+
+	class PriceList < Kounta::Resource
+		property :parent_id
+		property :name
+		property :products
+		coerce_key :products, Product
+	end
+
+end

data/lib/kounta/product.rb

@@ -0,0 +1,30 @@
+module Kounta
+
+	class Product < Kounta::Resource
+		property :company_id
+		property :code
+		property :barcode
+		property :stock
+		property :name
+		property :description
+		property :tags
+		property :image
+		property :unit_price
+		property :cost_price
+		property :taxes
+		property :sites
+
+		has_many :categories, Kounta::Category, {:company_id => :company_id}, lambda { |klass| {companies: klass.company_id, products: klass.company_id, categories: nil} }
+		coerce_key :taxes, Kounta::Tax
+
+		def tags_include?(name)
+			tags.any?{ |s| s.casecmp(name) == 0 }
+		end
+
+		def resource_path
+			{companies: company_id, products: id}
+		end
+
+	end
+
+end

data/lib/kounta/resource.rb

@@ -0,0 +1,91 @@
+require 'hashie'
+require_relative "rest/client"
+
+module Kounta
+
+	class Resource < Hashie::Dash
+		include Hashie::Extensions::Coercion
+
+		property :id
+		property :created_at
+		property :updated_at
+
+		def self.coerce(data)
+			if data.kind_of? Array
+				data.map { |item| self.new(item) }
+			else
+				self.new(data)
+			end
+		end
+
+		def self.has_one(sym, klass, assignments, route)
+			define_method(sym) do |item_id=nil, *args|
+				if item_id
+					assign_into(client.object_from_response(klass, :get, route.call(self, item_id), {:params => args[0]}), self, assignments)
+				else
+					assign_into(klass.new, self, assignments)
+				end
+			end
+		end
+
+		def self.has_many(sym, klass, assignments, route)
+			define_method(sym) do |*args|
+				client.objects_from_response(klass, :get, route.call(self), {:params => args[0]}).map {|returned_klass| assign_into(returned_klass, self, assignments) }
+			end
+		end
+
+		def initialize(hash={})
+			if hash
+				hash.each_pair do |k,v|
+					begin
+						self[k] = v
+					rescue NoMethodError => e
+						raise Kounta::Errors::UnknownResourceAttribute.new("Unknown attribute: #{k} on resource #{self.class}")
+					end
+				end
+			end
+		end
+
+		def client
+			@@client ||= Kounta::REST::Client.new
+		end
+
+		def to_hash(hash={})
+			{}.tap do |returning|
+				self.class.properties.each do |property|
+					next if ignored_properties.include?(property)
+					returning[property] = self[property] if self[property]
+				end
+			end.merge(hash)
+		end
+
+		def save!
+			response = new? ? client.perform(resource_path, :post, {:body => to_hash}) : client.perform(resource_path, :put, {:body => to_hash})
+			if response
+				response.each_pair do |k,v|
+					self[k] = v
+				end
+			end
+			self
+		end
+
+		def new?
+			!id
+		end
+
+		def ignored_properties(array=[])
+			array + [:created_at, :updated_at, :id, :company_id, :site_id]
+		end
+
+		private
+
+			def assign_into(klass, assigner, assignments)
+				assignments.each_pair do |k,v|
+					klass[k] = assigner[v]
+				end
+				klass
+			end
+
+	end
+
+end

data/lib/kounta/rest/client.rb

@@ -0,0 +1,65 @@
+require 'oauth2'
+require 'yell'
+
+module Kounta
+	module REST
+		class Client
+
+			def initialize
+				raise Kounta::Errors::MissingOauthDetails unless has_required_oauth_details?
+				@logger = Yell.new STDOUT
+				@conn = OAuth2::AccessToken.new(client, Kounta.client_token, {:refresh_token => Kounta.client_refresh_token})
+
+			end
+
+			def client
+				@oauth_client ||= OAuth2::Client.new(Kounta.client_id, Kounta.client_secret, {
+					:site => Kounta::SITE_URI,
+					:authorize_url => Kounta::AUTHORIZATION_URI,
+					:token_url => Kounta::TOKEN_URI
+				})
+			end
+
+			def path_from_hash(url_hash)
+				url_hash.map{ |key, value| value ? "#{key}/#{value}" : "#{key}" }.join('/')
+			end
+
+			def perform(url_hash, request_method, options={})
+				begin
+					log("#{request_method}: #{Kounta::SITE_URI}#{path_from_hash(url_hash)}.#{FORMAT.to_s} (#{options})")
+					response = @conn.request(request_method, "#{path_from_hash(url_hash)}.#{FORMAT.to_s}", options)
+				rescue OAuth2::Error => ex
+					if ex.message.include? 'The access token provided has expired'
+						log('oauth2 token expired, refreshing it...')
+						@conn = refreshed_token
+						retry
+					end
+				end
+				response.parsed if response
+			end
+
+			def objects_from_response(klass, request_method, url_hash, options={})
+				perform(url_hash, request_method, options).map { |response| klass.new(response) }
+			end
+
+			def object_from_response(klass, request_method, url_hash, options={})
+				klass.new( perform(url_hash, request_method, options) )
+			end
+
+			private
+
+				def has_required_oauth_details?
+					Kounta.client_id && Kounta.client_secret && Kounta.client_token && Kounta.client_refresh_token
+				end
+
+				def log(message)
+					@logger.info(message) unless !Kounta.enable_logging
+				end
+
+				def refreshed_token
+					OAuth2::AccessToken.from_hash(client, :refresh_token => Kounta.client_refresh_token).refresh!
+				end
+
+		end
+	end
+end

data/lib/kounta/site.rb

@@ -0,0 +1,42 @@
+module Kounta
+
+	class Site < Kounta::Resource
+		property :company_id
+		property :name
+		property :code
+		property :business_number
+		property :contact_person
+		property :shipping_address
+		property :postal_address
+		property :email
+		property :mobile
+		property :phone
+		property :fax
+		property :location
+		property :image
+		property :website
+		property :register_level_reconciliation
+		property :products
+		property :price_list
+
+		coerce_key :shipping_address, Kounta::Address
+		coerce_key :postal_address, Kounta::Address
+		coerce_key :price_list, Kounta::PriceList
+
+		has_one :product, Kounta::Product, {:company_id => :company_id}, lambda { |klass, item_id| {companies: klass.company_id, sites: klass.id, products: item_id} }
+		has_one :category, Kounta::Category, {:company_id => :company_id}, lambda { |klass, item_id| {companies: klass.company_id, sites: klass.id, categories: item_id} }
+		has_one :address, Kounta::Address, {:company_id => :company_id}, lambda { |klass, item_id| {companies: klass.company_id, sites: klass.id, addresses: item_id} }
+		has_one :order, Kounta::Order, {:company_id => :company_id}, lambda { |klass, item_id| {companies: klass.company_id, sites: klass.id, orders: item_id} }
+
+		has_many :products, Kounta::Product, {:company_id => :company_id}, lambda { |klass| {companies: klass.company_id, sites: klass.id, products: nil} }
+		has_many :categories, Kounta::Category, {:company_id => :company_id}, lambda { |klass| {companies: klass.company_id, sites: klass.id, categories: nil} }
+		has_many :addresses, Kounta::Address, {:company_id => :company_id}, lambda { |klass| {companies: klass.company_id, sites: klass.id, addresses: nil} }
+		has_many :orders, Kounta::Order, {:company_id => :company_id}, lambda { |klass| {companies: klass.company_id, sites: klass.id, orders: nil} }
+
+		def resource_path
+			{companies: company_id, sites: id}
+		end
+
+	end
+
+end

data/lib/kounta/tax.rb

@@ -0,0 +1,10 @@
+module Kounta
+
+	class Tax < Kounta::Resource
+		property :company_id
+		property :code
+		property :name
+		property :rate
+	end
+
+end

data/lib/kounta/version.rb

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

data/spec/helper.rb

@@ -0,0 +1,28 @@
+require 'simplecov'
+SimpleCov.start
+
+require 'rspec'
+require 'webmock/rspec'
+require 'kounta'
+
+# 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.include Helpers
+
+	config.before(:each) do
+		
+		stub_endpoints
+
+		Kounta.configure do |config|
+			config.client_id = "1234"
+			config.client_secret = "5678"
+			config.client_token = "abcd"
+			config.client_refresh_token = "efgh"
+		end
+
+	end
+
+end

data/spec/kounta/address_spec.rb

@@ -0,0 +1,11 @@
+require "helper"
+
+describe Kounta::Address do
+
+	subject { Kounta::Company.new.customer(701892).address(198109) }
+
+	it "should have a resource path" do
+		subject.resource_path.should eq({people: 701892, addresses: 198109})
+	end
+
+end

data/spec/kounta/category_spec.rb

@@ -0,0 +1,11 @@
+require "helper"
+
+describe Kounta::Category do
+
+	subject { Kounta::Company.new.category(1) }
+
+	it "should have a resource path" do
+		subject.resource_path.should eq({companies: 162, categories: 1})
+	end
+
+end

data/spec/kounta/company_spec.rb

@@ -0,0 +1,24 @@
+require "helper"
+require 'oj'
+
+describe Kounta::Company do
+
+	subject { Kounta::Company }
+
+	it "should be able to create a company from an existing hash" do
+		subject.new(Oj.load(File.read("#{Kounta.root}/spec/fixtures/companies_me.json")))
+	end
+
+	it "should be able to create a company without a hash" do
+		subject.new.should be_an_instance_of subject
+	end
+
+	it "should have a resource path" do
+		subject.new.resource_path.should eq({companies: 162})
+	end
+
+	it "should have a base price list" do
+		subject.new.base_price_list.should be_an_instance_of Kounta::PriceList
+	end
+
+end

data/spec/kounta/customer_spec.rb

@@ -0,0 +1,15 @@
+require "helper"
+
+describe Kounta::Customer do
+
+	subject { Kounta::Company.new.customer(389427) }
+
+	it "should have a name" do
+		subject.name.should eq("Samuel Richardson")
+	end
+
+	it "should have a resource path" do
+		subject.resource_path.should eq({companies: 162, customers: 389427})
+	end
+
+end

data/spec/kounta/kounta_spec.rb

@@ -0,0 +1,21 @@
+require "helper"
+
+describe Kounta do
+
+	subject { Kounta }
+
+	it "should be able to call a configure block" do
+		subject.configure do |config|
+			config.should be(Kounta)
+		end
+	end
+
+	it "should be able to configure loggin" do
+		Kounta.enable_logging.should be(false)
+		Kounta.enable_logging = true
+		Kounta.enable_logging.should be(true)
+		Kounta.enable_logging = false
+		Kounta.enable_logging.should be(false)
+	end
+
+end

data/spec/kounta/line_spec.rb

@@ -0,0 +1,14 @@
+require "helper"
+
+describe Kounta::Line do
+
+	subject { Kounta::Line.new }
+
+	it "should have a resource path" do
+		subject.company_id = 162
+		subject.order_id = 6789
+		subject.id = 1
+		subject.resource_path.should eq({companies: 162, orders: 6789, lines: 1})
+	end
+
+end

data/spec/kounta/order_spec.rb

@@ -0,0 +1,37 @@
+require "helper"
+
+describe Kounta::Order do
+
+	subject { Kounta::Company.new.customer(701892).order(93824701) }
+
+	it "should be able to add payments to new orders" do
+		new_order = Kounta::Order.new
+		new_order.payments << Kounta::Payment.new(:amount => 50.00)
+		new_order.to_hash[:payments].length.should be(1)
+		new_order.to_hash[:payments][0][:amount].should be(50.00)
+	end
+
+	it "should be able to add lines to new orders" do
+		new_order = Kounta::Order.new
+		new_order.lines << Kounta::Line.new(:quantity => 4)
+		new_order.to_hash[:lines].length.should be(1)
+		new_order.to_hash[:lines][0][:quantity].should be(4)
+	end
+
+	it "should be able to add and serialise payments to created orders" do
+		subject.payments << Kounta::Payment.new(:amount => 50.00)
+		subject.to_hash[:payments].length.should be(3)
+		subject.to_hash[:payments][2][:amount].should be(50.00)
+	end
+
+	it "should be able to add and serialise lines to created orders" do
+		subject.lines << Kounta::Line.new(:quantity => 4)
+		subject.to_hash[:lines].length.should be(3)
+		subject.to_hash[:lines][0][:quantity].should be(6)
+	end
+
+	it "should have a resource path" do
+		subject.resource_path.should eq({companies: 162, orders: 93824701})
+	end
+
+end

data/spec/kounta/payment_spec.rb

@@ -0,0 +1,14 @@
+require "helper"
+
+describe Kounta::Payment do
+
+	subject { Kounta::Payment.new }
+
+	it "should have a resource path" do
+		subject.company_id = 162
+		subject.order_id = 6789
+		subject.id = 1
+		subject.resource_path.should eq({companies: 162, orders: 6789, payments: 1})
+	end
+
+end