completelynovel-amazon-product-advertising-api 0.0.2

data/EXAMPLE.rdoc

@@ -0,0 +1,81 @@
+require 'rubygems'
+require 'amazon_product_advertising_api'
+# Setup your API key - in an initializer or something like that
+AmazonProductAdvertisingApi::Base.api_key = "<insert api key here>"
+
+# Setup Associates IDs for whichever regions you're selling to
+AmazonProductAdvertisingApi::Base.associate_ids.uk = "<insert UK Associate ID here>"
+AmazonProductAdvertisingApi::Base.associate_ids.us = "<insert US Associate ID here>"
+
+lookup = AmazonProductAdvertisingApi::Operations::Item::ItemLookup.new("0201485419")
+lookup.run
+
+# Returned XML, tidied
+# <?xml version="1.0"?>
+# <ItemLookupResponse xmlns="http://webservices.amazon.com/AWSECommerceService/2005-10-05">
+#   <OperationRequest>
+#     <RequestId>d6c19392-7710-4b05-ad9c-1637755170d8</RequestId>
+#     <Arguments>
+#       <Argument Name="Operation" Value="ItemLookup"/>
+#       <Argument Name="Service" Value="AWSECommerceService"/>
+#       <Argument Name="ItemId" Value="0201485419"/>
+#       <Argument Name="AWSAccessKeyId" Value="<your api key>"/>
+#     </Arguments>
+#     <RequestProcessingTime>0.0376290000000000</RequestProcessingTime>
+#   </OperationRequest>
+#   <Items>
+#     <Request>
+#       <IsValid>True</IsValid>
+#       <ItemLookupRequest>
+#         <Condition>New</Condition>
+#         <DeliveryMethod>Ship</DeliveryMethod>
+#         <IdType>ASIN</IdType>
+#         <MerchantId>Amazon</MerchantId>
+#         <OfferPage>1</OfferPage>
+#         <ItemId>0201485419</ItemId>
+#         <ResponseGroup>Small</ResponseGroup>
+#         <ReviewPage>1</ReviewPage>
+#       </ItemLookupRequest>
+#     </Request>
+#     <Item>
+#       <ASIN>0201485419</ASIN>
+#       <DetailPageURL>http://www.amazon.co.uk/Art-Computer-Programming-Information-Processing/dp/0201485419%3FSubscriptionId%3D<your api key>%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3D0201485419</DetailPageURL>
+#       <ItemAttributes>git 
+#         <Author>Donald E. Knuth</Author>
+#         <Manufacturer>Addison Wesley</Manufacturer>
+#         <ProductGroup>Book</ProductGroup>
+#         <Title>The Art of Computer Programming: v. 1-3: Vol 1-3 (Series in Computer Science &amp; Information Processing)</Title>
+#       </ItemAttributes>
+#     </Item>
+#   </Items>
+# </ItemLookupResponse>
+
+lookup.response.items.size
+=> 1
+
+lookup.response.items.first
+=> #<AmazonProductAdvertisingApi::Item:0x139154c @detail_page_url="http://www.amazon.co.uk/Art-Computer-Programming-Information-Processing/dp/0201485419%3FSubscriptionId%3D<your api key>%26tag%3Dws%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3D0201485419", @item_attributes=#<AmazonProductAdvertisingApi::Container:0x1391448 @manufacturer="Addison Wesley", @product_group="Book", @title="The Art of Computer Programming: v. 1-3: Vol 1-3 (Series in Computer Science &amp; Information Processing)", @author="Donald E. Knuth">, @asin="0201485419">
+
+lookup.response.items.first.asin
+=> "0201485419"
+
+# ItemAttributes is a container element, doesn't return a string
+lookup.response.items.first.item_attributes
+=> #<AmazonProductAdvertisingApi::Container:0x1391448 @manufacturer="Addison Wesley", @product_group="Book", @title="The Art of Computer Programming: v. 1-3: Vol 1-3 (Series in Computer Science &amp; Information Processing)", @author="Donald E. Knuth">
+
+lookup.response.items.first.item_attributes.title
+=> "The Art of Computer Programming: v. 1-3: Vol 1-3 (Series in Computer Science &amp; Information Processing)"
+
+lookup.response.items.first.item_attributes.author
+=> "Donald E. Knuth"
+
+# If you need to debug, you can access all the xml data easily
+lookup.raw_data
+=> <XML string, straight from the request body>
+
+lookup.hpricot_data
+=> <the xml data, having been fed into Hpricot>
+
+# And also the request uri
+irb(main):022:0> lookup.request_uri
+=> #<URI::HTTP:0x1c7021c URL:http://ecs.amazonaws.co.uk/onca/xml?Service=AWSECommerceService&Operation=ItemLookup&ItemId=0201485419&AWSAccessKeyId=%3Cinsert%20api%20key%20here%3E>

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Jon Gilbraith, CompletelyNovel Ltd
+
+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/README.rdoc

