jy-amazon-ecs 2.2.5

data/CHANGELOG

@@ -0,0 +1,102 @@
+2.2.4 2012-01-01
+----------------
+* Parse with UTF-8 encoding, happy new year :)
+
+2.2.3 2011-12-05
+----------------
+* Add Amazon Spain API
+
+2.2.2 2011-11-18
+----------------
+* Add VERSION constant in Amazon::Ecs
+* Update dependent gems version in Gemfile
+* Add Gemfile as part of the gem content
+* Update amazon-ecs.gemspec
+
+2.2.1 2011-10-25
+----------------
+* Add Gemfile
+* Rake, run test task by default
+* Rename README to README.rdoc
+* Upate README, add search index information
+
+2.2.0 2011-9-06
+----------------
+* Upgrade to Product Advertising API version to 2011-08-01
+* Fix IT service url and add support for CN URL
+* Add unit test for all service urls
+
+2.1.1 2011-09-05
+----------------
+* Fix wrong JP service url
+* Add Ecs.browser_node_lookup method
+
+2.1.0 2011-08-18
+----------------
+* Update service urls
+* Raise error when aws_secret_key is not found
+
+2.0.0 2011-05-09
+----------------
+* Replace Hpricot parser with Nokogiri
+* Element/Attribute retrieval to match XPath, name not automatically downcased as in Hpricot
+
+1.2.2 2011-05-07
+----------------
+* Add marshal_dump and marshal_load support
+
+1.2.1 2011-02-23
+----------------
+* Add support for Amazon Italy
+
+1.2.0 2011-02-07
+----------------
+* Remove test/ecs_signature_test.rb and test/test_helper.rb
+* Fix multibyte search on Ruby 1.9 returns HTTP Response: 403 Forbidden
+
+1.1.0 2010-11-11
+----------------
+* Add get_elements, get_element, and attributes instance methods in Amazon::Element
+* Deprecate Amazon::Element#search_and_convert
+
+1.0.0 2010-11-09
+----------------
+* Set default Amazon API version to 2010-10-01
+
+0.5.7 2009-08-28
+----------------
+* Added support for to sign request using openssl with fallback on ruby-hmac
+
+0.5.6 2009-07-21
+----------------
+* Update parameter value encoding to support special characters
+
+0.5.5 2009-07-18
+----------------
+* Sign request
+
+0.5.4 2008-01-02
+----------------
+* Add Response#error_code
+
+0.5.3 2007-09-12
+----------------
+* send_request to use default options.
+
+0.5.2 2007-09-08
+----------------
+* Fixed Amazon::Element.get_unescaped error when result returned for given element path is nil
+
+0.5.1 2007-02-08
+----------------
+* Fixed Amazon Japan and France URL error
+* Removed opts.delete(:search_index) from item_lookup, SearchIndex param is allowed 
+  when looking for a book with IdType other than the ASIN.
+* Check for defined? RAILS_DEFAULT_LOGGER to avoid exception for non-rails ruby app
+* Added check for LOGGER constant if RAILS_DEFAULT_LOGGER is not defined
+* Added Ecs.configure(&proc) method for easier configuration of default options
+* Added Element#search_and_convert method
+
+0.5.0 2006-09-12
+----------------
+Initial Release

data/Gemfile

@@ -0,0 +1,8 @@
+source :rubygems
+
+gem 'nokogiri', '~> 1.4'
+gem 'ruby-hmac', '~> 0.3'
+
+group :dev do
+  gem 'rake'
+end

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2011 Herryanto Siatono
+
+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/Rakefile

@@ -0,0 +1,24 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rake/packagetask'
+
+desc "Create the RDOC html files"
+rd = Rake::RDocTask.new("rdoc") { |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title    = "amazon-ecs"
+  rdoc.options << '--line-numbers' << '--inline-source' << '--main' << 'Readme.rdoc'
+  rdoc.rdoc_files.include('Readme.rdoc', 'CHANGELOG')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.rdoc_files.include('test/**/*.rb')
+}
+
+desc "Run the unit tests in test"
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+task :default => :test

data/Readme.rdoc

