/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/transport/remote.py

  • Committer: Andrew Bennetts
  • Date: 2008-03-28 08:05:51 UTC
  • mto: This revision was merged to the branch mainline in revision 3321.
  • Revision ID: andrew.bennetts@canonical.com-20080328080551-n7f6rejuycnzn0p8
Change _SmartClient's API to accept a medium and a base, rather than a _SharedConnection.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/transport/remote.py
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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
17
"""RemoteTransport client for the smart-server.
18
18
 
23
23
__all__ = ['RemoteTransport', 'RemoteTCPTransport', 'RemoteSSHTransport']
24
24
 
25
25
from cStringIO import StringIO
 
26
import urllib
 
27
import urlparse
26
28
 
27
29
from bzrlib import (
28
30
    config,
29
31
    debug,
30
32
    errors,
31
 
    remote,
32
33
    trace,
33
34
    transport,
34
35
    urlutils,
35
36
    )
36
 
from bzrlib.smart import client, medium
37
 
from bzrlib.symbol_versioning import (
38
 
    deprecated_method,
39
 
    )
 
37
from bzrlib.smart import client, medium, protocol
40
38
 
41
39
 
42
40
class _SmartStat(object):
54
52
 
55
53
    The connection has a notion of the current directory to which it's
56
54
    connected; this is incorporated in filenames passed to the server.
57
 
 
58
 
    This supports some higher-level RPC operations and can also be treated
 
55
    
 
56
    This supports some higher-level RPC operations and can also be treated 
59
57
    like a Transport to do file-like operations.
60
58
 
61
59
    The connection can be made over a tcp socket, an ssh pipe or a series of
63
61
    RemoteTCPTransport, etc.
64
62
    """
65
63
 
66
 
    # When making a readv request, cap it at requesting 5MB of data
67
 
    _max_readv_bytes = 5*1024*1024
68
 
 
69
64
    # IMPORTANT FOR IMPLEMENTORS: RemoteTransport MUST NOT be given encoding
70
65
    # responsibilities: Put those on SmartClient or similar. This is vital for
71
66
    # the ability to support multiple versions of the smart protocol over time:
72
 
    # RemoteTransport is an adapter from the Transport object model to the
 
67
    # RemoteTransport is an adapter from the Transport object model to the 
73
68
    # SmartClient model, not an encoder.
74
69
 
75
70
    # FIXME: the medium parameter should be private, only the tests requires
83
78
            one is being cloned from.  Attributes such as the medium will
84
79
            be reused.
85
80
 
86
 
        :param medium: The medium to use for this RemoteTransport.  If None,
87
 
            the medium from the _from_transport is shared.  If both this
88
 
            and _from_transport are None, a new medium will be built.
89
 
            _from_transport and medium cannot both be specified.
 
81
        :param medium: The medium to use for this RemoteTransport. This must be
 
82
            supplied if _from_transport is None.
90
83
 
91
84
        :param _client: Override the _SmartClient used by this transport.  This
92
85
            should only be used for testing purposes; normally this is
93
86
            determined from the medium.
94
87
        """
95
 
        super(RemoteTransport, self).__init__(
96
 
            url, _from_transport=_from_transport)
 
88
        super(RemoteTransport, self).__init__(url,
 
89
                                              _from_transport=_from_transport)
97
90
 
98
91
        # The medium is the connection, except when we need to share it with
99
92
        # other objects (RemoteBzrDir, RemoteRepository etc). In these cases
100
93
        # what we want to share is really the shared connection.
101
94
 
102
 
        if (_from_transport is not None
103
 
            and isinstance(_from_transport, RemoteTransport)):
104
 
            _client = _from_transport._client
105
 
        elif _from_transport is None:
 
95
        if _from_transport is None:
106
96
            # If no _from_transport is specified, we need to intialize the
107
97
            # shared medium.
108
98
            credentials = None
114
104
            self._shared_connection = transport._SharedConnection(medium,
115
105
                                                                  credentials,
116
106
                                                                  self.base)
117
 
        elif medium is None:
118
 
            # No medium was specified, so share the medium from the
119
 
            # _from_transport.
120
 
            medium = self._shared_connection.connection
121
107
        else:
122
 
            raise AssertionError(
123
 
                "Both _from_transport (%r) and medium (%r) passed to "
124
 
                "RemoteTransport.__init__, but these parameters are mutally "
125
 
                "exclusive." % (_from_transport, medium))
 
108
            if medium is None:
 
109
                medium = self._shared_connection.connection
126
110
 
127
111
        if _client is None:
128
 
            self._client = client._SmartClient(medium)
 
112
            self._client = client._SmartClient(medium, self.base)
129
113
        else:
130
114
            self._client = _client
131
115
 
138
122
        # No credentials
139
123
        return None, None
140
124
 
141
 
    def _report_activity(self, bytes, direction):
142
 
        """See Transport._report_activity.
