reactive_shipping 3.0.0

data/test/unit/carriers/usps_returns_test.rb

@@ -0,0 +1,45 @@
+require 'test_helper'
+
+class USPSReturnsTest < ActiveSupport::TestCase
+  include ReactiveShipping::Test::Fixtures
+
+  attr_reader :carrier
+
+  def setup
+    @carrier = USPSReturns.new
+  end
+
+  def test_external_return_label_response_failure_should_raise_exception
+    @carrier.expects(:commit).returns(xml_fixture('usps_returns/external_return_label_response_failure'))
+    assert_raises ResponseError do
+      @carrier.external_return_label_request(Nokogiri::XML({}))
+    end
+  end
+
+  def test_external_return_label_errors
+    response = Nokogiri::XML(xml_fixture('usps_returns/external_return_label_response_failure'))
+    errors = @carrier.send(:external_return_label_errors, response)
+    assert_equal errors.length > 0, true
+  end
+
+  def test_parse_external_return_label_response_raises_error
+    response = xml_fixture('usps_returns/external_return_label_response_failure')
+    assert_raises ResponseError do
+      @carrier.send(:parse_external_return_label_response, response)
+    end
+  end
+
+  def test_parse_external_return_label_response_returns_object
+    response = xml_fixture('usps_returns/external_return_label_response')
+
+    assert_equal @carrier.send(:parse_external_return_label_response, response).is_a?(ExternalReturnLabelResponse), true
+    assert_equal @carrier.send(:parse_external_return_label_response, response).tracking_number, "9202090140694100000410"
+    assert_equal @carrier.send(:parse_external_return_label_response, response).postal_routing, "420770739921"
+  end
+
+  def test_external_return_label_response_should_return_external_label_response
+    @carrier.expects(:commit).returns(xml_fixture('usps_returns/external_return_label_response'))
+    assert_equal @carrier.external_return_label_request(Nokogiri::XML({})).tracking_number, "9202090140694100000410"
+  end
+
+end

data/test/unit/carriers/usps_test.rb

