module Excon::Utils
Constants
- CONTROL
- DELIMS
- ESCAPED
- NONASCII
- UNESCAPED
- UNWISE
Public Instance Methods
binary_encode(string)
click to toggle source
# File lib/excon/utils.rb, line 12 def binary_encode(string) if FORCE_ENC && string.encoding != Encoding::ASCII_8BIT if string.frozen? string.dup.force_encoding('BINARY') else string.force_encoding('BINARY') end else string end end
connection_uri(datum = @data)
click to toggle source
# File lib/excon/utils.rb, line 24 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
escape_uri(str)
click to toggle source
Escapes HTTP reserved and unwise characters in str
# File lib/excon/utils.rb, line 103 def escape_uri(str) str = str.dup str = binary_encode(str) str.gsub(UNESCAPED) { "%%%02X" % $1[0].ord } end
port_string(datum)
click to toggle source
# File lib/excon/utils.rb, line 63 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)
click to toggle source
# File lib/excon/utils.rb, line 71 def query_string(datum) str = String.new case datum[:query] when String str << '?' << datum[:query] when Hash str << '?' datum[:query].sort_by {|k,_| k.to_s }.each do |key, values| key = CGI.escape(key.to_s) if values.nil? str << key << '&' else [values].flatten.each do |value| str << key << '=' << CGI.escape(value.to_s) << '&' end end end str.chop! # remove trailing '&' end str end
redact(datum)
click to toggle source
Redact sensitive info from provided data
# File lib/excon/utils.rb, line 36 def redact(datum) datum = datum.dup if datum.has_key?(:headers) if datum[:headers].has_key?('Authorization') || datum[:headers].has_key?('Proxy-Authorization') datum[:headers] = datum[:headers].dup end if datum[:headers].has_key?('Authorization') datum[:headers]['Authorization'] = REDACTED end if datum[:headers].has_key?('Proxy-Authorization') datum[:headers]['Proxy-Authorization'] = REDACTED end end if datum.has_key?(:password) datum[:password] = REDACTED end if datum.has_key?(:proxy) && datum[:proxy].has_key?(:password) datum[:proxy] = datum[:proxy].dup datum[:proxy][:password] = REDACTED end datum end
request_uri(datum)
click to toggle source
# File lib/excon/utils.rb, line 59 def request_uri(datum) connection_uri(datum) + datum[:path] + query_string(datum) end
split_header_value(str)
click to toggle source
Splits a header value str
according to HTTP specification.
# File lib/excon/utils.rb, line 94 def split_header_value(str) return [] if str.nil? str = str.dup.strip str = binary_encode(str) str.scan(%r'\G((?:"(?:\\.|[^"])+?"|[^",]+)+) (?:,\s*|\Z)'xn).flatten end
unescape_form(str)
click to toggle source
Unescape form encoded values in str
# File lib/excon/utils.rb, line 117 def unescape_form(str) str = str.dup str = binary_encode(str) str.gsub!(/\+/, ' ') str.gsub(ESCAPED) { $1.hex.chr } end
unescape_uri(str)
click to toggle source
Unescapes HTTP reserved and unwise characters in str
# File lib/excon/utils.rb, line 110 def unescape_uri(str) str = str.dup str = binary_encode(str) str.gsub(ESCAPED) { $1.hex.chr } end