Module: Excon::Utils

Extended by:
Utils
Included in:
Connection, Socket, Utils
Defined in:
lib/excon/utils.rb

Instance Method Summary collapse

Instance Method Details

#connection_uri(datum = @data) ⇒ Object 



13
14
15
16
17
18
19
20
21
22
 
# File 'lib/excon/utils.rb', line 13

def connection_uri(datum = @data)
  unless datum
    raise ArgumentError, '`datum` must be given unless called on a Connection'
  end
  if datum[:scheme] == UNIX
    '' << datum[:scheme] << '://' << datum[:socket]
  else
    '' << datum[:scheme] << '://' << datum[:host] << port_string(datum)
  end
end

#port_string(datum) ⇒ Object 



28
29
30
31
32
33
34
 
# File 'lib/excon/utils.rb', line 28

def port_string(datum)
  if datum[:port].nil? || (datum[:omit_default_port] && ((datum[:scheme].casecmp('http') == 0 && datum[:port] == 80) || (datum[:scheme].casecmp('https') == 0 && datum[:port] == 443)))
    ''
  else
    ':' << datum[:port].to_s
  end
end

#query_string(datum) ⇒ Object 



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/excon/utils.rb', line 36

def query_string(datum)
  str = ''
  case datum[:query]
  when String
    str << '?' << datum[:query]
  when Hash
    str << '?'
    datum[:query].sort_by {|k,_| k.to_s }.each do |key, values|
      if values.nil?
        str << key.to_s << '&'
      else
        [values].flatten.each do |value|
          str << key.to_s << '=' << CGI.escape(value.to_s) << '&'
        end
      end
    end
    str.chop! # remove trailing '&'
  end
  str
end

#request_uri(datum) ⇒ Object 



24
25
26
 
# File 'lib/excon/utils.rb', line 24

def request_uri(datum)
  connection_uri(datum) << datum[:path] << query_string(datum)
end

#split_header_value(str) ⇒ Object

Splits a header value str according to HTTP specification.



58
59
60
61
 
# File 'lib/excon/utils.rb', line 58

def split_header_value(str)
  return [] if str.nil?
  WEBrick::HTTPUtils.split_header_value(str.strip)
end

#unescape_form(str) ⇒ Object

Unescape form encoded values in str



69
70
71
 
# File 'lib/excon/utils.rb', line 69

def unescape_form(str)
  WEBrick::HTTPUtils.unescape_form(str)
end

#unescape_uri(str) ⇒ Object

Unescapes HTTP reserved and unwise characters in str



64
65
66
 
# File 'lib/excon/utils.rb', line 64

def unescape_uri(str)
  WEBrick::HTTPUtils.unescape(str)
end

#valid_connection_keys(params = {}) ⇒ Object 



5
6
7
 
# File 'lib/excon/utils.rb', line 5

def valid_connection_keys(params = {})
  Excon::VALID_CONNECTION_KEYS
end

#valid_request_keys(params = {}) ⇒ Object 



9
10
11
 
# File 'lib/excon/utils.rb', line 9

def valid_request_keys(params = {})
  Excon::VALID_REQUEST_KEYS
end