google4r-checkout 1.1.beta5 → 1.1.0

data/CHANGES

@@ -1,5 +1,11 @@
 =google4r-checkout Changelog
 
+== 1.1.0 (2011-06-29)
+
+* Support for newer refund-notification XML format, contributed by Chris Parrish
+* Update README to remove outdated Rails gem locking technique and add more examples
+* Modernize gem build
+
 == 1.1.beta5 (2010-09-21)
 
 * Support for chargeback fees and chargeback gateway refund fees, contributed by George Palmer

data/README.md

@@ -46,27 +46,93 @@ The file should contain content similar to:
         :use_sandbox => true
       }
 
-## Dependencies
-
-The unit tests use Mocha so you have to install the gem "mocha" to run the tests. You will also need the money gem library.
-
-## How To: Freeze a google4r version in a Rails project
-
-<code>rake rails:freeze:gems</code> only works for the Rails gems. So, how do you freeze your own gems like google4r? It turns out to be pretty straightforward:
-
-    cd RAILS_ROOT
-    cd vendor
-    gem unpack google4r-checkout
-    ls 
-    # ... google4r-checkout-0.1.1 ...
-
-Then, open RAILS_ROOT/config/environment.rb in your favourite text editor and add the following lines at the top of the file just below <code>require File.join(File.dirname(__FILE__), 'boot')</code>:
-
-    # Freeze non-Rails gem.
-    Dir.glob(File.join(RAILS_ROOT, 'vendor', '*', 'lib')) do |path|
-      $LOAD_PATH << path
+## Sending Commands to Google Checkout
+
+To send commands to Google Checkout, use a Google4R::Checkout::Frontend object.  The Frontend class contains a variety of methods for easily generating several types of commands, including checkout, cancel_order, charge_and_ship_order, etc.
+
+Here's an example:
+
+      # Create the Frontend from our configuration
+      frontend = Google4R::Checkout::Frontend.new(
+        :merchant_id => conf['merchant_id'],
+        :merchant_key => conf['merchant_key'],
+        :use_sandbox => conf['use_sandbox']
+      )
+      
+      # Create a new checkout command (to place an order)
+      cmd = frontend.create_checkout_command
+      
+      # Add an item to the command's shopping cart
+      cmd.shopping_cart.create_item do |item|
+        item.name = "2-liter bottle of Diet Pepsi"
+        item.quantity = 100
+        item.unit_price = Money.new(1.99, "USD")
+      end
+      
+      # Send the command to Google and capture the HTTP response
+      response = cmd.send_to_google_checkout
+      
+      # Redirect the user to Google Checkout to complete the transaction
+      redirect_to response.redirect_url
+
+For more information, see the Frontend class's RDocs and the Google Checkout API documentation.
+
+## Writing Responders
+
+To receive notifications from Google Checkout, you'll need to write an action in your web application to respond to Google Checkout XML requests.  The basic strategy for this is to use a NotificationHandler object (which can be obtained through a Frontend object) to parse the HTTP request, then handle the resulting Notification object according to its class.  You should then generate a NotificationAcknowledgment and return it as the response.
+
+It's a good idea to verify the HTTP authentication headers for incoming requests.  This will be a combination of your Merchant ID and Merchant Key.
+
+Here is an example of how one might do this in Rails:
+
+    class PaymentNotificationController < ApplicationController
+      before_filter :verify_merchant_credentials, :only => [:google]
+  
+      def google
+        frontend = Google4R::Checkout::Frontend.new(
+          :merchant_id => conf['merchant_id'],
+          :merchant_key => conf['merchant_key'],
+          :use_sandbox => conf['use_sandbox']
+        )
+        handler = frontend.create_notification_handler
+        
+        begin
+           notification = handler.handle(request.raw_post) # raw_post contains the XML
+        rescue Google4R::Checkout::UnknownNotificationType
+           # This can happen if Google adds new commands and Google4R has not been
+           # upgraded yet. It is not fatal.
+           logger.warn "Unknown notification type"
+           return render :text => 'ignoring unknown notification type', :status => 200
+        end
+        
+        case notification
+        when Google4R::Checkout::NewOrderNotification then
+          
+          # handle a NewOrderNotification
+          
+        when Google4R::Checkout::OrderStateChangeNotification then
+          
+          # handle an OrderStateChangeNotification
+          
+        else
+          return head :text => "I don't know how to handle a #{notification.class}", :status => 500
+        end
+    
+        notification_acknowledgement = Google4R::Checkout::NotificationAcknowledgement.new(notification)
+        render :xml => notification_acknowledgement, :status => 200
+      end
+  
+      private
+      # make sure the request authentication headers use the right merchant_id and merchant_key
+      def verify_merchant_credentials
+        authenticate_or_request_with_http_basic("Google Checkout notification endpoint") do |merchant_id, merchant_key|
+          (conf['merchant_id'].to_s == merchant_id.to_s) and (conf['merchant_key'].to_s == merchant_key.to_s)
+        end
+      end
     end
 
