~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/per_transport.py

  • Committer: Martin Pool
  • Date: 2009-08-20 04:53:23 UTC
  • mto: This revision was merged to the branch mainline in revision 4632.
  • Revision ID: mbp@sourcefrog.net-20090820045323-4hsicfa87pdq3l29
Correction to xdg_cache_dir and add a simple test

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2004, 2005, 2006 by Canonical Ltd
 
1
# Copyright (C) 2004, 2005, 2006, 2007 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
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
 
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
17
17
"""Tests for Transport implementations.
18
18
 
20
20
TransportTestProviderAdapter.
21
21
"""
22
22
 
 
23
import itertools
23
24
import os
24
25
from cStringIO import StringIO
 
26
from StringIO import StringIO as pyStringIO
25
27
import stat
26
28
import sys
 
29
import unittest
27
30
 
28
31
from bzrlib import (
 
32
    errors,
29
33
    osutils,
 
34
    tests,
30
35
    urlutils,
31
36
    )
32
 
from bzrlib.errors import (DirectoryNotEmpty, NoSuchFile, FileExists,
33
 
                           LockError, PathError,
34
 
                           TransportNotPossible, ConnectionError,
35
 
                           InvalidURL)
 
37
from bzrlib.errors import (ConnectionError,
 
38
                           DirectoryNotEmpty,
 
39
                           FileExists,
 
40
                           InvalidURL,
 
41
                           LockError,
 
42
                           NoSuchFile,
 
43
                           NotLocalUrl,
 
44
                           PathError,
 
45
                           TransportNotPossible,
 
46
                           )
36
47
from bzrlib.osutils import getcwd
37
 
from bzrlib.tests import TestCaseInTempDir, TestSkipped
 
48
from bzrlib.smart import medium
 
49
from bzrlib.tests import (
 
50
    TestCaseInTempDir,
 
51
    TestSkipped,
 
52
    TestNotApplicable,
 
53
    multiply_tests,
 
54
    )
38
55
from bzrlib.tests.test_transport import TestTransportImplementation
39
 
from bzrlib.transport import memory
40
 
import bzrlib.transport
41
 
 
42
 
 
43
 
def _append(fn, txt):
44
 
    """Append the given text (file-like object) to the supplied filename."""
45
 
    f = open(fn, 'ab')
46
 
    try:
47
 
        f.write(txt.read())
48
 
    finally:
49
 
        f.close()
 
56
from bzrlib.transport import (
 
57
    ConnectedTransport,
 
58
    get_transport,
 
59
    _get_transport_modules,
 
60
    )
 
61
from bzrlib.transport.memory import MemoryTransport
 
62
 
 
63
 
 
64
def get_transport_test_permutations(module):
 
65
    """Get the permutations module wants to have tested."""
 
66
    if getattr(module, 'get_test_permutations', None) is None:
 
67
        raise AssertionError(
 
68
            "transport module %s doesn't provide get_test_permutations()"
 
69
            % module.__name__)
 
70
        return []
 
71
    return module.get_test_permutations()
 
72
 
 
73
 
 
74
def transport_test_permutations():
 
75
    """Return a list of the klass, server_factory pairs to test."""
 
76
    result = []
 
77
    for module in _get_transport_modules():
 
78
        try:
 
79
            permutations = get_transport_test_permutations(
 
80
                reduce(getattr, (module).split('.')[1:], __import__(module)))
 
81
            for (klass, server_factory) in permutations:
 
82
                scenario = (server_factory.__name__,
 
83
                    {"transport_class":klass,
 
84
                     "transport_server":server_factory})
 
85
                result.append(scenario)
 
86
        except errors.DependencyNotPresent, e:
 
87
            # Continue even if a dependency prevents us
 
88
            # from adding this test
 
89
            pass
 
90
    return result
 
91
 
 
92
 
 
93
def load_tests(standard_tests, module, loader):
 
94
    """Multiply tests for tranport implementations."""
 
95
    result = loader.suiteClass()
 
96
    scenarios = transport_test_permutations()
 
97
    return multiply_tests(standard_tests, scenarios, result)
50
98
 
51
99
 
52
100
class TransportTests(TestTransportImplementation):
53
101
 
 
102
    def setUp(self):
 
103
        super(TransportTests, self).setUp()
 
104
        self._captureVar('BZR_NO_SMART_VFS', None)
 
105
 
54
106
    def check_transport_contents(self, content, transport, relpath):
55
107
        """Check that transport.get(relpath).read() == content."""
56
108
        self.assertEqualDiff(content, transport.get(relpath).read())
57
109
 
58
 
    def assertListRaises(self, excClass, func, *args, **kwargs):
59
 
        """Fail unless excClass is raised when the iterator from func is used.
60
 
        
61
 
        Many transport functions can return generators this makes sure
62
 
        to wrap them in a list() call to make sure the whole generator
63
 
        is run, and that the proper exception is raised.
64
 
        """
 
110
    def test_ensure_base_missing(self):
 
111
        """.ensure_base() should create the directory if it doesn't exist"""
 
112
        t = self.get_transport()
 
113
        t_a = t.clone('a')
 
114
        if t_a.is_readonly():
 
115
            self.assertRaises(TransportNotPossible,
 
116
                              t_a.ensure_base)
 
117
            return
 
118
        self.assertTrue(t_a.ensure_base())
 
119
        self.assertTrue(t.has('a'))
 
120
 
 
121
    def test_ensure_base_exists(self):
 
122
        """.ensure_base() should just be happy if it already exists"""
 
123
        t = self.get_transport()
 
124
        if t.is_readonly():
 
125
            return
 
126
 
 
127
        t.mkdir('a')
 
128
        t_a = t.clone('a')
 
129
        # ensure_base returns False if it didn't create the base
 
130
        self.assertFalse(t_a.ensure_base())
 
131
 
 
132
    def test_ensure_base_missing_parent(self):
 
133
        """.ensure_base() will fail if the parent dir doesn't exist"""
 
134
        t = self.get_transport()
 
135
        if t.is_readonly():
 
136
            return
 
137
 
 
138
        t_a = t.clone('a')
 
139
        t_b = t_a.clone('b')
 
140
        self.assertRaises(NoSuchFile, t_b.ensure_base)
 
141
 
 
142
    def test_external_url(self):
 
143
        """.external_url either works or raises InProcessTransport."""
 
144
        t = self.get_transport()
65
145
        try:
66
 
            list(func(*args, **kwargs))
67
 
        except excClass:
68
 
            return
69
 
        else:
70
 
            if hasattr(excClass,'__name__'): excName = excClass.__name__
71
 
            else: excName = str(excClass)
72
 
            raise self.failureException, "%s not raised" % excName
 
146
            t.external_url()
 
147
        except errors.InProcessTransport:
 
148
            pass
73
149
 
74
150
    def test_has(self):
75
151
        t = self.get_transport()
79
155
        self.assertEqual(True, t.has('a'))
80
156
        self.assertEqual(False, t.has('c'))
81
157
        self.assertEqual(True, t.has(urlutils.escape('%')))
82
 
        self.assertEqual(list(t.has_multi(['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h'])),
83
 
                [True, True, False, False, True, False, True, False])
 
158
        self.assertEqual(list(t.has_multi(['a', 'b', 'c', 'd',
 
159
                                           'e', 'f', 'g', 'h'])),
 
160
                         [True, True, False, False,
 
161
                          True, False, True, False])
84
162
        self.assertEqual(True, t.has_any(['a', 'b', 'c']))
85
 
        self.assertEqual(False, t.has_any(['c', 'd', 'f', urlutils.escape('%%')]))
86
 
        self.assertEqual(list(t.has_multi(iter(['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h']))),
87
 
                [True, True, False, False, True, False, True, False])
 
163
        self.assertEqual(False, t.has_any(['c', 'd', 'f',
 
164
                                           urlutils.escape('%%')]))
 
165
        self.assertEqual(list(t.has_multi(iter(['a', 'b', 'c', 'd',
 
166
                                                'e', 'f', 'g', 'h']))),
 
167
                         [True, True, False, False,
 
168
                          True, False, True, False])
88
169
        self.assertEqual(False, t.has_any(['c', 'c', 'c']))
89
170
        self.assertEqual(True, t.has_any(['b', 'b', 'b']))
90
171
 
 
172
    def test_has_root_works(self):
 
173
        from bzrlib.smart import server
 
174
        if self.transport_server is server.SmartTCPServer_for_testing:
 
175
            raise TestNotApplicable(
 
176
                "SmartTCPServer_for_testing intentionally does not allow "
 
177
                "access to /.")
 
178
        current_transport = self.get_transport()
 
179
        self.assertTrue(current_transport.has('/'))
 
180
        root = current_transport.clone('/')
 
181
        self.assertTrue(root.has(''))
 
182
 
91
183
    def test_get(self):
92
184
        t = self.get_transport()
93
185
 
100
192
        self.build_tree(files, transport=t, line_endings='binary')
101
193
        self.check_transport_contents('contents of a\n', t, 'a')
102
194
        content_f = t.get_multi(files)
103
 
        for content, f in zip(contents, content_f):
 
195
        # Use itertools.izip() instead of use zip() or map(), since they fully
 
196
        # evaluate their inputs, the transport requests should be issued and
 
197
        # handled sequentially (we don't want to force transport to buffer).
 
198
        for content, f in itertools.izip(contents, content_f):
104
199
            self.assertEqual(content, f.read())
105
200
 
106
201
        content_f = t.get_multi(iter(files))
107
 
        for content, f in zip(contents, content_f):
 
202
        # Use itertools.izip() for the same reason
 
203
        for content, f in itertools.izip(contents, content_f):
108
204
            self.assertEqual(content, f.read())
109
205
 
 
206
    def test_get_unknown_file(self):
 
207
        t = self.get_transport()
 
208
        files = ['a', 'b']
 
209
        contents = ['contents of a\n',
 
210
                    'contents of b\n',
 
211
                    ]
 
212
        self.build_tree(files, transport=t, line_endings='binary')
110
213
        self.assertRaises(NoSuchFile, t.get, 'c')
111
214
        self.assertListRaises(NoSuchFile, t.get_multi, ['a', 'b', 'c'])
112
215
        self.assertListRaises(NoSuchFile, t.get_multi, iter(['a', 'b', 'c']))
113
216
 
114
 
    def test_put(self):
115
 
        t = self.get_transport()
116
 
 
117
 
        if t.is_readonly():
118
 
            self.assertRaises(TransportNotPossible,
119
 
                    t.put, 'a', 'some text for a\n')
120
 
            return
121
 
 
122
 
        t.put('a', StringIO('some text for a\n'))
