1
# Copyright (C) 2006-2012, 2015, 2016 Canonical Ltd
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
# GNU General Public License for more details.
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
"""Tests for the urlutils wrapper."""
22
from .. import osutils, urlutils, win32utils
23
from ..errors import (
26
from . import features, TestCaseInTempDir, TestCase, TestSkipped
29
class TestUrlToPath(TestCase):
31
def test_basename(self):
32
# breezy.urlutils.basename
33
# Test breezy.urlutils.split()
34
basename = urlutils.basename
35
if sys.platform == 'win32':
36
self.assertRaises(urlutils.InvalidURL, basename,
37
'file:///path/to/foo')
38
self.assertEqual('foo', basename('file:///C|/foo'))
39
self.assertEqual('foo', basename('file:///C:/foo'))
40
self.assertEqual('', basename('file:///C:/'))
42
self.assertEqual('foo', basename('file:///foo'))
43
self.assertEqual('', basename('file:///'))
45
self.assertEqual('foo', basename('http://host/path/to/foo'))
46
self.assertEqual('foo', basename('http://host/path/to/foo/'))
48
basename('http://host/path/to/foo/', exclude_trailing_slash=False))
49
self.assertEqual('path', basename('http://host/path'))
50
self.assertEqual('', basename('http://host/'))
51
self.assertEqual('', basename('http://host'))
52
self.assertEqual('path', basename('http:///nohost/path'))
54
self.assertEqual('path', basename('random+scheme://user:pass@ahost:port/path'))
55
self.assertEqual('path', basename('random+scheme://user:pass@ahost:port/path/'))
56
self.assertEqual('', basename('random+scheme://user:pass@ahost:port/'))
59
self.assertEqual('foo', basename('path/to/foo'))
60
self.assertEqual('foo', basename('path/to/foo/'))
61
self.assertEqual('', basename('path/to/foo/',
62
exclude_trailing_slash=False))
63
self.assertEqual('foo', basename('path/../foo'))
64
self.assertEqual('foo', basename('../path/foo'))
66
def test_normalize_url_files(self):
67
# Test that local paths are properly normalized
68
normalize_url = urlutils.normalize_url
70
def norm_file(expected, path):
71
url = normalize_url(path)
72
self.assertStartsWith(url, 'file:///')
73
if sys.platform == 'win32':
74
url = url[len('file:///C:'):]
76
url = url[len('file://'):]
78
self.assertEndsWith(url, expected)
80
norm_file('path/to/foo', 'path/to/foo')
81
norm_file('/path/to/foo', '/path/to/foo')
82
norm_file('path/to/foo', '../path/to/foo')
84
# Local paths are assumed to *not* be escaped at all
86
u'uni/\xb5'.encode(osutils.get_user_encoding())
88
# locale cannot handle unicode
91
norm_file('uni/%C2%B5', u'uni/\xb5')
93
norm_file('uni/%25C2%25B5', u'uni/%C2%B5')
94
norm_file('uni/%20b', u'uni/ b')
95
# All the crazy characters get escaped in local paths => file:/// urls
96
# The ' ' character must not be at the end, because on win32
97
# it gets stripped off by ntpath.abspath
98
norm_file('%27%20%3B/%3F%3A%40%26%3D%2B%24%2C%23', "' ;/?:@&=+$,#")
100
def test_normalize_url_hybrid(self):
101
# Anything with a scheme:// should be treated as a hybrid url
102
# which changes what characters get escaped.
103
normalize_url = urlutils.normalize_url
105
eq = self.assertEqual
106
eq('file:///foo/', normalize_url(u'file:///foo/'))
107
eq('file:///foo/%20', normalize_url(u'file:///foo/ '))
108
eq('file:///foo/%20', normalize_url(u'file:///foo/%20'))
109
# Don't escape reserved characters
110
eq('file:///ab_c.d-e/%f:?g&h=i+j;k,L#M$',
111
normalize_url('file:///ab_c.d-e/%f:?g&h=i+j;k,L#M$'))
112
eq('http://ab_c.d-e/%f:?g&h=i+j;k,L#M$',
113
normalize_url('http://ab_c.d-e/%f:?g&h=i+j;k,L#M$'))
115
# Escape unicode characters, but not already escaped chars
116
eq('http://host/ab/%C2%B5/%C2%B5',
117
normalize_url(u'http://host/ab/%C2%B5/\xb5'))
119
# Unescape characters that don't need to be escaped
120
eq('http://host/~bob%2525-._',
121
normalize_url('http://host/%7Ebob%2525%2D%2E%5F'))
122
eq('http://host/~bob%2525-._',
123
normalize_url(u'http://host/%7Ebob%2525%2D%2E%5F'))
125
# Normalize verifies URLs when they are not unicode
126
# (indicating they did not come from the user)
127
self.assertRaises(urlutils.InvalidURL, normalize_url,
129
self.assertRaises(urlutils.InvalidURL, normalize_url, 'http://host/ ')
131
def test_url_scheme_re(self):
132
# Test paths that may be URLs
133
def test_one(url, scheme_and_path):
134
"""Assert that _url_scheme_re correctly matches
136
:param scheme_and_path: The (scheme, path) that should be matched
137
can be None, to indicate it should not match
139
m = urlutils._url_scheme_re.match(url)
140
if scheme_and_path is None:
141
self.assertEqual(None, m)
143
self.assertEqual(scheme_and_path[0], m.group('scheme'))
144
self.assertEqual(scheme_and_path[1], m.group('path'))
147
test_one('/path', None)
148
test_one('C:/path', None)
149
test_one('../path/to/foo', None)
150
test_one(u'../path/to/fo\xe5', None)
153
test_one('http://host/path/', ('http', 'host/path/'))
154
test_one('sftp://host/path/to/foo', ('sftp', 'host/path/to/foo'))
155
test_one('file:///usr/bin', ('file', '/usr/bin'))
156
test_one('file:///C:/Windows', ('file', '/C:/Windows'))
157
test_one('file:///C|/Windows', ('file', '/C|/Windows'))
158
test_one(u'readonly+sftp://host/path/\xe5', ('readonly+sftp', u'host/path/\xe5'))
161
# Can't have slashes or colons in the scheme
162
test_one('/path/to/://foo', None)
163
test_one('scheme:stuff://foo', ('scheme', 'stuff://foo'))
164
# Must have more than one character for scheme
165
test_one('C://foo', None)
166
test_one('ab://foo', ('ab', 'foo'))
168
def test_dirname(self):
169
# Test breezy.urlutils.dirname()
170
dirname = urlutils.dirname
171
if sys.platform == 'win32':
172
self.assertRaises(urlutils.InvalidURL, dirname,
173
'file:///path/to/foo')
174
self.assertEqual('file:///C|/', dirname('file:///C|/foo'))
175
self.assertEqual('file:///C|/', dirname('file:///C|/'))
177
self.assertEqual('file:///', dirname('file:///foo'))
178
self.assertEqual('file:///', dirname('file:///'))
180
self.assertEqual('http://host/path/to', dirname('http://host/path/to/foo'))
181
self.assertEqual('http://host/path/to', dirname('http://host/path/to/foo/'))
182
self.assertEqual('http://host/path/to/foo',
183
dirname('http://host/path/to/foo/', exclude_trailing_slash=False))
184
self.assertEqual('http://host/', dirname('http://host/path'))
185
self.assertEqual('http://host/', dirname('http://host/'))
186
self.assertEqual('http://host', dirname('http://host'))
187
self.assertEqual('http:///nohost', dirname('http:///nohost/path'))
189
self.assertEqual('random+scheme://user:pass@ahost:port/',
190
dirname('random+scheme://user:pass@ahost:port/path'))
191
self.assertEqual('random+scheme://user:pass@ahost:port/',
192
dirname('random+scheme://user:pass@ahost:port/path/'))
193
self.assertEqual('random+scheme://user:pass@ahost:port/',
194
dirname('random+scheme://user:pass@ahost:port/'))
197
self.assertEqual('path/to', dirname('path/to/foo'))
198
self.assertEqual('path/to', dirname('path/to/foo/'))
199
self.assertEqual('path/to/foo',
200
dirname('path/to/foo/', exclude_trailing_slash=False))
201
self.assertEqual('path/..', dirname('path/../foo'))
202
self.assertEqual('../path', dirname('../path/foo'))
204
def test_is_url(self):
205
self.assertTrue(urlutils.is_url('http://foo/bar'))
206
self.assertTrue(urlutils.is_url('bzr+ssh://foo/bar'))
207
self.assertTrue(urlutils.is_url('lp:foo/bar'))
208
self.assertTrue(urlutils.is_url('file:///foo/bar'))
209
self.assertFalse(urlutils.is_url(''))
210
self.assertFalse(urlutils.is_url('foo'))
211
self.assertFalse(urlutils.is_url('foo/bar'))
212
self.assertFalse(urlutils.is_url('/foo'))
213
self.assertFalse(urlutils.is_url('/foo/bar'))
214
self.assertFalse(urlutils.is_url('C:/'))
215
self.assertFalse(urlutils.is_url('C:/foo'))
216
self.assertFalse(urlutils.is_url('C:/foo/bar'))
219
def test(expected, *args):
220
joined = urlutils.join(*args)
221
self.assertEqual(expected, joined)
223
# Test relative path joining
224
test('foo', 'foo') # relative fragment with nothing is preserved.
225
test('foo/bar', 'foo', 'bar')
226
test('http://foo/bar', 'http://foo', 'bar')
227
test('http://foo/bar', 'http://foo', '.', 'bar')
228
test('http://foo/baz', 'http://foo', 'bar', '../baz')
229
test('http://foo/bar/baz', 'http://foo', 'bar/baz')
230
test('http://foo/baz', 'http://foo', 'bar/../baz')
231
test('http://foo/baz', 'http://foo/bar/', '../baz')
232
test('lp:foo/bar', 'lp:foo', 'bar')
233
test('lp:foo/bar/baz', 'lp:foo', 'bar/baz')
236
test('http://foo', 'http://foo') # abs url with nothing is preserved.
237
test('http://bar', 'http://foo', 'http://bar')
238
test('sftp://bzr/foo', 'http://foo', 'bar', 'sftp://bzr/foo')
239
test('file:///bar', 'foo', 'file:///bar')
240
test('http://bar/', 'http://foo', 'http://bar/')
241
test('http://bar/a', 'http://foo', 'http://bar/a')
242
test('http://bar/a/', 'http://foo', 'http://bar/a/')
243
test('lp:bar', 'http://foo', 'lp:bar')
244
test('lp:bar', 'lp:foo', 'lp:bar')
245
test('file:///stuff', 'lp:foo', 'file:///stuff')
248
test('file:///foo', 'file:///', 'foo')
249
test('file:///bar/foo', 'file:///bar/', 'foo')
250
test('http://host/foo', 'http://host/', 'foo')
251
test('http://host/', 'http://host', '')
254
# Cannot go above root
255
# Implicitly at root:
256
self.assertRaises(urlutils.InvalidURLJoin, urlutils.join,
257
'http://foo', '../baz')
258
self.assertRaises(urlutils.InvalidURLJoin, urlutils.join,
260
# Joining from a path explicitly under the root.
261
self.assertRaises(urlutils.InvalidURLJoin, urlutils.join,
262
'http://foo/a', '../../b')
264
def test_joinpath(self):
265
def test(expected, *args):
266
joined = urlutils.joinpath(*args)
267
self.assertEqual(expected, joined)
269
# Test a single element
272
# Test relative path joining
273
test('foo/bar', 'foo', 'bar')
274
test('foo/bar', 'foo', '.', 'bar')
275
test('foo/baz', 'foo', 'bar', '../baz')
276
test('foo/bar/baz', 'foo', 'bar/baz')
277
test('foo/baz', 'foo', 'bar/../baz')
279
# Test joining to an absolute path
281
test('/foo', '/foo', '.')
282
test('/foo/bar', '/foo', 'bar')
283
test('/', '/foo', '..')
285
# Test joining with an absolute path
286
test('/bar', 'foo', '/bar')
288
# Test joining to a path with a trailing slash
289
test('foo/bar', 'foo/', 'bar')
292
# Cannot go above root
293
self.assertRaises(urlutils.InvalidURLJoin, urlutils.joinpath, '/',
295
self.assertRaises(urlutils.InvalidURLJoin, urlutils.joinpath, '/',
297
self.assertRaises(urlutils.InvalidURLJoin, urlutils.joinpath, '/',
300
def test_join_segment_parameters_raw(self):
301
join_segment_parameters_raw = urlutils.join_segment_parameters_raw
302
self.assertEqual("/somedir/path",
303
join_segment_parameters_raw("/somedir/path"))
304
self.assertEqual("/somedir/path,rawdata",
305
join_segment_parameters_raw("/somedir/path", "rawdata"))
306
self.assertRaises(urlutils.InvalidURLJoin,
307
join_segment_parameters_raw, "/somedir/path",
308
"rawdata1,rawdata2,rawdata3")
309
self.assertEqual("/somedir/path,bla,bar",
310
join_segment_parameters_raw("/somedir/path", "bla", "bar"))
311
self.assertEqual("/somedir,exist=some/path,bla,bar",
312
join_segment_parameters_raw("/somedir,exist=some/path",
314
self.assertRaises(TypeError, join_segment_parameters_raw,
317
def test_join_segment_parameters(self):
318
join_segment_parameters = urlutils.join_segment_parameters
319
self.assertEqual("/somedir/path",
320
join_segment_parameters("/somedir/path", {}))
321
self.assertEqual("/somedir/path,key1=val1",
322
join_segment_parameters("/somedir/path", {"key1": "val1"}))
323
self.assertRaises(urlutils.InvalidURLJoin,
324
join_segment_parameters, "/somedir/path",
325
{"branch": "brr,brr,brr"})
326
self.assertRaises(urlutils.InvalidURLJoin,
327
join_segment_parameters, "/somedir/path", {"key1=val1": "val2"})
328
self.assertEqual("/somedir/path,key1=val1,key2=val2",
329
join_segment_parameters("/somedir/path", {
330
"key1": "val1", "key2": "val2"}))
331
self.assertEqual("/somedir/path,key1=val1,key2=val2",
332
join_segment_parameters("/somedir/path,key1=val1", {
334
self.assertEqual("/somedir/path,key1=val2",
335
join_segment_parameters("/somedir/path,key1=val1", {
337
self.assertEqual("/somedir,exist=some/path,key1=val1",
338
join_segment_parameters("/somedir,exist=some/path",
340
self.assertEqual("/,key1=val1,key2=val2",
341
join_segment_parameters("/,key1=val1", {"key2": "val2"}))
342
self.assertRaises(TypeError,
343
join_segment_parameters, "/,key1=val1", {"foo": 42})
345
def test_function_type(self):
346
if sys.platform == 'win32':
347
self.assertEqual(urlutils._win32_local_path_to_url,
348
urlutils.local_path_to_url)
349
self.assertEqual(urlutils._win32_local_path_from_url,
350
urlutils.local_path_from_url)
352
self.assertEqual(urlutils._posix_local_path_to_url,
353
urlutils.local_path_to_url)
354
self.assertEqual(urlutils._posix_local_path_from_url,
355
urlutils.local_path_from_url)
357
def test_posix_local_path_to_url(self):
358
to_url = urlutils._posix_local_path_to_url
359
self.assertEqual('file:///path/to/foo',
360
to_url('/path/to/foo'))
362
self.assertEqual('file:///path/to/foo%2Cbar',
363
to_url('/path/to/foo,bar'))
366
result = to_url(u'/path/to/r\xe4ksm\xf6rg\xe5s')
368
raise TestSkipped("local encoding cannot handle unicode")
370
self.assertEqual('file:///path/to/r%C3%A4ksm%C3%B6rg%C3%A5s', result)
371
self.assertFalse(isinstance(result, unicode))
373
def test_posix_local_path_from_url(self):
374
from_url = urlutils._posix_local_path_from_url
375
self.assertEqual('/path/to/foo',
376
from_url('file:///path/to/foo'))
377
self.assertEqual('/path/to/foo',
378
from_url('file:///path/to/foo,branch=foo'))
379
self.assertEqual(u'/path/to/r\xe4ksm\xf6rg\xe5s',
380
from_url('file:///path/to/r%C3%A4ksm%C3%B6rg%C3%A5s'))
381
self.assertEqual(u'/path/to/r\xe4ksm\xf6rg\xe5s',
382
from_url('file:///path/to/r%c3%a4ksm%c3%b6rg%c3%a5s'))
383
self.assertEqual(u'/path/to/r\xe4ksm\xf6rg\xe5s',
384
from_url('file://localhost/path/to/r%c3%a4ksm%c3%b6rg%c3%a5s'))
386
self.assertRaises(urlutils.InvalidURL, from_url, '/path/to/foo')
388
urlutils.InvalidURL, from_url,
389
'file://remotehost/path/to/r%c3%a4ksm%c3%b6rg%c3%a5s')
391
def test_win32_local_path_to_url(self):
392
to_url = urlutils._win32_local_path_to_url
393
self.assertEqual('file:///C:/path/to/foo',
394
to_url('C:/path/to/foo'))
395
# BOGUS: on win32, ntpath.abspath will strip trailing
396
# whitespace, so this will always fail
397
# Though under linux, it fakes abspath support
398
# and thus will succeed
399
# self.assertEqual('file:///C:/path/to/foo%20',
400
# to_url('C:/path/to/foo '))
401
self.assertEqual('file:///C:/path/to/f%20oo',
402
to_url('C:/path/to/f oo'))
404
self.assertEqual('file:///', to_url('/'))
406
self.assertEqual('file:///C:/path/to/foo%2Cbar',
407
to_url('C:/path/to/foo,bar'))
409
result = to_url(u'd:/path/to/r\xe4ksm\xf6rg\xe5s')
411
raise TestSkipped("local encoding cannot handle unicode")
413
self.assertEqual('file:///D:/path/to/r%C3%A4ksm%C3%B6rg%C3%A5s', result)
414
self.assertFalse(isinstance(result, unicode))
416
def test_win32_unc_path_to_url(self):
417
self.requireFeature(features.win32_feature)
418
to_url = urlutils._win32_local_path_to_url
419
self.assertEqual('file://HOST/path',
420
to_url(r'\\HOST\path'))
421
self.assertEqual('file://HOST/path',
422
to_url('//HOST/path'))
425
result = to_url(u'//HOST/path/to/r\xe4ksm\xf6rg\xe5s')
427
raise TestSkipped("local encoding cannot handle unicode")
429
self.assertEqual('file://HOST/path/to/r%C3%A4ksm%C3%B6rg%C3%A5s', result)
430
self.assertFalse(isinstance(result, unicode))
432
def test_win32_local_path_from_url(self):
433
from_url = urlutils._win32_local_path_from_url
434
self.assertEqual('C:/path/to/foo',
435
from_url('file:///C|/path/to/foo'))
436
self.assertEqual(u'D:/path/to/r\xe4ksm\xf6rg\xe5s',
437
from_url('file:///d|/path/to/r%C3%A4ksm%C3%B6rg%C3%A5s'))
438
self.assertEqual(u'D:/path/to/r\xe4ksm\xf6rg\xe5s',
439
from_url('file:///d:/path/to/r%c3%a4ksm%c3%b6rg%c3%a5s'))
440
self.assertEqual('/', from_url('file:///'))
441
self.assertEqual('C:/path/to/foo',
442
from_url('file:///C|/path/to/foo,branch=foo'))
444
self.assertRaises(urlutils.InvalidURL, from_url, 'file:///C:')
445
self.assertRaises(urlutils.InvalidURL, from_url, 'file:///c')
446
self.assertRaises(urlutils.InvalidURL, from_url, '/path/to/foo')
447
# Not a valid _win32 url, no drive letter
448
self.assertRaises(urlutils.InvalidURL, from_url, 'file:///path/to/foo')
450
def test_win32_unc_path_from_url(self):
451
from_url = urlutils._win32_local_path_from_url
452
self.assertEqual('//HOST/path', from_url('file://HOST/path'))
453
self.assertEqual('//HOST/path',
454
from_url('file://HOST/path,branch=foo'))
455
# despite IE allows 2, 4, 5 and 6 slashes in URL to another machine
456
# we want to use only 2 slashes
457
# Firefox understand only 5 slashes in URL, but it's ugly
458
self.assertRaises(urlutils.InvalidURL, from_url, 'file:////HOST/path')
459
self.assertRaises(urlutils.InvalidURL, from_url, 'file://///HOST/path')
460
self.assertRaises(urlutils.InvalidURL, from_url, 'file://////HOST/path')
461
# check for file://C:/ instead of file:///C:/
462
self.assertRaises(urlutils.InvalidURL, from_url, 'file://C:/path')
464
def test_win32_extract_drive_letter(self):
465
extract = urlutils._win32_extract_drive_letter
466
self.assertEqual(('file:///C:', '/foo'), extract('file://', '/C:/foo'))
467
self.assertEqual(('file:///d|', '/path'), extract('file://', '/d|/path'))
468
self.assertRaises(urlutils.InvalidURL, extract, 'file://', '/path')
469
# Root drives without slash treated as invalid, see bug #841322
470
self.assertEqual(('file:///C:', '/'), extract('file://', '/C:/'))
471
self.assertRaises(urlutils.InvalidURL, extract, 'file://', '/C:')
472
# Invalid without drive separator or following forward slash
473
self.assertRaises(urlutils.InvalidURL, extract, 'file://', '/C')
474
self.assertRaises(urlutils.InvalidURL, extract, 'file://', '/C:ool')
476
def test_split(self):
477
# Test breezy.urlutils.split()
478
split = urlutils.split
479
if sys.platform == 'win32':
480
self.assertRaises(urlutils.InvalidURL, split, 'file:///path/to/foo')
481
self.assertEqual(('file:///C|/', 'foo'), split('file:///C|/foo'))
482
self.assertEqual(('file:///C:/', ''), split('file:///C:/'))
484
self.assertEqual(('file:///', 'foo'), split('file:///foo'))
485
self.assertEqual(('file:///', ''), split('file:///'))
487
self.assertEqual(('http://host/path/to', 'foo'), split('http://host/path/to/foo'))
488
self.assertEqual(('http://host/path/to', 'foo'), split('http://host/path/to/foo/'))
489
self.assertEqual(('http://host/path/to/foo', ''),
490
split('http://host/path/to/foo/', exclude_trailing_slash=False))
491
self.assertEqual(('http://host/', 'path'), split('http://host/path'))
492
self.assertEqual(('http://host/', ''), split('http://host/'))
493
self.assertEqual(('http://host', ''), split('http://host'))
494
self.assertEqual(('http:///nohost', 'path'), split('http:///nohost/path'))
496
self.assertEqual(('random+scheme://user:pass@ahost:port/', 'path'),
497
split('random+scheme://user:pass@ahost:port/path'))
498
self.assertEqual(('random+scheme://user:pass@ahost:port/', 'path'),
499
split('random+scheme://user:pass@ahost:port/path/'))
500
self.assertEqual(('random+scheme://user:pass@ahost:port/', ''),
501
split('random+scheme://user:pass@ahost:port/'))
504
self.assertEqual(('path/to', 'foo'), split('path/to/foo'))
505
self.assertEqual(('path/to', 'foo'), split('path/to/foo/'))
506
self.assertEqual(('path/to/foo', ''),
507
split('path/to/foo/', exclude_trailing_slash=False))
508
self.assertEqual(('path/..', 'foo'), split('path/../foo'))
509
self.assertEqual(('../path', 'foo'), split('../path/foo'))
511
def test_split_segment_parameters_raw(self):
512
split_segment_parameters_raw = urlutils.split_segment_parameters_raw
513
# Check relative references with absolute paths
514
self.assertEqual(("/some/path", []),
515
split_segment_parameters_raw("/some/path"))
516
self.assertEqual(("/some/path", ["tip"]),
517
split_segment_parameters_raw("/some/path,tip"))
518
self.assertEqual(("/some,dir/path", ["tip"]),
519
split_segment_parameters_raw("/some,dir/path,tip"))
520
self.assertEqual(("/somedir/path", ["heads%2Ftip"]),
521
split_segment_parameters_raw("/somedir/path,heads%2Ftip"))
522
self.assertEqual(("/somedir/path", ["heads%2Ftip", "bar"]),
523
split_segment_parameters_raw("/somedir/path,heads%2Ftip,bar"))
524
# Check relative references with relative paths
525
self.assertEqual(("", ["key1=val1"]),
526
split_segment_parameters_raw(",key1=val1"))
527
self.assertEqual(("foo/", ["key1=val1"]),
528
split_segment_parameters_raw("foo/,key1=val1"))
529
self.assertEqual(("foo", ["key1=val1"]),
530
split_segment_parameters_raw("foo,key1=val1"))
531
self.assertEqual(("foo/base,la=bla/other/elements", []),
532
split_segment_parameters_raw("foo/base,la=bla/other/elements"))
533
self.assertEqual(("foo/base,la=bla/other/elements", ["a=b"]),
534
split_segment_parameters_raw("foo/base,la=bla/other/elements,a=b"))
535
# TODO: Check full URLs as well as relative references
537
def test_split_segment_parameters(self):
538
split_segment_parameters = urlutils.split_segment_parameters
539
# Check relative references with absolute paths
540
self.assertEqual(("/some/path", {}),
541
split_segment_parameters("/some/path"))
542
self.assertEqual(("/some/path", {"branch": "tip"}),
543
split_segment_parameters("/some/path,branch=tip"))
544
self.assertEqual(("/some,dir/path", {"branch": "tip"}),
545
split_segment_parameters("/some,dir/path,branch=tip"))
546
self.assertEqual(("/somedir/path", {"ref": "heads%2Ftip"}),
547
split_segment_parameters("/somedir/path,ref=heads%2Ftip"))
548
self.assertEqual(("/somedir/path",
549
{"ref": "heads%2Ftip", "key1": "val1"}),
550
split_segment_parameters(
551
"/somedir/path,ref=heads%2Ftip,key1=val1"))
552
self.assertEqual(("/somedir/path", {"ref": "heads%2F=tip"}),
553
split_segment_parameters("/somedir/path,ref=heads%2F=tip"))
554
# Check relative references with relative paths
555
self.assertEqual(("", {"key1": "val1"}),
556
split_segment_parameters(",key1=val1"))
557
self.assertEqual(("foo/", {"key1": "val1"}),
558
split_segment_parameters("foo/,key1=val1"))
559
self.assertEqual(("foo/base,key1=val1/other/elements", {}),
560
split_segment_parameters("foo/base,key1=val1/other/elements"))
561
self.assertEqual(("foo/base,key1=val1/other/elements",
562
{"key2": "val2"}), split_segment_parameters(
563
"foo/base,key1=val1/other/elements,key2=val2"))
564
# TODO: Check full URLs as well as relative references
566
def test_win32_strip_local_trailing_slash(self):
567
strip = urlutils._win32_strip_local_trailing_slash
568
self.assertEqual('file://', strip('file://'))
569
self.assertEqual('file:///', strip('file:///'))
570
self.assertEqual('file:///C', strip('file:///C'))
571
self.assertEqual('file:///C:', strip('file:///C:'))
572
self.assertEqual('file:///d|', strip('file:///d|'))
573
self.assertEqual('file:///C:/', strip('file:///C:/'))
574
self.assertEqual('file:///C:/a', strip('file:///C:/a/'))
576
def test_strip_trailing_slash(self):
577
sts = urlutils.strip_trailing_slash
578
if sys.platform == 'win32':
579
self.assertEqual('file:///C|/', sts('file:///C|/'))
580
self.assertEqual('file:///C:/foo', sts('file:///C:/foo'))
581
self.assertEqual('file:///C|/foo', sts('file:///C|/foo/'))
583
self.assertEqual('file:///', sts('file:///'))
584
self.assertEqual('file:///foo', sts('file:///foo'))
585
self.assertEqual('file:///foo', sts('file:///foo/'))
587
self.assertEqual('http://host/', sts('http://host/'))
588
self.assertEqual('http://host/foo', sts('http://host/foo'))
589
self.assertEqual('http://host/foo', sts('http://host/foo/'))
591
# No need to fail just because the slash is missing
592
self.assertEqual('http://host', sts('http://host'))
593
# TODO: jam 20060502 Should this raise InvalidURL?
594
self.assertEqual('file://', sts('file://'))
596
self.assertEqual('random+scheme://user:pass@ahost:port/path',
597
sts('random+scheme://user:pass@ahost:port/path'))
598
self.assertEqual('random+scheme://user:pass@ahost:port/path',
599
sts('random+scheme://user:pass@ahost:port/path/'))
600
self.assertEqual('random+scheme://user:pass@ahost:port/',
601
sts('random+scheme://user:pass@ahost:port/'))
603
# Make sure relative paths work too
604
self.assertEqual('path/to/foo', sts('path/to/foo'))
605
self.assertEqual('path/to/foo', sts('path/to/foo/'))
606
self.assertEqual('../to/foo', sts('../to/foo/'))
607
self.assertEqual('path/../foo', sts('path/../foo/'))
609
def test_unescape_for_display_utf8(self):
610
# Test that URLs are converted to nice unicode strings for display
611
def test(expected, url, encoding='utf-8'):
612
disp_url = urlutils.unescape_for_display(url, encoding=encoding)
613
self.assertIsInstance(disp_url, unicode)
614
self.assertEqual(expected, disp_url)
616
test('http://foo', 'http://foo')
617
if sys.platform == 'win32':
618
test('C:/foo/path', 'file:///C|/foo/path')
619
test('C:/foo/path', 'file:///C:/foo/path')
621
test('/foo/path', 'file:///foo/path')
623
test('http://foo/%2Fbaz', 'http://foo/%2Fbaz')
624
test(u'http://host/r\xe4ksm\xf6rg\xe5s',
625
'http://host/r%C3%A4ksm%C3%B6rg%C3%A5s')
627
# Make sure special escaped characters stay escaped
628
test(u'http://host/%3B%2F%3F%3A%40%26%3D%2B%24%2C%23',
629
'http://host/%3B%2F%3F%3A%40%26%3D%2B%24%2C%23')
631
# Can we handle sections that don't have utf-8 encoding?
632
test(u'http://host/%EE%EE%EE/r\xe4ksm\xf6rg\xe5s',
633
'http://host/%EE%EE%EE/r%C3%A4ksm%C3%B6rg%C3%A5s')
635
# Test encoding into output that can handle some characters
636
test(u'http://host/%EE%EE%EE/r\xe4ksm\xf6rg\xe5s',
637
'http://host/%EE%EE%EE/r%C3%A4ksm%C3%B6rg%C3%A5s',
638
encoding='iso-8859-1')
640
# This one can be encoded into utf8
641
test(u'http://host/\u062c\u0648\u062c\u0648',
642
'http://host/%d8%ac%d9%88%d8%ac%d9%88',
645
# This can't be put into 8859-1 and so stays as escapes
646
test(u'http://host/%d8%ac%d9%88%d8%ac%d9%88',
647
'http://host/%d8%ac%d9%88%d8%ac%d9%88',
648
encoding='iso-8859-1')
650
def test_escape(self):
651
self.assertEqual('%25', urlutils.escape('%'))
652
self.assertEqual('%C3%A5', urlutils.escape(u'\xe5'))
653
self.assertFalse(isinstance(urlutils.escape(u'\xe5'), unicode))
655
def test_escape_tildes(self):
656
self.assertEqual('~foo', urlutils.escape('~foo'))
658
def test_unescape(self):
659
self.assertEqual('%', urlutils.unescape('%25'))
660
self.assertEqual(u'\xe5', urlutils.unescape('%C3%A5'))
662
self.assertRaises(urlutils.InvalidURL, urlutils.unescape, u'\xe5')
663
self.assertRaises(urlutils.InvalidURL, urlutils.unescape, '\xe5')
664
self.assertRaises(urlutils.InvalidURL, urlutils.unescape, '%E5')
666
def test_escape_unescape(self):
667
self.assertEqual(u'\xe5', urlutils.unescape(urlutils.escape(u'\xe5')))
668
self.assertEqual('%', urlutils.unescape(urlutils.escape('%')))
670
def test_relative_url(self):
671
def test(expected, base, other):
672
result = urlutils.relative_url(base, other)
673
self.assertEqual(expected, result)
675
test('a', 'http://host/', 'http://host/a')
676
test('http://entirely/different', 'sftp://host/branch',
677
'http://entirely/different')
678
test('../person/feature', 'http://host/branch/mainline',
679
'http://host/branch/person/feature')
680
test('..', 'http://host/branch', 'http://host/')
681
test('http://host2/branch', 'http://host1/branch', 'http://host2/branch')
682
test('.', 'http://host1/branch', 'http://host1/branch')
683
test('../../../branch/2b', 'file:///home/jelmer/foo/bar/2b',
684
'file:///home/jelmer/branch/2b')
685
test('../../branch/2b', 'sftp://host/home/jelmer/bar/2b',
686
'sftp://host/home/jelmer/branch/2b')
687
test('../../branch/feature/%2b', 'http://host/home/jelmer/bar/%2b',
688
'http://host/home/jelmer/branch/feature/%2b')
689
test('../../branch/feature/2b', 'http://host/home/jelmer/bar/2b/',
690
'http://host/home/jelmer/branch/feature/2b')
691
# relative_url should preserve a trailing slash
692
test('../../branch/feature/2b/', 'http://host/home/jelmer/bar/2b/',
693
'http://host/home/jelmer/branch/feature/2b/')
694
test('../../branch/feature/2b/', 'http://host/home/jelmer/bar/2b',
695
'http://host/home/jelmer/branch/feature/2b/')
697
# TODO: treat http://host as http://host/
698
# relative_url is typically called from a branch.base or
699
# transport.base which always ends with a /
700
#test('a', 'http://host', 'http://host/a')
701
test('http://host/a', 'http://host', 'http://host/a')
702
#test('.', 'http://host', 'http://host/')
703
test('http://host/', 'http://host', 'http://host/')
704
#test('.', 'http://host/', 'http://host')
705
test('http://host', 'http://host/', 'http://host')
707
# On Windows file:///C:/path/to and file:///D:/other/path
708
# should not use relative url over the non-existent '/' directory.
709
if sys.platform == 'win32':
711
test('../../other/path',
712
'file:///C:/path/to', 'file:///C:/other/path')
713
#~next two tests is failed, i.e. urlutils.relative_url expects
714
#~to see normalized file URLs?
715
#~test('../../other/path',
716
#~ 'file:///C:/path/to', 'file:///c:/other/path')
717
#~test('../../other/path',
718
#~ 'file:///C:/path/to', 'file:///C|/other/path')
720
# check UNC paths too
721
test('../../other/path',
722
'file://HOST/base/path/to', 'file://HOST/base/other/path')
723
# on different drives
724
test('file:///D:/other/path',
725
'file:///C:/path/to', 'file:///D:/other/path')
726
# TODO: strictly saying in UNC path //HOST/base is full analog
727
# of drive letter for hard disk, and this situation is also
728
# should be exception from rules. [bialix 20071221]
731
class TestCwdToURL(TestCaseInTempDir):
732
"""Test that local_path_to_url works based on the cwd"""
735
# This test will fail if getcwd is not ascii
739
url = urlutils.local_path_to_url('.')
740
self.assertEndsWith(url, '/mytest')
742
def test_non_ascii(self):
746
raise TestSkipped('cannot create unicode directory')
750
# On Mac OSX this directory is actually:
751
# u'/dode\u0301' => '/dode\xcc\x81
752
# but we should normalize it back to
753
# u'/dod\xe9' => '/dod\xc3\xa9'
754
url = urlutils.local_path_to_url('.')
755
self.assertEndsWith(url, '/dod%C3%A9')
758
class TestDeriveToLocation(TestCase):
759
"""Test that the mapping of FROM_LOCATION to TO_LOCATION works."""
761
def test_to_locations_derived_from_paths(self):
762
derive = urlutils.derive_to_location
763
self.assertEqual("bar", derive("bar"))
764
self.assertEqual("bar", derive("../bar"))
765
self.assertEqual("bar", derive("/foo/bar"))
766
self.assertEqual("bar", derive("c:/foo/bar"))
767
self.assertEqual("bar", derive("c:bar"))
769
def test_to_locations_derived_from_urls(self):
770
derive = urlutils.derive_to_location
771
self.assertEqual("bar", derive("http://foo/bar"))
772
self.assertEqual("bar", derive("bzr+ssh://foo/bar"))
773
self.assertEqual("foo-bar", derive("lp:foo-bar"))
776
class TestRebaseURL(TestCase):
777
"""Test the behavior of rebase_url."""
779
def test_non_relative(self):
780
result = urlutils.rebase_url('file://foo', 'file://foo',
782
self.assertEqual('file://foo', result)
783
result = urlutils.rebase_url('/foo', 'file://foo',
785
self.assertEqual('/foo', result)
787
def test_different_ports(self):
788
e = self.assertRaises(urlutils.InvalidRebaseURLs, urlutils.rebase_url,
789
'foo', 'http://bar:80', 'http://bar:81')
790
self.assertEqual(str(e), "URLs differ by more than path:"
791
" 'http://bar:80' and 'http://bar:81'")
793
def test_different_hosts(self):
794
e = self.assertRaises(urlutils.InvalidRebaseURLs, urlutils.rebase_url,
795
'foo', 'http://bar', 'http://baz')
796
self.assertEqual(str(e), "URLs differ by more than path: 'http://bar'"
799
def test_different_protocol(self):
800
e = self.assertRaises(urlutils.InvalidRebaseURLs, urlutils.rebase_url,
801
'foo', 'http://bar', 'ftp://bar')
802
self.assertEqual(str(e), "URLs differ by more than path: 'http://bar'"
805
def test_rebase_success(self):
806
self.assertEqual('../bar', urlutils.rebase_url('bar', 'http://baz/',
808
self.assertEqual('qux/bar', urlutils.rebase_url('bar',
809
'http://baz/qux', 'http://baz/'))
810
self.assertEqual('.', urlutils.rebase_url('foo',
811
'http://bar/', 'http://bar/foo/'))
812
self.assertEqual('qux/bar', urlutils.rebase_url('../bar',
813
'http://baz/qux/foo', 'http://baz/'))
815
def test_determine_relative_path(self):
816
self.assertEqual('../../baz/bar',
817
urlutils.determine_relative_path(
818
'/qux/quxx', '/baz/bar'))
819
self.assertEqual('..',
820
urlutils.determine_relative_path(
822
self.assertEqual('baz',
823
urlutils.determine_relative_path(
825
self.assertEqual('.', urlutils.determine_relative_path(
829
class TestParseURL(TestCase):
831
def test_parse_simple(self):
832
parsed = urlutils.parse_url('http://example.com:80/one')
833
self.assertEqual(('http', None, None, 'example.com', 80, '/one'),
837
parsed = urlutils.parse_url('http://[1:2:3::40]/one')
838
self.assertEqual(('http', None, None, '1:2:3::40', None, '/one'),
841
def test_ipv6_port(self):
842
parsed = urlutils.parse_url('http://[1:2:3::40]:80/one')
843
self.assertEqual(('http', None, None, '1:2:3::40', 80, '/one'),
847
class TestURL(TestCase):
849
def test_parse_simple(self):
850
parsed = urlutils.URL.from_string('http://example.com:80/one')
851
self.assertEqual('http', parsed.scheme)
852
self.assertIs(None, parsed.user)
853
self.assertIs(None, parsed.password)
854
self.assertEqual('example.com', parsed.host)
855
self.assertEqual(80, parsed.port)
856
self.assertEqual('/one', parsed.path)
859
parsed = urlutils.URL.from_string('http://[1:2:3::40]/one')
860
self.assertEqual('http', parsed.scheme)
861
self.assertIs(None, parsed.port)
862
self.assertIs(None, parsed.user)
863
self.assertIs(None, parsed.password)
864
self.assertEqual('1:2:3::40', parsed.host)
865
self.assertEqual('/one', parsed.path)
867
def test_ipv6_port(self):
868
parsed = urlutils.URL.from_string('http://[1:2:3::40]:80/one')
869
self.assertEqual('http', parsed.scheme)
870
self.assertEqual('1:2:3::40', parsed.host)
871
self.assertIs(None, parsed.user)
872
self.assertIs(None, parsed.password)
873
self.assertEqual(80, parsed.port)
874
self.assertEqual('/one', parsed.path)
876
def test_quoted(self):
877
parsed = urlutils.URL.from_string(
878
'http://ro%62ey:h%40t@ex%41mple.com:2222/path')
879
self.assertEqual(parsed.quoted_host, 'ex%41mple.com')
880
self.assertEqual(parsed.host, 'exAmple.com')
881
self.assertEqual(parsed.port, 2222)
882
self.assertEqual(parsed.quoted_user, 'ro%62ey')
883
self.assertEqual(parsed.user, 'robey')
884
self.assertEqual(parsed.quoted_password, 'h%40t')
885
self.assertEqual(parsed.password, 'h@t')
886
self.assertEqual(parsed.path, '/path')
889
parsed1 = urlutils.URL.from_string('http://[1:2:3::40]:80/one')
890
parsed2 = urlutils.URL.from_string('http://[1:2:3::40]:80/one')
891
self.assertEqual(parsed1, parsed2)
892
self.assertEqual(parsed1, parsed1)
893
parsed2.path = '/two'
894
self.assertNotEqual(parsed1, parsed2)
897
parsed = urlutils.URL.from_string('http://[1:2:3::40]:80/one')
899
"<URL('http', None, None, '1:2:3::40', 80, '/one')>",
903
parsed = urlutils.URL.from_string('http://[1:2:3::40]:80/one')
904
self.assertEqual('http://[1:2:3::40]:80/one', str(parsed))
906
def test__combine_paths(self):
907
combine = urlutils.URL._combine_paths
908
self.assertEqual('/home/sarah/project/foo',
909
combine('/home/sarah', 'project/foo'))
910
self.assertEqual('/etc',
911
combine('/home/sarah', '../../etc'))
912
self.assertEqual('/etc',
913
combine('/home/sarah', '../../../etc'))
914
self.assertEqual('/etc',
915
combine('/home/sarah', '/etc'))
917
def test_clone(self):
918
url = urlutils.URL.from_string('http://[1:2:3::40]:80/one')
919
url1 = url.clone("two")
920
self.assertEqual("/one/two", url1.path)
921
url2 = url.clone("/two")
922
self.assertEqual("/two", url2.path)
924
self.assertIsNot(url, url3)
925
self.assertEqual(url, url3)
928
class TestFileRelpath(TestCase):
930
# GZ 2011-11-18: A way to override all path handling functions to one
931
# platform or another for testing would be nice.
933
def _with_posix_paths(self):
934
self.overrideAttr(urlutils, "local_path_from_url",
935
urlutils._posix_local_path_from_url)
936
self.overrideAttr(urlutils, "MIN_ABS_FILEURL_LENGTH", len("file:///"))
937
self.overrideAttr(osutils, "normpath", osutils._posix_normpath)
938
self.overrideAttr(osutils, "abspath", osutils._posix_abspath)
939
self.overrideAttr(osutils, "normpath", osutils._posix_normpath)
940
self.overrideAttr(osutils, "pathjoin", osutils.posixpath.join)
941
self.overrideAttr(osutils, "split", osutils.posixpath.split)
942
self.overrideAttr(osutils, "MIN_ABS_PATHLENGTH", 1)
944
def _with_win32_paths(self):
945
self.overrideAttr(urlutils, "local_path_from_url",
946
urlutils._win32_local_path_from_url)
947
self.overrideAttr(urlutils, "MIN_ABS_FILEURL_LENGTH",
948
urlutils.WIN32_MIN_ABS_FILEURL_LENGTH)
949
self.overrideAttr(osutils, "abspath", osutils._win32_abspath)
950
self.overrideAttr(osutils, "normpath", osutils._win32_normpath)
951
self.overrideAttr(osutils, "pathjoin", osutils._win32_pathjoin)
952
self.overrideAttr(osutils, "split", osutils.ntpath.split)
953
self.overrideAttr(osutils, "MIN_ABS_PATHLENGTH", 3)
955
def test_same_url_posix(self):
956
self._with_posix_paths()
958
urlutils.file_relpath("file:///a", "file:///a"))
960
urlutils.file_relpath("file:///a", "file:///a/"))
962
urlutils.file_relpath("file:///a/", "file:///a"))
964
def test_same_url_win32(self):
965
self._with_win32_paths()
967
urlutils.file_relpath("file:///A:/", "file:///A:/"))
969
urlutils.file_relpath("file:///A|/", "file:///A:/"))
971
urlutils.file_relpath("file:///A:/b/", "file:///A:/b/"))
973
urlutils.file_relpath("file:///A:/b", "file:///A:/b/"))
975
urlutils.file_relpath("file:///A:/b/", "file:///A:/b"))
977
def test_child_posix(self):
978
self._with_posix_paths()
979
self.assertEqual("b",
980
urlutils.file_relpath("file:///a", "file:///a/b"))
981
self.assertEqual("b",
982
urlutils.file_relpath("file:///a/", "file:///a/b"))
983
self.assertEqual("b/c",
984
urlutils.file_relpath("file:///a", "file:///a/b/c"))
986
def test_child_win32(self):
987
self._with_win32_paths()
988
self.assertEqual("b",
989
urlutils.file_relpath("file:///A:/", "file:///A:/b"))
990
self.assertEqual("b",
991
urlutils.file_relpath("file:///A|/", "file:///A:/b"))
992
self.assertEqual("c",
993
urlutils.file_relpath("file:///A:/b", "file:///A:/b/c"))
994
self.assertEqual("c",
995
urlutils.file_relpath("file:///A:/b/", "file:///A:/b/c"))
996
self.assertEqual("c/d",
997
urlutils.file_relpath("file:///A:/b", "file:///A:/b/c/d"))
999
def test_sibling_posix(self):
1000
self._with_posix_paths()
1001
self.assertRaises(PathNotChild,
1002
urlutils.file_relpath, "file:///a/b", "file:///a/c")
1003
self.assertRaises(PathNotChild,
1004
urlutils.file_relpath, "file:///a/b/", "file:///a/c")
1005
self.assertRaises(PathNotChild,
1006
urlutils.file_relpath, "file:///a/b/", "file:///a/c/")
1008
def test_sibling_win32(self):
1009
self._with_win32_paths()
1010
self.assertRaises(PathNotChild,
1011
urlutils.file_relpath, "file:///A:/b", "file:///A:/c")
1012
self.assertRaises(PathNotChild,
1013
urlutils.file_relpath, "file:///A:/b/", "file:///A:/c")
1014
self.assertRaises(PathNotChild,
1015
urlutils.file_relpath, "file:///A:/b/", "file:///A:/c/")
1017
def test_parent_posix(self):
1018
self._with_posix_paths()
1019
self.assertRaises(PathNotChild,
1020
urlutils.file_relpath, "file:///a/b", "file:///a")
1021
self.assertRaises(PathNotChild,
1022
urlutils.file_relpath, "file:///a/b", "file:///a/")
1024
def test_parent_win32(self):
1025
self._with_win32_paths()
1026
self.assertRaises(PathNotChild,
1027
urlutils.file_relpath, "file:///A:/b", "file:///A:/")
1028
self.assertRaises(PathNotChild,
1029
urlutils.file_relpath, "file:///A:/b/c", "file:///A:/b")
1032
class QuoteTests(TestCase):
1034
def test_quote(self):
1035
self.assertEqual('abc%20def', urlutils.quote('abc def'))
1036
self.assertEqual('abc%2Fdef', urlutils.quote('abc/def', safe=''))
1037
self.assertEqual('abc/def', urlutils.quote('abc/def', safe='/'))
1039
def test_quote_tildes(self):
1040
self.assertEqual('%7Efoo', urlutils.quote('~foo'))
1041
self.assertEqual('~foo', urlutils.quote('~foo', safe='/~'))
1043
def test_unquote(self):
1044
self.assertEqual('%', urlutils.unquote('%25'))
1045
self.assertEqual('\xc3\xa5', urlutils.unquote('%C3%A5'))
1046
self.assertEqual(u"\xe5", urlutils.unquote(u'\xe5'))