-Now you can use the following in your own code:
+## Dependencies
+
+google4r-checkout makes extensive use of the money gem library, which is a required dependency.  The unit tests also use Mocha and Nokogiri, which should be automatically pulled down by Bundler.
 
-    require 'google4r/checkout'
+google4r-checkout doesn't depend on any particular Ruby web framework, so it should work with any version of Rails, Sinatra, Camping, or even no web framework at all.

data/lib/google4r/checkout/commands.rb

@@ -93,12 +93,13 @@ module Google4R #:nodoc:
         url_str += 
           if self.class == CheckoutCommand then
             CHECKOUT_API_URL
-          elsif self.class == OrderReportCommand then
+          elsif self.class == OrderReportCommand || self.class == NotificationHistoryRequestCommand then
             ORDER_REPORT_API_URL
           else
             ORDER_PROCESSING_API_URL
           end
         url_str = url_str % frontend.configuration[:merchant_id]
+
         url = URI.parse(url_str)
         
         request = Net::HTTP::Post.new(url.path)
@@ -136,6 +137,23 @@ module Google4R #:nodoc:
             when 'request-received'
                 serial_number = xml_doc.elements['/request-received'].attributes['serial-number']
                 return serial_number
+            # report history notifications
+            when 'order-summary'
+                raise 'Response type OrderSummaryResponse not implemented'
+            when 'new-order-notification'
+                return NewOrderNotification.create_from_element xml_doc.root, @frontend
+            when 'risk-information-notification'
+                return RiskInformationNotification.create_from_element xml_doc.root, @frontend
+            when 'order-state-change-notification'
+                return OrderStateChangeNotification.create_from_element xml_doc.root, @frontend
+            when 'charge-amount-notification'
+                return ChargeAmountNotification.create_from_element xml_doc.root, @frontend
+            when 'authorization-amount-notification'
+                return AuthorizationAmountNotification.create_from_element xml_doc.root, @frontend
+            when 'refund-amount-notification'
+                return RefundAmountNotification.create_from_element xml_doc.root, @frontend
+            when 'chargeback-amount-notification'
+                return ChargebackAmountNotification.create_from_element xml_doc.root, @frontend
             else
                 raise "Unknown response:\n--\n#{xml_doc.to_s}\n--"
             end
@@ -222,6 +240,8 @@ module Google4R #:nodoc:
       # An array of ShippingMethod objects of this CheckoutCommand. Use 
       # #create_shipping_method to create new shipping methods.
       attr_reader :shipping_methods
+      
+      attr_reader :parameterized_urls
 
       # The URL at where the cart can be edited (String, optional).
       attr_accessor :edit_cart_url
@@ -264,6 +284,7 @@ module Google4R #:nodoc:
         super(frontend)
         @shopping_cart = ShoppingCart.new(self)
         @shipping_methods = Array.new
+        @parameterized_urls = Array.new
         if frontend.tax_table_factory
           @tax_tables = frontend.tax_table_factory.effective_tax_tables_at(Time.new)
         end
@@ -295,6 +316,26 @@ module Google4R #:nodoc:
         
         return shipping_method
       end