@@ -0,0 +1,141 @@
+== amazon-ecs
+
+Generic Product Advertising Ruby API using Nokogiri. Uses Response and 
+Element wrapper classes for easy access to the REST API XML output.
+
+It is generic, so you can easily extend <tt>Amazon::Ecs</tt> to support 
+other not implemented REST operations; and it is also generic because it just wraps around
+Nokogiri element object, instead of providing one-to-one object/attributes to XML elements map.
+
+The idea is as the API evolves, there is a change in REST XML output structure, 
+no updates will be required on <tt>amazon-ecs</tt> gem, 
+instead you just need to update the element path. 
+
+For HPricot dependency implementation, please install 1.2.x version or checkout v1.2 branch.
+
+== INSTALLATION
+
+  $ gem install amazon-ecs
+
+== EXAMPLE
+
+    require 'amazon/ecs'
+	
+    # Set the default options; options will be camelized and converted to REST request parameters.
+    # associate_tag and AWS_access_key_id are required options, associate_tag is required option
+    # since API version 2011-08-01. 
+    #
+    # To sign your request, include AWS_secret_key. 
+    Amazon::Ecs.options = {
+      :associate_tag => '[your associate tag]',
+      :AWS_access_key_id => '[your developer token]',       
+      :AWS_secret_key => '[your secret access key]'
+    }
+
+    # alternatively,
+    Amazon::Ecs.configure do |options|
+      options[:associate_tag] = '[your associate tag]'
+      options[:AWS_access_key_id] = '[your access key]'
+      options[:AWS_secret_key] = '[you secret key]'
+    end
+
+    # options provided on method call will merge with the default options
+    res = Amazon::Ecs.item_search('ruby', {:response_group => 'Medium', :sort => 'salesrank'})
+    
+    # search amazon uk
+    res = Amazon::Ecs.item_search('ruby', :country => 'uk')
+
+    # search all items, default search index is Books
+    res = Amazon::Ecs.item_search('ruby', :search_index => 'All')
+    
+    # some common response object methods
+    res.is_valid_request?     # return true if request is valid
+    res.has_error?            # return true if there is an error
+    res.error                 # return error message if there is any
+    res.total_pages           # return total pages
+    res.total_results         # return total results
+    res.item_page             # return current page no if :item_page option is provided
+
+    # traverse through each item (Amazon::Element)
+    res.items.each do |item|
+      # retrieve string value using XML path
+      item.get('ASIN')
+      item.get('ItemAttributes/Title')
+
+      # return Amazon::Element instance
+      item_attributes = item.get_element('ItemAttributes')
+      item_attributes.get('Title')
+  
+      # return first author or a string array of authors
+      item_attributes.get('Author')          # 'Author 1'
+      item_attributes.get_array('Author')    # ['Author 1', 'Author 2', ...]
+  
+      # return an hash of children text values with the element names as the keys
+      item.get_hash('SmallImage') # {:url => ..., :width => ..., :height => ...}
+
+      # return the first matching path as Amazon::Element
+      item_height = item.get_element('ItemDimensions/Height')
+      
+      # retrieve attributes from Amazon::Element
+      item_height.attributes['Units']   # 'hundredths-inches'
+      
+      # return an array of Amazon::Element
+      authors = item.get_elements('Author')
+  
+      # return Nokogiri::XML::NodeSet object or nil if not found
+      reviews = item/'EditorialReview'
+  
+      # traverse through Nokogiri elements
+      reviews.each do |review|
+        # Getting hash value out of Nokogiri element
+        Amazon::Element.get_hash(review) # [:source => ..., :content ==> ...]
+    
+        # Or to get unescaped HTML values
+        Amazon::Element.get_unescaped(review, 'Source')
+        Amazon::Element.get_unescaped(review, 'Content')
+        
+        # Or this way
+        el = Amazon::Element.new(review)
+        el.get_unescaped('Source')
+        el.get_unescaped('Content')
+      end
+    end
+    
+    # Extend Amazon::Ecs, replace 'other_operation' with the appropriate name
+    module Amazon
+      class Ecs
+        def self.other_operation(item_id, opts={})
+          opts[:operation] = '[other valid operation supported by Product Advertising API]'
+          
+          # setting default option value
+          opts[:item_id] = item_id
+        
+          self.send_request(opts)
+        end
+      end
+    end
+    
+    Amazon::Ecs.other_operation('[item_id]', :param1 => 'abc', :param2 => 'xyz')
+
+Refer to Amazon Product Advertising API documentation for more information 
+on other valid operations, request parameters and the XML response output:
+https://affiliate-program.amazon.com/gp/advertising/api/detail/main.html
+
+To get a sample of Amazon REST XML response output, use AWSZone.com scratch pad:
+http://www.awszone.com/scratchpads/aws/ecs.us/index.aws
+
+== SOURCE CODES
+
+* http://github.com/jugend/amazon-ecs
+
+== CREDITS
+
+Thanks to Dan Milne (http://da.nmilne.com/) for the signed request patch.
+
+Thanks to Bryan Housel (https://github.com/bhousel/amazon-ecs) for the initial Nokogiri patch 
+
+== LICENSE
+
+(The MIT License)
+
+Copyright (c) 2011 Herryanto Siatono, http://www.siatono.com

data/amazon-ecs.gemspec

@@ -0,0 +1,34 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require 'amazon/version'
+
+Gem::Specification.new do |gem|
+  gem.name = %q{jy-amazon-ecs}
+  gem.version = Amazon::Ecs::VERSION
+  gem.platform = Gem::Platform::RUBY
+  gem.authors = ["Herryanto Siatono"]
+  gem.email = %q{herryanto@gmail.com}
+  gem.homepage = %q{https://github.com/jugend/amazon-ecs}
+  gem.summary = %q{Generic Amazon Product Advertising Ruby API.}
+  gem.description = %q{Generic Amazon Product Advertising Ruby API.}
+
+  gem.files = `git ls-files`.split("\n")
+  gem.test_files = `git ls-files -- test/*`.split("\n")
+  gem.require_paths = ["lib"]
+ 
+  if gem.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    gem.specification_version = 2
+ 
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      gem.add_runtime_dependency("nokogiri", "~> 1.4")
+      gem.add_runtime_dependency("ruby-hmac", "~> 0.3")
+    else
+      gem.add_dependency("nokogiri", "~> 1.4")
+      gem.add_dependency("ruby-hmac", "~> 0.3")
+    end
+  else
+    gem.add_dependency("nokogiri", "~> 1.4")
+    gem.add_dependency("ruby-hmac", "~> 0.3")
+  end
+end

data/lib/amazon/ecs.rb

@@ -0,0 +1,403 @@
+#--
+# Copyright (c) 2010 Herryanto Siatono
+#
+# 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 'net/http'
+require 'nokogiri'
+require 'cgi'
+require 'hmac-sha2'
+require 'base64'
+require 'openssl'
+
+module Amazon
+  class RequestError < StandardError; end
+  
+  class Ecs
+    
+    SERVICE_URLS = {
+        :us => 'http://ecs.amazonaws.com/onca/xml',
+        :uk => 'http://ecs.amazonaws.co.uk/onca/xml',
+        :ca => 'http://ecs.amazonaws.ca/onca/xml',
+        :de => 'http://ecs.amazonaws.de/onca/xml',
+        :jp => 'http://ecs.amazonaws.jp/onca/xml',
+        :fr => 'http://ecs.amazonaws.fr/onca/xml',
+        :it => 'http://webservices.amazon.it/onca/xml',
+        :cn => 'http://webservices.amazon.cn/onca/xml',
+        :es => 'http://webservices.amazon.es/onca/xml'
+    }
+    
+    OPENSSL_DIGEST_SUPPORT = OpenSSL::Digest.constants.include?( 'SHA256' ) ||
+                             OpenSSL::Digest.constants.include?( :SHA256 )
+    
+    OPENSSL_DIGEST = OpenSSL::Digest::Digest.new( 'sha256' ) if OPENSSL_DIGEST_SUPPORT
+    
+    @@options = {
+      :version => "2011-08-01",
+      :service => "AWSECommerceService"
+    }
+    
+    @@debug = false
+
+    # Default search options
+    def self.options
+      @@options
+    end
+    
+    # Set default search options
+    def self.options=(opts)
+      @@options = opts
+    end
+    
+    # Get debug flag.
+    def self.debug
+      @@debug
+    end
+    
+    # Set debug flag to true or false.
+    def self.debug=(dbg)
+      @@debug = dbg
+    end
+    
+    def self.configure(&proc)
+      raise ArgumentError, "Block is required." unless block_given?
+      yield @@options
+    end
+    
+    # Search amazon items with search terms. Default search index option is 'Books'.
+    # For other search type other than keywords, please specify :type => [search type param name].
+    def self.item_search(terms, opts = {})
+      opts[:operation] = 'ItemSearch'
+      opts[:search_index] = opts[:search_index] || 'Books'
+      
+      type = opts.delete(:type)
+      if type 
+        opts[type.to_sym] = terms
+      else 
+        opts[:keywords] = terms
+      end
+      
+      self.send_request(opts)
+    end
+
+    # Search an item by ASIN no.
+    def self.item_lookup(item_ids, opts = {})
+      item_ids = [item_ids] unless item_ids.is_a?(Array)
+      opts[:operation] = 'ItemLookup'
+      opts[:item_id] = item_ids.join(',')
+      
+      self.send_request(opts)
+    end    
+
+    # Search a browse node by BrowseNodeId
+    def self.browse_node_lookup(browse_node_id, opts = {})
+      opts[:operation] = 'BrowseNodeLookup'
+      opts[:browse_node_id] = browse_node_id
+      
+      self.send_request(opts)
+    end    
+    
+    # Search a browse node by BrowseNodeId
+    def self.browse_node_lookup_multi(browse_node_ids, opts = {})
+      opts[:operation] = 'BrowseNodeLookup'
+      browse_node_ids.each_with_index do |id, index|
+        opts[:"browse_node_id.#{index + 1}"] = id
+      end
+      raise "Response parsing not implemented!"
+      self.send_request(opts)
+    end    
+    
+
+    # Generic send request to ECS REST service. You have to specify the :operation parameter.
+    def self.send_request(opts)
+      opts = self.options.merge(opts) if self.options
+      
+      # Include other required options
+      opts[:timestamp] = Time.now.utc.strftime("%Y-%m-%dT%H:%M:%SZ")
+
+      request_url = prepare_url(opts)
+      log "Request URL: #{request_url}"
+      
+      res = Net::HTTP.get_response(URI::parse(request_url))
+      unless res.kind_of? Net::HTTPSuccess
+        raise Amazon::RequestError, "HTTP Response: #{res.code} #{res.message}"
+      end
+      Response.new(res.body)
+    end
+    
+    def self.validate_request(opts) 
+      raise Amazon::RequestError, "" if opts[:associate_tag]
+    end
+
+    # Response object returned after a REST call to Amazon service.
+    class Response
+      
+      # XML input is in string format
+      def initialize(xml)
+        @doc = Nokogiri::XML(xml, nil, 'UTF-8')
+        @doc.remove_namespaces!
+        # @doc.xpath("//*").each { |elem| elem.name = elem.name.downcase }
+        # @doc.xpath("//@*").each { |att| att.name = att.name.downcase }
+      end
+
+      # Return Nokogiri::XML::Document object.
+      def doc
+        @doc
+      end
+
+      # Return true if request is valid.
+      def is_valid_request?
+        Element.get(@doc, "//IsValid") == "True"
+      end
+
+      # Return true if response has an error.
+      def has_error?
+        !(error.nil? || error.empty?)
+      end
+
+      # Return error message.
+      def error
+        Element.get(@doc, "//Error/Message")
+      end
+      
+      # Return error code
+      def error_code
+        Element.get(@doc, "//Error/Code")
+      end
+      
+      # Return an array of Amazon::Element item objects.
+      def items
+        @items ||= (@doc/"Item").collect { |item| Element.new(item) }
+      end
+      
+      # Return the first item (Amazon::Element)
+      def first_item
+        items.first
+      end
+      
+      def children_browse_nodes
+        @children_browse_nodes ||= (@doc/"BrowseNodes/BrowseNode/Children/BrowseNode").collect { |item| Element.new(item) }
+      end
+
+      # Return current page no if :item_page option is when initiating the request.
+      def item_page
+        @item_page ||= Element.get(@doc, "//ItemPage").to_i
+      end
+
+      # Return total results.
+      def total_results
+        @total_results ||= Element.get(@doc, "//TotalResults").to_i
+      end
+      
+      # Return total pages.
+      def total_pages
+        @total_pages ||= Element.get(@doc, "//TotalPages").to_i
+      end
+
+      def marshal_dump
+        @doc.to_s
+      end
+
+      def marshal_load(xml)
+        initialize(xml)
+      end
+    end
+    
+    protected
+      def self.log(s)
+        return unless self.debug
+        if defined? RAILS_DEFAULT_LOGGER
+          RAILS_DEFAULT_LOGGER.error(s)
+        elsif defined? LOGGER
+          LOGGER.error(s)
+        else
+          puts s
+        end
+      end
+      
+    private 
+      def self.prepare_url(opts)
+        country = opts.delete(:country)
+        country = (country.nil?) ? 'us' : country
+        request_url = SERVICE_URLS[country.to_sym]
+        raise Amazon::RequestError, "Invalid country '#{country}'" unless request_url
+
+        secret_key = opts.delete(:AWS_secret_key)
+        request_host = URI.parse(request_url).host
+        
+        qs = ''
+        
+        opts = opts.collect do |a,b| 
+          [camelize(a.to_s), b.to_s] 
+        end
+        
+        opts = opts.sort do |c,d| 
+          c[0].to_s <=> d[0].to_s
+        end
+        
+        opts.each do |e| 
+          log "Adding #{e[0]}=#{e[1]}"
+          next unless e[1]
+          e[1] = e[1].join(',') if e[1].is_a? Array
+          # v = URI.encode(e[1].to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))
+          v = self.url_encode(e[1].to_s)
+          qs << "&" unless qs.length == 0
+          qs << "#{e[0]}=#{v}"
+        end
+        #log "QS: @#{qs}"        
+        signature = ''
+        unless secret_key.nil?
+          request_to_sign="GET\n#{request_host}\n/onca/xml\n#{qs}"
+          signature = "&Signature=#{sign_request(request_to_sign, secret_key)}"
+        end
+
+        "#{request_url}?#{qs}#{signature}"
+      end
+      
+      def self.url_encode(string)
+        string.gsub( /([^a-zA-Z0-9_.~-]+)/ ) do
+          '%' + $1.unpack( 'H2' * $1.bytesize ).join( '%' ).upcase
+        end
+      end
+      
+      def self.camelize(s)
+        s.to_s.gsub(/\/(.?)/) { "::" + $1.upcase }.gsub(/(^|_)(.)/) { $2.upcase }
+      end
+      
+      def self.sign_request(url, key)
+        return nil if key.nil?
+        
+        if (OPENSSL_DIGEST_SUPPORT)
+          signature = OpenSSL::HMAC.digest(OPENSSL_DIGEST, key, url)
+          signature = [signature].pack('m').chomp
+        else
+          signature = Base64.encode64( HMAC::SHA256.digest(key, url) ).strip
+        end
+        signature = URI.escape(signature, Regexp.new("[+=]"))
+        return signature
+      end
+  end
+
+  # Internal wrapper class to provide convenient method to access Nokogiri element value.
+  class Element
+    class << self
+      # Return the text value of an element.
+      def get(element, path='.')
+        return unless element
+        result = element.at_xpath(path)
+        result = result.inner_html if result
+        result
+      end
+    
+      # Return an unescaped text value of an element.
+      def get_unescaped(element, path='.')
+        result = self.get(element, path)
+        CGI::unescapeHTML(result) if result
+      end
+
+      # Return an array of values based on the given path.
+      def get_array(element, path='.')
+        return unless element
+      
+        result = element/path
+        if (result.is_a? Nokogiri::XML::NodeSet) || (result.is_a? Array)
+          result.collect { |item| self.get(item) }
+        else
+          [self.get(result)]
+        end
+      end
+
+      # Return child element text values of the given path.
+      def get_hash(element, path='.')
+        return unless element
+    
+        result = element.at_xpath(path)
+        if result
+          hash = {}
+          result = result.children
+          result.each do |item|
+            hash[item.name] = item.inner_html
+          end 
+          hash
+        end
+      end
+    end
+    
+    # Pass Nokogiri::XML::Element object
+    def initialize(element)
+      @element = element
+    end
+
+    # Returns Nokogiri::XML::Element object    
+    def elem
+      @element
+    end
+    
+    # Returns a Nokogiri::XML::NodeSet of elements matching the given path. Example: element/"author".
+    def /(path)
+      elements = @element/path
+      return nil if elements.size == 0
+      elements
+    end
+
+    # Return an array of Amazon::Element matching the given path
+    def get_elements(path)
+      elements = self./(path)
+      return unless elements
+      elements = elements.map{|element| Element.new(element)}
+    end
+    
+    # Similar with search_and_convert but always return first element if more than one elements found
+    def get_element(path)
+      elements = get_elements(path)
+      elements[0] if elements
+    end
+
+    # Get the text value of the given path, leave empty to retrieve current element value.
+    def get(path='.')
+      Element.get(@element, path)
+    end
+    
+    # Get the unescaped HTML text of the given path.
+    def get_unescaped(path='.')
+      Element.get_unescaped(@element, path)
+    end
+    
+    # Get the array values of the given path.
+    def get_array(path='.')
+      Element.get_array(@element, path)
+    end
+
+    # Get the children element text values in hash format with the element names as the hash keys.
+    def get_hash(path='.')
+      Element.get_hash(@element, path)
+    end
+    
+    def attributes
+      return unless self.elem
+      self.elem.attributes
+    end
+    
+    def to_s
+      elem.to_s if elem
+    end
+  end
+end