taxjar-ruby 1.0.1 → 1.1.0

data/lib/taxjar/api/api.rb

@@ -15,23 +15,5 @@ module Taxjar
       perform_post_with_object("/v2/taxes", 'tax', options, Taxjar::Tax)
     end
 
-    def create_order(options = {})
-      perform_post_with_object("/v2/transactions/orders", 'order', options, Taxjar::Order)
-    end
-
-    def update_order(options = {})
-      id = options.fetch(:transaction_id)
-      perform_put_with_object("/v2/transactions/orders/#{id}", 'order', options, Taxjar::Order)
-    end
-
-    def create_refund(options = {})
-      perform_post_with_object("/v2/transactions/refunds", 'refund', options, Taxjar::Refund)
-    end
-
-    def update_refund(options = {})
-      id = options.fetch(:transaction_id)
-      perform_put_with_object("/v2/transactions/refunds/#{id}", 'refund', options, Taxjar::Refund)
-    end
-
   end
 end

data/lib/taxjar/api/order.rb

@@ -0,0 +1,29 @@
+require 'taxjar/api/utils'
+module Taxjar
+  module API
+    module Order
+      include Taxjar::API::Utils
+
+      def list_orders(options = {})
+        perform_get_with_array("/v2/transactions/orders", 'orders', options)
+      end
+
+      def show_order(id, options = {})
+        perform_get_with_object("/v2/transactions/orders/#{id}", 'order', options, Taxjar::Order)
+      end
+
+      def create_order(options = {})
+        perform_post_with_object("/v2/transactions/orders", 'order', options, Taxjar::Order)
+      end
+
+      def update_order(options = {})
+        id = options.fetch(:transaction_id)
+        perform_put_with_object("/v2/transactions/orders/#{id}", 'order', options, Taxjar::Order)
+      end
+
+      def delete_order(id, options={})
+        perform_delete_with_object("/v2/transactions/orders/#{id}", 'order', options, Taxjar::Order)
+      end
+    end
+  end
+end

data/lib/taxjar/api/refund.rb

@@ -0,0 +1,29 @@
+require 'taxjar/api/utils'
+module Taxjar
+  module API
+    module Refund
+      include Taxjar::API::Utils
+
+      def list_refunds(options = {})
+        perform_get_with_array("/v2/transactions/refunds", 'refunds', options)
+      end
+
+      def show_refund(id, options = {})
+        perform_get_with_object("/v2/transactions/refunds/#{id}", 'refund', options, Taxjar::Refund)
+      end
+
+      def create_refund(options = {})
+        perform_post_with_object("/v2/transactions/refunds", 'refund', options, Taxjar::Refund)
+      end
+
+      def update_refund(options = {})
+        id = options.fetch(:transaction_id)
+        perform_put_with_object("/v2/transactions/refunds/#{id}", 'refund', options, Taxjar::Refund)
+      end
+
+      def delete_refund(id, options={})
+        perform_delete_with_object("/v2/transactions/refunds/#{id}", 'refund', options, Taxjar::Refund)
+      end
+    end
+  end
+end

data/lib/taxjar/api/utils.rb

@@ -16,6 +16,10 @@ module Taxjar
         perform_request_with_objects(:get, path, object_key, options, klass)
       end
 
+      def perform_get_with_array(path, object_key, options)
+        perform_request_with_array(:get, path, object_key, options)
+      end
+
       def perform_post_with_object(path, object_key, options, klass)
         perform_request_with_object(:post, path, object_key, options, klass)
       end
@@ -24,6 +28,10 @@ module Taxjar
         perform_request_with_object(:put, path, object_key, options, klass)
       end
 
+      def perform_delete_with_object(path, object_key, options, klass)
+        perform_request_with_object(:delete, path, object_key, options, klass)
+      end
+
       def perform_request_with_object(request_method, path, object_key, options, klass)
         response = perform_request(request_method, path, object_key, options)
         klass.new(response)
@@ -35,6 +43,10 @@ module Taxjar
           klass.new(element)
         end
       end
+
+      def perform_request_with_array(request_method, path, object_key, options)
+        perform_request(request_method, path, object_key, options) || []
+      end
     end
   end
 end

data/lib/taxjar/base.rb

@@ -2,6 +2,27 @@ require 'addressable/uri'
 require 'forwardable'
 require 'memoizable'
 
+if !Array.new.respond_to?(:to_h)
+  module Enumerable
+    def to_h(*arg)
+      h = {}
+      each_with_index(*arg) do |elem, i|
+        unless elem.respond_to?(:to_ary)
+          raise TypeError, "wrong element type #{elem.class} at #{i} (expected array)"
+        end
+
+        ary = elem.to_ary
+        if ary.size != 2
+          raise ArgumentError, "wrong array length at #{i} (expected 2, was #{ary.size})"
+        end
+
+        h[ary[0]] = ary[1]
+      end
+      h
+    end
+  end
+end
+
 module Taxjar
   class Base
     extend Forwardable

