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

addressable 1.0.2 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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>