@@ -0,0 +1,94 @@
+= amazon-product-advertising-api
+
+== Introduction
+A nice rubyish interface to the Amazon Product Advertising API, formerly
+known as the Associates Web Service and before that the Amazon E-Commerce
+Service.
+
+The basic design philosophy is the 'Principle of least surprise', so it's:
+- a dsl that should feel familiar to ruby folk.
+- structured generally like the API.
+
+== Prerequisites
+It's assumed you're reasonably familiar with Ruby as a language, and the
+typical coding patterns and styles employed by the community.
+
+It's also assumed that you're familiar with the API. If not go RTFM for a bit,
+it's all pretty straight forward.
+
+== Overview
+As mentioned before, the idea behind this is to model the API so that once
+you're familiar with this library and the API, you'll find this an easy way to
+navigate around it. You should then be able to just refer to the lists of
+Operations, Response Groups and Response Elements in the appendices for all
+you need to know.
+
+You initiate requests by instantiating classes representing api Operations and
+named the same way, i.e. ItemSearch, ItemLookup, etc. The request parameters
+are represented by attributes on those objects and can be manipulated as you
+wish.  If a parameter is required it'll be required or defaulted on
+initialization, but everywhere else we defer to the defaults provided by the
+api.
+
+Once setup, you call 'run' on the operation which will send the request and
+return a response object (and after that also available as operation.response).
+
+The response has a bit less structure than the request operations. There is no
+representation for Response Groups as beyond one level deep there is no clear
+pattern for how returned XML is structured (at least not without going down the
+route trying to define custom handling for each of them). So, instead we group
+the Operations into broad groups which return the same collections of data.
+ItemSearch, ItemLookup and SimilarityLookup all return a Items container
+element with one or more Item tag in it, etc.
+
+Everything beyond one level deep is done with a recursive sweep instantiating
+Element objects as we go.
+
+== Things to know
+- Amazon uses a lot of Camel case in their XML, but to suit Ruby / Rails
+  conventions attributes, etc are converted to underscore style.
+- One gotcha - Response Elements can either be a simple value or a container
+  with more elements inside. We recognise this situation by simply comparing
+  the parent and child names (plural parent, singular child) though that isn't
+  always the pattern so we also look for multiple children of the same name.
+  
+  That means that some situations might creep through and not work as expected.
+  If the parent and child don't follow the same naming convention and there is
+  also only one child element you'd find the child would be defined as
+  parent.child rather than parent.children.first.
+  
+  This is a bug and will have to be addressed (probably by making a list of
+  container elements to check against).
+  
+== Having problems?
+After running the request uri, returned raw xml and hpricot data will be
+available in operation.raw_data and operation.hpricot_data which should tell
+you all you need to know about the response.
+
+== Test coverage
+There aren't any tests at the moment but I'll try to add some.
+
+For the most part there isn't really all that much to test though as it's all
+largely just making http requests, however the XML parsing is quite convoluted
+so some tests would be good there to make sure the parsing is following the
+intended rules.
+
+
+= TODO
+- Implement the rest of the Operations (Cart*, Customer*, Help, List*, Seller*,
+  Tag*, Transaction* and Vehicle*).
+- Clean handling of routine errors such as rate limiting, etc.
+- Implement HMAC before the authentication requirement kicks in in August 2009.
+- Implement batch and multiple operation requests, abstracted away from the
+  user within the dsl.
+- Some sort of internal caching mechanism.
+- Ability to bind to different IP addresses, in order to circumvent API rate
+  limiting.
+
+
+= Credits
+Created by Jon Gilbraith, jon@completelynovel.com, while working with
+CompletelyNovel.
+
+Contents of support.rb are basically taken and adapted from Rails'
+ActiveSupport.

