module Parliament
  module Request
    # API request object, allowing the user to build a request to an OpenSearch API and build a response.
    #
    # @since 0.1.0
    # attr [Hash] templates the different types and template urls set from the OpenSearch API description document.
    class OpenSearchRequest < Parliament::Request::BaseRequest
      attr_reader :templates, :description_url

      OPEN_SEARCH_PARAMETERS = {
        count:           10,
        start_index:     1,
        start_page:      1,
        language:        '*',
        output_encoding: 'UTF-8',
        input_encoding:  'UTF-8'
      }.freeze

      # Creates a new instance of Parliament::OpenSearch::Request.
      #
      # An interesting note for #initialize is that setting description_url on the class means you don't need to pass in a description_url.
      # You can pass one anyway to override the class parameter.  Similarly, headers can be set by either settings the headers on the class,
      # or passing headers in.
      #
      # @see Parliament::BaseRequest#initialize
      # @param [String] description_url the url for the OpenSearch API description file. (expected: http://example.com/description.xml - without the trailing slash).
      # @param [Hash] headers the headers being sent in the request.
      # @param [Parliament::OpenSearch::Builder] builder the builder required to create the response.
      def initialize(description_url: nil, headers: nil, builder: nil)
        @description_url = description_url ||= self.class.description_url

        raise Parliament::OpenSearch::DescriptionError.new(@description_url), 'No description URL passed to Parliament::OpenSearchRequest#new and, no Parliament::OpenSearchRequest#base_url value set. Without a description URL, we are unable to make any search requests.' if @description_url.nil? && self.class.templates.nil?

        @templates = Parliament::OpenSearch::DescriptionCache.fetch(@description_url)
        @open_search_parameters = self.class.open_search_parameters

        super(base_url: nil, headers: headers, builder: builder)
      end

      # Sets up the query url using the base_url and parameters, then make an HTTP GET request and process results.
      #
      # @see Parliament::BaseRequest#get
      # @params [Hash] search_params the search parameters to be passed to the OpenSearch API.  This is the search term and/or any of the keys from OPEN_SEARCH_PARAMETERS, depending on the parameters allowed in the API.
      # @params [String] type the type of data requested, eg. 'application/atom+xml'.
      # @params [Hash] params any extra parameters.
      def get(search_params, type: nil, params: nil)
        setup_query_url(search_params, type)

        super(params: params)
      end

      # @attr [String] templates the different types and template urls set from the OpenSearch API description document.
      # @attr [Hash] open_search_parameters the possible parameters to use in the query url.
      class << self
        attr_reader :description_url, :templates

        def description_url=(description_url)
          @description_url = description_url
          @templates = Parliament::OpenSearch::DescriptionCache.fetch(@description_url)
        end

        def open_search_parameters
          OPEN_SEARCH_PARAMETERS.dup
        end
      end

      private

      attr_reader :query_url

      def setup_query_url(search_params, type = nil)
        search_terms = search_params[:query]
        type ||= 'application/atom+xml'

        url_hash = @templates.select { |url| url[:type] == type }.first

        raise Parliament::OpenSearch::DescriptionError.new(type), "There is no url for the requested type '#{type}'." if url_hash.nil?

        query_url = url_hash[:template].dup

        query_url.gsub!('{searchTerms}', search_terms)

        @open_search_parameters.each do |key, value|
          camel_case_key = ActiveSupport::Inflector.camelize(key.to_s, false)
          if search_params.keys.include?(key)
            query_url.gsub!("{#{camel_case_key}?}", search_params[key].to_s)
          else
            query_url.gsub!("{#{camel_case_key}?}", value.to_s)
          end
        end

        @query_url = query_url
      end
    end
  end
end