+      
+      # Use this method to create a new parameterized_url object. It requires the URL
+      # to be passed in the 'opts' hash. It will create a new instance of the 
+      # paramterized URL object. 
+      # 
+      # Raises an argument error if the URL passed in the opts hash is not a String
+      #
+      # To find more information on 3rd party conversion tracking visit the API documentation
+      # http://code.google.com/apis/checkout/developer/checkout_pixel_tracking.html 
+      def create_parameterized_url(opts, &block)
+        raise(ArgumentError, "Url option required") unless opts[:url].kind_of?(String)
+
+        parameterized_url = ParameterizedUrl.new(opts[:url])
+        @parameterized_urls << parameterized_url
+
+        yield(parameterized_url) if block_given?
+
+        return parameterized_url
+      end
+      
     end
 
     # CheckoutRedirectResponse instances are returned when a CheckoutCommand is successfully
@@ -638,5 +679,23 @@ module Google4R #:nodoc:
         ReturnOrderReportCommandXmlGenerator.new(self).generate
       end
     end
+    
+    # The <notification-history-request> command allows you to receive
+    # a notification type node refered to by the serial number posted by
+    # google to the notification callback URL
+    class NotificationHistoryRequestCommand < Command
+      
+      attr_reader :serial_number
+      
+      def initialize(frontend, serial_number)
+        super frontend
+        
+        @serial_number = serial_number
+      end
+      
+      def to_xml
+        NotificationHistoryReportCommandXmlGenerator.new(self).generate
+      end
+    end
   end
 end

data/lib/google4r/checkout/frontend.rb

@@ -217,6 +217,10 @@ module Google4R #:nodoc:
       def create_order_report_command(start_date, end_date)
         return OrderReportCommand.new(self, start_date, end_date)
       end
+      
+      def create_notification_history_request_command(serial_number)
+        return NotificationHistoryRequestCommand.new(self, serial_number)
+      end
     end
   end
 end

data/lib/google4r/checkout/notifications.rb

@@ -368,9 +368,11 @@ module Google4R #:nodoc:
         amount = (BigDecimal.new(element.elements['total-refund-amount'].text)*100).to_i
         refund.total_refund_amount = Money.new(amount, currency)
         
-        currency = element.elements['latest-fee-refund-amount'].attributes['currency']
-        amount = (BigDecimal.new(element.elements['latest-fee-refund-amount'].text)*100).to_i
-        refund.latest_fee_refund_amount = Money.new(amount, currency)
+        if element.elements['latest-fee-refund-amount']
+          currency = element.elements['latest-fee-refund-amount'].attributes['currency']
+          amount = (BigDecimal.new(element.elements['latest-fee-refund-amount'].text)*100).to_i
+          refund.latest_fee_refund_amount = Money.new(amount, currency)
+        end
         
         refund.timestamp = Time.parse(element.elements['timestamp'].text)
 

data/lib/google4r/checkout/shared.rb

@@ -1281,6 +1281,78 @@ module Google4R #:nodoc:
       end
     end
     
