taxjar-ruby 1.0.0

data/spec/taxjar/api/api_spec.rb

@@ -0,0 +1,207 @@
+require 'helper'
+
+describe Taxjar::API do
+
+  before do
+    @client = Taxjar::Client.new(api_key: 'AK')
+  end
+
+  describe '#categories' do
+    before do
+      stub_get('/v2/categories').to_return(body: fixture('categories.json'),
+                                                    headers: {content_type: 'application/json; charset=utf-8'})
+
+    end
+
+    it 'requests the right resource' do
+      @client.categories
+      expect(a_get('/v2/categories')).to have_been_made
+    end
+
+    it 'returns the requested categories' do
+      categories = @client.categories
+      expect(categories).to be_an Array
+      expect(categories.first).to be_a Taxjar::Category
+      expect(categories.first.name).to eq('Digital Goods')
+    end
+  end
+
+  describe '#rate_for_location' do
+    before do
+      @postal_code = "90210"
+      stub_get("/v2/rates/#{@postal_code}").to_return(body: fixture('rates.json'),
+                                                               headers: {content_type: 'application/json; charset=utf-8'})
+
+    end
+
+    it 'requests the right resource' do
+      @client.rates_for_location(@postal_code)
+      expect(a_get("/v2/rates/#{@postal_code}")).to have_been_made
+    end
+
+    it 'returns the requested rates' do
+      rates = @client.rates_for_location(@postal_code)
+      expect(rates).to be_a Taxjar::Rate
+      expect(rates.county).to eq('LOS ANGELES')
+    end
+  end
+
+  describe "#tax_for_order" do
+    before do
+      stub_post("/v2/taxes").to_return(body: fixture('taxes.json'),
+                                                headers: {content_type: 'application/json; charset=utf-8'})
+
+      @order = {:from_country => 'US',
+                :from_zip => '07001',
+                :from_state => 'NJ',
+                :to_zip => '07446',
+                :amount => 16.50,
+                :shipping => 1.5,
+                :line_items => [{:line_item => {:quantity => 1,
+                                                :unit_price => 15.0,
+                                                :product_tax_code => '20010'}}]
+      }
+    end
+
+    it 'requests the right resource' do
+      @client.tax_for_order(@order)
+      expect(a_post("/v2/taxes")).to have_been_made
+    end
+
+    it 'returns the requested taxes' do
+      tax = @client.tax_for_order(@order)
+      expect(tax).to be_a Taxjar::Tax
+      expect(tax.tax_source).to eq('destination')
+    end
+  end
+
+  describe "#create_order" do
+    before do
+      stub_post("/v2/transactions/orders").to_return(body: fixture('order.json'),
+                                            headers: {content_type: 'application/json; charset=utf-8'})
+
+      @order = {:transaction_id => '123',
+                :transaction_date => '2015/05/14',
+                :to_country => 'US',
+                :to_zip => '90002',
+                :to_city => 'Los Angeles',
+                :to_street => '123 Palm Grove Ln',
+                :amount => 17.45,
+                :shipping => 1.5,
+                :sales_tax => 0.95,
+                :line_items => [{:quantity => 1,
+                                 :product_identifier => '12-34243-9',
+                                 :descriptiion => 'Fuzzy Widget',
+                                 :unit_price => 15.0,
+                                 :sales_tax => 0.95}]
+      }
+    end
+
+    it 'requests the right resource' do
+      @client.create_order(@order)
+      expect(a_post("/v2/transactions/orders")).to have_been_made
+    end
+
+    it 'returns the created order' do
+      order = @client.create_order(@order)
+      expect(order).to be_a Taxjar::Order
+      expect(order.transaction_id).to eq(123)
+    end
+  end
+
+  describe "#update_order" do
+    before do
+      @order_id = 123
+      stub_put("/v2/transactions/orders/#{@order_id}").to_return(body: fixture('order.json'),
+                                            headers: {content_type: 'application/json; charset=utf-8'})
+
+      @order = {:transaction_id => '123',
+                :amount => 17.95,
+                :shipping => 2.0,
+                :line_items => [{:quantity => 1,
+                                 :product_identifier => '12-34243-0',
+                                 :descriptiion => 'Heavy  Widget',
+                                 :unit_price => 15.0,
+                                 :discount => 0.0,
+                                 :sales_tax => 0.95}]
+      }
+    end
+
+    it 'requests the right resource' do
+      @client.update_order(@order)
+      expect(a_put("/v2/transactions/orders/#{@order_id}")).to have_been_made
+    end
+
+    it 'returns the updated order' do
+      order = @client.update_order(@order)
+      expect(order).to be_a Taxjar::Order
+      expect(order.transaction_id).to eq(123)
+    end
+  end
+
+  describe "#create_refund" do
+    before do
+      stub_post("/v2/transactions/refunds").to_return(body: fixture('refund.json'),
+                                            headers: {content_type: 'application/json; charset=utf-8'})
+
+      @refund = {:transaction_id => '321',
+                :transaction_date => '2015/05/14',
+                :transaction_reference_id => '123',
+                :to_country => 'US',
+                :to_zip => '90002',
+                :to_state => 'CA',
+                :to_city => 'Los Angeles',
+                :to_street => '123 Palm Grove Ln',
+                :amount => 17.45,
+                :shipping => 1.5,
+                :sales_tax => 0.95,
+                :line_items => [{:quantity => 1,
+                                 :product_identifier => '12-34243-9',
+                                 :descriptiion => 'Fuzzy Widget',
+                                 :unit_price => 15.0,
+                                 :sales_tax => 0.95}]
+      }
+    end
+
+    it 'requests the right resource' do
+      @client.create_refund(@refund)
+      expect(a_post("/v2/transactions/refunds")).to have_been_made
+    end
+
+    it 'returns the created order' do
+      refund  = @client.create_refund(@refund)
+      expect(refund).to be_a Taxjar::Refund
+      expect(refund.transaction_id).to eq(321)
+    end
+  end
+
+  describe "#update_refund" do
+    before do
+      @refund_id = 321
+      stub_put("/v2/transactions/refunds/#{@refund_id}").to_return(body: fixture('refund.json'),
+                                            headers: {content_type: 'application/json; charset=utf-8'})
+
+      @refund = {:transaction_id => '321',
+                :amount => 17.95,
+                :shipping => 2.0,
+                :sales_tax => 0.95,
+                :line_items => [{:quantity => 1,
+                                 :product_identifier => '12-34243-9',
+                                 :descriptiion => 'Heavy Widget',
+                                 :unit_price => 15.0,
+                                 :sales_tax => 0.95}]
+      }
+    end
+
+    it 'requests the right resource' do
+      @client.update_refund(@refund)
+      expect(a_put("/v2/transactions/refunds/#{@refund_id}")).to have_been_made
+    end
+
+    it 'returns the updated refund' do
+      refund = @client.update_refund(@refund)
+      expect(refund).to be_a Taxjar::Refund
+      expect(refund.transaction_id).to eq(321)
+    end
+  end
+end

