Class: Gem::UriFormatter

Inherits:
Object show all
Defined in:
lib/rubygems/uri_formatter.rb

Overview

The UriFormatter handles URIs from user-input and escaping.

uf = Gem::UriFormatter.new 'example.com'

p uf.normalize #=> 'http://example.com'

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(uri) ⇒ UriFormatter

Creates a new URI formatter for uri.



19
20
21
22
23
# File 'lib/rubygems/uri_formatter.rb', line 19

def initialize(uri)
  require 'cgi'

  @uri = uri
end

Instance Attribute Details

#uriObject (readonly)

The URI to be formatted.



14
15
16
# File 'lib/rubygems/uri_formatter.rb', line 14

def uri
  @uri
end

Instance Method Details

#escapeObject

Escapes the #uri for use as a CGI parameter



28
29
30
31
# File 'lib/rubygems/uri_formatter.rb', line 28

def escape
  return unless @uri
  CGI.escape @uri
end

#normalizeObject

Normalize the URI by adding “http://” if it is missing.



36
37
38
# File 'lib/rubygems/uri_formatter.rb', line 36

def normalize
  (@uri =~ /^(https?|ftp|file):/i) ? @uri : "http://#{@uri}"
end

#unescapeObject

Unescapes the #uri which came from a CGI parameter



43
44
45
46
# File 'lib/rubygems/uri_formatter.rb', line 43

def unescape
  return unless @uri
  CGI.unescape @uri
end