+    # ParamaterizedUrl instances are used 
+    class ParameterizedUrl
+      
+      # The third party conversion tracker URL
+      attr_accessor :url
+      
+      # Paramters passed to the third party conversion tracker - Read Only
+      attr_reader :url_parameters
+      
+      def initialize(url)
+        @url = url.to_s
+        @url_parameters = Array.new
+      end
+      
+      # UrlParameters can be created (recommended) using this method by passing in a hash
+      # containing values for the :name of the parameter as is it to be provided to the third
+      # party conversion tracker, and the :parameter_type that has a valued assigned by Google Checkout
+      def create_url_parameter(opts)
+        url_parameter = UrlParameter.new(self,opts)
+        @url_parameters << url_parameter   
+        
+        return url_parameter
+      end
+            
+    end    
+    
+    # Url Paramaters that are available from the Google Checkout API that can be
+    # passed to the third party conversion tracker
+    # 
+    # UrlParameter objects require a parameter name, which is the name of the value to be
+    # provided to the third party conversion tracker, and a parameter type which is
+    # the name of the value, as assigned by Google Checkout.
+    # 
+    # The parameter_type must be a string, and must be a valid type, as defined in the subsequant list
+    # otherwise an Argument Error is thrown. 
+    #
+    # The :name symbol must have an associated value, and be of the String class, other
+    # an argument error will be thrown
+    # Below is a list of defined types, as assigned by Google Checkout.
+    #
+    # buyer-id - A Google-assigned value that uniquely identifies a customer email address.
+    # order-id - A Google-assigned value that uniquely identifies an order. This value is displayed in the Merchant Center for each order. If you have implemented the Notification API, you will also see this value in all Google Checkout notifications.
+    # order-subtotal - The total cost for all of the items in the order including coupons and discounts but excluding taxes and shipping charges.
+    # order-subtotal-plus-tax - The total cost for all of the items in the order, including taxes, coupons and discounts, but excluding shipping charges.
+    # order-subtotal-plus-shipping - The total cost for all of the items in the order, including shipping charges, coupons and discounts, but excluding taxes.
+    # order-total - The total cost for all of the items in the order, including taxes, shipping charges, coupons and discounts.
+    # tax-amount - The total amount of taxes charged for an order.
+    # shipping-amount - The shipping cost associated with an order.
+    # coupon-amount - The total amount of all coupons factored into the order total.
+    # billing-city - The city associated with the order's billing address.
+    # billing-region - The U.S. state associated with the order's billing address.
+    # billing-postal-code - The five-digit U.S. zip code associated with the order's billing address.
+    # billing-country-code - The two-letter ISO 3166 country code associated with the order's billing address.
+    # shipping-city - The city associated with the order's shipping address.
+    # shipping-region - The U.S. state associated with the order's shipping address.
+    # shipping-postal-code - The five-digit U.S. zip code associated with the order's shipping address.
+    # shipping-country-code - The two-letter ISO 3166 country code associated with the order's shipping address.
+    class UrlParameter
+      attr_reader :parameterized_url,:name,:parameter_type
+      
+      VALID_TYPES = ['buyer-id', 'order-id', 'order-subtotal', 'order-subtotal-plus-tax', 'order-subtotal-plus-shipping', 'order-total', 'tax-amount','shipping-amount', 'coupon-amount', 'billing-city', 'billing-region', 'billing-postal-code', 'billing-country-code', 'shipping-city', 'shipping-region', 'shipping-postal-code', 'shipping-country-code'].freeze
+      
+      def initialize(parameterized_url,opts)
+        raise(ArgumentError,"url-parameter type can only be #{VALID_TYPES.join(", ")}") unless VALID_TYPES.include?(opts[:type])      
+        raise(ArgumentError, "Missing or invalid parameter name") unless opts[:name].kind_of?(String)      
+        
+        @parameterized_url = parameterized_url
+        @name = opts[:name]
+        @parameter_type = opts[:type]
+      end          
+    end
+    
     # financial_state
     # REVIEWING - Google Checkout is reviewing the order.
     # CHARGEABLE - The order is ready to be charged.

data/lib/google4r/checkout/xml_generation.rb

@@ -76,6 +76,7 @@ module Google4R #:nodoc:
         ReturnItemsCommand => 'return-items',
         ResetItemsShippingInformationCommand => 'reset-items-shipping-information',
         OrderReportCommand => 'order-list-request',
+        NotificationHistoryRequestCommand => 'notification-history-request',
       }
       
       def initialize(command)
@@ -197,7 +198,14 @@ module Google4R #:nodoc:
           analytics_element = flow_element.add_element('analytics-data')
           analytics_element.text = command.analytics_data
         end
-
+        
+        # <parameterized-urls>
+        if command.parameterized_urls then
+          parameterized_url_element = flow_element.add_element('parameterized-urls')
+          command.parameterized_urls.each do |parameterized_url|
+            self.process_parameterized_urls(parameterized_url, parameterized_url_element)
+          end
+        end 
       end
       
       # adds the tax-tables to the parent xml element
@@ -551,6 +559,19 @@ module Google4R #:nodoc:
         end
       end
       