143
 
 
144
 
        Does nothing; the smart medium will report activity triggered by a
145
 
        RemoteTransport.
146
 
        """
147
 
        pass
148
 
 
149
125
    def is_readonly(self):
150
126
        """Smart server transport can do read/write file operations."""
151
 
        try:
152
 
            resp = self._call2('Transport.is_readonly')
153
 
        except errors.UnknownSmartMethod:
 
127
        resp = self._call2('Transport.is_readonly')
 
128
        if resp == ('yes', ):
 
129
            return True
 
130
        elif resp == ('no', ):
 
131
            return False
 
132
        elif (resp == ('error', "Generic bzr smart protocol error: "
 
133
                                "bad request 'Transport.is_readonly'") or
 
134
              resp == ('error', "Generic bzr smart protocol error: "
 
135
                                "bad request u'Transport.is_readonly'")):
154
136
            # XXX: nasty hack: servers before 0.16 don't have a
155
137
            # 'Transport.is_readonly' verb, so we do what clients before 0.16
156
138
            # did: assume False.
157
139
            return False
158
 
        if resp == ('yes', ):
159
 
            return True
160
 
        elif resp == ('no', ):
161
 
            return False
162
140
        else:
163
 
            raise errors.UnexpectedSmartServerResponse(resp)
 
141
            self._translate_error(resp)
 
142
        raise errors.UnexpectedSmartServerResponse(resp)
164
143
 
165
144
    def get_smart_client(self):
166
145
        return self._get_connection()
168
147
    def get_smart_medium(self):
169
148
        return self._get_connection()
170
149
 
 
150
    def get_shared_medium(self):
 
151
        return self._get_shared_connection()
 
152
 
171
153
    def _remote_path(self, relpath):
172
154
        """Returns the Unicode version of the absolute path for relpath."""
173
155
        return self._combine_paths(self._path, relpath)
174
156
 
175
157
    def _call(self, method, *args):
176
158
        resp = self._call2(method, *args)
177
 
        self._ensure_ok(resp)
 
159
        self._translate_error(resp)
178
160
 
179
161
    def _call2(self, method, *args):
180
162
        """Call a method on the remote server."""
181
 
        try:
182
 
            return self._client.call(method, *args)
183
 
        except errors.ErrorFromSmartServer, err:
184
 
            # The first argument, if present, is always a path.
185
 
            if args:
186
 
                context = {'relpath': args[0]}
187
 
            else:
188
 
                context = {}
189
 
            self._translate_error(err, **context)
 
163
        return self._client.call(method, *args)
190
164
 
191
165
    def _call_with_body_bytes(self, method, args, body):
192
166
        """Call a method on the remote server with body bytes."""
193
 
        try:
194
 
            return self._client.call_with_body_bytes(method, args, body)
195
 
        except errors.ErrorFromSmartServer, err:
196
 
            # The first argument, if present, is always a path.
197
 
            if args:
198
 
                context = {'relpath': args[0]}
199
 
            else:
200
 
                context = {}
201
 
            self._translate_error(err, **context)
 
167
        return self._client.call_with_body_bytes(method, args, body)
202
168
 
203
169
    def has(self, relpath):
204
170
        """Indicate whether a remote file of the given name exists or not.
211
177
        elif resp == ('no', ):
212
178
            return False
213
179
        else:
214
 
            raise errors.UnexpectedSmartServerResponse(resp)
 
180
            self._translate_error(resp)
215
181
 
216
182
    def get(self, relpath):
217
183
        """Return file-like object reading the contents of a remote file.
218
 
 
 
184
        
219
185
        :see: Transport.get_bytes()/get_file()
220
186
        """
221
187
        return StringIO(self.get_bytes(relpath))
222
188
 
223
189
    def get_bytes(self, relpath):
224
190
        remote = self._remote_path(relpath)
225
 
        try:
226
 
            resp, response_handler = self._client.call_expecting_body('get', remote)
