kounta_rest 0.0.1

data/spec/kounta/product_spec.rb

@@ -0,0 +1,16 @@
+require "helper"
+
+describe Kounta::Product do
+
+	subject { Kounta::Company.new.site(985).product(1) }
+
+	it "should be able to to test for tags" do
+		subject.tags_include?("Rosebud").should be(false)
+		subject.tags_include?("Fragile").should be(true)
+	end
+
+	it "should have a resource path" do
+		subject.resource_path.should eq({companies: 162, products: 1})
+	end
+
+end

data/spec/kounta/resource_spec.rb

@@ -0,0 +1,95 @@
+require "helper"
+
+describe Kounta::Resource do
+
+	subject { Kounta::Resource }
+
+	before :each do
+		subject.has_one(:address, Kounta::Address, {:company_id => :id}, lambda { |klass, item_id| {companies: klass.id, addresses: item_id} })
+		subject.has_many :addresses, Kounta::Address, {:company_id => :id}, lambda { |klass| {companies: klass.id, addresses: nil} }
+		@instance = subject.new({:id => 345})
+	end
+
+	it "should populate details if created with a hash" do
+		@instance.id.should be(345)
+	end
+
+	it "should coerce an array of data to itself" do
+		results = subject.coerce [{:id => 1}, {:id => 2}, {:id => 3}]
+		results.each do |result|
+			result.should be_an_instance_of subject
+		end
+	end
+
+	it "should create a has_one relationship mapping" do
+		@instance.should respond_to(:address)
+	end
+
+	it "should respond with an object when supplied with an id" do
+		@instance.address(1).should be_an_instance_of Kounta::Address
+		WebMock.should have_requested(:get, singular_endpoint('addresses'))
+	end
+
+	it "should be able to create an empty instance of the has_one relationship and apply mappings to it" do
+		@instance.id = 162
+		address = @instance.address
+		address.should be_an_instance_of Kounta::Address
+		address.company_id.should be(162)
+	end
+
+	it "should create a has_many relationship mapping" do
+		@instance.should respond_to(:addresses)
+	end
+
+	it "should respond with an array of objects" do
+		@instance.addresses.each do |address|
+			address.should be_an_instance_of Kounta::Address
+		end
+	end
+
+	it "should apply assignments to the has_many relationship" do
+		@instance.addresses.each do |address|
+			address.company_id.should be(@instance.id)
+		end
+	end
+
+	it "should have a reference to the rest client" do
+		@instance.client.should be_an_instance_of Kounta::REST::Client
+	end
+
+	it "should be able to serialise itself to a hash" do
+		@instance.to_hash.should eq({:id => 345})
+		@instance.to_hash({:merge => "me"}).should eq({:id => 345, :merge => "me"})
+	end
+
+	it "should raise an error when presented with an unknown attribute" do
+		expect { subject.new({:id => 345, :new_attribute => 'value'}) }.to raise_error Kounta::Errors::UnknownResourceAttribute
+	end
+
+	it "should be able to save a new object" do
+		subject.property :number
+		subject.property :product_id
+		subject.property :quantity
+		subject.property :notes
+		subject.property :price_variation
+		instance = subject.new
+		instance.id = nil
+		instance.define_singleton_method :resource_path, lambda { {companies: 162, orders: 6789, lines: nil} }
+		instance.save!.should be_an_instance_of subject
+		WebMock.should have_requested(:post, group_endpoint('lines'))
+	end
+
+	it "should be able to update an existing object" do
+		subject.property :number
+		subject.property :product_id
+		subject.property :quantity
+		subject.property :notes
+		subject.property :price_variation
+		instance = subject.new
+		instance.id = 162
+		instance.define_singleton_method :resource_path, lambda { {companies: 162, orders: 6789, lines: 2345} }
+		instance.save!.should be_an_instance_of subject
+		WebMock.should have_requested(:put, singular_endpoint('lines'))
+	end
+
+end

data/spec/kounta/rest/client_spec.rb

