Class: ActionDispatch::Journey::Router::Utils

Inherits:
Object
  • Object
show all
Defined in:
lib/action_dispatch/journey/router/utils.rb

Overview

:nodoc:

Defined Under Namespace

Classes: UriEncoder

Constant Summary collapse

ENCODER =
UriEncoder.new

Class Method Summary collapse

Class Method Details

.escape_fragment(fragment) ⇒ Object



91
92
93
# File 'lib/action_dispatch/journey/router/utils.rb', line 91

def self.escape_fragment(fragment)
  ENCODER.escape_fragment(fragment.to_s)
end

.escape_path(path) ⇒ Object



83
84
85
# File 'lib/action_dispatch/journey/router/utils.rb', line 83

def self.escape_path(path)
  ENCODER.escape_path(path.to_s)
end

.escape_segment(segment) ⇒ Object



87
88
89
# File 'lib/action_dispatch/journey/router/utils.rb', line 87

def self.escape_segment(segment)
  ENCODER.escape_segment(segment.to_s)
end

.normalize_path(path) ⇒ Object

Normalizes URI path.

Strips off trailing slash and ensures there is a leading slash. Also converts downcase URL encoded string to uppercase.

normalize_path("/foo")  # => "/foo"
normalize_path("/foo/") # => "/foo"
normalize_path("foo")   # => "/foo"
normalize_path("")      # => "/"
normalize_path("/%ab")  # => "/%AB"


19
20
21
22
23
24
25
26
27
28
29
30
31
# File 'lib/action_dispatch/journey/router/utils.rb', line 19

def self.normalize_path(path)
  path ||= ""
  encoding = path.encoding
  path = +"/#{path}"
  path.squeeze!("/")

  unless path == "/"
    path.delete_suffix!("/")
    path.gsub!(/(%[a-f0-9]{2})/) { $1.upcase }
  end

  path.force_encoding(encoding)
end

.unescape_uri(uri) ⇒ Object

Replaces any escaped sequences with their unescaped representations.

uri = "/topics?title=Ruby%20on%20Rails"
unescape_uri(uri)  #=> "/topics?title=Ruby on Rails"


99
100
101
# File 'lib/action_dispatch/journey/router/utils.rb', line 99

def self.unescape_uri(uri)
  ENCODER.unescape_uri(uri)
end