123
 
        self.failUnless(t.has('a'))
124
 
        self.check_transport_contents('some text for a\n', t, 'a')
125
 
        # Make sure 'has' is updated
126
 
        self.assertEqual(list(t.has_multi(['a', 'b', 'c', 'd', 'e'])),
127
 
                [True, False, False, False, False])
128
 
        # Put also replaces contents
129
 
        self.assertEqual(t.put_multi([('a', StringIO('new\ncontents for\na\n')),
130
 
                                      ('d', StringIO('contents\nfor d\n'))]),
131
 
                         2)
132
 
        self.assertEqual(list(t.has_multi(['a', 'b', 'c', 'd', 'e'])),
133
 
                [True, False, False, True, False])
134
 
        self.check_transport_contents('new\ncontents for\na\n', t, 'a')
135
 
        self.check_transport_contents('contents\nfor d\n', t, 'd')
136
 
 
137
 
        self.assertEqual(
138
 
            t.put_multi(iter([('a', StringIO('diff\ncontents for\na\n')),
139
 
                              ('d', StringIO('another contents\nfor d\n'))])),
140
 
                        2)
141
 
        self.check_transport_contents('diff\ncontents for\na\n', t, 'a')
142
 
        self.check_transport_contents('another contents\nfor d\n', t, 'd')
143
 
 
144
 
        self.assertRaises(NoSuchFile,
145
 
                          t.put, 'path/doesnt/exist/c', 'contents')
146
 
 
147
 
    def test_put_permissions(self):
148
 
        t = self.get_transport()
149
 
 
150
 
        if t.is_readonly():
151
 
            return
152
 
        if not t._can_roundtrip_unix_modebits():
153
 
            # Can't roundtrip, so no need to run this test
154
 
            return
155
 
        t.put('mode644', StringIO('test text\n'), mode=0644)
156
 
        self.assertTransportMode(t, 'mode644', 0644)
157
 
        t.put('mode666', StringIO('test text\n'), mode=0666)
158
 
        self.assertTransportMode(t, 'mode666', 0666)
159
 
        t.put('mode600', StringIO('test text\n'), mode=0600)
 
217
    def test_get_directory_read_gives_ReadError(self):
 
218
        """consistent errors for read() on a file returned by get()."""
 
219
        t = self.get_transport()
 
220
        if t.is_readonly():
 
221
            self.build_tree(['a directory/'])
 
222
        else:
 
223
            t.mkdir('a%20directory')
 
224
        # getting the file must either work or fail with a PathError
 
225
        try:
 
226
            a_file = t.get('a%20directory')
 
227
        except (errors.PathError, errors.RedirectRequested):
 
228
            # early failure return immediately.
 
229
            return
 
230
        # having got a file, read() must either work (i.e. http reading a dir
 
231
        # listing) or fail with ReadError
 
232
        try:
 
233
            a_file.read()
 
234
        except errors.ReadError:
 
235
            pass
 
236
 
 
237
    def test_get_bytes(self):
 
238
        t = self.get_transport()
 
239
 
 
240
        files = ['a', 'b', 'e', 'g']
 
241
        contents = ['contents of a\n',
 
242
                    'contents of b\n',
 
243
                    'contents of e\n',
 
244
                    'contents of g\n',
 
245
                    ]
 
246
        self.build_tree(files, transport=t, line_endings='binary')
 
247
        self.check_transport_contents('contents of a\n', t, 'a')
 
248
 
 
249
        for content, fname in zip(contents, files):
 
250
            self.assertEqual(content, t.get_bytes(fname))
 
251
 
 
252
    def test_get_bytes_unknown_file(self):
 
253
        t = self.get_transport()
 
254
 
 
255
        self.assertRaises(NoSuchFile, t.get_bytes, 'c')
 
256
 
 
257
    def test_get_with_open_write_stream_sees_all_content(self):
 
258
        t = self.get_transport()
 
259
        if t.is_readonly():
 
260
            return
 
261
        handle = t.open_write_stream('foo')
 
262
        try:
 
263
            handle.write('b')
 
264
            self.assertEqual('b', t.get('foo').read())
 
265
        finally:
 
266
            handle.close()
 
267
 
 
268
    def test_get_bytes_with_open_write_stream_sees_all_content(self):
 
269
        t = self.get_transport()
 
270
        if t.is_readonly():
 
271
            return
 
272
        handle = t.open_write_stream('foo')
 
273
        try:
 
274
            handle.write('b')
 
275
            self.assertEqual('b', t.get_bytes('foo'))
 
276
            self.assertEqual('b', t.get('foo').read())
 
277
        finally:
 
278
            handle.close()
 
279
 
 
280
    def test_put_bytes(self):
 
281
        t = self.get_transport()
 
282
 
 
283
        if t.is_readonly():
 
284
            self.assertRaises(TransportNotPossible,
 
285
                    t.put_bytes, 'a', 'some text for a\n')
 
286
            return
 
287
 
 
288
        t.put_bytes('a', 'some text for a\n')
 
289
        self.failUnless(t.has('a'))
 
290
        self.check_transport_contents('some text for a\n', t, 'a')
 
291
 
 
292
        # The contents should be overwritten
 
293
        t.put_bytes('a', 'new text for a\n')
 
294
        self.check_transport_contents('new text for a\n', t, 'a')
 
295
 
 
296
        self.assertRaises(NoSuchFile,
 
297
                          t.put_bytes, 'path/doesnt/exist/c', 'contents')
 
298
 
 
299
    def test_put_bytes_non_atomic(self):
 
300
        t = self.get_transport()
 
301
 
 
302
        if t.is_readonly():
 
303
            self.assertRaises(TransportNotPossible,
 
304
                    t.put_bytes_non_atomic, 'a', 'some text for a\n')
 
305
            return
 
306
 
 
307
        self.failIf(t.has('a'))
 
308
        t.put_bytes_non_atomic('a', 'some text for a\n')
 
309
        self.failUnless(t.has('a'))
 
310
        self.check_transport_contents('some text for a\n', t, 'a')
 
311
        # Put also replaces contents
 
312
        t.put_bytes_non_atomic('a', 'new\ncontents for\na\n')
 
313
        self.check_transport_contents('new\ncontents for\na\n', t, 'a')
 
314
 
 
315
        # Make sure we can create another file
 
316
        t.put_bytes_non_atomic('d', 'contents for\nd\n')
 
317
        # And overwrite 'a' with empty contents
 
318
        t.put_bytes_non_atomic('a', '')
 
319
        self.check_transport_contents('contents for\nd\n', t, 'd')
 
320
        self.check_transport_contents('', t, 'a')
 
321
 
 
322
        self.assertRaises(NoSuchFile, t.put_bytes_non_atomic, 'no/such/path',
 
323
                                       'contents\n')
 
324
        # Now test the create_parent flag
 
325
        self.assertRaises(NoSuchFile, t.put_bytes_non_atomic, 'dir/a',
 
326
                                       'contents\n')
 
327
        self.failIf(t.has('dir/a'))
 
328
        t.put_bytes_non_atomic('dir/a', 'contents for dir/a\n',
 
329
                               create_parent_dir=True)
 
330
        self.check_transport_contents('contents for dir/a\n', t, 'dir/a')
 
331
 
 
332
        # But we still get NoSuchFile if we can't make the parent dir
 
333
        self.assertRaises(NoSuchFile, t.put_bytes_non_atomic, 'not/there/a',
 
334
                                       'contents\n',
 
335
                                       create_parent_dir=True)
 
336
 
 
337
    def test_put_bytes_permissions(self):
 
338
        t = self.get_transport()
 
339
 
 
340
        if t.is_readonly():
 
341
            return
 
342
        if not t._can_roundtrip_unix_modebits():
 
343
            # Can't roundtrip, so no need to run this test
 
344
            return
 
345
        t.put_bytes('mode644', 'test text\n', mode=0644)
 
346
        self.assertTransportMode(t, 'mode644', 0644)
 
347
        t.put_bytes('mode666', 'test text\n', mode=0666)
 
348
        self.assertTransportMode(t, 'mode666', 0666)
 
349
        t.put_bytes('mode600', 'test text\n', mode=0600)
 
350
        self.assertTransportMode(t, 'mode600', 0600)
 
351
        # Yes, you can put_bytes a file such that it becomes readonly
 
352
        t.put_bytes('mode400', 'test text\n', mode=0400)
 
353
        self.assertTransportMode(t, 'mode400', 0400)
 
354
 
 
355
        # The default permissions should be based on the current umask
 
356
        umask = osutils.get_umask()
 
357
        t.put_bytes('nomode', 'test text\n', mode=None)
 
358
        self.assertTransportMode(t, 'nomode', 0666 & ~umask)
 
359
 
 
360
    def test_put_bytes_non_atomic_permissions(self):
 
361
        t = self.get_transport()
 
362
 
 
363
        if t.is_readonly():
 
364
            return
 
365
        if not t._can_roundtrip_unix_modebits():
 
366
            # Can't roundtrip, so no need to run this test
 
367
            return
 
368
        t.put_bytes_non_atomic('mode644', 'test text\n', mode=0644)
 
369
        self.assertTransportMode(t, 'mode644', 0644)
 
370
        t.put_bytes_non_atomic('mode666', 'test text\n', mode=0666)
 
371
        self.assertTransportMode(t, 'mode666', 0666)
 
372
        t.put_bytes_non_atomic('mode600', 'test text\n', mode=0600)
 
373
        self.assertTransportMode(t, 'mode600', 0600)
 
374
        t.put_bytes_non_atomic('mode400', 'test text\n', mode=0400)
 
375
        self.assertTransportMode(t, 'mode400', 0400)
 
376
 
 
377
        # The default permissions should be based on the current umask
 
378
        umask = osutils.get_umask()
 
379
        t.put_bytes_non_atomic('nomode', 'test text\n', mode=None)
 
380
        self.assertTransportMode(t, 'nomode', 0666 & ~umask)
 
381
 
 
382
        # We should also be able to set the mode for a parent directory
 
383
        # when it is created
 
384
        t.put_bytes_non_atomic('dir700/mode664', 'test text\n', mode=0664,
 
385
                               dir_mode=0700, create_parent_dir=True)
 
386
        self.assertTransportMode(t, 'dir700', 0700)
 
387
        t.put_bytes_non_atomic('dir770/mode664', 'test text\n', mode=0664,
 
388
                               dir_mode=0770, create_parent_dir=True)
 
389
        self.assertTransportMode(t, 'dir770', 0770)
 
390
        t.put_bytes_non_atomic('dir777/mode664', 'test text\n', mode=0664,
 
391
                               dir_mode=0777, create_parent_dir=True)
 
