addressable 0.1.2 → 1.0.0

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