data/spec/taxjar/api/request_spec.rb

@@ -0,0 +1,134 @@
+require 'helper'
+
+describe Taxjar::API::Request do
+
+  describe "#BASE_URL" do
+    it 'should have taxjar api url' do
+      expect(Taxjar::API::Request::BASE_URL).to eq('https://api.taxjar.com')
+    end
+  end
+
+  describe "attr_accessors" do
+    let(:client){ Taxjar::Client.new(api_key: 'AK')}
+    let(:subject) do
+      Taxjar::API::Request.new(client, :get, '/api_path', 'object')
+    end
+
+    it 'should return the client' do
+      expect(subject).to respond_to(:client)
+      expect(subject.client).to be(client)
+    end
+
+    it 'should return a uri' do
+      expect(subject).to respond_to(:uri)
+      expect(subject.uri).to be_instance_of(Addressable::URI)
+      expect(subject.uri.to_s).to eq('https://api.taxjar.com/api_path')
+    end
+
+    it 'should return headers' do
+      expect(subject).to respond_to(:headers)
+      expect(subject.headers).to be_instance_of(Hash)
+      expect(subject.headers[:user_agent]).to match('TaxjarRubyGem')
+      expect(subject.headers[:authorization]).to eq('Bearer AK')
+    end
+
+    it 'should return request method' do
+      expect(subject).to respond_to(:request_method)
+      expect(subject.request_method).to be_instance_of(Symbol)
+      expect(subject.request_method).to eq(:get)
+    end
+
+    it 'should return path' do
+      expect(subject).to respond_to(:path)
+      expect(subject.path).to be_instance_of(String)
+      expect(subject.path).to eq('/api_path')
+    end
+
+    it 'should return object_key' do
+      expect(subject).to respond_to(:object_key)
+      expect(subject.object_key).to be_instance_of(String)
+      expect(subject.object_key).to eq('object')
+    end
+
+    describe 'options' do
+      it 'should return options' do
+        expect(subject).to respond_to(:options)
+        expect(subject.options).to be_instance_of(Hash)
+      end
+
+      it 'should have an empty hash if no options passed to constructor' do
+        expect(subject.options).to eq({})
+      end
+
+      it 'should have options if passed to constructor' do
+        options = {city: "New York City", state: "NY"}
+        client =  Taxjar::Client.new(api_key: 'AK')
+        subject = Taxjar::API::Request.new(client, :get, '/api_path', 'object', options)
+        expect(subject.options).to eq(options)
+      end
+    end
+
+  end
+
+  describe "#perform" do
+
+    let(:client){ Taxjar::Client.new(api_key: 'AK')}
+    let(:subject) do
+      Taxjar::API::Request.new(client, :get, '/api_path', 'object')
+    end
+
+    context 'with get' do
+      it 'should return a body if no errors' do
+        stub_request(:get, "https://api.taxjar.com/api_path").
+          with(:headers => {'Authorization'=>'Bearer AK', 'Connection'=>'close',
+                            'Host'=>'api.taxjar.com',
+                            'User-Agent'=>'TaxjarRubyGem/1.0.0'}).
+          to_return(:status => 200, :body => '{"object": {"id": "3"}}',
+                    :headers => {content_type: 'application/json; charset utf-8'})
+
+
+        expect(subject.perform).to eq({id: '3'})
+      end
+    end
+
+    context 'with POST' do
+
+      let(:client){ Taxjar::Client.new(api_key: 'AK')}
+      let(:subject) do
+        Taxjar::API::Request.new(client, :post, '/api_path', 'object', {:city => "New York"})
+      end
+
+      it 'should return a body if no errors' do
+         stub_request(:post, "https://api.taxjar.com/api_path").
+                    with(:body => "{\"city\":\"New York\"}",
+                         :headers => {'Authorization'=>'Bearer AK', 'Connection'=>'close',
+                                      'Content-Type'=>'application/json',
+                                      'Host'=>'api.taxjar.com',
+                                      'User-Agent'=>'TaxjarRubyGem/1.0.0'}).
+          to_return(:status => 200, :body => '{"object": {"id": "3"}}',
+                    :headers => {content_type: 'application/json; charset utf-8'})
+
+
+        expect(subject.perform).to eq({id: '3'})
+      end
+    end
+
+    Taxjar::Error::ERRORS.each do |status, exception|
+      context "when HTTP status is #{status}" do
+        it "raises #{exception}" do
+          stub_request(:get, "https://api.taxjar.com/api_path").
+            with(:headers => {'Authorization'=>'Bearer AK', 'Connection'=>'close',
+                              'Host'=>'api.taxjar.com',
+                              'User-Agent'=>'TaxjarRubyGem/1.0.0'}).
+            to_return(:status => status, :body => '{}',
+                      :body => '{"error": "Not Acceptable",
+                                 "detail": "error explanation",
+                                 "status": "'+ status.to_s + '"}',
+                      :headers => {content_type: 'application/json; charset utf-8'})
+          expect{subject.perform}.to raise_error(exception, 'error explanation')
+        end
+      end
+    end
+  end
+
+end