data/lib/taxjar/client.rb

@@ -1,10 +1,15 @@
 require 'taxjar/api/api'
+require 'taxjar/api/order'
+require 'taxjar/api/refund'
 require 'taxjar/error'
 require 'taxjar/api/request'
 require 'taxjar/api/utils'
 module Taxjar
   class Client
     include Taxjar::API
+    include Taxjar::API::Order
+    include Taxjar::API::Refund
+
     attr_accessor :api_key
 
     def initialize(options = {})

data/lib/taxjar/version.rb

@@ -7,11 +7,11 @@ module Taxjar
     end
 
     def minor
-      0
+      1
     end
 
     def patch
-      1
+      0
     end
 
     def pre

data/spec/fixtures/orders.json

@@ -0,0 +1,6 @@
+{
+  "orders": [
+    "123",
+    "456"
+  ]
+}

data/spec/fixtures/refunds.json

@@ -0,0 +1,6 @@
+{
+  "refunds": [
+    "321",
+    "654"
+  ]
+}

data/spec/helper.rb

@@ -19,6 +19,10 @@ def a_post(path)
   a_request(:post, Taxjar::API::Request::BASE_URL + path)
 end
 
+def a_delete(path)
+  a_request(:delete, Taxjar::API::Request::BASE_URL + path)
+end
+
 def a_put(path)
   a_request(:put, Taxjar::API::Request::BASE_URL + path)
 end
@@ -35,6 +39,10 @@ def stub_put(path)
   stub_request(:put, Taxjar::API::Request::BASE_URL + path)
 end
 
+def stub_delete(path)
+  stub_request(:delete, Taxjar::API::Request::BASE_URL + path)
+end
+
 def fixture_path
     File.expand_path('../fixtures', __FILE__)
 end

data/spec/taxjar/api/api_spec.rb

@@ -74,134 +74,4 @@ describe Taxjar::API do
       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/order_spec.rb

@@ -0,0 +1,156 @@
+require 'helper'
+
+describe Taxjar::API::Order do
+
+  before do
+    @client = Taxjar::Client.new(api_key: 'AK')
+  end
+
+  describe "#list_orders" do
+    context "without parameters" do
+      before do
+        stub_get('/v2/transactions/orders').to_return(body: fixture('orders.json'),
+                                                      headers: {content_type: 'application/json; charset=utf-8'})
+
+      end
+
+      it 'requests the right resource' do
+        @client.list_orders
+        expect(a_get('/v2/transactions/orders')).to have_been_made
+      end
+
+      it 'returns the requested orders' do
+        orders = @client.list_orders
+        expect(orders).to be_an Array
+        expect(orders.first).to be_a String
+        expect(orders.first).to eq('123')
+      end
+    end
+
+    context "with parameters" do
+      before do
+        stub_get('/v2/transactions/orders?from_transaction_date=2015/05/01&to_transaction_date=2015/05/31').
+          to_return(body: fixture('orders.json'),
+                    headers: {content_type: 'application/json; charset=utf-8'})
+
+      end
+
+      it 'requests the right resource' do
+        @client.list_orders(from_transaction_date: '2015/05/01',
+                                     to_transaction_date: '2015/05/31')
+        expect(a_get('/v2/transactions/orders?from_transaction_date=2015/05/01&to_transaction_date=2015/05/31')).to have_been_made
+      end
+
+      it 'returns the requested orders' do
+        orders = @client.list_orders(from_transaction_date: '2015/05/01',
+                                     to_transaction_date: '2015/05/31')
+        expect(orders).to be_an Array
+        expect(orders.first).to be_a String
+        expect(orders.first).to eq('123')
+      end
+    end
+  end
+
+  describe "#show_order" do
+    before do
+        stub_get('/v2/transactions/orders/123').
+          to_return(body: fixture('order.json'),
+                    headers: {content_type: 'application/json; charset=utf-8'})
+    end
+
+    it 'requests the right resource' do
+      @client.show_order('123')
+      expect(a_get('/v2/transactions/orders/123')).to have_been_made
+    end
+
+    it 'returns the requested order' do
+      order = @client.show_order('123')
+      expect(order).to be_an Taxjar::Order
+      expect(order.transaction_id).to eq(123)
+    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 "#delete_order" do
+    before do
+        stub_delete('/v2/transactions/orders/123').
+          to_return(body: fixture('order.json'),
+                    headers: {content_type: 'application/json; charset=utf-8'})
+    end
+
+    it 'requests the right resource' do
+      @client.delete_order('123')
+      expect(a_delete('/v2/transactions/orders/123')).to have_been_made
+    end
+
+    it 'returns the deleted order' do
+      order = @client.delete_order('123')
+      expect(order).to be_an Taxjar::Order
+      expect(order.transaction_id).to eq(123)
+    end
+  end
+
+end