392
        self.assertTransportMode(t, 'dir777', 0777)
 
393
 
 
394
    def test_put_file(self):
 
395
        t = self.get_transport()
 
396
 
 
397
        if t.is_readonly():
 
398
            self.assertRaises(TransportNotPossible,
 
399
                    t.put_file, 'a', StringIO('some text for a\n'))
 
400
            return
 
401
 
 
402
        result = t.put_file('a', StringIO('some text for a\n'))
 
403
        # put_file returns the length of the data written
 
404
        self.assertEqual(16, result)
 
405
        self.failUnless(t.has('a'))
 
406
        self.check_transport_contents('some text for a\n', t, 'a')
 
407
        # Put also replaces contents
 
408
        result = t.put_file('a', StringIO('new\ncontents for\na\n'))
 
409
        self.assertEqual(19, result)
 
410
        self.check_transport_contents('new\ncontents for\na\n', t, 'a')
 
411
        self.assertRaises(NoSuchFile,
 
412
                          t.put_file, 'path/doesnt/exist/c',
 
413
                              StringIO('contents'))
 
414
 
 
415
    def test_put_file_non_atomic(self):
 
416
        t = self.get_transport()
 
417
 
 
418
        if t.is_readonly():
 
419
            self.assertRaises(TransportNotPossible,
 
420
                    t.put_file_non_atomic, 'a', StringIO('some text for a\n'))
 
421
            return
 
422
 
 
423
        self.failIf(t.has('a'))
 
424
        t.put_file_non_atomic('a', StringIO('some text for a\n'))
 
425
        self.failUnless(t.has('a'))
 
426
        self.check_transport_contents('some text for a\n', t, 'a')
 
427
        # Put also replaces contents
 
428
        t.put_file_non_atomic('a', StringIO('new\ncontents for\na\n'))
 
429
        self.check_transport_contents('new\ncontents for\na\n', t, 'a')
 
430
 
 
431
        # Make sure we can create another file
 
432
        t.put_file_non_atomic('d', StringIO('contents for\nd\n'))
 
433
        # And overwrite 'a' with empty contents
 
434
        t.put_file_non_atomic('a', StringIO(''))
 
435
        self.check_transport_contents('contents for\nd\n', t, 'd')
 
436
        self.check_transport_contents('', t, 'a')
 
437
 
 
438
        self.assertRaises(NoSuchFile, t.put_file_non_atomic, 'no/such/path',
 
439
                                       StringIO('contents\n'))
 
440
        # Now test the create_parent flag
 
441
        self.assertRaises(NoSuchFile, t.put_file_non_atomic, 'dir/a',
 
442
                                       StringIO('contents\n'))
 
443
        self.failIf(t.has('dir/a'))
 
444
        t.put_file_non_atomic('dir/a', StringIO('contents for dir/a\n'),
 
445
                              create_parent_dir=True)
 
446
        self.check_transport_contents('contents for dir/a\n', t, 'dir/a')
 
447
 
 
448
        # But we still get NoSuchFile if we can't make the parent dir
 
449
        self.assertRaises(NoSuchFile, t.put_file_non_atomic, 'not/there/a',
 
450
                                       StringIO('contents\n'),
 
451
                                       create_parent_dir=True)
 
452
 
 
453
    def test_put_file_permissions(self):
 
454
 
 
455
        t = self.get_transport()
 
456
 
 
457
        if t.is_readonly():
 
458
            return
 
459
        if not t._can_roundtrip_unix_modebits():
 
460
            # Can't roundtrip, so no need to run this test
 
461
            return
 
462
        t.put_file('mode644', StringIO('test text\n'), mode=0644)
 
463
        self.assertTransportMode(t, 'mode644', 0644)
 
464
        t.put_file('mode666', StringIO('test text\n'), mode=0666)
 
465
        self.assertTransportMode(t, 'mode666', 0666)
 
466
        t.put_file('mode600', StringIO('test text\n'), mode=0600)
160
467
        self.assertTransportMode(t, 'mode600', 0600)
161
468
        # Yes, you can put a file such that it becomes readonly
162
 
        t.put('mode400', StringIO('test text\n'), mode=0400)
163
 
        self.assertTransportMode(t, 'mode400', 0400)
164
 
        t.put_multi([('mmode644', StringIO('text\n'))], mode=0644)
165
 
        self.assertTransportMode(t, 'mmode644', 0644)
166
 
 
167
 
        # The default permissions should be based on the current umask
168
 
        umask = osutils.get_umask()
169
 
        t.put('nomode', StringIO('test text\n'), mode=None)
170
 
        self.assertTransportMode(t, 'nomode', 0666 & ~umask)
171
 
        
 
469
        t.put_file('mode400', StringIO('test text\n'), mode=0400)
 
470
        self.assertTransportMode(t, 'mode400', 0400)
 
471
        # The default permissions should be based on the current umask
 
472
        umask = osutils.get_umask()
 
473
        t.put_file('nomode', StringIO('test text\n'), mode=None)
 
474
        self.assertTransportMode(t, 'nomode', 0666 & ~umask)
 
475
 
 
476
    def test_put_file_non_atomic_permissions(self):
 
477
        t = self.get_transport()
 
478
 
 
479
        if t.is_readonly():
 
480
            return
 
481
        if not t._can_roundtrip_unix_modebits():
 
482
            # Can't roundtrip, so no need to run this test
 
483
            return
 
484
        t.put_file_non_atomic('mode644', StringIO('test text\n'), mode=0644)
 
485
        self.assertTransportMode(t, 'mode644', 0644)
 
486
        t.put_file_non_atomic('mode666', StringIO('test text\n'), mode=0666)
 
487
        self.assertTransportMode(t, 'mode666', 0666)
 
488
        t.put_file_non_atomic('mode600', StringIO('test text\n'), mode=0600)
 
489
        self.assertTransportMode(t, 'mode600', 0600)
 
490
        # Yes, you can put_file_non_atomic a file such that it becomes readonly
 
491
        t.put_file_non_atomic('mode400', StringIO('test text\n'), mode=0400)
 
492
        self.assertTransportMode(t, 'mode400', 0400)
 
493
 
 
494
        # The default permissions should be based on the current umask
 
495
        umask = osutils.get_umask()
 
496
        t.put_file_non_atomic('nomode', StringIO('test text\n'), mode=None)
 
497
        self.assertTransportMode(t, 'nomode', 0666 & ~umask)
 
498
 
 
499
        # We should also be able to set the mode for a parent directory
 
500
        # when it is created
 
501
        sio = StringIO()
 
502
        t.put_file_non_atomic('dir700/mode664', sio, mode=0664,
 
503
                              dir_mode=0700, create_parent_dir=True)
 
504
        self.assertTransportMode(t, 'dir700', 0700)
 
505
        t.put_file_non_atomic('dir770/mode664', sio, mode=0664,
 
506
                              dir_mode=0770, create_parent_dir=True)
 
507
        self.assertTransportMode(t, 'dir770', 0770)
 
508
        t.put_file_non_atomic('dir777/mode664', sio, mode=0664,
 
509
                              dir_mode=0777, create_parent_dir=True)
 
510
        self.assertTransportMode(t, 'dir777', 0777)
 
511
 
 
512
    def test_put_bytes_unicode(self):
 
513
        # Expect put_bytes to raise AssertionError or UnicodeEncodeError if
 
514
        # given unicode "bytes".  UnicodeEncodeError doesn't really make sense
 
515
        # (we don't want to encode unicode here at all, callers should be
 
516
        # strictly passing bytes to put_bytes), but we allow it for backwards
 
517
        # compatibility.  At some point we should use a specific exception.
 
518
        # See https://bugs.launchpad.net/bzr/+bug/106898.
 
519
        t = self.get_transport()
 
520
        if t.is_readonly():
 
521
            return
 
522
        unicode_string = u'\u1234'
 
523
        self.assertRaises(
 
524
            (AssertionError, UnicodeEncodeError),
 
525
            t.put_bytes, 'foo', unicode_string)
 
526
 
 
527
    def test_put_file_unicode(self):
 
528
        # Like put_bytes, except with a StringIO.StringIO of a unicode string.
 
529
        # This situation can happen (and has) if code is careless about the type
 
530
        # of "string" they initialise/write to a StringIO with.  We cannot use
 
531
        # cStringIO, because it never returns unicode from read.
 
532
        # Like put_bytes, UnicodeEncodeError isn't quite the right exception to
 
533
        # raise, but we raise it for hysterical raisins.
 
534
        t = self.get_transport()
 
535
        if t.is_readonly():
 
536
            return
 
537
        unicode_file = pyStringIO(u'\u1234')
 
538
        self.assertRaises(UnicodeEncodeError, t.put_file, 'foo', unicode_file)
 
539
 
172
540
    def test_mkdir(self):
173
541
        t = self.get_transport()
174
542
 
175
543
        if t.is_readonly():
176
 
            # cannot mkdir on readonly transports. We're not testing for 
 
544
            # cannot mkdir on readonly transports. We're not testing for
177
545
            # cache coherency because cache behaviour is not currently
178
546
            # defined for the transport interface.
179
547
            self.assertRaises(TransportNotPossible, t.mkdir, '.')
200
568
 
201
569
        # we were testing that a local mkdir followed by a transport
202
570
        # mkdir failed thusly, but given that we * in one process * do not
203
 
        # concurrently fiddle with disk dirs and then use transport to do 
 
571
        # concurrently fiddle with disk dirs and then use transport to do
204
572
        # things, the win here seems marginal compared to the constraint on
205
573
        # the interface. RBC 20051227
206
574
        t.mkdir('dir_g')
207
575
        self.assertRaises(FileExists, t.mkdir, 'dir_g')
208
576
 
209
577
        # Test get/put in sub-directories
210
 
        self.assertEqual(2, 
211
 
            t.put_multi([('dir_a/a', StringIO('contents of dir_a/a')),
212
 
                         ('dir_b/b', StringIO('contents of dir_b/b'))]))
 
578
        t.put_bytes('dir_a/a', 'contents of dir_a/a')
 
579
        t.put_file('dir_b/b', StringIO('contents of dir_b/b'))
213
580
        self.check_transport_contents('contents of dir_a/a', t, 'dir_a/a')
214
581
        self.check_transport_contents('contents of dir_b/b', t, 'dir_b/b')
215
582
 
240
607
        t.mkdir('dnomode', mode=None)
241
608
        self.assertTransportMode(t, 'dnomode', 0777 & ~umask)
242
609
 
 
610
    def test_opening_a_file_stream_creates_file(self):
 
611
        t = self.get_transport()
 
