awis-sdk-ruby_ 1.1.1p1

data/lib/awis/api/category_browse.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Awis
+  module API
+    class CategoryBrowse < Base
+      DEFAULT_RESPONSE_GROUP = %w[categories related_categories language_categories letter_bars].freeze
+
+      def load_request_uri(arguments = {})
+        validation_arguments!(arguments)
+
+        super(params)
+      end
+
+      private
+
+      def before_validation_arguments(arguments)
+        raise ArgumentError, "Invalid arguments. should be like { path: 'Top/Arts' }" unless arguments.is_a?(Hash)
+        raise ArgumentError, 'Invalid arguments. the path must be configured.' unless arguments.key?(:path)
+      end
+
+      def validation_arguments!(arguments)
+        before_validation_arguments(arguments)
+
+        @arguments = arguments
+        @arguments[:response_group] = Array(arguments.fetch(:response_group, DEFAULT_RESPONSE_GROUP))
+        @arguments[:descriptions]   = arguments.fetch(:descriptions, true)
+      end
+
+      def params
+        {
+          'Action'        => action_name,
+          'ResponseGroup' => response_groups,
+          'Path'          => arguments[:path],
+          'Descriptions'  => request_description_params
+        }
+      end
+
+      def response_groups
+        arguments[:response_group].sort.map { |group| camelize(group) }.join(',')
+      end
+    end
+  end
+end

data/lib/awis/api/category_listings.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Awis
+  module API
+    class CategoryListings < Base
+      DEFAULT_RESPONSE_GROUP = %w[listings].freeze
+
+      def load_request_uri(arguments = {})
+        validation_arguments!(arguments)
+
+        super(params)
+      end
+
+      private
+
+      def before_validation_arguments(arguments)
+        raise ArgumentError, "Invalid arguments. should be like { path: '/Top/Games/Card_Games' }" unless arguments.is_a?(Hash)
+        raise ArgumentError, 'Invalid arguments. the path must be configured.' unless arguments.key?(:path)
+      end
+
+      def validation_arguments!(arguments)
+        before_validation_arguments(arguments)
+
+        @arguments = arguments
+        @arguments[:sort_by]      = arguments.fetch(:sort_by, 'popularity')
+        @arguments[:recursive]    = arguments.fetch(:recursive, true)
+        @arguments[:descriptions] = arguments.fetch(:descriptions, true)
+        @arguments[:start]        = arguments.fetch(:start, 0)
+        @arguments[:count]        = arguments.fetch(:count, 20)
+      end
+
+      def params
+        {
+          'Action'        => action_name,
+          'ResponseGroup' => response_groups,
+          'Path'          => arguments[:path],
+          'Recursive'     => recursive_param,
+          'Descriptions'  => request_description_params,
+          'SortBy'        => sort_by_param,
+          'Count'         => arguments[:count],
+          'Start'         => arguments[:start]
+        }
+      end
+
+      def recursive_param
+        arguments[:recursive].to_s.capitalize
+      end
+
+      def sort_by_param
+        camelize(arguments[:sort_by])
+      end
+
+      def response_groups
+        DEFAULT_RESPONSE_GROUP.map { |group| camelize(group) }.join(',')
+      end
+    end
+  end
+end

data/lib/awis/api/sites_linking_in.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Awis
+  module API
+    class SitesLinkingIn < Base
+      DEFAULT_RESPONSE_GROUP = %w[sites_linking_in].freeze
+
+      def load_request_uri(arguments = {})
+        validation_arguments!(arguments)
+
+        super(params)
+      end
+
+      private
+
+      def validation_arguments!(arguments)
+        before_validation_arguments(arguments)
+
+        @arguments = arguments
+        @arguments[:count] = arguments.fetch(:count, 20)
+        @arguments[:start] = arguments.fetch(:start, 0)
+      end
+
+      def params
+        {
+          'Action'        => action_name,
+          'Url'           => arguments[:url],
+          'ResponseGroup' => response_groups,
+          'Count'         => arguments[:count],
+          'Start'         => arguments[:start]
+        }
+      end
+
+      def response_groups
+        DEFAULT_RESPONSE_GROUP.map { |group| camelize(group) }.join(',')
+      end
+    end
+  end
+end

