RubyGems - addressable - Versions diffs - 1.0.2 → 1.0.3 - Mend

addressable 1.0.2 → 1.0.3

Files changed (31) hide show

data/CHANGELOG +3 -0
data/coverage/-Library-Ruby-Gems-1_8-gems-rcov-0_8_1_2_0-lib-rcov_rb.html +1598 -0
data/coverage/-Library-Ruby-Gems-1_8-gems-rspec-1_1_3-bin-spec.html +614 -0
data/coverage/-Library-Ruby-Gems-1_8-gems-rspec-1_1_3-lib-spec_rb.html +640 -0
data/coverage/-Library-Ruby-Gems-1_8-gems-rspec-1_1_3-plugins-mock_frameworks-rspec_rb.html +628 -0
data/coverage/index.html +113 -5
data/coverage/lib-addressable-uri_rb.html +176 -170
data/coverage/lib-addressable-version_rb.html +3 -3
data/lib/addressable/uri.rb +7 -1
data/lib/addressable/version.rb +2 -2
data/spec/addressable/uri_spec.rb +12 -0
metadata +8 -29
data/doc/classes/Addressable.html +0 -115
data/doc/classes/Addressable/URI.html +0 -2509
data/doc/classes/Addressable/URI/CharacterClasses.html +0 -173
data/doc/classes/Addressable/URI/IDNA.html +0 -193
data/doc/classes/Addressable/URI/InvalidOptionError.html +0 -117
data/doc/classes/Addressable/URI/InvalidTemplateValue.html +0 -117
data/doc/classes/Addressable/URI/InvalidURIError.html +0 -117
data/doc/created.rid +0 -1
data/doc/files/CHANGELOG.html +0 -140
data/doc/files/LICENSE.html +0 -130
data/doc/files/README.html +0 -133
data/doc/files/lib/addressable/uri_rb.html +0 -110
data/doc/files/lib/addressable/version_rb.html +0 -101
data/doc/fr_class_index.html +0 -33
data/doc/fr_file_index.html +0 -31
data/doc/fr_method_index.html +0 -85
data/doc/index.html +0 -24
data/doc/rdoc-style.css +0 -208
data/specdoc/index.html +0 -1486

data/coverage/lib-addressable-version_rb.html CHANGED

