addressable 1.0.4 → 2.0.0

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