612
        if t.is_readonly():
 
613
            return
 
614
        handle = t.open_write_stream('foo')
 
615
        try:
 
616
            self.assertEqual('', t.get_bytes('foo'))
 
617
        finally:
 
618
            handle.close()
 
619
 
 
620
    def test_opening_a_file_stream_can_set_mode(self):
 
621
        t = self.get_transport()
 
622
        if t.is_readonly():
 
623
            return
 
624
        if not t._can_roundtrip_unix_modebits():
 
625
            # Can't roundtrip, so no need to run this test
 
626
            return
 
627
        def check_mode(name, mode, expected):
 
628
            handle = t.open_write_stream(name, mode=mode)
 
629
            handle.close()
 
630
            self.assertTransportMode(t, name, expected)
 
631
        check_mode('mode644', 0644, 0644)
 
632
        check_mode('mode666', 0666, 0666)
 
633
        check_mode('mode600', 0600, 0600)
 
634
        # The default permissions should be based on the current umask
 
635
        check_mode('nomode', None, 0666 & ~osutils.get_umask())
 
636
 
243
637
    def test_copy_to(self):
244
638
        # FIXME: test:   same server to same server (partly done)
245
639
        # same protocol two servers
246
640
        # and    different protocols (done for now except for MemoryTransport.
247
641
        # - RBC 20060122
248
 
        from bzrlib.transport.memory import MemoryTransport
249
642
 
250
643
        def simple_copy_files(transport_from, transport_to):
251
644
            files = ['a', 'b', 'c', 'd']
270
663
            self.build_tree(['e/', 'e/f'])
271
664
        else:
272
665
            t.mkdir('e')
273
 
            t.put('e/f', StringIO('contents of e'))
 
666
            t.put_bytes('e/f', 'contents of e')
274
667
        self.assertRaises(NoSuchFile, t.copy_to, ['e/f'], temp_transport)
275
668
        temp_transport.mkdir('e')
276
669
        t.copy_to(['e/f'], temp_transport)
291
684
            for f in files:
292
685
                self.assertTransportMode(temp_transport, f, mode)
293
686
 
294
 
    def test_append(self):
295
 
        t = self.get_transport()
296
 
 
297
 
        if t.is_readonly():
298
 
            open('a', 'wb').write('diff\ncontents for\na\n')
299
 
            open('b', 'wb').write('contents\nfor b\n')
300
 
        else:
301
 
            t.put_multi([
302
 
                    ('a', StringIO('diff\ncontents for\na\n')),
303
 
                    ('b', StringIO('contents\nfor b\n'))
304
 
                    ])
305
 
 
306
 
        if t.is_readonly():
307
 
            self.assertRaises(TransportNotPossible,
308
 
                    t.append, 'a', 'add\nsome\nmore\ncontents\n')
309
 
            _append('a', StringIO('add\nsome\nmore\ncontents\n'))
310
 
        else:
311
 
            self.assertEqual(20,
312
 
                t.append('a', StringIO('add\nsome\nmore\ncontents\n')))
313
 
 
314
 
        self.check_transport_contents(
315
 
            'diff\ncontents for\na\nadd\nsome\nmore\ncontents\n',
316
 
            t, 'a')
317
 
 
318
 
        if t.is_readonly():
319
 
            self.assertRaises(TransportNotPossible,
320
 
                    t.append_multi,
321
 
                        [('a', 'and\nthen\nsome\nmore\n'),
322
 
                         ('b', 'some\nmore\nfor\nb\n')])
323
 
            _append('a', StringIO('and\nthen\nsome\nmore\n'))
324
 
            _append('b', StringIO('some\nmore\nfor\nb\n'))
325
 
        else:
326
 
            self.assertEqual((43, 15), 
327
 
                t.append_multi([('a', StringIO('and\nthen\nsome\nmore\n')),
328
 
                                ('b', StringIO('some\nmore\nfor\nb\n'))]))
 
687
    def test_create_prefix(self):
 
688
        t = self.get_transport()
 
689
        sub = t.clone('foo').clone('bar')
 
690
        try:
 
691
            sub.create_prefix()
 
692
        except TransportNotPossible:
 
693
            self.assertTrue(t.is_readonly())
 
694
        else:
 
695
            self.assertTrue(t.has('foo/bar'))
 
696
 
 
697
    def test_append_file(self):
 
698
        t = self.get_transport()
 
699
 
 
700
        if t.is_readonly():
 
701
            self.assertRaises(TransportNotPossible,
 
702
                    t.append_file, 'a', 'add\nsome\nmore\ncontents\n')
 
703
            return
 
704
        t.put_bytes('a', 'diff\ncontents for\na\n')
 
705
        t.put_bytes('b', 'contents\nfor b\n')
 
706
 
 
707
        self.assertEqual(20,
 
708
            t.append_file('a', StringIO('add\nsome\nmore\ncontents\n')))
 
709
 
 
710
        self.check_transport_contents(
 
711
            'diff\ncontents for\na\nadd\nsome\nmore\ncontents\n',
 
712
            t, 'a')
 
713
 
 
714
        # a file with no parent should fail..
 
715
        self.assertRaises(NoSuchFile,
 
716
                          t.append_file, 'missing/path', StringIO('content'))
 
717
 
 
718
        # And we can create new files, too
 
719
        self.assertEqual(0,
 
720
            t.append_file('c', StringIO('some text\nfor a missing file\n')))
 
721
        self.check_transport_contents('some text\nfor a missing file\n',
 
722
                                      t, 'c')
 
723
 
 
724
    def test_append_bytes(self):
 
725
        t = self.get_transport()
 
726
 
 
727
        if t.is_readonly():
 
728
            self.assertRaises(TransportNotPossible,
 
729
                    t.append_bytes, 'a', 'add\nsome\nmore\ncontents\n')
 
730
            return
 
731
 
 
732
        self.assertEqual(0, t.append_bytes('a', 'diff\ncontents for\na\n'))
 
733
        self.assertEqual(0, t.append_bytes('b', 'contents\nfor b\n'))
 
734
 
 
735
        self.assertEqual(20,
 
736
            t.append_bytes('a', 'add\nsome\nmore\ncontents\n'))
 
737
 
 
738
        self.check_transport_contents(
 
739
            'diff\ncontents for\na\nadd\nsome\nmore\ncontents\n',
 
740
            t, 'a')
 
741
 
 
742
        # a file with no parent should fail..
 
743
        self.assertRaises(NoSuchFile,
 
744
                          t.append_bytes, 'missing/path', 'content')
 
745
 
 
746
    def test_append_multi(self):
 
747
        t = self.get_transport()
 
748
 
 
749
        if t.is_readonly():
 
750
            return
 
751
        t.put_bytes('a', 'diff\ncontents for\na\n'
 
752
                         'add\nsome\nmore\ncontents\n')
 
753
        t.put_bytes('b', 'contents\nfor b\n')
 
754
 
 
755
        self.assertEqual((43, 15),
 
756
            t.append_multi([('a', StringIO('and\nthen\nsome\nmore\n')),
 
757
                            ('b', StringIO('some\nmore\nfor\nb\n'))]))
 
758
 
329
759
        self.check_transport_contents(
330
760
            'diff\ncontents for\na\n'
331
761
            'add\nsome\nmore\ncontents\n'
336
766
                'some\nmore\nfor\nb\n',
337
767
                t, 'b')
338
768
 
339
 
        if t.is_readonly():
340
 
            _append('a', StringIO('a little bit more\n'))
341
 
            _append('b', StringIO('from an iterator\n'))
342
 
        else:
343
 
            self.assertEqual((62, 31),
344
 
                t.append_multi(iter([('a', StringIO('a little bit more\n')),
345
 
                                     ('b', StringIO('from an iterator\n'))])))
 
769
        self.assertEqual((62, 31),
 
770
            t.append_multi(iter([('a', StringIO('a little bit more\n')),
 
771
                                 ('b', StringIO('from an iterator\n'))])))
346
772
        self.check_transport_contents(
347
773
            'diff\ncontents for\na\n'
348
774
            'add\nsome\nmore\ncontents\n'
355
781
                'from an iterator\n',
356
782
                t, 'b')
357
783
 
358
 
        if t.is_readonly():
359
 
            _append('c', StringIO('some text\nfor a missing file\n'))
360
 
            _append('a', StringIO('some text in a\n'))
361
 
            _append('d', StringIO('missing file r\n'))
362
 
        else:
363
 
            self.assertEqual(0,
364
 
                t.append('c', StringIO('some text\nfor a missing file\n')))
365
 
            self.assertEqual((80, 0),
366
 
                t.append_multi([('a', StringIO('some text in a\n')),
367
 
                                ('d', StringIO('missing file r\n'))]))
 
784
        self.assertEqual((80, 0),
 
785
            t.append_multi([('a', StringIO('some text in a\n')),
 
786
                            ('d', StringIO('missing file r\n'))]))
 
787
 
368
788
        self.check_transport_contents(
369
789
            'diff\ncontents for\na\n'
370
790
            'add\nsome\nmore\ncontents\n'
372
792
            'a little bit more\n'
373
793
            'some text in a\n',
374
794
            t, 'a')
375
 
        self.check_transport_contents('some text\nfor a missing file\n',
376
 
                                      t, 'c')
377
795
        self.check_transport_contents('missing file r\n', t, 'd')
378
 
        
379
 
        # a file with no parent should fail..
380
 
        if not t.is_readonly():
381
 
            self.assertRaises(NoSuchFile,
382
 
                              t.append, 'missing/path', 
383
 
                              StringIO('content'))
384
 
 
385
 
    def test_append_file(self):
386
 
        t = self.get_transport()
387
 
 
388
 
        contents = [
389
 
            ('f1', StringIO('this is a string\nand some more stuff\n')),
390
 
            ('f2', StringIO('here is some text\nand a bit more\n')),
391
 
            ('f3', StringIO('some text for the\nthird file created\n')),
392
 
            ('f4', StringIO('this is a string\nand some more stuff\n')),
393
 
            ('f5', StringIO('here is some text\nand a bit more\n')),
394
 
            ('f6', StringIO('some text for the\nthird file created\n'))
395
 
        ]
396
 
        
397
 
        if t.is_readonly():
398
 
            for f, val in contents:
399
 
                open(f, 'wb').write(val.read())
400
 
        else:
401
 
            t.put_multi(contents)
402
 
 
403
 
        a1 = StringIO('appending to\none\n')
404
 
        if t.is_readonly():
405
 
            _append('f1', a1)
406
 
        else:
407
 
            t.append('f1', a1)
408
 
 
409
 
        del a1