data/spec/taxjar/base_spec.rb

@@ -0,0 +1,28 @@
+require 'helper'
+
+require 'helper'
+
+describe Taxjar::Base do
+
+  describe "#initialize" do
+    before do
+      @klass = Class.new(Taxjar::Base)
+      @klass.attr_reader(:field)
+    end
+
+    it 'should convert string fields to floats if it can be done' do
+      b = @klass.new(:field => '3.0')
+      expect(b.field).to eq(3.0)
+    end
+
+    it 'should convert string fields to integers if it can be done' do
+      b = @klass.new(:field => '3')
+      expect(b.field).to eq(3)
+    end
+
+    it 'it should leave string as strings' do
+      b = @klass.new(:field => 'a')
+      expect(b.field).to eq('a')
+    end
+  end
+end

data/spec/taxjar/client_spec.rb

@@ -0,0 +1,23 @@
+require 'helper'
+
+describe Taxjar::Client do
+
+  describe '#api_key?' do 
+    it 'returns true if api_key is present' do
+      client = Taxjar::Client.new(api_key: 'AK')
+      expect(client.api_key?).to be true
+    end
+
+    it 'returns false if api_key is not present' do
+      client = Taxjar::Client.new
+      expect(client.api_key?).to be false
+    end
+  end
+
+  describe '#user_agent' do
+    it 'returns string with version' do
+      client = Taxjar::Client.new(api_key: 'AK')
+      expect(client.user_agent).to eq("TaxjarRubyGem/#{Taxjar::Version}")
+    end
+  end
+end

