awis-wrapper

#awis-wrapper

This is the wrapper for AWIS service, this thought derive from Ishango2 project.

##Usage

  Amazon::Awis.options = {:aws_access_key_id => "123", :aws_secret_key => "456", :action => "UrlInfo", :responsegroup => "RankByCountry"}

  #Or with one block
  Amazon::Awis.configure do |options|
      # options[:aws_access_key_id] = [your access key]
      # options[:aws_secret_key] = [you secret key]
      options[:responsegroup] = 'Rank'
  end

  #Call get_info method to get single website info
  res = Amazon::Awis.get_info('yahoo.com')
  if res.success? 
    all_countries = res.get_all('country')
    all_countries.each do |c|
      c.contribution.first.users.first  #navigate into the children tree. the accociations always return Array, so note the 'first' method.
    end
  end
  
  #Or get multiple websites info with batch request
  res = Amazon::Awis.get_info(]'yahoo.com', 'cnn.com')
  if res.success?
    res.get_all('response') # get all repsonse items in the document, then you can iterate all the response data with each "aws:Response"
    element = res.get('response') # this would get only one(the first) item in the document
    element.get_all_child('country') # all "aws:Country" items searched from current element. return Element class.
    #or directly access
    element.operation_request.first.request_id # would convert to camel case automaticly
    # to access the attribute
    element['Code'] == "US"
  end

Contributing to awis-wrapper

• Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
• Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
• Fork the project.
• Start a feature/bugfix branch.
• Commit and push until you are happy with your contribution.
• Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
• Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright

Copyright (c) 2013 Vincent.Z. See LICENSE.txt for further details.