227
 
        except errors.ErrorFromSmartServer, err:
228
 
            self._translate_error(err, relpath)
 
191
        request = self.get_smart_medium().get_request()
 
192
        smart_protocol = protocol.SmartClientRequestProtocolOne(request)
 
193
        smart_protocol.call('get', remote)
 
194
        resp = smart_protocol.read_response_tuple(True)
229
195
        if resp != ('ok', ):
230
 
            response_handler.cancel_read_body()
231
 
            raise errors.UnexpectedSmartServerResponse(resp)
232
 
        return response_handler.read_body_bytes()
 
196
            smart_protocol.cancel_read_body()
 
197
            self._translate_error(resp, relpath)
 
198
        return smart_protocol.read_body_bytes()
233
199
 
234
200
    def _serialise_optional_mode(self, mode):
235
201
        if mode is None:
240
206
    def mkdir(self, relpath, mode=None):
241
207
        resp = self._call2('mkdir', self._remote_path(relpath),
242
208
            self._serialise_optional_mode(mode))
 
209
        self._translate_error(resp)
243
210
 
244
211
    def open_write_stream(self, relpath, mode=None):
245
212
        """See Transport.open_write_stream."""
261
228
        resp = self._call_with_body_bytes('put',
262
229
            (self._remote_path(relpath), self._serialise_optional_mode(mode)),
263
230
            upload_contents)
264
 
        self._ensure_ok(resp)
 
231
        self._translate_error(resp)
265
232
        return len(upload_contents)
266
233
 
267
234
    def put_bytes_non_atomic(self, relpath, bytes, mode=None,
278
245
            (self._remote_path(relpath), self._serialise_optional_mode(mode),
279
246
             create_parent_str, self._serialise_optional_mode(dir_mode)),
280
247
            bytes)
281
 
        self._ensure_ok(resp)
 
248
        self._translate_error(resp)
282
249
 
283
250
    def put_file(self, relpath, upload_file, mode=None):
284
251
        # its not ideal to seek back, but currently put_non_atomic_file depends
300
267
 
301
268
    def append_file(self, relpath, from_file, mode=None):
302
269
        return self.append_bytes(relpath, from_file.read(), mode)
303
 
 
 
270
        
304
271
    def append_bytes(self, relpath, bytes, mode=None):
305
272
        resp = self._call_with_body_bytes(
306
273
            'append',
308
275
            bytes)
309
276
        if resp[0] == 'appended':
310
277
            return int(resp[1])
311
 
        raise errors.UnexpectedSmartServerResponse(resp)
 
278
        self._translate_error(resp)
312
279
 
313
280
    def delete(self, relpath):
314
281
        resp = self._call2('delete', self._remote_path(relpath))
315
 
        self._ensure_ok(resp)
 
282
        self._translate_error(resp)
316
283
 
317
284
    def external_url(self):
318
285
        """See bzrlib.transport.Transport.external_url."""
322
289
    def recommended_page_size(self):
323
290
        """Return the recommended page size for this transport."""
324
291
        return 64 * 1024
325
 
 
 
292
        
326
293
    def _readv(self, relpath, offsets):
327
294
        if not offsets:
328
295
            return
330
297
        offsets = list(offsets)
331
298
 
332
299
        sorted_offsets = sorted(offsets)
 
300
        # turn the list of offsets into a stack
 
301
        offset_stack = iter(offsets)
 
302
        cur_offset_and_size = offset_stack.next()
333
303
        coalesced = list(self._coalesce_offsets(sorted_offsets,
334
304
                               limit=self._max_readv_combine,
335
 
                               fudge_factor=self._bytes_to_read_before_seek,
336
 
                               max_size=self._max_readv_bytes))
337
 
 
338
 
        # now that we've coallesced things, avoid making enormous requests
339
 
        requests = []
340
 
        cur_request = []
341
 
        cur_len = 0
342
 
        for c in coalesced:
343
 
            if c.length + cur_len > self._max_readv_bytes:
344
 
                requests.append(cur_request)
345
 
                cur_request = [c]
346
 
                cur_len = c.length
347
 
                continue
348
 
            cur_request.append(c)
349
 
            cur_len += c.length
350
 
        if cur_request:
351
 
            requests.append(cur_request)
352
 
        if 'hpss' in debug.debug_flags:
353
 
            trace.mutter('%s.readv %s offsets => %s coalesced'
354
 
                         ' => %s requests (%s)',
355
 
                         self.__class__.__name__, len(offsets), len(coalesced),
356
 
                         len(requests), sum(map(len, requests)))
 
305
                               fudge_factor=self._bytes_to_read_before_seek))
 
306
 
 
307
        request = self.get_smart_medium().get_request()
 
308
        smart_protocol = protocol.SmartClientRequestProtocolOne(request)
 
309
        smart_protocol.call_with_body_readv_array(
 
310
            ('readv', self._remote_path(relpath)),
 
311
            [(c.start, c.length) for c in coalesced])
 
312
        resp = smart_protocol.read_response_tuple(True)
 
313
 
 
314
        if resp[0] != 'readv':
 
315
            # This should raise an exception
 
316
            smart_protocol.cancel_read_body()
 
317
            self._translate_error(resp)
 
318
            return
 
319
 
 
320
        # FIXME: this should know how many bytes are needed, for clarity.
 
321
        data = smart_protocol.read_body_bytes()
357
322
        # Cache the results, but only until they have been fulfilled
358
323
        data_map = {}
359
 
        # turn the list of offsets into a single stack to iterate
360
 
        offset_stack = iter(offsets)
361
 
        # using a list so it can be modified when passing down and coming back
362
 
        next_offset = [offset_stack.next()]
363
 
        for cur_request in requests:
364
 
            try:
365
 
                result = self._client.call_with_body_readv_array(
366
 
                    ('readv', self._remote_path(relpath),),
367
 
                    [(c.start, c.length) for c in cur_request])
368
 
                resp, response_handler = result
369
 
            except errors.ErrorFromSmartServer, err:
370
 
                self._translate_error(err, relpath)
371
 
 
372
 
            if resp[0] != 'readv':
373
 
                # This should raise an exception
374
 
                response_handler.cancel_read_body()
375
 
                raise errors.UnexpectedSmartServerResponse(resp)
376
 
 
377
 
            for res in self._handle_response(offset_stack, cur_request,
378
 
                                             response_handler,
379
 
                                             data_map,
380
 
                                             next_offset):
381
 
                yield res
382
 
 
383
 
    def _handle_response(self, offset_stack, coalesced, response_handler,
384
 
                         data_map, next_offset):
385
 
        cur_offset_and_size = next_offset[0]
386
 
        # FIXME: this should know how many bytes are needed, for clarity.
387
 
        data = response_handler.read_body_bytes()
388
 
        data_offset = 0
389
324
        for c_offset in coalesced:
390
325
            if len(data) < c_offset.length:
391
326
                raise errors.ShortReadvError(relpath, c_offset.start,
392
327
                            c_offset.length, actual=len(data))
393
328
            for suboffset, subsize in c_offset.ranges:
394
329
                key = (c_offset.start+suboffset, subsize)
395
 
                this_data = data[data_offset+suboffset:
396
 
                                 data_offset+suboffset+subsize]
397
 
                # Special case when the data is in-order, rather than packing
398
 
                # into a map and then back out again. Benchmarking shows that
399
 
                # this has 100% hit rate, but leave in the data_map work just
400
 
                # in case.
401
 
                # TODO: Could we get away with using buffer() to avoid the
402
 
                #       memory copy?  Callers would need to realize they may
403
 
                #       not have a real string.
404
 
                if key == cur_offset_and_size:
405
 
                    yield cur_offset_and_size[0], this_data
406
 
                    cur_offset_and_size = next_offset[0] = offset_stack.next()
407
 
                else:
408
 
                    data_map[key] = this_data
409
 
            data_offset += c_offset.length
 
330
                data_map[key] = data[suboffset:suboffset+subsize]
 
331
            data = data[c_offset.length:]
410
332
 
411
333
            # Now that we've read some data, see if we can yield anything back
412
334
            while cur_offset_and_size in data_map:
413
335
                this_data = data_map.pop(cur_offset_and_size)
414
336
                yield cur_offset_and_size[0], this_data
415
 
                cur_offset_and_size = next_offset[0] = offset_stack.next()
 
337
                cur_offset_and_size = offset_stack.next()
416
338
 
417
339
    def rename(self, rel_from, rel_to):