410
 
 
411
 
        self.check_transport_contents(
412
 
                'this is a string\nand some more stuff\n'
413
 
                'appending to\none\n',
414
 
                t, 'f1')
415
 
 
416
 
        a2 = StringIO('adding more\ntext to two\n')
417
 
        a3 = StringIO('some garbage\nto put in three\n')
418
 
 
419
 
        if t.is_readonly():
420
 
            _append('f2', a2)
421
 
            _append('f3', a3)
422
 
        else:
423
 
            t.append_multi([('f2', a2), ('f3', a3)])
424
 
 
425
 
        del a2, a3
426
 
 
427
 
        self.check_transport_contents(
428
 
                'here is some text\nand a bit more\n'
429
 
                'adding more\ntext to two\n',
430
 
                t, 'f2')
431
 
        self.check_transport_contents( 
432
 
                'some text for the\nthird file created\n'
433
 
                'some garbage\nto put in three\n',
434
 
                t, 'f3')
435
 
 
436
 
        # Test that an actual file object can be used with put
437
 
        a4 = t.get('f1')
438
 
        if t.is_readonly():
439
 
            _append('f4', a4)
440
 
        else:
441
 
            t.append('f4', a4)
442
 
 
443
 
        del a4
444
 
 
445
 
        self.check_transport_contents(
446
 
                'this is a string\nand some more stuff\n'
447
 
                'this is a string\nand some more stuff\n'
448
 
                'appending to\none\n',
449
 
                t, 'f4')
450
 
 
451
 
        a5 = t.get('f2')
452
 
        a6 = t.get('f3')
453
 
        if t.is_readonly():
454
 
            _append('f5', a5)
455
 
            _append('f6', a6)
456
 
        else:
457
 
            t.append_multi([('f5', a5), ('f6', a6)])
458
 
 
459
 
        del a5, a6
460
 
 
461
 
        self.check_transport_contents(
462
 
                'here is some text\nand a bit more\n'
463
 
                'here is some text\nand a bit more\n'
464
 
                'adding more\ntext to two\n',
465
 
                t, 'f5')
466
 
        self.check_transport_contents(
467
 
                'some text for the\nthird file created\n'
468
 
                'some text for the\nthird file created\n'
469
 
                'some garbage\nto put in three\n',
470
 
                t, 'f6')
471
 
 
472
 
        a5 = t.get('f2')
473
 
        a6 = t.get('f2')
474
 
        a7 = t.get('f3')
475
 
        if t.is_readonly():
476
 
            _append('c', a5)
477
 
            _append('a', a6)
478
 
            _append('d', a7)
479
 
        else:
480
 
            t.append('c', a5)
481
 
            t.append_multi([('a', a6), ('d', a7)])
482
 
        del a5, a6, a7
483
 
        self.check_transport_contents(t.get('f2').read(), t, 'c')
484
 
        self.check_transport_contents(t.get('f3').read(), t, 'd')
485
 
 
486
 
    def test_append_mode(self):
 
796
 
 
797
    def test_append_file_mode(self):
 
798
        """Check that append accepts a mode parameter"""
487
799
        # check append accepts a mode
488
800
        t = self.get_transport()
489
801
        if t.is_readonly():
490
 
            return
491
 
        t.append('f', StringIO('f'), mode=None)
492
 
        
 
802
            self.assertRaises(TransportNotPossible,
 
803
                t.append_file, 'f', StringIO('f'), mode=None)
 
804
            return
 
805
        t.append_file('f', StringIO('f'), mode=None)
 
806
 
 
807
    def test_append_bytes_mode(self):
 
808
        # check append_bytes accepts a mode
 
809
        t = self.get_transport()
 
810
        if t.is_readonly():
 
811
            self.assertRaises(TransportNotPossible,
 
812
                t.append_bytes, 'f', 'f', mode=None)
 
813
            return
 
814
        t.append_bytes('f', 'f', mode=None)
 
815
 
493
816
    def test_delete(self):
494
817
        # TODO: Test Transport.delete
495
818
        t = self.get_transport()
499
822
            self.assertRaises(TransportNotPossible, t.delete, 'missing')
500
823
            return
501
824
 
502
 
        t.put('a', StringIO('a little bit of text\n'))
 
825
        t.put_bytes('a', 'a little bit of text\n')
503
826
        self.failUnless(t.has('a'))
504
827
        t.delete('a')
505
828
        self.failIf(t.has('a'))
506
829
 
507
830
        self.assertRaises(NoSuchFile, t.delete, 'a')
508
831
 
509
 
        t.put('a', StringIO('a text\n'))
510
 
        t.put('b', StringIO('b text\n'))
511
 
        t.put('c', StringIO('c text\n'))
 
832
        t.put_bytes('a', 'a text\n')
 
833
        t.put_bytes('b', 'b text\n')
 
834
        t.put_bytes('c', 'c text\n')
512
835
        self.assertEqual([True, True, True],
513
836
                list(t.has_multi(['a', 'b', 'c'])))
514
837
        t.delete_multi(['a', 'c'])
524
847
        self.assertRaises(NoSuchFile,
525
848
                t.delete_multi, iter(['a', 'b', 'c']))
526
849
 
527
 
        t.put('a', StringIO('another a text\n'))
528
 
        t.put('c', StringIO('another c text\n'))
 
850
        t.put_bytes('a', 'another a text\n')
 
851
        t.put_bytes('c', 'another c text\n')
529
852
        t.delete_multi(iter(['a', 'b', 'c']))
530
853
 
531
854
        # We should have deleted everything
534
857
        # plain "listdir".
535
858
        # self.assertEqual([], os.listdir('.'))
536
859
 
 
860
    def test_recommended_page_size(self):
 
861
        """Transports recommend a page size for partial access to files."""
 
862
        t = self.get_transport()
 
863
        self.assertIsInstance(t.recommended_page_size(), int)
 
864
 
537
865
    def test_rmdir(self):
538
866
        t = self.get_transport()
539
867
        # Not much to do with a readonly transport
543
871
        t.mkdir('adir')
544
872
        t.mkdir('adir/bdir')
545
873
        t.rmdir('adir/bdir')
546
 
        self.assertRaises(NoSuchFile, t.stat, 'adir/bdir')
 
874
        # ftp may not be able to raise NoSuchFile for lack of
 
875
        # details when failing
 
876
        self.assertRaises((NoSuchFile, PathError), t.rmdir, 'adir/bdir')
547
877
        t.rmdir('adir')
548
 
        self.assertRaises(NoSuchFile, t.stat, 'adir')
 
878
        self.assertRaises((NoSuchFile, PathError), t.rmdir, 'adir')
549
879
 
550
880
    def test_rmdir_not_empty(self):
551
881
        """Deleting a non-empty directory raises an exception
552
 
        
 
882
 
553
883
        sftp (and possibly others) don't give us a specific "directory not
554
884
        empty" exception -- we can just see that the operation failed.
555
885
        """
560
890
        t.mkdir('adir/bdir')
561
891
        self.assertRaises(PathError, t.rmdir, 'adir')
562
892
 
 
893
    def test_rmdir_empty_but_similar_prefix(self):
 
894
        """rmdir does not get confused by sibling paths.
 
895
 
 
896
        A naive implementation of MemoryTransport would refuse to rmdir
 
897
        ".bzr/branch" if there is a ".bzr/branch-format" directory, because it
 
898
        uses "path.startswith(dir)" on all file paths to determine if directory
 
899
        is empty.
 
900
        """
 
901
        t = self.get_transport()
 
902
        if t.is_readonly():
 
903
            return
 
904
        t.mkdir('foo')
 
905
        t.put_bytes('foo-bar', '')
 
906
        t.mkdir('foo-baz')
 
907
        t.rmdir('foo')
 
908
        self.assertRaises((NoSuchFile, PathError), t.rmdir, 'foo')
 
909
        self.failUnless(t.has('foo-bar'))
 
910
 
563
911
    def test_rename_dir_succeeds(self):
564
912
        t = self.get_transport()
565
913
        if t.is_readonly():
579
927
        t.mkdir('adir/asubdir')
580
928
        t.mkdir('bdir')
581
929
        t.mkdir('bdir/bsubdir')
 
930
        # any kind of PathError would be OK, though we normally expect
 
931
        # DirectoryNotEmpty
582
932
        self.assertRaises(PathError, t.rename, 'bdir', 'adir')
583
933
        # nothing was changed so it should still be as before
584
934
        self.assertTrue(t.has('bdir/bsubdir'))
585
935
        self.assertFalse(t.has('adir/bdir'))
586
936
        self.assertFalse(t.has('adir/bsubdir'))
587
937
 
 
938
    def test_rename_across_subdirs(self):
 
939
        t = self.get_transport()
 
940
        if t.is_readonly():
 
941
            raise TestNotApplicable("transport is readonly")
 
942
        t.mkdir('a')
 
943
        t.mkdir('b')
 
944
        ta = t.clone('a')
 
945
        tb = t.clone('b')
 
946
        ta.put_bytes('f', 'aoeu')
 
947
        ta.rename('f', '../b/f')
 
948
        self.assertTrue(tb.has('f'))
 
949
        self.assertFalse(ta.has('f'))
 
950
        self.assertTrue(t.has('b/f'))
 
951
 
588
952
    def test_delete_tree(self):
589
953
        t = self.get_transport()
590
954
 
600
964
        except TransportNotPossible:
601
965
            # ok, this transport does not support delete_tree
602
966
            return
603
 
        
 
967
 
604
968
        # did it delete that trivial case?
605
969
        self.assertRaises(NoSuchFile, t.stat, 'adir')
606
970
 
607
971
        self.build_tree(['adir/',
608
 
                         'adir/file', 
609
 
                         'adir/subdir/', 
610
 
                         'adir/subdir/file', 
 
972
                         'adir/file',
 
973
                         'adir/subdir/',
 
974
                         'adir/subdir/file',
611
975
                         'adir/subdir2/',
612
976
                         'adir/subdir2/file',
613
977
                         ], transport=t)
627
991
        # creates control files in the working directory
628
992
        # perhaps all of this could be done in a subdirectory
629
993
 
630
 
        t.put('a', StringIO('a first file\n'))
 
994
        t.put_bytes('a', 'a first file\n')
631
995
        self.assertEquals([True, False], list(t.has_multi(['a', 'b'])))
632
996
 
633
997
        t.move('a', 'b')
638
1002
        self.assertEquals([False, True], list(t.has_multi(['a', 'b'])))
639
1003
 
640
1004
        # Overwrite a file
641
 
        t.put('c', StringIO('c this file\n'))
 
1005
        t.put_bytes('c', 'c this file\n')
642
1006
        t.move('c', 'b')