+      # Adda the paramterized URL nodes for 3rd party conversion tracking
+      # Adds a <paramertized-url> element to a parent (<parameterized-urls>) element      
+      def process_parameterized_urls(parameterized_url, parent)
+        parameterized_url_node = parent.add_element('parameterized-url')
+        parameterized_url_node.add_attribute('url', parameterized_url.url)
+        parent_parameters_node = parameterized_url_node.add_element('parameters') if parameterized_url.url_parameters
+        parameterized_url.url_parameters.each do |parameter|
+          parameter_node = parent_parameters_node.add_element('url-parameter')
+          parameter_node.add_attribute('name', parameter.name)
+          parameter_node.add_attribute('type',parameter.parameter_type)
+        end        
+      end
+      
       # Converts a Hash into an XML structure. The keys are converted to tag names. If
       # the values are Hashs themselves then process_hash is called upon them. If the
       # values are Arrays then a new element with the key's name will be created.
@@ -999,5 +1020,22 @@ module Google4R #:nodoc:
         end
       end
     end
+    
+    class NotificationHistoryReportCommandXmlGenerator < CommandXmlGenerator
+      
+      def initialize(command)
+        @command = command
+      end
+      
+      protected
+      
+      def process_command(command)
+        root = super
+        
+        sn_element = root.add_element('serial-number')
+        sn_element.text = command.serial_number
+      end
+    end
+    
   end
 end

data/test/integration/checkout_command_test.rb

@@ -228,6 +228,14 @@ class Google4R::Checkout::CheckoutCommandIntegrationTest < Test::Unit::TestCase
       end
     end
     
+    # Add a paramterized URL with url parameters
+    command.create_parameterized_url(:url => "http://google.ca") do |parameterized_url|
+      parameterized_url.create_url_parameter(:name => "order", :type => 'order-id')
+    end
+    
+    # Add a parameterized URL without URL parameters
+    command.create_parameterized_url(:url => "http://www.google.com")
+        
     # Add items to the cart.
     1.upto(5) do |i|
       command.shopping_cart.create_item do |item|

data/test/unit/chargeback_amount_notification_test.rb

@@ -51,6 +51,18 @@ class Google4R::Checkout::ChargebackAmountNotificationTest < Test::Unit::TestCas
   <timestamp>2006-03-18T20:25:31</timestamp>
 </chargeback-amount-notification>
 }
+
+    @example2_xml = %q{
+<?xml version="1.0" encoding="UTF-8"?>
+<chargeback-amount-notification xmlns="http://checkout.google.com/schema/2"
+  serial-number="bea6bc1b-e1e2-44fe-80ff-0180e33a2614">
+  <google-order-number>841171949013218</google-order-number>
+  <latest-chargeback-amount currency="GBP">226.06</latest-chargeback-amount>
+  <total-chargeback-amount currency="GBP">226.06</total-chargeback-amount>
+  <timestamp>2006-03-18T20:25:31</timestamp>
+</chargeback-amount-notification>
+}
+
   end
   
   def test_create_from_element_works_correctly
@@ -66,4 +78,17 @@ class Google4R::Checkout::ChargebackAmountNotificationTest < Test::Unit::TestCas
     assert_equal(Money.new(221, 'GBP'), notification.latest_fee_refund_amount)
     assert_equal(Money.new(1000, 'GBP'), notification.latest_chargeback_fee_amount)
   end
+
+  def test_create_from_minimal_element_works_correctly
+    root = REXML::Document.new(@example2_xml).root
+    
+    notification = ChargebackAmountNotification.create_from_element(root, @frontend)
+
+    assert_equal 'bea6bc1b-e1e2-44fe-80ff-0180e33a2614', notification.serial_number
+    assert_equal '841171949013218', notification.google_order_number
+    assert_equal Time.parse('2006-03-18T20:25:31'), notification.timestamp
+    assert_equal(Money.new(22606, 'GBP'), notification.total_chargeback_amount)
+    assert_equal(Money.new(22606, 'GBP'), notification.latest_chargeback_amount)
+  end
+
 end

data/test/unit/checkout_command_test.rb

@@ -55,6 +55,7 @@ class Google4R::Checkout::CheckoutCommandTest < Test::Unit::TestCase
     assert_equal @frontend, @command.frontend
     assert_kind_of ShoppingCart, @command.shopping_cart
     assert_equal [], @command.shipping_methods
