peddler 0.1.3

data/spec/peddler/feeds_spec.rb

@@ -0,0 +1,80 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper") 
+
+module Peddler
+  module Feeds
+    module OrderFulfillment
+      describe Batch do
+        before(:each) do
+          @transport = Peddler::Transport.new
+          @transport.modernize_request
+          @feed = Peddler::Feeds::OrderFulfillment::Batch.new(@transport)
+          @fulfilled_order = Peddler::Feeds::OrderFulfillment::Item.new :order_id  => "123-1234567-1234567",
+                                                                 :ship_date => Date.parse("2009-08-11").to_s
+        end
+      
+        it "should add items to batch" do
+          @feed.batch.size.should == 0
+          @feed << @fulfilled_order
+          @feed.batch.size.should == 1
+        end
+    
+        it "should create content for upload" do
+          @feed << @fulfilled_order
+          @feed.file_content.should == "order-id\torder-item-id\tquantity\tship-date\tcarrier-code\tcarrier-name\ttracking-number\tship-method\r\n123-1234567-1234567\t\t\t2009-08-11\t\t\t\t\r\n"
+        end
+  
+        it "should upload" do
+          @feed.id.should == nil
+          @transport.stub!(:execute_request).and_return('<Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://merchant-query.amazon.com/query/schema/MerchantQueryResponses.xsd"><Upload> <UploadId>130895733</UploadId><UploadType>_POST_FLAT_FILE_FULFILLMENT_DATA_</UploadType><UploadStatus>_SUBMITTED_</UploadStatus><SubmittedDate>2007-04-05T00:34:00+0000</SubmittedDate></Upload></Response>')
+          @feed.upload
+          @feed.id.should == "130895733"
+          @feed.status.should == "_SUBMITTED_"
+        end
+        
+        it "should refresh status" do
+          @transport.stub!(:execute_request).and_return('<Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://merchant-query.amazon.com/query/schema/MerchantQueryResponses.xsd"><Upload> <UploadId>130895733</UploadId><UploadType>_POST_FLAT_FILE_FULFILLMENT_DATA_</UploadType><UploadStatus>_SUBMITTED_</UploadStatus><SubmittedDate>2007-04-05T00:34:00+0000</SubmittedDate></Upload></Response>')
+          @feed.upload
+          @transport.stub!(:execute_request).and_return('<Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://merchant-query.amazon.com/query/schema/MerchantQueryResponses.xsd"><UploadsStatusList><Upload><UploadId>130895733</UploadId><UploadType>_POST_FLAT_FILE_FULFILLMENT_DATA_</UploadType><UploadStatus>_IN_PROGRESS_</UploadStatus><SubmittedDate>2007-04-05T00:34:00+0000</SubmittedDate><StartedProcessingDate>2007-04-05T00:39:00+0000</StartedProcessingDate></Upload></UploadsStatusList></Response>')
+          @feed.status.should == "_SUBMITTED_"
+          @feed.status!.should == "_IN_PROGRESS_"
+          @transport.stub!(:execute_request).and_return('<Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://merchant-query.amazon.com/query/schema/MerchantQueryResponses.xsd"><UploadsStatusList><Upload><UploadId>130895733</UploadId><UploadType>_POST_FLAT_FILE_FULFILLMENT_DATA_</UploadType><UploadStatus>_DONE_</UploadStatus><SubmittedDate>2007-04-05T00:34:00+0000</SubmittedDate><StartedProcessingDate>2007-04-05T00:39:00+0000</StartedProcessingDate><CompletedProcessingDate>2007-04-05T01:02:00+0000</CompletedProcessingDate><MessagesProcessed>2</MessagesProcessed><MessagesSuccessful>2</MessagesSuccessful><MessagesWithErrors>0</MessagesWithErrors><MessagesWithWarnings>0</MessagesWithWarnings><RelatedDownloadsList><Download><DownloadId>3404021</DownloadId><DownloadType>FeedSummaryReport</DownloadType><RelatedReferenceId>4307285844</RelatedReferenceId><AvailableDate>2009-04-24T23:47:24+00:00</AvailableDate><Acknowledged>FALSE</Acknowledged></Download></RelatedDownloadsList></Upload></UploadsStatusList></Response>')
+          @feed.status!.should == "_DONE_"
+          @feed.download.id.should == "3404021"
+          @feed.download.available_at.to_s.should == "Sat Apr 25 00:47:24 +0100 2009"
+        end
+      end
+    end
+    
+    module OrderCancellation
+      describe Batch do
+        before(:each) do
+          @transport = Peddler::Transport.new
+          @transport.modernize_request
+          @feed = Peddler::Feeds::OrderCancellation::Batch.new(@transport)
+          @cancelled_order = Peddler::Feeds::OrderCancellation::Item.new :order_id  => "123-1234567-1234567"
+        end
+        
+        it "should add items to batch" do
+          @feed.batch.size.should == 0
+          @feed << @cancelled_order
+          @feed.batch.size.should == 1
+        end
+        
+        it "should create content for upload" do
+          @feed << @cancelled_order
+          @feed.file_content.should == "TemplateType=OrderCancellation  Version=1.0/1.0.3 This row for Amazon.com use only.  Do not modify or delete.\r\norder-id\tcancellation-reason-code\tamazon-order-item-code\r\n123-1234567-1234567\t\t\r\n"
+        end
+        
+        it "should raise error if cancellation reason code is given but Amazon order item code is missing" do
+          @cancelled_order.cancellation_reason_code = "BuyerCanceled"
+          lambda { @cancelled_order.to_s }.should raise_error(PeddlerError)
+        end
+        
+        it "should raise error if Amazon order item code is given but cancellation reason code is missing" do
+          @cancelled_order.amazon_order_item_code = "111111111111"
+          lambda { @cancelled_order.to_s }.should raise_error(PeddlerError)
+        end
+      end
+    end
+  end
+end 