@@ -553,7 +553,7 @@ span.run100 {
 </style>
     </head>
   <body><h3>C0 code coverage information</h3>
-    <p>Generated on Thu Dec 13 13:10:50 -0500 2007 with <a href='http://eigenclass.org/hiki/rcov'>rcov 0.8.1.2</a>
+    <p>Generated on Sat May 03 13:27:45 -0400 2008 with <a href='http://eigenclass.org/hiki/rcov'>rcov 0.8.1.2</a>
       </p>
     <hr/>
     <pre><span class='marked0'>Code reported as executed by Ruby looks like this...
@@ -599,7 +599,7 @@ span.run100 {
     </tbody>
   </table>
 <pre><span class="inferred1"><a name="line1"></a> 1 #--
-</span><span class="inferred0"><a name="line2"></a> 2 # Addressable, Copyright (c) 2006-2007 Bob Aman
+</span><span class="inferred0"><a name="line2"></a> 2 # Addressable, Copyright (c) 2006-2008 Bob Aman
 </span><span class="inferred1"><a name="line3"></a> 3 #
 </span><span class="inferred0"><a name="line4"></a> 4 # Permission is hereby granted, free of charge, to any person obtaining
 </span><span class="inferred1"><a name="line5"></a> 5 # a copy of this software and associated documentation files (the
@@ -625,7 +625,7 @@ span.run100 {
 </span><span class="marked1"><a name="line25"></a>25   module ADDRESSABLE_VERSION #:nodoc:
 </span><span class="marked0"><a name="line26"></a>26     MAJOR = 1
 </span><span class="marked1"><a name="line27"></a>27     MINOR = 0
-</span><span class="marked0"><a name="line28"></a>28     TINY  = 2
+</span><span class="marked0"><a name="line28"></a>28     TINY  = 3
 </span><span class="inferred1"><a name="line29"></a>29
 </span><span class="marked0"><a name="line30"></a>30     STRING = [MAJOR, MINOR, TINY].join('.')
 </span><span class="inferred1"><a name="line31"></a>31   end

data/lib/addressable/uri.rb CHANGED

@@ -93,7 +93,7 @@ module Addressable
         host = authority.gsub(/^([^\[\]]*)@/, "").gsub(/:([^:@\[\]]*?)$/, "")
         port = authority.scan(/:([^:@\[\]]*?)$/).flatten[0]
       end
-      if port == nil || port == ""
+      if port == ""
         port = nil
       end
@@ -1070,6 +1070,12 @@ module Addressable
       return false unless uri.kind_of?(self.class)
       return self.to_s == uri.to_s
     end
+    # Returns a hash value that will make a URI equivalent to its normalized
+    # form.
+    def hash
+      return (self.normalize.to_s.hash * -1)
+    end
     # Clones the URI object.
     def dup

data/lib/addressable/version.rb CHANGED

@@ -1,5 +1,5 @@
 #--
-# Addressable, Copyright (c) 2006-2007 Bob Aman
+# Addressable, Copyright (c) 2006-2008 Bob Aman
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
@@ -25,7 +25,7 @@ module Addressable
   module ADDRESSABLE_VERSION #:nodoc:
     MAJOR = 1
     MINOR = 0
-    TINY  = 2
+    TINY  = 3
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/spec/addressable/uri_spec.rb CHANGED

@@ -610,6 +610,18 @@ describe Addressable::URI, " when parsed from " +
   it "should be identical to its duplicate" do
     @uri.should == @uri.dup
   end
+  it "should have the same hash as its duplicate" do
+    @uri.hash.should == @uri.dup.hash
+  end
+  it "should have a different hash from its equivalent String value" do
+    @uri.hash.should_not == @uri.to_s.hash
+  end
+  it "should have the same hash as an equivalent URI" do
+    @uri.hash.should == Addressable::URI.parse("http://example.com:80/").hash
+  end
 end
 describe Addressable::URI, " when parsed from " +

metadata CHANGED

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: addressable
 version: !ruby/object:Gem::Version
-  version: 1.0.2
-platform: ""
+  version: 1.0.3
+platform: ruby
 authors:
 - Bob Aman
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2007-12-13 00:00:00 -05:00
+date: 2008-05-03 00:00:00 -04:00
 default_executable:
 dependencies:
 - !ruby/object:Gem::Dependency
@@ -46,31 +46,10 @@ files:
 - spec/addressable/uri_spec.rb
 - spec/data
 - spec/data/rfc3986.txt
-- doc/classes
-- doc/classes/Addressable
-- doc/classes/Addressable/URI
-- doc/classes/Addressable/URI/CharacterClasses.html
-- doc/classes/Addressable/URI/IDNA.html
-- doc/classes/Addressable/URI/InvalidOptionError.html
-- doc/classes/Addressable/URI/InvalidTemplateValue.html
-- doc/classes/Addressable/URI/InvalidURIError.html
-- doc/classes/Addressable/URI.html
-- doc/classes/Addressable.html
-- doc/created.rid
-- doc/files
-- doc/files/CHANGELOG.html
-- doc/files/lib
-- doc/files/lib/addressable
-- doc/files/lib/addressable/uri_rb.html
-- doc/files/lib/addressable/version_rb.html
-- doc/files/LICENSE.html
-- doc/files/README.html
-- doc/fr_class_index.html
-- doc/fr_file_index.html
-- doc/fr_method_index.html
-- doc/index.html
-- doc/rdoc-style.css
-- specdoc/index.html
+- coverage/-Library-Ruby-Gems-1_8-gems-rcov-0_8_1_2_0-lib-rcov_rb.html
+- coverage/-Library-Ruby-Gems-1_8-gems-rspec-1_1_3-bin-spec.html
+- coverage/-Library-Ruby-Gems-1_8-gems-rspec-1_1_3-lib-spec_rb.html
+- coverage/-Library-Ruby-Gems-1_8-gems-rspec-1_1_3-plugins-mock_frameworks-rspec_rb.html
 - coverage/index.html
 - coverage/lib-addressable-uri_rb.html
 - coverage/lib-addressable-version_rb.html
@@ -101,7 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubyforge_project: addressable
-rubygems_version: 0.9.5
+rubygems_version: 1.0.1
 signing_key:
 specification_version: 2
 summary: URI Implementation

data/doc/classes/Addressable.html DELETED

@@ -1,115 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Module: Addressable</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Module</strong></td>
-          <td class="class-name-in-header">Addressable</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../files/lib/addressable/uri_rb.html">
-                lib/addressable/uri.rb
-                </a>
-        <br />
-                <a href="../files/lib/addressable/version_rb.html">
-                lib/addressable/version.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-   </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <div id="class-list">
-      <h3 class="section-bar">Classes and Modules</h3>
-      Class <a href="Addressable/URI.html" class="link">Addressable::URI</a><br />
-    </div>
-    <!-- if method_list -->
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>

data/doc/classes/Addressable/URI.html DELETED

@@ -1,2509 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Class: Addressable::URI</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Class</strong></td>
-          <td class="class-name-in-header">Addressable::URI</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../files/lib/addressable/uri_rb.html">
-                lib/addressable/uri.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>Parent:</strong></td>
-            <td>
-                Object
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <p>
-This is an implementation of a <a href="URI.html">URI</a> parser based on
-RFC 3986, 3987.
-</p>
-    </div>
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000041">+</a>&nbsp;&nbsp;
-      <a href="#M000052">==</a>&nbsp;&nbsp;
-      <a href="#M000051">===</a>&nbsp;&nbsp;
-      <a href="#M000040">absolute?</a>&nbsp;&nbsp;
-      <a href="#M000023">authority</a>&nbsp;&nbsp;
-      <a href="#M000024">authority=</a>&nbsp;&nbsp;
-      <a href="#M000032">basename</a>&nbsp;&nbsp;
-      <a href="#M000003">convert_path</a>&nbsp;&nbsp;
-      <a href="#M000050">display_uri</a>&nbsp;&nbsp;
-      <a href="#M000054">dup</a>&nbsp;&nbsp;
-      <a href="#M000009">encode</a>&nbsp;&nbsp;
-      <a href="#M000007">encode_segment</a>&nbsp;&nbsp;
-      <a href="#M000053">eql?</a>&nbsp;&nbsp;
-      <a href="#M000004">expand_template</a>&nbsp;&nbsp;
-      <a href="#M000033">extname</a>&nbsp;&nbsp;
-      <a href="#M000011">extract</a>&nbsp;&nbsp;
-      <a href="#M000005">extract_mapping</a>&nbsp;&nbsp;
-      <a href="#M000036">fragment</a>&nbsp;&nbsp;
-      <a href="#M000037">fragment=</a>&nbsp;&nbsp;
-      <a href="#M000002">heuristic_parse</a>&nbsp;&nbsp;
-      <a href="#M000021">host</a>&nbsp;&nbsp;
-      <a href="#M000022">host=</a>&nbsp;&nbsp;
-      <a href="#M000057">inspect</a>&nbsp;&nbsp;
-      <a href="#M000038">ip_based?</a>&nbsp;&nbsp;
-      <a href="#M000025">ip_based_schemes</a>&nbsp;&nbsp;
-      <a href="#M000043">join</a>&nbsp;&nbsp;
-      <a href="#M000006">join</a>&nbsp;&nbsp;
-      <a href="#M000045">join!</a>&nbsp;&nbsp;
-      <a href="#M000042">merge</a>&nbsp;&nbsp;
-      <a href="#M000044">merge!</a>&nbsp;&nbsp;
-      <a href="#M000012">new</a>&nbsp;&nbsp;
-      <a href="#M000048">normalize</a>&nbsp;&nbsp;
-      <a href="#M000049">normalize!</a>&nbsp;&nbsp;
-      <a href="#M000010">normalized_encode</a>&nbsp;&nbsp;
-      <a href="#M000001">parse</a>&nbsp;&nbsp;
-      <a href="#M000017">password</a>&nbsp;&nbsp;
-      <a href="#M000018">password=</a>&nbsp;&nbsp;
-      <a href="#M000030">path</a>&nbsp;&nbsp;
-      <a href="#M000031">path=</a>&nbsp;&nbsp;
-      <a href="#M000027">port</a>&nbsp;&nbsp;
-      <a href="#M000028">port=</a>&nbsp;&nbsp;
-      <a href="#M000034">query</a>&nbsp;&nbsp;
-      <a href="#M000035">query=</a>&nbsp;&nbsp;
-      <a href="#M000039">relative?</a>&nbsp;&nbsp;
-      <a href="#M000046">route_from</a>&nbsp;&nbsp;
-      <a href="#M000047">route_to</a>&nbsp;&nbsp;
-      <a href="#M000013">scheme</a>&nbsp;&nbsp;
-      <a href="#M000014">scheme=</a>&nbsp;&nbsp;
-      <a href="#M000026">scheme_mapping</a>&nbsp;&nbsp;
-      <a href="#M000029">specified_port</a>&nbsp;&nbsp;
-      <a href="#M000056">to_hash</a>&nbsp;&nbsp;
-      <a href="#M000055">to_s</a>&nbsp;&nbsp;
-      <a href="#M000008">unencode_segment</a>&nbsp;&nbsp;
-      <a href="#M000015">user</a>&nbsp;&nbsp;
-      <a href="#M000016">user=</a>&nbsp;&nbsp;
-      <a href="#M000019">userinfo</a>&nbsp;&nbsp;
-      <a href="#M000020">userinfo=</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <div id="class-list">
-      <h3 class="section-bar">Classes and Modules</h3>
-      Module <a href="URI/CharacterClasses.html" class="link">Addressable::URI::CharacterClasses</a><br />
-Module <a href="URI/IDNA.html" class="link">Addressable::URI::IDNA</a><br />
-Class <a href="URI/InvalidOptionError.html" class="link">Addressable::URI::InvalidOptionError</a><br />
-Class <a href="URI/InvalidTemplateValue.html" class="link">Addressable::URI::InvalidTemplateValue</a><br />
-Class <a href="URI/InvalidURIError.html" class="link">Addressable::URI::InvalidURIError</a><br />
-    </div>
-    <div id="aliases-list">
-      <h3 class="section-bar">External Aliases</h3>
-      <div class="name-list">
-                        <table summary="aliases">
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">encode</td>
-          <td>-&gt;</td>
-          <td class="context-item-value">escape</td>
-        </tr>
-                        </table>
-      </div>
-    </div>
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000003" class="method-detail">
-        <a name="M000003"></a>
-        <div class="method-heading">
-          <a href="#M000003" class="method-signature">
-          <span class="method-name">convert_path</span><span class="method-args">(path)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Converts a <a href="URI.html#M000030">path</a> to a file protocol <a
-href="URI.html">URI</a>. If the <a href="URI.html#M000030">path</a>
-supplied is relative, it will be returned as a relative <a
-href="URI.html">URI</a>. If the <a href="URI.html#M000030">path</a>
-supplied is actually a <a href="URI.html">URI</a>, it will return the
-parsed <a href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000003-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000003-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 144</span>
-144:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">convert_path</span>(<span class="ruby-identifier">path</span>)
-145:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">path</span>.<span class="ruby-identifier">nil?</span>
-146:
-147:       <span class="ruby-identifier">converted_uri</span> = <span class="ruby-identifier">path</span>.<span class="ruby-identifier">strip</span>
-148:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">converted_uri</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">converted_uri</span>[<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;/&quot;</span>
-149:         <span class="ruby-identifier">converted_uri</span> = <span class="ruby-value str">&quot;file://&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">converted_uri</span>
-150:       <span class="ruby-keyword kw">end</span>
-151:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">converted_uri</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span> <span class="ruby-operator">&amp;&amp;</span>
-152:           <span class="ruby-identifier">converted_uri</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/^[a-zA-Z]:[\\\/]/</span>).<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
-153:         <span class="ruby-identifier">converted_uri</span> = <span class="ruby-value str">&quot;file:///&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">converted_uri</span>
-154:       <span class="ruby-keyword kw">end</span>
-155:       <span class="ruby-identifier">converted_uri</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/^file:\/*/i</span>, <span class="ruby-value str">&quot;file:///&quot;</span>)
-156:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">converted_uri</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^file:/i</span>
-157:         <span class="ruby-comment cmt"># Adjust windows-style uris</span>
-158:         <span class="ruby-identifier">converted_uri</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/^file:\/\/\/([a-zA-Z])\|/i</span>, <span class="ruby-value str">'file:///\1:'</span>)
-159:         <span class="ruby-identifier">converted_uri</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/\\/</span>, <span class="ruby-value str">'/'</span>)
-160:         <span class="ruby-identifier">converted_uri</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">converted_uri</span>).<span class="ruby-identifier">normalize</span>
-161:         <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">converted_uri</span>.<span class="ruby-identifier">path</span>) <span class="ruby-operator">&amp;&amp;</span>
-162:             <span class="ruby-constant">File</span>.<span class="ruby-identifier">stat</span>(<span class="ruby-identifier">converted_uri</span>.<span class="ruby-identifier">path</span>).<span class="ruby-identifier">directory?</span>
-163:           <span class="ruby-identifier">converted_uri</span>.<span class="ruby-identifier">path</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/\/$/</span>, <span class="ruby-value str">&quot;&quot;</span>)
-164:           <span class="ruby-identifier">converted_uri</span>.<span class="ruby-identifier">path</span> = <span class="ruby-identifier">converted_uri</span>.<span class="ruby-identifier">path</span> <span class="ruby-operator">+</span> <span class="ruby-value str">'/'</span>
-165:         <span class="ruby-keyword kw">end</span>
-166:       <span class="ruby-keyword kw">else</span>
-167:         <span class="ruby-identifier">converted_uri</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">converted_uri</span>)
-168:       <span class="ruby-keyword kw">end</span>
-169:
-170:       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">converted_uri</span>
-171:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000009" class="method-detail">
-        <a name="M000009"></a>
-        <div class="method-heading">
-          <a href="#M000009" class="method-signature">
-          <span class="method-name">encode</span><span class="method-args">(uri)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Percent encodes any special characters in the <a href="URI.html">URI</a>.
-This method does not take IRIs or IDNs into account.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000009-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000009-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 373</span>
-373:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode</span>(<span class="ruby-identifier">uri</span>)
-374:       <span class="ruby-identifier">uri_object</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-keyword kw">self</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">uri</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">to_s</span>)
-375:       <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>.<span class="ruby-identifier">new</span>(
-376:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">scheme</span>,
-377:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">SCHEME</span>),
-378:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">user</span>,
-379:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">AUTHORITY</span>),
-380:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">password</span>,
-381:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">AUTHORITY</span>),
-382:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">host</span>,
-383:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">AUTHORITY</span>),
-384:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">specified_port</span>,
-385:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">AUTHORITY</span>),
-386:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">path</span>,
-387:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">PATH</span>),
-388:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">query</span>,
-389:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">QUERY</span>),
-390:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">fragment</span>,
-391:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">FRAGMENT</span>)
-392:       ).<span class="ruby-identifier">to_s</span>
-393:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000007" class="method-detail">
-        <a name="M000007"></a>
-        <div class="method-heading">
-          <a href="#M000007" class="method-signature">
-          <span class="method-name">encode_segment</span><span class="method-args">(segment, character_class= Addressable::URI::CharacterClasses::RESERVED + Addressable::URI::CharacterClasses::UNRESERVED)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Percent encodes a <a href="URI.html">URI</a> segment. Returns a string.
-Takes an optional character class parameter, which should be specified as a
-string containing a regular expression character class (not including the
-surrounding square brackets). The character class parameter defaults to the
-reserved plus unreserved character classes specified in RFC 3986. Usage of
-the constants within the <a
-href="URI/CharacterClasses.html">CharacterClasses</a> module is highly
-recommended when using this method.
-</p>
-<p>
-An example:
-</p>
-<pre>
- Addressable::URI.escape_segment(&quot;simple-example&quot;, &quot;b-zB-Z0-9&quot;)
- =&gt; &quot;simple%2Dex%61mple&quot;
-</pre>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000007-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000007-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 351</span>
-351:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">segment</span>, <span class="ruby-identifier">character_class</span>=
-352:         <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">RESERVED</span> <span class="ruby-operator">+</span>
-353:         <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">UNRESERVED</span>)
-354:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">segment</span>.<span class="ruby-identifier">nil?</span>
-355:       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">segment</span>.<span class="ruby-identifier">gsub</span>(
-356:         <span class="ruby-node">/[^#{character_class}]/</span>
-357:       ) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">sequence</span><span class="ruby-operator">|</span>
-358:         (<span class="ruby-value str">&quot;%&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">sequence</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'C'</span>)[<span class="ruby-value">0</span>].<span class="ruby-identifier">to_s</span>(<span class="ruby-value">16</span>).<span class="ruby-identifier">upcase</span>)
-359:       <span class="ruby-keyword kw">end</span>
-360:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000004" class="method-detail">
-        <a name="M000004"></a>
-        <div class="method-heading">
-          <a href="#M000004" class="method-signature">
-          <span class="method-name">expand_template</span><span class="method-args">(pattern, mapping, processor=nil)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Expands a <a href="URI.html">URI</a> template into a full <a
-href="URI.html">URI</a>.
-</p>
-<p>
-An optional processor object may be supplied. The object should respond to
-either the :validate or :transform messages or both. Both the :validate and
-:transform methods should take two parameters: :name and :value. The
-:validate method should return true or false; true if the value of the
-variable is valid, false otherwise. The :transform method should return the
-transformed variable value as a string.
-</p>
-<p>
-An example:
-</p>
-<pre>
- class ExampleProcessor
-   def self.validate(name, value)
-     return !!(value =~ /^[\w ]+$/) if name == &quot;query&quot;
-     return true
-   end
-   def self.transform(name, value)
-     return value.gsub(/ /, &quot;+&quot;) if name == &quot;query&quot;
-     return value
-   end
- end
- Addressable::URI.expand_template(
-   &quot;http://example.com/search/{query}/&quot;,
-   {&quot;query&quot; =&gt; &quot;an example search query&quot;},
-   ExampleProcessor).to_s
- =&gt; &quot;http://example.com/search/an+example+search+query/&quot;
-</pre>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000004-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000004-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 202</span>
-202:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">expand_template</span>(<span class="ruby-identifier">pattern</span>, <span class="ruby-identifier">mapping</span>, <span class="ruby-identifier">processor</span>=<span class="ruby-keyword kw">nil</span>)
-203:       <span class="ruby-identifier">result</span> = <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">dup</span>
-204:       <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">name</span>, <span class="ruby-identifier">value</span> <span class="ruby-keyword kw">in</span> <span class="ruby-identifier">mapping</span>
-205:         <span class="ruby-identifier">transformed_value</span> = <span class="ruby-identifier">value</span>
-206:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">processor</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-207:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">processor</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:validate</span>)
-208:             <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">processor</span>.<span class="ruby-identifier">validate</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">value</span>)
-209:               <span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidTemplateValue</span>,
-210:                 <span class="ruby-node">&quot;(#{name}, #{value}) is an invalid template value.&quot;</span>
-211:             <span class="ruby-keyword kw">end</span>
-212:           <span class="ruby-keyword kw">end</span>
-213:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">processor</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:transform</span>)
-214:             <span class="ruby-identifier">transformed_value</span> = <span class="ruby-identifier">processor</span>.<span class="ruby-identifier">transform</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">value</span>)
-215:           <span class="ruby-keyword kw">end</span>
-216:         <span class="ruby-keyword kw">end</span>
-217:
-218:         <span class="ruby-comment cmt"># Handle percent escaping</span>
-219:         <span class="ruby-identifier">transformed_value</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">transformed_value</span>,
-220:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">RESERVED</span> <span class="ruby-operator">+</span>
-221:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">UNRESERVED</span>)
-222:
-223:         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-node">/\{#{Regexp.escape(name)}\}/</span>, <span class="ruby-identifier">transformed_value</span>)
-224:       <span class="ruby-keyword kw">end</span>
-225:       <span class="ruby-identifier">result</span>.<span class="ruby-identifier">gsub!</span>(
-226:         <span class="ruby-node">/\{[#{Addressable::URI::CharacterClasses::UNRESERVED}]+\}/</span>, <span class="ruby-value str">&quot;&quot;</span>)
-227:       <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">result</span>)
-228:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000011" class="method-detail">
-        <a name="M000011"></a>
-        <div class="method-heading">
-          <a href="#M000011" class="method-signature">
-          <span class="method-name">extract</span><span class="method-args">(text, options={})</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Extracts uris from an arbitrary body of text.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000011-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000011-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 439</span>
-439:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">extract</span>(<span class="ruby-identifier">text</span>, <span class="ruby-identifier">options</span>={})
-440:       <span class="ruby-identifier">defaults</span> = {<span class="ruby-identifier">:base</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">:parse</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">false</span>}
-441:       <span class="ruby-identifier">options</span> = <span class="ruby-identifier">defaults</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">options</span>)
-442:       <span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidOptionError</span> <span class="ruby-keyword kw">unless</span> (<span class="ruby-identifier">options</span>.<span class="ruby-identifier">keys</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">defaults</span>.<span class="ruby-identifier">keys</span>).<span class="ruby-identifier">empty?</span>
-443:       <span class="ruby-comment cmt"># This regular expression needs to be less forgiving or else it would</span>
-444:       <span class="ruby-comment cmt"># match virtually all text.  Which isn't exactly what we're going for.</span>
-445:       <span class="ruby-identifier">extract_regex</span> = <span class="ruby-regexp re">/((([a-z\+]+):)[^ \n\&lt;\&gt;\&quot;\\]+[\w\/])/</span>
-446:       <span class="ruby-identifier">extracted_uris</span> =
-447:         <span class="ruby-identifier">text</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-identifier">extract_regex</span>).<span class="ruby-identifier">collect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">match</span><span class="ruby-operator">|</span> <span class="ruby-identifier">match</span>[<span class="ruby-value">0</span>] }
-448:       <span class="ruby-identifier">sgml_extract_regex</span> = <span class="ruby-regexp re">/&lt;[^&gt;]+href=\&quot;([^\&quot;]+?)\&quot;[^&gt;]*&gt;/</span>
-449:       <span class="ruby-identifier">sgml_extracted_uris</span> =
-450:         <span class="ruby-identifier">text</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-identifier">sgml_extract_regex</span>).<span class="ruby-identifier">collect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">match</span><span class="ruby-operator">|</span> <span class="ruby-identifier">match</span>[<span class="ruby-value">0</span>] }
-451:       <span class="ruby-identifier">extracted_uris</span>.<span class="ruby-identifier">concat</span>(<span class="ruby-identifier">sgml_extracted_uris</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">extracted_uris</span>)
-452:       <span class="ruby-identifier">textile_extract_regex</span> = <span class="ruby-regexp re">/\&quot;.+?\&quot;:([^ ]+\/[^ ]+)[ \,\.\;\:\?\!\&lt;\&gt;\&quot;]/i</span>
-453:       <span class="ruby-identifier">textile_extracted_uris</span> =
-454:         <span class="ruby-identifier">text</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-identifier">textile_extract_regex</span>).<span class="ruby-identifier">collect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">match</span><span class="ruby-operator">|</span> <span class="ruby-identifier">match</span>[<span class="ruby-value">0</span>] }
-455:       <span class="ruby-identifier">extracted_uris</span>.<span class="ruby-identifier">concat</span>(<span class="ruby-identifier">textile_extracted_uris</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">extracted_uris</span>)
-456:       <span class="ruby-identifier">parsed_uris</span> = []
-457:       <span class="ruby-identifier">base_uri</span> = <span class="ruby-keyword kw">nil</span>
-458:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:base</span>] <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-459:         <span class="ruby-identifier">base_uri</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:base</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:base</span>].<span class="ruby-identifier">kind_of?</span>(<span class="ruby-keyword kw">self</span>)
-460:         <span class="ruby-identifier">base_uri</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:base</span>].<span class="ruby-identifier">to_s</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">base_uri</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
-461:       <span class="ruby-keyword kw">end</span>
-462:       <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">uri_string</span> <span class="ruby-keyword kw">in</span> <span class="ruby-identifier">extracted_uris</span>
-463:         <span class="ruby-keyword kw">begin</span>
-464:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">base_uri</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
-465:             <span class="ruby-identifier">parsed_uris</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">uri_string</span>)
-466:           <span class="ruby-keyword kw">else</span>
-467:             <span class="ruby-identifier">parsed_uris</span> <span class="ruby-operator">&lt;&lt;</span> (<span class="ruby-identifier">base_uri</span> <span class="ruby-operator">+</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">uri_string</span>))
-468:           <span class="ruby-keyword kw">end</span>
-469:         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span>
-470:           <span class="ruby-keyword kw">nil</span>
-471:         <span class="ruby-keyword kw">end</span>
-472:       <span class="ruby-keyword kw">end</span>
-473:       <span class="ruby-identifier">parsed_uris</span>.<span class="ruby-identifier">reject!</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">uri</span><span class="ruby-operator">|</span>
-474:         (<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/T\d+/</span> <span class="ruby-operator">||</span>
-475:          <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;xmlns&quot;</span> <span class="ruby-operator">||</span>
-476:          <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;xml&quot;</span> <span class="ruby-operator">||</span>
-477:          <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;thr&quot;</span> <span class="ruby-operator">||</span>
-478:          <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;this&quot;</span> <span class="ruby-operator">||</span>
-479:          <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;float&quot;</span> <span class="ruby-operator">||</span>
-480:          <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;user&quot;</span> <span class="ruby-operator">||</span>
-481:          <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;username&quot;</span> <span class="ruby-operator">||</span>
-482:          <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;out&quot;</span>)
-483:       <span class="ruby-keyword kw">end</span>
-484:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:parse</span>]
-485:         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">parsed_uris</span>
-486:       <span class="ruby-keyword kw">else</span>
-487:         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">parsed_uris</span>.<span class="ruby-identifier">collect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">uri</span><span class="ruby-operator">|</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">to_s</span> }
-488:       <span class="ruby-keyword kw">end</span>
-489:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000002" class="method-detail">
-        <a name="M000002"></a>
-        <div class="method-heading">
-          <a href="#M000002" class="method-signature">
-          <span class="method-name">heuristic_parse</span><span class="method-args">(input, hints={})</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Converts an input to a <a href="URI.html">URI</a>. The input does not have
-to be a valid <a href="URI.html">URI</a> &#8212; the method will use
-heuristics to guess what <a href="URI.html">URI</a> was intended. This is
-not standards compliant, merely <a
-href="URI.html#M000015">user</a>-friendly.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000002-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000002-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 107</span>
-107:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">heuristic_parse</span>(<span class="ruby-identifier">input</span>, <span class="ruby-identifier">hints</span>={})
-108:       <span class="ruby-identifier">input</span> = <span class="ruby-identifier">input</span>.<span class="ruby-identifier">dup</span>
-109:       <span class="ruby-identifier">hints</span> = {
-110:         <span class="ruby-identifier">:scheme</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;http&quot;</span>
-111:       }.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">hints</span>)
-112:       <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">input</span>
-113:       <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/^http:\/+/</span>
-114:         <span class="ruby-identifier">input</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/^http:\/+/</span>, <span class="ruby-value str">&quot;http://&quot;</span>)
-115:       <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/^feed:\/+http:\/+/</span>
-116:         <span class="ruby-identifier">input</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/^feed:\/+http:\/+/</span>, <span class="ruby-value str">&quot;feed:http://&quot;</span>)
-117:       <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/^feed:\/+/</span>
-118:         <span class="ruby-identifier">input</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/^feed:\/+/</span>, <span class="ruby-value str">&quot;feed://&quot;</span>)
-119:       <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/^file:\/+/</span>
-120:         <span class="ruby-identifier">input</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/^file:\/+/</span>, <span class="ruby-value str">&quot;file:///&quot;</span>)
-121:       <span class="ruby-keyword kw">end</span>
-122:       <span class="ruby-identifier">parsed</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">input</span>)
-123:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">parsed</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^[^\/?#\.]+\.[^\/?#]+$/</span>
-124:         <span class="ruby-identifier">parsed</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">hints</span>[<span class="ruby-identifier">:scheme</span>] <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;://&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">input</span>)
-125:       <span class="ruby-keyword kw">end</span>
-126:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">parsed</span>.<span class="ruby-identifier">authority</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
-127:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">parsed</span>.<span class="ruby-identifier">path</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^[^\/]+\./</span>
-128:           <span class="ruby-identifier">new_host</span> = <span class="ruby-identifier">parsed</span>.<span class="ruby-identifier">path</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/^([^\/]+\.[^\/]*)/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
-129:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">new_host</span>
-130:             <span class="ruby-identifier">new_path</span> = <span class="ruby-identifier">parsed</span>.<span class="ruby-identifier">path</span>.<span class="ruby-identifier">gsub</span>(
-131:               <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">&quot;^&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">escape</span>(<span class="ruby-identifier">new_host</span>)), <span class="ruby-value str">&quot;&quot;</span>)
-132:             <span class="ruby-identifier">parsed</span>.<span class="ruby-identifier">host</span> = <span class="ruby-identifier">new_host</span>
-133:             <span class="ruby-identifier">parsed</span>.<span class="ruby-identifier">path</span> = <span class="ruby-identifier">new_path</span>
-134:             <span class="ruby-identifier">parsed</span>.<span class="ruby-identifier">scheme</span> = <span class="ruby-identifier">hints</span>[<span class="ruby-identifier">:scheme</span>]
-135:           <span class="ruby-keyword kw">end</span>
-136:         <span class="ruby-keyword kw">end</span>
-137:       <span class="ruby-keyword kw">end</span>
-138:       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">parsed</span>
-139:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000025" class="method-detail">
-        <a name="M000025"></a>
-        <div class="method-heading">
-          <a href="#M000025" class="method-signature">
-          <span class="method-name">ip_based_schemes</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns an array of known ip-based schemes. These schemes typically use a
-similar <a href="URI.html">URI</a> form: //&lt;<a
-href="URI.html#M000015">user</a>&gt;:&lt;<a
-href="URI.html#M000017">password</a>&gt;@&lt;<a
-href="URI.html#M000021">host</a>&gt;:&lt;<a
-href="URI.html#M000027">port</a>&gt;/&lt;url-<a
-href="URI.html#M000030">path</a>&gt;
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000025-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000025-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 662</span>
-662:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">ip_based_schemes</span>
-663:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme_mapping</span>.<span class="ruby-identifier">keys</span>
-664:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000006" class="method-detail">
-        <a name="M000006"></a>
-        <div class="method-heading">
-          <a href="#M000006" class="method-signature">
-          <span class="method-name">join</span><span class="method-args">(*uris)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Joins several uris together.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000006-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000006-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 328</span>
-328:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">join</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">uris</span>)
-329:       <span class="ruby-identifier">uri_objects</span> = <span class="ruby-identifier">uris</span>.<span class="ruby-identifier">collect</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">uri</span><span class="ruby-operator">|</span>
-330:         <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-keyword kw">self</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">uri</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">to_s</span>)
-331:       <span class="ruby-keyword kw">end</span>
-332:       <span class="ruby-identifier">result</span> = <span class="ruby-identifier">uri_objects</span>.<span class="ruby-identifier">shift</span>.<span class="ruby-identifier">dup</span>
-333:       <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">uri</span> <span class="ruby-keyword kw">in</span> <span class="ruby-identifier">uri_objects</span>
-334:         <span class="ruby-identifier">result</span>.<span class="ruby-identifier">merge!</span>(<span class="ruby-identifier">uri</span>)
-335:       <span class="ruby-keyword kw">end</span>
-336:       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">result</span>
-337:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000012" class="method-detail">
-        <a name="M000012"></a>
-        <div class="method-heading">
-          <a href="#M000012" class="method-signature">
-          <span class="method-name">new</span><span class="method-args">(scheme, user, password, host, port, path, query, fragment)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Creates a <a href="URI.html#M000012">new</a> uri object from component
-parts. Passing nil for any of these parameters is acceptable.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000012-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000012-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 493</span>
-493:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">scheme</span>, <span class="ruby-identifier">user</span>, <span class="ruby-identifier">password</span>, <span class="ruby-identifier">host</span>, <span class="ruby-identifier">port</span>, <span class="ruby-identifier">path</span>, <span class="ruby-identifier">query</span>, <span class="ruby-identifier">fragment</span>)
-494:       <span class="ruby-ivar">@scheme</span> = <span class="ruby-identifier">scheme</span>
-495:       <span class="ruby-ivar">@scheme</span> = <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@scheme</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">strip</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;&quot;</span>
-496:       <span class="ruby-ivar">@user</span> = <span class="ruby-identifier">user</span>
-497:       <span class="ruby-ivar">@password</span> = <span class="ruby-identifier">password</span>
-498:       <span class="ruby-ivar">@host</span> = <span class="ruby-identifier">host</span>
-499:       <span class="ruby-ivar">@specified_port</span> = <span class="ruby-identifier">port</span>.<span class="ruby-identifier">to_s</span>
-500:       <span class="ruby-ivar">@port</span> = <span class="ruby-identifier">port</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Fixnum</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">port</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">port</span>
-501:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@port</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span>(<span class="ruby-ivar">@port</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^\d+$/</span>)
-502:         <span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidURIError</span>,
-503:           <span class="ruby-node">&quot;Invalid port number: #{@port.inspect}&quot;</span>
-504:       <span class="ruby-keyword kw">end</span>
-505:       <span class="ruby-ivar">@port</span> = <span class="ruby-ivar">@port</span>.<span class="ruby-identifier">to_i</span>
-506:       <span class="ruby-ivar">@port</span> = <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@port</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-507:       <span class="ruby-ivar">@path</span> = (<span class="ruby-identifier">path</span> <span class="ruby-operator">||</span> <span class="ruby-value str">&quot;&quot;</span>)
-508:       <span class="ruby-ivar">@query</span> = <span class="ruby-identifier">query</span>
-509:       <span class="ruby-ivar">@fragment</span> = <span class="ruby-identifier">fragment</span>
-510:
-511:       <span class="ruby-identifier">validate</span>()
-512:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000010" class="method-detail">
-        <a name="M000010"></a>
-        <div class="method-heading">
-          <a href="#M000010" class="method-signature">
-          <span class="method-name">normalized_encode</span><span class="method-args">(uri)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Normalizes the encoding of a <a href="URI.html">URI</a>. Characters within
-a hostname are not percent encoded to allow for internationalized domain
-names.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000010-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000010-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 401</span>
-401:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">normalized_encode</span>(<span class="ruby-identifier">uri</span>)
-402:       <span class="ruby-identifier">uri_object</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-keyword kw">self</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">uri</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">to_s</span>)
-403:       <span class="ruby-identifier">segments</span> = {
-404:         <span class="ruby-identifier">:scheme</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unencode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">scheme</span>),
-405:         <span class="ruby-identifier">:user</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unencode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">user</span>),
-406:         <span class="ruby-identifier">:password</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unencode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">password</span>),
-407:         <span class="ruby-identifier">:host</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unencode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">host</span>),
-408:         <span class="ruby-identifier">:port</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unencode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">specified_port</span>),
-409:         <span class="ruby-identifier">:path</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unencode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">path</span>),
-410:         <span class="ruby-identifier">:query</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unencode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">query</span>),
-411:         <span class="ruby-identifier">:fragment</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unencode_segment</span>(<span class="ruby-identifier">uri_object</span>.<span class="ruby-identifier">fragment</span>)
-412:       }
-413:       <span class="ruby-keyword kw">if</span> <span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">IDNA</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">:use_libidn?</span>)
-414:         <span class="ruby-identifier">segments</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
-415:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-416:             <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-constant">IDN</span><span class="ruby-operator">::</span><span class="ruby-constant">Stringprep</span>.<span class="ruby-identifier">nfkc_normalize</span>(<span class="ruby-identifier">value</span>.<span class="ruby-identifier">to_s</span>)
-417:           <span class="ruby-keyword kw">end</span>
-418:         <span class="ruby-keyword kw">end</span>
-419:       <span class="ruby-keyword kw">end</span>
-420:       <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>.<span class="ruby-identifier">new</span>(
-421:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:scheme</span>],
-422:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">SCHEME</span>),
-423:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:user</span>],
-424:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">AUTHORITY</span>),
-425:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:password</span>],
-426:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">AUTHORITY</span>),
-427:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:host</span>],
-428:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:port</span>],
-429:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:path</span>],
-430:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">PATH</span>),
-431:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:query</span>],
-432:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">QUERY</span>),
-433:         <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encode_segment</span>(<span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:fragment</span>],
-434:           <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">CharacterClasses</span><span class="ruby-operator">::</span><span class="ruby-constant">FRAGMENT</span>)
-435:       ).<span class="ruby-identifier">to_s</span>
-436:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000001" class="method-detail">
-        <a name="M000001"></a>
-        <div class="method-heading">
-          <a href="#M000001" class="method-signature">
-          <span class="method-name">parse</span><span class="method-args">(uri_string)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns a <a href="URI.html">URI</a> object based on the parsed string.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000001-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000001-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 60</span>
- 60:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">uri_string</span>)
- 61:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri_string</span>.<span class="ruby-identifier">nil?</span>
- 62:
- 63:       <span class="ruby-comment cmt"># If a URI object is passed, just return itself.</span>
- 64:       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">uri_string</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri_string</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-keyword kw">self</span>)
- 65:
- 66:       <span class="ruby-comment cmt"># If a URI object of the Ruby standard library variety is passed,</span>
- 67:       <span class="ruby-comment cmt"># convert it to a string, then parse the string.</span>
- 68:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri_string</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">name</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^URI::/</span>
- 69:         <span class="ruby-identifier">uri_string</span> = <span class="ruby-identifier">uri_string</span>.<span class="ruby-identifier">to_s</span>
- 70:       <span class="ruby-keyword kw">end</span>
- 71:
- 72:       <span class="ruby-identifier">uri_regex</span> =
- 73:         <span class="ruby-regexp re">/^(([^:\/?#]+):)?(\/\/([^\/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?/</span>
- 74:       <span class="ruby-identifier">scan</span> = <span class="ruby-identifier">uri_string</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-identifier">uri_regex</span>)
- 75:       <span class="ruby-identifier">fragments</span> = <span class="ruby-identifier">scan</span>[<span class="ruby-value">0</span>]
- 76:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">fragments</span>.<span class="ruby-identifier">nil?</span>
- 77:       <span class="ruby-identifier">scheme</span> = <span class="ruby-identifier">fragments</span>[<span class="ruby-value">1</span>]
- 78:       <span class="ruby-identifier">authority</span> = <span class="ruby-identifier">fragments</span>[<span class="ruby-value">3</span>]
- 79:       <span class="ruby-identifier">path</span> = <span class="ruby-identifier">fragments</span>[<span class="ruby-value">4</span>]
- 80:       <span class="ruby-identifier">query</span> = <span class="ruby-identifier">fragments</span>[<span class="ruby-value">6</span>]
- 81:       <span class="ruby-identifier">fragment</span> = <span class="ruby-identifier">fragments</span>[<span class="ruby-value">8</span>]
- 82:       <span class="ruby-identifier">userinfo</span> = <span class="ruby-keyword kw">nil</span>
- 83:       <span class="ruby-identifier">user</span> = <span class="ruby-keyword kw">nil</span>
- 84:       <span class="ruby-identifier">password</span> = <span class="ruby-keyword kw">nil</span>
- 85:       <span class="ruby-identifier">host</span> = <span class="ruby-keyword kw">nil</span>
- 86:       <span class="ruby-identifier">port</span> = <span class="ruby-keyword kw">nil</span>
- 87:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">authority</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
- 88:         <span class="ruby-identifier">userinfo</span> = <span class="ruby-identifier">authority</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/^([^\[\]]*)@/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
- 89:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">userinfo</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
- 90:           <span class="ruby-identifier">user</span> = <span class="ruby-identifier">userinfo</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/^([^:]*):?/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
- 91:           <span class="ruby-identifier">password</span> = <span class="ruby-identifier">userinfo</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/:(.*)$/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
- 92:         <span class="ruby-keyword kw">end</span>
- 93:         <span class="ruby-identifier">host</span> = <span class="ruby-identifier">authority</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/^([^\[\]]*)@/</span>, <span class="ruby-value str">&quot;&quot;</span>).<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/:([^:@\[\]]*?)$/</span>, <span class="ruby-value str">&quot;&quot;</span>)
- 94:         <span class="ruby-identifier">port</span> = <span class="ruby-identifier">authority</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/:([^:@\[\]]*?)$/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
- 95:       <span class="ruby-keyword kw">end</span>
- 96:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">port</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">port</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;&quot;</span>
- 97:         <span class="ruby-identifier">port</span> = <span class="ruby-keyword kw">nil</span>
- 98:       <span class="ruby-keyword kw">end</span>
- 99:
-100:       <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>.<span class="ruby-identifier">new</span>(
-101:         <span class="ruby-identifier">scheme</span>, <span class="ruby-identifier">user</span>, <span class="ruby-identifier">password</span>, <span class="ruby-identifier">host</span>, <span class="ruby-identifier">port</span>, <span class="ruby-identifier">path</span>, <span class="ruby-identifier">query</span>, <span class="ruby-identifier">fragment</span>)
-102:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000026" class="method-detail">
-        <a name="M000026"></a>
-        <div class="method-heading">
-          <a href="#M000026" class="method-signature">
-          <span class="method-name">scheme_mapping</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns a hash of common IP-based schemes and their default <a
-href="URI.html#M000027">port</a> numbers. Adding <a
-href="URI.html#M000012">new</a> schemes to this hash, as necessary, will
-allow for better <a href="URI.html">URI</a> normalization.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000026-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000026-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 669</span>
-669:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme_mapping</span>
-670:       <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-ivar">@protocol_mapping</span>) <span class="ruby-operator">||</span> <span class="ruby-ivar">@protocol_mapping</span>.<span class="ruby-identifier">nil?</span>
-671:         <span class="ruby-ivar">@protocol_mapping</span> = {
-672:           <span class="ruby-value str">&quot;http&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">80</span>,
-673:           <span class="ruby-value str">&quot;https&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">443</span>,
-674:           <span class="ruby-value str">&quot;ftp&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">21</span>,
-675:           <span class="ruby-value str">&quot;tftp&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">69</span>,
-676:           <span class="ruby-value str">&quot;ssh&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">22</span>,
-677:           <span class="ruby-value str">&quot;svn+ssh&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">22</span>,
-678:           <span class="ruby-value str">&quot;telnet&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">23</span>,
-679:           <span class="ruby-value str">&quot;nntp&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">119</span>,
-680:           <span class="ruby-value str">&quot;gopher&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">70</span>,
-681:           <span class="ruby-value str">&quot;wais&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">210</span>,
-682:           <span class="ruby-value str">&quot;ldap&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">389</span>,
-683:           <span class="ruby-value str">&quot;prospero&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">1525</span>
-684:         }
-685:       <span class="ruby-keyword kw">end</span>
-686:       <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@protocol_mapping</span>
-687:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000008" class="method-detail">
-        <a name="M000008"></a>
-        <div class="method-heading">
-          <a href="#M000008" class="method-signature">
-          <span class="method-name">unencode_segment</span><span class="method-args">(segment)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Unencodes any percent encoded characters within a <a
-href="URI.html">URI</a> segment. Returns a string.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000008-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000008-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 364</span>
-364:     <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unencode_segment</span>(<span class="ruby-identifier">segment</span>)
-365:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">segment</span>.<span class="ruby-identifier">nil?</span>
-366:       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">segment</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/%[0-9a-f]{2}/i</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">sequence</span><span class="ruby-operator">|</span>
-367:         <span class="ruby-identifier">sequence</span>[<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">3</span>].<span class="ruby-identifier">to_i</span>(<span class="ruby-value">16</span>).<span class="ruby-identifier">chr</span>
-368:       <span class="ruby-keyword kw">end</span>
-369:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000041" class="method-detail">
-        <a name="M000041"></a>
-        <div class="method-heading">
-          <a href="#M000041" class="method-signature">
-          <span class="method-name">+</span><span class="method-args">(uri)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Joins two URIs together.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000041-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000041-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 788</span>
-788:     <span class="ruby-keyword kw">def</span> <span class="ruby-operator">+</span>(<span class="ruby-identifier">uri</span>)
-789:       <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">uri</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>)
-790:         <span class="ruby-identifier">uri</span> = <span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">to_s</span>)
-791:       <span class="ruby-keyword kw">end</span>
-792:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;&quot;</span>
-793:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>
-794:       <span class="ruby-keyword kw">end</span>
-795:
-796:       <span class="ruby-identifier">joined_scheme</span> = <span class="ruby-keyword kw">nil</span>
-797:       <span class="ruby-identifier">joined_user</span> = <span class="ruby-keyword kw">nil</span>
-798:       <span class="ruby-identifier">joined_password</span> = <span class="ruby-keyword kw">nil</span>
-799:       <span class="ruby-identifier">joined_host</span> = <span class="ruby-keyword kw">nil</span>
-800:       <span class="ruby-identifier">joined_port</span> = <span class="ruby-keyword kw">nil</span>
-801:       <span class="ruby-identifier">joined_path</span> = <span class="ruby-keyword kw">nil</span>
-802:       <span class="ruby-identifier">joined_query</span> = <span class="ruby-keyword kw">nil</span>
-803:       <span class="ruby-identifier">joined_fragment</span> = <span class="ruby-keyword kw">nil</span>
-804:
-805:       <span class="ruby-comment cmt"># Section 5.2.2 of RFC 3986</span>
-806:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-807:         <span class="ruby-identifier">joined_scheme</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span>
-808:         <span class="ruby-identifier">joined_user</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">user</span>
-809:         <span class="ruby-identifier">joined_password</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">password</span>
-810:         <span class="ruby-identifier">joined_host</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">host</span>
-811:         <span class="ruby-identifier">joined_port</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">specified_port</span>
-812:         <span class="ruby-identifier">joined_path</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">path</span>)
-813:         <span class="ruby-identifier">joined_query</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">query</span>
-814:       <span class="ruby-keyword kw">else</span>
-815:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">authority</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-816:           <span class="ruby-identifier">joined_user</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">user</span>
-817:           <span class="ruby-identifier">joined_password</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">password</span>
-818:           <span class="ruby-identifier">joined_host</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">host</span>
-819:           <span class="ruby-identifier">joined_port</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">specified_port</span>
-820:           <span class="ruby-identifier">joined_path</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">path</span>)
-821:           <span class="ruby-identifier">joined_query</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">query</span>
-822:         <span class="ruby-keyword kw">else</span>
-823:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">path</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">path</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;&quot;</span>
-824:             <span class="ruby-identifier">joined_path</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">path</span>
-825:             <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">query</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-826:               <span class="ruby-identifier">joined_query</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">query</span>
-827:             <span class="ruby-keyword kw">else</span>
-828:               <span class="ruby-identifier">joined_query</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">query</span>
-829:             <span class="ruby-keyword kw">end</span>
-830:           <span class="ruby-keyword kw">else</span>
-831:             <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">path</span>[<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;/&quot;</span>
-832:               <span class="ruby-identifier">joined_path</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">path</span>)
-833:             <span class="ruby-keyword kw">else</span>
-834:               <span class="ruby-identifier">base_path</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">path</span>.<span class="ruby-identifier">dup</span>
-835:               <span class="ruby-identifier">base_path</span> = <span class="ruby-value str">&quot;&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">base_path</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
-836:               <span class="ruby-identifier">base_path</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">base_path</span>)
-837:
-838:               <span class="ruby-comment cmt"># Section 5.2.3 of RFC 3986</span>
-839:               <span class="ruby-comment cmt">#</span>
-840:               <span class="ruby-comment cmt"># Removes the right-most path segment from the base path.</span>
-841:               <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">base_path</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/\//</span>
-842:                 <span class="ruby-identifier">base_path</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/\/[^\/]+$/</span>, <span class="ruby-value str">&quot;/&quot;</span>)
-843:               <span class="ruby-keyword kw">else</span>
-844:                 <span class="ruby-identifier">base_path</span> = <span class="ruby-value str">&quot;&quot;</span>
-845:               <span class="ruby-keyword kw">end</span>
-846:
-847:               <span class="ruby-comment cmt"># If the base path is empty and an authority segment has been</span>
-848:               <span class="ruby-comment cmt"># defined, use a base path of &quot;/&quot;</span>
-849:               <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">base_path</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;&quot;</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">authority</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-850:                 <span class="ruby-identifier">base_path</span> = <span class="ruby-value str">&quot;/&quot;</span>
-851:               <span class="ruby-keyword kw">end</span>
-852:
-853:               <span class="ruby-identifier">joined_path</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">base_path</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">path</span>)
-854:             <span class="ruby-keyword kw">end</span>
-855:             <span class="ruby-identifier">joined_query</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">query</span>
-856:           <span class="ruby-keyword kw">end</span>
-857:           <span class="ruby-identifier">joined_user</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">user</span>
-858:           <span class="ruby-identifier">joined_password</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">password</span>
-859:           <span class="ruby-identifier">joined_host</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">host</span>
-860:           <span class="ruby-identifier">joined_port</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">specified_port</span>
-861:         <span class="ruby-keyword kw">end</span>
-862:         <span class="ruby-identifier">joined_scheme</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span>
-863:       <span class="ruby-keyword kw">end</span>
-864:       <span class="ruby-identifier">joined_fragment</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">fragment</span>
-865:
-866:       <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>.<span class="ruby-identifier">new</span>(
-867:         <span class="ruby-identifier">joined_scheme</span>,
-868:         <span class="ruby-identifier">joined_user</span>,
-869:         <span class="ruby-identifier">joined_password</span>,
-870:         <span class="ruby-identifier">joined_host</span>,
-871:         <span class="ruby-identifier">joined_port</span>,
-872:         <span class="ruby-identifier">joined_path</span>,
-873:         <span class="ruby-identifier">joined_query</span>,
-874:         <span class="ruby-identifier">joined_fragment</span>
-875:       )
-876:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000052" class="method-detail">
-        <a name="M000052"></a>
-        <div class="method-heading">
-          <a href="#M000052" class="method-signature">
-          <span class="method-name">==</span><span class="method-args">(uri)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns true if the <a href="URI.html">URI</a> objects are equal. This
-method normalizes both URIs before doing the comparison.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000052-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000052-source">
-<pre>
-      <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 1062</span>
-1062:     <span class="ruby-keyword kw">def</span> <span class="ruby-operator">==</span>(<span class="ruby-identifier">uri</span>)
-1063:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>)
-1064:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">normalize</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">normalize</span>.<span class="ruby-identifier">to_s</span>
-1065:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000051" class="method-detail">
-        <a name="M000051"></a>
-        <div class="method-heading">
-          <a href="#M000051" class="method-signature">
-          <span class="method-name">===</span><span class="method-args">(uri)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns true if the <a href="URI.html">URI</a> objects are equal. This
-method normalizes both URIs before doing the comparison, and allows
-comparison against strings.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000051-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000051-source">
-<pre>
-      <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 1047</span>
-1047:     <span class="ruby-keyword kw">def</span> <span class="ruby-operator">===</span>(<span class="ruby-identifier">uri</span>)
-1048:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:normalize</span>)
-1049:         <span class="ruby-identifier">uri_string</span> = <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">normalize</span>.<span class="ruby-identifier">to_s</span>
-1050:       <span class="ruby-keyword kw">else</span>
-1051:         <span class="ruby-keyword kw">begin</span>
-1052:           <span class="ruby-identifier">uri_string</span> = <span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">to_s</span>).<span class="ruby-identifier">normalize</span>.<span class="ruby-identifier">to_s</span>
-1053:         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">InvalidURIError</span>
-1054:           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
-1055:         <span class="ruby-keyword kw">end</span>
-1056:       <span class="ruby-keyword kw">end</span>
-1057:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">normalize</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">uri_string</span>
-1058:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000040" class="method-detail">
-        <a name="M000040"></a>
-        <div class="method-heading">
-          <a href="#M000040" class="method-signature">
-          <span class="method-name">absolute?</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns true if this <a href="URI.html">URI</a> is known to be absolute.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000040-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000040-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 783</span>
-783:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">absolute?</span>
-784:       <span class="ruby-keyword kw">return</span> <span class="ruby-operator">!</span><span class="ruby-identifier">relative?</span>
-785:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000023" class="method-detail">
-        <a name="M000023"></a>
-        <div class="method-heading">
-          <a href="#M000023" class="method-signature">
-          <span class="method-name">authority</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the <a href="URI.html#M000023">authority</a> segment of this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000023-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000023-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 617</span>
-617:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">authority</span>
-618:       <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-ivar">@authority</span>) <span class="ruby-operator">||</span> <span class="ruby-ivar">@authority</span>.<span class="ruby-identifier">nil?</span>
-619:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">host</span>.<span class="ruby-identifier">nil?</span>
-620:         <span class="ruby-ivar">@authority</span> = <span class="ruby-value str">&quot;&quot;</span>
-621:         <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">userinfo</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-622:           <span class="ruby-ivar">@authority</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;#{self.userinfo}@&quot;</span>
-623:         <span class="ruby-keyword kw">end</span>
-624:         <span class="ruby-ivar">@authority</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">host</span>
-625:         <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">specified_port</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-626:           <span class="ruby-ivar">@authority</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;:#{self.specified_port}&quot;</span>
-627:         <span class="ruby-keyword kw">end</span>
-628:       <span class="ruby-keyword kw">end</span>
-629:       <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@authority</span>
-630:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000024" class="method-detail">
-        <a name="M000024"></a>
-        <div class="method-heading">
-          <a href="#M000024" class="method-signature">
-          <span class="method-name">authority=</span><span class="method-args">(new_authority)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Sets the <a href="URI.html#M000023">authority</a> segment of this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000024-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000024-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 633</span>
-633:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">authority=</span>(<span class="ruby-identifier">new_authority</span>)
-634:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">new_authority</span>
-635:         <span class="ruby-identifier">new_userinfo</span> = <span class="ruby-identifier">new_authority</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/^([^\[\]]*)@/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
-636:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">new_userinfo</span>
-637:           <span class="ruby-identifier">new_user</span> = <span class="ruby-identifier">new_userinfo</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/^([^:]*):?/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
-638:           <span class="ruby-identifier">new_password</span> = <span class="ruby-identifier">new_userinfo</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/:(.*)$/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
-639:         <span class="ruby-keyword kw">end</span>
-640:         <span class="ruby-identifier">new_host</span> =
-641:           <span class="ruby-identifier">new_authority</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/^([^\[\]]*)@/</span>, <span class="ruby-value str">&quot;&quot;</span>).<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/:([^:@\[\]]*?)$/</span>, <span class="ruby-value str">&quot;&quot;</span>)
-642:         <span class="ruby-identifier">new_port</span> =
-643:           <span class="ruby-identifier">new_authority</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/:([^:@\[\]]*?)$/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
-644:       <span class="ruby-keyword kw">end</span>
-645:
-646:       <span class="ruby-comment cmt"># Password assigned first to ensure validity in case of nil</span>
-647:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">password</span> = <span class="ruby-identifier">new_password</span>
-648:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">user</span> = <span class="ruby-identifier">new_user</span>
-649:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">host</span> = <span class="ruby-identifier">new_host</span>
-650:
-651:       <span class="ruby-comment cmt"># Port reset to allow port normalization</span>
-652:       <span class="ruby-ivar">@port</span> = <span class="ruby-keyword kw">nil</span>
-653:       <span class="ruby-ivar">@specified_port</span> = <span class="ruby-identifier">new_port</span>
-654:
-655:       <span class="ruby-comment cmt"># Ensure we haven't created an invalid URI</span>
-656:       <span class="ruby-identifier">validate</span>()
-657:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000032" class="method-detail">
-        <a name="M000032"></a>
-        <div class="method-heading">
-          <a href="#M000032" class="method-signature">
-          <span class="method-name">basename</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the <a href="URI.html#M000032">basename</a>, if any, of the file at
-the <a href="URI.html#M000030">path</a> being referenced. Returns nil if
-there is no <a href="URI.html#M000030">path</a> component.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000032-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000032-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 735</span>
-735:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">basename</span>
-736:       <span class="ruby-comment cmt"># Path cannot be nil</span>
-737:       <span class="ruby-keyword kw">return</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">path</span>).<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/;[^\/]*$/</span>, <span class="ruby-value str">&quot;&quot;</span>)
-738:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000050" class="method-detail">
-        <a name="M000050"></a>
-        <div class="method-heading">
-          <a href="#M000050" class="method-signature">
-          <span class="method-name">display_uri</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Creates a <a href="URI.html">URI</a> suitable for display to users. If
-semantic attacks are likely, the application should try to detect these and
-warn the <a href="URI.html#M000015">user</a>. See RFC 3986 section 7.6 for
-more information.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000050-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000050-source">
-<pre>
-      <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 1033</span>
-1033:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">display_uri</span>
-1034:       <span class="ruby-identifier">display_uri</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">normalize</span>
-1035:       <span class="ruby-keyword kw">begin</span>
-1036:         <span class="ruby-identifier">display_uri</span>.<span class="ruby-identifier">instance_variable_set</span>(<span class="ruby-value str">&quot;@host&quot;</span>,
-1037:           <span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">IDNA</span>.<span class="ruby-identifier">to_unicode</span>(<span class="ruby-identifier">display_uri</span>.<span class="ruby-identifier">host</span>))
-1038:       <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span>
-1039:         <span class="ruby-keyword kw">nil</span>
-1040:       <span class="ruby-keyword kw">end</span>
-1041:       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">display_uri</span>
-1042:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000054" class="method-detail">
-        <a name="M000054"></a>
-        <div class="method-heading">
-          <a href="#M000054" class="method-signature">
-          <span class="method-name">dup</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Clones the <a href="URI.html">URI</a> object.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000054-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000054-source">
-<pre>
-      <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 1075</span>
-1075:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">dup</span>
-1076:       <span class="ruby-identifier">duplicated_scheme</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span>.<span class="ruby-identifier">dup</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
-1077:       <span class="ruby-identifier">duplicated_user</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">user</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">user</span>.<span class="ruby-identifier">dup</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
-1078:       <span class="ruby-identifier">duplicated_password</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">password</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">password</span>.<span class="ruby-identifier">dup</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
-1079:       <span class="ruby-identifier">duplicated_host</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">host</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">host</span>.<span class="ruby-identifier">dup</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
-1080:       <span class="ruby-identifier">duplicated_port</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">specified_port</span>
-1081:       <span class="ruby-identifier">duplicated_path</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">path</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">path</span>.<span class="ruby-identifier">dup</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
-1082:       <span class="ruby-identifier">duplicated_query</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">query</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">query</span>.<span class="ruby-identifier">dup</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
-1083:       <span class="ruby-identifier">duplicated_fragment</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">fragment</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">fragment</span>.<span class="ruby-identifier">dup</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
-1084:       <span class="ruby-identifier">duplicated_uri</span> = <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>.<span class="ruby-identifier">new</span>(
-1085:         <span class="ruby-identifier">duplicated_scheme</span>,
-1086:         <span class="ruby-identifier">duplicated_user</span>,
-1087:         <span class="ruby-identifier">duplicated_password</span>,
-1088:         <span class="ruby-identifier">duplicated_host</span>,
-1089:         <span class="ruby-identifier">duplicated_port</span>,
-1090:         <span class="ruby-identifier">duplicated_path</span>,
-1091:         <span class="ruby-identifier">duplicated_query</span>,
-1092:         <span class="ruby-identifier">duplicated_fragment</span>
-1093:       )
-1094:       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">duplicated_uri</span>
-1095:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000053" class="method-detail">
-        <a name="M000053"></a>
-        <div class="method-heading">
-          <a href="#M000053" class="method-signature">
-          <span class="method-name">eql?</span><span class="method-args">(uri)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns true if the <a href="URI.html">URI</a> objects are equal. This
-method does NOT <a href="URI.html#M000048">normalize</a> either <a
-href="URI.html">URI</a> before doing the comparison.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000053-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000053-source">
-<pre>
-      <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 1069</span>
-1069:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">eql?</span>(<span class="ruby-identifier">uri</span>)
-1070:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>)
-1071:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">to_s</span>
-1072:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000033" class="method-detail">
-        <a name="M000033"></a>
-        <div class="method-heading">
-          <a href="#M000033" class="method-signature">
-          <span class="method-name">extname</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the extension, if any, of the file at the <a
-href="URI.html#M000030">path</a> being referenced. Returns &quot;&quot; if
-there is no extension or nil if there is no <a
-href="URI.html#M000030">path</a> component.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000033-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000033-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 743</span>
-743:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">extname</span>
-744:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">path</span>
-745:       <span class="ruby-keyword kw">return</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">extname</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">basename</span>)
-746:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000005" class="method-detail">
-        <a name="M000005"></a>
-        <div class="method-heading">
-          <a href="#M000005" class="method-signature">
-          <span class="method-name">extract_mapping</span><span class="method-args">(pattern, processor=nil)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Extracts a mapping from the <a href="URI.html">URI</a> using a <a
-href="URI.html">URI</a> Template pattern. Returns nil if the pattern
-doesn&#8216;t match the <a href="URI.html">URI</a>.
-</p>
-<p>
-An optional processor object may be supplied. The object should respond to
-either the :restore or :match messages or both. The :restore method should
-take two parameters: :name and :value. The :restore method should reverse
-any transformations that have been performed on the value to ensure a valid
-<a href="URI.html">URI</a>. The :match method should take a single
-parameter: :name. The :match method should return a String containing a
-regular expression capture group for matching on that particular variable.
-The default value is &quot;.*&quot;.
-</p>
-<p>
-An example:
-</p>
-<pre>
- class ExampleProcessor
-   def self.restore(name, value)
-     return value.gsub(/\+/, &quot; &quot;) if name == &quot;query&quot;
-     return value
-   end
-   def self.match(name)
-     return &quot;.*?&quot; if name == &quot;first&quot;
-     return &quot;.*&quot;
-   end
- end
- uri = Addressable::URI.parse(
-   &quot;http://example.com/search/an+example+search+query/&quot;)
- uri.extract_mapping(&quot;http://example.com/search/{query}/&quot;,
-   ExampleProcessor)
- =&gt; {&quot;query&quot; =&gt; &quot;an example search query&quot;}
- uri = Addressable::URI.parse(
-   &quot;http://example.com/a/b/c/&quot;)
- uri.extract_mapping(&quot;http://example.com/{first}/{second}/&quot;,
-   ExampleProcessor)
- =&gt; {&quot;first&quot; =&gt; &quot;a&quot;, &quot;second&quot; =&gt; &quot;b/c&quot;}
-</pre>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000005-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000005-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 267</span>
-267:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">extract_mapping</span>(<span class="ruby-identifier">pattern</span>, <span class="ruby-identifier">processor</span>=<span class="ruby-keyword kw">nil</span>)
-268:       <span class="ruby-identifier">mapping</span> = {}
-269:       <span class="ruby-identifier">variable_regexp</span> =
-270:         <span class="ruby-node">/\{([#{Addressable::URI::CharacterClasses::UNRESERVED}]+)\}/</span>
-271:
-272:       <span class="ruby-comment cmt"># Get all the variables in the pattern</span>
-273:       <span class="ruby-identifier">variables</span> = <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-identifier">variable_regexp</span>).<span class="ruby-identifier">flatten</span>
-274:
-275:       <span class="ruby-comment cmt"># Initialize all result values to the empty string</span>
-276:       <span class="ruby-identifier">variables</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">mapping</span>[<span class="ruby-identifier">v</span>] = <span class="ruby-value str">&quot;&quot;</span> }
-277:
-278:       <span class="ruby-comment cmt"># Escape the pattern</span>
-279:       <span class="ruby-identifier">escaped_pattern</span> =
-280:         <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">escape</span>(<span class="ruby-identifier">pattern</span>).<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\\\{/</span>, <span class="ruby-value str">&quot;{&quot;</span>).<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\\\}/</span>, <span class="ruby-value str">&quot;}&quot;</span>)
-281:
-282:       <span class="ruby-comment cmt"># Create a regular expression that captures the values of the</span>
-283:       <span class="ruby-comment cmt"># variables in the URI.</span>
-284:       <span class="ruby-identifier">regexp_string</span> = <span class="ruby-identifier">escaped_pattern</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-identifier">variable_regexp</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
-285:         <span class="ruby-identifier">capture_group</span> = <span class="ruby-value str">&quot;(.*)&quot;</span>
-286:
-287:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">processor</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-288:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">processor</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:match</span>)
-289:             <span class="ruby-identifier">name</span> = <span class="ruby-identifier">v</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-identifier">variable_regexp</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
-290:             <span class="ruby-identifier">capture_group</span> = <span class="ruby-node">&quot;(#{processor.match(name)})&quot;</span>
-291:           <span class="ruby-keyword kw">end</span>
-292:         <span class="ruby-keyword kw">end</span>
-293:
-294:         <span class="ruby-identifier">capture_group</span>
-295:       <span class="ruby-keyword kw">end</span>
-296:
-297:       <span class="ruby-comment cmt"># Ensure that the regular expression matches the whole URI.</span>
-298:       <span class="ruby-identifier">regexp_string</span> = <span class="ruby-node">&quot;^#{regexp_string}$&quot;</span>
-299:
-300:       <span class="ruby-identifier">regexp</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">regexp_string</span>)
-301:       <span class="ruby-identifier">values</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-identifier">regexp</span>).<span class="ruby-identifier">flatten</span>
-302:
-303:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">variables</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">values</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">variables</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
-304:         <span class="ruby-comment cmt"># We have a match.</span>
-305:         <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">i</span> <span class="ruby-keyword kw">in</span> <span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">variables</span>.<span class="ruby-identifier">size</span>
-306:           <span class="ruby-identifier">name</span> = <span class="ruby-identifier">variables</span>[<span class="ruby-identifier">i</span>]
-307:           <span class="ruby-identifier">value</span> = <span class="ruby-identifier">values</span>[<span class="ruby-identifier">i</span>]
-308:
-309:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">processor</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-310:             <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">processor</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:restore</span>)
-311:               <span class="ruby-identifier">value</span> = <span class="ruby-identifier">processor</span>.<span class="ruby-identifier">restore</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">value</span>)
-312:             <span class="ruby-keyword kw">end</span>
-313:           <span class="ruby-keyword kw">end</span>
-314:
-315:           <span class="ruby-identifier">mapping</span>[<span class="ruby-identifier">name</span>] = <span class="ruby-identifier">value</span>
-316:         <span class="ruby-keyword kw">end</span>
-317:         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">mapping</span>
-318:       <span class="ruby-keyword kw">elsif</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">pattern</span>
-319:         <span class="ruby-comment cmt"># The pattern contained no variables but still matched.</span>
-320:         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">mapping</span>
-321:       <span class="ruby-keyword kw">else</span>
-322:         <span class="ruby-comment cmt"># Pattern failed to match URI.</span>
-323:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
-324:       <span class="ruby-keyword kw">end</span>
-325:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000036" class="method-detail">
-        <a name="M000036"></a>
-        <div class="method-heading">
-          <a href="#M000036" class="method-signature">
-          <span class="method-name">fragment</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the <a href="URI.html#M000036">fragment</a> for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000036-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000036-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 759</span>
-759:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fragment</span>
-760:       <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@fragment</span>
-761:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000037" class="method-detail">
-        <a name="M000037"></a>
-        <div class="method-heading">
-          <a href="#M000037" class="method-signature">
-          <span class="method-name">fragment=</span><span class="method-args">(new_fragment)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Sets the <a href="URI.html#M000036">fragment</a> for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000037-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000037-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 764</span>
-764:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fragment=</span>(<span class="ruby-identifier">new_fragment</span>)
-765:       <span class="ruby-ivar">@fragment</span> = <span class="ruby-identifier">new_fragment</span>
-766:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000021" class="method-detail">
-        <a name="M000021"></a>
-        <div class="method-heading">
-          <a href="#M000021" class="method-signature">
-          <span class="method-name">host</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the <a href="URI.html#M000021">host</a> for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000021-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000021-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 601</span>
-601:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">host</span>
-602:       <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@host</span>
-603:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000022" class="method-detail">
-        <a name="M000022"></a>
-        <div class="method-heading">
-          <a href="#M000022" class="method-signature">
-          <span class="method-name">host=</span><span class="method-args">(new_host)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Sets the <a href="URI.html#M000021">host</a> for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000022-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000022-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 606</span>
-606:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">host=</span>(<span class="ruby-identifier">new_host</span>)
-607:       <span class="ruby-ivar">@host</span> = <span class="ruby-identifier">new_host</span>
-608:
-609:       <span class="ruby-comment cmt"># Reset dependant values</span>
-610:       <span class="ruby-ivar">@authority</span> = <span class="ruby-keyword kw">nil</span>
-611:
-612:       <span class="ruby-comment cmt"># Ensure we haven't created an invalid URI</span>
-613:       <span class="ruby-identifier">validate</span>()
-614:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000057" class="method-detail">
-        <a name="M000057"></a>
-        <div class="method-heading">
-          <a href="#M000057" class="method-signature">
-          <span class="method-name">inspect</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns a string representation of the <a href="URI.html">URI</a>
-object&#8216;s state.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000057-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000057-source">
-<pre>
-      <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 1123</span>
-1123:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">inspect</span>
-1124:       <span class="ruby-identifier">sprintf</span>(<span class="ruby-value str">&quot;#&lt;%s:%#0x URI:%s&gt;&quot;</span>, <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">to_s</span>, <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">object_id</span>, <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_s</span>)
-1125:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000038" class="method-detail">
-        <a name="M000038"></a>
-        <div class="method-heading">
-          <a href="#M000038" class="method-signature">
-          <span class="method-name">ip_based?</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns true if the <a href="URI.html">URI</a> uses an IP-based protocol.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000038-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000038-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 769</span>
-769:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ip_based?</span>
-770:       <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span>
-771:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">ip_based_schemes</span>.<span class="ruby-identifier">include?</span>(
-772:           <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">downcase</span>)
-773:       <span class="ruby-keyword kw">end</span>
-774:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
-775:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000043" class="method-detail">
-        <a name="M000043"></a>
-        <div class="method-heading">
-          <span class="method-name">join</span><span class="method-args">(uri)</span>
-        </div>
-        <div class="method-description">
-          <p>
-Alias for <a href="URI.html#M000042">merge</a>
-</p>
-        </div>
-      </div>
-      <div id="method-M000045" class="method-detail">
-        <a name="M000045"></a>
-        <div class="method-heading">
-          <span class="method-name">join!</span><span class="method-args">(uri)</span>
-        </div>
-        <div class="method-description">
-          <p>
-Alias for <a href="URI.html#M000042">merge</a>!
-</p>
-        </div>
-      </div>
-      <div id="method-M000042" class="method-detail">
-        <a name="M000042"></a>
-        <div class="method-heading">
-          <a href="#M000042" class="method-signature">
-          <span class="method-name">merge</span><span class="method-args">(uri)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Merges two URIs together.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000042-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000042-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 879</span>
-879:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">merge</span>(<span class="ruby-identifier">uri</span>)
-880:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">uri</span>
-881:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000044" class="method-detail">
-        <a name="M000044"></a>
-        <div class="method-heading">
-          <a href="#M000044" class="method-signature">
-          <span class="method-name">merge!</span><span class="method-args">(uri)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Destructive form of <a href="URI.html#M000042">merge</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000044-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000044-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 885</span>
-885:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">merge!</span>(<span class="ruby-identifier">uri</span>)
-886:       <span class="ruby-identifier">replace_self</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">uri</span>))
-887:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000048" class="method-detail">
-        <a name="M000048"></a>
-        <div class="method-heading">
-          <a href="#M000048" class="method-signature">
-          <span class="method-name">normalize</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns a normalized <a href="URI.html">URI</a> object.
-</p>
-<p>
-NOTE: This method does not attempt to fully conform to specifications. It
-exists largely to correct other people&#8216;s failures to read the
-specifications, and also to deal with caching issues since several
-different URIs may represent the same resource and should not be cached
-multiple times.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000048-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000048-source">
-<pre>
-      <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 956</span>
- 956:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">normalize</span>
- 957:       <span class="ruby-identifier">normalized_scheme</span> = <span class="ruby-keyword kw">nil</span>
- 958:       <span class="ruby-identifier">normalized_scheme</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">downcase</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
- 959:       <span class="ruby-identifier">normalized_scheme</span> = <span class="ruby-value str">&quot;svn+ssh&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_scheme</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;ssh+svn&quot;</span>
- 960:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_scheme</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;feed&quot;</span>
- 961:         <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^feed:\/*http:\/*/</span>
- 962:           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">parse</span>(
- 963:             <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/^feed:\/*(http:\/*.*)/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]).<span class="ruby-identifier">normalize</span>
- 964:         <span class="ruby-keyword kw">end</span>
- 965:       <span class="ruby-keyword kw">end</span>
- 966:       <span class="ruby-identifier">normalized_user</span> = <span class="ruby-keyword kw">nil</span>
- 967:       <span class="ruby-identifier">normalized_user</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">user</span>.<span class="ruby-identifier">strip</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">user</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
- 968:       <span class="ruby-identifier">normalized_password</span> = <span class="ruby-keyword kw">nil</span>
- 969:       <span class="ruby-identifier">normalized_password</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">password</span>.<span class="ruby-identifier">strip</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">password</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
- 970:
- 971:       <span class="ruby-comment cmt"># If we are using http or https and user/password are blank,</span>
- 972:       <span class="ruby-comment cmt"># then we remove them</span>
- 973:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_scheme</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/https?/</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">normalized_user</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;&quot;</span> <span class="ruby-operator">&amp;&amp;</span>
- 974:           (<span class="ruby-operator">!</span><span class="ruby-identifier">normalized_password</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">normalized_password</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;&quot;</span>)
- 975:         <span class="ruby-identifier">normalized_user</span> = <span class="ruby-keyword kw">nil</span>
- 976:         <span class="ruby-identifier">normalized_password</span> = <span class="ruby-keyword kw">nil</span>
- 977:       <span class="ruby-keyword kw">end</span>
- 978:
- 979:       <span class="ruby-identifier">normalized_host</span> = <span class="ruby-keyword kw">nil</span>
- 980:       <span class="ruby-identifier">normalized_host</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">host</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">downcase</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">host</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
- 981:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_host</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
- 982:         <span class="ruby-keyword kw">begin</span>
- 983:           <span class="ruby-identifier">normalized_host</span> = <span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">IDNA</span>.<span class="ruby-identifier">to_ascii</span>(<span class="ruby-identifier">normalized_host</span>)
- 984:         <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span>
- 985:           <span class="ruby-keyword kw">nil</span>
- 986:         <span class="ruby-keyword kw">end</span>
- 987:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_host</span>[<span class="ruby-value">-1</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;.&quot;</span>
- 988:           <span class="ruby-identifier">normalized_host</span> = <span class="ruby-identifier">normalized_host</span>[<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-value">-1</span>]
- 989:         <span class="ruby-keyword kw">end</span>
- 990:       <span class="ruby-keyword kw">end</span>
- 991:
- 992:       <span class="ruby-identifier">normalized_port</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">port</span>
- 993:       <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">scheme_mapping</span>[<span class="ruby-identifier">normalized_scheme</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">normalized_port</span>
- 994:         <span class="ruby-identifier">normalized_port</span> = <span class="ruby-keyword kw">nil</span>
- 995:       <span class="ruby-keyword kw">end</span>
- 996:       <span class="ruby-identifier">normalized_path</span> = <span class="ruby-keyword kw">nil</span>
- 997:       <span class="ruby-identifier">normalized_path</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">path</span>.<span class="ruby-identifier">strip</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">path</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
- 998:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_path</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
- 999:         <span class="ruby-identifier">normalized_path</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">normalized_path</span>)
-1000:       <span class="ruby-keyword kw">end</span>
-1001:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_path</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;&quot;</span>
-1002:         <span class="ruby-keyword kw">if</span> [<span class="ruby-value str">&quot;http&quot;</span>, <span class="ruby-value str">&quot;https&quot;</span>, <span class="ruby-value str">&quot;ftp&quot;</span>, <span class="ruby-value str">&quot;tftp&quot;</span>].<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">normalized_scheme</span>)
-1003:           <span class="ruby-identifier">normalized_path</span> = <span class="ruby-value str">&quot;/&quot;</span>
-1004:         <span class="ruby-keyword kw">end</span>
-1005:       <span class="ruby-keyword kw">end</span>
-1006:
-1007:       <span class="ruby-identifier">normalized_query</span> = <span class="ruby-keyword kw">nil</span>
-1008:       <span class="ruby-identifier">normalized_query</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">query</span>.<span class="ruby-identifier">strip</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">query</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-1009:
-1010:       <span class="ruby-identifier">normalized_fragment</span> = <span class="ruby-keyword kw">nil</span>
-1011:       <span class="ruby-identifier">normalized_fragment</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">fragment</span>.<span class="ruby-identifier">strip</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">fragment</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-1012:       <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span>(
-1013:         <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>.<span class="ruby-identifier">normalized_encode</span>(<span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>.<span class="ruby-identifier">new</span>(
-1014:           <span class="ruby-identifier">normalized_scheme</span>,
-1015:           <span class="ruby-identifier">normalized_user</span>,
-1016:           <span class="ruby-identifier">normalized_password</span>,
-1017:           <span class="ruby-identifier">normalized_host</span>,
-1018:           <span class="ruby-identifier">normalized_port</span>,
-1019:           <span class="ruby-identifier">normalized_path</span>,
-1020:           <span class="ruby-identifier">normalized_query</span>,
-1021:           <span class="ruby-identifier">normalized_fragment</span>
-1022:         )))
-1023:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000049" class="method-detail">
-        <a name="M000049"></a>
-        <div class="method-heading">
-          <a href="#M000049" class="method-signature">
-          <span class="method-name">normalize!</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Destructively normalizes this <a href="URI.html">URI</a> object.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000049-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000049-source">
-<pre>
-      <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 1026</span>
-1026:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">normalize!</span>
-1027:       <span class="ruby-identifier">replace_self</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">normalize</span>)
-1028:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000017" class="method-detail">
-        <a name="M000017"></a>
-        <div class="method-heading">
-          <a href="#M000017" class="method-signature">
-          <span class="method-name">password</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the <a href="URI.html#M000017">password</a> for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000017-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000017-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 547</span>
-547:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">password</span>
-548:       <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@password</span>
-549:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000018" class="method-detail">
-        <a name="M000018"></a>
-        <div class="method-heading">
-          <a href="#M000018" class="method-signature">
-          <span class="method-name">password=</span><span class="method-args">(new_password)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Sets the <a href="URI.html#M000017">password</a> for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000018-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000018-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 552</span>
-552:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">password=</span>(<span class="ruby-identifier">new_password</span>)
-553:       <span class="ruby-ivar">@password</span> = <span class="ruby-identifier">new_password</span>
-554:
-555:       <span class="ruby-comment cmt"># You can't have a nil user with a non-nil password</span>
-556:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@password</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-557:         <span class="ruby-ivar">@user</span> = <span class="ruby-value str">&quot;&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@user</span>.<span class="ruby-identifier">nil?</span>
-558:       <span class="ruby-keyword kw">end</span>
-559:
-560:       <span class="ruby-comment cmt"># Reset dependant values</span>
-561:       <span class="ruby-ivar">@userinfo</span> = <span class="ruby-keyword kw">nil</span>
-562:       <span class="ruby-ivar">@authority</span> = <span class="ruby-keyword kw">nil</span>
-563:
-564:       <span class="ruby-comment cmt"># Ensure we haven't created an invalid URI</span>
-565:       <span class="ruby-identifier">validate</span>()
-566:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000030" class="method-detail">
-        <a name="M000030"></a>
-        <div class="method-heading">
-          <a href="#M000030" class="method-signature">
-          <span class="method-name">path</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the <a href="URI.html#M000030">path</a> for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000030-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000030-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 724</span>
-724:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">path</span>
-725:       <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@path</span>
-726:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000031" class="method-detail">
-        <a name="M000031"></a>
-        <div class="method-heading">
-          <a href="#M000031" class="method-signature">
-          <span class="method-name">path=</span><span class="method-args">(new_path)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Sets the <a href="URI.html#M000030">path</a> for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000031-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000031-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 729</span>
-729:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">path=</span>(<span class="ruby-identifier">new_path</span>)
-730:       <span class="ruby-ivar">@path</span> = (<span class="ruby-identifier">new_path</span> <span class="ruby-operator">||</span> <span class="ruby-value str">&quot;&quot;</span>)
-731:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000027" class="method-detail">
-        <a name="M000027"></a>
-        <div class="method-heading">
-          <a href="#M000027" class="method-signature">
-          <span class="method-name">port</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the <a href="URI.html#M000027">port</a> number for this <a
-href="URI.html">URI</a>. This method will <a
-href="URI.html#M000048">normalize</a> to the default <a
-href="URI.html#M000027">port</a> for the <a href="URI.html">URI</a>&#8216;s
-<a href="URI.html#M000013">scheme</a> if the <a
-href="URI.html#M000027">port</a> isn&#8216;t explicitly specified in the <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000027-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000027-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 692</span>
-692:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">port</span>
-693:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@port</span>.<span class="ruby-identifier">to_i</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-694:         <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span>
-695:           <span class="ruby-ivar">@port</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">scheme_mapping</span>[<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">downcase</span>]
-696:         <span class="ruby-keyword kw">else</span>
-697:           <span class="ruby-ivar">@port</span> = <span class="ruby-keyword kw">nil</span>
-698:         <span class="ruby-keyword kw">end</span>
-699:         <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@port</span>
-700:       <span class="ruby-keyword kw">else</span>
-701:         <span class="ruby-ivar">@port</span> = <span class="ruby-ivar">@port</span>.<span class="ruby-identifier">to_i</span>
-702:         <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@port</span>
-703:       <span class="ruby-keyword kw">end</span>
-704:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000028" class="method-detail">
-        <a name="M000028"></a>
-        <div class="method-heading">
-          <a href="#M000028" class="method-signature">
-          <span class="method-name">port=</span><span class="method-args">(new_port)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Sets the <a href="URI.html#M000027">port</a> for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000028-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000028-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 707</span>
-707:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">port=</span>(<span class="ruby-identifier">new_port</span>)
-708:       <span class="ruby-ivar">@port</span> = <span class="ruby-identifier">new_port</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_i</span>
-709:       <span class="ruby-ivar">@specified_port</span> = <span class="ruby-ivar">@port</span>
-710:       <span class="ruby-ivar">@authority</span> = <span class="ruby-keyword kw">nil</span>
-711:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000034" class="method-detail">
-        <a name="M000034"></a>
-        <div class="method-heading">
-          <a href="#M000034" class="method-signature">
-          <span class="method-name">query</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the <a href="URI.html#M000034">query</a> string for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000034-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000034-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 749</span>
-749:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">query</span>
-750:       <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@query</span>
-751:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000035" class="method-detail">
-        <a name="M000035"></a>
-        <div class="method-heading">
-          <a href="#M000035" class="method-signature">
-          <span class="method-name">query=</span><span class="method-args">(new_query)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Sets the <a href="URI.html#M000034">query</a> string for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000035-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000035-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 754</span>
-754:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">query=</span>(<span class="ruby-identifier">new_query</span>)
-755:       <span class="ruby-ivar">@query</span> = <span class="ruby-identifier">new_query</span>
-756:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000039" class="method-detail">
-        <a name="M000039"></a>
-        <div class="method-heading">
-          <a href="#M000039" class="method-signature">
-          <span class="method-name">relative?</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns true if this <a href="URI.html">URI</a> is known to be relative.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000039-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000039-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 778</span>
-778:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">relative?</span>
-779:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span>.<span class="ruby-identifier">nil?</span>
-780:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000046" class="method-detail">
-        <a name="M000046"></a>
-        <div class="method-heading">
-          <a href="#M000046" class="method-signature">
-          <span class="method-name">route_from</span><span class="method-args">(uri)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the shortest normalized relative form of this <a
-href="URI.html">URI</a> that uses the supplied <a href="URI.html">URI</a>
-as a base for resolution. Returns an absolute <a href="URI.html">URI</a> if
-necessary.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000046-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000046-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 893</span>
-893:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">route_from</span>(<span class="ruby-identifier">uri</span>)
-894:       <span class="ruby-identifier">uri</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">uri</span>).<span class="ruby-identifier">normalize</span>
-895:       <span class="ruby-identifier">normalized_self</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">normalize</span>
-896:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_self</span>.<span class="ruby-identifier">relative?</span>
-897:         <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;Expected absolute URI, got: #{self.to_s}&quot;</span>
-898:       <span class="ruby-keyword kw">end</span>
-899:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">relative?</span>
-900:         <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;Expected absolute URI, got: #{uri.to_s}&quot;</span>
-901:       <span class="ruby-keyword kw">end</span>
-902:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_self</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">uri</span>
-903:         <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-node">&quot;##{normalized_self.fragment}&quot;</span>)
-904:       <span class="ruby-keyword kw">end</span>
-905:       <span class="ruby-identifier">segments</span> = <span class="ruby-identifier">normalized_self</span>.<span class="ruby-identifier">to_hash</span>
-906:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_self</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">scheme</span>
-907:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:scheme</span>] = <span class="ruby-keyword kw">nil</span>
-908:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_self</span>.<span class="ruby-identifier">authority</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">authority</span>
-909:           <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:user</span>] = <span class="ruby-keyword kw">nil</span>
-910:           <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:password</span>] = <span class="ruby-keyword kw">nil</span>
-911:           <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:host</span>] = <span class="ruby-keyword kw">nil</span>
-912:           <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:port</span>] = <span class="ruby-keyword kw">nil</span>
-913:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_self</span>.<span class="ruby-identifier">path</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">path</span>
-914:             <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:path</span>] = <span class="ruby-keyword kw">nil</span>
-915:             <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">normalized_self</span>.<span class="ruby-identifier">query</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">query</span>
-916:               <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:query</span>] = <span class="ruby-keyword kw">nil</span>
-917:             <span class="ruby-keyword kw">end</span>
-918:           <span class="ruby-keyword kw">else</span>
-919:             <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">path</span> <span class="ruby-operator">!=</span> <span class="ruby-value str">&quot;/&quot;</span>
-920:               <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:path</span>].<span class="ruby-identifier">gsub!</span>(
-921:                 <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">&quot;^&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">escape</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">path</span>)), <span class="ruby-value str">&quot;&quot;</span>)
-922:             <span class="ruby-keyword kw">end</span>
-923:           <span class="ruby-keyword kw">end</span>
-924:         <span class="ruby-keyword kw">end</span>
-925:       <span class="ruby-keyword kw">end</span>
-926:       <span class="ruby-comment cmt"># Avoid network-path references.</span>
-927:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:host</span>] <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-928:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:scheme</span>] = <span class="ruby-identifier">normalized_self</span>.<span class="ruby-identifier">scheme</span>
-929:       <span class="ruby-keyword kw">end</span>
-930:       <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Addressable</span><span class="ruby-operator">::</span><span class="ruby-constant">URI</span>.<span class="ruby-identifier">new</span>(
-931:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:scheme</span>],
-932:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:user</span>],
-933:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:password</span>],
-934:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:host</span>],
-935:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:port</span>],
-936:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:path</span>],
-937:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:query</span>],
-938:         <span class="ruby-identifier">segments</span>[<span class="ruby-identifier">:fragment</span>]
-939:       )
-940:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000047" class="method-detail">
-        <a name="M000047"></a>
-        <div class="method-heading">
-          <a href="#M000047" class="method-signature">
-          <span class="method-name">route_to</span><span class="method-args">(uri)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the shortest normalized relative form of the supplied <a
-href="URI.html">URI</a> that uses this <a href="URI.html">URI</a> as a base
-for resolution. Returns an absolute <a href="URI.html">URI</a> if
-necessary.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000047-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000047-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 945</span>
-945:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">route_to</span>(<span class="ruby-identifier">uri</span>)
-946:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">uri</span>).<span class="ruby-identifier">route_from</span>(<span class="ruby-keyword kw">self</span>)
-947:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000013" class="method-detail">
-        <a name="M000013"></a>
-        <div class="method-heading">
-          <a href="#M000013" class="method-signature">
-          <span class="method-name">scheme</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the <a href="URI.html#M000013">scheme</a> (protocol) for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000013-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000013-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 515</span>
-515:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">scheme</span>
-516:       <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@scheme</span>
-517:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000014" class="method-detail">
-        <a name="M000014"></a>
-        <div class="method-heading">
-          <a href="#M000014" class="method-signature">
-          <span class="method-name">scheme=</span><span class="method-args">(new_scheme)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Sets the <a href="URI.html#M000013">scheme</a> (protocol for this <a
-href="URI.html">URI</a>.)
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000014-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000014-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 520</span>
-520:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">scheme=</span>(<span class="ruby-identifier">new_scheme</span>)
-521:       <span class="ruby-ivar">@scheme</span> = <span class="ruby-identifier">new_scheme</span>
-522:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000029" class="method-detail">
-        <a name="M000029"></a>
-        <div class="method-heading">
-          <a href="#M000029" class="method-signature">
-          <span class="method-name">specified_port</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the <a href="URI.html#M000027">port</a> number that was actually
-specified in the <a href="URI.html">URI</a> string.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000029-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000029-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 714</span>
-714:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">specified_port</span>
-715:       <span class="ruby-identifier">port</span> = <span class="ruby-ivar">@specified_port</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_i</span>
-716:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">port</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-717:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
-718:       <span class="ruby-keyword kw">else</span>
-719:         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">port</span>
-720:       <span class="ruby-keyword kw">end</span>
-721:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000056" class="method-detail">
-        <a name="M000056"></a>
-        <div class="method-heading">
-          <a href="#M000056" class="method-signature">
-          <span class="method-name">to_hash</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns a Hash of the <a href="URI.html">URI</a> segments.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000056-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000056-source">
-<pre>
-      <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 1109</span>
-1109:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_hash</span>
-1110:       <span class="ruby-keyword kw">return</span> {
-1111:         <span class="ruby-identifier">:scheme</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span>,
-1112:         <span class="ruby-identifier">:user</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">user</span>,
-1113:         <span class="ruby-identifier">:password</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">password</span>,
-1114:         <span class="ruby-identifier">:host</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">host</span>,
-1115:         <span class="ruby-identifier">:port</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">specified_port</span>,
-1116:         <span class="ruby-identifier">:path</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">path</span>,
-1117:         <span class="ruby-identifier">:query</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">query</span>,
-1118:         <span class="ruby-identifier">:fragment</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">fragment</span>
-1119:       }
-1120:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000055" class="method-detail">
-        <a name="M000055"></a>
-        <div class="method-heading">
-          <a href="#M000055" class="method-signature">
-          <span class="method-name">to_s</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the assembled <a href="URI.html">URI</a> as a string.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000055-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000055-source">
-<pre>
-      <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 1098</span>
-1098:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_s</span>
-1099:       <span class="ruby-identifier">uri_string</span> = <span class="ruby-value str">&quot;&quot;</span>
-1100:       <span class="ruby-identifier">uri_string</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;#{self.scheme}:&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">scheme</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-1101:       <span class="ruby-identifier">uri_string</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;//#{self.authority}&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">authority</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-1102:       <span class="ruby-identifier">uri_string</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">path</span>.<span class="ruby-identifier">to_s</span>
-1103:       <span class="ruby-identifier">uri_string</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;?#{self.query}&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">query</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-1104:       <span class="ruby-identifier">uri_string</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;##{self.fragment}&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">fragment</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-1105:       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">uri_string</span>
-1106:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000015" class="method-detail">
-        <a name="M000015"></a>
-        <div class="method-heading">
-          <a href="#M000015" class="method-signature">
-          <span class="method-name">user</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the <a href="URI.html#M000015">user</a> for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000015-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000015-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 525</span>
-525:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">user</span>
-526:       <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@user</span>
-527:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000016" class="method-detail">
-        <a name="M000016"></a>
-        <div class="method-heading">
-          <a href="#M000016" class="method-signature">
-          <span class="method-name">user=</span><span class="method-args">(new_user)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Sets the <a href="URI.html#M000015">user</a> for this <a
-href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000016-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000016-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 530</span>
-530:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">user=</span>(<span class="ruby-identifier">new_user</span>)
-531:       <span class="ruby-ivar">@user</span> = <span class="ruby-identifier">new_user</span>
-532:
-533:       <span class="ruby-comment cmt"># You can't have a nil user with a non-nil password</span>
-534:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@password</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-535:         <span class="ruby-ivar">@user</span> = <span class="ruby-value str">&quot;&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@user</span>.<span class="ruby-identifier">nil?</span>
-536:       <span class="ruby-keyword kw">end</span>
-537:
-538:       <span class="ruby-comment cmt"># Reset dependant values</span>
-539:       <span class="ruby-ivar">@userinfo</span> = <span class="ruby-keyword kw">nil</span>
-540:       <span class="ruby-ivar">@authority</span> = <span class="ruby-keyword kw">nil</span>
-541:
-542:       <span class="ruby-comment cmt"># Ensure we haven't created an invalid URI</span>
-543:       <span class="ruby-identifier">validate</span>()
-544:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000019" class="method-detail">
-        <a name="M000019"></a>
-        <div class="method-heading">
-          <a href="#M000019" class="method-signature">
-          <span class="method-name">userinfo</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the username and <a href="URI.html#M000017">password</a> segment of
-this <a href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000019-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000019-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 569</span>
-569:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">userinfo</span>
-570:       <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-ivar">@userinfo</span>) <span class="ruby-operator">||</span> <span class="ruby-ivar">@userinfo</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
-571:         <span class="ruby-identifier">current_user</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">user</span>
-572:         <span class="ruby-identifier">current_password</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">password</span>
-573:         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">current_user</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-identifier">current_password</span>
-574:           <span class="ruby-ivar">@userinfo</span> = <span class="ruby-keyword kw">nil</span>
-575:         <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">current_user</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">current_password</span>
-576:           <span class="ruby-ivar">@userinfo</span> = <span class="ruby-node">&quot;#{current_user}:#{current_password}&quot;</span>
-577:         <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">current_user</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-identifier">current_password</span>
-578:           <span class="ruby-ivar">@userinfo</span> = <span class="ruby-node">&quot;#{current_user}&quot;</span>
-579:         <span class="ruby-keyword kw">end</span>
-580:       <span class="ruby-keyword kw">end</span>
-581:       <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@userinfo</span>
-582:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000020" class="method-detail">
-        <a name="M000020"></a>
-        <div class="method-heading">
-          <a href="#M000020" class="method-signature">
-          <span class="method-name">userinfo=</span><span class="method-args">(new_userinfo)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Sets the username and <a href="URI.html#M000017">password</a> segment of
-this <a href="URI.html">URI</a>.
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000020-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000020-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/addressable/uri.rb, line 585</span>
-585:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">userinfo=</span>(<span class="ruby-identifier">new_userinfo</span>)
-586:       <span class="ruby-identifier">new_user</span> = <span class="ruby-identifier">new_userinfo</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/^(.*):/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
-587:       <span class="ruby-identifier">new_password</span> = <span class="ruby-identifier">new_userinfo</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp re">/:(.*)$/</span>).<span class="ruby-identifier">flatten</span>[<span class="ruby-value">0</span>]
-588:
-589:       <span class="ruby-comment cmt"># Password assigned first to ensure validity in case of nil</span>
-590:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">password</span> = <span class="ruby-identifier">new_password</span>
-591:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">user</span> = <span class="ruby-identifier">new_user</span>
-592:
-593:       <span class="ruby-comment cmt"># Reset dependant values</span>
-594:       <span class="ruby-ivar">@authority</span> = <span class="ruby-keyword kw">nil</span>
-595:
-596:       <span class="ruby-comment cmt"># Ensure we haven't created an invalid URI</span>
-597:       <span class="ruby-identifier">validate</span>()
-598:     <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>