@@ -0,0 +1,38 @@
+require "helper"
+
+describe Kounta::REST::Client do
+
+	subject { Kounta::REST::Client.new }
+
+	it "should throw an error when creating a client without required tokens" do
+		Kounta.client_token = nil
+		expect { Kounta::REST::Client.new }.to raise_error Kounta::Errors::MissingOauthDetails
+	end
+
+	it "should be able to create a new client" do
+		subject.should be_an_instance_of(Kounta::REST::Client)
+	end
+
+	it "should be able to generate a url from an ordered hash" do
+		subject.path_from_hash({companies: 162, products: nil}).should eq("companies/162/products")
+		subject.path_from_hash({companies: 162, products: 1234}).should eq("companies/162/products/1234")
+	end
+
+	it "should be able to create objects from a response" do
+		responses = subject.objects_from_response(Kounta::Product, :get, {companies: 162, products: nil})
+		responses.each do |response|
+			response.should be_an_instance_of Kounta::Product
+		end
+	end
+
+	it "should be able to create an object from a response" do
+		subject.object_from_response(Kounta::Product, :get, {companies: 162, products: 555}).should be_an_instance_of Kounta::Product
+	end
+
+	it "should refresh the token automatically" do
+		stub_request(:get, group_endpoint('noop')).to_return(:body => {:message => "The access token provided has expired"}, :headers => endpoint_headers, :status => 400)
+		stub_request(:post, "https://api.kounta.com/v1/token.json")
+		expect { subject.perform({:company_id => 123, :noop => nil}, :get) }.to raise_error OAuth2::Error
+	end
+
+end

data/spec/kounta/site_spec.rb

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

data/spec/support/endpoints.rb

@@ -0,0 +1,67 @@
+module Helpers
+
+	def company_me_endpoint
+		/\/.+\/companies\/me\.json/
+	end
+
+	def base_pricelist_endpoint
+		/\/.+\/price_lists\/base\.json/
+	end
+
+	def singular_endpoint(name)
+		/\/.+\/#{name}\/\d+\.json/
+	end
+
+	def group_endpoint(name)
+		/\/.+\/#{name}\.json/
+	end
+
+	def load_json_from_fixture(filename)
+		File.read("#{Kounta.root}/spec/fixtures/#{filename}")
+	end
+
+	def endpoint_headers
+		{'Content-Type' => 'application/json'}
+	end
+
+	def stub_endpoints
+
+		# create
+		stub_request(:post, group_endpoint('products')).to_return(:body => load_json_from_fixture('product.json'), :headers => endpoint_headers)
+		stub_request(:post, group_endpoint('customers')).to_return(:body => load_json_from_fixture('customer.json'), :headers => endpoint_headers)
+		stub_request(:post, group_endpoint('categories')).to_return(:body => load_json_from_fixture('category.json'), :headers => endpoint_headers)
+		stub_request(:post, group_endpoint('addresses')).to_return(:body => load_json_from_fixture('address.json'), :headers => endpoint_headers)
+		stub_request(:post, group_endpoint('payments')).to_return(:body => load_json_from_fixture('payment.json'), :headers => endpoint_headers)
+		stub_request(:post, group_endpoint('lines')).to_return(:body => load_json_from_fixture('line.json'), :headers => endpoint_headers)
+		stub_request(:post, group_endpoint('orders')).to_return(:body => load_json_from_fixture('order.json'), :headers => endpoint_headers)
+
+		# read
+		stub_request(:get, singular_endpoint('categories')).to_return(:body => load_json_from_fixture('category.json'), :headers => endpoint_headers)
+		stub_request(:get, group_endpoint('categories')).to_return(:body => load_json_from_fixture('categories.json'), :headers => endpoint_headers)
+		stub_request(:get, singular_endpoint('customers')).to_return(:body => load_json_from_fixture('customer.json'), :headers => endpoint_headers)
+		stub_request(:get, group_endpoint('customers')).to_return(:body => load_json_from_fixture('customers.json'), :headers => endpoint_headers)
+		stub_request(:get, singular_endpoint('addresses')).to_return(:body => load_json_from_fixture('address.json'), :headers => endpoint_headers)
+		stub_request(:get, group_endpoint('addresses')).to_return(:body => load_json_from_fixture('addresses.json'), :headers => endpoint_headers)
+		stub_request(:get, singular_endpoint('products')).to_return(:body => load_json_from_fixture('product.json'), :headers => endpoint_headers)
+		stub_request(:get, group_endpoint('products')).to_return(:body => load_json_from_fixture('products.json'), :headers => endpoint_headers)
+		stub_request(:get, singular_endpoint('sites')).to_return(:body => load_json_from_fixture('site.json'), :headers => endpoint_headers)
+		stub_request(:get, group_endpoint('sites')).to_return(:body => load_json_from_fixture('sites.json'), :headers => endpoint_headers)
+		stub_request(:get, singular_endpoint('price_lists')).to_return(:body => load_json_from_fixture('price_list.json'), :headers => endpoint_headers)
+		stub_request(:get, group_endpoint('price_lists')).to_return(:body => load_json_from_fixture('price_lists.json'), :headers => endpoint_headers)
+		stub_request(:get, base_pricelist_endpoint).to_return(:body => load_json_from_fixture('price_list.json'), :headers => endpoint_headers)
+		stub_request(:get, company_me_endpoint).to_return(:body => load_json_from_fixture('companies_me.json'), :headers => endpoint_headers)
+		stub_request(:get, group_endpoint('taxes')).to_return(:body => load_json_from_fixture('taxes.json'), :headers => endpoint_headers)
+		stub_request(:get, singular_endpoint('orders')).to_return(:body => load_json_from_fixture('order.json'), :headers => endpoint_headers)
+		stub_request(:get, group_endpoint('orders')).to_return(:body => load_json_from_fixture('orders.json'), :headers => endpoint_headers)
+
+		# update
+		stub_request(:put, singular_endpoint('products')).to_return(:body => load_json_from_fixture('product.json'), :headers => endpoint_headers)
+		stub_request(:put, singular_endpoint('customers')).to_return(:body => load_json_from_fixture('customer.json'), :headers => endpoint_headers)
+		stub_request(:put, singular_endpoint('categories')).to_return(:body => load_json_from_fixture('category.json'), :headers => endpoint_headers)
+		stub_request(:put, singular_endpoint('addresses')).to_return(:body => load_json_from_fixture('address.json'), :headers => endpoint_headers)
+		stub_request(:put, singular_endpoint('payments')).to_return(:body => load_json_from_fixture('payment.json'), :headers => endpoint_headers)
+		stub_request(:put, singular_endpoint('lines')).to_return(:body => load_json_from_fixture('line.json'), :headers => endpoint_headers)
+		stub_request(:put, singular_endpoint('orders')).to_return(:body => load_json_from_fixture('order.json'), :headers => endpoint_headers)
+
+	end
+end