data/spec/peddler/handlers_spec.rb

@@ -0,0 +1,19 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper") 
+module Peddler
+  module Handlers
+    describe XMLHandler do
+      it "should parse XML" do
+        xml = Peddler::Handlers::XMLHandler.decode_response("<Reports> <Report>reportstarttime=08-13-2009:06-16-06 reportendtime=12-31-1969:16-00-00 reportid=2599221990 </Report></Reports>")
+        statuses = Peddler::Handlers::XMLHandler.parse_legacy(xml)
+        statuses[0].id.should == "2599221990"
+      end
+    end
+    
+    describe TabDelimitedHandler do
+      it "should parse tab-delimited text" do
+        text = Peddler::Handlers::TabDelimitedHandler.decode_response("title\tautor\nA Thousand Plateaus\tGilles Deleuze\n")
+        text[0].title.should == "A Thousand Plateaus"
+      end
+    end
+  end
+end 

data/spec/peddler/inventory_spec.rb

@@ -0,0 +1,74 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper") 
+
+module Peddler
+  
+  module Inventory
+    
+    describe Queue do
+
+      it "should show queue count" do
+        transport = Peddler::Transport.new
+        transport.legacize_request
+        transport.stub!(:execute_request).and_return("<PendingUploadsCount>1</PendingUploadsCount>")
+        Peddler::Inventory::Queue.count(transport).should == 1
+      end
+
+    end
+    
+    describe Batch do 
+    
+      before(:each) do
+        @transport = Peddler::Transport.new
+        @transport.legacize_request
+        @inventory = Peddler::Inventory::Batch.new(@transport)
+        @item = Peddler::Inventory::Item.new :product_id => "1234567890",
+                                           :price => 100.00,
+                                           :sku => "FOO-SKU",
+                                           :quantity => 10
+      end
+      
+      it "should add items to batch" do
+        @inventory.batch.size.should == 0
+        @inventory << @item
+        @inventory.batch.size.should == 1
+      end
+    
+      it "should generate an upload file" do
+        @inventory << @item
+        @inventory.file_content.should == "product-id\tproduct-id-type\titem-condition\tprice\tsku\tquantity\tadd-delete\twill-ship-internationally\texpedited-shipping\titem-note\titem-is-marketplace\tfulfillment-center-id\titem-name\titem-description\tcategory1\timage-url\tshipping-fee\tbrowse-path\tstorefront-feature\tboldface\tasin1\tasin2\tasin3\r\n1234567890\t\t\t100.0\tFOO-SKU\t10\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n"
+      end
+    
+      it "should generate a modify-only upload file" do
+        @inventory << @item
+        @inventory.file_content(:short).should == "sku\tprice\tquantity\r\nFOO-SKU\t100.0\t10\r\n"
+      end
+    
+      it "should generate default headers for uploading" do
+        params = @inventory.defaultize :file_format => "UIEE",
+                                       :enable_expedited_shipping => "N"
+        params[:method].should be_nil
+        params[:upload_for].should == "Marketplace"
+        params[:email].should == "Y"
+        params[:file_format].should == "UIEE"
+        params["enable-expedited-shipping"].should == "N"
+        params[:enable_expedited_shipping].should be_nil
+      end
+    
+      it "should upload batch" do
+        @transport.stub!(:execute_request).and_return("<BatchID>2585199250</BatchID>")
+        @inventory.upload.should == true
+        @inventory.id.should == "2585199250"
+      end
+      
+      it "should raise error if a subsequent upload is attempted" do
+        @transport.stub!(:execute_request).and_return("<BatchID>2585199250</BatchID>")
+        @inventory.upload.should == true
+        @inventory.id.should_not == nil
+        lambda { @inventory.upload }.should raise_error(PeddlerError)
+      end
+      
+    end
+  
+  end
+  
+end 