+    assert_equal [], @command.parameterized_urls
     assert_nil @command.edit_cart_url
     assert_nil @command.continue_shopping_url
     assert_nil @command.request_buyer_phone_number
@@ -67,7 +68,7 @@ class Google4R::Checkout::CheckoutCommandTest < Test::Unit::TestCase
       :merchant_calculations_url, :merchant_calculations_url=,
       :accept_merchant_coupons, :accept_merchant_coupons=,
       :accept_gift_certificates, :accept_gift_certificates=,
-      :platform_id, :platform_id=
+      :platform_id, :platform_id=, :parameterized_urls, :create_parameterized_url
     ].each do |symbol|
       assert_respond_to @command, symbol
     end
@@ -113,12 +114,35 @@ class Google4R::Checkout::CheckoutCommandTest < Test::Unit::TestCase
     
       assert @command.shipping_methods.include?(obj)
     end
-  end
+  end 
   
   def test_create_shipping_method_raises_exception_on_invalid_clazz_parameter
     assert_raises(ArgumentError) { @command.create_shipping_method(String) }
   end
   
+  def test_create_parameterized_url_method_works_without_block
+    parameterized_url = @command.create_parameterized_url(:url => "http://someurl")
+    
+    assert_kind_of ParameterizedUrl,parameterized_url
+    
+    assert @command.parameterized_urls.include?(parameterized_url)          
+  end
+
+  def test_create_parameterized_url_method_works_with_block
+    obj = nil
+    
+    @command.create_parameterized_url(:url => "http://someurl") do |parameterized_url|      
+      obj = parameterized_url
+      assert_kind_of ParameterizedUrl, obj
+    end    
+    
+    assert @command.parameterized_urls.include?(obj)  
+  end
+  
+  def test_create_parameterized_url_method_raises_exception_on_missing_url
+    assert_raises(ArgumentError) { @command.create_parameterized_url() }    
+  end
+  
   def test_to_xml_does_not_raise_exception
     assert_nothing_raised { @command.to_xml }
   end

data/test/unit/parameterized_url_test.rb

@@ -0,0 +1,57 @@
+#--
+# Project:   google_checkout4r 
+# File:      test/unit/paramterized_url_test.rb
+# Author:    Johnathan Niziol <johnathan.niziol at canadadrugs dot com>
+# Copyright: (c) 2011 by Johnathan Niziol
+# License:   MIT License as follows:
+#
+# 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. 
+#++
+
+require File.expand_path(File.dirname(__FILE__)) + '/../test_helper'
+
+require 'google4r/checkout'
+
+require 'test/frontend_configuration'
+
+# Test for the Parameterized class.
+class Google4R::Checkout::ParameterizedUrlTest < Test::Unit::TestCase
+  include Google4R::Checkout
+
+  def setup
+    @parameterized_url = ParameterizedUrl.new("http://testurl.com")   
+  end
+  
+  def test_parameterized_url_behaves_correctly
+    assert_respond_to @parameterized_url, :url
+    assert_respond_to @parameterized_url, :create_url_parameter
+    assert_respond_to @parameterized_url, :url_parameters 
+  end
+  
+  def test_initialized_correctly
+    assert_equal "http://testurl.com", @parameterized_url.url
+    assert_equal [], @parameterized_url.url_parameters
+  end
+    
+  def test_accessors_work_correctly
+    @parameterized_url.url = "url"
+    assert_equal "url", @parameterized_url.url    
+  end
+end

data/test/unit/url_parameter_test.rb

@@ -0,0 +1,55 @@
+#--
+# Project:   google_checkout4r 
+# File:      test/unit/paramterized_url_test.rb
+# Author:    Johnathan Niziol <jniziol at gmail dot com>
+# Copyright: (c) 2007 by Johnathan Niziol
+# License:   MIT License as follows:
+#
+# 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. 
+#++
+
+require File.expand_path(File.dirname(__FILE__)) + '/../test_helper'
+
+require 'google4r/checkout'
+
+require 'test/frontend_configuration'
+
+# Test for the TaxTable class.
+class Google4R::Checkout::UrlParameterTest < Test::Unit::TestCase
+  include Google4R::Checkout
+
+  def setup
+    @parameterized_url = ParameterizedUrl.new("http://www.google.com")
+    @url_parameter = @parameterized_url.create_url_parameter(:name => 'order', :type => 'order-id')   
+  end
+  
+  def test_url_parameter_behaves_correctly
+    assert_respond_to @url_parameter, :parameterized_url
+    assert_respond_to @url_parameter, :name
+    assert_respond_to @url_parameter, :parameter_type 
+  end
+  
+  def test_initialized_correctly
+    assert_equal "order", @url_parameter.name
+    assert_equal "order-id", @url_parameter.parameter_type
+    assert_equal @parameterized_url, @url_parameter.parameterized_url
+  end
+  
+end