643
1007
        self.failIf(t.has('c'))
644
1008
        self.check_transport_contents('c this file\n', t, 'b')
645
1009
 
646
1010
        # TODO: Try to write a test for atomicity
647
 
        # TODO: Test moving into a non-existant subdirectory
 
1011
        # TODO: Test moving into a non-existent subdirectory
648
1012
        # TODO: Test Transport.move_multi
649
1013
 
650
1014
    def test_copy(self):
653
1017
        if t.is_readonly():
654
1018
            return
655
1019
 
656
 
        t.put('a', StringIO('a file\n'))
 
1020
        t.put_bytes('a', 'a file\n')
657
1021
        t.copy('a', 'b')
658
1022
        self.check_transport_contents('a file\n', t, 'b')
659
1023
 
662
1026
        # What should the assert be if you try to copy a
663
1027
        # file over a directory?
664
1028
        #self.assertRaises(Something, t.copy, 'a', 'c')
665
 
        t.put('d', StringIO('text in d\n'))
 
1029
        t.put_bytes('d', 'text in d\n')
666
1030
        t.copy('d', 'b')
667
1031
        self.check_transport_contents('text in d\n', t, 'b')
668
1032
 
669
1033
        # TODO: test copy_multi
670
1034
 
671
1035
    def test_connection_error(self):
672
 
        """ConnectionError is raised when connection is impossible"""
 
1036
        """ConnectionError is raised when connection is impossible.
 
1037
 
 
1038
        The error should be raised from the first operation on the transport.
 
1039
        """
673
1040
        try:
674
1041
            url = self._server.get_bogus_url()
675
1042
        except NotImplementedError:
676
1043
            raise TestSkipped("Transport %s has no bogus URL support." %
677
1044
                              self._server.__class__)
678
 
        try:
679
 
            t = bzrlib.transport.get_transport(url)
680
 
            t.get('.bzr/branch')
681
 
        except (ConnectionError, NoSuchFile), e:
682
 
            pass
683
 
        except (Exception), e:
684
 
            self.fail('Wrong exception thrown (%s.%s): %s' 
685
 
                        % (e.__class__.__module__, e.__class__.__name__, e))
686
 
        else:
687
 
            self.fail('Did not get the expected ConnectionError or NoSuchFile.')
 
1045
        t = get_transport(url)
 
1046
        self.assertRaises((ConnectionError, NoSuchFile), t.get, '.bzr/branch')
688
1047
 
689
1048
    def test_stat(self):
690
1049
        # TODO: Test stat, just try once, and if it throws, stop testing
699
1058
            return
700
1059
 
701
1060
        paths = ['a', 'b/', 'b/c', 'b/d/', 'b/d/e']
702
 
        sizes = [14, 0, 16, 0, 18] 
 
1061
        sizes = [14, 0, 16, 0, 18]
703
1062
        self.build_tree(paths, transport=t, line_endings='binary')
704
1063
 
705
1064
        for path, size in zip(paths, sizes):
727
1086
    def test_list_dir(self):
728
1087
        # TODO: Test list_dir, just try once, and if it throws, stop testing
729
1088
        t = self.get_transport()
730
 
        
 
1089
 
731
1090
        if not t.listable():
732
1091
            self.assertRaises(TransportNotPossible, t.list_dir, '.')
733
1092
            return
734
1093
 
735
 
        def sorted_list(d):
736
 
            l = list(t.list_dir(d))
 
1094
        def sorted_list(d, transport):
 
1095
            l = list(transport.list_dir(d))
737
1096
            l.sort()
738
1097
            return l
739
1098
 
740
 
        # SftpServer creates control files in the working directory
741
 
        # so lets move down a directory to avoid those.
742
 
        if not t.is_readonly():
743
 
            t.mkdir('wd')
744
 
        else:
745
 
            os.mkdir('wd')
746
 
        t = t.clone('wd')
747
 
 
748
 
        self.assertEqual([], sorted_list(u'.'))
 
1099
        self.assertEqual([], sorted_list('.', t))
749
1100
        # c2 is precisely one letter longer than c here to test that
750
1101
        # suffixing is not confused.
 
1102
        # a%25b checks that quoting is done consistently across transports
 
1103
        tree_names = ['a', 'a%25b', 'b', 'c/', 'c/d', 'c/e', 'c2/']
 
1104
 
751
1105
        if not t.is_readonly():
752
 
            self.build_tree(['a', 'b', 'c/', 'c/d', 'c/e', 'c2/'], transport=t)
 
1106
            self.build_tree(tree_names, transport=t)
753
1107
        else:
754
 
            self.build_tree(['wd/a', 'wd/b', 'wd/c/', 'wd/c/d', 'wd/c/e', 'wd/c2/'])
755
 
 
756
 
        self.assertEqual([u'a', u'b', u'c', u'c2'], sorted_list(u'.'))
757
 
        self.assertEqual([u'd', u'e'], sorted_list(u'c'))
 
1108
            self.build_tree(tree_names)
 
1109
 
 
1110
        self.assertEqual(
 
1111
            ['a', 'a%2525b', 'b', 'c', 'c2'], sorted_list('', t))
 
1112
        self.assertEqual(
 
1113
            ['a', 'a%2525b', 'b', 'c', 'c2'], sorted_list('.', t))
 
1114
        self.assertEqual(['d', 'e'], sorted_list('c', t))
 
1115
 
 
1116
        # Cloning the transport produces an equivalent listing
 
1117
        self.assertEqual(['d', 'e'], sorted_list('', t.clone('c')))
758
1118
 
759
1119
        if not t.is_readonly():
760
1120
            t.delete('c/d')
761
1121
            t.delete('b')
762
1122
        else:
763
 
            os.unlink('wd/c/d')
764
 
            os.unlink('wd/b')
765
 
            
766
 
        self.assertEqual([u'a', u'c', u'c2'], sorted_list('.'))
767
 
        self.assertEqual([u'e'], sorted_list(u'c'))
 
1123
            os.unlink('c/d')
 
1124
            os.unlink('b')
 
1125
 
 
1126
        self.assertEqual(['a', 'a%2525b', 'c', 'c2'], sorted_list('.', t))
 
1127
        self.assertEqual(['e'], sorted_list('c', t))
768
1128
 
769
1129
        self.assertListRaises(PathError, t.list_dir, 'q')
770
1130
        self.assertListRaises(PathError, t.list_dir, 'c/f')
 
1131
        # 'a' is a file, list_dir should raise an error
771
1132
        self.assertListRaises(PathError, t.list_dir, 'a')
772
1133
 
 
1134
    def test_list_dir_result_is_url_escaped(self):
 
1135
        t = self.get_transport()
 
1136
        if not t.listable():
 
1137
            raise TestSkipped("transport not listable")
 
1138
 
 
1139
        if not t.is_readonly():
 
1140
            self.build_tree(['a/', 'a/%'], transport=t)
 
1141
        else:
 
1142
            self.build_tree(['a/', 'a/%'])
 
1143
 
 
1144
        names = list(t.list_dir('a'))
 
1145
        self.assertEqual(['%25'], names)
 
1146
        self.assertIsInstance(names[0], str)
 
1147
 
 
1148
    def test_clone_preserve_info(self):
 
1149
        t1 = self.get_transport()
 
1150
        if not isinstance(t1, ConnectedTransport):
 
1151
            raise TestSkipped("not a connected transport")
 
1152
 
 
1153
        t2 = t1.clone('subdir')
 
1154
        self.assertEquals(t1._scheme, t2._scheme)
 
1155
        self.assertEquals(t1._user, t2._user)
 
1156
        self.assertEquals(t1._password, t2._password)
 
1157
        self.assertEquals(t1._host, t2._host)
 
1158
        self.assertEquals(t1._port, t2._port)
 
1159
 
 
1160
    def test__reuse_for(self):
 
1161
        t = self.get_transport()
 
1162
        if not isinstance(t, ConnectedTransport):
 
1163
            raise TestSkipped("not a connected transport")
 
1164
 
 
1165
        def new_url(scheme=None, user=None, password=None,
 
1166
                    host=None, port=None, path=None):
 
1167
            """Build a new url from t.base changing only parts of it.
 
1168
 
 
1169
            Only the parameters different from None will be changed.
 
1170
            """
 
1171
            if scheme   is None: scheme   = t._scheme
 
1172
            if user     is None: user     = t._user
 
1173
            if password is None: password = t._password
 
1174
            if user     is None: user     = t._user
 
1175
            if host     is None: host     = t._host
 
1176
            if port     is None: port     = t._port
 
1177
            if path     is None: path     = t._path
 
1178
            return t._unsplit_url(scheme, user, password, host, port, path)
 
1179
 
 
1180
        if t._scheme == 'ftp':
 
1181
            scheme = 'sftp'
 
1182
        else:
 
1183
            scheme = 'ftp'
 
1184
        self.assertIsNot(t, t._reuse_for(new_url(scheme=scheme)))
 
1185
        if t._user == 'me':
 
1186
            user = 'you'
 
1187
        else:
 
1188
            user = 'me'
 
1189
        self.assertIsNot(t, t._reuse_for(new_url(user=user)))
 
1190
        # passwords are not taken into account because:
 
1191
        # - it makes no sense to have two different valid passwords for the
 
1192
        #   same user
 
1193
        # - _password in ConnectedTransport is intended to collect what the
 
1194
        #   user specified from the command-line and there are cases where the
 
1195
        #   new url can contain no password (if the url was built from an
 
1196
        #   existing transport.base for example)
 
1197
        # - password are considered part of the credentials provided at
 
1198
        #   connection creation time and as such may not be present in the url
 
1199
        #   (they may be typed by the user when prompted for example)
 
1200
        self.assertIs(t, t._reuse_for(new_url(password='from space')))
 
1201
        # We will not connect, we can use a invalid host
 
1202
        self.assertIsNot(t, t._reuse_for(new_url(host=t._host + 'bar')))
 
1203
        if t._port == 1234:
 
1204
            port = 4321
 
1205
        else:
 
1206
            port = 1234
 
1207
        self.assertIsNot(t, t._reuse_for(new_url(port=port)))
 
1208
        # No point in trying to reuse a transport for a local URL
 
1209
        self.assertIs(None, t._reuse_for('/valid_but_not_existing'))
 
1210
 
 
1211
    def test_connection_sharing(self):
 
1212
        t = self.get_transport()
 
1213
        if not isinstance(t, ConnectedTransport):
 
1214
            raise TestSkipped("not a connected transport")
 
1215
 
 
1216
        c = t.clone('subdir')
 
1217
        # Some transports will create the connection  only when needed
 