data/amazon-product-advertising-api.gemspec

@@ -0,0 +1,36 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{amazon-product-advertising-api}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors           = ["Jon Gilbraith"]
+  s.date              = %q{2009-06-11}
+  s.description       = %q{A nice rubyish interface to the Amazon Product Advertising API, formerly known as the Associates Web Service and before that the Amazon E-Commerce Service.}
+  s.email             = %q{jon@completelynovel.com}
+  s.files             = ["EXAMPLE.rdoc", "MIT-LICENSE", "README.rdoc", "amazon-product-advertising-api.gemspec", "lib/amazon_product_advertising_api", "lib/amazon_product_advertising_api/base.rb", "lib/amazon_product_advertising_api/operations", "lib/amazon_product_advertising_api/operations/base.rb", "lib/amazon_product_advertising_api/operations/browse_node.rb", "lib/amazon_product_advertising_api/operations/item.rb", "lib/amazon_product_advertising_api/support.rb", "lib/amazon_product_advertising_api.rb"]
+  s.has_rdoc          = false
+  s.homepage          = %q{http://github.com/completelynovel/amazon-product-advertising-api}
+  s.rdoc_options      = ["--inline-source", "--charset=UTF-8"]
+  s.require_paths     = ["lib"]
+  s.rubyforge_project = %q{amazon-pa-api}
+  s.rubygems_version  = %q{1.3.0}
+  s.summary           = %q{A nice rubyish interface to the Amazon Product Advertising API.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<mime-types>, [">= 1.15"])
+      s.add_runtime_dependency(%q<diff-lcs>, [">= 1.1.2"])
+    else
+      s.add_dependency(%q<mime-types>, [">= 1.15"])
+      s.add_dependency(%q<diff-lcs>, [">= 1.1.2"])
+    end
+  else
+    s.add_dependency(%q<mime-types>, [">= 1.15"])
+    s.add_dependency(%q<diff-lcs>, [">= 1.1.2"])
+  end
+end

data/lib/amazon_product_advertising_api.rb

@@ -0,0 +1,8 @@
+require 'net/http'
+require 'hpricot'
+
+require 'amazon_product_advertising_api/support'
+require 'amazon_product_advertising_api/base'
+require 'amazon_product_advertising_api/operations/base'
+require 'amazon_product_advertising_api/operations/browse_node'
+require 'amazon_product_advertising_api/operations/item'

data/lib/amazon_product_advertising_api/base.rb

@@ -0,0 +1,12 @@
+module AmazonProductAdvertisingApi
+  
+  class Base
+    
+    cattr_accessor :api_key
+    
+    cattr_accessor :associate_ids
+    @@associate_ids = Struct.new(:ca, :de, :fr, :jp, :uk, :us).new
+    
+  end
+  
+end

data/lib/amazon_product_advertising_api/operations/base.rb

@@ -0,0 +1,131 @@
+module AmazonProductAdvertisingApi
+  module Operations
+    module Base
+      
+      class Request
+    
+        attr_accessor :aws_access_key_id
+    
+        attr_accessor :region
+    
+        attr_accessor :operation
+        
+        attr_accessor :request_uri
+    
+        attr_accessor :raw_data
+    
+        attr_accessor :hpricot_data
+    
+        attr_accessor :response
+    
+        SERVICE_URLS = {
+            :us => 'http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService',
+            :uk => 'http://ecs.amazonaws.co.uk/onca/xml?Service=AWSECommerceService',
+            :ca => 'http://ecs.amazonaws.ca/onca/xml?Service=AWSECommerceService',
+            :de => 'http://ecs.amazonaws.de/onca/xml?Service=AWSECommerceService',
+            :jp => 'http://ecs.amazonaws.jp/onca/xml?Service=AWSECommerceService',
+            :fr => 'http://ecs.amazonaws.fr/onca/xml?Service=AWSECommerceService'
+        }
+    
+        def initialize
+          self.response = AmazonProductAdvertisingApi::Operations::Base::Element.new
+        end
+    
+        def query_amazon(params)
+          request_params = {}
+          request_params["AWSAccessKeyId"] = AmazonProductAdvertisingApi::Base.api_key
+          request_params["Operation"]      = self.operation
+          request_params["AssociateTag"]   = AmazonProductAdvertisingApi::Base.associate_ids.send(self.region) unless AmazonProductAdvertisingApi::Base.associate_ids.send(self.region).nil?
+          request_params.merge!(params)
+          
+          self.request_uri = "#{SERVICE_URLS[self.region]}&#{request_params.collect { |var, val| var.to_s.camelize + "=" + val.to_s }.join("&")}"
+          self.request_uri = URI.parse(URI.escape(self.request_uri))
+      
+          result = Net::HTTP::get_response(self.request_uri)
+          raise("Error connecting to Amazon") if !result.kind_of?(Net::HTTPSuccess)
+      
+          # Store away the raw data for debugging or if more direct access is required
+          self.raw_data     = result.body
+          self.hpricot_data = Hpricot.XML(self.raw_data)
+      
+          # Now parse the xml and build out the reponse elements
+          self.parse
+        end
+        
+        def parse
+          raise "This should be being overridden by it's subclass to provide custom parsing for the particular operation concerned."
+        end
+        
+        def run
+          self.query_amazon(params)
+        end
+        
+        private
+          # When passed an hpricot element it returns true or false based on whether this item is thought to be inside a Container Element.
+          # It does this in the rather crude way of seeing if the parent's name is the pluralized form of it's own, or it is one of
+          # several with the same name. This isn't 100% fool proof so I think at some point using a definitive list of the container elements
+          # would be a better way to go.
+          #
+          # The pluralisation could also do with something a bit more sophisticated.
+          def parent_a_container?(hpricot_element)
+            hpricot_element.parent.name == hpricot_element.name + "s" || hpricot_element.parent.search("> #{hpricot_element.name}").size > 1
+          end
+        
+      end
+      
+      class Element
+        
+        include Enumerable
+        
+        def initialize
+          @contained_elements = []
+        end
+        
+        def add_element(name, value = nil)
+          name = name.underscore
+
+          self.instance_eval %{
+            def self.#{name}
+              @#{name}
+            end
+            def self.#{name}=(value)
+              @#{name} ||= value
+            end
+          }
+
+          if !value.nil?
+            value = value.to_s if value.is_a?(Symbol)
+            self.send("#{name}=", value)
+          end
+
+          # Return the element
+          self.instance_eval("self.#{name}")
+        end
+        
+        def << element
+          @contained_elements << element
+        end
+        
+        def each(&block)
+          @contained_elements.each do |element|
+            yield element
+          end
+        end
+        
+        def [] position
+          @contained_elements[position]
+        end
+        
+        def first
+          @contained_elements.first
+        end
+        
+        def size
+          @contained_elements.size
+        end
+        
+      end
+    
+    end
+  end
+end

data/lib/amazon_product_advertising_api/operations/browse_node.rb

@@ -0,0 +1,65 @@
+module AmazonProductAdvertisingApi
+  module Operations
+    module BrowseNode
+      
+      class BrowseNodeLookup < AmazonProductAdvertisingApi::Operations::Base::Request
+        
+        REQUEST_PARAMETERS = :browse_node_id, :response_group
+      
+        REQUEST_PARAMETERS.each do |param|
+          self.send(:attr_accessor, param)
+        end
+
+        def initialize(browse_node_id, region = :uk)
+          super()
+
+          self.browse_node_id = browse_node_id
+          self.operation      = "BrowseNodeLookup"
+          self.region         = region
+        end
+        
+        def parse
+          self.response.add_element("BrowseNodes", AmazonProductAdvertisingApi::Operations::Base::Element.new)
+
+          (self.hpricot_data/'BrowseNodes > BrowseNode').each do |element|
+            new_element = AmazonProductAdvertisingApi::Operations::Base::Element.new
+            self.response.browse_nodes << new_element
+
+            queue = []
+            queue << [new_element, element.containers]
+            
+            queue.each do |pair|
+              current_element    = pair[0]
+              current_children = pair[1]
+          
+              current_children.each do |child|
+                if child.containers.size == 0
+                  current_element.add_element(child.name, child.inner_html)
+                else
+                  if parent_a_container?(child)
+                     new_element = AmazonProductAdvertisingApi::Operations::Base::Element.new
+                    current_element << new_element
+                    queue           << [new_element, child.containers]
+                  else
+                    new_element = current_element.add_element(child.name, AmazonProductAdvertisingApi::Operations::Base::Element.new)
+                    queue << [new_element, child.containers]
+                  end
+                end
+              end
+            end
+          end
+        end
+        
+        private
+          def params
+            REQUEST_PARAMETERS.inject({}) do |parameters, parameter|
+              parameters[parameter] = eval("self.#{parameter}") unless eval("self.#{parameter}.nil?")
+              parameters
+            end
+          end
+      
+      end
+            
+    end
+  end
+end

data/lib/amazon_product_advertising_api/operations/item.rb

@@ -0,0 +1,133 @@
+module AmazonProductAdvertisingApi
+  module Operations
+    module Item
+      
+      module Common
+        
+        def parse
+          self.response.add_element("Items", AmazonProductAdvertisingApi::Operations::Base::Element.new)
+
+          (self.hpricot_data/'Items > Item').each do |element|
+            new_element = AmazonProductAdvertisingApi::Operations::Base::Element.new
+            self.response.items << new_element
+
+            queue = []
+            queue << [new_element, element.containers]
+            
+            queue.each do |pair|
+              current_element    = pair[0]
+              current_children = pair[1]
+          
+              current_children.each do |child|
+                if child.containers.size == 0
+                  current_element.add_element(child.name, child.inner_html)
+                else
+                  if parent_a_container?(child)
+                     new_element = AmazonProductAdvertisingApi::Operations::Base::Element.new
+                    current_element << new_element
+                    queue           << [new_element, child.containers]
+                  else
+                    new_element = current_element.add_element(child.name, AmazonProductAdvertisingApi::Operations::Base::Element.new)
+                    queue << [new_element, child.containers]
+                  end
+                end
+              end
+            end
+          end
+        end
+        
+      end
+      
+      class ItemSearch < AmazonProductAdvertisingApi::Operations::Base::Request
+        
+        include Common
+        
+        REQUEST_PARAMETERS = :actor, :artist, :audience_rating, :author, :availability, :brand, :browse_node, :city,
+                             :composer, :condition, :conductor, :director, :item_page, :keywords, :manufacturer, :maximum_price,
+                             :merchant_id, :minimum_price, :neighborhood, :orchestra, :postal_code, :power, :publisher, :related_items_page,
+                             :relationship_type, :review_sort, :search_index, :sort, :tag_page, :tags_per_page, :tag_sort, :text_stream, :title,
+                             :variation_page, :response_group
+      
+        REQUEST_PARAMETERS.each do |param|
+          self.send(:attr_accessor, param)
+        end
+
+        def initialize(keywords, search_index = "Books", region = :uk)
+          super()
+
+          self.keywords     = keywords
+          self.search_index = search_index
+          self.operation    = "ItemSearch"
+          self.region       = region
+        end
+      
+        private
+          def params
+            REQUEST_PARAMETERS.inject({}) do |parameters, parameter|
+              parameters[parameter] = eval("self.#{parameter}") unless eval("self.#{parameter}.nil?")
+              parameters
+            end
+          end
+      
+      end
+      
+      class ItemLookup < AmazonProductAdvertisingApi::Operations::Base::Request
+        
+        include Common
+        
+        REQUEST_PARAMETERS = :condition, :id_type, :item_id, :merchant_id, :offer_page, :related_items_page, :relationship_type, :review_page,
+                             :review_sort, :search_index, :tag_page, :tags_per_page, :tag_sort, :variation_page, :response_group
+      
+        REQUEST_PARAMETERS.each do |param|
+          self.send(:attr_accessor, param)
+        end
+        
+        def initialize(item_id, region = :uk)
+          super()
+          
+          self.item_id   = item_id
+          self.operation = "ItemLookup"
+          self.region    = region
+        end
+      
+        private
+          def params
+            REQUEST_PARAMETERS.inject({}) do |parameters, parameter|
+              parameters[parameter] = eval("self.#{parameter}") unless eval("self.#{parameter}.nil?")
+              parameters
+            end
+          end
+          
+      end
+
+      class SimilarityLookup < AmazonProductAdvertisingApi::Operations::Base::Request
+        
+        include Common
+        
+        REQUEST_PARAMETERS = :condition, :item_id, :merchant_id, :similarity_type, :response_group
+      
+        REQUEST_PARAMETERS.each do |param|
+          self.send(:attr_accessor, param)
+        end
+        
+        def initialize(item_id, region = :uk)
+          super()
+          
+          self.item_id   = item_id
+          self.operation = "SimilarityLookup"
+          self.region    = region
+        end
+      
+        private
+          def params
+            REQUEST_PARAMETERS.inject({}) do |parameters, parameter|
+              parameters[parameter] = eval("self.#{parameter}") unless eval("self.#{parameter}.nil?")
+              parameters
+            end
+          end
+          
+      end
+      
+    end
+  end
+end

data/lib/amazon_product_advertising_api/support.rb

@@ -0,0 +1,55 @@
+class Class
+  def cattr_reader(sym)
+    class_eval(<<-EOS, __FILE__, __LINE__)
+      unless defined? @@#{sym}  # unless defined? @@hair_colors
+        @@#{sym} = nil          #   @@hair_colors = nil
+      end                       # end
+                                #
+      def self.#{sym}           # def self.hair_colors
+        @@#{sym}                #   @@hair_colors
+      end                       # end
+                                #
+      def #{sym}                # def hair_colors
+        @@#{sym}                #   @@hair_colors
+      end                       # end
+    EOS
+  end
+
+  def cattr_writer(sym)
+    class_eval(<<-EOS, __FILE__, __LINE__)
+      unless defined? @@#{sym}                       # unless defined? @@hair_colors
+        @@#{sym} = nil                               #   @@hair_colors = nil
+      end                                            # end
+                                                     #
+      def self.#{sym}=(obj)                          # def self.hair_colors=(obj)
+        @@#{sym} = obj                               #   @@hair_colors = obj
+      end                                            # end
+    EOS
+  end
+
+  def cattr_accessor(sym)
+    cattr_reader(sym)
+    cattr_writer(sym)
+  end
+  
+end
+
+class String
+
+  def camelize(first_letter_in_uppercase = true)
+    if first_letter_in_uppercase
+      self.to_s.gsub(/\/(.?)/) { "::" + $1.upcase }.gsub(/(^|_)(.)/) { $2.upcase }
+    else
+      self.first + camelize(self)[1..-1]
+    end
+  end
+  
+  def underscore
+    self.to_s.gsub(/::/, '/').
+      gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+      gsub(/([a-z\d])([A-Z])/,'\1_\2').
+      tr("-", "_").
+      downcase
+  end
+
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification 
+name: completelynovel-amazon-product-advertising-api
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Jon Gilbraith
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-06-11 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: mime-types
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.15"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: diff-lcs
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.2
+    version: 
+description: A nice rubyish interface to the Amazon Product Advertising API, formerly known as the Associates Web Service and before that the Amazon E-Commerce Service.
+email: jon@completelynovel.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- EXAMPLE.rdoc
+- MIT-LICENSE
+- README.rdoc
+- amazon-product-advertising-api.gemspec
+- lib/amazon_product_advertising_api
+- lib/amazon_product_advertising_api/base.rb
+- lib/amazon_product_advertising_api/operations
+- lib/amazon_product_advertising_api/operations/base.rb
+- lib/amazon_product_advertising_api/operations/browse_node.rb
+- lib/amazon_product_advertising_api/operations/item.rb
+- lib/amazon_product_advertising_api/support.rb
+- lib/amazon_product_advertising_api.rb
+has_rdoc: false
+homepage: http://github.com/completelynovel/amazon-product-advertising-api
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --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: amazon-pa-api
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A nice rubyish interface to the Amazon Product Advertising API.
+test_files: []
+