ups_time_in_transit 0.1.1

data/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2010 Joseph Stelmach
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+

data/Manifest

@@ -0,0 +1,6 @@
+LICENSE
+Manifest
+README
+Rakefile
+lib/ups_time_in_transit.rb
+ups_time_in_transit.gemspec

data/README

@@ -0,0 +1,55 @@
+ups_time_in_transit is an easy to use interface to the UPS Time in Transit API.
+
+== installation ==
+gem install ups_time_in_transit
+
+== usage ==
+
+# define your access options.  These are options that won't change 
+# between requests.  Take care to specify the proper UPS url:
+# 'https://wwwcie.ups.com/ups.app/xml/TimeInTransit' for testing and
+# development, and 'https://onlinetools.ups.com/ups.app/xml/TimeInTransit'
+# for production.
+access_options = {
+  :url => 'https://wwwcie.ups.com/ups.app/xml/TimeInTransit',
+  :access_license_number => 'foo',
+  :user_id => 'bar',
+  :password => 'baz',
+  :order_cutoff_time => 17 ,
+  :sender_city => 'Hoboken',
+  :sender_state => 'NJ',
+  :sender_country_code => 'US',
+  :sender_zip => '07030'}
+
+# It's best to store these these options in a yaml file and load them
+# into a map when you need them:
+yaml = YAML.load_file("#{RAILS_ROOT}/config/ups_time_in_transit.yml")
+access_options = yaml[RAILS_ENV].inject({}){|h,(k, v)| h[k.to_sym] = v; h}
+
+# create an api instance with your access options
+time_in_transit_api = UPS::TimeInTransit.new(access_options)
+
+# for each request, generate a map of request options describing
+# the shipment and where it's going
+request_options = {
+  :total_packages => 1,
+  :unit_of_measurement => 'LBS',
+  :weight => 10,
+  :city => 'Newark',
+  :state => 'DE',
+  :zip => '19711',
+  :country_code => 'US'}
+
+# request the map of delivery types (overnight, ground, etc.) to the expected 
+# delivery date for that type.  Be sure to rescue any errors.
+begin
+  delivery_dates = time_in_transit_api.request(request_options)
+rescue => error
+  puts error.inspect
+end
+
+== changelog ==
+
+v.0.1.0
+  initial release
+

data/Rakefile

@@ -0,0 +1,12 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('ups_time_in_transit', '0.1.1') do |p|
+  p.description    = "Provides an easy to use interface to the UPS time in transit API"
+  p.url            = "http://github.com/joestelmach/ups_time_in_transit"
+  p.author         = "Joe Stelmach"
+  p.email          = "joestelmach @nospam@ gmail.com"
+  p.ignore_pattern = ["tmp/*", "script/*"]
+  p.runtime_dependencies = ['activesupport']
+end

data/lib/ups_time_in_transit.rb