1218
        t.has('surely_not') # Force connection
 
1219
        self.assertIs(t._get_connection(), c._get_connection())
 
1220
 
 
1221
        # Temporary failure, we need to create a new dummy connection
 
1222
        new_connection = object()
 
1223
        t._set_connection(new_connection)
 
1224
        # Check that both transports use the same connection
 
1225
        self.assertIs(new_connection, t._get_connection())
 
1226
        self.assertIs(new_connection, c._get_connection())
 
1227
 
 
1228
    def test_reuse_connection_for_various_paths(self):
 
1229
        t = self.get_transport()
 
1230
        if not isinstance(t, ConnectedTransport):
 
1231
            raise TestSkipped("not a connected transport")
 
1232
 
 
1233
        t.has('surely_not') # Force connection
 
1234
        self.assertIsNot(None, t._get_connection())
 
1235
 
 
1236
        subdir = t._reuse_for(t.base + 'whatever/but/deep/down/the/path')
 
1237
        self.assertIsNot(t, subdir)
 
1238
        self.assertIs(t._get_connection(), subdir._get_connection())
 
1239
 
 
1240
        home = subdir._reuse_for(t.base + 'home')
 
1241
        self.assertIs(t._get_connection(), home._get_connection())
 
1242
        self.assertIs(subdir._get_connection(), home._get_connection())
 
1243
 
773
1244
    def test_clone(self):
774
1245
        # TODO: Test that clone moves up and down the filesystem
775
1246
        t1 = self.get_transport()
795
1266
        self.failIf(t3.has('b/d'))
796
1267
 
797
1268
        if t1.is_readonly():
798
 
            open('b/d', 'wb').write('newfile\n')
 
1269
            self.build_tree_contents([('b/d', 'newfile\n')])
799
1270
        else:
800
 
            t2.put('d', StringIO('newfile\n'))
 
1271
            t2.put_bytes('d', 'newfile\n')
801
1272
 
802
1273
        self.failUnless(t1.has('b/d'))
803
1274
        self.failUnless(t2.has('d'))
804
1275
        self.failUnless(t3.has('b/d'))
805
1276
 
 
1277
    def test_clone_to_root(self):
 
1278
        orig_transport = self.get_transport()
 
1279
        # Repeatedly go up to a parent directory until we're at the root
 
1280
        # directory of this transport
 
1281
        root_transport = orig_transport
 
1282
        new_transport = root_transport.clone("..")
 
1283
        # as we are walking up directories, the path must be
 
1284
        # growing less, except at the top
 
1285
        self.assertTrue(len(new_transport.base) < len(root_transport.base)
 
1286
            or new_transport.base == root_transport.base)
 
1287
        while new_transport.base != root_transport.base:
 
1288
            root_transport = new_transport
 
1289
            new_transport = root_transport.clone("..")
 
1290
            # as we are walking up directories, the path must be
 
1291
            # growing less, except at the top
 
1292
            self.assertTrue(len(new_transport.base) < len(root_transport.base)
 
1293
                or new_transport.base == root_transport.base)
 
1294
 
 
1295
        # Cloning to "/" should take us to exactly the same location.
 
1296
        self.assertEqual(root_transport.base, orig_transport.clone("/").base)
 
1297
        # the abspath of "/" from the original transport should be the same
 
1298
        # as the base at the root:
 
1299
        self.assertEqual(orig_transport.abspath("/"), root_transport.base)
 
1300
 
 
1301
        # At the root, the URL must still end with / as its a directory
 
1302
        self.assertEqual(root_transport.base[-1], '/')
 
1303
 
 
1304
    def test_clone_from_root(self):
 
1305
        """At the root, cloning to a simple dir should just do string append."""
 
1306
        orig_transport = self.get_transport()
 
1307
        root_transport = orig_transport.clone('/')
 
1308
        self.assertEqual(root_transport.base + '.bzr/',
 
1309
            root_transport.clone('.bzr').base)
 
1310
 
 
1311
    def test_base_url(self):
 
1312
        t = self.get_transport()
 
1313
        self.assertEqual('/', t.base[-1])
 
1314
 
806
1315
    def test_relpath(self):
807
1316
        t = self.get_transport()
808
1317
        self.assertEqual('', t.relpath(t.base))
809
1318
        # base ends with /
810
1319
        self.assertEqual('', t.relpath(t.base[:-1]))
811
 
        # subdirs which dont exist should still give relpaths.
 
1320
        # subdirs which don't exist should still give relpaths.
812
1321
        self.assertEqual('foo', t.relpath(t.base + 'foo'))
813
1322
        # trailing slash should be the same.
814
1323
        self.assertEqual('foo', t.relpath(t.base + 'foo/'))
830
1339
        # that have aliasing problems like symlinks should go in backend
831
1340
        # specific test cases.
832
1341
        transport = self.get_transport()
833
 
        
834
 
        # disabled because some transports might normalize urls in generating
835
 
        # the abspath - eg http+pycurl-> just http -- mbp 20060308 
 
1342
 
836
1343
        self.assertEqual(transport.base + 'relpath',
837
1344
                         transport.abspath('relpath'))
838
1345
 
 
1346
        # This should work without raising an error.
 
1347
        transport.abspath("/")
 
1348
 
 
1349
        # the abspath of "/" and "/foo/.." should result in the same location
 
1350
        self.assertEqual(transport.abspath("/"), transport.abspath("/foo/.."))
 
1351
 
 
1352
        self.assertEqual(transport.clone("/").abspath('foo'),
 
1353
                         transport.abspath("/foo"))
 
1354
 
 
1355
    def test_win32_abspath(self):
 
1356
        # Note: we tried to set sys.platform='win32' so we could test on
 
1357
        # other platforms too, but then osutils does platform specific
 
1358
        # things at import time which defeated us...
 
1359
        if sys.platform != 'win32':
 
1360
            raise TestSkipped(
 
1361
                'Testing drive letters in abspath implemented only for win32')
 
1362
 
 
1363
        # smoke test for abspath on win32.
 
1364
        # a transport based on 'file:///' never fully qualifies the drive.
 
1365
        transport = get_transport("file:///")
 
1366
        self.failUnlessEqual(transport.abspath("/"), "file:///")
 
1367
 
 
1368
        # but a transport that starts with a drive spec must keep it.
 
1369
        transport = get_transport("file:///C:/")
 
1370
        self.failUnlessEqual(transport.abspath("/"), "file:///C:/")
 
1371
 
839
1372
    def test_local_abspath(self):
840
1373
        transport = self.get_transport()
841
1374
        try:
842
1375
            p = transport.local_abspath('.')
843
 
        except TransportNotPossible:
844
 
            pass # This is not a local transport
 
1376
        except (errors.NotLocalUrl, TransportNotPossible), e:
 
1377
            # should be formattable
 
1378
            s = str(e)
845
1379
        else:
846
1380
            self.assertEqual(getcwd(), p)
847
1381
 
872
1406
                         'isolated/dir/',
873
1407
                         'isolated/dir/foo',
874
1408
                         'isolated/dir/bar',
 
1409
                         'isolated/dir/b%25z', # make sure quoting is correct
875
1410
                         'isolated/bar'],
876
1411
                        transport=transport)
877
1412
        paths = set(transport.iter_files_recursive())
879
1414
        self.assertEqual(paths,
880
1415
                    set(['isolated/dir/foo',
881
1416
                         'isolated/dir/bar',
 
1417
                         'isolated/dir/b%2525z',
882
1418
                         'isolated/bar']))
883
1419
        sub_transport = transport.clone('isolated')
884
1420
        paths = set(sub_transport.iter_files_recursive())
885
 
        self.assertEqual(set(['dir/foo', 'dir/bar', 'bar']), paths)
 
1421
        self.assertEqual(paths,
 
1422
            set(['dir/foo', 'dir/bar', 'dir/b%2525z', 'bar']))
 
1423
 
 
1424
    def test_copy_tree(self):
 
1425
        # TODO: test file contents and permissions are preserved. This test was
 
1426
        # added just to ensure that quoting was handled correctly.
 
1427
        # -- David Allouche 2006-08-11
 
1428
        transport = self.get_transport()
 
1429
        if not transport.listable():
 
1430
            self.assertRaises(TransportNotPossible,
 
1431
                              transport.iter_files_recursive)
 
1432
            return
 
1433
        if transport.is_readonly():
 
1434
            return
 
1435
        self.build_tree(['from/',
 
1436
                         'from/dir/',
 
1437
                         'from/dir/foo',
 
1438
                         'from/dir/bar',
 
1439
                         'from/dir/b%25z', # make sure quoting is correct
 
1440
                         'from/bar'],
 
1441
                        transport=transport)
 
1442
        transport.copy_tree('from', 'to')
 
1443
        paths = set(transport.iter_files_recursive())
 
1444
        self.assertEqual(paths,
 
1445
                    set(['from/dir/foo',
 
1446
                         'from/dir/bar',
 
1447
                         'from/dir/b%2525z',
 
1448
                         'from/bar',
 
1449
                         'to/dir/foo',
 
1450
                         'to/dir/bar',
 
1451
                         'to/dir/b%2525z',
 
1452
                         'to/bar',]))
 
1453
 
 
1454
    def test_copy_tree_to_transport(self):
 
1455
        transport = self.get_transport()
 
1456
        if not transport.listable():
 
1457
            self.assertRaises(TransportNotPossible,
 
1458
                              transport.iter_files_recursive)
 
1459
            return
 
1460
        if transport.is_readonly():
 
1461
            return
 
1462
        self.build_tree(['from/',
 
1463
                         'from/dir/',
 
1464
                         'from/dir/foo',
 
1465
                         'from/dir/bar',
 
1466
                         'from/dir/b%25z', # make sure quoting is correct
 
1467
                         'from/bar'],
 
1468
                        transport=transport)
 
1469
        from_transport = transport.clone('from')
 
1470
        to_transport = transport.clone('to')
 
1471
        to_transport.ensure_base()
 
1472
        from_transport.copy_tree_to_transport(to_transport)
 
1473
        paths = set(transport.iter_files_recursive())
 
1474
        self.assertEqual(paths,
 
1475
                    set(['from/dir/foo',
 
1476
                         'from/dir/bar',
 
1477
                         'from/dir/b%2525z',
 
1478
                         'from/bar',
 
1479
                         'to/dir/foo',
 
1480
                         'to/dir/bar',
 
1481
                         'to/dir/b%2525z',
 
1482
                         'to/bar',]))
886
1483
 
887
1484
    def test_unicode_paths(self):
888
1485
        """Test that we can read/write files with Unicode names."""
915
1512
            self.check_transport_contents(contents, t, urlutils.escape(fname))