data/spec/taxjar/error_spec.rb

@@ -0,0 +1,21 @@
+require 'helper'
+
+describe Taxjar::Error do
+
+  describe 'attributes' do
+    let(:error) { Taxjar::Error.new('unprocessable entity', 422)}
+
+    describe "#code" do
+      it 'returns the error code' do
+        expect(error.code).to eq(422)
+      end
+    end
+
+    describe "#message" do
+      it 'returns the message' do
+        expect(error.message).to eq('unprocessable entity')
+      end
+    end
+  end
+
+end

data/spec/taxjar/version_spec.rb

@@ -0,0 +1,34 @@
+require 'helper'
+
+describe Taxjar::Version do
+  before do
+    allow(Taxjar::Version).to receive(:major).and_return(1)
+    allow(Taxjar::Version).to receive(:minor).and_return(2)
+    allow(Taxjar::Version).to receive(:patch).and_return(3)
+    allow(Taxjar::Version).to receive(:pre).and_return(nil)
+  end
+
+  describe '.to_h' do
+    it 'returns a hash with the right values' do
+      expect(Taxjar::Version.to_h).to be_a Hash
+      expect(Taxjar::Version.to_h[:major]).to eq(1)
+      expect(Taxjar::Version.to_h[:minor]).to eq(2)
+      expect(Taxjar::Version.to_h[:patch]).to eq(3)
+      expect(Taxjar::Version.to_h[:pre]).to eq(nil)
+    end
+  end
+
+  describe '.to_a' do
+    it 'returns an array with the right values' do
+      expect(Taxjar::Version.to_a).to be_an Array
+      expect(Taxjar::Version.to_a).to eq([1, 2, 3])
+    end
+  end
+
+  describe '.to_s' do
+    it 'returns a string with the right value' do
+      expect(Taxjar::Version.to_s).to be_a String
+      expect(Taxjar::Version.to_s).to eq('1.2.3')
+    end
+  end
+end