@@ -0,0 +1,250 @@
+require 'date'
+require 'rexml/document'
+require 'net/http'
+require 'net/https'
+require 'rubygems'
+require 'active_support'
+
+module UPS
+  # Provides a simple api to to ups's time in transit service.
+  class TimeInTransit
+    XPCI_VERSION = '1.0002'
+    DEFAULT_CUTOFF_TIME = 14
+    DEFAULT_TIMEOUT = 30
+    DEFAULT_RETRY_COUNT = 3
+    DEFAULT_COUNTRY_CODE = 'US'
+    DEFAULT_UNIT_OF_MEASUREMENT = 'LBS'
+
+    # Creates a TimeInTransit instance based on the given hash of access 
+    # options The following access options are available and are required 
+    # unless a default value is specified:
+    #
+    # [<tt>:url</tt>]
+    #   The ups api url to use
+    #
+    # [<tt>:access_license_number</tt>]
+    #   Your ups license number
+    #
+    # [<tt>:user_id</tt>]
+    #    Your ups user id
+    #
+    # [<tt>password</tt>]
+    #   Your ups password
+    #
+    # [<tt>:order_cutoff_time</tt>]
+    #   Your own arbitrary cutoff time that is some time before the actual ups cutoff 
+    #   time.  Requests made after this time will use the following day as the send 
+    #   date (or the following monday if the request is made on a weekend or on a 
+    #   friday after this time.)
+    #
+    # [<tt>:sender_city</tt>]
+    #   The city you are shipping from
+    #
+    # [<tt>:sender_state</tt>]
+    #   The state you are shipping from
+    #
+    # [<tt>:sender_zip</tt>]
+    #   The zip code you are shipping from
+    #
+    # [<tt>:sender_country_code</tt>]
+    #   The country you are shipping from (defaults to 'US')
+    #
+    # [<tt>:retry_count</tt>]
+    #   The number of times you would like to retry when a connection 
+    #   fails (defaults to 3)
+    #
+    # [<tt>:timeout</tt>]
+    #   The number of seconds you would like to wait for a response before 
+    #   giving up (defaults to 30)
+    #
+    def initialize(access_options)
+      @order_cutoff_time = access_options[:order_cutoff_time] || DEFAULT_CUTOFF_TIME
+      @url = access_options[:url]
+      @timeout = access_options[:timeout] || DEFAULT_TIMEOUT 
+      @retry_count = access_options[:retry_count] || DEFAULT_CUTOFF_TIME 
+
+      @access_xml = generate_xml({
+        :AccessRequest => {
+          :AccessLicenseNumber => access_options[:access_license_number],
+          :UserId => access_options[:user_id],
+          :Password => access_options[:password]
+        }
+      })
+
+      @transit_from_attributes = {
+        :AddressArtifactFormat => {
+          :PoliticalDivision2 => access_options[:sender_city],
+          :PoliticalDivision1 => access_options[:sender_state],
+          :CountryCode => access_options[:sender_country_code] || DEFAULT_COUNTRY_CODE,
+          :PostcodePrimaryLow => access_options[:sender_zip]
+        }
+      }
+    end
+
+    # Requests time in transit information based on the given hash of options:
+    #
+    # [<tt>:total_packages</tt>]
+    #   the number of packages in the shipment (defaults to 1)
+    #
+    # [<tt>:unit_of_measurement</tt>]
+    #   the unit of measurement to use (defaults to 'LBS')
+    #
+    # [<tt>:weight</tt>]
+    #   the weight of the shipment in the given units
+    #
+    # [<tt>:city</tt>]
+    #   the city you are shipping to
+    #
+    # [<tt>:state</tt>]
+    #   the state you are shipping to
+    #
+    # [<tt>:zip</tt>]
+    #   the zip code you are shipping to
+    #
+    # [<tt>:country_code</tt>]
+    #   the country you are shipping to (defaults to 'US')
+    #
+    # An error will be raised if the request is unsuccessful.
+    #
+    def request(options)
+      
+      # build our request xml
+      pickup_date = calculate_pickup_date
+      options[:pickup_date] = pickup_date.strftime('%Y%m%d')
+      xml = @access_xml + generate_xml(build_transit_attributes(options))
+
+      # attempt the request in a timeout
+      delivery_dates = {}
+      attempts = 0
+      begin 
+        Timeout.timeout(@timeout) do
+          response = send_request(@url, xml)
+          delivery_dates = response_to_map(response)
+        end
+
+      # We can only attempt to recover from Timeout errors, all other errors
+      # should be raised back to the user
+      rescue Timeout::Error => error
+        if(attempts < @retry_count)
+          attempts += 1
+          retry
+
+        else
+          raise error
+        end
+      end
+
+      delivery_dates
+    end
+
+    private 
+
+    # calculates the next available pickup date based on the current time and the 
+    # configured order cutoff time
+    def calculate_pickup_date
+      now = Time.now
+      day_of_week = now.strftime('%w').to_i
+      in_weekend = [6,0].include?(day_of_week)
+      in_friday_after_cutoff = day_of_week == 5 and now.hour > @order_cutoff_time
+
+      # If we're in a weekend (6 is Sat, 0 is Sun,) or we're in Friday after
+      # the cutoff time, then our ship date will move
+      if(in_weekend or in_friday_after_cutoff)
+        pickup_date = now.next_week
+
+      # if we're in another weekday but after the cutoff time, our ship date
+      # moves to tomorrow
+      elsif(now.hour > @order_cutoff_time)
+        pickup_date = now.tomorrow
+      else
+        pickup_date = now
+      end
+    end
+
+    # Builds a hash of transit request attributes based on the given values
+    def build_transit_attributes(options)
+      # set defaults if none given
+      options[:total_packages] = 1 unless options[:total_packages]
+
+      # convert all options to string values
+      options.each_value {|option| option = options.to_s}
+
+      transit_attributes = {
+        :TimeInTransitRequest => {
+          :Request => {
+            :RequestAction => 'TimeInTransit',
+            :TransactionReference => {
+              :XpciVersion => XPCI_VERSION
+            }
+          },
+          :TotalPackagesInShipment => options[:total_packages],
+          :ShipmentWeight => {
+            :UnitOfMeasurement => {
+              :Code => options[:unit_of_measurement] || DEFAULT_UNIT_OF_MEASUREMENT
+            },
+            :Weight => options[:weight],
+          },
+          :PickupDate => options[:pickup_date],
+          :TransitFrom => @transit_from_attributes,
+          :TransitTo => {
+            :AddressArtifactFormat => {
+              :PoliticalDivision2 => options[:city],
+              :PoliticalDivision1 => options[:state],
+              :CountryCode => options[:country_code] || DEFAULT_COUNTRY_CODE,
+              :PostcodePrimaryLow => options[:zip],
+            }
+          }
+        }
+      }
+    end
+
+    # generates an xml document for the given attributes
+    def generate_xml(attributes)
+      xml = REXML::Document.new
+      xml << REXML::XMLDecl.new
+      emit(attributes, xml)
+      xml.root.add_attribute("xml:lang", "en-US")
+      xml.to_s
+    end
+
+    # recursively emits xml nodes under the given node for values in the given hash
+    def emit(attributes, node)
+      attributes.each do |k,v|
+        child_node = REXML::Element.new(k.to_s, node)
+        (v.respond_to? 'each_key') ? emit(v, child_node) : child_node.add_text(v.to_s)
+      end
+    end
+
+    # Posts the given data to the given url, returning the raw response
+    def send_request(url, data)
+      uri = URI.parse(url)
+      http = Net::HTTP.new(uri.host, uri.port)
+      if uri.port == 443
+        http.use_ssl	= true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      end
+      response = http.post(uri.path, data)
+      response.code == '200' ? response.body : response.error!
+    end
+
+    # converts the given raw xml response to a map of local service codes
+    # to estimated delivery dates
+    def response_to_map(response) 
+      response_doc = REXML::Document.new(response)
+      response_code = response_doc.elements['//ResponseStatusCode'].text.to_i
+      raise "Invalid response from ups:\n#{response_doc.to_s}" if(!response_code || response_code != 1)
+
+      service_codes_to_delivery_dates = {}
+      response_code = response_doc.elements.each('//ServiceSummary') do |service_element|
+        service_code = service_element.elements['Service/Code'].text
+        if(service_code)
+          date_string = service_element.elements['EstimatedArrival/Date'].text
+          time_string = service_element.elements['EstimatedArrival/Time'].text
+          delivery_date = Time.parse("#{date_string} #{time_string}")
+          service_codes_to_delivery_dates[service_code] = delivery_date
+        end
+      end
+      service_codes_to_delivery_dates
+    end
+  end
+end

