addressable 0.1.0 → 0.1.1

Sign up to get free protection for your applications and to get access to all the features.
data/CHANGELOG CHANGED
@@ -1,3 +1,7 @@
1
+ === Addressable 0.1.1
2
+ * updated documentation
3
+ * added URI Template variable extraction
4
+
1
5
  === Addressable 0.1.0
2
6
  * initial release
3
7
  * implementation based on RFC 3986, 3987
data/README CHANGED
@@ -1,3 +1,24 @@
1
1
  Addressable is a replacement for the URI implementation that is part of
2
2
  Ruby's standard library. It more closely conforms to the relevant RFCs and
3
3
  adds support for IRIs and URI templates.
4
+
5
+ Example usage:
6
+
7
+ require 'addressable/uri'
8
+
9
+ uri = Addressable::URI.parse("http://example.com/path/to/resource/")
10
+ uri.scheme
11
+ => "http"
12
+ uri.host
13
+ => "example.com"
14
+ uri.path
15
+ => "/path/to/resource/"
16
+
17
+ Addressable::URI.expand_template("http://example.com/{query}/", {
18
+ "query" => "an+example+query"
19
+ })
20
+ => #<Addressable::URI:0x123456 URI:http://example.com/an+example+query/>
21
+
22
+ uri = Addressable::URI.parse("http://www.詹姆斯.com/")
23
+ uri.normalize
24
+ => #<Addressable::URI:0x654321 URI:http://www.xn--8ws00zhy3a.com/>
@@ -151,7 +151,7 @@ table.report tr.dark {
151
151
  </head>
152
152
  <body>
153
153
  <h3>C0 code coverage information</h3>
154
- <p>Generated on Wed Sep 05 00:27:38 -0400 2007 with <a href='http://eigenclass.org/hiki.rb?rcov'>rcov 0.8.0</a>
154
+ <p>Generated on Wed Sep 05 16:05:30 -0400 2007 with <a href='http://eigenclass.org/hiki.rb?rcov'>rcov 0.8.0</a>
155
155
  </p>
156
156
  <hr /> <table class='report'>
157
157
  <thead>
@@ -167,10 +167,10 @@ table.report tr.dark {
167
167
  <tr class='light'>
168
168
  <td>TOTAL</td>
169
169
  <td class='lines_total'>
170
- <tt>1092</tt>
170
+ <tt>1207</tt>
171
171
  </td>
172
172
  <td class='lines_code'>
173
- <tt>805</tt>
173
+ <tt>852</tt>
174
174
  </td>
175
175
  <td>
176
176
  <table cellspacing='0' cellpadding='0' align='right'>
@@ -210,10 +210,53 @@ table.report tr.dark {
210
210
  <a href='lib-addressable-uri_rb.html'>lib/addressable/uri.rb</a>
211
211
  </td>
212
212
  <td class='lines_total'>
213
- <tt>1092</tt>
213
+ <tt>1175</tt>
214
214
  </td>
215
215
  <td class='lines_code'>
216
- <tt>805</tt>
216
+ <tt>844</tt>
217
+ </td>
218
+ <td>
219
+ <table cellspacing='0' cellpadding='0' align='right'>
220
+ <tr>
221
+ <td>
222
+ <tt class='coverage_total'>100.0%</tt>&nbsp;</td>
223
+ <td>
224
+ <table cellspacing='0' class='percent_graph' cellpadding='0' width='100'>
225
+ <tr>
226
+ <td class='covered' width='100' />
227
+ <td class='uncovered' width='0' />
228
+ </tr>
229
+ </table>
230
+ </td>
231
+ </tr>
232
+ </table>
233
+ </td>
234
+ <td>
235
+ <table cellspacing='0' cellpadding='0' align='right'>
236
+ <tr>
237
+ <td>
238
+ <tt class='coverage_code'>100.0%</tt>&nbsp;</td>
239
+ <td>
240
+ <table cellspacing='0' class='percent_graph' cellpadding='0' width='100'>
241
+ <tr>
242
+ <td class='covered' width='100' />
243
+ <td class='uncovered' width='0' />
244
+ </tr>
245
+ </table>
246
+ </td>
247
+ </tr>
248
+ </table>
249
+ </td>
250
+ </tr>
251
+ <tr class='light'>
252
+ <td>
253
+ <a href='lib-addressable-version_rb.html'>lib/addressable/version.rb</a>
254
+ </td>
255
+ <td class='lines_total'>
256
+ <tt>32</tt>
257
+ </td>
258
+ <td class='lines_code'>
259
+ <tt>8</tt>
217
260
  </td>
218
261
  <td>
219
262
  <table cellspacing='0' cellpadding='0' align='right'>
@@ -556,7 +556,7 @@ span.run100 {
556
556
  </head>
557
557
  <body>
558
558
  <h3>C0 code coverage information</h3>
559
- <p>Generated on Wed Sep 05 00:27:42 -0400 2007 with <a href='http://eigenclass.org/hiki.rb?rcov'>rcov 0.8.0</a>
559
+ <p>Generated on Wed Sep 05 16:05:34 -0400 2007 with <a href='http://eigenclass.org/hiki.rb?rcov'>rcov 0.8.0</a>
560
560
  </p>
561
561
  <hr /><pre><span class='marked0'>Code reported as executed by Ruby looks like this...
562
562
  </span><span class='marked1'>and this: this line is also marked as covered.
@@ -580,10 +580,10 @@ span.run100 {
580
580
  <a href='lib-addressable-uri_rb.html'>lib/addressable/uri.rb</a>
581
581
  </td>
582
582
  <td class='lines_total'>
583
- <tt>1092</tt>
583
+ <tt>1175</tt>
584
584
  </td>
585
585
  <td class='lines_code'>
586
- <tt>805</tt>
586
+ <tt>844</tt>
587
587
  </td>
588
588
  <td>
589
589
  <table cellspacing='0' cellpadding='0' align='right'>
@@ -642,1075 +642,1158 @@ span.run100 {
642
642
  </span><span class="inferred1"><a name="line21" /> 21 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
643
643
  </span><span class="inferred0"><a name="line22" /> 22 #++
644
644
  </span><span class="inferred1"><a name="line23" /> 23
645
- </span><span class="marked0"><a name="line24" /> 24 module Addressable
646
- </span><span class="inferred1"><a name="line25" /> 25 # This is an implementation of a URI parser based on RFC 3986.
647
- </span><span class="marked0"><a name="line26" /> 26 class URI
648
- </span><span class="inferred1"><a name="line27" /> 27 # Raised if something other than a uri is supplied.
649
- </span><span class="marked0"><a name="line28" /> 28 class InvalidURIError &lt; StandardError
650
- </span><span class="inferred1"><a name="line29" /> 29 end
651
- </span><span class="inferred0"><a name="line30" /> 30
652
- </span><span class="inferred1"><a name="line31" /> 31 # Raised if an invalid method option is supplied.
653
- </span><span class="marked0"><a name="line32" /> 32 class InvalidOptionError &lt; StandardError
654
- </span><span class="inferred1"><a name="line33" /> 33 end
655
- </span><span class="inferred0"><a name="line34" /> 34
656
- </span><span class="inferred1"><a name="line35" /> 35 # Raised if an invalid method option is supplied.
657
- </span><span class="marked0"><a name="line36" /> 36 class InvalidTemplateValue &lt; StandardError
658
- </span><span class="inferred1"><a name="line37" /> 37 end
659
- </span><span class="inferred0"><a name="line38" /> 38
660
- </span><span class="marked1"><a name="line39" /> 39 module CharacterClasses
661
- </span><span class="marked0"><a name="line40" /> 40 ALPHA = &quot;a-zA-Z&quot;
662
- </span><span class="marked1"><a name="line41" /> 41 DIGIT = &quot;0-9&quot;
663
- </span><span class="marked0"><a name="line42" /> 42 GEN_DELIMS = &quot;\\:\\/\\?\\#\\[\\]\\@&quot;
664
- </span><span class="marked1"><a name="line43" /> 43 SUB_DELIMS = &quot;\\!\\$\\&amp;\\'\\(\\)\\*\\+\\,\\;\\=&quot;
665
- </span><span class="marked0"><a name="line44" /> 44 RESERVED = GEN_DELIMS + SUB_DELIMS
666
- </span><span class="marked1"><a name="line45" /> 45 UNRESERVED = ALPHA + DIGIT + &quot;\\-\\.\\_\\~&quot;
667
- </span><span class="marked0"><a name="line46" /> 46 PCHAR = UNRESERVED + SUB_DELIMS + &quot;\\:\\@&quot;
668
- </span><span class="marked1"><a name="line47" /> 47 SCHEME = ALPHA + DIGIT + &quot;\\-\\+\\.&quot;
669
- </span><span class="marked0"><a name="line48" /> 48 AUTHORITY = PCHAR
670
- </span><span class="marked1"><a name="line49" /> 49 PATH = PCHAR + &quot;\\/&quot;
671
- </span><span class="marked0"><a name="line50" /> 50 QUERY = PCHAR + &quot;\\/\\?&quot;
672
- </span><span class="marked1"><a name="line51" /> 51 FRAGMENT = PCHAR + &quot;\\/\\?&quot;
673
- </span><span class="inferred0"><a name="line52" /> 52 end
674
- </span><span class="inferred1"><a name="line53" /> 53
675
- </span><span class="inferred0"><a name="line54" /> 54 # Returns a URI object based on the parsed string.
676
- </span><span class="marked1"><a name="line55" /> 55 def self.parse(uri_string)
677
- </span><span class="marked0"><a name="line56" /> 56 return nil if uri_string.nil?
678
- </span><span class="inferred1"><a name="line57" /> 57
679
- </span><span class="inferred0"><a name="line58" /> 58 # If a URI object is passed, just return itself.
680
- </span><span class="marked1"><a name="line59" /> 59 return uri_string if uri_string.kind_of?(self)
681
- </span><span class="inferred0"><a name="line60" /> 60
682
- </span><span class="inferred1"><a name="line61" /> 61 # If a URI object of the Ruby standard library variety is passed,
683
- </span><span class="inferred0"><a name="line62" /> 62 # convert it to a string, then parse the string.
684
- </span><span class="marked1"><a name="line63" /> 63 if uri_string.class.name =~ /^URI::/
685
- </span><span class="inferred0"><a name="line64" /> 64 uri_string = uri_string.to_s
686
- </span><span class="inferred1"><a name="line65" /> 65 end
687
- </span><span class="inferred0"><a name="line66" /> 66
688
- </span><span class="marked1"><a name="line67" /> 67 uri_regex =
689
- </span><span class="inferred0"><a name="line68" /> 68 /^(([^:\/?#]+):)?(\/\/([^\/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?/
690
- </span><span class="marked1"><a name="line69" /> 69 scan = uri_string.scan(uri_regex)
691
- </span><span class="marked0"><a name="line70" /> 70 fragments = scan[0]
692
- </span><span class="marked1"><a name="line71" /> 71 return nil if fragments.nil?
693
- </span><span class="marked0"><a name="line72" /> 72 scheme = fragments[1]
694
- </span><span class="marked1"><a name="line73" /> 73 authority = fragments[3]
695
- </span><span class="marked0"><a name="line74" /> 74 path = fragments[4]
696
- </span><span class="marked1"><a name="line75" /> 75 query = fragments[6]
697
- </span><span class="marked0"><a name="line76" /> 76 fragment = fragments[8]
698
- </span><span class="marked1"><a name="line77" /> 77 userinfo = nil
699
- </span><span class="marked0"><a name="line78" /> 78 user = nil
700
- </span><span class="marked1"><a name="line79" /> 79 password = nil
701
- </span><span class="marked0"><a name="line80" /> 80 host = nil
702
- </span><span class="marked1"><a name="line81" /> 81 port = nil
703
- </span><span class="marked0"><a name="line82" /> 82 if authority != nil
704
- </span><span class="marked1"><a name="line83" /> 83 userinfo = authority.scan(/^([^\[\]]*)@/).flatten[0]
705
- </span><span class="marked0"><a name="line84" /> 84 if userinfo != nil
706
- </span><span class="marked1"><a name="line85" /> 85 user = userinfo.strip.scan(/^([^:]*):?/).flatten[0]
707
- </span><span class="marked0"><a name="line86" /> 86 password = userinfo.strip.scan(/:(.*)$/).flatten[0]
708
- </span><span class="inferred1"><a name="line87" /> 87 end
709
- </span><span class="marked0"><a name="line88" /> 88 host = authority.gsub(/^([^\[\]]*)@/, &quot;&quot;).gsub(/:([^:@\[\]]*?)$/, &quot;&quot;)
710
- </span><span class="marked1"><a name="line89" /> 89 port = authority.scan(/:([^:@\[\]]*?)$/).flatten[0]
711
- </span><span class="inferred0"><a name="line90" /> 90 end
712
- </span><span class="marked1"><a name="line91" /> 91 if port.nil? || port == &quot;&quot;
713
- </span><span class="marked0"><a name="line92" /> 92 port = nil
714
- </span><span class="inferred1"><a name="line93" /> 93 end
715
- </span><span class="inferred0"><a name="line94" /> 94
716
- </span><span class="inferred1"><a name="line95" /> 95 # WARNING: Not standards-compliant, but follows the theme
717
- </span><span class="inferred0"><a name="line96" /> 96 # of Postel's law:
718
- </span><span class="inferred1"><a name="line97" /> 97 #
719
- </span><span class="inferred0"><a name="line98" /> 98 # Special exception for dealing with the retarded idea of the
720
- </span><span class="inferred1"><a name="line99" /> 99 # feed pseudo-protocol. Without this exception, the parser will read
721
- </span><span class="inferred0"><a name="line100" /> 100 # the URI as having a blank port number, instead of as having a second
722
- </span><span class="inferred1"><a name="line101" /> 101 # URI embedded within. This exception translates these broken URIs
723
- </span><span class="inferred0"><a name="line102" /> 102 # and instead treats the inner URI as opaque.
724
- </span><span class="marked1"><a name="line103" /> 103 if scheme == &quot;feed&quot; &amp;&amp; host == &quot;http&quot;
725
- </span><span class="marked0"><a name="line104" /> 104 userinfo = nil
726
- </span><span class="marked1"><a name="line105" /> 105 user = nil
727
- </span><span class="marked0"><a name="line106" /> 106 password = nil
728
- </span><span class="marked1"><a name="line107" /> 107 host = nil
729
- </span><span class="marked0"><a name="line108" /> 108 port = nil
730
- </span><span class="marked1"><a name="line109" /> 109 path = authority + path
731
- </span><span class="inferred0"><a name="line110" /> 110 end
732
- </span><span class="inferred1"><a name="line111" /> 111
733
- </span><span class="marked0"><a name="line112" /> 112 return Addressable::URI.new(
734
- </span><span class="marked1"><a name="line113" /> 113 scheme, user, password, host, port, path, query, fragment)
735
- </span><span class="inferred0"><a name="line114" /> 114 end
736
- </span><span class="inferred1"><a name="line115" /> 115
737
- </span><span class="inferred0"><a name="line116" /> 116 # Converts a path to a file protocol URI. If the path supplied is
738
- </span><span class="inferred1"><a name="line117" /> 117 # relative, it will be returned as a relative URI. If the path supplied
739
- </span><span class="inferred0"><a name="line118" /> 118 # is actually a URI, it will return the parsed URI.
740
- </span><span class="marked1"><a name="line119" /> 119 def self.convert_path(path)
741
- </span><span class="marked0"><a name="line120" /> 120 return nil if path.nil?
742
- </span><span class="inferred1"><a name="line121" /> 121
743
- </span><span class="marked0"><a name="line122" /> 122 converted_uri = path.strip
744
- </span><span class="marked1"><a name="line123" /> 123 if converted_uri.length &gt; 0 &amp;&amp; converted_uri[0..0] == &quot;/&quot;
745
- </span><span class="marked0"><a name="line124" /> 124 converted_uri = &quot;file://&quot; + converted_uri
746
- </span><span class="inferred1"><a name="line125" /> 125 end
747
- </span><span class="inferred0"><a name="line126" /> 126 if converted_uri.length &gt; 0 &amp;&amp;
748
- </span><span class="marked1"><a name="line127" /> 127 converted_uri.scan(/^[a-zA-Z]:[\\\/]/).size &gt; 0
749
- </span><span class="marked0"><a name="line128" /> 128 converted_uri = &quot;file:///&quot; + converted_uri
750
- </span><span class="inferred1"><a name="line129" /> 129 end
751
- </span><span class="marked0"><a name="line130" /> 130 converted_uri.gsub!(/^file:\/*/i, &quot;file:///&quot;)
752
- </span><span class="marked1"><a name="line131" /> 131 if converted_uri =~ /^file:/i
753
- </span><span class="inferred0"><a name="line132" /> 132 # Adjust windows-style uris
754
- </span><span class="marked1"><a name="line133" /> 133 converted_uri.gsub!(/^file:\/\/\/([a-zA-Z])\|/i, 'file:///\1:')
755
- </span><span class="marked0"><a name="line134" /> 134 converted_uri.gsub!(/\\/, '/')
756
- </span><span class="marked1"><a name="line135" /> 135 converted_uri = self.parse(converted_uri).normalize
757
- </span><span class="marked0"><a name="line136" /> 136 if File.exists?(converted_uri.path) &amp;&amp;
758
- </span><span class="marked1"><a name="line137" /> 137 File.stat(converted_uri.path).directory?
759
- </span><span class="marked0"><a name="line138" /> 138 converted_uri.path.gsub!(/\/$/, &quot;&quot;)
760
- </span><span class="marked1"><a name="line139" /> 139 converted_uri.path = converted_uri.path + '/'
761
- </span><span class="inferred0"><a name="line140" /> 140 end
762
- </span><span class="inferred1"><a name="line141" /> 141 else
763
- </span><span class="marked0"><a name="line142" /> 142 converted_uri = self.parse(converted_uri)
764
- </span><span class="inferred1"><a name="line143" /> 143 end
765
- </span><span class="inferred0"><a name="line144" /> 144
766
- </span><span class="marked1"><a name="line145" /> 145 return converted_uri
767
- </span><span class="inferred0"><a name="line146" /> 146 end
768
- </span><span class="inferred1"><a name="line147" /> 147
769
- </span><span class="inferred0"><a name="line148" /> 148 # Expands a URI template into a full URI.
770
- </span><span class="inferred1"><a name="line149" /> 149 #
771
- </span><span class="inferred0"><a name="line150" /> 150 # An optional processor object may be supplied. The object should
772
- </span><span class="inferred1"><a name="line151" /> 151 # respond to either the :validate or :transform messages or both.
773
- </span><span class="inferred0"><a name="line152" /> 152 # Both the :validate and :transform methods should take two parameters:
774
- </span><span class="inferred1"><a name="line153" /> 153 # :name and :value. The :validate method should return true or false;
775
- </span><span class="inferred0"><a name="line154" /> 154 # true if the value of the variable is valid, false otherwise. The
776
- </span><span class="inferred1"><a name="line155" /> 155 # :transform method should return the transformed variable value as a
777
- </span><span class="inferred0"><a name="line156" /> 156 # string.
778
- </span><span class="inferred1"><a name="line157" /> 157 #
779
- </span><span class="inferred0"><a name="line158" /> 158 # An example:
780
- </span><span class="inferred1"><a name="line159" /> 159 #
781
- </span><span class="inferred0"><a name="line160" /> 160 # class ExampleProcessor
782
- </span><span class="inferred1"><a name="line161" /> 161 # def self.validate(name, value)
783
- </span><span class="inferred0"><a name="line162" /> 162 # return !!(value =~ /^[\w ]+$/) if name == &quot;query&quot;
784
- </span><span class="inferred1"><a name="line163" /> 163 # return true
785
- </span><span class="inferred0"><a name="line164" /> 164 # end
786
- </span><span class="inferred1"><a name="line165" /> 165 #
787
- </span><span class="inferred0"><a name="line166" /> 166 # def self.transform(name, value)
788
- </span><span class="inferred1"><a name="line167" /> 167 # return value.gsub(/ /, &quot;+&quot;) if name == &quot;query&quot;
789
- </span><span class="inferred0"><a name="line168" /> 168 # return value
645
+ </span><span class="marked0"><a name="line24" /> 24 $:.unshift(File.expand_path(File.join(File.dirname(__FILE__), '/..')))
646
+ </span><span class="marked1"><a name="line25" /> 25 $:.uniq!
647
+ </span><span class="inferred0"><a name="line26" /> 26
648
+ </span><span class="marked1"><a name="line27" /> 27 require 'addressable/version'
649
+ </span><span class="inferred0"><a name="line28" /> 28
650
+ </span><span class="marked1"><a name="line29" /> 29 module Addressable
651
+ </span><span class="inferred0"><a name="line30" /> 30 # This is an implementation of a URI parser based on RFC 3986.
652
+ </span><span class="marked1"><a name="line31" /> 31 class URI
653
+ </span><span class="inferred0"><a name="line32" /> 32 # Raised if something other than a uri is supplied.
654
+ </span><span class="marked1"><a name="line33" /> 33 class InvalidURIError &lt; StandardError
655
+ </span><span class="inferred0"><a name="line34" /> 34 end
656
+ </span><span class="inferred1"><a name="line35" /> 35
657
+ </span><span class="inferred0"><a name="line36" /> 36 # Raised if an invalid method option is supplied.
658
+ </span><span class="marked1"><a name="line37" /> 37 class InvalidOptionError &lt; StandardError
659
+ </span><span class="inferred0"><a name="line38" /> 38 end
660
+ </span><span class="inferred1"><a name="line39" /> 39
661
+ </span><span class="inferred0"><a name="line40" /> 40 # Raised if an invalid method option is supplied.
662
+ </span><span class="marked1"><a name="line41" /> 41 class InvalidTemplateValue &lt; StandardError
663
+ </span><span class="inferred0"><a name="line42" /> 42 end
664
+ </span><span class="inferred1"><a name="line43" /> 43
665
+ </span><span class="marked0"><a name="line44" /> 44 module CharacterClasses
666
+ </span><span class="marked1"><a name="line45" /> 45 ALPHA = &quot;a-zA-Z&quot;
667
+ </span><span class="marked0"><a name="line46" /> 46 DIGIT = &quot;0-9&quot;
668
+ </span><span class="marked1"><a name="line47" /> 47 GEN_DELIMS = &quot;\\:\\/\\?\\#\\[\\]\\@&quot;
669
+ </span><span class="marked0"><a name="line48" /> 48 SUB_DELIMS = &quot;\\!\\$\\&amp;\\'\\(\\)\\*\\+\\,\\;\\=&quot;
670
+ </span><span class="marked1"><a name="line49" /> 49 RESERVED = GEN_DELIMS + SUB_DELIMS
671
+ </span><span class="marked0"><a name="line50" /> 50 UNRESERVED = ALPHA + DIGIT + &quot;\\-\\.\\_\\~&quot;
672
+ </span><span class="marked1"><a name="line51" /> 51 PCHAR = UNRESERVED + SUB_DELIMS + &quot;\\:\\@&quot;
673
+ </span><span class="marked0"><a name="line52" /> 52 SCHEME = ALPHA + DIGIT + &quot;\\-\\+\\.&quot;
674
+ </span><span class="marked1"><a name="line53" /> 53 AUTHORITY = PCHAR
675
+ </span><span class="marked0"><a name="line54" /> 54 PATH = PCHAR + &quot;\\/&quot;
676
+ </span><span class="marked1"><a name="line55" /> 55 QUERY = PCHAR + &quot;\\/\\?&quot;
677
+ </span><span class="marked0"><a name="line56" /> 56 FRAGMENT = PCHAR + &quot;\\/\\?&quot;
678
+ </span><span class="inferred1"><a name="line57" /> 57 end
679
+ </span><span class="inferred0"><a name="line58" /> 58
680
+ </span><span class="inferred1"><a name="line59" /> 59 # Returns a URI object based on the parsed string.
681
+ </span><span class="marked0"><a name="line60" /> 60 def self.parse(uri_string)
682
+ </span><span class="marked1"><a name="line61" /> 61 return nil if uri_string.nil?
683
+ </span><span class="inferred0"><a name="line62" /> 62
684
+ </span><span class="inferred1"><a name="line63" /> 63 # If a URI object is passed, just return itself.
685
+ </span><span class="marked0"><a name="line64" /> 64 return uri_string if uri_string.kind_of?(self)
686
+ </span><span class="inferred1"><a name="line65" /> 65
687
+ </span><span class="inferred0"><a name="line66" /> 66 # If a URI object of the Ruby standard library variety is passed,
688
+ </span><span class="inferred1"><a name="line67" /> 67 # convert it to a string, then parse the string.
689
+ </span><span class="marked0"><a name="line68" /> 68 if uri_string.class.name =~ /^URI::/
690
+ </span><span class="inferred1"><a name="line69" /> 69 uri_string = uri_string.to_s
691
+ </span><span class="inferred0"><a name="line70" /> 70 end
692
+ </span><span class="inferred1"><a name="line71" /> 71
693
+ </span><span class="marked0"><a name="line72" /> 72 uri_regex =
694
+ </span><span class="inferred1"><a name="line73" /> 73 /^(([^:\/?#]+):)?(\/\/([^\/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?/
695
+ </span><span class="marked0"><a name="line74" /> 74 scan = uri_string.scan(uri_regex)
696
+ </span><span class="marked1"><a name="line75" /> 75 fragments = scan[0]
697
+ </span><span class="marked0"><a name="line76" /> 76 return nil if fragments.nil?
698
+ </span><span class="marked1"><a name="line77" /> 77 scheme = fragments[1]
699
+ </span><span class="marked0"><a name="line78" /> 78 authority = fragments[3]
700
+ </span><span class="marked1"><a name="line79" /> 79 path = fragments[4]
701
+ </span><span class="marked0"><a name="line80" /> 80 query = fragments[6]
702
+ </span><span class="marked1"><a name="line81" /> 81 fragment = fragments[8]
703
+ </span><span class="marked0"><a name="line82" /> 82 userinfo = nil
704
+ </span><span class="marked1"><a name="line83" /> 83 user = nil
705
+ </span><span class="marked0"><a name="line84" /> 84 password = nil
706
+ </span><span class="marked1"><a name="line85" /> 85 host = nil
707
+ </span><span class="marked0"><a name="line86" /> 86 port = nil
708
+ </span><span class="marked1"><a name="line87" /> 87 if authority != nil
709
+ </span><span class="marked0"><a name="line88" /> 88 userinfo = authority.scan(/^([^\[\]]*)@/).flatten[0]
710
+ </span><span class="marked1"><a name="line89" /> 89 if userinfo != nil
711
+ </span><span class="marked0"><a name="line90" /> 90 user = userinfo.strip.scan(/^([^:]*):?/).flatten[0]
712
+ </span><span class="marked1"><a name="line91" /> 91 password = userinfo.strip.scan(/:(.*)$/).flatten[0]
713
+ </span><span class="inferred0"><a name="line92" /> 92 end
714
+ </span><span class="marked1"><a name="line93" /> 93 host = authority.gsub(/^([^\[\]]*)@/, &quot;&quot;).gsub(/:([^:@\[\]]*?)$/, &quot;&quot;)
715
+ </span><span class="marked0"><a name="line94" /> 94 port = authority.scan(/:([^:@\[\]]*?)$/).flatten[0]
716
+ </span><span class="inferred1"><a name="line95" /> 95 end
717
+ </span><span class="marked0"><a name="line96" /> 96 if port.nil? || port == &quot;&quot;
718
+ </span><span class="marked1"><a name="line97" /> 97 port = nil
719
+ </span><span class="inferred0"><a name="line98" /> 98 end
720
+ </span><span class="inferred1"><a name="line99" /> 99
721
+ </span><span class="inferred0"><a name="line100" /> 100 # WARNING: Not standards-compliant, but follows the theme
722
+ </span><span class="inferred1"><a name="line101" /> 101 # of Postel's law:
723
+ </span><span class="inferred0"><a name="line102" /> 102 #
724
+ </span><span class="inferred1"><a name="line103" /> 103 # Special exception for dealing with the retarded idea of the
725
+ </span><span class="inferred0"><a name="line104" /> 104 # feed pseudo-protocol. Without this exception, the parser will read
726
+ </span><span class="inferred1"><a name="line105" /> 105 # the URI as having a blank port number, instead of as having a second
727
+ </span><span class="inferred0"><a name="line106" /> 106 # URI embedded within. This exception translates these broken URIs
728
+ </span><span class="inferred1"><a name="line107" /> 107 # and instead treats the inner URI as opaque.
729
+ </span><span class="marked0"><a name="line108" /> 108 if scheme == &quot;feed&quot; &amp;&amp; host == &quot;http&quot;
730
+ </span><span class="marked1"><a name="line109" /> 109 userinfo = nil
731
+ </span><span class="marked0"><a name="line110" /> 110 user = nil
732
+ </span><span class="marked1"><a name="line111" /> 111 password = nil
733
+ </span><span class="marked0"><a name="line112" /> 112 host = nil
734
+ </span><span class="marked1"><a name="line113" /> 113 port = nil
735
+ </span><span class="marked0"><a name="line114" /> 114 path = authority + path
736
+ </span><span class="inferred1"><a name="line115" /> 115 end
737
+ </span><span class="inferred0"><a name="line116" /> 116
738
+ </span><span class="marked1"><a name="line117" /> 117 return Addressable::URI.new(
739
+ </span><span class="marked0"><a name="line118" /> 118 scheme, user, password, host, port, path, query, fragment)
740
+ </span><span class="inferred1"><a name="line119" /> 119 end
741
+ </span><span class="inferred0"><a name="line120" /> 120
742
+ </span><span class="inferred1"><a name="line121" /> 121 # Converts a path to a file protocol URI. If the path supplied is
743
+ </span><span class="inferred0"><a name="line122" /> 122 # relative, it will be returned as a relative URI. If the path supplied
744
+ </span><span class="inferred1"><a name="line123" /> 123 # is actually a URI, it will return the parsed URI.
745
+ </span><span class="marked0"><a name="line124" /> 124 def self.convert_path(path)
746
+ </span><span class="marked1"><a name="line125" /> 125 return nil if path.nil?
747
+ </span><span class="inferred0"><a name="line126" /> 126
748
+ </span><span class="marked1"><a name="line127" /> 127 converted_uri = path.strip
749
+ </span><span class="marked0"><a name="line128" /> 128 if converted_uri.length &gt; 0 &amp;&amp; converted_uri[0..0] == &quot;/&quot;
750
+ </span><span class="marked1"><a name="line129" /> 129 converted_uri = &quot;file://&quot; + converted_uri
751
+ </span><span class="inferred0"><a name="line130" /> 130 end
752
+ </span><span class="inferred1"><a name="line131" /> 131 if converted_uri.length &gt; 0 &amp;&amp;
753
+ </span><span class="marked0"><a name="line132" /> 132 converted_uri.scan(/^[a-zA-Z]:[\\\/]/).size &gt; 0
754
+ </span><span class="marked1"><a name="line133" /> 133 converted_uri = &quot;file:///&quot; + converted_uri
755
+ </span><span class="inferred0"><a name="line134" /> 134 end
756
+ </span><span class="marked1"><a name="line135" /> 135 converted_uri.gsub!(/^file:\/*/i, &quot;file:///&quot;)
757
+ </span><span class="marked0"><a name="line136" /> 136 if converted_uri =~ /^file:/i
758
+ </span><span class="inferred1"><a name="line137" /> 137 # Adjust windows-style uris
759
+ </span><span class="marked0"><a name="line138" /> 138 converted_uri.gsub!(/^file:\/\/\/([a-zA-Z])\|/i, 'file:///\1:')
760
+ </span><span class="marked1"><a name="line139" /> 139 converted_uri.gsub!(/\\/, '/')
761
+ </span><span class="marked0"><a name="line140" /> 140 converted_uri = self.parse(converted_uri).normalize
762
+ </span><span class="marked1"><a name="line141" /> 141 if File.exists?(converted_uri.path) &amp;&amp;
763
+ </span><span class="marked0"><a name="line142" /> 142 File.stat(converted_uri.path).directory?
764
+ </span><span class="marked1"><a name="line143" /> 143 converted_uri.path.gsub!(/\/$/, &quot;&quot;)
765
+ </span><span class="marked0"><a name="line144" /> 144 converted_uri.path = converted_uri.path + '/'
766
+ </span><span class="inferred1"><a name="line145" /> 145 end
767
+ </span><span class="inferred0"><a name="line146" /> 146 else
768
+ </span><span class="marked1"><a name="line147" /> 147 converted_uri = self.parse(converted_uri)
769
+ </span><span class="inferred0"><a name="line148" /> 148 end
770
+ </span><span class="inferred1"><a name="line149" /> 149
771
+ </span><span class="marked0"><a name="line150" /> 150 return converted_uri
772
+ </span><span class="inferred1"><a name="line151" /> 151 end
773
+ </span><span class="inferred0"><a name="line152" /> 152
774
+ </span><span class="inferred1"><a name="line153" /> 153 # Expands a URI template into a full URI.
775
+ </span><span class="inferred0"><a name="line154" /> 154 #
776
+ </span><span class="inferred1"><a name="line155" /> 155 # An optional processor object may be supplied. The object should
777
+ </span><span class="inferred0"><a name="line156" /> 156 # respond to either the :validate or :transform messages or both.
778
+ </span><span class="inferred1"><a name="line157" /> 157 # Both the :validate and :transform methods should take two parameters:
779
+ </span><span class="inferred0"><a name="line158" /> 158 # :name and :value. The :validate method should return true or false;
780
+ </span><span class="inferred1"><a name="line159" /> 159 # true if the value of the variable is valid, false otherwise. The
781
+ </span><span class="inferred0"><a name="line160" /> 160 # :transform method should return the transformed variable value as a
782
+ </span><span class="inferred1"><a name="line161" /> 161 # string.
783
+ </span><span class="inferred0"><a name="line162" /> 162 #
784
+ </span><span class="inferred1"><a name="line163" /> 163 # An example:
785
+ </span><span class="inferred0"><a name="line164" /> 164 #
786
+ </span><span class="inferred1"><a name="line165" /> 165 # class ExampleProcessor
787
+ </span><span class="inferred0"><a name="line166" /> 166 # def self.validate(name, value)
788
+ </span><span class="inferred1"><a name="line167" /> 167 # return !!(value =~ /^[\w ]+$/) if name == &quot;query&quot;
789
+ </span><span class="inferred0"><a name="line168" /> 168 # return true
790
790
  </span><span class="inferred1"><a name="line169" /> 169 # end
791
- </span><span class="inferred0"><a name="line170" /> 170 # end
792
- </span><span class="inferred1"><a name="line171" /> 171 #
793
- </span><span class="inferred0"><a name="line172" /> 172 # Addressable::URI.expand_template(
794
- </span><span class="inferred1"><a name="line173" /> 173 # &quot;http://example.com/search/{query}/&quot;,
795
- </span><span class="inferred0"><a name="line174" /> 174 # {&quot;query&quot; =&gt; &quot;an example search query&quot;},
796
- </span><span class="inferred1"><a name="line175" /> 175 # ExampleProcessor).to_s
797
- </span><span class="inferred0"><a name="line176" /> 176 # =&gt; &quot;http://example.com/search/an+example+search+query/&quot;
798
- </span><span class="marked1"><a name="line177" /> 177 def self.expand_template(pattern, mapping, processor=nil)
799
- </span><span class="marked0"><a name="line178" /> 178 result = pattern.dup
800
- </span><span class="marked1"><a name="line179" /> 179 for name, value in mapping
801
- </span><span class="marked0"><a name="line180" /> 180 transformed_value = value
802
- </span><span class="marked1"><a name="line181" /> 181 if processor != nil
803
- </span><span class="marked0"><a name="line182" /> 182 if processor.respond_to?(:validate)
804
- </span><span class="marked1"><a name="line183" /> 183 if !processor.validate(name, value)
805
- </span><span class="marked0"><a name="line184" /> 184 raise InvalidTemplateValue,
806
- </span><span class="inferred1"><a name="line185" /> 185 &quot;(#{name}, #{value}) is an invalid template value.&quot;
807
- </span><span class="inferred0"><a name="line186" /> 186 end
808
- </span><span class="inferred1"><a name="line187" /> 187 end
809
- </span><span class="marked0"><a name="line188" /> 188 if processor.respond_to?(:transform)
810
- </span><span class="marked1"><a name="line189" /> 189 transformed_value = processor.transform(name, value)
811
- </span><span class="inferred0"><a name="line190" /> 190 end
812
- </span><span class="inferred1"><a name="line191" /> 191 end
813
- </span><span class="inferred0"><a name="line192" /> 192
814
- </span><span class="inferred1"><a name="line193" /> 193 # Handle percent escaping
815
- </span><span class="marked0"><a name="line194" /> 194 transformed_value = self.encode_segment(transformed_value,
816
- </span><span class="inferred1"><a name="line195" /> 195 Addressable::URI::CharacterClasses::RESERVED +
817
- </span><span class="inferred0"><a name="line196" /> 196 Addressable::URI::CharacterClasses::UNRESERVED)
818
- </span><span class="inferred1"><a name="line197" /> 197
819
- </span><span class="marked0"><a name="line198" /> 198 result.gsub!(/\{#{Regexp.escape(name)}\}/, transformed_value)
820
- </span><span class="inferred1"><a name="line199" /> 199 end
821
- </span><span class="marked0"><a name="line200" /> 200 result.gsub!(/\{[#{CharacterClasses::UNRESERVED}]+\}/, &quot;&quot;)
822
- </span><span class="marked1"><a name="line201" /> 201 return Addressable::URI.parse(result)
823
- </span><span class="inferred0"><a name="line202" /> 202 end
824
- </span><span class="inferred1"><a name="line203" /> 203
825
- </span><span class="inferred0"><a name="line204" /> 204 # Joins several uris together.
826
- </span><span class="marked1"><a name="line205" /> 205 def self.join(*uris)
827
- </span><span class="marked0"><a name="line206" /> 206 uri_objects = uris.collect do |uri|
828
- </span><span class="marked1"><a name="line207" /> 207 uri.kind_of?(self) ? uri : self.parse(uri.to_s)
829
- </span><span class="inferred0"><a name="line208" /> 208 end
830
- </span><span class="marked1"><a name="line209" /> 209 result = uri_objects.shift.dup
831
- </span><span class="marked0"><a name="line210" /> 210 for uri in uri_objects
832
- </span><span class="marked1"><a name="line211" /> 211 result.merge!(uri)
833
- </span><span class="inferred0"><a name="line212" /> 212 end
834
- </span><span class="marked1"><a name="line213" /> 213 return result
835
- </span><span class="inferred0"><a name="line214" /> 214 end
836
- </span><span class="inferred1"><a name="line215" /> 215
837
- </span><span class="inferred0"><a name="line216" /> 216 # Percent encodes a URI segment. Returns a string. Takes an optional
838
- </span><span class="inferred1"><a name="line217" /> 217 # character class parameter, which should be specified as a string
839
- </span><span class="inferred0"><a name="line218" /> 218 # containing a regular expression character class (not including the
840
- </span><span class="inferred1"><a name="line219" /> 219 # surrounding square brackets). The character class parameter defaults
841
- </span><span class="inferred0"><a name="line220" /> 220 # to the reserved plus unreserved character classes specified in
842
- </span><span class="inferred1"><a name="line221" /> 221 # RFC 3986. Usage of the constants within the CharacterClasses module is
843
- </span><span class="inferred0"><a name="line222" /> 222 # highly recommended when using this method.
844
- </span><span class="inferred1"><a name="line223" /> 223 #
845
- </span><span class="inferred0"><a name="line224" /> 224 # An example:
846
- </span><span class="inferred1"><a name="line225" /> 225 #
847
- </span><span class="inferred0"><a name="line226" /> 226 # Addressable::URI.escape_segment(&quot;simple-example&quot;, &quot;b-zB-Z0-9&quot;)
848
- </span><span class="inferred1"><a name="line227" /> 227 # =&gt; &quot;simple%2Dex%61mple&quot;
849
- </span><span class="marked0"><a name="line228" /> 228 def self.encode_segment(segment, character_class=
850
- </span><span class="inferred1"><a name="line229" /> 229 Addressable::URI::CharacterClasses::RESERVED +
851
- </span><span class="marked0"><a name="line230" /> 230 Addressable::URI::CharacterClasses::UNRESERVED)
852
- </span><span class="marked1"><a name="line231" /> 231 return nil if segment.nil?
853
- </span><span class="inferred0"><a name="line232" /> 232 return segment.gsub(
854
- </span><span class="inferred1"><a name="line233" /> 233 /[^#{character_class}]/
855
- </span><span class="inferred0"><a name="line234" /> 234 ) do |sequence|
856
- </span><span class="marked1"><a name="line235" /> 235 (&quot;%&quot; + sequence.unpack('C')[0].to_s(16).upcase)
857
- </span><span class="marked0"><a name="line236" /> 236 end
858
- </span><span class="inferred1"><a name="line237" /> 237 end
859
- </span><span class="inferred0"><a name="line238" /> 238
860
- </span><span class="inferred1"><a name="line239" /> 239 # Unencodes any percent encoded characters within a URI segment.
861
- </span><span class="inferred0"><a name="line240" /> 240 # Returns a string.
862
- </span><span class="marked1"><a name="line241" /> 241 def self.unencode_segment(segment)
863
- </span><span class="marked0"><a name="line242" /> 242 return nil if segment.nil?
864
- </span><span class="inferred1"><a name="line243" /> 243 return segment.to_s.gsub(/%[0-9a-f]{2}/i) do |sequence|
865
- </span><span class="marked0"><a name="line244" /> 244 sequence[1..3].to_i(16).chr
866
- </span><span class="marked1"><a name="line245" /> 245 end
867
- </span><span class="inferred0"><a name="line246" /> 246 end
868
- </span><span class="inferred1"><a name="line247" /> 247
869
- </span><span class="inferred0"><a name="line248" /> 248 # Percent encodes any special characters in the URI. This method does
870
- </span><span class="inferred1"><a name="line249" /> 249 # not take IRIs or IDNs into account.
871
- </span><span class="marked0"><a name="line250" /> 250 def self.encode(uri)
872
- </span><span class="marked1"><a name="line251" /> 251 uri_object = uri.kind_of?(self) ? uri : self.parse(uri.to_s)
873
- </span><span class="marked0"><a name="line252" /> 252 return Addressable::URI.new(
874
- </span><span class="marked1"><a name="line253" /> 253 self.encode_segment(uri_object.scheme,
875
- </span><span class="inferred0"><a name="line254" /> 254 Addressable::URI::CharacterClasses::SCHEME),
876
- </span><span class="marked1"><a name="line255" /> 255 self.encode_segment(uri_object.user,
877
- </span><span class="inferred0"><a name="line256" /> 256 Addressable::URI::CharacterClasses::AUTHORITY),
878
- </span><span class="marked1"><a name="line257" /> 257 self.encode_segment(uri_object.password,
879
- </span><span class="inferred0"><a name="line258" /> 258 Addressable::URI::CharacterClasses::AUTHORITY),
880
- </span><span class="marked1"><a name="line259" /> 259 self.encode_segment(uri_object.host,
881
- </span><span class="inferred0"><a name="line260" /> 260 Addressable::URI::CharacterClasses::AUTHORITY),
882
- </span><span class="marked1"><a name="line261" /> 261 self.encode_segment(uri_object.specified_port,
883
- </span><span class="inferred0"><a name="line262" /> 262 Addressable::URI::CharacterClasses::AUTHORITY),
884
- </span><span class="marked1"><a name="line263" /> 263 self.encode_segment(uri_object.path,
885
- </span><span class="inferred0"><a name="line264" /> 264 Addressable::URI::CharacterClasses::PATH),
886
- </span><span class="marked1"><a name="line265" /> 265 self.encode_segment(uri_object.query,
887
- </span><span class="inferred0"><a name="line266" /> 266 Addressable::URI::CharacterClasses::QUERY),
888
- </span><span class="marked1"><a name="line267" /> 267 self.encode_segment(uri_object.fragment,
889
- </span><span class="inferred0"><a name="line268" /> 268 Addressable::URI::CharacterClasses::FRAGMENT)
890
- </span><span class="marked1"><a name="line269" /> 269 ).to_s
891
- </span><span class="inferred0"><a name="line270" /> 270 end
892
- </span><span class="inferred1"><a name="line271" /> 271
893
- </span><span class="marked0"><a name="line272" /> 272 class &lt;&lt; self
894
- </span><span class="marked1"><a name="line273" /> 273 alias_method :escape, :encode
895
- </span><span class="inferred0"><a name="line274" /> 274 end
896
- </span><span class="inferred1"><a name="line275" /> 275
897
- </span><span class="inferred0"><a name="line276" /> 276 # Normalizes the encoding of a URI. Characters within a hostname are
898
- </span><span class="inferred1"><a name="line277" /> 277 # not percent encoded to allow for internationalized domain names.
899
- </span><span class="marked0"><a name="line278" /> 278 def self.normalized_encode(uri)
900
- </span><span class="marked1"><a name="line279" /> 279 uri_object = uri.kind_of?(self) ? uri : self.parse(uri.to_s)
901
- </span><span class="marked0"><a name="line280" /> 280 segments = {
902
- </span><span class="marked1"><a name="line281" /> 281 :scheme =&gt; self.unencode_segment(uri_object.scheme),
903
- </span><span class="marked0"><a name="line282" /> 282 :user =&gt; self.unencode_segment(uri_object.user),
904
- </span><span class="marked1"><a name="line283" /> 283 :password =&gt; self.unencode_segment(uri_object.password),
905
- </span><span class="marked0"><a name="line284" /> 284 :host =&gt; self.unencode_segment(uri_object.host),
906
- </span><span class="marked1"><a name="line285" /> 285 :port =&gt; self.unencode_segment(uri_object.specified_port),
907
- </span><span class="marked0"><a name="line286" /> 286 :path =&gt; self.unencode_segment(uri_object.path),
908
- </span><span class="marked1"><a name="line287" /> 287 :query =&gt; self.unencode_segment(uri_object.query),
909
- </span><span class="marked0"><a name="line288" /> 288 :fragment =&gt; self.unencode_segment(uri_object.fragment)
910
- </span><span class="inferred1"><a name="line289" /> 289 }
911
- </span><span class="marked0"><a name="line290" /> 290 if URI::IDNA.send(:use_libidn?)
912
- </span><span class="marked1"><a name="line291" /> 291 segments.each do |key, value|
913
- </span><span class="marked0"><a name="line292" /> 292 if value != nil
914
- </span><span class="marked1"><a name="line293" /> 293 segments[key] = IDN::Stringprep.nfkc_normalize(value.to_s)
915
- </span><span class="inferred0"><a name="line294" /> 294 end
916
- </span><span class="inferred1"><a name="line295" /> 295 end
917
- </span><span class="inferred0"><a name="line296" /> 296 end
918
- </span><span class="marked1"><a name="line297" /> 297 return Addressable::URI.new(
919
- </span><span class="marked0"><a name="line298" /> 298 self.encode_segment(segments[:scheme],
920
- </span><span class="inferred1"><a name="line299" /> 299 Addressable::URI::CharacterClasses::SCHEME),
921
- </span><span class="marked0"><a name="line300" /> 300 self.encode_segment(segments[:user],
922
- </span><span class="inferred1"><a name="line301" /> 301 Addressable::URI::CharacterClasses::AUTHORITY),
923
- </span><span class="marked0"><a name="line302" /> 302 self.encode_segment(segments[:password],
924
- </span><span class="inferred1"><a name="line303" /> 303 Addressable::URI::CharacterClasses::AUTHORITY),
925
- </span><span class="inferred0"><a name="line304" /> 304 segments[:host],
926
- </span><span class="inferred1"><a name="line305" /> 305 segments[:port],
927
- </span><span class="marked0"><a name="line306" /> 306 self.encode_segment(segments[:path],
928
- </span><span class="inferred1"><a name="line307" /> 307 Addressable::URI::CharacterClasses::PATH),
929
- </span><span class="marked0"><a name="line308" /> 308 self.encode_segment(segments[:query],
930
- </span><span class="inferred1"><a name="line309" /> 309 Addressable::URI::CharacterClasses::QUERY),
931
- </span><span class="marked0"><a name="line310" /> 310 self.encode_segment(segments[:fragment],
932
- </span><span class="inferred1"><a name="line311" /> 311 Addressable::URI::CharacterClasses::FRAGMENT)
933
- </span><span class="marked0"><a name="line312" /> 312 ).to_s
934
- </span><span class="inferred1"><a name="line313" /> 313 end
935
- </span><span class="inferred0"><a name="line314" /> 314
936
- </span><span class="inferred1"><a name="line315" /> 315 # Extracts uris from an arbitrary body of text.
937
- </span><span class="marked0"><a name="line316" /> 316 def self.extract(text, options={})
938
- </span><span class="marked1"><a name="line317" /> 317 defaults = {:base =&gt; nil, :parse =&gt; false}
939
- </span><span class="marked0"><a name="line318" /> 318 options = defaults.merge(options)
940
- </span><span class="marked1"><a name="line319" /> 319 raise InvalidOptionError unless (options.keys - defaults.keys).empty?
941
- </span><span class="inferred0"><a name="line320" /> 320 # This regular expression needs to be less forgiving or else it would
942
- </span><span class="inferred1"><a name="line321" /> 321 # match virtually all text. Which isn't exactly what we're going for.
943
- </span><span class="marked0"><a name="line322" /> 322 extract_regex = /((([a-z\+]+):)[^ \n\&lt;\&gt;\&quot;\\]+[\w\/])/
944
- </span><span class="marked1"><a name="line323" /> 323 extracted_uris =
945
- </span><span class="marked0"><a name="line324" /> 324 text.scan(extract_regex).collect { |match| match[0] }
946
- </span><span class="marked1"><a name="line325" /> 325 sgml_extract_regex = /&lt;[^&gt;]+href=\&quot;([^\&quot;]+?)\&quot;[^&gt;]*&gt;/
947
- </span><span class="marked0"><a name="line326" /> 326 sgml_extracted_uris =
948
- </span><span class="inferred1"><a name="line327" /> 327 text.scan(sgml_extract_regex).collect { |match| match[0] }
949
- </span><span class="marked0"><a name="line328" /> 328 extracted_uris.concat(sgml_extracted_uris - extracted_uris)
950
- </span><span class="marked1"><a name="line329" /> 329 textile_extract_regex = /\&quot;.+?\&quot;:([^ ]+\/[^ ]+)[ \,\.\;\:\?\!\&lt;\&gt;\&quot;]/i
951
- </span><span class="marked0"><a name="line330" /> 330 textile_extracted_uris =
952
- </span><span class="inferred1"><a name="line331" /> 331 text.scan(textile_extract_regex).collect { |match| match[0] }
953
- </span><span class="marked0"><a name="line332" /> 332 extracted_uris.concat(textile_extracted_uris - extracted_uris)
954
- </span><span class="marked1"><a name="line333" /> 333 parsed_uris = []
955
- </span><span class="marked0"><a name="line334" /> 334 base_uri = nil
956
- </span><span class="marked1"><a name="line335" /> 335 if options[:base] != nil
957
- </span><span class="marked0"><a name="line336" /> 336 base_uri = options[:base] if options[:base].kind_of?(self)
958
- </span><span class="marked1"><a name="line337" /> 337 base_uri = self.parse(options[:base].to_s) if base_uri == nil
959
- </span><span class="inferred0"><a name="line338" /> 338 end
960
- </span><span class="marked1"><a name="line339" /> 339 for uri_string in extracted_uris
961
- </span><span class="marked0"><a name="line340" /> 340 begin
962
- </span><span class="marked1"><a name="line341" /> 341 if base_uri == nil
963
- </span><span class="marked0"><a name="line342" /> 342 parsed_uris &lt;&lt; self.parse(uri_string)
964
- </span><span class="inferred1"><a name="line343" /> 343 else
965
- </span><span class="marked0"><a name="line344" /> 344 parsed_uris &lt;&lt; (base_uri + self.parse(uri_string))
966
- </span><span class="inferred1"><a name="line345" /> 345 end
967
- </span><span class="inferred0"><a name="line346" /> 346 rescue Exception
968
- </span><span class="marked1"><a name="line347" /> 347 nil
969
- </span><span class="inferred0"><a name="line348" /> 348 end
970
- </span><span class="inferred1"><a name="line349" /> 349 end
971
- </span><span class="marked0"><a name="line350" /> 350 parsed_uris.reject! do |uri|
972
- </span><span class="marked1"><a name="line351" /> 351 (uri.scheme =~ /T\d+/ ||
973
- </span><span class="marked0"><a name="line352" /> 352 uri.scheme == &quot;xmlns&quot; ||
974
- </span><span class="marked1"><a name="line353" /> 353 uri.scheme == &quot;xml&quot; ||
975
- </span><span class="marked0"><a name="line354" /> 354 uri.scheme == &quot;thr&quot; ||
976
- </span><span class="marked1"><a name="line355" /> 355 uri.scheme == &quot;this&quot; ||
977
- </span><span class="marked0"><a name="line356" /> 356 uri.scheme == &quot;float&quot; ||
978
- </span><span class="marked1"><a name="line357" /> 357 uri.scheme == &quot;user&quot; ||
979
- </span><span class="marked0"><a name="line358" /> 358 uri.scheme == &quot;username&quot; ||
980
- </span><span class="marked1"><a name="line359" /> 359 uri.scheme == &quot;out&quot;)
981
- </span><span class="inferred0"><a name="line360" /> 360 end
982
- </span><span class="marked1"><a name="line361" /> 361 if options[:parse]
983
- </span><span class="marked0"><a name="line362" /> 362 return parsed_uris
984
- </span><span class="inferred1"><a name="line363" /> 363 else
985
- </span><span class="marked0"><a name="line364" /> 364 return parsed_uris.collect { |uri| uri.to_s }
986
- </span><span class="inferred1"><a name="line365" /> 365 end
987
- </span><span class="inferred0"><a name="line366" /> 366 end
988
- </span><span class="inferred1"><a name="line367" /> 367
989
- </span><span class="inferred0"><a name="line368" /> 368 # Creates a new uri object from component parts. Passing nil for
990
- </span><span class="inferred1"><a name="line369" /> 369 # any of these parameters is acceptable.
991
- </span><span class="marked0"><a name="line370" /> 370 def initialize(scheme, user, password, host, port, path, query, fragment)
992
- </span><span class="marked1"><a name="line371" /> 371 @scheme = scheme
993
- </span><span class="marked0"><a name="line372" /> 372 @scheme = nil if @scheme.to_s.strip == &quot;&quot;
994
- </span><span class="marked1"><a name="line373" /> 373 @user = user
995
- </span><span class="marked0"><a name="line374" /> 374 @password = password
996
- </span><span class="marked1"><a name="line375" /> 375 @host = host
997
- </span><span class="marked0"><a name="line376" /> 376 @specified_port = port.to_s
998
- </span><span class="marked1"><a name="line377" /> 377 @port = port
999
- </span><span class="marked0"><a name="line378" /> 378 @port = @port.to_s if @port.kind_of?(Fixnum)
1000
- </span><span class="marked1"><a name="line379" /> 379 if @port != nil &amp;&amp; !(@port =~ /^\d+$/)
1001
- </span><span class="marked0"><a name="line380" /> 380 raise InvalidURIError,
1002
- </span><span class="inferred1"><a name="line381" /> 381 &quot;Invalid port number: #{@port.inspect}&quot;
1003
- </span><span class="inferred0"><a name="line382" /> 382 end
1004
- </span><span class="marked1"><a name="line383" /> 383 @port = @port.to_i
1005
- </span><span class="marked0"><a name="line384" /> 384 @port = nil if @port == 0
1006
- </span><span class="marked1"><a name="line385" /> 385 @path = path
1007
- </span><span class="marked0"><a name="line386" /> 386 @query = query
1008
- </span><span class="marked1"><a name="line387" /> 387 @fragment = fragment
1009
- </span><span class="inferred0"><a name="line388" /> 388
1010
- </span><span class="marked1"><a name="line389" /> 389 validate()
1011
- </span><span class="inferred0"><a name="line390" /> 390 end
1012
- </span><span class="inferred1"><a name="line391" /> 391
1013
- </span><span class="inferred0"><a name="line392" /> 392 # Returns the scheme (protocol) for this URI.
1014
- </span><span class="marked1"><a name="line393" /> 393 def scheme
1015
- </span><span class="marked0"><a name="line394" /> 394 return @scheme
1016
- </span><span class="marked1"><a name="line395" /> 395 end
1017
- </span><span class="inferred0"><a name="line396" /> 396
1018
- </span><span class="inferred1"><a name="line397" /> 397 # Sets the scheme (protocol for this URI.)
1019
- </span><span class="marked0"><a name="line398" /> 398 def scheme=(new_scheme)
1020
- </span><span class="marked1"><a name="line399" /> 399 @scheme = new_scheme
1021
- </span><span class="marked0"><a name="line400" /> 400 end
1022
- </span><span class="inferred1"><a name="line401" /> 401
1023
- </span><span class="inferred0"><a name="line402" /> 402 # Returns the user for this URI.
1024
- </span><span class="marked1"><a name="line403" /> 403 def user
1025
- </span><span class="marked0"><a name="line404" /> 404 return @user
1026
- </span><span class="marked1"><a name="line405" /> 405 end
1027
- </span><span class="inferred0"><a name="line406" /> 406
1028
- </span><span class="inferred1"><a name="line407" /> 407 # Sets the user for this URI.
1029
- </span><span class="marked0"><a name="line408" /> 408 def user=(new_user)
1030
- </span><span class="marked1"><a name="line409" /> 409 @user = new_user
1031
- </span><span class="inferred0"><a name="line410" /> 410
1032
- </span><span class="inferred1"><a name="line411" /> 411 # You can't have a nil user with a non-nil password
1033
- </span><span class="marked0"><a name="line412" /> 412 if @password != nil
1034
- </span><span class="marked1"><a name="line413" /> 413 @user = &quot;&quot; if @user.nil?
1035
- </span><span class="inferred0"><a name="line414" /> 414 end
1036
- </span><span class="inferred1"><a name="line415" /> 415
1037
- </span><span class="inferred0"><a name="line416" /> 416 # Reset dependant values
1038
- </span><span class="marked1"><a name="line417" /> 417 @userinfo = nil
1039
- </span><span class="marked0"><a name="line418" /> 418 @authority = nil
1040
- </span><span class="inferred1"><a name="line419" /> 419
1041
- </span><span class="inferred0"><a name="line420" /> 420 # Ensure we haven't created an invalid URI
1042
- </span><span class="marked1"><a name="line421" /> 421 validate()
1043
- </span><span class="inferred0"><a name="line422" /> 422 end
1044
- </span><span class="inferred1"><a name="line423" /> 423
1045
- </span><span class="inferred0"><a name="line424" /> 424 # Returns the password for this URI.
1046
- </span><span class="marked1"><a name="line425" /> 425 def password
1047
- </span><span class="marked0"><a name="line426" /> 426 return @password
1048
- </span><span class="marked1"><a name="line427" /> 427 end
1049
- </span><span class="inferred0"><a name="line428" /> 428
1050
- </span><span class="inferred1"><a name="line429" /> 429 # Sets the password for this URI.
1051
- </span><span class="marked0"><a name="line430" /> 430 def password=(new_password)
1052
- </span><span class="marked1"><a name="line431" /> 431 @password = new_password
1053
- </span><span class="inferred0"><a name="line432" /> 432
1054
- </span><span class="inferred1"><a name="line433" /> 433 # You can't have a nil user with a non-nil password
1055
- </span><span class="marked0"><a name="line434" /> 434 if @password != nil
1056
- </span><span class="marked1"><a name="line435" /> 435 @user = &quot;&quot; if @user.nil?
1057
- </span><span class="inferred0"><a name="line436" /> 436 end
1058
- </span><span class="inferred1"><a name="line437" /> 437
1059
- </span><span class="inferred0"><a name="line438" /> 438 # Reset dependant values
1060
- </span><span class="marked1"><a name="line439" /> 439 @userinfo = nil
1061
- </span><span class="marked0"><a name="line440" /> 440 @authority = nil
1062
- </span><span class="inferred1"><a name="line441" /> 441
1063
- </span><span class="inferred0"><a name="line442" /> 442 # Ensure we haven't created an invalid URI
1064
- </span><span class="marked1"><a name="line443" /> 443 validate()
1065
- </span><span class="inferred0"><a name="line444" /> 444 end
1066
- </span><span class="inferred1"><a name="line445" /> 445
1067
- </span><span class="inferred0"><a name="line446" /> 446 # Returns the username and password segment of this URI.
1068
- </span><span class="marked1"><a name="line447" /> 447 def userinfo
1069
- </span><span class="marked0"><a name="line448" /> 448 if !defined?(@userinfo) || @userinfo.nil?
1070
- </span><span class="marked1"><a name="line449" /> 449 current_user = self.user
1071
- </span><span class="marked0"><a name="line450" /> 450 current_password = self.password
1072
- </span><span class="marked1"><a name="line451" /> 451 if current_user == nil &amp;&amp; current_password == nil
1073
- </span><span class="marked0"><a name="line452" /> 452 @userinfo = nil
1074
- </span><span class="marked1"><a name="line453" /> 453 elsif current_user != nil &amp;&amp; current_password == nil
1075
- </span><span class="marked0"><a name="line454" /> 454 @userinfo = &quot;#{current_user}&quot;
1076
- </span><span class="marked1"><a name="line455" /> 455 elsif current_user != nil &amp;&amp; current_password != nil
1077
- </span><span class="marked0"><a name="line456" /> 456 @userinfo = &quot;#{current_user}:#{current_password}&quot;
1078
- </span><span class="inferred1"><a name="line457" /> 457 end
1079
- </span><span class="inferred0"><a name="line458" /> 458 end
1080
- </span><span class="marked1"><a name="line459" /> 459 return @userinfo
1081
- </span><span class="inferred0"><a name="line460" /> 460 end
1082
- </span><span class="inferred1"><a name="line461" /> 461
1083
- </span><span class="inferred0"><a name="line462" /> 462 # Sets the username and password segment of this URI.
1084
- </span><span class="marked1"><a name="line463" /> 463 def userinfo=(new_userinfo)
1085
- </span><span class="marked0"><a name="line464" /> 464 new_user = new_userinfo.to_s.strip.scan(/^(.*):/).flatten[0]
1086
- </span><span class="marked1"><a name="line465" /> 465 new_password = new_userinfo.to_s.strip.scan(/:(.*)$/).flatten[0]
1087
- </span><span class="inferred0"><a name="line466" /> 466
1088
- </span><span class="inferred1"><a name="line467" /> 467 # Password assigned first to ensure validity in case of nil
1089
- </span><span class="marked0"><a name="line468" /> 468 self.password = new_password
1090
- </span><span class="marked1"><a name="line469" /> 469 self.user = new_user
1091
- </span><span class="inferred0"><a name="line470" /> 470
1092
- </span><span class="inferred1"><a name="line471" /> 471 # Reset dependant values
1093
- </span><span class="marked0"><a name="line472" /> 472 @authority = nil
1094
- </span><span class="inferred1"><a name="line473" /> 473
1095
- </span><span class="inferred0"><a name="line474" /> 474 # Ensure we haven't created an invalid URI
1096
- </span><span class="marked1"><a name="line475" /> 475 validate()
1097
- </span><span class="inferred0"><a name="line476" /> 476 end
1098
- </span><span class="inferred1"><a name="line477" /> 477
1099
- </span><span class="inferred0"><a name="line478" /> 478 # Returns the host for this URI.
1100
- </span><span class="marked1"><a name="line479" /> 479 def host
1101
- </span><span class="marked0"><a name="line480" /> 480 return @host
1102
- </span><span class="marked1"><a name="line481" /> 481 end
1103
- </span><span class="inferred0"><a name="line482" /> 482
1104
- </span><span class="inferred1"><a name="line483" /> 483 # Sets the host for this URI.
1105
- </span><span class="marked0"><a name="line484" /> 484 def host=(new_host)
1106
- </span><span class="marked1"><a name="line485" /> 485 @host = new_host
1107
- </span><span class="inferred0"><a name="line486" /> 486
1108
- </span><span class="inferred1"><a name="line487" /> 487 # Reset dependant values
1109
- </span><span class="marked0"><a name="line488" /> 488 @authority = nil
1110
- </span><span class="inferred1"><a name="line489" /> 489
1111
- </span><span class="inferred0"><a name="line490" /> 490 # Ensure we haven't created an invalid URI
1112
- </span><span class="marked1"><a name="line491" /> 491 validate()
1113
- </span><span class="inferred0"><a name="line492" /> 492 end
1114
- </span><span class="inferred1"><a name="line493" /> 493
1115
- </span><span class="inferred0"><a name="line494" /> 494 # Returns the authority segment of this URI.
1116
- </span><span class="marked1"><a name="line495" /> 495 def authority
1117
- </span><span class="marked0"><a name="line496" /> 496 if !defined?(@authority) || @authority.nil?
1118
- </span><span class="marked1"><a name="line497" /> 497 return nil if self.host.nil?
1119
- </span><span class="marked0"><a name="line498" /> 498 @authority = &quot;&quot;
1120
- </span><span class="marked1"><a name="line499" /> 499 if self.userinfo != nil
1121
- </span><span class="marked0"><a name="line500" /> 500 @authority &lt;&lt; &quot;#{self.userinfo}@&quot;
1122
- </span><span class="inferred1"><a name="line501" /> 501 end
1123
- </span><span class="marked0"><a name="line502" /> 502 @authority &lt;&lt; self.host
1124
- </span><span class="marked1"><a name="line503" /> 503 if self.specified_port != nil
1125
- </span><span class="marked0"><a name="line504" /> 504 @authority &lt;&lt; &quot;:#{self.specified_port}&quot;
1126
- </span><span class="inferred1"><a name="line505" /> 505 end
1127
- </span><span class="inferred0"><a name="line506" /> 506 end
1128
- </span><span class="marked1"><a name="line507" /> 507 return @authority
1129
- </span><span class="inferred0"><a name="line508" /> 508 end
1130
- </span><span class="inferred1"><a name="line509" /> 509
1131
- </span><span class="inferred0"><a name="line510" /> 510 # Sets the authority segment of this URI.
1132
- </span><span class="marked1"><a name="line511" /> 511 def authority=(new_authority)
1133
- </span><span class="marked0"><a name="line512" /> 512 if new_authority != nil
1134
- </span><span class="marked1"><a name="line513" /> 513 new_userinfo = new_authority.scan(/^([^\[\]]*)@/).flatten[0]
1135
- </span><span class="marked0"><a name="line514" /> 514 if new_userinfo != nil
1136
- </span><span class="marked1"><a name="line515" /> 515 new_user = new_userinfo.strip.scan(/^([^:]*):?/).flatten[0]
1137
- </span><span class="marked0"><a name="line516" /> 516 new_password = new_userinfo.strip.scan(/:(.*)$/).flatten[0]
1138
- </span><span class="inferred1"><a name="line517" /> 517 end
1139
- </span><span class="marked0"><a name="line518" /> 518 new_host =
1140
- </span><span class="inferred1"><a name="line519" /> 519 new_authority.gsub(/^([^\[\]]*)@/, &quot;&quot;).gsub(/:([^:@\[\]]*?)$/, &quot;&quot;)
1141
- </span><span class="marked0"><a name="line520" /> 520 new_port =
1142
- </span><span class="inferred1"><a name="line521" /> 521 new_authority.scan(/:([^:@\[\]]*?)$/).flatten[0]
1143
- </span><span class="inferred0"><a name="line522" /> 522 end
1144
- </span><span class="marked1"><a name="line523" /> 523 new_port = nil if new_port == &quot;&quot;
1145
- </span><span class="inferred0"><a name="line524" /> 524
1146
- </span><span class="inferred1"><a name="line525" /> 525 # Password assigned first to ensure validity in case of nil
1147
- </span><span class="marked0"><a name="line526" /> 526 self.password = new_password
1148
- </span><span class="marked1"><a name="line527" /> 527 self.user = new_user
1149
- </span><span class="marked0"><a name="line528" /> 528 self.host = new_host
1150
- </span><span class="inferred1"><a name="line529" /> 529
1151
- </span><span class="inferred0"><a name="line530" /> 530 # Port reset to allow port normalization
1152
- </span><span class="marked1"><a name="line531" /> 531 @port = nil
1153
- </span><span class="marked0"><a name="line532" /> 532 @specified_port = new_port
1154
- </span><span class="inferred1"><a name="line533" /> 533
1155
- </span><span class="inferred0"><a name="line534" /> 534 # Ensure we haven't created an invalid URI
1156
- </span><span class="marked1"><a name="line535" /> 535 validate()
1157
- </span><span class="inferred0"><a name="line536" /> 536 end
1158
- </span><span class="inferred1"><a name="line537" /> 537
1159
- </span><span class="inferred0"><a name="line538" /> 538 # Returns an array of known ip-based schemes. These schemes typically
1160
- </span><span class="inferred1"><a name="line539" /> 539 # use a similar URI form:
1161
- </span><span class="inferred0"><a name="line540" /> 540 # //&lt;user&gt;:&lt;password&gt;@&lt;host&gt;:&lt;port&gt;/&lt;url-path&gt;
1162
- </span><span class="marked1"><a name="line541" /> 541 def self.ip_based_schemes
1163
- </span><span class="marked0"><a name="line542" /> 542 return self.scheme_mapping.keys
1164
- </span><span class="marked1"><a name="line543" /> 543 end
1165
- </span><span class="inferred0"><a name="line544" /> 544
1166
- </span><span class="inferred1"><a name="line545" /> 545 # Returns a hash of common IP-based schemes and their default port
1167
- </span><span class="inferred0"><a name="line546" /> 546 # numbers. Adding new schemes to this hash, as necessary, will allow
1168
- </span><span class="inferred1"><a name="line547" /> 547 # for better URI normalization.
1169
- </span><span class="marked0"><a name="line548" /> 548 def self.scheme_mapping
1170
- </span><span class="marked1"><a name="line549" /> 549 if !defined?(@protocol_mapping) || @protocol_mapping.nil?
1171
- </span><span class="marked0"><a name="line550" /> 550 @protocol_mapping = {
1172
- </span><span class="inferred1"><a name="line551" /> 551 &quot;http&quot; =&gt; 80,
1173
- </span><span class="inferred0"><a name="line552" /> 552 &quot;https&quot; =&gt; 443,
1174
- </span><span class="inferred1"><a name="line553" /> 553 &quot;ftp&quot; =&gt; 21,
1175
- </span><span class="inferred0"><a name="line554" /> 554 &quot;tftp&quot; =&gt; 69,
1176
- </span><span class="inferred1"><a name="line555" /> 555 &quot;ssh&quot; =&gt; 22,
1177
- </span><span class="inferred0"><a name="line556" /> 556 &quot;svn+ssh&quot; =&gt; 22,
1178
- </span><span class="inferred1"><a name="line557" /> 557 &quot;telnet&quot; =&gt; 23,
1179
- </span><span class="inferred0"><a name="line558" /> 558 &quot;nntp&quot; =&gt; 119,
1180
- </span><span class="inferred1"><a name="line559" /> 559 &quot;gopher&quot; =&gt; 70,
1181
- </span><span class="inferred0"><a name="line560" /> 560 &quot;wais&quot; =&gt; 210,
1182
- </span><span class="inferred1"><a name="line561" /> 561 &quot;ldap&quot; =&gt; 389,
1183
- </span><span class="inferred0"><a name="line562" /> 562 &quot;prospero&quot; =&gt; 1525
1184
- </span><span class="inferred1"><a name="line563" /> 563 }
1185
- </span><span class="inferred0"><a name="line564" /> 564 end
1186
- </span><span class="marked1"><a name="line565" /> 565 return @protocol_mapping
1187
- </span><span class="inferred0"><a name="line566" /> 566 end
1188
- </span><span class="inferred1"><a name="line567" /> 567
1189
- </span><span class="inferred0"><a name="line568" /> 568 # Returns the port number for this URI. This method will normalize to the
1190
- </span><span class="inferred1"><a name="line569" /> 569 # default port for the URI's scheme if the port isn't explicitly specified
1191
- </span><span class="inferred0"><a name="line570" /> 570 # in the URI.
1192
- </span><span class="marked1"><a name="line571" /> 571 def port
1193
- </span><span class="marked0"><a name="line572" /> 572 if @port.to_i == 0
1194
- </span><span class="marked1"><a name="line573" /> 573 if self.scheme.nil?
1195
- </span><span class="marked0"><a name="line574" /> 574 @port = nil
1196
- </span><span class="inferred1"><a name="line575" /> 575 else
1197
- </span><span class="marked0"><a name="line576" /> 576 @port = self.class.scheme_mapping[self.scheme.strip.downcase]
1198
- </span><span class="inferred1"><a name="line577" /> 577 end
1199
- </span><span class="marked0"><a name="line578" /> 578 return @port
1200
- </span><span class="inferred1"><a name="line579" /> 579 else
1201
- </span><span class="marked0"><a name="line580" /> 580 @port = @port.to_i
1202
- </span><span class="marked1"><a name="line581" /> 581 return @port
1203
- </span><span class="inferred0"><a name="line582" /> 582 end
1204
- </span><span class="marked1"><a name="line583" /> 583 end
1205
- </span><span class="inferred0"><a name="line584" /> 584
1206
- </span><span class="inferred1"><a name="line585" /> 585 # Sets the port for this URI.
1207
- </span><span class="marked0"><a name="line586" /> 586 def port=(new_port)
1208
- </span><span class="marked1"><a name="line587" /> 587 @port = new_port.to_s.to_i
1209
- </span><span class="marked0"><a name="line588" /> 588 @specified_port = @port
1210
- </span><span class="marked1"><a name="line589" /> 589 @authority = nil
1211
- </span><span class="inferred0"><a name="line590" /> 590 end
1212
- </span><span class="inferred1"><a name="line591" /> 591
1213
- </span><span class="inferred0"><a name="line592" /> 592 # Returns the port number that was actually specified in the URI string.
1214
- </span><span class="marked1"><a name="line593" /> 593 def specified_port
1215
- </span><span class="marked0"><a name="line594" /> 594 port = @specified_port.to_s.to_i
1216
- </span><span class="marked1"><a name="line595" /> 595 if port == 0
1217
- </span><span class="marked0"><a name="line596" /> 596 return nil
1218
- </span><span class="inferred1"><a name="line597" /> 597 else
1219
- </span><span class="marked0"><a name="line598" /> 598 return port
1220
- </span><span class="inferred1"><a name="line599" /> 599 end
1221
- </span><span class="inferred0"><a name="line600" /> 600 end
1222
- </span><span class="inferred1"><a name="line601" /> 601
1223
- </span><span class="inferred0"><a name="line602" /> 602 # Returns the path for this URI.
1224
- </span><span class="marked1"><a name="line603" /> 603 def path
1225
- </span><span class="marked0"><a name="line604" /> 604 return @path
1226
- </span><span class="marked1"><a name="line605" /> 605 end
1227
- </span><span class="inferred0"><a name="line606" /> 606
1228
- </span><span class="inferred1"><a name="line607" /> 607 # Sets the path for this URI.
1229
- </span><span class="marked0"><a name="line608" /> 608 def path=(new_path)
1230
- </span><span class="marked1"><a name="line609" /> 609 @path = new_path
1231
- </span><span class="marked0"><a name="line610" /> 610 end
1232
- </span><span class="inferred1"><a name="line611" /> 611
1233
- </span><span class="inferred0"><a name="line612" /> 612 # Returns the basename, if any, of the file at the path being referenced.
1234
- </span><span class="inferred1"><a name="line613" /> 613 # Returns nil if there is no path component.
1235
- </span><span class="marked0"><a name="line614" /> 614 def basename
1236
- </span><span class="marked1"><a name="line615" /> 615 return nil if self.path == nil
1237
- </span><span class="marked0"><a name="line616" /> 616 return File.basename(self.path).gsub(/;[^\/]*$/, &quot;&quot;)
1238
- </span><span class="inferred1"><a name="line617" /> 617 end
1239
- </span><span class="inferred0"><a name="line618" /> 618
1240
- </span><span class="inferred1"><a name="line619" /> 619 # Returns the extension, if any, of the file at the path being referenced.
1241
- </span><span class="inferred0"><a name="line620" /> 620 # Returns &quot;&quot; if there is no extension or nil if there is no path
1242
- </span><span class="inferred1"><a name="line621" /> 621 # component.
1243
- </span><span class="marked0"><a name="line622" /> 622 def extname
1244
- </span><span class="marked1"><a name="line623" /> 623 return nil if self.path == nil
1245
- </span><span class="marked0"><a name="line624" /> 624 return File.extname(self.basename.gsub(/;[^\/]*$/, &quot;&quot;))
1246
- </span><span class="inferred1"><a name="line625" /> 625 end
1247
- </span><span class="inferred0"><a name="line626" /> 626
1248
- </span><span class="inferred1"><a name="line627" /> 627 # Returns the query string for this URI.
1249
- </span><span class="marked0"><a name="line628" /> 628 def query
1250
- </span><span class="marked1"><a name="line629" /> 629 return @query
1251
- </span><span class="marked0"><a name="line630" /> 630 end
1252
- </span><span class="inferred1"><a name="line631" /> 631
1253
- </span><span class="inferred0"><a name="line632" /> 632 # Sets the query string for this URI.
1254
- </span><span class="marked1"><a name="line633" /> 633 def query=(new_query)
1255
- </span><span class="marked0"><a name="line634" /> 634 @query = new_query
1256
- </span><span class="marked1"><a name="line635" /> 635 end
1257
- </span><span class="inferred0"><a name="line636" /> 636
1258
- </span><span class="inferred1"><a name="line637" /> 637 # Returns the fragment for this URI.
1259
- </span><span class="marked0"><a name="line638" /> 638 def fragment
1260
- </span><span class="marked1"><a name="line639" /> 639 return @fragment
1261
- </span><span class="marked0"><a name="line640" /> 640 end
1262
- </span><span class="inferred1"><a name="line641" /> 641
1263
- </span><span class="inferred0"><a name="line642" /> 642 # Sets the fragment for this URI.
1264
- </span><span class="marked1"><a name="line643" /> 643 def fragment=(new_fragment)
1265
- </span><span class="marked0"><a name="line644" /> 644 @fragment = new_fragment
1266
- </span><span class="marked1"><a name="line645" /> 645 end
1267
- </span><span class="inferred0"><a name="line646" /> 646
1268
- </span><span class="inferred1"><a name="line647" /> 647 # Returns true if the URI uses an IP-based protocol.
1269
- </span><span class="marked0"><a name="line648" /> 648 def ip_based?
1270
- </span><span class="marked1"><a name="line649" /> 649 return false if self.scheme.nil?
1271
- </span><span class="marked0"><a name="line650" /> 650 return self.class.ip_based_schemes.include?(self.scheme.strip.downcase)
1272
- </span><span class="inferred1"><a name="line651" /> 651 end
1273
- </span><span class="inferred0"><a name="line652" /> 652
1274
- </span><span class="inferred1"><a name="line653" /> 653 # Returns true if this URI is known to be relative.
1275
- </span><span class="marked0"><a name="line654" /> 654 def relative?
1276
- </span><span class="marked1"><a name="line655" /> 655 return self.scheme.nil?
1277
- </span><span class="marked0"><a name="line656" /> 656 end
1278
- </span><span class="inferred1"><a name="line657" /> 657
1279
- </span><span class="inferred0"><a name="line658" /> 658 # Returns true if this URI is known to be absolute.
1280
- </span><span class="marked1"><a name="line659" /> 659 def absolute?
1281
- </span><span class="marked0"><a name="line660" /> 660 return !relative?
1282
- </span><span class="marked1"><a name="line661" /> 661 end
1283
- </span><span class="inferred0"><a name="line662" /> 662
1284
- </span><span class="inferred1"><a name="line663" /> 663 # Joins two URIs together.
1285
- </span><span class="marked0"><a name="line664" /> 664 def +(uri)
1286
- </span><span class="marked1"><a name="line665" /> 665 if !uri.kind_of?(self.class)
1287
- </span><span class="marked0"><a name="line666" /> 666 uri = URI.parse(uri.to_s)
1288
- </span><span class="inferred1"><a name="line667" /> 667 end
1289
- </span><span class="marked0"><a name="line668" /> 668 if uri.to_s == &quot;&quot;
1290
- </span><span class="marked1"><a name="line669" /> 669 return self.dup
1291
- </span><span class="inferred0"><a name="line670" /> 670 end
1292
- </span><span class="inferred1"><a name="line671" /> 671
1293
- </span><span class="marked0"><a name="line672" /> 672 joined_scheme = nil
1294
- </span><span class="marked1"><a name="line673" /> 673 joined_user = nil
1295
- </span><span class="marked0"><a name="line674" /> 674 joined_password = nil
1296
- </span><span class="marked1"><a name="line675" /> 675 joined_host = nil
1297
- </span><span class="marked0"><a name="line676" /> 676 joined_port = nil
1298
- </span><span class="marked1"><a name="line677" /> 677 joined_path = nil
1299
- </span><span class="marked0"><a name="line678" /> 678 joined_query = nil
1300
- </span><span class="marked1"><a name="line679" /> 679 joined_fragment = nil
1301
- </span><span class="inferred0"><a name="line680" /> 680
1302
- </span><span class="inferred1"><a name="line681" /> 681 # Section 5.2.2 of RFC 3986
1303
- </span><span class="marked0"><a name="line682" /> 682 if uri.scheme != nil
1304
- </span><span class="marked1"><a name="line683" /> 683 joined_scheme = uri.scheme
1305
- </span><span class="marked0"><a name="line684" /> 684 joined_user = uri.user
1306
- </span><span class="marked1"><a name="line685" /> 685 joined_password = uri.password
1307
- </span><span class="marked0"><a name="line686" /> 686 joined_host = uri.host
1308
- </span><span class="marked1"><a name="line687" /> 687 joined_port = uri.specified_port
1309
- </span><span class="marked0"><a name="line688" /> 688 joined_path = self.class.normalize_path(uri.path)
1310
- </span><span class="marked1"><a name="line689" /> 689 joined_query = uri.query
1311
- </span><span class="inferred0"><a name="line690" /> 690 else
1312
- </span><span class="marked1"><a name="line691" /> 691 if uri.authority != nil
1313
- </span><span class="marked0"><a name="line692" /> 692 joined_user = uri.user
1314
- </span><span class="marked1"><a name="line693" /> 693 joined_password = uri.password
1315
- </span><span class="marked0"><a name="line694" /> 694 joined_host = uri.host
1316
- </span><span class="marked1"><a name="line695" /> 695 joined_port = uri.specified_port
1317
- </span><span class="marked0"><a name="line696" /> 696 joined_path = self.class.normalize_path(uri.path)
1318
- </span><span class="marked1"><a name="line697" /> 697 joined_query = uri.query
1319
- </span><span class="inferred0"><a name="line698" /> 698 else
1320
- </span><span class="marked1"><a name="line699" /> 699 if uri.path == nil || uri.path == &quot;&quot;
1321
- </span><span class="marked0"><a name="line700" /> 700 joined_path = self.path
1322
- </span><span class="marked1"><a name="line701" /> 701 if uri.query != nil
1323
- </span><span class="marked0"><a name="line702" /> 702 joined_query = uri.query
1324
- </span><span class="inferred1"><a name="line703" /> 703 else
1325
- </span><span class="marked0"><a name="line704" /> 704 joined_query = self.query
1326
- </span><span class="inferred1"><a name="line705" /> 705 end
1327
- </span><span class="inferred0"><a name="line706" /> 706 else
1328
- </span><span class="marked1"><a name="line707" /> 707 if uri.path[0..0] == &quot;/&quot;
1329
- </span><span class="marked0"><a name="line708" /> 708 joined_path = self.class.normalize_path(uri.path)
1330
- </span><span class="inferred1"><a name="line709" /> 709 else
1331
- </span><span class="marked0"><a name="line710" /> 710 base_path = self.path.nil? ? &quot;&quot; : self.path.dup
1332
- </span><span class="marked1"><a name="line711" /> 711 base_path = self.class.normalize_path(base_path)
1333
- </span><span class="marked0"><a name="line712" /> 712 base_path.gsub!(/\/[^\/]+$/, &quot;/&quot;)
1334
- </span><span class="marked1"><a name="line713" /> 713 joined_path = self.class.normalize_path(base_path + uri.path)
1335
- </span><span class="inferred0"><a name="line714" /> 714 end
1336
- </span><span class="marked1"><a name="line715" /> 715 joined_query = uri.query
1337
- </span><span class="inferred0"><a name="line716" /> 716 end
1338
- </span><span class="marked1"><a name="line717" /> 717 joined_user = self.user
1339
- </span><span class="marked0"><a name="line718" /> 718 joined_password = self.password
1340
- </span><span class="marked1"><a name="line719" /> 719 joined_host = self.host
1341
- </span><span class="marked0"><a name="line720" /> 720 joined_port = self.specified_port
1342
- </span><span class="inferred1"><a name="line721" /> 721 end
1343
- </span><span class="marked0"><a name="line722" /> 722 joined_scheme = self.scheme
1344
- </span><span class="inferred1"><a name="line723" /> 723 end
1345
- </span><span class="marked0"><a name="line724" /> 724 joined_fragment = uri.fragment
1346
- </span><span class="inferred1"><a name="line725" /> 725
1347
- </span><span class="marked0"><a name="line726" /> 726 return Addressable::URI.new(
1348
- </span><span class="inferred1"><a name="line727" /> 727 joined_scheme,
1349
- </span><span class="inferred0"><a name="line728" /> 728 joined_user,
1350
- </span><span class="inferred1"><a name="line729" /> 729 joined_password,
1351
- </span><span class="inferred0"><a name="line730" /> 730 joined_host,
1352
- </span><span class="inferred1"><a name="line731" /> 731 joined_port,
1353
- </span><span class="inferred0"><a name="line732" /> 732 joined_path,
1354
- </span><span class="inferred1"><a name="line733" /> 733 joined_query,
1355
- </span><span class="inferred0"><a name="line734" /> 734 joined_fragment
1356
- </span><span class="marked1"><a name="line735" /> 735 )
1357
- </span><span class="inferred0"><a name="line736" /> 736 end
1358
- </span><span class="inferred1"><a name="line737" /> 737
1359
- </span><span class="inferred0"><a name="line738" /> 738 # Merges two URIs together.
1360
- </span><span class="marked1"><a name="line739" /> 739 def merge(uri)
1361
- </span><span class="marked0"><a name="line740" /> 740 return self + uri
1362
- </span><span class="marked1"><a name="line741" /> 741 end
1363
- </span><span class="inferred0"><a name="line742" /> 742
1364
- </span><span class="inferred1"><a name="line743" /> 743 # Destructive form of merge.
1365
- </span><span class="marked0"><a name="line744" /> 744 def merge!(uri)
1366
- </span><span class="marked1"><a name="line745" /> 745 replace_self(self.merge(uri))
1367
- </span><span class="marked0"><a name="line746" /> 746 end
1368
- </span><span class="inferred1"><a name="line747" /> 747
1369
- </span><span class="inferred0"><a name="line748" /> 748 # Returns the shortest normalized relative form of this URI that uses the
1370
- </span><span class="inferred1"><a name="line749" /> 749 # supplied URI as a base for resolution. Returns an absolute URI if
1371
- </span><span class="inferred0"><a name="line750" /> 750 # necessary.
1372
- </span><span class="marked1"><a name="line751" /> 751 def route_from(uri)
1373
- </span><span class="marked0"><a name="line752" /> 752 uri = uri.kind_of?(self.class) ? uri : self.class.parse(uri.to_s)
1374
- </span><span class="marked1"><a name="line753" /> 753 uri = uri.normalize
1375
- </span><span class="marked0"><a name="line754" /> 754 normalized_self = self.normalize
1376
- </span><span class="marked1"><a name="line755" /> 755 if normalized_self.relative?
1377
- </span><span class="marked0"><a name="line756" /> 756 raise ArgumentError, &quot;Expected absolute URI, got: #{self.to_s}&quot;
1378
- </span><span class="inferred1"><a name="line757" /> 757 end
1379
- </span><span class="marked0"><a name="line758" /> 758 if uri.relative?
1380
- </span><span class="marked1"><a name="line759" /> 759 raise ArgumentError, &quot;Expected absolute URI, got: #{self.to_s}&quot;
1381
- </span><span class="inferred0"><a name="line760" /> 760 end
1382
- </span><span class="marked1"><a name="line761" /> 761 if normalized_self == uri
1383
- </span><span class="marked0"><a name="line762" /> 762 return Addressable::URI.parse(&quot;##{normalized_self.fragment}&quot;)
1384
- </span><span class="inferred1"><a name="line763" /> 763 end
1385
- </span><span class="marked0"><a name="line764" /> 764 segments = normalized_self.to_h
1386
- </span><span class="marked1"><a name="line765" /> 765 if normalized_self.scheme == uri.scheme
1387
- </span><span class="marked0"><a name="line766" /> 766 segments[:scheme] = nil
1388
- </span><span class="marked1"><a name="line767" /> 767 if normalized_self.authority == uri.authority
1389
- </span><span class="marked0"><a name="line768" /> 768 segments[:user] = nil
1390
- </span><span class="marked1"><a name="line769" /> 769 segments[:password] = nil
1391
- </span><span class="marked0"><a name="line770" /> 770 segments[:host] = nil
1392
- </span><span class="marked1"><a name="line771" /> 771 segments[:port] = nil
1393
- </span><span class="marked0"><a name="line772" /> 772 if normalized_self.path == uri.path
1394
- </span><span class="marked1"><a name="line773" /> 773 segments[:path] = nil
1395
- </span><span class="marked0"><a name="line774" /> 774 if normalized_self.query == uri.query
1396
- </span><span class="marked1"><a name="line775" /> 775 segments[:query] = nil
1397
- </span><span class="inferred0"><a name="line776" /> 776 end
1398
- </span><span class="inferred1"><a name="line777" /> 777 end
1399
- </span><span class="inferred0"><a name="line778" /> 778 end
1400
- </span><span class="inferred1"><a name="line779" /> 779 end
1401
- </span><span class="inferred0"><a name="line780" /> 780 # Avoid network-path references.
1402
- </span><span class="marked1"><a name="line781" /> 781 if segments[:scheme] == nil &amp;&amp; segments[:host] != nil
1403
- </span><span class="marked0"><a name="line782" /> 782 segments[:scheme] = normalized_self.scheme
1404
- </span><span class="inferred1"><a name="line783" /> 783 end
1405
- </span><span class="marked0"><a name="line784" /> 784 return Addressable::URI.new(
1406
- </span><span class="inferred1"><a name="line785" /> 785 segments[:scheme],
1407
- </span><span class="inferred0"><a name="line786" /> 786 segments[:user],
1408
- </span><span class="inferred1"><a name="line787" /> 787 segments[:password],
1409
- </span><span class="inferred0"><a name="line788" /> 788 segments[:host],
1410
- </span><span class="inferred1"><a name="line789" /> 789 segments[:port],
1411
- </span><span class="inferred0"><a name="line790" /> 790 segments[:path],
1412
- </span><span class="inferred1"><a name="line791" /> 791 segments[:query],
1413
- </span><span class="inferred0"><a name="line792" /> 792 segments[:fragment]
1414
- </span><span class="marked1"><a name="line793" /> 793 )
1415
- </span><span class="inferred0"><a name="line794" /> 794 end
1416
- </span><span class="inferred1"><a name="line795" /> 795
1417
- </span><span class="inferred0"><a name="line796" /> 796 # Returns the shortest normalized relative form of the supplied URI that
1418
- </span><span class="inferred1"><a name="line797" /> 797 # uses this URI as a base for resolution. Returns an absolute URI if
1419
- </span><span class="inferred0"><a name="line798" /> 798 # necessary.
1420
- </span><span class="marked1"><a name="line799" /> 799 def route_to(uri)
1421
- </span><span class="marked0"><a name="line800" /> 800 uri = uri.kind_of?(self.class) ? uri : self.class.parse(uri.to_s)
1422
- </span><span class="marked1"><a name="line801" /> 801 return uri.route_from(self)
1423
- </span><span class="inferred0"><a name="line802" /> 802 end
1424
- </span><span class="inferred1"><a name="line803" /> 803
1425
- </span><span class="inferred0"><a name="line804" /> 804 # Returns a normalized URI object.
1426
- </span><span class="inferred1"><a name="line805" /> 805 #
1427
- </span><span class="inferred0"><a name="line806" /> 806 # NOTE: This method does not attempt to fully conform to specifications.
1428
- </span><span class="inferred1"><a name="line807" /> 807 # It exists largely to correct other people's failures to read the
1429
- </span><span class="inferred0"><a name="line808" /> 808 # specifications, and also to deal with caching issues since several
1430
- </span><span class="inferred1"><a name="line809" /> 809 # different URIs may represent the same resource and should not be
1431
- </span><span class="inferred0"><a name="line810" /> 810 # cached multiple times.
1432
- </span><span class="marked1"><a name="line811" /> 811 def normalize
1433
- </span><span class="marked0"><a name="line812" /> 812 normalized_scheme = nil
1434
- </span><span class="marked1"><a name="line813" /> 813 normalized_scheme = self.scheme.strip.downcase if self.scheme != nil
1435
- </span><span class="marked0"><a name="line814" /> 814 normalized_scheme = &quot;svn+ssh&quot; if normalized_scheme == &quot;ssh+svn&quot;
1436
- </span><span class="marked1"><a name="line815" /> 815 if normalized_scheme == &quot;feed&quot;
1437
- </span><span class="marked0"><a name="line816" /> 816 if self.to_s =~ /^feed:\/*http:\/*/
1438
- </span><span class="marked1"><a name="line817" /> 817 return self.class.parse(
1439
- </span><span class="marked0"><a name="line818" /> 818 self.to_s.scan(/^feed:\/*(http:\/*.*)/).flatten[0]).normalize
1440
- </span><span class="inferred1"><a name="line819" /> 819 end
1441
- </span><span class="inferred0"><a name="line820" /> 820 end
1442
- </span><span class="marked1"><a name="line821" /> 821 normalized_user = nil
1443
- </span><span class="marked0"><a name="line822" /> 822 normalized_user = self.user.strip if self.user != nil
1444
- </span><span class="marked1"><a name="line823" /> 823 normalized_password = nil
1445
- </span><span class="marked0"><a name="line824" /> 824 normalized_password = self.password.strip if self.password != nil
1446
- </span><span class="marked1"><a name="line825" /> 825 normalized_host = nil
1447
- </span><span class="marked0"><a name="line826" /> 826 normalized_host = self.host.strip.downcase if self.host != nil
1448
- </span><span class="marked1"><a name="line827" /> 827 if normalized_host != nil
1449
- </span><span class="marked0"><a name="line828" /> 828 begin
1450
- </span><span class="marked1"><a name="line829" /> 829 normalized_host = URI::IDNA.to_ascii(normalized_host)
1451
- </span><span class="inferred0"><a name="line830" /> 830 rescue Exception
1452
- </span><span class="marked1"><a name="line831" /> 831 nil
1453
- </span><span class="inferred0"><a name="line832" /> 832 end
1454
- </span><span class="inferred1"><a name="line833" /> 833 end
1455
- </span><span class="inferred0"><a name="line834" /> 834
1456
- </span><span class="marked1"><a name="line835" /> 835 normalized_port = self.port
1457
- </span><span class="marked0"><a name="line836" /> 836 if self.class.scheme_mapping[normalized_scheme] == normalized_port
1458
- </span><span class="marked1"><a name="line837" /> 837 normalized_port = nil
1459
- </span><span class="inferred0"><a name="line838" /> 838 end
1460
- </span><span class="marked1"><a name="line839" /> 839 normalized_path = nil
1461
- </span><span class="marked0"><a name="line840" /> 840 normalized_path = self.path.strip if self.path != nil
1462
- </span><span class="inferred1"><a name="line841" /> 841 if normalized_path == nil &amp;&amp;
1463
- </span><span class="marked0"><a name="line842" /> 842 normalized_scheme != nil &amp;&amp;
1464
- </span><span class="inferred1"><a name="line843" /> 843 normalized_host != nil
1465
- </span><span class="marked0"><a name="line844" /> 844 normalized_path = &quot;/&quot;
1466
- </span><span class="inferred1"><a name="line845" /> 845 end
1467
- </span><span class="marked0"><a name="line846" /> 846 if normalized_path != nil
1468
- </span><span class="marked1"><a name="line847" /> 847 normalized_path = self.class.normalize_path(normalized_path)
1469
- </span><span class="inferred0"><a name="line848" /> 848 end
1470
- </span><span class="marked1"><a name="line849" /> 849 if normalized_path == &quot;&quot;
1471
- </span><span class="marked0"><a name="line850" /> 850 if [&quot;http&quot;, &quot;https&quot;, &quot;ftp&quot;, &quot;tftp&quot;].include?(normalized_scheme)
1472
- </span><span class="marked1"><a name="line851" /> 851 normalized_path = &quot;/&quot;
1473
- </span><span class="inferred0"><a name="line852" /> 852 end
1474
- </span><span class="inferred1"><a name="line853" /> 853 end
1475
- </span><span class="inferred0"><a name="line854" /> 854
1476
- </span><span class="marked1"><a name="line855" /> 855 normalized_query = nil
1477
- </span><span class="marked0"><a name="line856" /> 856 normalized_query = self.query.strip if self.query != nil
1478
- </span><span class="inferred1"><a name="line857" /> 857
1479
- </span><span class="marked0"><a name="line858" /> 858 normalized_fragment = nil
1480
- </span><span class="marked1"><a name="line859" /> 859 normalized_fragment = self.fragment.strip if self.fragment != nil
1481
- </span><span class="marked0"><a name="line860" /> 860 return Addressable::URI.parse(
1482
- </span><span class="marked1"><a name="line861" /> 861 Addressable::URI.normalized_encode(Addressable::URI.new(
1483
- </span><span class="inferred0"><a name="line862" /> 862 normalized_scheme,
1484
- </span><span class="inferred1"><a name="line863" /> 863 normalized_user,
1485
- </span><span class="inferred0"><a name="line864" /> 864 normalized_password,
1486
- </span><span class="inferred1"><a name="line865" /> 865 normalized_host,
1487
- </span><span class="inferred0"><a name="line866" /> 866 normalized_port,
1488
- </span><span class="inferred1"><a name="line867" /> 867 normalized_path,
1489
- </span><span class="inferred0"><a name="line868" /> 868 normalized_query,
1490
- </span><span class="inferred1"><a name="line869" /> 869 normalized_fragment
1491
- </span><span class="marked0"><a name="line870" /> 870 )))
1492
- </span><span class="inferred1"><a name="line871" /> 871 end
1493
- </span><span class="inferred0"><a name="line872" /> 872
1494
- </span><span class="inferred1"><a name="line873" /> 873 # Destructively normalizes this URI object.
1495
- </span><span class="marked0"><a name="line874" /> 874 def normalize!
1496
- </span><span class="marked1"><a name="line875" /> 875 replace_self(self.normalize)
1497
- </span><span class="marked0"><a name="line876" /> 876 end
1498
- </span><span class="inferred1"><a name="line877" /> 877
1499
- </span><span class="inferred0"><a name="line878" /> 878 # Creates a URI suitable for display to users. If semantic attacks are
1500
- </span><span class="inferred1"><a name="line879" /> 879 # likely, the application should try to detect these and warn the user.
1501
- </span><span class="inferred0"><a name="line880" /> 880 # See RFC 3986 section 7.6 for more information.
1502
- </span><span class="marked1"><a name="line881" /> 881 def display_uri
1503
- </span><span class="marked0"><a name="line882" /> 882 display_uri = self.normalize
1504
- </span><span class="marked1"><a name="line883" /> 883 begin
1505
- </span><span class="marked0"><a name="line884" /> 884 display_uri.instance_variable_set(&quot;@host&quot;,
1506
- </span><span class="marked1"><a name="line885" /> 885 URI::IDNA.to_unicode(display_uri.host))
1507
- </span><span class="inferred0"><a name="line886" /> 886 rescue Exception
1508
- </span><span class="marked1"><a name="line887" /> 887 nil
1509
- </span><span class="inferred0"><a name="line888" /> 888 end
1510
- </span><span class="marked1"><a name="line889" /> 889 return display_uri
1511
- </span><span class="inferred0"><a name="line890" /> 890 end
1512
- </span><span class="inferred1"><a name="line891" /> 891
1513
- </span><span class="inferred0"><a name="line892" /> 892 # Returns true if the URI objects are equal. This method normalizes
1514
- </span><span class="inferred1"><a name="line893" /> 893 # both URIs before doing the comparison, and allows comparison against
1515
- </span><span class="inferred0"><a name="line894" /> 894 # strings.
1516
- </span><span class="marked1"><a name="line895" /> 895 def ===(uri)
1517
- </span><span class="marked0"><a name="line896" /> 896 uri_string = nil
1518
- </span><span class="marked1"><a name="line897" /> 897 if uri.respond_to?(:normalize)
1519
- </span><span class="marked0"><a name="line898" /> 898 uri_string = uri.normalize.to_s
1520
- </span><span class="inferred1"><a name="line899" /> 899 else
1521
- </span><span class="marked0"><a name="line900" /> 900 begin
1522
- </span><span class="marked1"><a name="line901" /> 901 uri_string = URI.parse(uri.to_s).normalize.to_s
1523
- </span><span class="inferred0"><a name="line902" /> 902 rescue Exception
1524
- </span><span class="marked1"><a name="line903" /> 903 return false
1525
- </span><span class="inferred0"><a name="line904" /> 904 end
1526
- </span><span class="inferred1"><a name="line905" /> 905 end
1527
- </span><span class="marked0"><a name="line906" /> 906 return self.normalize.to_s == uri_string
1528
- </span><span class="inferred1"><a name="line907" /> 907 end
1529
- </span><span class="inferred0"><a name="line908" /> 908
1530
- </span><span class="inferred1"><a name="line909" /> 909 # Returns true if the URI objects are equal. This method normalizes
1531
- </span><span class="inferred0"><a name="line910" /> 910 # both URIs before doing the comparison.
1532
- </span><span class="marked1"><a name="line911" /> 911 def ==(uri)
1533
- </span><span class="marked0"><a name="line912" /> 912 return false unless uri.kind_of?(self.class)
1534
- </span><span class="marked1"><a name="line913" /> 913 return self.normalize.to_s == uri.normalize.to_s
1535
- </span><span class="inferred0"><a name="line914" /> 914 end
1536
- </span><span class="inferred1"><a name="line915" /> 915
1537
- </span><span class="inferred0"><a name="line916" /> 916 # Returns true if the URI objects are equal. This method does NOT
1538
- </span><span class="inferred1"><a name="line917" /> 917 # normalize either URI before doing the comparison.
1539
- </span><span class="marked0"><a name="line918" /> 918 def eql?(uri)
1540
- </span><span class="marked1"><a name="line919" /> 919 return false unless uri.kind_of?(self.class)
1541
- </span><span class="marked0"><a name="line920" /> 920 return self.to_s == uri.to_s
1542
- </span><span class="inferred1"><a name="line921" /> 921 end
1543
- </span><span class="inferred0"><a name="line922" /> 922
1544
- </span><span class="inferred1"><a name="line923" /> 923 # Clones the URI object.
1545
- </span><span class="marked0"><a name="line924" /> 924 def dup
1546
- </span><span class="marked1"><a name="line925" /> 925 duplicated_scheme = nil
1547
- </span><span class="marked0"><a name="line926" /> 926 duplicated_scheme = self.scheme.dup if self.scheme != nil
1548
- </span><span class="marked1"><a name="line927" /> 927 duplicated_user = nil
1549
- </span><span class="marked0"><a name="line928" /> 928 duplicated_user = self.user.dup if self.user != nil
1550
- </span><span class="marked1"><a name="line929" /> 929 duplicated_password = nil
1551
- </span><span class="marked0"><a name="line930" /> 930 duplicated_password = self.password.dup if self.password != nil
1552
- </span><span class="marked1"><a name="line931" /> 931 duplicated_host = nil
1553
- </span><span class="marked0"><a name="line932" /> 932 duplicated_host = self.host.dup if self.host != nil
1554
- </span><span class="marked1"><a name="line933" /> 933 duplicated_port = self.port
1555
- </span><span class="marked0"><a name="line934" /> 934 duplicated_path = nil
1556
- </span><span class="marked1"><a name="line935" /> 935 duplicated_path = self.path.dup if self.path != nil
1557
- </span><span class="marked0"><a name="line936" /> 936 duplicated_query = nil
1558
- </span><span class="marked1"><a name="line937" /> 937 duplicated_query = self.query.dup if self.query != nil
1559
- </span><span class="marked0"><a name="line938" /> 938 duplicated_fragment = nil
1560
- </span><span class="marked1"><a name="line939" /> 939 duplicated_fragment = self.fragment.dup if self.fragment != nil
1561
- </span><span class="marked0"><a name="line940" /> 940 duplicated_uri = Addressable::URI.new(
1562
- </span><span class="inferred1"><a name="line941" /> 941 duplicated_scheme,
1563
- </span><span class="inferred0"><a name="line942" /> 942 duplicated_user,
1564
- </span><span class="inferred1"><a name="line943" /> 943 duplicated_password,
1565
- </span><span class="inferred0"><a name="line944" /> 944 duplicated_host,
1566
- </span><span class="inferred1"><a name="line945" /> 945 duplicated_port,
1567
- </span><span class="inferred0"><a name="line946" /> 946 duplicated_path,
1568
- </span><span class="inferred1"><a name="line947" /> 947 duplicated_query,
1569
- </span><span class="inferred0"><a name="line948" /> 948 duplicated_fragment
1570
- </span><span class="inferred1"><a name="line949" /> 949 )
1571
- </span><span class="marked0"><a name="line950" /> 950 @specified_port = nil if !defined?(@specified_port)
1572
- </span><span class="marked1"><a name="line951" /> 951 duplicated_uri.instance_variable_set(&quot;@specified_port&quot;, @specified_port)
1573
- </span><span class="marked0"><a name="line952" /> 952 return duplicated_uri
1574
- </span><span class="inferred1"><a name="line953" /> 953 end
1575
- </span><span class="inferred0"><a name="line954" /> 954
1576
- </span><span class="inferred1"><a name="line955" /> 955 # Returns the assembled URI as a string.
1577
- </span><span class="marked0"><a name="line956" /> 956 def to_s
1578
- </span><span class="marked1"><a name="line957" /> 957 uri_string = &quot;&quot;
1579
- </span><span class="marked0"><a name="line958" /> 958 uri_string &lt;&lt; &quot;#{self.scheme}:&quot; if self.scheme != nil
1580
- </span><span class="marked1"><a name="line959" /> 959 uri_string &lt;&lt; &quot;//#{self.authority}&quot; if self.authority != nil
1581
- </span><span class="marked0"><a name="line960" /> 960 uri_string &lt;&lt; self.path.to_s
1582
- </span><span class="marked1"><a name="line961" /> 961 uri_string &lt;&lt; &quot;?#{self.query}&quot; if self.query != nil
1583
- </span><span class="marked0"><a name="line962" /> 962 uri_string &lt;&lt; &quot;##{self.fragment}&quot; if self.fragment != nil
1584
- </span><span class="marked1"><a name="line963" /> 963 return uri_string
1585
- </span><span class="inferred0"><a name="line964" /> 964 end
1586
- </span><span class="inferred1"><a name="line965" /> 965
1587
- </span><span class="inferred0"><a name="line966" /> 966 # Returns a Hash of the URI segments.
1588
- </span><span class="marked1"><a name="line967" /> 967 def to_h
1589
- </span><span class="inferred0"><a name="line968" /> 968 return {
1590
- </span><span class="marked1"><a name="line969" /> 969 :scheme =&gt; self.scheme,
1591
- </span><span class="marked0"><a name="line970" /> 970 :user =&gt; self.user,
1592
- </span><span class="marked1"><a name="line971" /> 971 :password =&gt; self.password,
1593
- </span><span class="marked0"><a name="line972" /> 972 :host =&gt; self.host,
1594
- </span><span class="marked1"><a name="line973" /> 973 :port =&gt; self.specified_port,
1595
- </span><span class="marked0"><a name="line974" /> 974 :path =&gt; self.path,
1596
- </span><span class="marked1"><a name="line975" /> 975 :query =&gt; self.query,
1597
- </span><span class="marked0"><a name="line976" /> 976 :fragment =&gt; self.fragment
1598
- </span><span class="marked1"><a name="line977" /> 977 }
1599
- </span><span class="marked0"><a name="line978" /> 978 end
1600
- </span><span class="inferred1"><a name="line979" /> 979
1601
- </span><span class="inferred0"><a name="line980" /> 980 # Returns a string representation of the URI object's state.
1602
- </span><span class="marked1"><a name="line981" /> 981 def inspect
1603
- </span><span class="marked0"><a name="line982" /> 982 sprintf(&quot;#&lt;%s:%#0x URI:%s&gt;&quot;, self.class.to_s, self.object_id, self.to_s)
1604
- </span><span class="marked1"><a name="line983" /> 983 end
1605
- </span><span class="inferred0"><a name="line984" /> 984
1606
- </span><span class="inferred1"><a name="line985" /> 985 # This module handles internationalized domain names. When Ruby has an
1607
- </span><span class="inferred0"><a name="line986" /> 986 # implementation of nameprep, stringprep, punycode, etc, this
1608
- </span><span class="inferred1"><a name="line987" /> 987 # module should contain an actual implementation of IDNA instead of
1609
- </span><span class="inferred0"><a name="line988" /> 988 # returning nil if libidn can't be used.
1610
- </span><span class="marked1"><a name="line989" /> 989 module IDNA
1611
- </span><span class="inferred0"><a name="line990" /> 990 # Returns the ascii representation of the label.
1612
- </span><span class="marked1"><a name="line991" /> 991 def self.to_ascii(label)
1613
- </span><span class="marked0"><a name="line992" /> 992 return nil if label.nil?
1614
- </span><span class="marked1"><a name="line993" /> 993 if self.use_libidn?
1615
- </span><span class="marked0"><a name="line994" /> 994 return IDN::Idna.toASCII(label)
1616
- </span><span class="inferred1"><a name="line995" /> 995 else
1617
- </span><span class="marked0"><a name="line996" /> 996 raise NotImplementedError,
1618
- </span><span class="inferred1"><a name="line997" /> 997 &quot;There is no available pure-ruby implementation. &quot; +
1619
- </span><span class="inferred0"><a name="line998" /> 998 &quot;Install libidn bindings.&quot;
1620
- </span><span class="inferred1"><a name="line999" /> 999 end
1621
- </span><span class="inferred0"><a name="line1000" />1000 end
1622
- </span><span class="inferred1"><a name="line1001" />1001
1623
- </span><span class="inferred0"><a name="line1002" />1002 # Returns the unicode representation of the label.
1624
- </span><span class="marked1"><a name="line1003" />1003 def self.to_unicode(label)
1625
- </span><span class="marked0"><a name="line1004" />1004 return nil if label.nil?
1626
- </span><span class="marked1"><a name="line1005" />1005 if self.use_libidn?
1627
- </span><span class="marked0"><a name="line1006" />1006 return IDN::Idna.toUnicode(label)
1628
- </span><span class="inferred1"><a name="line1007" />1007 else
1629
- </span><span class="marked0"><a name="line1008" />1008 raise NotImplementedError,
1630
- </span><span class="inferred1"><a name="line1009" />1009 &quot;There is no available pure-ruby implementation. &quot; +
1631
- </span><span class="inferred0"><a name="line1010" />1010 &quot;Install libidn bindings.&quot;
1632
- </span><span class="inferred1"><a name="line1011" />1011 end
1633
- </span><span class="inferred0"><a name="line1012" />1012 end
1634
- </span><span class="inferred1"><a name="line1013" />1013
1635
- </span><span class="marked0"><a name="line1014" />1014 private
1636
- </span><span class="inferred1"><a name="line1015" />1015 # Determines if the libidn bindings are available and able to be used.
1637
- </span><span class="marked0"><a name="line1016" />1016 def self.use_libidn?
1638
- </span><span class="marked1"><a name="line1017" />1017 if !defined?(@use_libidn) || @use_libidn.nil?
1639
- </span><span class="marked0"><a name="line1018" />1018 begin
1640
- </span><span class="marked1"><a name="line1019" />1019 require 'rubygems'
1641
- </span><span class="inferred0"><a name="line1020" />1020 rescue LoadError
1642
- </span><span class="marked1"><a name="line1021" />1021 nil
1643
- </span><span class="inferred0"><a name="line1022" />1022 end
1644
- </span><span class="marked1"><a name="line1023" />1023 begin
1645
- </span><span class="marked0"><a name="line1024" />1024 require 'idn'
1646
- </span><span class="inferred1"><a name="line1025" />1025 rescue LoadError
1647
- </span><span class="marked0"><a name="line1026" />1026 nil
1648
- </span><span class="inferred1"><a name="line1027" />1027 end
1649
- </span><span class="marked0"><a name="line1028" />1028 @use_libidn = !!(defined?(IDN::Idna))
1650
- </span><span class="inferred1"><a name="line1029" />1029 end
1651
- </span><span class="marked0"><a name="line1030" />1030 return @use_libidn
1652
- </span><span class="inferred1"><a name="line1031" />1031 end
1653
- </span><span class="inferred0"><a name="line1032" />1032 end
1654
- </span><span class="inferred1"><a name="line1033" />1033
1655
- </span><span class="marked0"><a name="line1034" />1034 private
1656
- </span><span class="inferred1"><a name="line1035" />1035 # Resolves paths to their simplest form.
1657
- </span><span class="marked0"><a name="line1036" />1036 def self.normalize_path(path)
1658
- </span><span class="marked1"><a name="line1037" />1037 return nil if path.nil?
1659
- </span><span class="marked0"><a name="line1038" />1038 normalized_path = path.dup
1660
- </span><span class="marked1"><a name="line1039" />1039 previous_state = normalized_path.dup
1661
- </span><span class="inferred0"><a name="line1040" />1040 begin
1662
- </span><span class="marked1"><a name="line1041" />1041 previous_state = normalized_path.dup
1663
- </span><span class="marked0"><a name="line1042" />1042 normalized_path.gsub!(/\/\.\//, &quot;/&quot;)
1664
- </span><span class="marked1"><a name="line1043" />1043 normalized_path.gsub!(/\/\.$/, &quot;/&quot;)
1665
- </span><span class="marked0"><a name="line1044" />1044 parent = normalized_path.scan(/\/([^\/]+)\/\.\.\//).flatten[0]
1666
- </span><span class="marked1"><a name="line1045" />1045 if parent != &quot;.&quot; &amp;&amp; parent != &quot;..&quot;
1667
- </span><span class="marked0"><a name="line1046" />1046 normalized_path.gsub!(/\/#{parent}\/\.\.\//, &quot;/&quot;)
1668
- </span><span class="inferred1"><a name="line1047" />1047 end
1669
- </span><span class="marked0"><a name="line1048" />1048 parent = normalized_path.scan(/\/([^\/]+)\/\.\.$/).flatten[0]
1670
- </span><span class="marked1"><a name="line1049" />1049 if parent != &quot;.&quot; &amp;&amp; parent != &quot;..&quot;
1671
- </span><span class="marked0"><a name="line1050" />1050 normalized_path.gsub!(/\/#{parent}\/\.\.$/, &quot;/&quot;)
1672
- </span><span class="inferred1"><a name="line1051" />1051 end
1673
- </span><span class="marked0"><a name="line1052" />1052 normalized_path.gsub!(/^\.\.?\/?/, &quot;&quot;)
1674
- </span><span class="marked1"><a name="line1053" />1053 normalized_path.gsub!(/^\/\.\.?\//, &quot;/&quot;)
1675
- </span><span class="marked0"><a name="line1054" />1054 end until previous_state == normalized_path
1676
- </span><span class="marked1"><a name="line1055" />1055 return normalized_path
1677
- </span><span class="inferred0"><a name="line1056" />1056 end
1678
- </span><span class="inferred1"><a name="line1057" />1057
1679
- </span><span class="inferred0"><a name="line1058" />1058 # Ensures that the URI is valid.
1680
- </span><span class="marked1"><a name="line1059" />1059 def validate
1681
- </span><span class="marked0"><a name="line1060" />1060 if self.scheme == nil &amp;&amp; self.user == nil &amp;&amp; self.password == nil &amp;&amp;
1682
- </span><span class="marked1"><a name="line1061" />1061 self.host == nil &amp;&amp; self.port == nil &amp;&amp; self.path == nil &amp;&amp;
1683
- </span><span class="marked0"><a name="line1062" />1062 self.query == nil &amp;&amp; self.fragment == nil
1684
- </span><span class="marked1"><a name="line1063" />1063 raise InvalidURIError, &quot;All segments were nil.&quot;
1685
- </span><span class="inferred0"><a name="line1064" />1064 end
1686
- </span><span class="marked1"><a name="line1065" />1065 if self.scheme != nil &amp;&amp;
1687
- </span><span class="marked0"><a name="line1066" />1066 (self.host == nil || self.host == &quot;&quot;) &amp;&amp;
1688
- </span><span class="marked1"><a name="line1067" />1067 (self.path == nil || self.path == &quot;&quot;)
1689
- </span><span class="marked0"><a name="line1068" />1068 raise InvalidURIError,
1690
- </span><span class="inferred1"><a name="line1069" />1069 &quot;Absolute URI missing hierarchical segment.&quot;
1691
- </span><span class="inferred0"><a name="line1070" />1070 end
1692
- </span><span class="inferred1"><a name="line1071" />1071 end
1693
- </span><span class="inferred0"><a name="line1072" />1072
1694
- </span><span class="inferred1"><a name="line1073" />1073 # Replaces the internal state of self with the specified URI's state.
1695
- </span><span class="inferred0"><a name="line1074" />1074 # Used in destructive operations to avoid massive code repetition.
1696
- </span><span class="marked1"><a name="line1075" />1075 def replace_self(uri)
1697
- </span><span class="inferred0"><a name="line1076" />1076 # Reset dependant values
1698
- </span><span class="marked1"><a name="line1077" />1077 @userinfo = nil
1699
- </span><span class="marked0"><a name="line1078" />1078 @authority = nil
1700
- </span><span class="inferred1"><a name="line1079" />1079
1701
- </span><span class="marked0"><a name="line1080" />1080 @scheme = uri.scheme
1702
- </span><span class="marked1"><a name="line1081" />1081 @user = uri.user
1703
- </span><span class="marked0"><a name="line1082" />1082 @password = uri.password
1704
- </span><span class="marked1"><a name="line1083" />1083 @host = uri.host
1705
- </span><span class="marked0"><a name="line1084" />1084 @specified_port = uri.instance_variable_get(&quot;@specified_port&quot;)
1706
- </span><span class="marked1"><a name="line1085" />1085 @port = @specified_port.to_s.to_i
1707
- </span><span class="marked0"><a name="line1086" />1086 @path = uri.path
1708
- </span><span class="marked1"><a name="line1087" />1087 @query = uri.query
1709
- </span><span class="marked0"><a name="line1088" />1088 @fragment = uri.fragment
1710
- </span><span class="marked1"><a name="line1089" />1089 return self
1711
- </span><span class="inferred0"><a name="line1090" />1090 end
1712
- </span><span class="inferred1"><a name="line1091" />1091 end
1713
- </span><span class="inferred0"><a name="line1092" />1092 end
791
+ </span><span class="inferred0"><a name="line170" /> 170 #
792
+ </span><span class="inferred1"><a name="line171" /> 171 # def self.transform(name, value)
793
+ </span><span class="inferred0"><a name="line172" /> 172 # return value.gsub(/ /, &quot;+&quot;) if name == &quot;query&quot;
794
+ </span><span class="inferred1"><a name="line173" /> 173 # return value
795
+ </span><span class="inferred0"><a name="line174" /> 174 # end
796
+ </span><span class="inferred1"><a name="line175" /> 175 # end
797
+ </span><span class="inferred0"><a name="line176" /> 176 #
798
+ </span><span class="inferred1"><a name="line177" /> 177 # Addressable::URI.expand_template(
799
+ </span><span class="inferred0"><a name="line178" /> 178 # &quot;http://example.com/search/{query}/&quot;,
800
+ </span><span class="inferred1"><a name="line179" /> 179 # {&quot;query&quot; =&gt; &quot;an example search query&quot;},
801
+ </span><span class="inferred0"><a name="line180" /> 180 # ExampleProcessor).to_s
802
+ </span><span class="inferred1"><a name="line181" /> 181 # =&gt; &quot;http://example.com/search/an+example+search+query/&quot;
803
+ </span><span class="marked0"><a name="line182" /> 182 def self.expand_template(pattern, mapping, processor=nil)
804
+ </span><span class="marked1"><a name="line183" /> 183 result = pattern.dup
805
+ </span><span class="marked0"><a name="line184" /> 184 for name, value in mapping
806
+ </span><span class="marked1"><a name="line185" /> 185 transformed_value = value
807
+ </span><span class="marked0"><a name="line186" /> 186 if processor != nil
808
+ </span><span class="marked1"><a name="line187" /> 187 if processor.respond_to?(:validate)
809
+ </span><span class="marked0"><a name="line188" /> 188 if !processor.validate(name, value)
810
+ </span><span class="marked1"><a name="line189" /> 189 raise InvalidTemplateValue,
811
+ </span><span class="inferred0"><a name="line190" /> 190 &quot;(#{name}, #{value}) is an invalid template value.&quot;
812
+ </span><span class="inferred1"><a name="line191" /> 191 end
813
+ </span><span class="inferred0"><a name="line192" /> 192 end
814
+ </span><span class="marked1"><a name="line193" /> 193 if processor.respond_to?(:transform)
815
+ </span><span class="marked0"><a name="line194" /> 194 transformed_value = processor.transform(name, value)
816
+ </span><span class="inferred1"><a name="line195" /> 195 end
817
+ </span><span class="inferred0"><a name="line196" /> 196 end
818
+ </span><span class="inferred1"><a name="line197" /> 197
819
+ </span><span class="inferred0"><a name="line198" /> 198 # Handle percent escaping
820
+ </span><span class="marked1"><a name="line199" /> 199 transformed_value = self.encode_segment(transformed_value,
821
+ </span><span class="inferred0"><a name="line200" /> 200 Addressable::URI::CharacterClasses::RESERVED +
822
+ </span><span class="inferred1"><a name="line201" /> 201 Addressable::URI::CharacterClasses::UNRESERVED)
823
+ </span><span class="inferred0"><a name="line202" /> 202
824
+ </span><span class="marked1"><a name="line203" /> 203 result.gsub!(/\{#{Regexp.escape(name)}\}/, transformed_value)
825
+ </span><span class="inferred0"><a name="line204" /> 204 end
826
+ </span><span class="marked1"><a name="line205" /> 205 result.gsub!(
827
+ </span><span class="inferred0"><a name="line206" /> 206 /\{[#{Addressable::URI::CharacterClasses::UNRESERVED}]+\}/, &quot;&quot;)
828
+ </span><span class="marked1"><a name="line207" /> 207 return Addressable::URI.parse(result)
829
+ </span><span class="inferred0"><a name="line208" /> 208 end
830
+ </span><span class="inferred1"><a name="line209" /> 209
831
+ </span><span class="inferred0"><a name="line210" /> 210 # Extracts a mapping from the URI using a URI Template pattern.
832
+ </span><span class="inferred1"><a name="line211" /> 211 # Returns nil if the pattern doesn't match the URI.
833
+ </span><span class="inferred0"><a name="line212" /> 212 #
834
+ </span><span class="inferred1"><a name="line213" /> 213 # An optional processor object may be supplied. The object should
835
+ </span><span class="inferred0"><a name="line214" /> 214 # respond to either the :restore or :match messages or both.
836
+ </span><span class="inferred1"><a name="line215" /> 215 # The :restore method should take two parameters: :name and :value.
837
+ </span><span class="inferred0"><a name="line216" /> 216 # The :restore method should reverse any transformations that have been
838
+ </span><span class="inferred1"><a name="line217" /> 217 # performed on the value to ensure a valid URI. The :match method
839
+ </span><span class="inferred0"><a name="line218" /> 218 # should take a single parameter: :name. The :match method should
840
+ </span><span class="inferred1"><a name="line219" /> 219 # return a String containing a regular expression capture group for
841
+ </span><span class="inferred0"><a name="line220" /> 220 # matching on that particular variable. The default value is &quot;.*&quot;.
842
+ </span><span class="inferred1"><a name="line221" /> 221 #
843
+ </span><span class="inferred0"><a name="line222" /> 222 # An example:
844
+ </span><span class="inferred1"><a name="line223" /> 223 #
845
+ </span><span class="inferred0"><a name="line224" /> 224 # class ExampleProcessor
846
+ </span><span class="inferred1"><a name="line225" /> 225 # def self.restore(name, value)
847
+ </span><span class="inferred0"><a name="line226" /> 226 # return value.gsub(/\+/, &quot; &quot;) if name == &quot;query&quot;
848
+ </span><span class="inferred1"><a name="line227" /> 227 # return value
849
+ </span><span class="inferred0"><a name="line228" /> 228 # end
850
+ </span><span class="inferred1"><a name="line229" /> 229 #
851
+ </span><span class="inferred0"><a name="line230" /> 230 # def self.match(name)
852
+ </span><span class="inferred1"><a name="line231" /> 231 # return &quot;.*?&quot; if name == &quot;first&quot;
853
+ </span><span class="inferred0"><a name="line232" /> 232 # return &quot;.*&quot;
854
+ </span><span class="inferred1"><a name="line233" /> 233 # end
855
+ </span><span class="inferred0"><a name="line234" /> 234 # end
856
+ </span><span class="inferred1"><a name="line235" /> 235 #
857
+ </span><span class="inferred0"><a name="line236" /> 236 # uri = Addressable::URI.parse(
858
+ </span><span class="inferred1"><a name="line237" /> 237 # &quot;http://example.com/search/an+example+search+query/&quot;)
859
+ </span><span class="inferred0"><a name="line238" /> 238 # uri.extract_mapping(&quot;http://example.com/search/{query}/&quot;,
860
+ </span><span class="inferred1"><a name="line239" /> 239 # ExampleProcessor)
861
+ </span><span class="inferred0"><a name="line240" /> 240 # =&gt; {&quot;query&quot; =&gt; &quot;an example search query&quot;}
862
+ </span><span class="inferred1"><a name="line241" /> 241 #
863
+ </span><span class="inferred0"><a name="line242" /> 242 # uri = Addressable::URI.parse(
864
+ </span><span class="inferred1"><a name="line243" /> 243 # &quot;http://example.com/a/b/c/&quot;)
865
+ </span><span class="inferred0"><a name="line244" /> 244 # uri.extract_mapping(&quot;http://example.com/{first}/{second}/&quot;,
866
+ </span><span class="inferred1"><a name="line245" /> 245 # ExampleProcessor)
867
+ </span><span class="inferred0"><a name="line246" /> 246 # =&gt; {&quot;first&quot; =&gt; &quot;a&quot;, &quot;second&quot; =&gt; &quot;b/c&quot;}
868
+ </span><span class="marked1"><a name="line247" /> 247 def extract_mapping(pattern, processor=nil)
869
+ </span><span class="marked0"><a name="line248" /> 248 mapping = {}
870
+ </span><span class="marked1"><a name="line249" /> 249 variable_regexp =
871
+ </span><span class="inferred0"><a name="line250" /> 250 /\{([#{Addressable::URI::CharacterClasses::UNRESERVED}]+)\}/
872
+ </span><span class="marked1"><a name="line251" /> 251 variables = pattern.scan(variable_regexp).flatten
873
+ </span><span class="marked0"><a name="line252" /> 252 variables.each { |v| mapping[v] = &quot;&quot; }
874
+ </span><span class="marked1"><a name="line253" /> 253 escaped_pattern =
875
+ </span><span class="inferred0"><a name="line254" /> 254 Regexp.escape(pattern).gsub(/\\\{/, &quot;{&quot;).gsub(/\\\}/, &quot;}&quot;)
876
+ </span><span class="marked1"><a name="line255" /> 255 regexp = Regexp.new(escaped_pattern.gsub(variable_regexp) do |v|
877
+ </span><span class="marked0"><a name="line256" /> 256 capture_group = &quot;(.*)&quot;
878
+ </span><span class="inferred1"><a name="line257" /> 257
879
+ </span><span class="marked0"><a name="line258" /> 258 if processor != nil
880
+ </span><span class="marked1"><a name="line259" /> 259 if processor.respond_to?(:match)
881
+ </span><span class="marked0"><a name="line260" /> 260 name = v.scan(variable_regexp).flatten[0]
882
+ </span><span class="marked1"><a name="line261" /> 261 capture_group = &quot;(#{processor.match(name)})&quot;
883
+ </span><span class="inferred0"><a name="line262" /> 262 end
884
+ </span><span class="inferred1"><a name="line263" /> 263 end
885
+ </span><span class="inferred0"><a name="line264" /> 264
886
+ </span><span class="marked1"><a name="line265" /> 265 capture_group
887
+ </span><span class="inferred0"><a name="line266" /> 266 end)
888
+ </span><span class="marked1"><a name="line267" /> 267 values = self.to_s.scan(regexp).flatten
889
+ </span><span class="marked0"><a name="line268" /> 268 if variables.size == values.size
890
+ </span><span class="marked1"><a name="line269" /> 269 for i in 0...variables.size
891
+ </span><span class="marked0"><a name="line270" /> 270 name = variables[i]
892
+ </span><span class="marked1"><a name="line271" /> 271 value = values[i]
893
+ </span><span class="inferred0"><a name="line272" /> 272
894
+ </span><span class="marked1"><a name="line273" /> 273 if processor != nil
895
+ </span><span class="marked0"><a name="line274" /> 274 if processor.respond_to?(:restore)
896
+ </span><span class="marked1"><a name="line275" /> 275 value = processor.restore(name, value)
897
+ </span><span class="inferred0"><a name="line276" /> 276 end
898
+ </span><span class="inferred1"><a name="line277" /> 277 end
899
+ </span><span class="inferred0"><a name="line278" /> 278
900
+ </span><span class="marked1"><a name="line279" /> 279 mapping[name] = value
901
+ </span><span class="inferred0"><a name="line280" /> 280 end
902
+ </span><span class="marked1"><a name="line281" /> 281 return mapping
903
+ </span><span class="inferred0"><a name="line282" /> 282 else
904
+ </span><span class="marked1"><a name="line283" /> 283 return nil
905
+ </span><span class="inferred0"><a name="line284" /> 284 end
906
+ </span><span class="inferred1"><a name="line285" /> 285 end
907
+ </span><span class="inferred0"><a name="line286" /> 286
908
+ </span><span class="inferred1"><a name="line287" /> 287 # Joins several uris together.
909
+ </span><span class="marked0"><a name="line288" /> 288 def self.join(*uris)
910
+ </span><span class="marked1"><a name="line289" /> 289 uri_objects = uris.collect do |uri|
911
+ </span><span class="marked0"><a name="line290" /> 290 uri.kind_of?(self) ? uri : self.parse(uri.to_s)
912
+ </span><span class="inferred1"><a name="line291" /> 291 end
913
+ </span><span class="marked0"><a name="line292" /> 292 result = uri_objects.shift.dup
914
+ </span><span class="marked1"><a name="line293" /> 293 for uri in uri_objects
915
+ </span><span class="marked0"><a name="line294" /> 294 result.merge!(uri)
916
+ </span><span class="inferred1"><a name="line295" /> 295 end
917
+ </span><span class="marked0"><a name="line296" /> 296 return result
918
+ </span><span class="inferred1"><a name="line297" /> 297 end
919
+ </span><span class="inferred0"><a name="line298" /> 298
920
+ </span><span class="inferred1"><a name="line299" /> 299 # Percent encodes a URI segment. Returns a string. Takes an optional
921
+ </span><span class="inferred0"><a name="line300" /> 300 # character class parameter, which should be specified as a string
922
+ </span><span class="inferred1"><a name="line301" /> 301 # containing a regular expression character class (not including the
923
+ </span><span class="inferred0"><a name="line302" /> 302 # surrounding square brackets). The character class parameter defaults
924
+ </span><span class="inferred1"><a name="line303" /> 303 # to the reserved plus unreserved character classes specified in
925
+ </span><span class="inferred0"><a name="line304" /> 304 # RFC 3986. Usage of the constants within the CharacterClasses module is
926
+ </span><span class="inferred1"><a name="line305" /> 305 # highly recommended when using this method.
927
+ </span><span class="inferred0"><a name="line306" /> 306 #
928
+ </span><span class="inferred1"><a name="line307" /> 307 # An example:
929
+ </span><span class="inferred0"><a name="line308" /> 308 #
930
+ </span><span class="inferred1"><a name="line309" /> 309 # Addressable::URI.escape_segment(&quot;simple-example&quot;, &quot;b-zB-Z0-9&quot;)
931
+ </span><span class="inferred0"><a name="line310" /> 310 # =&gt; &quot;simple%2Dex%61mple&quot;
932
+ </span><span class="marked1"><a name="line311" /> 311 def self.encode_segment(segment, character_class=
933
+ </span><span class="inferred0"><a name="line312" /> 312 Addressable::URI::CharacterClasses::RESERVED +
934
+ </span><span class="marked1"><a name="line313" /> 313 Addressable::URI::CharacterClasses::UNRESERVED)
935
+ </span><span class="marked0"><a name="line314" /> 314 return nil if segment.nil?
936
+ </span><span class="inferred1"><a name="line315" /> 315 return segment.gsub(
937
+ </span><span class="inferred0"><a name="line316" /> 316 /[^#{character_class}]/
938
+ </span><span class="inferred1"><a name="line317" /> 317 ) do |sequence|
939
+ </span><span class="marked0"><a name="line318" /> 318 (&quot;%&quot; + sequence.unpack('C')[0].to_s(16).upcase)
940
+ </span><span class="marked1"><a name="line319" /> 319 end
941
+ </span><span class="inferred0"><a name="line320" /> 320 end
942
+ </span><span class="inferred1"><a name="line321" /> 321
943
+ </span><span class="inferred0"><a name="line322" /> 322 # Unencodes any percent encoded characters within a URI segment.
944
+ </span><span class="inferred1"><a name="line323" /> 323 # Returns a string.
945
+ </span><span class="marked0"><a name="line324" /> 324 def self.unencode_segment(segment)
946
+ </span><span class="marked1"><a name="line325" /> 325 return nil if segment.nil?
947
+ </span><span class="inferred0"><a name="line326" /> 326 return segment.to_s.gsub(/%[0-9a-f]{2}/i) do |sequence|
948
+ </span><span class="marked1"><a name="line327" /> 327 sequence[1..3].to_i(16).chr
949
+ </span><span class="marked0"><a name="line328" /> 328 end
950
+ </span><span class="inferred1"><a name="line329" /> 329 end
951
+ </span><span class="inferred0"><a name="line330" /> 330
952
+ </span><span class="inferred1"><a name="line331" /> 331 # Percent encodes any special characters in the URI. This method does
953
+ </span><span class="inferred0"><a name="line332" /> 332 # not take IRIs or IDNs into account.
954
+ </span><span class="marked1"><a name="line333" /> 333 def self.encode(uri)
955
+ </span><span class="marked0"><a name="line334" /> 334 uri_object = uri.kind_of?(self) ? uri : self.parse(uri.to_s)
956
+ </span><span class="marked1"><a name="line335" /> 335 return Addressable::URI.new(
957
+ </span><span class="marked0"><a name="line336" /> 336 self.encode_segment(uri_object.scheme,
958
+ </span><span class="inferred1"><a name="line337" /> 337 Addressable::URI::CharacterClasses::SCHEME),
959
+ </span><span class="marked0"><a name="line338" /> 338 self.encode_segment(uri_object.user,
960
+ </span><span class="inferred1"><a name="line339" /> 339 Addressable::URI::CharacterClasses::AUTHORITY),
961
+ </span><span class="marked0"><a name="line340" /> 340 self.encode_segment(uri_object.password,
962
+ </span><span class="inferred1"><a name="line341" /> 341 Addressable::URI::CharacterClasses::AUTHORITY),
963
+ </span><span class="marked0"><a name="line342" /> 342 self.encode_segment(uri_object.host,
964
+ </span><span class="inferred1"><a name="line343" /> 343 Addressable::URI::CharacterClasses::AUTHORITY),
965
+ </span><span class="marked0"><a name="line344" /> 344 self.encode_segment(uri_object.specified_port,
966
+ </span><span class="inferred1"><a name="line345" /> 345 Addressable::URI::CharacterClasses::AUTHORITY),
967
+ </span><span class="marked0"><a name="line346" /> 346 self.encode_segment(uri_object.path,
968
+ </span><span class="inferred1"><a name="line347" /> 347 Addressable::URI::CharacterClasses::PATH),
969
+ </span><span class="marked0"><a name="line348" /> 348 self.encode_segment(uri_object.query,
970
+ </span><span class="inferred1"><a name="line349" /> 349 Addressable::URI::CharacterClasses::QUERY),
971
+ </span><span class="marked0"><a name="line350" /> 350 self.encode_segment(uri_object.fragment,
972
+ </span><span class="inferred1"><a name="line351" /> 351 Addressable::URI::CharacterClasses::FRAGMENT)
973
+ </span><span class="marked0"><a name="line352" /> 352 ).to_s
974
+ </span><span class="inferred1"><a name="line353" /> 353 end
975
+ </span><span class="inferred0"><a name="line354" /> 354
976
+ </span><span class="marked1"><a name="line355" /> 355 class &lt;&lt; self
977
+ </span><span class="marked0"><a name="line356" /> 356 alias_method :escape, :encode
978
+ </span><span class="inferred1"><a name="line357" /> 357 end
979
+ </span><span class="inferred0"><a name="line358" /> 358
980
+ </span><span class="inferred1"><a name="line359" /> 359 # Normalizes the encoding of a URI. Characters within a hostname are
981
+ </span><span class="inferred0"><a name="line360" /> 360 # not percent encoded to allow for internationalized domain names.
982
+ </span><span class="marked1"><a name="line361" /> 361 def self.normalized_encode(uri)
983
+ </span><span class="marked0"><a name="line362" /> 362 uri_object = uri.kind_of?(self) ? uri : self.parse(uri.to_s)
984
+ </span><span class="marked1"><a name="line363" /> 363 segments = {
985
+ </span><span class="marked0"><a name="line364" /> 364 :scheme =&gt; self.unencode_segment(uri_object.scheme),
986
+ </span><span class="marked1"><a name="line365" /> 365 :user =&gt; self.unencode_segment(uri_object.user),
987
+ </span><span class="marked0"><a name="line366" /> 366 :password =&gt; self.unencode_segment(uri_object.password),
988
+ </span><span class="marked1"><a name="line367" /> 367 :host =&gt; self.unencode_segment(uri_object.host),
989
+ </span><span class="marked0"><a name="line368" /> 368 :port =&gt; self.unencode_segment(uri_object.specified_port),
990
+ </span><span class="marked1"><a name="line369" /> 369 :path =&gt; self.unencode_segment(uri_object.path),
991
+ </span><span class="marked0"><a name="line370" /> 370 :query =&gt; self.unencode_segment(uri_object.query),
992
+ </span><span class="marked1"><a name="line371" /> 371 :fragment =&gt; self.unencode_segment(uri_object.fragment)
993
+ </span><span class="inferred0"><a name="line372" /> 372 }
994
+ </span><span class="marked1"><a name="line373" /> 373 if URI::IDNA.send(:use_libidn?)
995
+ </span><span class="marked0"><a name="line374" /> 374 segments.each do |key, value|
996
+ </span><span class="marked1"><a name="line375" /> 375 if value != nil
997
+ </span><span class="marked0"><a name="line376" /> 376 segments[key] = IDN::Stringprep.nfkc_normalize(value.to_s)
998
+ </span><span class="inferred1"><a name="line377" /> 377 end
999
+ </span><span class="inferred0"><a name="line378" /> 378 end
1000
+ </span><span class="inferred1"><a name="line379" /> 379 end
1001
+ </span><span class="marked0"><a name="line380" /> 380 return Addressable::URI.new(
1002
+ </span><span class="marked1"><a name="line381" /> 381 self.encode_segment(segments[:scheme],
1003
+ </span><span class="inferred0"><a name="line382" /> 382 Addressable::URI::CharacterClasses::SCHEME),
1004
+ </span><span class="marked1"><a name="line383" /> 383 self.encode_segment(segments[:user],
1005
+ </span><span class="inferred0"><a name="line384" /> 384 Addressable::URI::CharacterClasses::AUTHORITY),
1006
+ </span><span class="marked1"><a name="line385" /> 385 self.encode_segment(segments[:password],
1007
+ </span><span class="inferred0"><a name="line386" /> 386 Addressable::URI::CharacterClasses::AUTHORITY),
1008
+ </span><span class="inferred1"><a name="line387" /> 387 segments[:host],
1009
+ </span><span class="inferred0"><a name="line388" /> 388 segments[:port],
1010
+ </span><span class="marked1"><a name="line389" /> 389 self.encode_segment(segments[:path],
1011
+ </span><span class="inferred0"><a name="line390" /> 390 Addressable::URI::CharacterClasses::PATH),
1012
+ </span><span class="marked1"><a name="line391" /> 391 self.encode_segment(segments[:query],
1013
+ </span><span class="inferred0"><a name="line392" /> 392 Addressable::URI::CharacterClasses::QUERY),
1014
+ </span><span class="marked1"><a name="line393" /> 393 self.encode_segment(segments[:fragment],
1015
+ </span><span class="inferred0"><a name="line394" /> 394 Addressable::URI::CharacterClasses::FRAGMENT)
1016
+ </span><span class="marked1"><a name="line395" /> 395 ).to_s
1017
+ </span><span class="inferred0"><a name="line396" /> 396 end
1018
+ </span><span class="inferred1"><a name="line397" /> 397
1019
+ </span><span class="inferred0"><a name="line398" /> 398 # Extracts uris from an arbitrary body of text.
1020
+ </span><span class="marked1"><a name="line399" /> 399 def self.extract(text, options={})
1021
+ </span><span class="marked0"><a name="line400" /> 400 defaults = {:base =&gt; nil, :parse =&gt; false}
1022
+ </span><span class="marked1"><a name="line401" /> 401 options = defaults.merge(options)
1023
+ </span><span class="marked0"><a name="line402" /> 402 raise InvalidOptionError unless (options.keys - defaults.keys).empty?
1024
+ </span><span class="inferred1"><a name="line403" /> 403 # This regular expression needs to be less forgiving or else it would
1025
+ </span><span class="inferred0"><a name="line404" /> 404 # match virtually all text. Which isn't exactly what we're going for.
1026
+ </span><span class="marked1"><a name="line405" /> 405 extract_regex = /((([a-z\+]+):)[^ \n\&lt;\&gt;\&quot;\\]+[\w\/])/
1027
+ </span><span class="marked0"><a name="line406" /> 406 extracted_uris =
1028
+ </span><span class="marked1"><a name="line407" /> 407 text.scan(extract_regex).collect { |match| match[0] }
1029
+ </span><span class="marked0"><a name="line408" /> 408 sgml_extract_regex = /&lt;[^&gt;]+href=\&quot;([^\&quot;]+?)\&quot;[^&gt;]*&gt;/
1030
+ </span><span class="marked1"><a name="line409" /> 409 sgml_extracted_uris =
1031
+ </span><span class="inferred0"><a name="line410" /> 410 text.scan(sgml_extract_regex).collect { |match| match[0] }
1032
+ </span><span class="marked1"><a name="line411" /> 411 extracted_uris.concat(sgml_extracted_uris - extracted_uris)
1033
+ </span><span class="marked0"><a name="line412" /> 412 textile_extract_regex = /\&quot;.+?\&quot;:([^ ]+\/[^ ]+)[ \,\.\;\:\?\!\&lt;\&gt;\&quot;]/i
1034
+ </span><span class="marked1"><a name="line413" /> 413 textile_extracted_uris =
1035
+ </span><span class="inferred0"><a name="line414" /> 414 text.scan(textile_extract_regex).collect { |match| match[0] }
1036
+ </span><span class="marked1"><a name="line415" /> 415 extracted_uris.concat(textile_extracted_uris - extracted_uris)
1037
+ </span><span class="marked0"><a name="line416" /> 416 parsed_uris = []
1038
+ </span><span class="marked1"><a name="line417" /> 417 base_uri = nil
1039
+ </span><span class="marked0"><a name="line418" /> 418 if options[:base] != nil
1040
+ </span><span class="marked1"><a name="line419" /> 419 base_uri = options[:base] if options[:base].kind_of?(self)
1041
+ </span><span class="marked0"><a name="line420" /> 420 base_uri = self.parse(options[:base].to_s) if base_uri == nil
1042
+ </span><span class="inferred1"><a name="line421" /> 421 end
1043
+ </span><span class="marked0"><a name="line422" /> 422 for uri_string in extracted_uris
1044
+ </span><span class="marked1"><a name="line423" /> 423 begin
1045
+ </span><span class="marked0"><a name="line424" /> 424 if base_uri == nil
1046
+ </span><span class="marked1"><a name="line425" /> 425 parsed_uris &lt;&lt; self.parse(uri_string)
1047
+ </span><span class="inferred0"><a name="line426" /> 426 else
1048
+ </span><span class="marked1"><a name="line427" /> 427 parsed_uris &lt;&lt; (base_uri + self.parse(uri_string))
1049
+ </span><span class="inferred0"><a name="line428" /> 428 end
1050
+ </span><span class="inferred1"><a name="line429" /> 429 rescue Exception
1051
+ </span><span class="marked0"><a name="line430" /> 430 nil
1052
+ </span><span class="inferred1"><a name="line431" /> 431 end
1053
+ </span><span class="inferred0"><a name="line432" /> 432 end
1054
+ </span><span class="marked1"><a name="line433" /> 433 parsed_uris.reject! do |uri|
1055
+ </span><span class="marked0"><a name="line434" /> 434 (uri.scheme =~ /T\d+/ ||
1056
+ </span><span class="marked1"><a name="line435" /> 435 uri.scheme == &quot;xmlns&quot; ||
1057
+ </span><span class="marked0"><a name="line436" /> 436 uri.scheme == &quot;xml&quot; ||
1058
+ </span><span class="marked1"><a name="line437" /> 437 uri.scheme == &quot;thr&quot; ||
1059
+ </span><span class="marked0"><a name="line438" /> 438 uri.scheme == &quot;this&quot; ||
1060
+ </span><span class="marked1"><a name="line439" /> 439 uri.scheme == &quot;float&quot; ||
1061
+ </span><span class="marked0"><a name="line440" /> 440 uri.scheme == &quot;user&quot; ||
1062
+ </span><span class="marked1"><a name="line441" /> 441 uri.scheme == &quot;username&quot; ||
1063
+ </span><span class="marked0"><a name="line442" /> 442 uri.scheme == &quot;out&quot;)
1064
+ </span><span class="inferred1"><a name="line443" /> 443 end
1065
+ </span><span class="marked0"><a name="line444" /> 444 if options[:parse]
1066
+ </span><span class="marked1"><a name="line445" /> 445 return parsed_uris
1067
+ </span><span class="inferred0"><a name="line446" /> 446 else
1068
+ </span><span class="marked1"><a name="line447" /> 447 return parsed_uris.collect { |uri| uri.to_s }
1069
+ </span><span class="inferred0"><a name="line448" /> 448 end
1070
+ </span><span class="inferred1"><a name="line449" /> 449 end
1071
+ </span><span class="inferred0"><a name="line450" /> 450
1072
+ </span><span class="inferred1"><a name="line451" /> 451 # Creates a new uri object from component parts. Passing nil for
1073
+ </span><span class="inferred0"><a name="line452" /> 452 # any of these parameters is acceptable.
1074
+ </span><span class="marked1"><a name="line453" /> 453 def initialize(scheme, user, password, host, port, path, query, fragment)
1075
+ </span><span class="marked0"><a name="line454" /> 454 @scheme = scheme
1076
+ </span><span class="marked1"><a name="line455" /> 455 @scheme = nil if @scheme.to_s.strip == &quot;&quot;
1077
+ </span><span class="marked0"><a name="line456" /> 456 @user = user
1078
+ </span><span class="marked1"><a name="line457" /> 457 @password = password
1079
+ </span><span class="marked0"><a name="line458" /> 458 @host = host
1080
+ </span><span class="marked1"><a name="line459" /> 459 @specified_port = port.to_s
1081
+ </span><span class="marked0"><a name="line460" /> 460 @port = port
1082
+ </span><span class="marked1"><a name="line461" /> 461 @port = @port.to_s if @port.kind_of?(Fixnum)
1083
+ </span><span class="marked0"><a name="line462" /> 462 if @port != nil &amp;&amp; !(@port =~ /^\d+$/)
1084
+ </span><span class="marked1"><a name="line463" /> 463 raise InvalidURIError,
1085
+ </span><span class="inferred0"><a name="line464" /> 464 &quot;Invalid port number: #{@port.inspect}&quot;
1086
+ </span><span class="inferred1"><a name="line465" /> 465 end
1087
+ </span><span class="marked0"><a name="line466" /> 466 @port = @port.to_i
1088
+ </span><span class="marked1"><a name="line467" /> 467 @port = nil if @port == 0
1089
+ </span><span class="marked0"><a name="line468" /> 468 @path = path
1090
+ </span><span class="marked1"><a name="line469" /> 469 @query = query
1091
+ </span><span class="marked0"><a name="line470" /> 470 @fragment = fragment
1092
+ </span><span class="inferred1"><a name="line471" /> 471
1093
+ </span><span class="marked0"><a name="line472" /> 472 validate()
1094
+ </span><span class="inferred1"><a name="line473" /> 473 end
1095
+ </span><span class="inferred0"><a name="line474" /> 474
1096
+ </span><span class="inferred1"><a name="line475" /> 475 # Returns the scheme (protocol) for this URI.
1097
+ </span><span class="marked0"><a name="line476" /> 476 def scheme
1098
+ </span><span class="marked1"><a name="line477" /> 477 return @scheme
1099
+ </span><span class="marked0"><a name="line478" /> 478 end
1100
+ </span><span class="inferred1"><a name="line479" /> 479
1101
+ </span><span class="inferred0"><a name="line480" /> 480 # Sets the scheme (protocol for this URI.)
1102
+ </span><span class="marked1"><a name="line481" /> 481 def scheme=(new_scheme)
1103
+ </span><span class="marked0"><a name="line482" /> 482 @scheme = new_scheme
1104
+ </span><span class="marked1"><a name="line483" /> 483 end
1105
+ </span><span class="inferred0"><a name="line484" /> 484
1106
+ </span><span class="inferred1"><a name="line485" /> 485 # Returns the user for this URI.
1107
+ </span><span class="marked0"><a name="line486" /> 486 def user
1108
+ </span><span class="marked1"><a name="line487" /> 487 return @user
1109
+ </span><span class="marked0"><a name="line488" /> 488 end
1110
+ </span><span class="inferred1"><a name="line489" /> 489
1111
+ </span><span class="inferred0"><a name="line490" /> 490 # Sets the user for this URI.
1112
+ </span><span class="marked1"><a name="line491" /> 491 def user=(new_user)
1113
+ </span><span class="marked0"><a name="line492" /> 492 @user = new_user
1114
+ </span><span class="inferred1"><a name="line493" /> 493
1115
+ </span><span class="inferred0"><a name="line494" /> 494 # You can't have a nil user with a non-nil password
1116
+ </span><span class="marked1"><a name="line495" /> 495 if @password != nil
1117
+ </span><span class="marked0"><a name="line496" /> 496 @user = &quot;&quot; if @user.nil?
1118
+ </span><span class="inferred1"><a name="line497" /> 497 end
1119
+ </span><span class="inferred0"><a name="line498" /> 498
1120
+ </span><span class="inferred1"><a name="line499" /> 499 # Reset dependant values
1121
+ </span><span class="marked0"><a name="line500" /> 500 @userinfo = nil
1122
+ </span><span class="marked1"><a name="line501" /> 501 @authority = nil
1123
+ </span><span class="inferred0"><a name="line502" /> 502
1124
+ </span><span class="inferred1"><a name="line503" /> 503 # Ensure we haven't created an invalid URI
1125
+ </span><span class="marked0"><a name="line504" /> 504 validate()
1126
+ </span><span class="inferred1"><a name="line505" /> 505 end
1127
+ </span><span class="inferred0"><a name="line506" /> 506
1128
+ </span><span class="inferred1"><a name="line507" /> 507 # Returns the password for this URI.
1129
+ </span><span class="marked0"><a name="line508" /> 508 def password
1130
+ </span><span class="marked1"><a name="line509" /> 509 return @password
1131
+ </span><span class="marked0"><a name="line510" /> 510 end
1132
+ </span><span class="inferred1"><a name="line511" /> 511
1133
+ </span><span class="inferred0"><a name="line512" /> 512 # Sets the password for this URI.
1134
+ </span><span class="marked1"><a name="line513" /> 513 def password=(new_password)
1135
+ </span><span class="marked0"><a name="line514" /> 514 @password = new_password
1136
+ </span><span class="inferred1"><a name="line515" /> 515
1137
+ </span><span class="inferred0"><a name="line516" /> 516 # You can't have a nil user with a non-nil password
1138
+ </span><span class="marked1"><a name="line517" /> 517 if @password != nil
1139
+ </span><span class="marked0"><a name="line518" /> 518 @user = &quot;&quot; if @user.nil?
1140
+ </span><span class="inferred1"><a name="line519" /> 519 end
1141
+ </span><span class="inferred0"><a name="line520" /> 520
1142
+ </span><span class="inferred1"><a name="line521" /> 521 # Reset dependant values
1143
+ </span><span class="marked0"><a name="line522" /> 522 @userinfo = nil
1144
+ </span><span class="marked1"><a name="line523" /> 523 @authority = nil
1145
+ </span><span class="inferred0"><a name="line524" /> 524
1146
+ </span><span class="inferred1"><a name="line525" /> 525 # Ensure we haven't created an invalid URI
1147
+ </span><span class="marked0"><a name="line526" /> 526 validate()
1148
+ </span><span class="inferred1"><a name="line527" /> 527 end
1149
+ </span><span class="inferred0"><a name="line528" /> 528
1150
+ </span><span class="inferred1"><a name="line529" /> 529 # Returns the username and password segment of this URI.
1151
+ </span><span class="marked0"><a name="line530" /> 530 def userinfo
1152
+ </span><span class="marked1"><a name="line531" /> 531 if !defined?(@userinfo) || @userinfo.nil?
1153
+ </span><span class="marked0"><a name="line532" /> 532 current_user = self.user
1154
+ </span><span class="marked1"><a name="line533" /> 533 current_password = self.password
1155
+ </span><span class="marked0"><a name="line534" /> 534 if current_user == nil &amp;&amp; current_password == nil
1156
+ </span><span class="marked1"><a name="line535" /> 535 @userinfo = nil
1157
+ </span><span class="marked0"><a name="line536" /> 536 elsif current_user != nil &amp;&amp; current_password == nil
1158
+ </span><span class="marked1"><a name="line537" /> 537 @userinfo = &quot;#{current_user}&quot;
1159
+ </span><span class="marked0"><a name="line538" /> 538 elsif current_user != nil &amp;&amp; current_password != nil
1160
+ </span><span class="marked1"><a name="line539" /> 539 @userinfo = &quot;#{current_user}:#{current_password}&quot;
1161
+ </span><span class="inferred0"><a name="line540" /> 540 end
1162
+ </span><span class="inferred1"><a name="line541" /> 541 end
1163
+ </span><span class="marked0"><a name="line542" /> 542 return @userinfo
1164
+ </span><span class="inferred1"><a name="line543" /> 543 end
1165
+ </span><span class="inferred0"><a name="line544" /> 544
1166
+ </span><span class="inferred1"><a name="line545" /> 545 # Sets the username and password segment of this URI.
1167
+ </span><span class="marked0"><a name="line546" /> 546 def userinfo=(new_userinfo)
1168
+ </span><span class="marked1"><a name="line547" /> 547 new_user = new_userinfo.to_s.strip.scan(/^(.*):/).flatten[0]
1169
+ </span><span class="marked0"><a name="line548" /> 548 new_password = new_userinfo.to_s.strip.scan(/:(.*)$/).flatten[0]
1170
+ </span><span class="inferred1"><a name="line549" /> 549
1171
+ </span><span class="inferred0"><a name="line550" /> 550 # Password assigned first to ensure validity in case of nil
1172
+ </span><span class="marked1"><a name="line551" /> 551 self.password = new_password
1173
+ </span><span class="marked0"><a name="line552" /> 552 self.user = new_user
1174
+ </span><span class="inferred1"><a name="line553" /> 553
1175
+ </span><span class="inferred0"><a name="line554" /> 554 # Reset dependant values
1176
+ </span><span class="marked1"><a name="line555" /> 555 @authority = nil
1177
+ </span><span class="inferred0"><a name="line556" /> 556
1178
+ </span><span class="inferred1"><a name="line557" /> 557 # Ensure we haven't created an invalid URI
1179
+ </span><span class="marked0"><a name="line558" /> 558 validate()
1180
+ </span><span class="inferred1"><a name="line559" /> 559 end
1181
+ </span><span class="inferred0"><a name="line560" /> 560
1182
+ </span><span class="inferred1"><a name="line561" /> 561 # Returns the host for this URI.
1183
+ </span><span class="marked0"><a name="line562" /> 562 def host
1184
+ </span><span class="marked1"><a name="line563" /> 563 return @host
1185
+ </span><span class="marked0"><a name="line564" /> 564 end
1186
+ </span><span class="inferred1"><a name="line565" /> 565
1187
+ </span><span class="inferred0"><a name="line566" /> 566 # Sets the host for this URI.
1188
+ </span><span class="marked1"><a name="line567" /> 567 def host=(new_host)
1189
+ </span><span class="marked0"><a name="line568" /> 568 @host = new_host
1190
+ </span><span class="inferred1"><a name="line569" /> 569
1191
+ </span><span class="inferred0"><a name="line570" /> 570 # Reset dependant values
1192
+ </span><span class="marked1"><a name="line571" /> 571 @authority = nil
1193
+ </span><span class="inferred0"><a name="line572" /> 572
1194
+ </span><span class="inferred1"><a name="line573" /> 573 # Ensure we haven't created an invalid URI
1195
+ </span><span class="marked0"><a name="line574" /> 574 validate()
1196
+ </span><span class="inferred1"><a name="line575" /> 575 end
1197
+ </span><span class="inferred0"><a name="line576" /> 576
1198
+ </span><span class="inferred1"><a name="line577" /> 577 # Returns the authority segment of this URI.
1199
+ </span><span class="marked0"><a name="line578" /> 578 def authority
1200
+ </span><span class="marked1"><a name="line579" /> 579 if !defined?(@authority) || @authority.nil?
1201
+ </span><span class="marked0"><a name="line580" /> 580 return nil if self.host.nil?
1202
+ </span><span class="marked1"><a name="line581" /> 581 @authority = &quot;&quot;
1203
+ </span><span class="marked0"><a name="line582" /> 582 if self.userinfo != nil
1204
+ </span><span class="marked1"><a name="line583" /> 583 @authority &lt;&lt; &quot;#{self.userinfo}@&quot;
1205
+ </span><span class="inferred0"><a name="line584" /> 584 end
1206
+ </span><span class="marked1"><a name="line585" /> 585 @authority &lt;&lt; self.host
1207
+ </span><span class="marked0"><a name="line586" /> 586 if self.specified_port != nil
1208
+ </span><span class="marked1"><a name="line587" /> 587 @authority &lt;&lt; &quot;:#{self.specified_port}&quot;
1209
+ </span><span class="inferred0"><a name="line588" /> 588 end
1210
+ </span><span class="inferred1"><a name="line589" /> 589 end
1211
+ </span><span class="marked0"><a name="line590" /> 590 return @authority
1212
+ </span><span class="inferred1"><a name="line591" /> 591 end
1213
+ </span><span class="inferred0"><a name="line592" /> 592
1214
+ </span><span class="inferred1"><a name="line593" /> 593 # Sets the authority segment of this URI.
1215
+ </span><span class="marked0"><a name="line594" /> 594 def authority=(new_authority)
1216
+ </span><span class="marked1"><a name="line595" /> 595 if new_authority != nil
1217
+ </span><span class="marked0"><a name="line596" /> 596 new_userinfo = new_authority.scan(/^([^\[\]]*)@/).flatten[0]
1218
+ </span><span class="marked1"><a name="line597" /> 597 if new_userinfo != nil
1219
+ </span><span class="marked0"><a name="line598" /> 598 new_user = new_userinfo.strip.scan(/^([^:]*):?/).flatten[0]
1220
+ </span><span class="marked1"><a name="line599" /> 599 new_password = new_userinfo.strip.scan(/:(.*)$/).flatten[0]
1221
+ </span><span class="inferred0"><a name="line600" /> 600 end
1222
+ </span><span class="marked1"><a name="line601" /> 601 new_host =
1223
+ </span><span class="inferred0"><a name="line602" /> 602 new_authority.gsub(/^([^\[\]]*)@/, &quot;&quot;).gsub(/:([^:@\[\]]*?)$/, &quot;&quot;)
1224
+ </span><span class="marked1"><a name="line603" /> 603 new_port =
1225
+ </span><span class="inferred0"><a name="line604" /> 604 new_authority.scan(/:([^:@\[\]]*?)$/).flatten[0]
1226
+ </span><span class="inferred1"><a name="line605" /> 605 end
1227
+ </span><span class="marked0"><a name="line606" /> 606 new_port = nil if new_port == &quot;&quot;
1228
+ </span><span class="inferred1"><a name="line607" /> 607
1229
+ </span><span class="inferred0"><a name="line608" /> 608 # Password assigned first to ensure validity in case of nil
1230
+ </span><span class="marked1"><a name="line609" /> 609 self.password = new_password
1231
+ </span><span class="marked0"><a name="line610" /> 610 self.user = new_user
1232
+ </span><span class="marked1"><a name="line611" /> 611 self.host = new_host
1233
+ </span><span class="inferred0"><a name="line612" /> 612
1234
+ </span><span class="inferred1"><a name="line613" /> 613 # Port reset to allow port normalization
1235
+ </span><span class="marked0"><a name="line614" /> 614 @port = nil
1236
+ </span><span class="marked1"><a name="line615" /> 615 @specified_port = new_port
1237
+ </span><span class="inferred0"><a name="line616" /> 616
1238
+ </span><span class="inferred1"><a name="line617" /> 617 # Ensure we haven't created an invalid URI
1239
+ </span><span class="marked0"><a name="line618" /> 618 validate()
1240
+ </span><span class="inferred1"><a name="line619" /> 619 end
1241
+ </span><span class="inferred0"><a name="line620" /> 620
1242
+ </span><span class="inferred1"><a name="line621" /> 621 # Returns an array of known ip-based schemes. These schemes typically
1243
+ </span><span class="inferred0"><a name="line622" /> 622 # use a similar URI form:
1244
+ </span><span class="inferred1"><a name="line623" /> 623 # //&lt;user&gt;:&lt;password&gt;@&lt;host&gt;:&lt;port&gt;/&lt;url-path&gt;
1245
+ </span><span class="marked0"><a name="line624" /> 624 def self.ip_based_schemes
1246
+ </span><span class="marked1"><a name="line625" /> 625 return self.scheme_mapping.keys
1247
+ </span><span class="marked0"><a name="line626" /> 626 end
1248
+ </span><span class="inferred1"><a name="line627" /> 627
1249
+ </span><span class="inferred0"><a name="line628" /> 628 # Returns a hash of common IP-based schemes and their default port
1250
+ </span><span class="inferred1"><a name="line629" /> 629 # numbers. Adding new schemes to this hash, as necessary, will allow
1251
+ </span><span class="inferred0"><a name="line630" /> 630 # for better URI normalization.
1252
+ </span><span class="marked1"><a name="line631" /> 631 def self.scheme_mapping
1253
+ </span><span class="marked0"><a name="line632" /> 632 if !defined?(@protocol_mapping) || @protocol_mapping.nil?
1254
+ </span><span class="marked1"><a name="line633" /> 633 @protocol_mapping = {
1255
+ </span><span class="inferred0"><a name="line634" /> 634 &quot;http&quot; =&gt; 80,
1256
+ </span><span class="inferred1"><a name="line635" /> 635 &quot;https&quot; =&gt; 443,
1257
+ </span><span class="inferred0"><a name="line636" /> 636 &quot;ftp&quot; =&gt; 21,
1258
+ </span><span class="inferred1"><a name="line637" /> 637 &quot;tftp&quot; =&gt; 69,
1259
+ </span><span class="inferred0"><a name="line638" /> 638 &quot;ssh&quot; =&gt; 22,
1260
+ </span><span class="inferred1"><a name="line639" /> 639 &quot;svn+ssh&quot; =&gt; 22,
1261
+ </span><span class="inferred0"><a name="line640" /> 640 &quot;telnet&quot; =&gt; 23,
1262
+ </span><span class="inferred1"><a name="line641" /> 641 &quot;nntp&quot; =&gt; 119,
1263
+ </span><span class="inferred0"><a name="line642" /> 642 &quot;gopher&quot; =&gt; 70,
1264
+ </span><span class="inferred1"><a name="line643" /> 643 &quot;wais&quot; =&gt; 210,
1265
+ </span><span class="inferred0"><a name="line644" /> 644 &quot;ldap&quot; =&gt; 389,
1266
+ </span><span class="inferred1"><a name="line645" /> 645 &quot;prospero&quot; =&gt; 1525
1267
+ </span><span class="inferred0"><a name="line646" /> 646 }
1268
+ </span><span class="inferred1"><a name="line647" /> 647 end
1269
+ </span><span class="marked0"><a name="line648" /> 648 return @protocol_mapping
1270
+ </span><span class="inferred1"><a name="line649" /> 649 end
1271
+ </span><span class="inferred0"><a name="line650" /> 650
1272
+ </span><span class="inferred1"><a name="line651" /> 651 # Returns the port number for this URI. This method will normalize to the
1273
+ </span><span class="inferred0"><a name="line652" /> 652 # default port for the URI's scheme if the port isn't explicitly specified
1274
+ </span><span class="inferred1"><a name="line653" /> 653 # in the URI.
1275
+ </span><span class="marked0"><a name="line654" /> 654 def port
1276
+ </span><span class="marked1"><a name="line655" /> 655 if @port.to_i == 0
1277
+ </span><span class="marked0"><a name="line656" /> 656 if self.scheme.nil?
1278
+ </span><span class="marked1"><a name="line657" /> 657 @port = nil
1279
+ </span><span class="inferred0"><a name="line658" /> 658 else
1280
+ </span><span class="marked1"><a name="line659" /> 659 @port = self.class.scheme_mapping[self.scheme.strip.downcase]
1281
+ </span><span class="inferred0"><a name="line660" /> 660 end
1282
+ </span><span class="marked1"><a name="line661" /> 661 return @port
1283
+ </span><span class="inferred0"><a name="line662" /> 662 else
1284
+ </span><span class="marked1"><a name="line663" /> 663 @port = @port.to_i
1285
+ </span><span class="marked0"><a name="line664" /> 664 return @port
1286
+ </span><span class="inferred1"><a name="line665" /> 665 end
1287
+ </span><span class="marked0"><a name="line666" /> 666 end
1288
+ </span><span class="inferred1"><a name="line667" /> 667
1289
+ </span><span class="inferred0"><a name="line668" /> 668 # Sets the port for this URI.
1290
+ </span><span class="marked1"><a name="line669" /> 669 def port=(new_port)
1291
+ </span><span class="marked0"><a name="line670" /> 670 @port = new_port.to_s.to_i
1292
+ </span><span class="marked1"><a name="line671" /> 671 @specified_port = @port
1293
+ </span><span class="marked0"><a name="line672" /> 672 @authority = nil
1294
+ </span><span class="inferred1"><a name="line673" /> 673 end
1295
+ </span><span class="inferred0"><a name="line674" /> 674
1296
+ </span><span class="inferred1"><a name="line675" /> 675 # Returns the port number that was actually specified in the URI string.
1297
+ </span><span class="marked0"><a name="line676" /> 676 def specified_port
1298
+ </span><span class="marked1"><a name="line677" /> 677 port = @specified_port.to_s.to_i
1299
+ </span><span class="marked0"><a name="line678" /> 678 if port == 0
1300
+ </span><span class="marked1"><a name="line679" /> 679 return nil
1301
+ </span><span class="inferred0"><a name="line680" /> 680 else
1302
+ </span><span class="marked1"><a name="line681" /> 681 return port
1303
+ </span><span class="inferred0"><a name="line682" /> 682 end
1304
+ </span><span class="inferred1"><a name="line683" /> 683 end
1305
+ </span><span class="inferred0"><a name="line684" /> 684
1306
+ </span><span class="inferred1"><a name="line685" /> 685 # Returns the path for this URI.
1307
+ </span><span class="marked0"><a name="line686" /> 686 def path
1308
+ </span><span class="marked1"><a name="line687" /> 687 return @path
1309
+ </span><span class="marked0"><a name="line688" /> 688 end
1310
+ </span><span class="inferred1"><a name="line689" /> 689
1311
+ </span><span class="inferred0"><a name="line690" /> 690 # Sets the path for this URI.
1312
+ </span><span class="marked1"><a name="line691" /> 691 def path=(new_path)
1313
+ </span><span class="marked0"><a name="line692" /> 692 @path = new_path
1314
+ </span><span class="marked1"><a name="line693" /> 693 end
1315
+ </span><span class="inferred0"><a name="line694" /> 694
1316
+ </span><span class="inferred1"><a name="line695" /> 695 # Returns the basename, if any, of the file at the path being referenced.
1317
+ </span><span class="inferred0"><a name="line696" /> 696 # Returns nil if there is no path component.
1318
+ </span><span class="marked1"><a name="line697" /> 697 def basename
1319
+ </span><span class="marked0"><a name="line698" /> 698 return nil if self.path == nil
1320
+ </span><span class="marked1"><a name="line699" /> 699 return File.basename(self.path).gsub(/;[^\/]*$/, &quot;&quot;)
1321
+ </span><span class="inferred0"><a name="line700" /> 700 end
1322
+ </span><span class="inferred1"><a name="line701" /> 701
1323
+ </span><span class="inferred0"><a name="line702" /> 702 # Returns the extension, if any, of the file at the path being referenced.
1324
+ </span><span class="inferred1"><a name="line703" /> 703 # Returns &quot;&quot; if there is no extension or nil if there is no path
1325
+ </span><span class="inferred0"><a name="line704" /> 704 # component.
1326
+ </span><span class="marked1"><a name="line705" /> 705 def extname
1327
+ </span><span class="marked0"><a name="line706" /> 706 return nil if self.path == nil
1328
+ </span><span class="marked1"><a name="line707" /> 707 return File.extname(self.basename.gsub(/;[^\/]*$/, &quot;&quot;))
1329
+ </span><span class="inferred0"><a name="line708" /> 708 end
1330
+ </span><span class="inferred1"><a name="line709" /> 709
1331
+ </span><span class="inferred0"><a name="line710" /> 710 # Returns the query string for this URI.
1332
+ </span><span class="marked1"><a name="line711" /> 711 def query
1333
+ </span><span class="marked0"><a name="line712" /> 712 return @query
1334
+ </span><span class="marked1"><a name="line713" /> 713 end
1335
+ </span><span class="inferred0"><a name="line714" /> 714
1336
+ </span><span class="inferred1"><a name="line715" /> 715 # Sets the query string for this URI.
1337
+ </span><span class="marked0"><a name="line716" /> 716 def query=(new_query)
1338
+ </span><span class="marked1"><a name="line717" /> 717 @query = new_query
1339
+ </span><span class="marked0"><a name="line718" /> 718 end
1340
+ </span><span class="inferred1"><a name="line719" /> 719
1341
+ </span><span class="inferred0"><a name="line720" /> 720 # Returns the fragment for this URI.
1342
+ </span><span class="marked1"><a name="line721" /> 721 def fragment
1343
+ </span><span class="marked0"><a name="line722" /> 722 return @fragment
1344
+ </span><span class="marked1"><a name="line723" /> 723 end
1345
+ </span><span class="inferred0"><a name="line724" /> 724
1346
+ </span><span class="inferred1"><a name="line725" /> 725 # Sets the fragment for this URI.
1347
+ </span><span class="marked0"><a name="line726" /> 726 def fragment=(new_fragment)
1348
+ </span><span class="marked1"><a name="line727" /> 727 @fragment = new_fragment
1349
+ </span><span class="marked0"><a name="line728" /> 728 end
1350
+ </span><span class="inferred1"><a name="line729" /> 729
1351
+ </span><span class="inferred0"><a name="line730" /> 730 # Returns true if the URI uses an IP-based protocol.
1352
+ </span><span class="marked1"><a name="line731" /> 731 def ip_based?
1353
+ </span><span class="marked0"><a name="line732" /> 732 return false if self.scheme.nil?
1354
+ </span><span class="marked1"><a name="line733" /> 733 return self.class.ip_based_schemes.include?(self.scheme.strip.downcase)
1355
+ </span><span class="inferred0"><a name="line734" /> 734 end
1356
+ </span><span class="inferred1"><a name="line735" /> 735
1357
+ </span><span class="inferred0"><a name="line736" /> 736 # Returns true if this URI is known to be relative.
1358
+ </span><span class="marked1"><a name="line737" /> 737 def relative?
1359
+ </span><span class="marked0"><a name="line738" /> 738 return self.scheme.nil?
1360
+ </span><span class="marked1"><a name="line739" /> 739 end
1361
+ </span><span class="inferred0"><a name="line740" /> 740
1362
+ </span><span class="inferred1"><a name="line741" /> 741 # Returns true if this URI is known to be absolute.
1363
+ </span><span class="marked0"><a name="line742" /> 742 def absolute?
1364
+ </span><span class="marked1"><a name="line743" /> 743 return !relative?
1365
+ </span><span class="marked0"><a name="line744" /> 744 end
1366
+ </span><span class="inferred1"><a name="line745" /> 745
1367
+ </span><span class="inferred0"><a name="line746" /> 746 # Joins two URIs together.
1368
+ </span><span class="marked1"><a name="line747" /> 747 def +(uri)
1369
+ </span><span class="marked0"><a name="line748" /> 748 if !uri.kind_of?(self.class)
1370
+ </span><span class="marked1"><a name="line749" /> 749 uri = URI.parse(uri.to_s)
1371
+ </span><span class="inferred0"><a name="line750" /> 750 end
1372
+ </span><span class="marked1"><a name="line751" /> 751 if uri.to_s == &quot;&quot;
1373
+ </span><span class="marked0"><a name="line752" /> 752 return self.dup
1374
+ </span><span class="inferred1"><a name="line753" /> 753 end
1375
+ </span><span class="inferred0"><a name="line754" /> 754
1376
+ </span><span class="marked1"><a name="line755" /> 755 joined_scheme = nil
1377
+ </span><span class="marked0"><a name="line756" /> 756 joined_user = nil
1378
+ </span><span class="marked1"><a name="line757" /> 757 joined_password = nil
1379
+ </span><span class="marked0"><a name="line758" /> 758 joined_host = nil
1380
+ </span><span class="marked1"><a name="line759" /> 759 joined_port = nil
1381
+ </span><span class="marked0"><a name="line760" /> 760 joined_path = nil
1382
+ </span><span class="marked1"><a name="line761" /> 761 joined_query = nil
1383
+ </span><span class="marked0"><a name="line762" /> 762 joined_fragment = nil
1384
+ </span><span class="inferred1"><a name="line763" /> 763
1385
+ </span><span class="inferred0"><a name="line764" /> 764 # Section 5.2.2 of RFC 3986
1386
+ </span><span class="marked1"><a name="line765" /> 765 if uri.scheme != nil
1387
+ </span><span class="marked0"><a name="line766" /> 766 joined_scheme = uri.scheme
1388
+ </span><span class="marked1"><a name="line767" /> 767 joined_user = uri.user
1389
+ </span><span class="marked0"><a name="line768" /> 768 joined_password = uri.password
1390
+ </span><span class="marked1"><a name="line769" /> 769 joined_host = uri.host
1391
+ </span><span class="marked0"><a name="line770" /> 770 joined_port = uri.specified_port
1392
+ </span><span class="marked1"><a name="line771" /> 771 joined_path = self.class.normalize_path(uri.path)
1393
+ </span><span class="marked0"><a name="line772" /> 772 joined_query = uri.query
1394
+ </span><span class="inferred1"><a name="line773" /> 773 else
1395
+ </span><span class="marked0"><a name="line774" /> 774 if uri.authority != nil
1396
+ </span><span class="marked1"><a name="line775" /> 775 joined_user = uri.user
1397
+ </span><span class="marked0"><a name="line776" /> 776 joined_password = uri.password
1398
+ </span><span class="marked1"><a name="line777" /> 777 joined_host = uri.host
1399
+ </span><span class="marked0"><a name="line778" /> 778 joined_port = uri.specified_port
1400
+ </span><span class="marked1"><a name="line779" /> 779 joined_path = self.class.normalize_path(uri.path)
1401
+ </span><span class="marked0"><a name="line780" /> 780 joined_query = uri.query
1402
+ </span><span class="inferred1"><a name="line781" /> 781 else
1403
+ </span><span class="marked0"><a name="line782" /> 782 if uri.path == nil || uri.path == &quot;&quot;
1404
+ </span><span class="marked1"><a name="line783" /> 783 joined_path = self.path
1405
+ </span><span class="marked0"><a name="line784" /> 784 if uri.query != nil
1406
+ </span><span class="marked1"><a name="line785" /> 785 joined_query = uri.query
1407
+ </span><span class="inferred0"><a name="line786" /> 786 else
1408
+ </span><span class="marked1"><a name="line787" /> 787 joined_query = self.query
1409
+ </span><span class="inferred0"><a name="line788" /> 788 end
1410
+ </span><span class="inferred1"><a name="line789" /> 789 else
1411
+ </span><span class="marked0"><a name="line790" /> 790 if uri.path[0..0] == &quot;/&quot;
1412
+ </span><span class="marked1"><a name="line791" /> 791 joined_path = self.class.normalize_path(uri.path)
1413
+ </span><span class="inferred0"><a name="line792" /> 792 else
1414
+ </span><span class="marked1"><a name="line793" /> 793 base_path = self.path.nil? ? &quot;&quot; : self.path.dup
1415
+ </span><span class="marked0"><a name="line794" /> 794 base_path = self.class.normalize_path(base_path)
1416
+ </span><span class="marked1"><a name="line795" /> 795 base_path.gsub!(/\/[^\/]+$/, &quot;/&quot;)
1417
+ </span><span class="marked0"><a name="line796" /> 796 joined_path = self.class.normalize_path(base_path + uri.path)
1418
+ </span><span class="inferred1"><a name="line797" /> 797 end
1419
+ </span><span class="marked0"><a name="line798" /> 798 joined_query = uri.query
1420
+ </span><span class="inferred1"><a name="line799" /> 799 end
1421
+ </span><span class="marked0"><a name="line800" /> 800 joined_user = self.user
1422
+ </span><span class="marked1"><a name="line801" /> 801 joined_password = self.password
1423
+ </span><span class="marked0"><a name="line802" /> 802 joined_host = self.host
1424
+ </span><span class="marked1"><a name="line803" /> 803 joined_port = self.specified_port
1425
+ </span><span class="inferred0"><a name="line804" /> 804 end
1426
+ </span><span class="marked1"><a name="line805" /> 805 joined_scheme = self.scheme
1427
+ </span><span class="inferred0"><a name="line806" /> 806 end
1428
+ </span><span class="marked1"><a name="line807" /> 807 joined_fragment = uri.fragment
1429
+ </span><span class="inferred0"><a name="line808" /> 808
1430
+ </span><span class="marked1"><a name="line809" /> 809 return Addressable::URI.new(
1431
+ </span><span class="inferred0"><a name="line810" /> 810 joined_scheme,
1432
+ </span><span class="inferred1"><a name="line811" /> 811 joined_user,
1433
+ </span><span class="inferred0"><a name="line812" /> 812 joined_password,
1434
+ </span><span class="inferred1"><a name="line813" /> 813 joined_host,
1435
+ </span><span class="inferred0"><a name="line814" /> 814 joined_port,
1436
+ </span><span class="inferred1"><a name="line815" /> 815 joined_path,
1437
+ </span><span class="inferred0"><a name="line816" /> 816 joined_query,
1438
+ </span><span class="inferred1"><a name="line817" /> 817 joined_fragment
1439
+ </span><span class="marked0"><a name="line818" /> 818 )
1440
+ </span><span class="inferred1"><a name="line819" /> 819 end
1441
+ </span><span class="inferred0"><a name="line820" /> 820
1442
+ </span><span class="inferred1"><a name="line821" /> 821 # Merges two URIs together.
1443
+ </span><span class="marked0"><a name="line822" /> 822 def merge(uri)
1444
+ </span><span class="marked1"><a name="line823" /> 823 return self + uri
1445
+ </span><span class="marked0"><a name="line824" /> 824 end
1446
+ </span><span class="inferred1"><a name="line825" /> 825
1447
+ </span><span class="inferred0"><a name="line826" /> 826 # Destructive form of merge.
1448
+ </span><span class="marked1"><a name="line827" /> 827 def merge!(uri)
1449
+ </span><span class="marked0"><a name="line828" /> 828 replace_self(self.merge(uri))
1450
+ </span><span class="marked1"><a name="line829" /> 829 end
1451
+ </span><span class="inferred0"><a name="line830" /> 830
1452
+ </span><span class="inferred1"><a name="line831" /> 831 # Returns the shortest normalized relative form of this URI that uses the
1453
+ </span><span class="inferred0"><a name="line832" /> 832 # supplied URI as a base for resolution. Returns an absolute URI if
1454
+ </span><span class="inferred1"><a name="line833" /> 833 # necessary.
1455
+ </span><span class="marked0"><a name="line834" /> 834 def route_from(uri)
1456
+ </span><span class="marked1"><a name="line835" /> 835 uri = uri.kind_of?(self.class) ? uri : self.class.parse(uri.to_s)
1457
+ </span><span class="marked0"><a name="line836" /> 836 uri = uri.normalize
1458
+ </span><span class="marked1"><a name="line837" /> 837 normalized_self = self.normalize
1459
+ </span><span class="marked0"><a name="line838" /> 838 if normalized_self.relative?
1460
+ </span><span class="marked1"><a name="line839" /> 839 raise ArgumentError, &quot;Expected absolute URI, got: #{self.to_s}&quot;
1461
+ </span><span class="inferred0"><a name="line840" /> 840 end
1462
+ </span><span class="marked1"><a name="line841" /> 841 if uri.relative?
1463
+ </span><span class="marked0"><a name="line842" /> 842 raise ArgumentError, &quot;Expected absolute URI, got: #{self.to_s}&quot;
1464
+ </span><span class="inferred1"><a name="line843" /> 843 end
1465
+ </span><span class="marked0"><a name="line844" /> 844 if normalized_self == uri
1466
+ </span><span class="marked1"><a name="line845" /> 845 return Addressable::URI.parse(&quot;##{normalized_self.fragment}&quot;)
1467
+ </span><span class="inferred0"><a name="line846" /> 846 end
1468
+ </span><span class="marked1"><a name="line847" /> 847 segments = normalized_self.to_h
1469
+ </span><span class="marked0"><a name="line848" /> 848 if normalized_self.scheme == uri.scheme
1470
+ </span><span class="marked1"><a name="line849" /> 849 segments[:scheme] = nil
1471
+ </span><span class="marked0"><a name="line850" /> 850 if normalized_self.authority == uri.authority
1472
+ </span><span class="marked1"><a name="line851" /> 851 segments[:user] = nil
1473
+ </span><span class="marked0"><a name="line852" /> 852 segments[:password] = nil
1474
+ </span><span class="marked1"><a name="line853" /> 853 segments[:host] = nil
1475
+ </span><span class="marked0"><a name="line854" /> 854 segments[:port] = nil
1476
+ </span><span class="marked1"><a name="line855" /> 855 if normalized_self.path == uri.path
1477
+ </span><span class="marked0"><a name="line856" /> 856 segments[:path] = nil
1478
+ </span><span class="marked1"><a name="line857" /> 857 if normalized_self.query == uri.query
1479
+ </span><span class="marked0"><a name="line858" /> 858 segments[:query] = nil
1480
+ </span><span class="inferred1"><a name="line859" /> 859 end
1481
+ </span><span class="inferred0"><a name="line860" /> 860 end
1482
+ </span><span class="inferred1"><a name="line861" /> 861 end
1483
+ </span><span class="inferred0"><a name="line862" /> 862 end
1484
+ </span><span class="inferred1"><a name="line863" /> 863 # Avoid network-path references.
1485
+ </span><span class="marked0"><a name="line864" /> 864 if segments[:scheme] == nil &amp;&amp; segments[:host] != nil
1486
+ </span><span class="marked1"><a name="line865" /> 865 segments[:scheme] = normalized_self.scheme
1487
+ </span><span class="inferred0"><a name="line866" /> 866 end
1488
+ </span><span class="marked1"><a name="line867" /> 867 return Addressable::URI.new(
1489
+ </span><span class="inferred0"><a name="line868" /> 868 segments[:scheme],
1490
+ </span><span class="inferred1"><a name="line869" /> 869 segments[:user],
1491
+ </span><span class="inferred0"><a name="line870" /> 870 segments[:password],
1492
+ </span><span class="inferred1"><a name="line871" /> 871 segments[:host],
1493
+ </span><span class="inferred0"><a name="line872" /> 872 segments[:port],
1494
+ </span><span class="inferred1"><a name="line873" /> 873 segments[:path],
1495
+ </span><span class="inferred0"><a name="line874" /> 874 segments[:query],
1496
+ </span><span class="inferred1"><a name="line875" /> 875 segments[:fragment]
1497
+ </span><span class="marked0"><a name="line876" /> 876 )
1498
+ </span><span class="inferred1"><a name="line877" /> 877 end
1499
+ </span><span class="inferred0"><a name="line878" /> 878
1500
+ </span><span class="inferred1"><a name="line879" /> 879 # Returns the shortest normalized relative form of the supplied URI that
1501
+ </span><span class="inferred0"><a name="line880" /> 880 # uses this URI as a base for resolution. Returns an absolute URI if
1502
+ </span><span class="inferred1"><a name="line881" /> 881 # necessary.
1503
+ </span><span class="marked0"><a name="line882" /> 882 def route_to(uri)
1504
+ </span><span class="marked1"><a name="line883" /> 883 uri = uri.kind_of?(self.class) ? uri : self.class.parse(uri.to_s)
1505
+ </span><span class="marked0"><a name="line884" /> 884 return uri.route_from(self)
1506
+ </span><span class="inferred1"><a name="line885" /> 885 end
1507
+ </span><span class="inferred0"><a name="line886" /> 886
1508
+ </span><span class="inferred1"><a name="line887" /> 887 # Returns a normalized URI object.
1509
+ </span><span class="inferred0"><a name="line888" /> 888 #
1510
+ </span><span class="inferred1"><a name="line889" /> 889 # NOTE: This method does not attempt to fully conform to specifications.
1511
+ </span><span class="inferred0"><a name="line890" /> 890 # It exists largely to correct other people's failures to read the
1512
+ </span><span class="inferred1"><a name="line891" /> 891 # specifications, and also to deal with caching issues since several
1513
+ </span><span class="inferred0"><a name="line892" /> 892 # different URIs may represent the same resource and should not be
1514
+ </span><span class="inferred1"><a name="line893" /> 893 # cached multiple times.
1515
+ </span><span class="marked0"><a name="line894" /> 894 def normalize
1516
+ </span><span class="marked1"><a name="line895" /> 895 normalized_scheme = nil
1517
+ </span><span class="marked0"><a name="line896" /> 896 normalized_scheme = self.scheme.strip.downcase if self.scheme != nil
1518
+ </span><span class="marked1"><a name="line897" /> 897 normalized_scheme = &quot;svn+ssh&quot; if normalized_scheme == &quot;ssh+svn&quot;
1519
+ </span><span class="marked0"><a name="line898" /> 898 if normalized_scheme == &quot;feed&quot;
1520
+ </span><span class="marked1"><a name="line899" /> 899 if self.to_s =~ /^feed:\/*http:\/*/
1521
+ </span><span class="marked0"><a name="line900" /> 900 return self.class.parse(
1522
+ </span><span class="marked1"><a name="line901" /> 901 self.to_s.scan(/^feed:\/*(http:\/*.*)/).flatten[0]).normalize
1523
+ </span><span class="inferred0"><a name="line902" /> 902 end
1524
+ </span><span class="inferred1"><a name="line903" /> 903 end
1525
+ </span><span class="marked0"><a name="line904" /> 904 normalized_user = nil
1526
+ </span><span class="marked1"><a name="line905" /> 905 normalized_user = self.user.strip if self.user != nil
1527
+ </span><span class="marked0"><a name="line906" /> 906 normalized_password = nil
1528
+ </span><span class="marked1"><a name="line907" /> 907 normalized_password = self.password.strip if self.password != nil
1529
+ </span><span class="marked0"><a name="line908" /> 908 normalized_host = nil
1530
+ </span><span class="marked1"><a name="line909" /> 909 normalized_host = self.host.strip.downcase if self.host != nil
1531
+ </span><span class="marked0"><a name="line910" /> 910 if normalized_host != nil
1532
+ </span><span class="marked1"><a name="line911" /> 911 begin
1533
+ </span><span class="marked0"><a name="line912" /> 912 normalized_host = URI::IDNA.to_ascii(normalized_host)
1534
+ </span><span class="inferred1"><a name="line913" /> 913 rescue Exception
1535
+ </span><span class="marked0"><a name="line914" /> 914 nil
1536
+ </span><span class="inferred1"><a name="line915" /> 915 end
1537
+ </span><span class="inferred0"><a name="line916" /> 916 end
1538
+ </span><span class="inferred1"><a name="line917" /> 917
1539
+ </span><span class="marked0"><a name="line918" /> 918 normalized_port = self.port
1540
+ </span><span class="marked1"><a name="line919" /> 919 if self.class.scheme_mapping[normalized_scheme] == normalized_port
1541
+ </span><span class="marked0"><a name="line920" /> 920 normalized_port = nil
1542
+ </span><span class="inferred1"><a name="line921" /> 921 end
1543
+ </span><span class="marked0"><a name="line922" /> 922 normalized_path = nil
1544
+ </span><span class="marked1"><a name="line923" /> 923 normalized_path = self.path.strip if self.path != nil
1545
+ </span><span class="inferred0"><a name="line924" /> 924 if normalized_path == nil &amp;&amp;
1546
+ </span><span class="marked1"><a name="line925" /> 925 normalized_scheme != nil &amp;&amp;
1547
+ </span><span class="inferred0"><a name="line926" /> 926 normalized_host != nil
1548
+ </span><span class="marked1"><a name="line927" /> 927 normalized_path = &quot;/&quot;
1549
+ </span><span class="inferred0"><a name="line928" /> 928 end
1550
+ </span><span class="marked1"><a name="line929" /> 929 if normalized_path != nil
1551
+ </span><span class="marked0"><a name="line930" /> 930 normalized_path = self.class.normalize_path(normalized_path)
1552
+ </span><span class="inferred1"><a name="line931" /> 931 end
1553
+ </span><span class="marked0"><a name="line932" /> 932 if normalized_path == &quot;&quot;
1554
+ </span><span class="marked1"><a name="line933" /> 933 if [&quot;http&quot;, &quot;https&quot;, &quot;ftp&quot;, &quot;tftp&quot;].include?(normalized_scheme)
1555
+ </span><span class="marked0"><a name="line934" /> 934 normalized_path = &quot;/&quot;
1556
+ </span><span class="inferred1"><a name="line935" /> 935 end
1557
+ </span><span class="inferred0"><a name="line936" /> 936 end
1558
+ </span><span class="inferred1"><a name="line937" /> 937
1559
+ </span><span class="marked0"><a name="line938" /> 938 normalized_query = nil
1560
+ </span><span class="marked1"><a name="line939" /> 939 normalized_query = self.query.strip if self.query != nil
1561
+ </span><span class="inferred0"><a name="line940" /> 940
1562
+ </span><span class="marked1"><a name="line941" /> 941 normalized_fragment = nil
1563
+ </span><span class="marked0"><a name="line942" /> 942 normalized_fragment = self.fragment.strip if self.fragment != nil
1564
+ </span><span class="marked1"><a name="line943" /> 943 return Addressable::URI.parse(
1565
+ </span><span class="marked0"><a name="line944" /> 944 Addressable::URI.normalized_encode(Addressable::URI.new(
1566
+ </span><span class="inferred1"><a name="line945" /> 945 normalized_scheme,
1567
+ </span><span class="inferred0"><a name="line946" /> 946 normalized_user,
1568
+ </span><span class="inferred1"><a name="line947" /> 947 normalized_password,
1569
+ </span><span class="inferred0"><a name="line948" /> 948 normalized_host,
1570
+ </span><span class="inferred1"><a name="line949" /> 949 normalized_port,
1571
+ </span><span class="inferred0"><a name="line950" /> 950 normalized_path,
1572
+ </span><span class="inferred1"><a name="line951" /> 951 normalized_query,
1573
+ </span><span class="inferred0"><a name="line952" /> 952 normalized_fragment
1574
+ </span><span class="marked1"><a name="line953" /> 953 )))
1575
+ </span><span class="inferred0"><a name="line954" /> 954 end
1576
+ </span><span class="inferred1"><a name="line955" /> 955
1577
+ </span><span class="inferred0"><a name="line956" /> 956 # Destructively normalizes this URI object.
1578
+ </span><span class="marked1"><a name="line957" /> 957 def normalize!
1579
+ </span><span class="marked0"><a name="line958" /> 958 replace_self(self.normalize)
1580
+ </span><span class="marked1"><a name="line959" /> 959 end
1581
+ </span><span class="inferred0"><a name="line960" /> 960
1582
+ </span><span class="inferred1"><a name="line961" /> 961 # Creates a URI suitable for display to users. If semantic attacks are
1583
+ </span><span class="inferred0"><a name="line962" /> 962 # likely, the application should try to detect these and warn the user.
1584
+ </span><span class="inferred1"><a name="line963" /> 963 # See RFC 3986 section 7.6 for more information.
1585
+ </span><span class="marked0"><a name="line964" /> 964 def display_uri
1586
+ </span><span class="marked1"><a name="line965" /> 965 display_uri = self.normalize
1587
+ </span><span class="marked0"><a name="line966" /> 966 begin
1588
+ </span><span class="marked1"><a name="line967" /> 967 display_uri.instance_variable_set(&quot;@host&quot;,
1589
+ </span><span class="marked0"><a name="line968" /> 968 URI::IDNA.to_unicode(display_uri.host))
1590
+ </span><span class="inferred1"><a name="line969" /> 969 rescue Exception
1591
+ </span><span class="marked0"><a name="line970" /> 970 nil
1592
+ </span><span class="inferred1"><a name="line971" /> 971 end
1593
+ </span><span class="marked0"><a name="line972" /> 972 return display_uri
1594
+ </span><span class="inferred1"><a name="line973" /> 973 end
1595
+ </span><span class="inferred0"><a name="line974" /> 974
1596
+ </span><span class="inferred1"><a name="line975" /> 975 # Returns true if the URI objects are equal. This method normalizes
1597
+ </span><span class="inferred0"><a name="line976" /> 976 # both URIs before doing the comparison, and allows comparison against
1598
+ </span><span class="inferred1"><a name="line977" /> 977 # strings.
1599
+ </span><span class="marked0"><a name="line978" /> 978 def ===(uri)
1600
+ </span><span class="marked1"><a name="line979" /> 979 uri_string = nil
1601
+ </span><span class="marked0"><a name="line980" /> 980 if uri.respond_to?(:normalize)
1602
+ </span><span class="marked1"><a name="line981" /> 981 uri_string = uri.normalize.to_s
1603
+ </span><span class="inferred0"><a name="line982" /> 982 else
1604
+ </span><span class="marked1"><a name="line983" /> 983 begin
1605
+ </span><span class="marked0"><a name="line984" /> 984 uri_string = URI.parse(uri.to_s).normalize.to_s
1606
+ </span><span class="inferred1"><a name="line985" /> 985 rescue Exception
1607
+ </span><span class="marked0"><a name="line986" /> 986 return false
1608
+ </span><span class="inferred1"><a name="line987" /> 987 end
1609
+ </span><span class="inferred0"><a name="line988" /> 988 end
1610
+ </span><span class="marked1"><a name="line989" /> 989 return self.normalize.to_s == uri_string
1611
+ </span><span class="inferred0"><a name="line990" /> 990 end
1612
+ </span><span class="inferred1"><a name="line991" /> 991
1613
+ </span><span class="inferred0"><a name="line992" /> 992 # Returns true if the URI objects are equal. This method normalizes
1614
+ </span><span class="inferred1"><a name="line993" /> 993 # both URIs before doing the comparison.
1615
+ </span><span class="marked0"><a name="line994" /> 994 def ==(uri)
1616
+ </span><span class="marked1"><a name="line995" /> 995 return false unless uri.kind_of?(self.class)
1617
+ </span><span class="marked0"><a name="line996" /> 996 return self.normalize.to_s == uri.normalize.to_s
1618
+ </span><span class="inferred1"><a name="line997" /> 997 end
1619
+ </span><span class="inferred0"><a name="line998" /> 998
1620
+ </span><span class="inferred1"><a name="line999" /> 999 # Returns true if the URI objects are equal. This method does NOT
1621
+ </span><span class="inferred0"><a name="line1000" />1000 # normalize either URI before doing the comparison.
1622
+ </span><span class="marked1"><a name="line1001" />1001 def eql?(uri)
1623
+ </span><span class="marked0"><a name="line1002" />1002 return false unless uri.kind_of?(self.class)
1624
+ </span><span class="marked1"><a name="line1003" />1003 return self.to_s == uri.to_s
1625
+ </span><span class="inferred0"><a name="line1004" />1004 end
1626
+ </span><span class="inferred1"><a name="line1005" />1005
1627
+ </span><span class="inferred0"><a name="line1006" />1006 # Clones the URI object.
1628
+ </span><span class="marked1"><a name="line1007" />1007 def dup
1629
+ </span><span class="marked0"><a name="line1008" />1008 duplicated_scheme = nil
1630
+ </span><span class="marked1"><a name="line1009" />1009 duplicated_scheme = self.scheme.dup if self.scheme != nil
1631
+ </span><span class="marked0"><a name="line1010" />1010 duplicated_user = nil
1632
+ </span><span class="marked1"><a name="line1011" />1011 duplicated_user = self.user.dup if self.user != nil
1633
+ </span><span class="marked0"><a name="line1012" />1012 duplicated_password = nil
1634
+ </span><span class="marked1"><a name="line1013" />1013 duplicated_password = self.password.dup if self.password != nil
1635
+ </span><span class="marked0"><a name="line1014" />1014 duplicated_host = nil
1636
+ </span><span class="marked1"><a name="line1015" />1015 duplicated_host = self.host.dup if self.host != nil
1637
+ </span><span class="marked0"><a name="line1016" />1016 duplicated_port = self.port
1638
+ </span><span class="marked1"><a name="line1017" />1017 duplicated_path = nil
1639
+ </span><span class="marked0"><a name="line1018" />1018 duplicated_path = self.path.dup if self.path != nil
1640
+ </span><span class="marked1"><a name="line1019" />1019 duplicated_query = nil
1641
+ </span><span class="marked0"><a name="line1020" />1020 duplicated_query = self.query.dup if self.query != nil
1642
+ </span><span class="marked1"><a name="line1021" />1021 duplicated_fragment = nil
1643
+ </span><span class="marked0"><a name="line1022" />1022 duplicated_fragment = self.fragment.dup if self.fragment != nil
1644
+ </span><span class="marked1"><a name="line1023" />1023 duplicated_uri = Addressable::URI.new(
1645
+ </span><span class="inferred0"><a name="line1024" />1024 duplicated_scheme,
1646
+ </span><span class="inferred1"><a name="line1025" />1025 duplicated_user,
1647
+ </span><span class="inferred0"><a name="line1026" />1026 duplicated_password,
1648
+ </span><span class="inferred1"><a name="line1027" />1027 duplicated_host,
1649
+ </span><span class="inferred0"><a name="line1028" />1028 duplicated_port,
1650
+ </span><span class="inferred1"><a name="line1029" />1029 duplicated_path,
1651
+ </span><span class="inferred0"><a name="line1030" />1030 duplicated_query,
1652
+ </span><span class="inferred1"><a name="line1031" />1031 duplicated_fragment
1653
+ </span><span class="inferred0"><a name="line1032" />1032 )
1654
+ </span><span class="marked1"><a name="line1033" />1033 @specified_port = nil if !defined?(@specified_port)
1655
+ </span><span class="marked0"><a name="line1034" />1034 duplicated_uri.instance_variable_set(&quot;@specified_port&quot;, @specified_port)
1656
+ </span><span class="marked1"><a name="line1035" />1035 return duplicated_uri
1657
+ </span><span class="inferred0"><a name="line1036" />1036 end
1658
+ </span><span class="inferred1"><a name="line1037" />1037
1659
+ </span><span class="inferred0"><a name="line1038" />1038 # Returns the assembled URI as a string.
1660
+ </span><span class="marked1"><a name="line1039" />1039 def to_s
1661
+ </span><span class="marked0"><a name="line1040" />1040 uri_string = &quot;&quot;
1662
+ </span><span class="marked1"><a name="line1041" />1041 uri_string &lt;&lt; &quot;#{self.scheme}:&quot; if self.scheme != nil
1663
+ </span><span class="marked0"><a name="line1042" />1042 uri_string &lt;&lt; &quot;//#{self.authority}&quot; if self.authority != nil
1664
+ </span><span class="marked1"><a name="line1043" />1043 uri_string &lt;&lt; self.path.to_s
1665
+ </span><span class="marked0"><a name="line1044" />1044 uri_string &lt;&lt; &quot;?#{self.query}&quot; if self.query != nil
1666
+ </span><span class="marked1"><a name="line1045" />1045 uri_string &lt;&lt; &quot;##{self.fragment}&quot; if self.fragment != nil
1667
+ </span><span class="marked0"><a name="line1046" />1046 return uri_string
1668
+ </span><span class="inferred1"><a name="line1047" />1047 end
1669
+ </span><span class="inferred0"><a name="line1048" />1048
1670
+ </span><span class="inferred1"><a name="line1049" />1049 # Returns a Hash of the URI segments.
1671
+ </span><span class="marked0"><a name="line1050" />1050 def to_h
1672
+ </span><span class="inferred1"><a name="line1051" />1051 return {
1673
+ </span><span class="marked0"><a name="line1052" />1052 :scheme =&gt; self.scheme,
1674
+ </span><span class="marked1"><a name="line1053" />1053 :user =&gt; self.user,
1675
+ </span><span class="marked0"><a name="line1054" />1054 :password =&gt; self.password,
1676
+ </span><span class="marked1"><a name="line1055" />1055 :host =&gt; self.host,
1677
+ </span><span class="marked0"><a name="line1056" />1056 :port =&gt; self.specified_port,
1678
+ </span><span class="marked1"><a name="line1057" />1057 :path =&gt; self.path,
1679
+ </span><span class="marked0"><a name="line1058" />1058 :query =&gt; self.query,
1680
+ </span><span class="marked1"><a name="line1059" />1059 :fragment =&gt; self.fragment
1681
+ </span><span class="marked0"><a name="line1060" />1060 }
1682
+ </span><span class="marked1"><a name="line1061" />1061 end
1683
+ </span><span class="inferred0"><a name="line1062" />1062
1684
+ </span><span class="inferred1"><a name="line1063" />1063 # Returns a string representation of the URI object's state.
1685
+ </span><span class="marked0"><a name="line1064" />1064 def inspect
1686
+ </span><span class="marked1"><a name="line1065" />1065 sprintf(&quot;#&lt;%s:%#0x URI:%s&gt;&quot;, self.class.to_s, self.object_id, self.to_s)
1687
+ </span><span class="marked0"><a name="line1066" />1066 end
1688
+ </span><span class="inferred1"><a name="line1067" />1067
1689
+ </span><span class="inferred0"><a name="line1068" />1068 # This module handles internationalized domain names. When Ruby has an
1690
+ </span><span class="inferred1"><a name="line1069" />1069 # implementation of nameprep, stringprep, punycode, etc, this
1691
+ </span><span class="inferred0"><a name="line1070" />1070 # module should contain an actual implementation of IDNA instead of
1692
+ </span><span class="inferred1"><a name="line1071" />1071 # returning nil if libidn can't be used.
1693
+ </span><span class="marked0"><a name="line1072" />1072 module IDNA
1694
+ </span><span class="inferred1"><a name="line1073" />1073 # Returns the ascii representation of the label.
1695
+ </span><span class="marked0"><a name="line1074" />1074 def self.to_ascii(label)
1696
+ </span><span class="marked1"><a name="line1075" />1075 return nil if label.nil?
1697
+ </span><span class="marked0"><a name="line1076" />1076 if self.use_libidn?
1698
+ </span><span class="marked1"><a name="line1077" />1077 return IDN::Idna.toASCII(label)
1699
+ </span><span class="inferred0"><a name="line1078" />1078 else
1700
+ </span><span class="marked1"><a name="line1079" />1079 raise NotImplementedError,
1701
+ </span><span class="inferred0"><a name="line1080" />1080 &quot;There is no available pure-ruby implementation. &quot; +
1702
+ </span><span class="inferred1"><a name="line1081" />1081 &quot;Install libidn bindings.&quot;
1703
+ </span><span class="inferred0"><a name="line1082" />1082 end
1704
+ </span><span class="inferred1"><a name="line1083" />1083 end
1705
+ </span><span class="inferred0"><a name="line1084" />1084
1706
+ </span><span class="inferred1"><a name="line1085" />1085 # Returns the unicode representation of the label.
1707
+ </span><span class="marked0"><a name="line1086" />1086 def self.to_unicode(label)
1708
+ </span><span class="marked1"><a name="line1087" />1087 return nil if label.nil?
1709
+ </span><span class="marked0"><a name="line1088" />1088 if self.use_libidn?
1710
+ </span><span class="marked1"><a name="line1089" />1089 return IDN::Idna.toUnicode(label)
1711
+ </span><span class="inferred0"><a name="line1090" />1090 else
1712
+ </span><span class="marked1"><a name="line1091" />1091 raise NotImplementedError,
1713
+ </span><span class="inferred0"><a name="line1092" />1092 &quot;There is no available pure-ruby implementation. &quot; +
1714
+ </span><span class="inferred1"><a name="line1093" />1093 &quot;Install libidn bindings.&quot;
1715
+ </span><span class="inferred0"><a name="line1094" />1094 end
1716
+ </span><span class="inferred1"><a name="line1095" />1095 end
1717
+ </span><span class="inferred0"><a name="line1096" />1096
1718
+ </span><span class="marked1"><a name="line1097" />1097 private
1719
+ </span><span class="inferred0"><a name="line1098" />1098 # Determines if the libidn bindings are available and able to be used.
1720
+ </span><span class="marked1"><a name="line1099" />1099 def self.use_libidn?
1721
+ </span><span class="marked0"><a name="line1100" />1100 if !defined?(@use_libidn) || @use_libidn.nil?
1722
+ </span><span class="marked1"><a name="line1101" />1101 begin
1723
+ </span><span class="marked0"><a name="line1102" />1102 require 'rubygems'
1724
+ </span><span class="inferred1"><a name="line1103" />1103 rescue LoadError
1725
+ </span><span class="marked0"><a name="line1104" />1104 nil
1726
+ </span><span class="inferred1"><a name="line1105" />1105 end
1727
+ </span><span class="marked0"><a name="line1106" />1106 begin
1728
+ </span><span class="marked1"><a name="line1107" />1107 require 'idn'
1729
+ </span><span class="inferred0"><a name="line1108" />1108 rescue LoadError
1730
+ </span><span class="marked1"><a name="line1109" />1109 nil
1731
+ </span><span class="inferred0"><a name="line1110" />1110 end
1732
+ </span><span class="marked1"><a name="line1111" />1111 @use_libidn = !!(defined?(IDN::Idna))
1733
+ </span><span class="inferred0"><a name="line1112" />1112 end
1734
+ </span><span class="marked1"><a name="line1113" />1113 return @use_libidn
1735
+ </span><span class="inferred0"><a name="line1114" />1114 end
1736
+ </span><span class="inferred1"><a name="line1115" />1115 end
1737
+ </span><span class="inferred0"><a name="line1116" />1116
1738
+ </span><span class="marked1"><a name="line1117" />1117 private
1739
+ </span><span class="inferred0"><a name="line1118" />1118 # Resolves paths to their simplest form.
1740
+ </span><span class="marked1"><a name="line1119" />1119 def self.normalize_path(path)
1741
+ </span><span class="marked0"><a name="line1120" />1120 return nil if path.nil?
1742
+ </span><span class="marked1"><a name="line1121" />1121 normalized_path = path.dup
1743
+ </span><span class="marked0"><a name="line1122" />1122 previous_state = normalized_path.dup
1744
+ </span><span class="inferred1"><a name="line1123" />1123 begin
1745
+ </span><span class="marked0"><a name="line1124" />1124 previous_state = normalized_path.dup
1746
+ </span><span class="marked1"><a name="line1125" />1125 normalized_path.gsub!(/\/\.\//, &quot;/&quot;)
1747
+ </span><span class="marked0"><a name="line1126" />1126 normalized_path.gsub!(/\/\.$/, &quot;/&quot;)
1748
+ </span><span class="marked1"><a name="line1127" />1127 parent = normalized_path.scan(/\/([^\/]+)\/\.\.\//).flatten[0]
1749
+ </span><span class="marked0"><a name="line1128" />1128 if parent != &quot;.&quot; &amp;&amp; parent != &quot;..&quot;
1750
+ </span><span class="marked1"><a name="line1129" />1129 normalized_path.gsub!(/\/#{parent}\/\.\.\//, &quot;/&quot;)
1751
+ </span><span class="inferred0"><a name="line1130" />1130 end
1752
+ </span><span class="marked1"><a name="line1131" />1131 parent = normalized_path.scan(/\/([^\/]+)\/\.\.$/).flatten[0]
1753
+ </span><span class="marked0"><a name="line1132" />1132 if parent != &quot;.&quot; &amp;&amp; parent != &quot;..&quot;
1754
+ </span><span class="marked1"><a name="line1133" />1133 normalized_path.gsub!(/\/#{parent}\/\.\.$/, &quot;/&quot;)
1755
+ </span><span class="inferred0"><a name="line1134" />1134 end
1756
+ </span><span class="marked1"><a name="line1135" />1135 normalized_path.gsub!(/^\.\.?\/?/, &quot;&quot;)
1757
+ </span><span class="marked0"><a name="line1136" />1136 normalized_path.gsub!(/^\/\.\.?\//, &quot;/&quot;)
1758
+ </span><span class="marked1"><a name="line1137" />1137 end until previous_state == normalized_path
1759
+ </span><span class="marked0"><a name="line1138" />1138 return normalized_path
1760
+ </span><span class="inferred1"><a name="line1139" />1139 end
1761
+ </span><span class="inferred0"><a name="line1140" />1140
1762
+ </span><span class="inferred1"><a name="line1141" />1141 # Ensures that the URI is valid.
1763
+ </span><span class="marked0"><a name="line1142" />1142 def validate
1764
+ </span><span class="marked1"><a name="line1143" />1143 if self.scheme == nil &amp;&amp; self.user == nil &amp;&amp; self.password == nil &amp;&amp;
1765
+ </span><span class="marked0"><a name="line1144" />1144 self.host == nil &amp;&amp; self.port == nil &amp;&amp; self.path == nil &amp;&amp;
1766
+ </span><span class="marked1"><a name="line1145" />1145 self.query == nil &amp;&amp; self.fragment == nil
1767
+ </span><span class="marked0"><a name="line1146" />1146 raise InvalidURIError, &quot;All segments were nil.&quot;
1768
+ </span><span class="inferred1"><a name="line1147" />1147 end
1769
+ </span><span class="marked0"><a name="line1148" />1148 if self.scheme != nil &amp;&amp;
1770
+ </span><span class="marked1"><a name="line1149" />1149 (self.host == nil || self.host == &quot;&quot;) &amp;&amp;
1771
+ </span><span class="marked0"><a name="line1150" />1150 (self.path == nil || self.path == &quot;&quot;)
1772
+ </span><span class="marked1"><a name="line1151" />1151 raise InvalidURIError,
1773
+ </span><span class="inferred0"><a name="line1152" />1152 &quot;Absolute URI missing hierarchical segment.&quot;
1774
+ </span><span class="inferred1"><a name="line1153" />1153 end
1775
+ </span><span class="inferred0"><a name="line1154" />1154 end
1776
+ </span><span class="inferred1"><a name="line1155" />1155
1777
+ </span><span class="inferred0"><a name="line1156" />1156 # Replaces the internal state of self with the specified URI's state.
1778
+ </span><span class="inferred1"><a name="line1157" />1157 # Used in destructive operations to avoid massive code repetition.
1779
+ </span><span class="marked0"><a name="line1158" />1158 def replace_self(uri)
1780
+ </span><span class="inferred1"><a name="line1159" />1159 # Reset dependant values
1781
+ </span><span class="marked0"><a name="line1160" />1160 @userinfo = nil
1782
+ </span><span class="marked1"><a name="line1161" />1161 @authority = nil
1783
+ </span><span class="inferred0"><a name="line1162" />1162
1784
+ </span><span class="marked1"><a name="line1163" />1163 @scheme = uri.scheme
1785
+ </span><span class="marked0"><a name="line1164" />1164 @user = uri.user
1786
+ </span><span class="marked1"><a name="line1165" />1165 @password = uri.password
1787
+ </span><span class="marked0"><a name="line1166" />1166 @host = uri.host
1788
+ </span><span class="marked1"><a name="line1167" />1167 @specified_port = uri.instance_variable_get(&quot;@specified_port&quot;)
1789
+ </span><span class="marked0"><a name="line1168" />1168 @port = @specified_port.to_s.to_i
1790
+ </span><span class="marked1"><a name="line1169" />1169 @path = uri.path
1791
+ </span><span class="marked0"><a name="line1170" />1170 @query = uri.query
1792
+ </span><span class="marked1"><a name="line1171" />1171 @fragment = uri.fragment
1793
+ </span><span class="marked0"><a name="line1172" />1172 return self
1794
+ </span><span class="inferred1"><a name="line1173" />1173 end
1795
+ </span><span class="inferred0"><a name="line1174" />1174 end
1796
+ </span><span class="inferred1"><a name="line1175" />1175 end
1714
1797
  </span></pre><hr /> <p>Generated using the <a href='http://eigenclass.org/hiki.rb?rcov'>rcov code coverage analysis tool for Ruby</a> version 0.8.0.</p><p>
1715
1798
  <a href='http://validator.w3.org/check/referer'>
1716
1799
  <img src='http://www.w3.org/Icons/valid-xhtml10' height='31' alt='Valid XHTML 1.0!' width='88' />