data/lib/awis/api/traffic_history.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Awis
+  module API
+    class TrafficHistory < Base
+      DEFAULT_RESPONSE_GROUP = %w[history].freeze
+
+      def load_request_uri(arguments = {})
+        validation_arguments!(arguments)
+
+        super(params)
+      end
+
+      private
+
+      def params
+        {
+          'Action'        => action_name,
+          'Url'           => arguments[:url],
+          'ResponseGroup' => response_groups,
+          'Range'         => arguments[:range],
+          'Start'         => start_date
+        }
+      end
+
+      def validation_arguments!(arguments)
+        before_validation_arguments(arguments)
+
+        @arguments = arguments
+        @arguments[:range] = arguments.fetch(:range, 31)
+        @arguments[:start] = arguments.fetch(:start) { Time.now - (3600 * 24 * @arguments[:range].to_i) }
+      end
+
+      def start_date
+        arguments[:start].respond_to?(:strftime) ? arguments[:start].strftime('%Y%m%d') : arguments[:start]
+      end
+
+      def response_groups
+        DEFAULT_RESPONSE_GROUP.map { |group| camelize(group) }.join(',')
+      end
+    end
+  end
+end

data/lib/awis/api/url_info.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Awis
+  module API
+    class UrlInfo < Base
+      DEFAULT_RESPONSE_GROUP = %w[
+        related_links categories rank rank_by_country usage_stats
+        adult_content speed language owned_domains links_in_count site_data
+      ].freeze
+
+      def load_request_uri(arguments = {})
+        validation_arguments!(arguments)
+
+        super(params)
+      end
+
+      private
+
+      def validation_arguments!(arguments)
+        before_validation_arguments(arguments)
+
+        @arguments = arguments
+        @arguments[:response_group] = Array(arguments.fetch(:response_group, DEFAULT_RESPONSE_GROUP))
+      end
+
+      def params
+        {
+          'Action'        => action_name,
+          'Url'           => arguments[:url],
+          'ResponseGroup' => response_groups
+        }
+      end
+
+      def response_groups
+        arguments[:response_group].sort.map { |group| camelize(group) }.join(',')
+      end
+    end
+  end
+end

data/lib/awis/client.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Awis
+  class Client
+    def initialize
+      raise CertificateError, 'Amazon access certificate is missing!' if Awis.config.access_key_id.nil? || Awis.config.secret_access_key.nil?
+    end
+
+    def url_info(args)
+      parse_response_with_request('UrlInfo', args)
+    end
+
+    def traffic_history(args)
+      parse_response_with_request('TrafficHistory', args)
+    end
+
+    def sites_linking_in(args)
+      parse_response_with_request('SitesLinkingIn', args)
+    end
+
+    def category_browse(args)
+      parse_response_with_request('CategoryBrowse', args)
+    end
+
+    def category_listings(args)
+      parse_response_with_request('CategoryListings', args)
+    end
+
+    private
+
+    def parse_response_with_request(kclass, args)
+      case kclass
+      when 'UrlInfo'
+        Models::UrlInfo.new API::UrlInfo.new.fetch(args)
+      when 'SitesLinkingIn'
+        Models::SitesLinkingIn.new API::SitesLinkingIn.new.fetch(args)
+      when 'TrafficHistory'
+        Models::TrafficHistory.new API::TrafficHistory.new.fetch(args)
+      when 'CategoryBrowse'
+        Models::CategoryBrowse.new API::CategoryBrowse.new.fetch(args)
+      when 'CategoryListings'
+        Models::CategoryListings.new API::CategoryListings.new.fetch(args)
+      end
+    end
+  end
+end

data/lib/awis/config.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'singleton'
+
+module Awis
+  class Config
+    include Singleton
+    attr_accessor :access_key_id, :secret_access_key, :proxy, :debug, :protocol,
+                  :timeout, :open_timeout, :logger
+  end
+
+  def self.config
+    yield Config.instance if block_given?
+
+    Config.instance
+  end
+end

