addressable 1.0.1 → 1.0.2

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