@@ -0,0 +1,633 @@
+require 'test_helper'
+
+class USPSTest < ActiveSupport::TestCase
+  include ReactiveShipping::Test::Fixtures
+
+  def setup
+    @carrier = USPS.new(:login => 'login')
+    @tracking_response = xml_fixture('usps/tracking_response')
+    @batch_tracking_response = xml_fixture('usps/tracking_response_batch')
+    @tracking_response_failure = xml_fixture('usps/tracking_response_failure')
+    @tracking_infos_array = [
+      {number: '9102901000462189604217', :destination_zip => '12345', :mailing_date => Date.new(2010,1,30)},
+      {number: '5555555555555555555555'},
+      {number: '9405510ee200828613653750'}
+    ]
+  end
+
+  def test_using_tls_and_not_ssl_v3
+    refute_equal :SSLv3, @carrier.ssl_version, 'SSLv3 is no longer supported by USPS Web Tools'
+    assert_equal :TLSv1_2, @carrier.ssl_version
+  end
+
+  def test_tracking_request_should_create_correct_xml
+    @carrier.expects(:commit).with(:track, xml_fixture('usps/tracking_request'),false).returns(@tracking_response)
+    @carrier.find_tracking_info('9102901000462189604217', :destination_zip => '12345', :mailing_date => Date.new(2010,1,30))
+  end
+
+  def test_tracking_request_should_handle_9_digit_zip
+    @carrier.expects(:commit).with(:track, xml_fixture('usps/tracking_request'),false).returns(@tracking_response)
+    @carrier.find_tracking_info('9102901000462189604217', :destination_zip => '12345-4444', :mailing_date => Date.new(2010,1,30))
+  end
+
+  def test_tracking_failure_should_raise_exception
+    @carrier.expects(:commit).returns(@tracking_response_failure)
+    e = assert_raises ResponseError do
+      @carrier.find_tracking_info('abc123xyz', :test => true)
+    end
+    assert_equal "The Postal Service could not locate the tracking information for your request. Please verify your tracking number and try again later.", e.message
+  end
+
+  def test_find_tracking_info_should_handle_not_found_error
+    @carrier.expects(:commit).returns(xml_fixture('usps/tracking_response_test_error'))
+    e = assert_raises ResponseError do
+      @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    end
+    assert_equal "This Information has not been included in this Test Server.", e.message
+  end
+
+  def test_find_tracking_info_should_handle_not_available_error
+    @carrier.expects(:commit).returns(xml_fixture('usps/tracking_response_not_available'))
+    assert_raises ResponseError do
+      @carrier.find_tracking_info('9574211957289221353248', :test => true)
+    end
+  end
+
+  def test_find_tracking_info_should_handle_invalid_xml_error
+    @carrier.expects(:commit).returns(xml_fixture('usps/invalid_xml_tracking_response_error'))
+    assert_raises ResponseError do
+      @carrier.find_tracking_info('9102901000462189604217,9102901000462189604214', :test => true)
+    end
+  end
+
+  def test_find_tracking_info_should_return_a_tracking_response
+    @carrier.expects(:commit).returns(@tracking_response)
+    assert_instance_of ReactiveShipping::TrackingResponse, @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    @carrier.expects(:commit).returns(@tracking_response)
+    assert_equal 'ReactiveShipping::TrackingResponse', @carrier.find_tracking_info('EJ958083578US').class.name
+  end
+
+  def test_find_tracking_info_should_have_correct_fields
+    @carrier.expects(:commit).returns(@tracking_response)
+    response = @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    assert_equal 10, response.shipment_events.size
+    assert_equal Time.parse('April 28, 2015'), response.scheduled_delivery_date
+    assert_equal Time.parse('2015-04-28 09:01:00 UTC'), response.actual_delivery_date
+    assert_equal '9102901000462189604217', response.tracking_number
+  end
+
+  def test_find_tracking_info_should_return_shipment_events_in_ascending_chronological_order
+    @carrier.expects(:commit).returns(@tracking_response)
+    response = @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    assert_equal response.shipment_events.map(&:time).sort, response.shipment_events.map(&:time)
+  end
+
+  def test_find_tracking_info_should_have_correct_timestamps_for_shipment_events
+    @carrier.expects(:commit).returns(@tracking_response)
+    response = @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    assert_equal [
+      "2015-04-23 23:36:00 UTC",
+      "2015-04-25 18:04:00 UTC",
+      "2015-04-25 19:19:00 UTC",
+      "2015-04-26 00:18:00 UTC",
+      "2015-04-27 16:04:00 UTC",
+      "2015-04-28 04:05:00 UTC",
+      "2015-04-28 07:03:00 UTC",
+      "2015-04-28 08:19:00 UTC",
+      "2015-04-28 08:29:00 UTC",
+      "2015-04-28 09:01:00 UTC"], response.shipment_events.map { |e| e.time.strftime('%Y-%m-%d %H:%M:00 %Z') }
+  end
+
+  def test_find_tracking_info_should_have_correct_names_for_shipment_events
+    @carrier.expects(:commit).returns(@tracking_response)
+    response = @carrier.find_tracking_info('9102901000462189604217')
+    assert_equal [
+      "SHIPPING LABEL CREATED",
+      "ACCEPTED AT USPS ORIGIN SORT FACILITY",
+      "ARRIVED AT USPS ORIGIN FACILITY",
+      "DEPARTED USPS FACILITY",
+      "ARRIVED AT USPS FACILITY",
+      "DEPARTED USPS FACILITY",
+      "ARRIVED AT POST OFFICE",
+      "SORTING COMPLETE",
+      "OUT FOR DELIVERY",
+      "DELIVERED"], response.shipment_events.map(&:name)
+  end
+
+  def test_find_tracking_info_should_have_correct_locations_for_shipment_events
+    @carrier.expects(:commit).returns(@tracking_response)
+    response = @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    assert_equal [
+      "ARGYLE, TX, 76226",
+      "ARGYLE, TX, 76226",
+      "COPPELL, TX, 75099",
+      "COPPELL, TX, 75099",
+      "HAZELWOOD, MO, 63042",
+      "HAZELWOOD, MO, 63042",
+      "HANNA CITY, IL, 61536",
+      "HANNA CITY, IL, 61536",
+      "HANNA CITY, IL, 61536",
+      "HANNA CITY, IL, 61536"], response.shipment_events.map(&:location).map { |l| "#{l.city}, #{l.state}, #{l.postal_code}" }
+  end
+
+  def test_find_tracking_info_should_have_correct_event_codes_for_shipment_events
+    @carrier.expects(:commit).returns(@tracking_response)
+    response = @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    assert_equal ["GX", "OA", "10", "EF", "10", "EF", "07", "PC", "OF", "01"], response.shipment_events.map(&:type_code)
+  end
+
+  def test_find_tracking_info_should_handle_special_cases
+    @carrier.expects(:commit).returns(xml_fixture('usps/tracking_response_alt'))
+    response = @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    assert_equal 'Canada', response.shipment_events.last.location.country.name
+    assert_equal :out_for_delivery, response.status
+    assert_nil response.scheduled_delivery_date
+    assert_nil response.shipment_events.last.location.city
+
+    time = Time.at(0)
+    expected_utc_time = Time.utc(time.year, time.month, time.mday, time.hour, time.min, time.sec)
+
+    assert_equal 'NP', response.shipment_events.first.type_code
+    assert_equal expected_utc_time, response.shipment_events.first.time
+
+    special_country  = xml_fixture('usps/tracking_response_alt').gsub('CANADA','TAIWAN')
+    @carrier.expects(:commit).returns(special_country)
+    response = @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    assert_equal 'Taiwan, Province of China', response.shipment_events.last.location.country.name
+
+    special_country  = xml_fixture('usps/tracking_response_alt').gsub('CANADA','KOREA  REPUBLIC OF')
+    @carrier.expects(:commit).returns(special_country)
+    response = @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    assert_equal 'Korea, Republic of', response.shipment_events.last.location.country.name
+  end
+
+  def test_find_tracking_info_destination
+    # USPS API doesn't tell where it's going
+    @carrier.expects(:commit).returns(@tracking_response)
+    response = @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    assert_nil response.destination
+  end
+
+  def test_find_tracking_info_tracking_number
+    @carrier.expects(:commit).returns(@tracking_response)
+    response = @carrier.find_tracking_info('9102901000462189604217', :test => true)
+    assert_equal '9102901000462189604217', response.tracking_number
+  end
+
+  def test_find_tracking_info_should_have_correct_status
+    @carrier.expects(:commit).returns(@tracking_response)
+    response = @carrier.find_tracking_info('9102901000462189604217')
+    assert_equal :delivered, response.status
+  end
+
+  def test_find_tracking_info_should_have_correct_delivered
+    @carrier.expects(:commit).returns(@tracking_response)
+    response = @carrier.find_tracking_info('9102901000462189604217')
+    assert_equal true, response.delivered?
+  end
+
+  def test_tracking_batch_request_should_create_correct_xml
+    @carrier.expects(:commit).with(:track, xml_fixture('usps/tracking_request_batch'),false).returns(@batch_tracking_response)
+    @carrier.batch_find_tracking_info(@tracking_infos_array)
+  end
+
+  def test_batch_find_tracking_info_should_return_a_tracking_response_array
+    @carrier.expects(:commit).returns(@batch_tracking_response)
+    responses = @carrier.batch_find_tracking_info(@tracking_infos_array, :test => true)
+    assert_equal 4, responses.length
+    assert responses.all? { |x| x.instance_of? ReactiveShipping::TrackingResponse}
+  end
+
+  def test_batch_find_tracking_info_should_have_correct_data
+    @carrier.expects(:commit).returns(@batch_tracking_response)
+    responses = @carrier.batch_find_tracking_info(@tracking_infos_array, :test => true)
+    response = responses[0]
+    assert_equal ["GX", "OA", "10", "EF", "10", "EF", "07", "PC", "OF", "01"], response.shipment_events.map(&:type_code)
+    assert_equal Time.parse('April 28, 2015'), response.scheduled_delivery_date
+    assert_equal Time.parse('2015-04-28 09:01:00 UTC'), response.actual_delivery_date
+    assert_equal '9102901000462189604217', response.tracking_number
+  end
+
+  def test_batch_find_tracking_info_should_tolerate_failure
+    @carrier.expects(:commit).returns(@batch_tracking_response)
+    responses = @carrier.batch_find_tracking_info(@tracking_infos_array, :test => true)
+    response = responses[2]
+    refute response.success?
+    assert_equal "The Postal Service could not locate the tracking information for your request. Please verify your tracking number and try again later.",
+      response.message
+  end
+
+  def test_batch_find_tracking_info_should_handle_not_found_error
+    @carrier.expects(:commit).returns(xml_fixture('usps/tracking_response_test_error'))
+    e = assert_raises ResponseError do
+      @carrier.find_tracking_info(@batch_tracking_response, :test => true)
+    end
+    assert_equal "This Information has not been included in this Test Server.", e.message
+  end
+
+  def test_size_codes
+    assert_equal 'REGULAR', USPS.size_code_for(Package.new(2, [1, 12, 1], :units => :imperial))
+    assert_equal 'LARGE', USPS.size_code_for(Package.new(2, [12.1, 1, 1], :units => :imperial))
+    assert_equal 'LARGE', USPS.size_code_for(Package.new(2, [1000, 1000, 1000], :units => :imperial))
+  end
+
+  # TODO: test_parse_domestic_rate_response
+
+  def test_build_us_rate_request_uses_proper_container
+    expected_request = xml_fixture('usps/us_rate_request')
+    expected_request.gsub!('<Container/>','<Container>RECTANGULAR</Container>')
+    @carrier.expects(:commit).with(:us_rates, expected_request, false).returns(expected_request)
+    @carrier.expects(:parse_rate_response)
+    package = package_fixtures[:book]
+    package.options[:container] = :rectangular
+    @carrier.find_rates(location_fixtures[:beverly_hills], location_fixtures[:new_york], package, :test => true, :container => :rectangular)
+  end
+
+  def test_build_us_rate_request_uses_no_container_on_small_packages
+    expected_request = xml_fixture('usps/us_rate_request')
+    @carrier.expects(:commit).with(:us_rates, expected_request, false).returns(expected_request)
+    @carrier.expects(:parse_rate_response)
+    package = package_fixtures[:book]
+    @carrier.find_rates(location_fixtures[:beverly_hills], location_fixtures[:new_york], package, :test => true)
+  end
+
+  def test_build_us_rate_request_uses_proper_container_when_none_is_specified
+    expected_request = xml_fixture('usps/us_rate_request_large')
+    @carrier.expects(:commit).with(:us_rates, expected_request, false).returns(expected_request)
+    @carrier.expects(:parse_rate_response)
+    package = package_fixtures[:big_half_pound]
+    @carrier.find_rates(location_fixtures[:beverly_hills], location_fixtures[:new_york], package, :test => true)
+  end
+
+  def test_build_world_rate_request
+    expected_request = xml_fixture('usps/world_rate_request_without_value')
+    @carrier.expects(:commit).with(:world_rates, expected_request, false).returns(expected_request)
+    @carrier.expects(:parse_rate_response)
+    @carrier.find_rates(location_fixtures[:beverly_hills], location_fixtures[:ottawa], package_fixtures[:book], :test => true, :acceptance_time => Time.parse("2015-06-01T20:34:29Z"))
+  end
+
+  def test_build_world_rate_request_with_package_value
+    expected_request = xml_fixture('usps/world_rate_request_with_value')
+    @carrier.expects(:commit).with(:world_rates, expected_request, false).returns(expected_request)
+    @carrier.expects(:parse_rate_response)
+    @carrier.find_rates(location_fixtures[:beverly_hills], location_fixtures[:ottawa], package_fixtures[:american_wii], :test => true, :acceptance_time => Time.parse("2015-06-01T20:34:29Z"))
+  end
+
+  def test_build_world_rate_request_only_country
+    expected_request = xml_fixture('usps/world_rate_request_only_country')
+    @carrier.expects(:commit).with(:world_rates, expected_request, false).returns(expected_request)
+    @carrier.expects(:parse_rate_response)
+    @carrier.find_rates(location_fixtures[:beverly_hills], Location.new(:country => 'CZ'), package_fixtures[:american_wii], :test => true)
+  end
+
+  def test_initialize_options_requirements
+    assert_raises(ArgumentError) { USPS.new }
+    assert USPS.new(:login => 'blah')
+  end
+
+  def test_parse_international_rate_response
+    fixture_xml = xml_fixture('usps/beverly_hills_to_ottawa_american_wii_rate_response')
+    @carrier.expects(:commit).returns(fixture_xml)
+
+    response = begin
+      @carrier.find_rates(
+        location_fixtures[:beverly_hills], # imperial (U.S. origin)
+        location_fixtures[:ottawa],
+        package_fixtures[:american_wii],
+        :test => true
+      )
+    rescue ResponseError => e
+      e.response
+    end
+
+    expected_xml_hash = Hash.from_xml(fixture_xml)
+    actual_xml_hash = Hash.from_xml(response.xml)
+
+    assert_equal expected_xml_hash, actual_xml_hash
+
+    refute response.rates.empty?
+
+    assert_equal [1795, 3420, 5835, 8525, 8525], response.rates.map(&:price)
+    assert_equal [1, 2, 4, 12, 15], response.rates.map(&:service_code).map(&:to_i).sort
+
+    ordered_service_names = ["USPS Express Mail International",
+                             "USPS First-Class Package International Service",
+                             "USPS GXG Envelopes",
+                             "USPS Global Express Guaranteed (GXG)",
+                             "USPS Priority Mail International"]
+    assert_equal ordered_service_names, response.rates.map(&:service_name).sort
+  end
+
+  def test_parse_international_rate_response_errors
+    fixture_xml = xml_fixture('usps/api_error_rate_response')
+    @carrier.expects(:commit).returns(fixture_xml)
+
+    error = assert_raises(ResponseError) do
+      @carrier.find_rates(
+        location_fixtures[:beverly_hills], # imperial (U.S. origin)
+        location_fixtures[:ottawa],
+        package_fixtures[:american_wii],
+        :test => true
+      )
+    end
+    assert_equal 'This is a test response with the format of a real error.', error.message
+  end
+
+  def test_parse_max_dimension_sentences
+    limits = {
+      "Max. length 46\", width 35\", height 46\" and max. length plus girth 108\"" =>
+        [{:length => 46.0, :width => 46.0, :height => 35.0, :length_plus_girth => 108.0}],
+      "Max.length 42\", max. length plus girth 79\"" =>
+        [{:length => 42.0, :length_plus_girth => 79.0}],
+      "9 1/2\" X 12 1/2\"" =>
+        [{:length => 12.5, :width => 9.5, :height => 0.75}, "Flat Rate Envelope"],
+      "Maximum length and girth combined 108\"" =>
+        [{:length_plus_girth => 108.0}],
+      "USPS-supplied Priority Mail flat-rate envelope 9 1/2\" x 12 1/2.\" Maximum weight 4 pounds." =>
+        [{:length => 12.5, :width => 9.5, :height => 0.75}, "Flat Rate Envelope"],
+      "Max. length 24\", Max. length, height, depth combined 36\"" =>
+        [{:length => 24.0, :length_plus_width_plus_height => 36.0}]
+    }
+    p = package_fixtures[:book]
+    limits.each do |sentence, hashes|
+      dimensions = hashes[0].update(:weight => 50.0)
+      service_node = build_service_node(
+        :name => hashes[1],
+        :max_weight => 50,
+        :max_dimensions => sentence )
+      @carrier.expects(:package_valid_for_max_dimensions).with(p, dimensions)
+      @carrier.send(:package_valid_for_service, p, service_node)
+    end
+
+    service_node = build_service_node(
+        :name => "flat-rate box",
+        :max_weight => 50,
+        :max_dimensions => "USPS-supplied Priority Mail flat-rate box. Maximum weight 20 pounds." )
+
+    # should test against either kind of flat rate box:
+    dimensions = [{:weight => 50.0, :length => 11.0, :width => 8.5, :height => 5.5}, # or...
+                  {:weight => 50.0, :length => 13.625, :width => 11.875, :height => 3.375}]
+    @carrier.expects(:package_valid_for_max_dimensions).with(p, dimensions[0])
+    @carrier.expects(:package_valid_for_max_dimensions).with(p, dimensions[1])
+    @carrier.send(:package_valid_for_service, p, service_node)
+  end
+
+  def test_package_valid_for_max_dimensions
+    p = Package.new(70 * 16, [10, 10, 10], :units => :imperial)
+    limits = {:weight => 70.0, :length => 10.0, :width => 10.0, :height => 10.0, :length_plus_girth => 50.0, :length_plus_width_plus_height => 30.0}
+    assert_equal true, @carrier.send(:package_valid_for_max_dimensions, p, limits)
+
+    limits.keys.each do |key|
+      dimensions = {key => (limits[key] - 1)}
+      assert_equal false, @carrier.send(:package_valid_for_max_dimensions, p, dimensions)
+    end
+  end
+
+  def test_strip_9_digit_zip_codes
+    request = URI.decode(@carrier.send(:build_us_rate_request, package_fixtures[:book], "90210-1234", "123456789"))
+    assert !(request =~ /\>90210-1234\</)
+    assert request =~ /\>90210\</
+    assert !(request =~ /\>123456789\</)
+    assert request =~ /\>12345\</
+  end
+
+  def test_strip_9_digit_zip_codes_world_rates
+    request = URI.decode(@carrier.send(:build_world_rate_request, location_fixtures[:beverly_hills_9_zip],
+                                        package_fixtures[:book], location_fixtures[:auckland], {}))
+    refute_match /\<OriginZip\>90210-1234/, request
+    assert_match /\<OriginZip\>90210/, request
+  end
+
+  def test_maximum_weight
+    assert Package.new(70 * 16, [5, 5, 5], :units => :imperial).mass == @carrier.maximum_weight
+    assert Package.new((70 * 16) + 0.01, [5, 5, 5], :units => :imperial).mass > @carrier.maximum_weight
+    assert Package.new((70 * 16) - 0.01, [5, 5, 5], :units => :imperial).mass < @carrier.maximum_weight
+  end
+
+  def test_updated_domestic_rate_name_format_with_unescaped_html
+    mock_response = xml_fixture('usps/beverly_hills_to_new_york_book_rate_response')
+    @carrier.expects(:commit).returns(mock_response)
+    rates_response = @carrier.find_rates(
+      location_fixtures[:beverly_hills],
+      location_fixtures[:new_york],
+      package_fixtures[:book],
+      :test => true
+    )
+    rate_names = [
+      'USPS Express Mail',
+      'USPS Express Mail Flat Rate Envelope',
+      'USPS Express Mail Flat Rate Envelope Hold For Pickup',
+      'USPS Express Mail Hold For Pickup',
+      'USPS Express Mail Legal Flat Rate Envelope',
+      'USPS Express Mail Legal Flat Rate Envelope Hold For Pickup',
+      'USPS Express Mail Sunday/Holiday Delivery',
+      'USPS Express Mail Sunday/Holiday Delivery Flat Rate Envelope',
+      'USPS Express Mail Sunday/Holiday Delivery Legal Flat Rate Envelope',
+      'USPS First-Class Mail Large Envelope',
+      'USPS First-Class Mail Package',
+      'USPS Library Mail',
+      'USPS Media Mail',
+      'USPS Parcel Post',
+      'USPS Priority Mail',
+      'USPS Priority Mail Flat Rate Envelope',
+      'USPS Priority Mail Gift Card Flat Rate Envelope',
+      'USPS Priority Mail Large Flat Rate Box',
+      'USPS Priority Mail Legal Flat Rate Envelope',
+      'USPS Priority Mail Medium Flat Rate Box',
+      'USPS Priority Mail Padded Flat Rate Envelope',
+      'USPS Priority Mail Small Flat Rate Box',
+      'USPS Priority Mail Small Flat Rate Envelope',
+      'USPS Priority Mail Window Flat Rate Envelope'
+    ]
+    assert_equal rate_names, rates_response.rates.collect(&:service_name).sort
+  end
+
+  def test_first_class_packages_with_mail_type
+    @carrier.expects(:commit).returns(xml_fixture('usps/first_class_packages_with_mail_type_response'))
+
+    response = begin
+      @carrier.find_rates(
+        location_fixtures[:beverly_hills], # imperial (U.S. origin)
+        location_fixtures[:new_york],
+        Package.new(0, 0),
+
+        :test => true,
+        :service => :first_class,
+        :first_class_mail_type => :parcel
+
+      )
+    rescue ResponseError => e
+      e.response
+    end
+    assert response.success?, response.message
+  end
+
+  def test_first_class_packages_without_mail_type
+    @carrier.expects(:commit).returns(xml_fixture('usps/first_class_packages_without_mail_type_response'))
+
+    begin
+      @carrier.find_rates(
+        location_fixtures[:beverly_hills], # imperial (U.S. origin)
+        location_fixtures[:new_york],
+        Package.new(0, 0),
+
+        :test => true,
+        :service => :first_class
+
+      )
+    rescue ResponseError => e
+      assert_equal "Invalid First Class Mail Type.", e.message
+    end
+  end
+
+  def test_first_class_packages_with_invalid_mail_type
+    @carrier.expects(:commit).returns(xml_fixture('usps/first_class_packages_with_invalid_mail_type_response'))
+
+    begin
+      @carrier.find_rates(
+        location_fixtures[:beverly_hills], # imperial (U.S. origin)
+        location_fixtures[:new_york],
+        Package.new(0, 0),
+
+        :test => true,
+        :service => :first_class,
+        :first_class_mail_tpe => :invalid
+
+      )
+    rescue ResponseError => e
+      assert_equal "Invalid First Class Mail Type.", e.message
+    end
+  end
+
+  def test_domestic_retail_rates
+    mock_response = xml_fixture('usps/beverly_hills_to_new_york_book_commercial_base_rate_response')
+    @carrier.expects(:commit).returns(mock_response)
+
+    response = @carrier.find_rates(
+      location_fixtures[:beverly_hills],
+      location_fixtures[:new_york],
+      package_fixtures.values_at(:book),
+      :test => true
+    )
+
+    rates = Hash[response.rates.map { |rate| [rate.service_name, rate.price] }]
+
+    assert_equal 0, rates["USPS First-Class Package Service"] # the "first class package service" is only available for commercial base shippers
+    assert_equal 309, rates["USPS First-Class Mail Parcel"] # 2013 retail 9oz first class parcel is $3.09
+    assert_equal 695, rates["USPS Priority Mail"] # 2013 1lb zone 8 priority retail is $6.95
+  end
+
+  def test_domestic_commercial_base_rates
+    commercial_base_credentials = { key: "123", login: "user", password: "pass", commercial_base: true }
+    carrier = USPS.new(commercial_base_credentials)
+
+    mock_response = xml_fixture('usps/beverly_hills_to_new_york_book_commercial_base_rate_response')
+    carrier.expects(:commit).returns(mock_response)
+
+    response = carrier.find_rates(
+      location_fixtures[:beverly_hills],
+      location_fixtures[:new_york],
+      package_fixtures.values_at(:book),
+      :test => true
+    )
+
+    rates = Hash[response.rates.map { |rate| [rate.service_name, rate.price] }]
+
+    assert_equal 0, rates["USPS First-Class Mail Parcel"] # commercial base prices retail first class is unavailable. must ship as package service
+    assert_equal 273, rates["USPS First-Class Package Service"] # the "first class package service" should be present for commerical base (instead of USPS First-Class Mail Parcel for retail rates)
+    assert_equal 651, rates["USPS Priority Mail"] # 2013 zone 8 commercial base price is 6.51, retail is 6.95
+  end
+
+  def test_intl_commercial_base_rates
+    commercial_base_credentials = { key: "123", login: "user", password: "pass", commercial_base: true }
+    carrier = USPS.new(commercial_base_credentials)
+
+    mock_response = xml_fixture('usps/beverly_hills_to_ottawa_american_wii_commercial_base_rate_response')
+    carrier.expects(:commit).returns(mock_response)
+
+    response = carrier.find_rates(
+      location_fixtures[:beverly_hills],
+      location_fixtures[:ottawa],
+      package_fixtures.values_at(:american_wii),
+      :test => true
+    )
+
+    assert_equal [4112, 6047, 7744, 7744], response.rates.map(&:price) # note these prices are higher than the normal/retail unit tests because the rates from that test is years older than from this test
+  end
+
+  def test_domestic_commercial_plus_rates
+    commercial_plus_credentials = { key: "123", login: "user", password: "pass", commercial_plus: true }
+    carrier = USPS.new(commercial_plus_credentials)
+
+    mock_response = xml_fixture('usps/beverly_hills_to_new_york_book_commercial_plus_rate_response')
+    carrier.expects(:commit).returns(mock_response)
+
+    response = carrier.find_rates(
+      location_fixtures[:beverly_hills],
+      location_fixtures[:new_york],
+      package_fixtures.values_at(:book),
+      :test => true
+    )
+
+    rates = Hash[response.rates.map { |rate| [rate.service_name, rate.price] }]
+
+    assert_equal 0, rates["USPS First-Class Mail Parcel"]
+    assert_equal 405, rates["USPS First-Class Package Service"]
+    assert_equal 625, rates["USPS Priority Mail 2-Day"]
+  end
+
+  def test_intl_commercial_plus_rates
+    commercial_plus_credentials = { key: "123", login: "user", password: "pass", commercial_plus: true }
+    carrier = USPS.new(commercial_plus_credentials)
+
+    mock_response = xml_fixture('usps/beverly_hills_to_ottawa_american_wii_commercial_plus_rate_response')
+    carrier.expects(:commit).returns(mock_response)
+
+    response = carrier.find_rates(
+      location_fixtures[:beverly_hills],
+      location_fixtures[:ottawa],
+      package_fixtures.values_at(:american_wii),
+      :test => true
+    )
+
+    assert_equal [3767, 5526, 7231, 7231], response.rates.map(&:price)
+  end
+
+  def test_maximum_address_field_length
+    assert_equal 38, @carrier.maximum_address_field_length
+  end
+
+  private
+
+  def build_service_node(options = {})
+    builder = Nokogiri::XML::Builder.new do |xml|
+      xml.Service do
+        xml.Pounds(options[:pounds] || "0")
+        xml.SvcCommitments(options[:svc_commitments] || "Varies")
+        xml.Country(options[:country] || "CANADA")
+        xml.ID(options[:id] || "3")
+        xml.MaxWeight(options[:max_weight] || "64")
+        xml.SvcDescription(options[:name] || "First-Class Mail International")
+        xml.MailType(options[:mail_type] || "Package")
+        xml.Postage(options[:postage] || "3.76")
+        xml.Ounces(options[:ounces] || "9")
+        xml.MaxDimensions(options[:max_dimensions].dup || "Max. length 24\", Max. length, height, depth combined 36\"")
+      end
+    end
+    builder.doc.root
+  end
+
+  def build_service_hash(options = {})
+    {"Pounds" => options[:pounds] || "0",
+     "SvcCommitments" => options[:svc_commitments] || "Varies",
+     "Country" => options[:country] || "CANADA",
+     "ID" => options[:id] || "3",
+     "MaxWeight" => options[:max_weight] || "64",
+     "SvcDescription" => options[:name] || "First-Class Mail International",
+     "MailType" => options[:mail_type] || "Package",
+     "Postage" => options[:postage] || "3.76",
+     "Ounces" => options[:ounces] || "9",
+     "MaxDimensions" => options[:max_dimensions] ||
+       "Max. length 24\", Max. length, height, depth combined 36\""}
+  end
+end