Contents

module Contentful
  # This object represents a request that is to be made. It gets initialized by the client
  # with domain specific logic. The client later uses the Request's #url and #query methods
  # to execute the HTTP request.
  class Request
    attr_reader :client, :type, :query, :id

    def initialize(client, endpoint, query = {}, id = nil)
      @client = client
      @endpoint = endpoint
      @absolute = true if @endpoint.start_with?('http')

      @query = if query && !query.empty?
                 normalize_query(query)
      end

      if id
        @type = :single
        @id = URI.escape(id)
      else
        @type = :multi
        @id = nil
      end
    end

    # Returns the final URL, relative to a contentful space
    def url
      "#{@endpoint}#{ @type == :single ? "/#{id}" : '' }"
    end

    # Delegates the actual HTTP work to the client
    def get
      client.get(self)
    end

    # Returns true if endpoint is an absolute url
    def absolute?
      !! @absolute
    end

    # Returns a new Request object with the same data
    def copy
      Marshal.load(Marshal.dump(self))
    end

    private

    def normalize_query(query)
      Hash[
        query.map do |key, value|
          [
            key.to_sym,
            value.is_a?(::Array) ? value.join(',') : value
          ]
        end
      ]
    end
  end
end

Version data entries

6 entries across 6 versions & 1 rubygems

Version	Path
contentful-0.8.0	lib/contentful/request.rb
contentful-0.7.0	lib/contentful/request.rb
contentful-0.6.0	lib/contentful/request.rb
contentful-0.5.0	lib/contentful/request.rb
contentful-0.4.0	lib/contentful/request.rb
contentful-0.3.5	lib/contentful/request.rb