916
1513
 
917
1514
    def test_connect_twice_is_same_content(self):
918
 
        # check that our server (whatever it is) is accessable reliably
 
1515
        # check that our server (whatever it is) is accessible reliably
919
1516
        # via get_transport and multiple connections share content.
920
1517
        transport = self.get_transport()
921
1518
        if transport.is_readonly():
922
1519
            return
923
 
        transport.put('foo', StringIO('bar'))
924
 
        transport2 = self.get_transport()
925
 
        self.check_transport_contents('bar', transport2, 'foo')
926
 
        # its base should be usable.
927
 
        transport2 = bzrlib.transport.get_transport(transport.base)
928
 
        self.check_transport_contents('bar', transport2, 'foo')
 
1520
        transport.put_bytes('foo', 'bar')
 
1521
        transport3 = self.get_transport()
 
1522
        self.check_transport_contents('bar', transport3, 'foo')
929
1523
 
930
1524
        # now opening at a relative url should give use a sane result:
931
1525
        transport.mkdir('newdir')
932
 
        transport2 = bzrlib.transport.get_transport(transport.base + "newdir")
933
 
        transport2 = transport2.clone('..')
934
 
        self.check_transport_contents('bar', transport2, 'foo')
 
1526
        transport5 = self.get_transport('newdir')
 
1527
        transport6 = transport5.clone('..')
 
1528
        self.check_transport_contents('bar', transport6, 'foo')
935
1529
 
936
1530
    def test_lock_write(self):
 
1531
        """Test transport-level write locks.
 
1532
 
 
1533
        These are deprecated and transports may decline to support them.
 
1534
        """
937
1535
        transport = self.get_transport()
938
1536
        if transport.is_readonly():
939
1537
            self.assertRaises(TransportNotPossible, transport.lock_write, 'foo')
940
1538
            return
941
 
        transport.put('lock', StringIO())
942
 
        lock = transport.lock_write('lock')
 
1539
        transport.put_bytes('lock', '')
 
1540
        try:
 
1541
            lock = transport.lock_write('lock')
 
1542
        except TransportNotPossible:
 
1543
            return
943
1544
        # TODO make this consistent on all platforms:
944
1545
        # self.assertRaises(LockError, transport.lock_write, 'lock')
945
1546
        lock.unlock()
946
1547
 
947
1548
    def test_lock_read(self):
 
1549
        """Test transport-level read locks.
 
1550
 
 
1551
        These are deprecated and transports may decline to support them.
 
1552
        """
948
1553
        transport = self.get_transport()
949
1554
        if transport.is_readonly():
950
1555
            file('lock', 'w').close()
951
1556
        else:
952
 
            transport.put('lock', StringIO())
953
 
        lock = transport.lock_read('lock')
 
1557
            transport.put_bytes('lock', '')
 
1558
        try:
 
1559
            lock = transport.lock_read('lock')
 
1560
        except TransportNotPossible:
 
1561
            return
954
1562
        # TODO make this consistent on all platforms:
955
1563
        # self.assertRaises(LockError, transport.lock_read, 'lock')
956
1564
        lock.unlock()
960
1568
        if transport.is_readonly():
961
1569
            file('a', 'w').write('0123456789')
962
1570
        else:
963
 
            transport.put('a', StringIO('0123456789'))
 
1571
            transport.put_bytes('a', '0123456789')
 
1572
 
 
1573
        d = list(transport.readv('a', ((0, 1),)))
 
1574
        self.assertEqual(d[0], (0, '0'))
964
1575
 
965
1576
        d = list(transport.readv('a', ((0, 1), (1, 1), (3, 2), (9, 1))))
966
1577
        self.assertEqual(d[0], (0, '0'))
973
1584
        if transport.is_readonly():
974
1585
            file('a', 'w').write('0123456789')
975
1586
        else:
976
 
            transport.put('a', StringIO('01234567890'))
 
1587
            transport.put_bytes('a', '01234567890')
977
1588
 
978
1589
        d = list(transport.readv('a', ((1, 1), (9, 1), (0, 1), (3, 2))))
979
1590
        self.assertEqual(d[0], (1, '1'))
980
1591
        self.assertEqual(d[1], (9, '9'))
981
1592
        self.assertEqual(d[2], (0, '0'))
982
1593
        self.assertEqual(d[3], (3, '34'))
 
1594
 
 
1595
    def test_readv_with_adjust_for_latency(self):
 
1596
        transport = self.get_transport()
 
1597
        # the adjust for latency flag expands the data region returned
 
1598
        # according to a per-transport heuristic, so testing is a little
 
1599
        # tricky as we need more data than the largest combining that our
 
1600
        # transports do. To accomodate this we generate random data and cross
 
1601
        # reference the returned data with the random data. To avoid doing
 
1602
        # multiple large random byte look ups we do several tests on the same
 
1603
        # backing data.
 
1604
        content = osutils.rand_bytes(200*1024)
 
1605
        content_size = len(content)
 
1606
        if transport.is_readonly():
 
1607
            self.build_tree_contents([('a', content)])
 
1608
        else:
 
1609
            transport.put_bytes('a', content)
 
1610
        def check_result_data(result_vector):
 
1611
            for item in result_vector:
 
1612
                data_len = len(item[1])
 
1613
                self.assertEqual(content[item[0]:item[0] + data_len], item[1])
 
1614
 
 
1615
        # start corner case
 
1616
        result = list(transport.readv('a', ((0, 30),),
 
1617
            adjust_for_latency=True, upper_limit=content_size))
 
1618
        # we expect 1 result, from 0, to something > 30
 
1619
        self.assertEqual(1, len(result))
 
1620
        self.assertEqual(0, result[0][0])
 
1621
        self.assertTrue(len(result[0][1]) >= 30)
 
1622
        check_result_data(result)
 
1623
        # end of file corner case
 
1624
        result = list(transport.readv('a', ((204700, 100),),
 
1625
            adjust_for_latency=True, upper_limit=content_size))
 
1626
        # we expect 1 result, from 204800- its length, to the end
 
1627
        self.assertEqual(1, len(result))
 
1628
        data_len = len(result[0][1])
 
1629
        self.assertEqual(204800-data_len, result[0][0])
 
1630
        self.assertTrue(data_len >= 100)
 
1631
        check_result_data(result)
 
1632
        # out of order ranges are made in order
 
1633
        result = list(transport.readv('a', ((204700, 100), (0, 50)),
 
1634
            adjust_for_latency=True, upper_limit=content_size))
 
1635
        # we expect 2 results, in order, start and end.
 
1636
        self.assertEqual(2, len(result))
 
1637
        # start
 
1638
        data_len = len(result[0][1])
 
1639
        self.assertEqual(0, result[0][0])
 
1640
        self.assertTrue(data_len >= 30)
 
1641
        # end
 
1642
        data_len = len(result[1][1])
 
1643
        self.assertEqual(204800-data_len, result[1][0])
 
1644
        self.assertTrue(data_len >= 100)
 
1645
        check_result_data(result)
 
1646
        # close ranges get combined (even if out of order)
 
1647
        for request_vector in [((400,50), (800, 234)), ((800, 234), (400,50))]:
 
1648
            result = list(transport.readv('a', request_vector,
 
1649
                adjust_for_latency=True, upper_limit=content_size))
 
1650
            self.assertEqual(1, len(result))
 
1651
            data_len = len(result[0][1])
 
1652
            # minimum length is from 400 to 1034 - 634
 
1653
            self.assertTrue(data_len >= 634)
 
1654
            # must contain the region 400 to 1034
 
1655
            self.assertTrue(result[0][0] <= 400)
 
1656
            self.assertTrue(result[0][0] + data_len >= 1034)
 
1657
            check_result_data(result)
 
1658
 
 
1659
    def test_readv_with_adjust_for_latency_with_big_file(self):
 
1660
        transport = self.get_transport()
 
1661
        # test from observed failure case.
 
1662
        if transport.is_readonly():
 
1663
            file('a', 'w').write('a'*1024*1024)
 
1664
        else:
 
1665
            transport.put_bytes('a', 'a'*1024*1024)
 
1666
        broken_vector = [(465219, 800), (225221, 800), (445548, 800),
 
1667
            (225037, 800), (221357, 800), (437077, 800), (947670, 800),
 
1668
            (465373, 800), (947422, 800)]
 
1669
        results = list(transport.readv('a', broken_vector, True, 1024*1024))
 
1670
        found_items = [False]*9
 
1671
        for pos, (start, length) in enumerate(broken_vector):
 
1672
            # check the range is covered by the result
 
1673
            for offset, data in results:
 
1674
                if offset <= start and start + length <= offset + len(data):
 
1675
                    found_items[pos] = True
 
1676
        self.assertEqual([True]*9, found_items)
 
1677
 
 
1678
    def test_get_with_open_write_stream_sees_all_content(self):
 
1679
        t = self.get_transport()
 
1680
        if t.is_readonly():
 
1681
            return
 
1682
        handle = t.open_write_stream('foo')
 
1683
        try:
 
1684
            handle.write('bcd')
 
1685
            self.assertEqual([(0, 'b'), (2, 'd')], list(t.readv('foo', ((0,1), (2,1)))))
 
1686
        finally:
 
1687
            handle.close()
 
1688
 
 
1689
    def test_get_smart_medium(self):
 
1690
        """All transports must either give a smart medium, or know they can't.
 
1691
        """
 
1692
        transport = self.get_transport()
 
1693
        try:
 
1694
            client_medium = transport.get_smart_medium()
 
1695
            self.assertIsInstance(client_medium, medium.SmartClientMedium)
 
1696
        except errors.NoSmartMedium:
 
1697
            # as long as we got it we're fine
 
1698
            pass
 
1699
 
 
1700
    def test_readv_short_read(self):
 
1701
        transport = self.get_transport()
 
1702
        if transport.is_readonly():
 
1703
            file('a', 'w').write('0123456789')
 
1704
        else:
 
1705
            transport.put_bytes('a', '01234567890')
 
1706
 
 
1707
        # This is intentionally reading off the end of the file
 
1708
        # since we are sure that it cannot get there
 
1709
        self.assertListRaises((errors.ShortReadvError, errors.InvalidRange,
 
1710
                               # Can be raised by paramiko
 
1711
                               AssertionError),
 
1712
                              transport.readv, 'a', [(1,1), (8,10)])
 
1713
 
 
1714
        # This is trying to seek past the end of the file, it should
 
1715
        # also raise a special error
 
1716
        self.assertListRaises((errors.ShortReadvError, errors.InvalidRange),
 
1717
                              transport.readv, 'a', [(12,2)])