data/spec/peddler/legacy_reports_spec.rb

@@ -0,0 +1,86 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper") 
+
+module Peddler
+  describe LegacyReports do
+    before(:each) do
+      @transport = Peddler::Transport.new
+      @transport.legacize_request
+    end
+    
+    it "should generate an order report" do  
+      @transport.stub!(:execute_request).and_return("<Status>SUCCESS</Status>")
+      res = Peddler::LegacyReports.generate(@transport, :order, :number_of_days => 30)
+      res.should be_an_instance_of(Peddler::LegacyReports::Report)
+    end
+        
+    it "should show most recent order reports" do
+      @transport.stub!(:execute_request).and_return("<Reports> <Report>reportstarttime=07-23-2009:08-33-48 reportendtime=08-07-2009:08-33-48 reportid=1234567890 </Report></Reports>")
+      report_status = Peddler::LegacyReports.latest(@transport, :order, :count => 1)[0]
+      report_status.starts_at.should == "07-23-2009:08-33-48"
+      report_status.id.should == "1234567890"
+    end
+    
+    it "should show most recent uploads" do
+      @transport.stub!(:execute_request).and_return("<Batches> <Batch>batchid=2586376232 status=Done dateandtime=08/07/2009 01:48:23 PDT activateditems=1020 numberofwarnings=0 itemsnotacivated=0 </Batch></Batches>")
+      upload = Peddler::LegacyReports.latest(@transport, :upload, :count => 1)[0]
+      upload.id.should == "2586376232"
+      upload.status.should == "Done"
+      upload.datetime.should == "08/07/2009 01:48:23 PDT"
+      upload.activated_items.should == "1020"
+      upload.number_of_warnings.should == "0"
+      upload.items_not_activated.should == "0"
+    end
+  end
+  
+  module LegacyReports
+    describe Report do 
+      before(:each) do
+        @transport = Peddler::Transport.new
+        @transport.legacize_request
+        @report = Peddler::LegacyReports::Report.new(@transport)
+      end
+      
+      it "should download an inventory upload error log" do 
+        @transport.stub!(:execute_request).and_return("Feed Processing Summary:\n\tNumber of records processed\t\t82\n\tNumber of records successful\t\t81\n\noriginal-record-number\tsku\terror-code\terror-type\terror-message\n27\t1111111111\t8026\tError\tSeller is not authorized to list products in this category. For more details, see http://sellercentral.amazon.com/gp/errorcode/8026\n")
+        
+        @report.name = :upload
+        @report.id = "1234567890"
+      end
+      
+      it "should download an inventory upload error log" do
+        @transport.stub!(:execute_request).and_return("Feed Processing Summary:\n\tNumber of records processed\t\t82\n\tNumber of records successful\t\t81\n\noriginal-record-number\tsku\terror-code\terror-type\terror-message\n27\t1111111111\t8026\tError\tSeller is not authorized to list products in this category. For more details, see http://sellercentral.amazon.com/gp/errorcode/8026\n")
+        @report.name = :upload
+        @report.id = "1234567890"
+        @report.body.should =~ /Feed Processing Summary/
+      end
+      
+      it "should retrieve an order report by id" do
+        @transport.stub!(:execute_request).and_return("payments-status\torder-id\torder-item-id\tpayments-date\tpayments-transaction-id\titem-name\tlisting-id\tsku\tprice\tshipping-fee\tquantity-purchased\ttotal-price\tpurchase-date\tbatch-id\tbuyer-email\tbuyer-name\trecipient-name\tship-address-1\tship-address-2\tship-city\tship-state\tship-zip\tship-country\tspecial-comments\tupc\tship-method\n\t001-1234567-1234567\t12345678901234\t2009-07-23 08:59:03 PST\t\tFoo Bar\t000000000000\t1234567890\t10.00\t3.99\t1\t13.99\t2009-07-23 08:59:03 PST\t\tfoo@bar.com\tJOHN DOE\tJohn Doe\t1 MAIN ST\t\tNEW YORK\tNY\t10001-1000\tUS\t\t\tstandard\n")
+        @report.name = :order
+        @report.id = "1234567890"
+        res = Peddler::Handlers::TabDelimitedHandler.decode_response(@report.body)
+        res.size.should == 1
+        res[0].order_id.should == "001-1234567-1234567"
+        res[0].buyer_name.should == "JOHN DOE"
+      end
+    
+      it "should retrieve an order report by report name" do
+        @transport.stub!(:execute_request).and_return("payments-status\torder-id\torder-item-id\tpayments-date\tpayments-transaction-id\titem-name\tlisting-id\tsku\tprice\tshipping-fee\tquantity-purchased\ttotal-price\tpurchase-date\tbatch-id\tbuyer-email\tbuyer-name\trecipient-name\tship-address-1\tship-address-2\tship-city\tship-state\tship-zip\tship-country\tspecial-comments\tupc\tship-method\n\t001-1234567-1234567\t12345678901234\t2009-07-23 08:59:03 PST\t\tFoo Bar\t000000000000\t1234567890\t10.00\t3.99\t1\t13.99\t2009-07-23 08:59:03 PST\t\tfoo@bar.com\tJOHN DOE\tJohn Doe\t1 MAIN ST\t\tNEW YORK\tNY\t10001-1000\tUS\t\t\tstandard\n")
+        @report.name = :order
+        res = Peddler::Handlers::TabDelimitedHandler.decode_response(@report.body)
+        res.size.should == 1
+        res[0].order_id.should == "001-1234567-1234567"
+        res[0].buyer_name.should == "JOHN DOE"
+      end
+      
+      it "should retrieve an open listings liter report by id" do
+        @transport.stub!(:execute_request).and_return("seller-sku\tquantity\nSKU-FOO\t14\n")
+        @report.name = :open_listings_liter
+        @report.id = "1234567890"
+        res = Peddler::Handlers::TabDelimitedHandler.decode_response(@report.body)
+        res.size.should == 1
+        res[0].seller_sku.should == "SKU-FOO"
+      end
+    end
+  end
+end 