metadata

@@ -1,21 +1,27 @@
 --- !ruby/object:Gem::Specification 
 name: google4r-checkout
 version: !ruby/object:Gem::Version 
-  hash: -1848230123
-  prerelease: true
+  hash: 19
+  prerelease: 
   segments: 
   - 1
   - 1
-  - beta5
-  version: 1.1.beta5
+  - 0
+  version: 1.1.0
 platform: ruby
 authors: 
 - Tony Chan
+- Dan Dukeson
+- Nat Budin
+- George Palmer
+- Daniel Higham
+- Johnathan Niziol
+- Chris Parrish
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2010-09-21 00:00:00 -04:00
+date: 2011-06-29 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -34,8 +40,36 @@ dependencies:
         version: 2.3.0
   type: :runtime
   version_requirements: *id001
-description: Ruby library to access the Google Checkout service and implement notification handlers.
-email: 
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: "  google4r-checkout is a lightweight, framework-agnostic Ruby library to access the Google Checkout service and implement \n  notification handlers.  It exposes object-oriented wrappers for all of Google Checkout's API commands and notifications.\n"
+email: natbudin@gmail.com
 executables: []
 
 extensions: []
@@ -96,6 +130,7 @@ files:
 - test/unit/order_adjustment_test.rb
 - test/unit/order_report_command_test.rb
 - test/unit/order_state_change_notification_test.rb
+- test/unit/parameterized_url_test.rb
 - test/unit/pickup_shipping_test.rb
 - test/unit/postal_area_test.rb
 - test/unit/private_data_parser_test.rb
@@ -112,6 +147,7 @@ files:
 - test/unit/tax_table_test.rb
 - test/unit/tracking_data_test.rb
 - test/unit/unarchive_order_command_test.rb
+- test/unit/url_parameter_test.rb
 - test/unit/us_country_area_test.rb
 - test/unit/us_state_area_test.rb
 - test/unit/us_zip_area_test.rb
@@ -122,7 +158,7 @@ files:
 - LICENSE
 - CHANGES
 has_rdoc: true
-homepage: http://code.google.com/p/google-checkout-ruby-sample-code
+homepage: http://github.com/nbudin/google4r-checkout
 licenses: []
 
 post_install_message: 
@@ -144,21 +180,19 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version 
-      hash: 25
+      hash: 3
       segments: 
-      - 1
-      - 3
-      - 1
-      version: 1.3.1
+      - 0
+      version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.5.0
 signing_key: 
 specification_version: 3
-summary: Ruby library to access the Google Checkout service and implement notification handlers.
+summary: Full-featured Google Checkout library for Ruby
 test_files: 
 - test/integration/checkout_command_test.rb
 - test/unit/add_merchant_order_number_command_test.rb
@@ -202,6 +236,7 @@ test_files:
 - test/unit/order_adjustment_test.rb
 - test/unit/order_report_command_test.rb
 - test/unit/order_state_change_notification_test.rb
+- test/unit/parameterized_url_test.rb
 - test/unit/pickup_shipping_test.rb
 - test/unit/postal_area_test.rb
 - test/unit/private_data_parser_test.rb
@@ -218,6 +253,7 @@ test_files:
 - test/unit/tax_table_test.rb
 - test/unit/tracking_data_test.rb
 - test/unit/unarchive_order_command_test.rb
+- test/unit/url_parameter_test.rb
 - test/unit/us_country_area_test.rb
 - test/unit/us_state_area_test.rb
 - test/unit/us_zip_area_test.rb