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
45
# TODO: Should possibly split transport-specific tests into their own files.
48
class TestTransport(TestCase):
49
"""Test the non transport-concrete class functionality."""
51
def test__get_set_protocol_handlers(self):
52
handlers = _get_protocol_handlers()
53
self.assertNotEqual({}, handlers)
55
_set_protocol_handlers({})
56
self.assertEqual({}, _get_protocol_handlers())
58
_set_protocol_handlers(handlers)
60
def test_get_transport_modules(self):
61
handlers = _get_protocol_handlers()
62
class SampleHandler(object):
63
"""I exist, isnt that enough?"""
66
_set_protocol_handlers(my_handlers)
67
register_lazy_transport('foo', 'bzrlib.tests.test_transport', 'TestTransport.SampleHandler')
68
register_lazy_transport('bar', 'bzrlib.tests.test_transport', 'TestTransport.SampleHandler')
69
self.assertEqual([SampleHandler.__module__],
70
_get_transport_modules())
72
_set_protocol_handlers(handlers)
74
def test_transport_dependency(self):
75
"""Transport with missing dependency causes no error"""
76
saved_handlers = _get_protocol_handlers()
78
register_lazy_transport('foo', 'bzrlib.tests.test_transport',
79
'BadTransportHandler')
81
get_transport('foo://fooserver/foo')
82
except UnsupportedProtocol, e:
84
self.assertEquals('Unsupported protocol'
85
' for url "foo://fooserver/foo":'
86
' Unable to import library "some_lib":'
87
' testing missing dependency', str(e))
89
self.fail('Did not raise UnsupportedProtocol')
91
# restore original values
92
_set_protocol_handlers(saved_handlers)
94
def test_transport_fallback(self):
95
"""Transport with missing dependency causes no error"""
96
saved_handlers = _get_protocol_handlers()
98
_set_protocol_handlers({})
99
register_lazy_transport('foo', 'bzrlib.tests.test_transport',
100
'BackupTransportHandler')
101
register_lazy_transport('foo', 'bzrlib.tests.test_transport',
102
'BadTransportHandler')
103
t = get_transport('foo://fooserver/foo')
104
self.assertTrue(isinstance(t, BackupTransportHandler))
106
_set_protocol_handlers(saved_handlers)
108
def test__combine_paths(self):
110
self.assertEqual('/home/sarah/project/foo',
111
t._combine_paths('/home/sarah', 'project/foo'))
112
self.assertEqual('/etc',
113
t._combine_paths('/home/sarah', '../../etc'))
114
self.assertEqual('/etc',
115
t._combine_paths('/home/sarah', '../../../etc'))
116
self.assertEqual('/etc',
117
t._combine_paths('/home/sarah', '/etc'))
120
class TestCoalesceOffsets(TestCase):
122
def check(self, expected, offsets, limit=0, fudge=0):
123
coalesce = Transport._coalesce_offsets
124
exp = [_CoalescedOffset(*x) for x in expected]
125
out = list(coalesce(offsets, limit=limit, fudge_factor=fudge))
126
self.assertEqual(exp, out)
128
def test_coalesce_empty(self):
131
def test_coalesce_simple(self):
132
self.check([(0, 10, [(0, 10)])], [(0, 10)])
134
def test_coalesce_unrelated(self):
135
self.check([(0, 10, [(0, 10)]),
137
], [(0, 10), (20, 10)])
139
def test_coalesce_unsorted(self):
140
self.check([(20, 10, [(0, 10)]),
142
], [(20, 10), (0, 10)])
144
def test_coalesce_nearby(self):
145
self.check([(0, 20, [(0, 10), (10, 10)])],
148
def test_coalesce_overlapped(self):
149
self.check([(0, 15, [(0, 10), (5, 10)])],
152
def test_coalesce_limit(self):
153
self.check([(10, 50, [(0, 10), (10, 10), (20, 10),
154
(30, 10), (40, 10)]),
155
(60, 50, [(0, 10), (10, 10), (20, 10),
156
(30, 10), (40, 10)]),
157
], [(10, 10), (20, 10), (30, 10), (40, 10),
158
(50, 10), (60, 10), (70, 10), (80, 10),
159
(90, 10), (100, 10)],
162
def test_coalesce_no_limit(self):
163
self.check([(10, 100, [(0, 10), (10, 10), (20, 10),
164
(30, 10), (40, 10), (50, 10),
165
(60, 10), (70, 10), (80, 10),
167
], [(10, 10), (20, 10), (30, 10), (40, 10),
168
(50, 10), (60, 10), (70, 10), (80, 10),
169
(90, 10), (100, 10)])
171
def test_coalesce_fudge(self):
172
self.check([(10, 30, [(0, 10), (20, 10)]),
173
(100, 10, [(0, 10),]),
174
], [(10, 10), (30, 10), (100, 10)],
179
class TestMemoryTransport(TestCase):
181
def test_get_transport(self):
184
def test_clone(self):
185
transport = MemoryTransport()
186
self.assertTrue(isinstance(transport, MemoryTransport))
187
self.assertEqual("memory:///", transport.clone("/").base)
189
def test_abspath(self):
190
transport = MemoryTransport()
191
self.assertEqual("memory:///relpath", transport.abspath('relpath'))
193
def test_abspath_of_root(self):
194
transport = MemoryTransport()
195
self.assertEqual("memory:///", transport.base)
196
self.assertEqual("memory:///", transport.abspath('/'))
198
def test_abspath_of_relpath_starting_at_root(self):
199
transport = MemoryTransport()
200
self.assertEqual("memory:///foo", transport.abspath('/foo'))
202
def test_append_and_get(self):
203
transport = MemoryTransport()
204
transport.append_bytes('path', 'content')
205
self.assertEqual(transport.get('path').read(), 'content')
206
transport.append_file('path', StringIO('content'))
207
self.assertEqual(transport.get('path').read(), 'contentcontent')
209
def test_put_and_get(self):
210
transport = MemoryTransport()
211
transport.put_file('path', StringIO('content'))
212
self.assertEqual(transport.get('path').read(), 'content')
213
transport.put_bytes('path', 'content')
214
self.assertEqual(transport.get('path').read(), 'content')
216
def test_append_without_dir_fails(self):
217
transport = MemoryTransport()
218
self.assertRaises(NoSuchFile,
219
transport.append_bytes, 'dir/path', 'content')
221
def test_put_without_dir_fails(self):
222
transport = MemoryTransport()
223
self.assertRaises(NoSuchFile,
224
transport.put_file, 'dir/path', StringIO('content'))
226
def test_get_missing(self):
227
transport = MemoryTransport()
228
self.assertRaises(NoSuchFile, transport.get, 'foo')
230
def test_has_missing(self):
231
transport = MemoryTransport()
232
self.assertEquals(False, transport.has('foo'))
234
def test_has_present(self):
235
transport = MemoryTransport()
236
transport.append_bytes('foo', 'content')
237
self.assertEquals(True, transport.has('foo'))
239
def test_list_dir(self):
240
transport = MemoryTransport()
241
transport.put_bytes('foo', 'content')
242
transport.mkdir('dir')
243
transport.put_bytes('dir/subfoo', 'content')
244
transport.put_bytes('dirlike', 'content')
246
self.assertEquals(['dir', 'dirlike', 'foo'], sorted(transport.list_dir('.')))
247
self.assertEquals(['subfoo'], sorted(transport.list_dir('dir')))
249
def test_mkdir(self):
250
transport = MemoryTransport()
251
transport.mkdir('dir')
252
transport.append_bytes('dir/path', 'content')
253
self.assertEqual(transport.get('dir/path').read(), 'content')
255
def test_mkdir_missing_parent(self):
256
transport = MemoryTransport()
257
self.assertRaises(NoSuchFile,
258
transport.mkdir, 'dir/dir')
260
def test_mkdir_twice(self):
261
transport = MemoryTransport()
262
transport.mkdir('dir')
263
self.assertRaises(FileExists, transport.mkdir, 'dir')
265
def test_parameters(self):
266
transport = MemoryTransport()
267
self.assertEqual(True, transport.listable())
268
self.assertEqual(False, transport.should_cache())
269
self.assertEqual(False, transport.is_readonly())
271
def test_iter_files_recursive(self):
272
transport = MemoryTransport()
273
transport.mkdir('dir')
274
transport.put_bytes('dir/foo', 'content')
275
transport.put_bytes('dir/bar', 'content')
276
transport.put_bytes('bar', 'content')
277
paths = set(transport.iter_files_recursive())
278
self.assertEqual(set(['dir/foo', 'dir/bar', 'bar']), paths)
281
transport = MemoryTransport()
282
transport.put_bytes('foo', 'content')
283
transport.put_bytes('bar', 'phowar')
284
self.assertEqual(7, transport.stat('foo').st_size)
285
self.assertEqual(6, transport.stat('bar').st_size)
288
class ChrootDecoratorTransportTest(TestCase):
289
"""Chroot decoration specific tests."""
291
def test_construct(self):
292
from bzrlib.transport import chroot
293
transport = chroot.ChrootTransportDecorator('chroot+memory:///pathA/')
294
self.assertEqual('memory:///pathA/', transport.chroot_url)
296
transport = chroot.ChrootTransportDecorator(
297
'chroot+memory:///path/B', chroot='memory:///path/')
298
self.assertEqual('memory:///path/', transport.chroot_url)
300
def test_append_file(self):
301
transport = get_transport('chroot+file:///foo/bar')
302
self.assertRaises(PathNotChild, transport.append_file, '/foo', None)
304
def test_append_bytes(self):
305
transport = get_transport('chroot+file:///foo/bar')
306
self.assertRaises(PathNotChild, transport.append_bytes, '/foo', 'bytes')
308
def test_clone(self):
309
transport = get_transport('chroot+file:///foo/bar')
310
self.assertRaises(PathNotChild, transport.clone, '/foo')
312
def test_delete(self):
313
transport = get_transport('chroot+file:///foo/bar')
314
self.assertRaises(PathNotChild, transport.delete, '/foo')
316
def test_delete_tree(self):
317
transport = get_transport('chroot+file:///foo/bar')
318
self.assertRaises(PathNotChild, transport.delete_tree, '/foo')
321
transport = get_transport('chroot+file:///foo/bar')
322
self.assertRaises(PathNotChild, transport.get, '/foo')
324
def test_get_bytes(self):
325
transport = get_transport('chroot+file:///foo/bar')
326
self.assertRaises(PathNotChild, transport.get_bytes, '/foo')
329
transport = get_transport('chroot+file:///foo/bar')
330
self.assertRaises(PathNotChild, transport.has, '/foo')
332
def test_list_dir(self):
333
transport = get_transport('chroot+file:///foo/bar')
334
self.assertRaises(PathNotChild, transport.list_dir, '/foo')
336
def test_lock_read(self):
337
transport = get_transport('chroot+file:///foo/bar')
338
self.assertRaises(PathNotChild, transport.lock_read, '/foo')
340
def test_lock_write(self):
341
transport = get_transport('chroot+file:///foo/bar')
342
self.assertRaises(PathNotChild, transport.lock_write, '/foo')
344
def test_mkdir(self):
345
transport = get_transport('chroot+file:///foo/bar')
346
self.assertRaises(PathNotChild, transport.mkdir, '/foo')
348
def test_put_bytes(self):
349
transport = get_transport('chroot+file:///foo/bar')
350
self.assertRaises(PathNotChild, transport.put_bytes, '/foo', 'bytes')
352
def test_put_file(self):
353
transport = get_transport('chroot+file:///foo/bar')
354
self.assertRaises(PathNotChild, transport.put_file, '/foo', None)
356
def test_rename(self):
357
transport = get_transport('chroot+file:///foo/bar')
358
self.assertRaises(PathNotChild, transport.rename, '/aaa', 'bbb')
359
self.assertRaises(PathNotChild, transport.rename, 'ccc', '/d')
361
def test_rmdir(self):
362
transport = get_transport('chroot+file:///foo/bar')
363
self.assertRaises(PathNotChild, transport.rmdir, '/foo')
366
transport = get_transport('chroot+file:///foo/bar')
367
self.assertRaises(PathNotChild, transport.stat, '/foo')
370
class ReadonlyDecoratorTransportTest(TestCase):
371
"""Readonly decoration specific tests."""
373
def test_local_parameters(self):
374
import bzrlib.transport.readonly as readonly
375
# connect to . in readonly mode
376
transport = readonly.ReadonlyTransportDecorator('readonly+.')
377
self.assertEqual(True, transport.listable())
378
self.assertEqual(False, transport.should_cache())
379
self.assertEqual(True, transport.is_readonly())
381
def test_http_parameters(self):
382
from bzrlib.tests.HttpServer import HttpServer
383
import bzrlib.transport.readonly as readonly
384
# connect to . via http which is not listable
385
server = HttpServer()
388
transport = get_transport('readonly+' + server.get_url())
389
self.failUnless(isinstance(transport,
390
readonly.ReadonlyTransportDecorator))
391
self.assertEqual(False, transport.listable())
392
self.assertEqual(True, transport.should_cache())
393
self.assertEqual(True, transport.is_readonly())
398
class FakeNFSDecoratorTests(TestCaseInTempDir):
399
"""NFS decorator specific tests."""
401
def get_nfs_transport(self, url):
402
import bzrlib.transport.fakenfs as fakenfs
403
# connect to url with nfs decoration
404
return fakenfs.FakeNFSTransportDecorator('fakenfs+' + url)
406
def test_local_parameters(self):
407
# the listable, should_cache and is_readonly parameters
408
# are not changed by the fakenfs decorator
409
transport = self.get_nfs_transport('.')
410
self.assertEqual(True, transport.listable())
411
self.assertEqual(False, transport.should_cache())
412
self.assertEqual(False, transport.is_readonly())
414
def test_http_parameters(self):
415
# the listable, should_cache and is_readonly parameters
416
# are not changed by the fakenfs decorator
417
from bzrlib.tests.HttpServer import HttpServer
418
# connect to . via http which is not listable
419
server = HttpServer()
422
transport = self.get_nfs_transport(server.get_url())
423
self.assertIsInstance(
424
transport, bzrlib.transport.fakenfs.FakeNFSTransportDecorator)
425
self.assertEqual(False, transport.listable())
426
self.assertEqual(True, transport.should_cache())
427
self.assertEqual(True, transport.is_readonly())
431
def test_fakenfs_server_default(self):
432
# a FakeNFSServer() should bring up a local relpath server for itself
433
import bzrlib.transport.fakenfs as fakenfs
434
server = fakenfs.FakeNFSServer()
437
# the url should be decorated appropriately
438
self.assertStartsWith(server.get_url(), 'fakenfs+')
439
# and we should be able to get a transport for it
440
transport = get_transport(server.get_url())
441
# which must be a FakeNFSTransportDecorator instance.
442
self.assertIsInstance(
443
transport, fakenfs.FakeNFSTransportDecorator)
447
def test_fakenfs_rename_semantics(self):
448
# a FakeNFS transport must mangle the way rename errors occur to
449
# look like NFS problems.
450
transport = self.get_nfs_transport('.')
451
self.build_tree(['from/', 'from/foo', 'to/', 'to/bar'],
453
self.assertRaises(bzrlib.errors.ResourceBusy,
454
transport.rename, 'from', 'to')
457
class FakeVFATDecoratorTests(TestCaseInTempDir):
458
"""Tests for simulation of VFAT restrictions"""
460
def get_vfat_transport(self, url):
461
"""Return vfat-backed transport for test directory"""
462
from bzrlib.transport.fakevfat import FakeVFATTransportDecorator
463
return FakeVFATTransportDecorator('vfat+' + url)
465
def test_transport_creation(self):
466
from bzrlib.transport.fakevfat import FakeVFATTransportDecorator
467
transport = self.get_vfat_transport('.')
468
self.assertIsInstance(transport, FakeVFATTransportDecorator)
470
def test_transport_mkdir(self):
471
transport = self.get_vfat_transport('.')
472
transport.mkdir('HELLO')
473
self.assertTrue(transport.has('hello'))
474
self.assertTrue(transport.has('Hello'))
476
def test_forbidden_chars(self):
477
transport = self.get_vfat_transport('.')
478
self.assertRaises(ValueError, transport.has, "<NU>")
481
class BadTransportHandler(Transport):
482
def __init__(self, base_url):
483
raise DependencyNotPresent('some_lib', 'testing missing dependency')
486
class BackupTransportHandler(Transport):
487
"""Test transport that works as a backup for the BadTransportHandler"""
491
class TestTransportImplementation(TestCaseInTempDir):
492
"""Implementation verification for transports.
494
To verify a transport we need a server factory, which is a callable
495
that accepts no parameters and returns an implementation of
496
bzrlib.transport.Server.
498
That Server is then used to construct transport instances and test
499
the transport via loopback activity.
501
Currently this assumes that the Transport object is connected to the
502
current working directory. So that whatever is done
503
through the transport, should show up in the working
504
directory, and vice-versa. This is a bug, because its possible to have
505
URL schemes which provide access to something that may not be
506
result in storage on the local disk, i.e. due to file system limits, or
507
due to it being a database or some other non-filesystem tool.
509
This also tests to make sure that the functions work with both
510
generators and lists (assuming iter(list) is effectively a generator)
514
super(TestTransportImplementation, self).setUp()
515
self._server = self.transport_server()
519
super(TestTransportImplementation, self).tearDown()
520
self._server.tearDown()
522
def get_transport(self):
523
"""Return a connected transport to the local directory."""
524
base_url = self._server.get_url()
525
# try getting the transport via the regular interface:
526
t = get_transport(base_url)
527
if not isinstance(t, self.transport_class):
528
# we did not get the correct transport class type. Override the
529
# regular connection behaviour by direct construction.
530
t = self.transport_class(base_url)
534
class TestLocalTransports(TestCase):
536
def test_get_transport_from_abspath(self):
537
here = os.path.abspath('.')
538
t = get_transport(here)
539
self.assertIsInstance(t, LocalTransport)
540
self.assertEquals(t.base, urlutils.local_path_to_url(here) + '/')
542
def test_get_transport_from_relpath(self):
543
here = os.path.abspath('.')
544
t = get_transport('.')
545
self.assertIsInstance(t, LocalTransport)
546
self.assertEquals(t.base, urlutils.local_path_to_url('.') + '/')
548
def test_get_transport_from_local_url(self):
549
here = os.path.abspath('.')
550
here_url = urlutils.local_path_to_url(here) + '/'
551
t = get_transport(here_url)
552
self.assertIsInstance(t, LocalTransport)
553
self.assertEquals(t.base, here_url)