data/spec/peddler/refunds_spec.rb

@@ -0,0 +1,35 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper") 
+
+module Peddler
+  module Refunds
+    describe Batch do 
+      before(:each) do
+        @transport = Peddler::Transport.new
+        @transport.legacize_request
+        @refunds = Peddler::Refunds::Batch.new(@transport)
+        @refund = Peddler::Refunds::Item.new :order_id => "123-1234567-1234567",
+                                             :payments_transaction_id => "12341234567890",
+                                             :refund_amount => 10.00,
+                                             :reason => "CouldNotShip",
+                                             :message => "With our apologies"
+      end
+      
+      it "should add items to batch" do
+        @refunds.batch.size.should == 0
+        @refunds << @refund
+        @refunds.batch.size.should == 1
+      end
+    
+      it "should generate an upload file" do
+        @refunds << @refund
+        @refunds.file_content.should == "order-id\tpayments-transaction-id\trefund-amount\treason\tmessage\r\n123-1234567-1234567\t12341234567890\t10.0\tCouldNotShip\tWith our apologies\r\n"
+      end
+      
+      it "should upload batch" do
+        @transport.stub!(:execute_request).and_return("<Success>SUCCESS</Success>")
+        @refunds << @refund
+        @refunds.upload.should == true
+      end
+    end
+  end
+end

data/spec/peddler/reports_spec.rb

