Contents

require "uri"

module HTTPI
  class Request

    # Request accessor methods.
    ACCESSORS = [:url, :proxy, :headers, :body, :open_timeout, :read_timeout]

    # Request authentication methods.
    AUTHENTICATION = [:basic_auth]

    # Accepts a Hash of +options+ which may contain any number of ACCESSORS and/or
    # AUTHENTICATION credentials to set.
    def initialize(options = {})
      assign_accessors options
      assign_authentication options
    end

    # Sets the +url+ to access. Raises an +ArgumentError+ unless the +url+ is valid.
    def url=(url)
      @url = normalize_url! url
    end

    # Returns the +url+ to access.
    attr_reader :url

    # Sets the +proxy+ to use. Raises an +ArgumentError+ unless the +proxy+ is valid.
    def proxy=(proxy)
      @proxy = normalize_url! proxy
    end

    # Returns the +proxy+ to use.
    attr_reader :proxy

    # Returns a Hash of HTTP headers. Defaults to return an empty Hash.
    def headers
      @headers ||= {}
    end

    # Sets the Hash of HTTP headers.
    attr_writer :headers

    attr_accessor :body, :open_timeout, :read_timeout

    # Sets the HTTP basic auth credentials. Accepts an Array or two arguments for the
    # +username+ and +password+. Resets the credentials when +nil+ is passed and returns
    # an Array of credentials when no +args+ where given.
    def basic_auth(*args)
      @basic_auth = extract_credentials @basic_auth, args.flatten
    end

 private

    def assign_accessors(options)
      ACCESSORS.each { |a| send("#{a}=", options[a]) if options[a] }
    end
 
    def assign_authentication(options)
      AUTHENTICATION.each { |c| send(c, options[c]) if options[c] }
    end
 
    def normalize_url!(url)
      raise ArgumentError, "Invalid URL: #{url}" unless url.to_s =~ /^http/
      url.kind_of?(URI) ? url : URI(url)
    end

    def extract_credentials(credentials, args)
      return unless args.empty? || args.first
      args[1] ? args[0, 2] : credentials
    end

  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
httpi-0.2.0	lib/httpi/request.rb