data/lib/awis/connection.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require 'cgi'
+require 'aws-sigv4'
+require 'net/https'
+
+module Awis
+  class Connection
+    attr_accessor :debug, :protocol
+    attr_reader :params, :secret_access_key, :access_key_id
+
+    HEADERS = {
+      'accept' => 'application/xml',
+      'content-type' => 'application/xml',
+      'user-agent' => "awis-sdk-ruby v#{Awis::VERSION}"
+    }.freeze
+
+    def initialize(options = {})
+      @secret_access_key = options.fetch(:secret_access_key, Awis.config.secret_access_key)
+      @access_key_id     = options.fetch(:access_key_id, Awis.config.access_key_id)
+      raise CertificateError, 'Amazon access certificate is missing!' if @secret_access_key.nil? || @access_key_id.nil?
+
+      setup_options!
+    end
+
+    def setup_options!
+      @debug        = Awis.config.debug || false
+      @protocol     = Awis.config.protocol || 'https'
+      @timeout      = Awis.config.timeout || 10
+      @open_timeout = Awis.config.open_timeout || 10
+    end
+
+    def get(params = {})
+      @params = params
+      handle_response(request).body
+    end
+
+    private
+
+    def handle_response(response)
+      case response
+      when Net::HTTPSuccess
+        response
+      else
+        handle_error_response(response)
+      end
+    end
+
+    def handle_error_response(response)
+      case response.code.to_i
+      when 300...600
+        if response.body.nil?
+          raise ResponseError.new(nil, response)
+        else
+          error_message = MultiXml.parse(response.body).deep_find('ErrorCode')
+          raise ResponseError.new(error_message, response)
+        end
+      else
+        raise ResponseError.new("Unknown code: #{response.code}", response)
+      end
+    end
+
+    def request
+      req = Net::HTTP::Get.new(uri)
+      headers.each do |key, value|
+        req[key] = value
+      end
+      Net::HTTP.start(
+        uri.hostname,
+        uri.port,
+        use_ssl: uri.scheme == 'https',
+        ssl_timeout: @timeout,
+        open_timeout: @open_timeout
+      ) do |http|
+        http.request(req)
+      end
+    end
+
+    def uri
+      @uri ||= URI.parse("#{protocol}://#{Awis::SERVICE_HOST}/#{Awis::SERVICE_PATH}?#{query}")
+    end
+
+    def headers
+      HEADERS.merge(auth_headers)
+    end
+
+    def auth_headers
+      signer.sign_request(
+        http_method: 'GET',
+        headers: HEADERS,
+        url: uri.to_s
+      ).headers
+    end
+
+    def signer
+      Aws::Sigv4::Signer.new(
+        service: Awis::SERVICE_NAME,
+        region: Awis::SERVICE_REGION,
+        access_key_id: access_key_id,
+        secret_access_key: secret_access_key
+      )
+    end
+
+    def query
+      params.map do |key, value|
+        "#{key}=#{CGI.escape(value.to_s)}"
+      end.sort!.join('&')
+    end
+  end
+end

data/lib/awis/exceptions.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Awis
+  # Awis exceptions can be caught by rescuing: Awis::StandardError
+
+  class CertificateError < StandardError; end
+
+  class ResponseError < StandardError
+    attr_reader :response
+
+    def initialize(message, response)
+      @response = response
+      super(message)
+    end
+  end
+end

data/lib/awis/hash.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class Hash
+  def array_slice_merge!(key, array, count)
+    self[key] = array.each_slice(count).collect { |e| e.reduce({}, :merge) }
+  end
+
+  def deep_find(key, object = self, found = nil)
+    return object[key] if object.respond_to?(:key?) && object.key?(key)
+    return found unless object.is_a?(Enumerable)
+
+    object.find { |*a| found = deep_find(key, a.last) }
+    found
+  end
+end

data/lib/awis/models.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Awis
+  module Models
+    autoload :Base,             'awis/models/base'
+    autoload :BaseEntity,       'awis/models/base_entity'
+    autoload :UrlInfo,          'awis/models/url_info'
+    autoload :TrafficHistory,   'awis/models/traffic_history'
+    autoload :SitesLinkingIn,   'awis/models/sites_linking_in'
+    autoload :CategoryListings, 'awis/models/category_listings'
+    autoload :CategoryBrowse,   'awis/models/category_browse'
+  end
+end