Class: Gem::UriFormatter

Inherits:
Object
  • 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.


22
23
24
# File 'lib/rubygems/uri_formatter.rb', line 22

def initialize uri
  @uri = uri
end

Instance Attribute Details

#uriObject (readonly)

The URI to be formatted.


17
18
19
# File 'lib/rubygems/uri_formatter.rb', line 17

def uri
  @uri
end

Instance Method Details

#escapeObject

Escapes the #uri for use as a CGI parameter


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

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

#normalizeObject

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


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

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

#unescapeObject

Unescapes the #uri which came from a CGI parameter


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

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