data/ups_time_in_transit.gemspec

@@ -0,0 +1,35 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{ups_time_in_transit}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Joe Stelmach"]
+  s.cert_chain = ["/Users/joe/workspace/personal/gem-public_cert.pem"]
+  s.date = %q{2010-06-01}
+  s.description = %q{Provides an easy to use interface to the UPS time in transit API}
+  s.email = %q{joestelmach @nospam@ gmail.com}
+  s.extra_rdoc_files = ["LICENSE", "README", "lib/ups_time_in_transit.rb"]
+  s.files = ["LICENSE", "Manifest", "README", "Rakefile", "lib/ups_time_in_transit.rb", "ups_time_in_transit.gemspec"]
+  s.homepage = %q{http://github.com/joestelmach/ups_time_in_transit}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Ups_time_in_transit", "--main", "README"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{ups_time_in_transit}
+  s.rubygems_version = %q{1.3.7}
+  s.signing_key = %q{/Users/joe/workspace/personal/gem-private_key.pem}
+  s.summary = %q{Provides an easy to use interface to the UPS time in transit API}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 0"])
+  end
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification 
+name: ups_time_in_transit
+version: !ruby/object:Gem::Version 
+  hash: 25
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
+platform: ruby
+authors: 
+- Joe Stelmach
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDODCCAiCgAwIBAgIBADANBgkqhkiG9w0BAQUFADBCMRQwEgYDVQQDDAtqb2Vz
+  dGVsbWFjaDEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYD
+  Y29tMB4XDTEwMDYwMjAyMTEzN1oXDTExMDYwMjAyMTEzN1owQjEUMBIGA1UEAwwL
+  am9lc3RlbG1hY2gxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixk
+  ARkWA2NvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANkIW8alNYIx
+  7dkzBZXc6XE3WomRJCYZLgWAlbnGT/iF9xOunTOcsYOFVaP9fY5tQ3c9DKOd/TtG
+  bTFKZYvOQM2ASlfJo4KrW3NqiwpG1kPsTI3wOOrOzoClnVu8EneK0kG5PETDZY2H
+  h0B4kd7ejCmX8L4KRIVZRljZLSjLMEPEyA2+9CPIL7UfjmKHEIWjmQli+IrfUVoa
+  CpcrNxG7FBa/pwfsIF8nr1xSw35K7S1oJ5ma65s2449wVspqLXg5H3IQxz/Y9coe
+  iuG1QhmI78RSIHfzDPNXp5smOsHrVJm21h71eF/oV19BNvGuMkavOS5NSPZ3T685
+  v4NVpu7qoosCAwEAAaM5MDcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0O
+  BBYEFPCOueB1WpFUwO+OTSX4ABA4e/bPMA0GCSqGSIb3DQEBBQUAA4IBAQBnrQSg
+  rLL1UBujU/RkXPdC/xj61lywwy+HuiGruu1VbLVSten2VjjDEK4ga/7K9z3SRWiW
+  fFXj61rM9ljvYbQN2+74WR2WjbX7057bqY80/vSnyIxqxXoJzjg6OAHvdXq+oAel
+  A5jXBeb7FGd3IIUjAwWvLmvK+s3AmfOZ8y7e/A0QKtgvSufrUWN+ZaGnzP64WMPf
+  CHFGU7Orn1e+tYjg7zAQMXkYdQ9u/HvbJ6/gLQwD4bKwRW6jZGSBdUUQU7W4/ygC
+  irVgr9ouyby8ZibMqCXSRjQ9BP3xIRThygXC5MLpq4bkHn/twgUWC2FYWTeI3F43
+  BNAwAE8UFlzJGIy5
+  -----END CERTIFICATE-----
+
+date: 2010-06-01 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: Provides an easy to use interface to the UPS time in transit API
+email: joestelmach @nospam@ gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README
+- lib/ups_time_in_transit.rb
+files: 
+- LICENSE
+- Manifest
+- README
+- Rakefile
+- lib/ups_time_in_transit.rb
+- ups_time_in_transit.gemspec
+has_rdoc: true
+homepage: http://github.com/joestelmach/ups_time_in_transit
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Ups_time_in_transit
+- --main
+- README
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 11
+      segments: 
+      - 1
+      - 2
+      version: "1.2"
+requirements: []
+
+rubyforge_project: ups_time_in_transit
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Provides an easy to use interface to the UPS time in transit API
+test_files: []
+

metadata.gz.sig

@@ -0,0 +1,2 @@
+ �����\+����	y�AUI��K���{��
���dsn`0�Mm�◓B�|:~�dA?�������*�@���|;$�)�pW���BLF@	�\
+��J.)Λ����0����.#��?�����ƤBP_�;(X���H��G DzV��$SGDa�3�\B;"q