418
340
        self._call('rename',
427
349
    def rmdir(self, relpath):
428
350
        resp = self._call('rmdir', self._remote_path(relpath))
429
351
 
430
 
    def _ensure_ok(self, resp):
431
 
        if resp[0] != 'ok':
432
 
            raise errors.UnexpectedSmartServerResponse(resp)
433
 
 
434
 
    def _translate_error(self, err, relpath=None):
435
 
        remote._translate_error(err, path=relpath)
 
352
    def _translate_error(self, resp, orig_path=None):
 
353
        """Raise an exception from a response"""
 
354
        if resp is None:
 
355
            what = None
 
356
        else:
 
357
            what = resp[0]
 
358
        if what == 'ok':
 
359
            return
 
360
        elif what == 'NoSuchFile':
 
361
            if orig_path is not None:
 
362
                error_path = orig_path
 
363
            else:
 
364
                error_path = resp[1]
 
365
            raise errors.NoSuchFile(error_path)
 
366
        elif what == 'error':
 
367
            raise errors.SmartProtocolError(unicode(resp[1]))
 
368
        elif what == 'FileExists':
 
369
            raise errors.FileExists(resp[1])
 
370
        elif what == 'DirectoryNotEmpty':
 
371
            raise errors.DirectoryNotEmpty(resp[1])
 
372
        elif what == 'ShortReadvError':
 
373
            raise errors.ShortReadvError(resp[1], int(resp[2]),
 
374
                                         int(resp[3]), int(resp[4]))
 
375
        elif what in ('UnicodeEncodeError', 'UnicodeDecodeError'):
 
376
            encoding = str(resp[1]) # encoding must always be a string
 
377
            val = resp[2]
 
378
            start = int(resp[3])
 
379
            end = int(resp[4])
 
380
            reason = str(resp[5]) # reason must always be a string
 
381
            if val.startswith('u:'):
 
382
                val = val[2:].decode('utf-8')
 
383
            elif val.startswith('s:'):
 
384
                val = val[2:].decode('base64')
 
385
            if what == 'UnicodeDecodeError':
 
386
                raise UnicodeDecodeError(encoding, val, start, end, reason)
 
387
            elif what == 'UnicodeEncodeError':
 
388
                raise UnicodeEncodeError(encoding, val, start, end, reason)
 
389
        elif what == "ReadOnlyError":
 
390
            raise errors.TransportNotPossible('readonly transport')
 
391
        elif what == "ReadError":
 
392
            if orig_path is not None:
 
393
                error_path = orig_path
 
394
            else:
 
395
                error_path = resp[1]
 
396
            raise errors.ReadError(error_path)
 
397
        elif what == "PermissionDenied":
 
398
            if orig_path is not None:
 
399
                error_path = orig_path
 
400
            else:
 
401
                error_path = resp[1]
 
402
            raise errors.PermissionDenied(error_path)
 
403
        else:
 
404
            raise errors.SmartProtocolError('unexpected smart server error: %r' % (resp,))
436
405
 
437
406
    def disconnect(self):
438
407
        self.get_smart_medium().disconnect()
439
408
 
 
409
    def delete_tree(self, relpath):
 
410
        raise errors.TransportNotPossible('readonly transport')
 
411
 
440
412
    def stat(self, relpath):
441
413
        resp = self._call2('stat', self._remote_path(relpath))
442
414
        if resp[0] == 'stat':
443
415
            return _SmartStat(int(resp[1]), int(resp[2], 8))
444
 
        raise errors.UnexpectedSmartServerResponse(resp)
 
416
        else:
 
417
            self._translate_error(resp)
445
418
 
446
419
    ## def lock_read(self, relpath):
447
420
    ##     """Lock the given file for shared (read) access.
463
436
        resp = self._call2('list_dir', self._remote_path(relpath))
464
437
        if resp[0] == 'names':
465
438
            return [name.encode('ascii') for name in resp[1:]]
466
 
        raise errors.UnexpectedSmartServerResponse(resp)
 
439
        else:
 
440
            self._translate_error(resp)
467
441
 
468
442
    def iter_files_recursive(self):
469
443
        resp = self._call2('iter_files_recursive', self._remote_path(''))
470
444
        if resp[0] == 'names':
471
445
            return resp[1:]
472
 
        raise errors.UnexpectedSmartServerResponse(resp)
 
446
        else:
 
447
            self._translate_error(resp)
473
448
 
474
449
 
475
450
class RemoteTCPTransport(RemoteTransport):
476
451
    """Connection to smart server over plain tcp.
477
 
 
 
452
    
478
453
    This is essentially just a factory to get 'RemoteTransport(url,
479
454
        SmartTCPClientMedium).
480
455
    """
481
456
 
482
457
    def _build_medium(self):
483
 
        client_medium = medium.SmartTCPClientMedium(
484
 
            self._host, self._port, self.base)
485
 
        return client_medium, None
486
 
 
487
 
 
488
 
class RemoteTCPTransportV2Only(RemoteTransport):
489
 
    """Connection to smart server over plain tcp with the client hard-coded to
490
 
    assume protocol v2 and remote server version <= 1.6.
491
 
 
492
 
    This should only be used for testing.
493
 
    """
494
 
 
495
 
    def _build_medium(self):
496
 
        client_medium = medium.SmartTCPClientMedium(
497
 
            self._host, self._port, self.base)
498
 
        client_medium._protocol_version = 2
499
 
        client_medium._remember_remote_is_before((1, 6))
500
 
        return client_medium, None
 
458
        assert self.base.startswith('bzr://')
 
459
        return medium.SmartTCPClientMedium(self._host, self._port), None
501
460
 
502
461
 
503
462
class RemoteSSHTransport(RemoteTransport):
508
467
    """
509
468
 
510
469
    def _build_medium(self):
 
470
        assert self.base.startswith('bzr+ssh://')
 
471
        # ssh will prompt the user for a password if needed and if none is
 
472
        # provided but it will not give it back, so no credentials can be
 
473
        # stored.
511
474
        location_config = config.LocationConfig(self.base)
512
475
        bzr_remote_path = location_config.get_bzr_remote_path()
513
 
        user = self._user
514
 
        if user is None:
515
 
            auth = config.AuthenticationConfig()
516
 
            user = auth.get_user('ssh', self._host, self._port)
517
 
        client_medium = medium.SmartSSHClientMedium(self._host, self._port,
518
 
            user, self._password, self.base,
519
 
            bzr_remote_path=bzr_remote_path)
520
 
        return client_medium, (user, self._password)
 
476
        return medium.SmartSSHClientMedium(self._host, self._port,
 
477
            self._user, self._password, bzr_remote_path=bzr_remote_path), None
521
478
 
522
479
 
523
480
class RemoteHTTPTransport(RemoteTransport):
524
481
    """Just a way to connect between a bzr+http:// url and http://.
525
 
 
 
482
    
526
483
    This connection operates slightly differently than the RemoteSSHTransport.
527
484
    It uses a plain http:// transport underneath, which defines what remote
528
485
    .bzr/smart URL we are connected to. From there, all paths that are sent are
532
489
    """
533
490
 
534
491
    def __init__(self, base, _from_transport=None, http_transport=None):
 
492
        assert ( base.startswith('bzr+http://') or base.startswith('bzr+https://') )
 
493
 
535
494
        if http_transport is None:
536
495
            # FIXME: the password may be lost here because it appears in the
537
496
            # url only for an intial construction (when the url came from the
577
536
                                   _from_transport=self,
578
537
                                   http_transport=self._http_transport)
579
538
 
580
 
    def _redirected_to(self, source, target):
581
 
        """See transport._redirected_to"""
582
 
        redirected = self._http_transport._redirected_to(source, target)
583
 
        if (redirected is not None
584
 
            and isinstance(redirected, type(self._http_transport))):
585
 
            return RemoteHTTPTransport('bzr+' + redirected.external_url(),
586
 
                                       http_transport=redirected)
587
 
        else:
588
 
            # Either None or a transport for a different protocol
589
 
            return redirected
590
 
 
591
 
 
592
 
class HintingSSHTransport(transport.Transport):
593
 
    """Simple transport that handles ssh:// and points out bzr+ssh://."""
594
 
 
595
 
    def __init__(self, url):
596
 
        raise errors.UnsupportedProtocol(url,
597
 
            'bzr supports bzr+ssh to operate over ssh, use "bzr+%s".' % url)
598
 
 
599
539
 
600
540
def get_test_permutations():
601
541
    """Return (transport, server) permutations for testing."""
602
542
    ### We may need a little more test framework support to construct an
603
543
    ### appropriate RemoteTransport in the future.
604
 
    from bzrlib.tests import test_server
605
 
    return [(RemoteTCPTransport, test_server.SmartTCPServer_for_testing)]
 
544
    from bzrlib.smart import server
 
545
    return [(RemoteTCPTransport, server.SmartTCPServer_for_testing)]