click_and_send 0.1.1 → 0.2.0

data/lib/click_and_send/version.rb

@@ -1,3 +1,3 @@
 module ClickAndSend
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

data/lib/click_and_send.rb

@@ -72,6 +72,22 @@ module ClickAndSend
       end
     end
 
+    def item_pdf_url(ref)
+      ref = ref.to_s
+      tracking_numbers = find_tracking_numbers([ref])[ref] || {}
+      case tracking_numbers.length
+      when 0 then raise(Errors::APIError, "Not found: '#{ref}'")
+      when 1 then tracking_number = tracking_numbers.first
+      else
+        raise(Errors::APIError, "Expected 1 but found #{tracking_numbers.length} tracking numbers for '#{ref}': #{tracking_numbers.join(', ')}")
+      end
+      hash = ActiveSupport::OrderedHash.new
+      hash['PrintFormat'      ] = 'LINK'
+      hash['CustTransactionID'] = ref
+      hash['TrackingNumber'   ] = tracking_number
+      Request::PrintItem.new(hash).result
+    end
+
     def item_summary
       Request::ItemSummary.new.result.fetch(:item_summary_transaction)
     end
@@ -91,23 +107,22 @@ module ClickAndSend
       ClickAndSend::Request::ManifestItems.new(options).result
     end
 
-    def pdf_url(ref)
-      ref = ref.to_s
-      tracking_numbers = find_tracking_numbers([ref])[ref] || {}
-      case tracking_numbers.length
-      when 0 then raise(Errors::APIError, "Not found: '#{ref}'")
-      when 1 then tracking_number = tracking_numbers.first
-      else
-        raise(Errors::APIError, "Expected 1 but found #{tracking_numbers.length} tracking numbers for '#{ref}': #{tracking_numbers.join(', ')}")
-      end
-      hash = ActiveSupport::OrderedHash.new
-      hash['PrintFormat'      ] = 'LINK'
-      hash['CustTransactionID'] = ref
-      hash['TrackingNumber'   ] = tracking_number
-      Request::PrintItem.new(hash).result
+    def manifest_items_by_refs(refs)
+      tracking_numbers = find_tracking_numbers(refs)
+      options = {
+        'ManifestItems' => refs.collect do |ref|
+          {
+            'ManifestItem' => ActiveSupport::OrderedHash.new.tap do |hash|
+              hash['CustTransactionID'] = ref.to_s
+              hash['TrackingNumber'   ] = tracking_numbers[ref.to_s].first
+            end
+          }
+        end
+      }
+      manifest_items(options)
     end
 
-    def print_manifest(options)
+    def manifest_pdf_url(options)
       ensure_keys_present(options, %w(PrintFormat PrintDetails ManifestNumber))
       ClickAndSend::Request::PrintManifest.new(options).result.fetch(:manifest_http_link)
     end

data/spec/acceptance_spec.rb

@@ -36,8 +36,8 @@ describe ClickAndSend, :acceptance do
       end
     end
 
-    describe '.pdf_url' do
-      subject { ClickAndSend.pdf_url(ref) }
+    describe '.item_pdf_url' do
+      subject { ClickAndSend.item_pdf_url(ref) }
       it "returns URL for PDF" do
         subject.should be_a(String)
         open(subject).content_type.should eq('application/pdf')
@@ -119,8 +119,8 @@ describe ClickAndSend, :acceptance do
       end
     end
 
-    describe '.print_manifest' do
-      let(:print_manifest) { ClickAndSend.print_manifest(options) }
+    describe '.manifest_pdf_url' do
+      let(:manifest_pdf_url) { ClickAndSend.manifest_pdf_url(options) }
       let(:options) do
         ActiveSupport::OrderedHash.new.tap do |hash|
           hash['PrintFormat']    = 'LINK'
@@ -130,9 +130,22 @@ describe ClickAndSend, :acceptance do
       end
 
       it "returns URL for PDF" do
-        print_manifest.should be_a(String)
-        open(print_manifest).content_type.should eq('application/pdf')
+        manifest_pdf_url.should be_a(String)
+        open(manifest_pdf_url).content_type.should eq('application/pdf')
       end
     end
   end
+
+  describe '.manifest_items_by_refs' do
+    subject { ClickAndSend.manifest_items_by_refs(refs) }
+    let(:items_created) { ClickAndSend.create_items('Transactions' => attributes_for('Transaction')) }
+    let(:ref) { items_created.fetch(:cust_transaction_id) }
+    let(:refs) { [ref] }
+
+    it "returns manifest number and total charges/taxes" do
+      expect { subject }.not_to raise_error
+      subject.should be_a(Hash)
+      subject.keys.should =~ [:manifest_number, :total_charge, :total_taxes]
+    end
+  end
 end

data/spec/click_and_send_spec.rb

@@ -143,34 +143,8 @@ describe ClickAndSend do
       end
     end
 
