1
# Copyright (C) 2004, 2005, 2006 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21
from cStringIO import StringIO
24
from bzrlib import urlutils
25
from bzrlib.errors import (NoSuchFile, FileExists,
32
from bzrlib.tests import TestCase, TestCaseInTempDir
33
from bzrlib.transport import (_CoalescedOffset,
34
_get_protocol_handlers,
35
_get_transport_modules,
37
register_lazy_transport,
38
_set_protocol_handlers,
41
from bzrlib.transport.memory import MemoryTransport
42
from bzrlib.transport.local import (LocalTransport,
43
EmulatedWin32LocalTransport)
46
# TODO: Should possibly split transport-specific tests into their own files.
49
class TestTransport(TestCase):
50
"""Test the non transport-concrete class functionality."""
52
def test__get_set_protocol_handlers(self):
53
handlers = _get_protocol_handlers()
54
self.assertNotEqual({}, handlers)
56
_set_protocol_handlers({})
57
self.assertEqual({}, _get_protocol_handlers())
59
_set_protocol_handlers(handlers)
61
def test_get_transport_modules(self):
62
handlers = _get_protocol_handlers()
63
class SampleHandler(object):
64
"""I exist, isnt that enough?"""
67
_set_protocol_handlers(my_handlers)
68
register_lazy_transport('foo', 'bzrlib.tests.test_transport', 'TestTransport.SampleHandler')
69
register_lazy_transport('bar', 'bzrlib.tests.test_transport', 'TestTransport.SampleHandler')
70
self.assertEqual([SampleHandler.__module__],
71
_get_transport_modules())
73
_set_protocol_handlers(handlers)
75
def test_transport_dependency(self):
76
"""Transport with missing dependency causes no error"""
77
saved_handlers = _get_protocol_handlers()
79
register_lazy_transport('foo', 'bzrlib.tests.test_transport',
80
'BadTransportHandler')
82
get_transport('foo://fooserver/foo')
83
except UnsupportedProtocol, e:
85
self.assertEquals('Unsupported protocol'
86
' for url "foo://fooserver/foo":'
87
' Unable to import library "some_lib":'
88
' testing missing dependency', str(e))
90
self.fail('Did not raise UnsupportedProtocol')
92
# restore original values
93
_set_protocol_handlers(saved_handlers)
95
def test_transport_fallback(self):
96
"""Transport with missing dependency causes no error"""
97
saved_handlers = _get_protocol_handlers()
99
_set_protocol_handlers({})
100
register_lazy_transport('foo', 'bzrlib.tests.test_transport',
101
'BackupTransportHandler')
102
register_lazy_transport('foo', 'bzrlib.tests.test_transport',
103
'BadTransportHandler')
104
t = get_transport('foo://fooserver/foo')
105
self.assertTrue(isinstance(t, BackupTransportHandler))
107
_set_protocol_handlers(saved_handlers)
109
def test__combine_paths(self):
111
self.assertEqual('/home/sarah/project/foo',
112
t._combine_paths('/home/sarah', 'project/foo'))
113
self.assertEqual('/etc',
114
t._combine_paths('/home/sarah', '../../etc'))
115
self.assertEqual('/etc',
116
t._combine_paths('/home/sarah', '../../../etc'))
117
self.assertEqual('/etc',
118
t._combine_paths('/home/sarah', '/etc'))
121
class TestCoalesceOffsets(TestCase):
123
def check(self, expected, offsets, limit=0, fudge=0):
124
coalesce = Transport._coalesce_offsets
125
exp = [_CoalescedOffset(*x) for x in expected]
126
out = list(coalesce(offsets, limit=limit, fudge_factor=fudge))
127
self.assertEqual(exp, out)
129
def test_coalesce_empty(self):
132
def test_coalesce_simple(self):
133
self.check([(0, 10, [(0, 10)])], [(0, 10)])
135
def test_coalesce_unrelated(self):
136
self.check([(0, 10, [(0, 10)]),
138
], [(0, 10), (20, 10)])
140
def test_coalesce_unsorted(self):
141
self.check([(20, 10, [(0, 10)]),
143
], [(20, 10), (0, 10)])
145
def test_coalesce_nearby(self):
146
self.check([(0, 20, [(0, 10), (10, 10)])],
149
def test_coalesce_overlapped(self):
150
self.check([(0, 15, [(0, 10), (5, 10)])],
153
def test_coalesce_limit(self):
154
self.check([(10, 50, [(0, 10), (10, 10), (20, 10),
155
(30, 10), (40, 10)]),
156
(60, 50, [(0, 10), (10, 10), (20, 10),
157
(30, 10), (40, 10)]),
158
], [(10, 10), (20, 10), (30, 10), (40, 10),
159
(50, 10), (60, 10), (70, 10), (80, 10),
160
(90, 10), (100, 10)],
163
def test_coalesce_no_limit(self):
164
self.check([(10, 100, [(0, 10), (10, 10), (20, 10),
165
(30, 10), (40, 10), (50, 10),
166
(60, 10), (70, 10), (80, 10),
168
], [(10, 10), (20, 10), (30, 10), (40, 10),
169
(50, 10), (60, 10), (70, 10), (80, 10),
170
(90, 10), (100, 10)])
172
def test_coalesce_fudge(self):
173
self.check([(10, 30, [(0, 10), (20, 10)]),
174
(100, 10, [(0, 10),]),
175
], [(10, 10), (30, 10), (100, 10)],
180
class TestMemoryTransport(TestCase):
182
def test_get_transport(self):
185
def test_clone(self):
186
transport = MemoryTransport()
187
self.assertTrue(isinstance(transport, MemoryTransport))
188
self.assertEqual("memory:///", transport.clone("/").base)
190
def test_abspath(self):
191
transport = MemoryTransport()
192
self.assertEqual("memory:///relpath", transport.abspath('relpath'))
194
def test_abspath_of_root(self):
195
transport = MemoryTransport()
196
self.assertEqual("memory:///", transport.base)
197
self.assertEqual("memory:///", transport.abspath('/'))
199
def test_abspath_of_relpath_starting_at_root(self):
200
transport = MemoryTransport()
201
self.assertEqual("memory:///foo", transport.abspath('/foo'))
203
def test_append_and_get(self):
204
transport = MemoryTransport()
205
transport.append_bytes('path', 'content')
206
self.assertEqual(transport.get('path').read(), 'content')
207
transport.append_file('path', StringIO('content'))
208
self.assertEqual(transport.get('path').read(), 'contentcontent')
210
def test_put_and_get(self):
211
transport = MemoryTransport()
212
transport.put_file('path', StringIO('content'))
213
self.assertEqual(transport.get('path').read(), 'content')
214
transport.put_bytes('path', 'content')
215
self.assertEqual(transport.get('path').read(), 'content')
217
def test_append_without_dir_fails(self):
218
transport = MemoryTransport()
219
self.assertRaises(NoSuchFile,
220
transport.append_bytes, 'dir/path', 'content')
222
def test_put_without_dir_fails(self):
223
transport = MemoryTransport()
224
self.assertRaises(NoSuchFile,
225
transport.put_file, 'dir/path', StringIO('content'))
227
def test_get_missing(self):
228
transport = MemoryTransport()
229
self.assertRaises(NoSuchFile, transport.get, 'foo')
231
def test_has_missing(self):
232
transport = MemoryTransport()
233
self.assertEquals(False, transport.has('foo'))
235
def test_has_present(self):
236
transport = MemoryTransport()
237
transport.append_bytes('foo', 'content')
238
self.assertEquals(True, transport.has('foo'))
240
def test_list_dir(self):
241
transport = MemoryTransport()
242
transport.put_bytes('foo', 'content')
243
transport.mkdir('dir')
244
transport.put_bytes('dir/subfoo', 'content')
245
transport.put_bytes('dirlike', 'content')
247
self.assertEquals(['dir', 'dirlike', 'foo'], sorted(transport.list_dir('.')))
248
self.assertEquals(['subfoo'], sorted(transport.list_dir('dir')))
250
def test_mkdir(self):
251
transport = MemoryTransport()
252
transport.mkdir('dir')
253
transport.append_bytes('dir/path', 'content')
254
self.assertEqual(transport.get('dir/path').read(), 'content')
256
def test_mkdir_missing_parent(self):
257
transport = MemoryTransport()
258
self.assertRaises(NoSuchFile,
259
transport.mkdir, 'dir/dir')
261
def test_mkdir_twice(self):
262
transport = MemoryTransport()
263
transport.mkdir('dir')
264
self.assertRaises(FileExists, transport.mkdir, 'dir')
266
def test_parameters(self):
267
transport = MemoryTransport()
268
self.assertEqual(True, transport.listable())
269
self.assertEqual(False, transport.should_cache())
270
self.assertEqual(False, transport.is_readonly())
272
def test_iter_files_recursive(self):
273
transport = MemoryTransport()
274
transport.mkdir('dir')
275
transport.put_bytes('dir/foo', 'content')
276
transport.put_bytes('dir/bar', 'content')
277
transport.put_bytes('bar', 'content')
278
paths = set(transport.iter_files_recursive())
279
self.assertEqual(set(['dir/foo', 'dir/bar', 'bar']), paths)
282
transport = MemoryTransport()
283
transport.put_bytes('foo', 'content')
284
transport.put_bytes('bar', 'phowar')
285
self.assertEqual(7, transport.stat('foo').st_size)
286
self.assertEqual(6, transport.stat('bar').st_size)
289
class ChrootDecoratorTransportTest(TestCase):
290
"""Chroot decoration specific tests."""
292
def test_construct(self):
293
from bzrlib.transport import chroot
294
transport = chroot.ChrootTransportDecorator('chroot+memory:///pathA/')
295
self.assertEqual('memory:///pathA/', transport.chroot_url)
297
transport = chroot.ChrootTransportDecorator(
298
'chroot+memory:///path/B', chroot='memory:///path/')
299
self.assertEqual('memory:///path/', transport.chroot_url)
301
def test_append_file(self):
302
transport = get_transport('chroot+memory:///foo/bar')
303
self.assertRaises(PathNotChild, transport.append_file, '/foo', None)
305
def test_append_bytes(self):
306
transport = get_transport('chroot+memory:///foo/bar')
307
self.assertRaises(PathNotChild, transport.append_bytes, '/foo', 'bytes')
309
def test_clone(self):
310
transport = get_transport('chroot+memory:///foo/bar')
311
self.assertRaises(PathNotChild, transport.clone, '/foo')
313
def test_delete(self):
314
transport = get_transport('chroot+memory:///foo/bar')
315
self.assertRaises(PathNotChild, transport.delete, '/foo')
317
def test_delete_tree(self):
318
transport = get_transport('chroot+memory:///foo/bar')
319
self.assertRaises(PathNotChild, transport.delete_tree, '/foo')
322
transport = get_transport('chroot+memory:///foo/bar')
323
self.assertRaises(PathNotChild, transport.get, '/foo')
325
def test_get_bytes(self):
326
transport = get_transport('chroot+memory:///foo/bar')
327
self.assertRaises(PathNotChild, transport.get_bytes, '/foo')
330
transport = get_transport('chroot+memory:///foo/bar')
331
self.assertRaises(PathNotChild, transport.has, '/foo')
333
def test_list_dir(self):
334
transport = get_transport('chroot+memory:///foo/bar')
335
self.assertRaises(PathNotChild, transport.list_dir, '/foo')
337
def test_lock_read(self):
338
transport = get_transport('chroot+memory:///foo/bar')
339
self.assertRaises(PathNotChild, transport.lock_read, '/foo')
341
def test_lock_write(self):
342
transport = get_transport('chroot+memory:///foo/bar')
343
self.assertRaises(PathNotChild, transport.lock_write, '/foo')
345
def test_mkdir(self):
346
transport = get_transport('chroot+memory:///foo/bar')
347
self.assertRaises(PathNotChild, transport.mkdir, '/foo')
349
def test_put_bytes(self):
350
transport = get_transport('chroot+memory:///foo/bar')
351
self.assertRaises(PathNotChild, transport.put_bytes, '/foo', 'bytes')
353
def test_put_file(self):
354
transport = get_transport('chroot+memory:///foo/bar')
355
self.assertRaises(PathNotChild, transport.put_file, '/foo', None)
357
def test_rename(self):
358
transport = get_transport('chroot+memory:///foo/bar')
359
self.assertRaises(PathNotChild, transport.rename, '/aaa', 'bbb')
360
self.assertRaises(PathNotChild, transport.rename, 'ccc', '/d')
362
def test_rmdir(self):
363
transport = get_transport('chroot+memory:///foo/bar')
364
self.assertRaises(PathNotChild, transport.rmdir, '/foo')
367
transport = get_transport('chroot+memory:///foo/bar')
368
self.assertRaises(PathNotChild, transport.stat, '/foo')
371
class ReadonlyDecoratorTransportTest(TestCase):
372
"""Readonly decoration specific tests."""
374
def test_local_parameters(self):
375
import bzrlib.transport.readonly as readonly
376
# connect to . in readonly mode
377
transport = readonly.ReadonlyTransportDecorator('readonly+.')
378
self.assertEqual(True, transport.listable())
379
self.assertEqual(False, transport.should_cache())
380
self.assertEqual(True, transport.is_readonly())
382
def test_http_parameters(self):
383
from bzrlib.tests.HttpServer import HttpServer
384
import bzrlib.transport.readonly as readonly
385
# connect to . via http which is not listable
386
server = HttpServer()
389
transport = get_transport('readonly+' + server.get_url())
390
self.failUnless(isinstance(transport,
391
readonly.ReadonlyTransportDecorator))
392
self.assertEqual(False, transport.listable())
393
self.assertEqual(True, transport.should_cache())
394
self.assertEqual(True, transport.is_readonly())
399
class FakeNFSDecoratorTests(TestCaseInTempDir):
400
"""NFS decorator specific tests."""
402
def get_nfs_transport(self, url):
403
import bzrlib.transport.fakenfs as fakenfs
404
# connect to url with nfs decoration
405
return fakenfs.FakeNFSTransportDecorator('fakenfs+' + url)
407
def test_local_parameters(self):
408
# the listable, should_cache and is_readonly parameters
409
# are not changed by the fakenfs decorator
410
transport = self.get_nfs_transport('.')
411
self.assertEqual(True, transport.listable())
412
self.assertEqual(False, transport.should_cache())
413
self.assertEqual(False, transport.is_readonly())
415
def test_http_parameters(self):
416
# the listable, should_cache and is_readonly parameters
417
# are not changed by the fakenfs decorator
418
from bzrlib.tests.HttpServer import HttpServer
419
# connect to . via http which is not listable
420
server = HttpServer()
423
transport = self.get_nfs_transport(server.get_url())
424
self.assertIsInstance(
425
transport, bzrlib.transport.fakenfs.FakeNFSTransportDecorator)
426
self.assertEqual(False, transport.listable())
427
self.assertEqual(True, transport.should_cache())
428
self.assertEqual(True, transport.is_readonly())
432
def test_fakenfs_server_default(self):
433
# a FakeNFSServer() should bring up a local relpath server for itself
434
import bzrlib.transport.fakenfs as fakenfs
435
server = fakenfs.FakeNFSServer()
438
# the url should be decorated appropriately
439
self.assertStartsWith(server.get_url(), 'fakenfs+')
440
# and we should be able to get a transport for it
441
transport = get_transport(server.get_url())
442
# which must be a FakeNFSTransportDecorator instance.
443
self.assertIsInstance(
444
transport, fakenfs.FakeNFSTransportDecorator)
448
def test_fakenfs_rename_semantics(self):
449
# a FakeNFS transport must mangle the way rename errors occur to
450
# look like NFS problems.
451
transport = self.get_nfs_transport('.')
452
self.build_tree(['from/', 'from/foo', 'to/', 'to/bar'],
454
self.assertRaises(bzrlib.errors.ResourceBusy,
455
transport.rename, 'from', 'to')
458
class FakeVFATDecoratorTests(TestCaseInTempDir):
459
"""Tests for simulation of VFAT restrictions"""
461
def get_vfat_transport(self, url):
462
"""Return vfat-backed transport for test directory"""
463
from bzrlib.transport.fakevfat import FakeVFATTransportDecorator
464
return FakeVFATTransportDecorator('vfat+' + url)
466
def test_transport_creation(self):
467
from bzrlib.transport.fakevfat import FakeVFATTransportDecorator
468
transport = self.get_vfat_transport('.')
469
self.assertIsInstance(transport, FakeVFATTransportDecorator)
471
def test_transport_mkdir(self):
472
transport = self.get_vfat_transport('.')
473
transport.mkdir('HELLO')
474
self.assertTrue(transport.has('hello'))
475
self.assertTrue(transport.has('Hello'))
477
def test_forbidden_chars(self):
478
transport = self.get_vfat_transport('.')
479
self.assertRaises(ValueError, transport.has, "<NU>")
482
class BadTransportHandler(Transport):
483
def __init__(self, base_url):
484
raise DependencyNotPresent('some_lib', 'testing missing dependency')
487
class BackupTransportHandler(Transport):
488
"""Test transport that works as a backup for the BadTransportHandler"""
492
class TestTransportImplementation(TestCaseInTempDir):
493
"""Implementation verification for transports.
495
To verify a transport we need a server factory, which is a callable
496
that accepts no parameters and returns an implementation of
497
bzrlib.transport.Server.
499
That Server is then used to construct transport instances and test
500
the transport via loopback activity.
502
Currently this assumes that the Transport object is connected to the
503
current working directory. So that whatever is done
504
through the transport, should show up in the working
505
directory, and vice-versa. This is a bug, because its possible to have
506
URL schemes which provide access to something that may not be
507
result in storage on the local disk, i.e. due to file system limits, or
508
due to it being a database or some other non-filesystem tool.
510
This also tests to make sure that the functions work with both
511
generators and lists (assuming iter(list) is effectively a generator)
515
super(TestTransportImplementation, self).setUp()
516
self._server = self.transport_server()
520
super(TestTransportImplementation, self).tearDown()
521
self._server.tearDown()
523
def get_transport(self):
524
"""Return a connected transport to the local directory."""
525
base_url = self._server.get_url()
526
# try getting the transport via the regular interface:
527
t = get_transport(base_url)
528
if not isinstance(t, self.transport_class):
529
# we did not get the correct transport class type. Override the
530
# regular connection behaviour by direct construction.
531
t = self.transport_class(base_url)
535
class TestLocalTransports(TestCase):
537
def test_get_transport_from_abspath(self):
538
here = os.path.abspath('.')
539
t = get_transport(here)
540
self.assertIsInstance(t, LocalTransport)
541
self.assertEquals(t.base, urlutils.local_path_to_url(here) + '/')
543
def test_get_transport_from_relpath(self):
544
here = os.path.abspath('.')
545
t = get_transport('.')
546
self.assertIsInstance(t, LocalTransport)
547
self.assertEquals(t.base, urlutils.local_path_to_url('.') + '/')
549
def test_get_transport_from_local_url(self):
550
here = os.path.abspath('.')
551
here_url = urlutils.local_path_to_url(here) + '/'
552
t = get_transport(here_url)
553
self.assertIsInstance(t, LocalTransport)
554
self.assertEquals(t.base, here_url)
557
class TestWin32LocalTransport(TestCase):
559
def test_unc_clone_to_root(self):
560
# Win32 UNC path like \\HOST\path
561
# clone to root should stop at least at \\HOST part
563
t = EmulatedWin32LocalTransport('file://HOST/path/to/some/dir/')
566
self.assertEquals(t.base, 'file://HOST/')
567
# make sure we reach the root
569
self.assertEquals(t.base, 'file://HOST/')
added
removed
bzrlib/tests/test_transport.py