@@ -0,0 +1,19 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper") 
+
+module Peddler
+  module Reports
+    describe UnshippedOrdersReport do
+      before(:each) do
+        @transport = Peddler::Transport.new
+        @transport.modernize_request
+        @transport.stub!(:execute_request).and_return("<?xml version=\"1.0\"?>\n<Response xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:noNamespaceSchemaLocation=\"http://merchant-query.amazon.com/query/schema/MerchantQueryResponses.xsd\"><Report><ReportID>2597613290</ReportID><DownloadType>_GET_FLAT_FILE_ACTIONABLE_ORDER_DATA_</DownloadType><StartDate>2009-08-05T19:54:31+00:00</StartDate><EndDate>2009-08-12T19:54:31+00:00</EndDate><Scheduled>false</Scheduled><ReportStatus>_SUBMITTED_</ReportStatus><SubmittedDate>2009-08-12T19:54:31+00:00</SubmittedDate></Report></Response>")
+        @report = Peddler::Reports::UnshippedOrdersReport.new(@transport)
+      end
+    
+      it "should add generate a request" do
+        @report.id.should == "2597613290"
+        @report.status.should == "_SUBMITTED_"
+      end
+    end
+  end
+end 

data/spec/peddler/transport_spec.rb

@@ -0,0 +1,58 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper") 
+
+module Peddler
+  
+  describe Transport do 
+    
+    before(:each) do
+      @transport = Peddler::Transport.new
+      @transport.username = "user"
+      @transport.password = "secret"
+      @transport.region = "us"
+    end
+    
+    it "should switch regions" do
+      @transport.legacize_request
+      @transport.region = "uk"
+      @transport.url.host.should == "secure.amazon.co.uk"
+    end
+    
+    it "should raise error when region is invalid" do
+      lambda { @transport.region = "foo" }.should raise_error(PeddlerError)
+    end
+    
+    it "should add path to legacy URL" do
+      @transport.legacize_request
+      @transport.path << "foo"
+      @transport.url.to_s.should == "https://secure.amazon.com/exec/panama/seller-admin/foo/"
+    end
+    
+    it "should add path to modern URL" do
+      @transport.modernize_request
+      @transport.path << "foo"
+      @transport.url.to_s.should == "https://secure.amazon.com/query/foo/?Service=MerchantQueryService"
+    end
+    
+    it "should add query parameters to the modern URL" do
+      @transport.modernize_request
+      @transport.query_params["key1"] = "val1"
+      @transport.query_params["key2"] = "val2"
+      @transport.url.to_s.should == "https://secure.amazon.com/query/?key1=val1&key2=val2&Service=MerchantQueryService"
+    end
+    
+    it "should url_encode query parameters" do
+      @transport.modernize_request
+      @transport.query_params["key"] = "!@#"
+      @transport.url.to_s.should == "https://secure.amazon.com/query/?key=%21%40%23&Service=MerchantQueryService"
+    end
+    
+    it "should authenticate request" do
+      @transport.legacize_request
+      req = @transport.request
+      req["authorization"].should_not be(nil)
+    end
+    
+  end
+   
+end 
+ 

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+$: << File.join(File.dirname(__FILE__), "/../lib") 
+require 'spec' 
+require 'peddler' 

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification 
+name: peddler
+version: !ruby/object:Gem::Version 
+  version: 0.1.3
+platform: ruby
+authors: 
+- Hakan Senol Ensari
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-06 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: xml-simple
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Peddler is a Ruby wrapper to the Amazon Inventory Management API.
+email: hakan.ensari@papercavalier.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .gitignore
+- History.txt
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- init.rb
+- lib/peddler.rb
+- lib/peddler/client.rb
+- lib/peddler/feeds.rb
+- lib/peddler/handlers.rb
+- lib/peddler/inventory.rb
+- lib/peddler/legacy_reports.rb
+- lib/peddler/refunds.rb
+- lib/peddler/reports.rb
+- lib/peddler/transport.rb
+- peddler.gemspec
+- spec/peddler/client_spec.rb
+- spec/peddler/feeds_spec.rb
+- spec/peddler/handlers_spec.rb
+- spec/peddler/inventory_spec.rb
+- spec/peddler/legacy_reports_spec.rb
+- spec/peddler/refunds_spec.rb
+- spec/peddler/reports_spec.rb
+- spec/peddler/transport_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://snl.github.com/peddler
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A Ruby wrapper to the Amazon Inventory Management API
+test_files: 
+- spec/peddler/client_spec.rb
+- spec/peddler/feeds_spec.rb
+- spec/peddler/handlers_spec.rb
+- spec/peddler/inventory_spec.rb
+- spec/peddler/legacy_reports_spec.rb
+- spec/peddler/refunds_spec.rb
+- spec/peddler/reports_spec.rb
+- spec/peddler/transport_spec.rb
+- spec/spec_helper.rb