-    describe '.item_summary' do
-      subject { ClickAndSend.item_summary }
-      it "fetches :item_summary_transaction from ItemSummary result" do
-        ClickAndSend::Request::ItemSummary.should_receive(:new) do
-          stub(:result => {:item_summary_transaction => 'items'})
-        end
-        subject.should eq('items')
-      end
-    end
-
-    describe '.manifest_items' do
-      subject { ClickAndSend.manifest_items(options) }
-      let(:required_inputs) { %w(ManifestItems) }
-      it_behaves_like "data required"
-
-      context "when input has valid keys" do
-        it "calls ManifestItems result" do
-          manifest_items = stub
-          options = {'ManifestItems' => stub}
-          ClickAndSend::Request::ManifestItems.should_receive(:new).with(options) { manifest_items }
-          manifest_items.should_receive(:result)
-          ClickAndSend.manifest_items(options)
-        end
-      end
-    end
-
-    describe '.pdf_url' do
-      subject { ClickAndSend.pdf_url('REF') }
+    describe '.item_pdf_url' do
+      subject { ClickAndSend.item_pdf_url('REF') }
       let(:options) do
         {
           'PrintFormat' => 'LINK',
@@ -178,7 +152,7 @@ describe ClickAndSend do
           'TrackingNumber' => tracking_numbers.first
         }
       end
-      let(:pdf_url) { 'http://example.com/paperwork.pdf' }
+      let(:item_pdf_url) { 'http://example.com/paperwork.pdf' }
       before do
         ClickAndSend.stub(:find_tracking_numbers).with(['REF']) do
           {'REF' => tracking_numbers}
@@ -189,9 +163,9 @@ describe ClickAndSend do
         let(:tracking_numbers) { ['xyz'] }
         specify "requests URL from PrintItem" do
           ClickAndSend::Request::PrintItem.should_receive(:new).with(options) do
-            stub(:result => pdf_url)
+            stub(:result => item_pdf_url)
           end
-          subject.should eq(pdf_url)
+          subject.should eq(item_pdf_url)
         end
       end
 
@@ -210,23 +184,76 @@ describe ClickAndSend do
       end
     end
 
-    describe '.print_manifest' do
-      subject { ClickAndSend.print_manifest(options) }
+    describe '.item_summary' do
+      subject { ClickAndSend.item_summary }
+      it "fetches :item_summary_transaction from ItemSummary result" do
+        ClickAndSend::Request::ItemSummary.should_receive(:new) do
+          stub(:result => {:item_summary_transaction => 'items'})
+        end
+        subject.should eq('items')
+      end
+    end
+
+    describe '.manifest_items' do
+      subject { ClickAndSend.manifest_items(options) }
+      let(:required_inputs) { %w(ManifestItems) }
+      it_behaves_like "data required"
+
+      context "when input has valid keys" do
+        it "calls ManifestItems result" do
+          manifest_items = stub
+          options = {'ManifestItems' => stub}
+          ClickAndSend::Request::ManifestItems.should_receive(:new).with(options) { manifest_items }
+          manifest_items.should_receive(:result)
+          ClickAndSend.manifest_items(options)
+        end
+      end
+    end
+
+    describe '.manifest_items_by_refs' do
+      subject { ClickAndSend.manifest_items_by_refs(refs, options) }
+      let(:manifest_items) do
+        {
+          'ManifestItems' => [
+            {
+              'ManifestItem' => ActiveSupport::OrderedHash.new.tap do |hash|
+                hash['CustTransactionID'] = ref
+                hash['TrackingNumber'   ] = tracking_number
+              end
+            }
+          ]
+        }
+      end
+      let(:options) { stub }
+      let(:print_manifest) { stub }
+      let(:ref) { stub.tap { |ref| ref.stub(:to_s) { ref } } }
+      let(:refs) { [ref] }
+      let(:tracking_number) { stub }
+
+      it "retrieves tracking numbers and calls manifest_items" do
+        ClickAndSend.should_receive(:find_tracking_numbers).with(refs) { {ref => [tracking_number]} }
+        ClickAndSend.should_receive(:manifest_items).with(manifest_items) { print_manifest }
+        ClickAndSend.manifest_items_by_refs(refs).should eq(print_manifest)
+      end
+    end
+
+    describe '.manifest_pdf_url' do
+      subject { ClickAndSend.manifest_pdf_url(options) }
       let(:required_inputs) { %w(PrintFormat PrintDetails ManifestNumber) }
       it_behaves_like "data required"
 
       context "when input has valid keys" do
         it "calls PrintManifest result" do
           result = stub
-          print_manifest = stub(:result => result)
+          manifest_pdf_url = stub(:result => result)
           result.stub(:fetch).with(:manifest_http_link) { 'the link' }
           options = ActiveSupport::OrderedHash.new.tap do |hash|
             required_inputs.each do |required_input|
               hash[required_input] = stub
             end
           end
-          ClickAndSend::Request::PrintManifest.should_receive(:new).with(options) { print_manifest }
-          ClickAndSend.print_manifest(options).should eq('the link')
+          ClickAndSend::Request::PrintManifest.should_receive(:new).with(options) { manifest_pdf_url }
+          ClickAndSend.manifest_pdf_url(options).should eq('the link')
         end
       end
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: click_and_send
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -178,7 +178,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2750192198691146344
+      hash: -2505933282695818565
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -187,7 +187,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2750192198691146344
+      hash: -2505933282695818565
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24