metadata

@@ -0,0 +1,236 @@
+--- !ruby/object:Gem::Specification
+name: kounta_rest
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Samuel Richardson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-11-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.13.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.13.0
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.1.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.1.4
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.5
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.12.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.12.2
+- !ruby/object:Gem::Dependency
+  name: yell
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.5.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.5.1
+description: Library for accessing Kountas RESTful API
+email:
+- sam@richardson.co.nz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .gitmodules
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- console.rb
+- kounta.gemspec
+- lib/kounta.rb
+- lib/kounta/address.rb
+- lib/kounta/category.rb
+- lib/kounta/company.rb
+- lib/kounta/customer.rb
+- lib/kounta/errors.rb
+- lib/kounta/line.rb
+- lib/kounta/order.rb
+- lib/kounta/payment.rb
+- lib/kounta/price_list.rb
+- lib/kounta/product.rb
+- lib/kounta/resource.rb
+- lib/kounta/rest/client.rb
+- lib/kounta/site.rb
+- lib/kounta/tax.rb
+- lib/kounta/version.rb
+- spec/helper.rb
+- spec/kounta/address_spec.rb
+- spec/kounta/category_spec.rb
+- spec/kounta/company_spec.rb
+- spec/kounta/customer_spec.rb
+- spec/kounta/kounta_spec.rb
+- spec/kounta/line_spec.rb
+- spec/kounta/order_spec.rb
+- spec/kounta/payment_spec.rb
+- spec/kounta/product_spec.rb
+- spec/kounta/resource_spec.rb
+- spec/kounta/rest/client_spec.rb
+- spec/kounta/site_spec.rb
+- spec/support/endpoints.rb
+homepage: http://www.richardson.co.nz
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Will write this
+test_files:
+- spec/helper.rb
+- spec/kounta/address_spec.rb
+- spec/kounta/category_spec.rb
+- spec/kounta/company_spec.rb
+- spec/kounta/customer_spec.rb
+- spec/kounta/kounta_spec.rb
+- spec/kounta/line_spec.rb
+- spec/kounta/order_spec.rb
+- spec/kounta/payment_spec.rb
+- spec/kounta/product_spec.rb
+- spec/kounta/resource_spec.rb
+- spec/kounta/rest/client_spec.rb
+- spec/kounta/site_spec.rb
+- spec/support/endpoints.rb