~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/remote.py

 * ``Repository.get_data_stream`` is now deprecated in favour of
   ``Repository.get_data_stream_for_search`` which allows less network
   traffic when requesting data streams over a smart server. (Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2006-2010 Canonical Ltd
 
1
# Copyright (C) 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
 
 
17
 
import bz2
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
 
17
# TODO: At some point, handle upgrades by just passing the whole request
 
18
# across to run on the server.
 
19
 
 
20
from cStringIO import StringIO
18
21
 
19
22
from bzrlib import (
20
 
    bencode,
21
23
    branch,
22
 
    bzrdir,
23
 
    config,
24
 
    debug,
25
24
    errors,
26
25
    graph,
27
 
    lock,
28
26
    lockdir,
29
27
    repository,
30
 
    repository as _mod_repository,
31
28
    revision,
32
 
    revision as _mod_revision,
33
 
    static_tuple,
34
 
    symbol_versioning,
35
29
)
36
 
from bzrlib.branch import BranchReferenceFormat, BranchWriteLockResult
 
30
from bzrlib.branch import BranchReferenceFormat
37
31
from bzrlib.bzrdir import BzrDir, RemoteBzrDirFormat
38
 
from bzrlib.decorators import needs_read_lock, needs_write_lock, only_raises
39
 
from bzrlib.errors import (
40
 
    NoSuchRevision,
41
 
    SmartProtocolError,
 
32
from bzrlib.config import BranchConfig, TreeConfig
 
33
from bzrlib.decorators import needs_read_lock, needs_write_lock
 
34
from bzrlib.errors import NoSuchRevision
 
35
from bzrlib.lockable_files import LockableFiles
 
36
from bzrlib.pack import ContainerPushParser
 
37
from bzrlib.smart import client, vfs
 
38
from bzrlib.symbol_versioning import (
 
39
    deprecated_method,
 
40
    zero_ninetyone,
42
41
    )
43
 
from bzrlib.lockable_files import LockableFiles
44
 
from bzrlib.smart import client, vfs, repository as smart_repo
45
 
from bzrlib.revision import ensure_null, NULL_REVISION
46
 
from bzrlib.repository import RepositoryWriteLockResult
47
 
from bzrlib.trace import mutter, note, warning
48
 
 
49
 
 
50
 
class _RpcHelper(object):
51
 
    """Mixin class that helps with issuing RPCs."""
52
 
 
53
 
    def _call(self, method, *args, **err_context):
54
 
        try:
55
 
            return self._client.call(method, *args)
56
 
        except errors.ErrorFromSmartServer, err:
57
 
            self._translate_error(err, **err_context)
58
 
 
59
 
    def _call_expecting_body(self, method, *args, **err_context):
60
 
        try:
61
 
            return self._client.call_expecting_body(method, *args)
62
 
        except errors.ErrorFromSmartServer, err:
63
 
            self._translate_error(err, **err_context)
64
 
 
65
 
    def _call_with_body_bytes(self, method, args, body_bytes, **err_context):
66
 
        try:
67
 
            return self._client.call_with_body_bytes(method, args, body_bytes)
68
 
        except errors.ErrorFromSmartServer, err:
69
 
            self._translate_error(err, **err_context)
70
 
 
71
 
    def _call_with_body_bytes_expecting_body(self, method, args, body_bytes,
72
 
                                             **err_context):
73
 
        try:
74
 
            return self._client.call_with_body_bytes_expecting_body(
75
 
                method, args, body_bytes)
76
 
        except errors.ErrorFromSmartServer, err:
77
 
            self._translate_error(err, **err_context)
78
 
 
79
 
 
80
 
def response_tuple_to_repo_format(response):
81
 
    """Convert a response tuple describing a repository format to a format."""
82
 
    format = RemoteRepositoryFormat()
83
 
    format._rich_root_data = (response[0] == 'yes')
84
 
    format._supports_tree_reference = (response[1] == 'yes')
85
 
    format._supports_external_lookups = (response[2] == 'yes')
86
 
    format._network_name = response[3]
87
 
    return format
88
 
 
 
42
from bzrlib.revision import NULL_REVISION
 
43
from bzrlib.trace import note
89
44
 
90
45
# Note: RemoteBzrDirFormat is in bzrdir.py
91
46
 
92
 
class RemoteBzrDir(BzrDir, _RpcHelper):
 
47
class RemoteBzrDir(BzrDir):
93
48
    """Control directory on a remote server, accessed via bzr:// or similar."""
94
49
 
95
 
    def __init__(self, transport, format, _client=None, _force_probe=False):
 
50
    def __init__(self, transport, _client=None):
96
51
        """Construct a RemoteBzrDir.
97
52
 
98
53
        :param _client: Private parameter for testing. Disables probing and the
99
54
            use of a real bzrdir.
100
55
        """
101
 
        BzrDir.__init__(self, transport, format)
 
56
        BzrDir.__init__(self, transport, RemoteBzrDirFormat())
102
57
        # this object holds a delegated bzrdir that uses file-level operations
103
58
        # to talk to the other side
104
59
        self._real_bzrdir = None
105
 
        self._has_working_tree = None
106
 
        # 1-shot cache for the call pattern 'create_branch; open_branch' - see
107
 
        # create_branch for details.
108
 
        self._next_open_branch_result = None
109
60
 
110
61
        if _client is None:
111
 
            medium = transport.get_smart_medium()
112
 
            self._client = client._SmartClient(medium)
 
62
            self._shared_medium = transport.get_shared_medium()
 
63
            self._client = client._SmartClient(self._shared_medium)
113
64
        else:
114
65
            self._client = _client
115
 
            if not _force_probe:
116
 
                return
117
 
 
118
 
        self._probe_bzrdir()
119
 
 
120
 
    def __repr__(self):
121
 
        return '%s(%r)' % (self.__class__.__name__, self._client)
122
 
 
123
 
    def _probe_bzrdir(self):
124
 
        medium = self._client._medium
 
66
            self._shared_medium = None
 
67
            return
 
68
 
125
69
        path = self._path_for_remote_call(self._client)
126
 
        if medium._is_remote_before((2, 1)):
127
 
            self._rpc_open(path)
128
 
            return
129
 
        try:
130
 
            self._rpc_open_2_1(path)
131
 
            return
132
 
        except errors.UnknownSmartMethod:
133
 
            medium._remember_remote_is_before((2, 1))
134
 
            self._rpc_open(path)
135
 
 
136
 
    def _rpc_open_2_1(self, path):
137
 
        response = self._call('BzrDir.open_2.1', path)
138
 
        if response == ('no',):
139
 
            raise errors.NotBranchError(path=self.root_transport.base)
140
 
        elif response[0] == 'yes':
141
 
            if response[1] == 'yes':
142
 
                self._has_working_tree = True
143
 
            elif response[1] == 'no':
144
 
                self._has_working_tree = False
145
 
            else:
146
 
                raise errors.UnexpectedSmartServerResponse(response)
147
 
        else:
148
 
            raise errors.UnexpectedSmartServerResponse(response)
149
 
 
150
 
    def _rpc_open(self, path):
151
 
        response = self._call('BzrDir.open', path)
 
70
        response = self._client.call('BzrDir.open', path)
152
71
        if response not in [('yes',), ('no',)]:
153
72
            raise errors.UnexpectedSmartServerResponse(response)
154
73
        if response == ('no',):
155
 
            raise errors.NotBranchError(path=self.root_transport.base)
 
74
            raise errors.NotBranchError(path=transport.base)
156
75
 
157
76
    def _ensure_real(self):
158
77
        """Ensure that there is a _real_bzrdir set.
160
79
        Used before calls to self._real_bzrdir.
161
80
        """
162
81
        if not self._real_bzrdir:
163
 
            if 'hpssvfs' in debug.debug_flags:
164
 
                import traceback
165
 
                warning('VFS BzrDir access triggered\n%s',
166
 
                    ''.join(traceback.format_stack()))
167
82
            self._real_bzrdir = BzrDir.open_from_transport(
168
83
                self.root_transport, _server_formats=False)
169
 
            self._format._network_name = \
170
 
                self._real_bzrdir._format.network_name()
171
 
 
172
 
    def _translate_error(self, err, **context):
173
 
        _translate_error(err, bzrdir=self, **context)
174
 
 
175
 
    def break_lock(self):
176
 
        # Prevent aliasing problems in the next_open_branch_result cache.
177
 
        # See create_branch for rationale.
178
 
        self._next_open_branch_result = None
179
 
        return BzrDir.break_lock(self)
180
 
 
181
 
    def _vfs_cloning_metadir(self, require_stacking=False):
182
 
        self._ensure_real()
183
 
        return self._real_bzrdir.cloning_metadir(
184
 
            require_stacking=require_stacking)
185
 
 
186
 
    def cloning_metadir(self, require_stacking=False):
187
 
        medium = self._client._medium
188
 
        if medium._is_remote_before((1, 13)):
189
 
            return self._vfs_cloning_metadir(require_stacking=require_stacking)
190
 
        verb = 'BzrDir.cloning_metadir'
191
 
        if require_stacking:
192
 
            stacking = 'True'
193
 
        else:
194
 
            stacking = 'False'
195
 
        path = self._path_for_remote_call(self._client)
196
 
        try:
197
 
            response = self._call(verb, path, stacking)
198
 
        except errors.UnknownSmartMethod:
199
 
            medium._remember_remote_is_before((1, 13))
200
 
            return self._vfs_cloning_metadir(require_stacking=require_stacking)
201
 
        except errors.UnknownErrorFromSmartServer, err:
202
 
            if err.error_tuple != ('BranchReference',):
203
 
                raise
204
 
            # We need to resolve the branch reference to determine the
205
 
            # cloning_metadir.  This causes unnecessary RPCs to open the
206
 
            # referenced branch (and bzrdir, etc) but only when the caller
207
 
            # didn't already resolve the branch reference.
208
 
            referenced_branch = self.open_branch()
209
 
            return referenced_branch.bzrdir.cloning_metadir()
210
 
        if len(response) != 3:
211
 
            raise errors.UnexpectedSmartServerResponse(response)
212
 
        control_name, repo_name, branch_info = response
213
 
        if len(branch_info) != 2:
214
 
            raise errors.UnexpectedSmartServerResponse(response)
215
 
        branch_ref, branch_name = branch_info
216
 
        format = bzrdir.network_format_registry.get(control_name)
217
 
        if repo_name:
218
 
            format.repository_format = repository.network_format_registry.get(
219
 
                repo_name)
220
 
        if branch_ref == 'ref':
221
 
            # XXX: we need possible_transports here to avoid reopening the
222
 
            # connection to the referenced location
223
 
            ref_bzrdir = BzrDir.open(branch_name)
224
 
            branch_format = ref_bzrdir.cloning_metadir().get_branch_format()
225
 
            format.set_branch_format(branch_format)
226
 
        elif branch_ref == 'branch':
227
 
            if branch_name:
228
 
                format.set_branch_format(
229
 
                    branch.network_format_registry.get(branch_name))
230
 
        else:
231
 
            raise errors.UnexpectedSmartServerResponse(response)
232
 
        return format
233
84
 
234
85
    def create_repository(self, shared=False):
235
 
        # as per meta1 formats - just delegate to the format object which may
236
 
        # be parameterised.
237
 
        result = self._format.repository_format.initialize(self, shared)
238
 
        if not isinstance(result, RemoteRepository):
239
 
            return self.open_repository()
240
 
        else:
241
 
            return result
 
86
        self._ensure_real()
 
87
        self._real_bzrdir.create_repository(shared=shared)
 
88
        return self.open_repository()
242
89
 
243
90
    def destroy_repository(self):
244
91
        """See BzrDir.destroy_repository"""
245
92
        self._ensure_real()
246
93
        self._real_bzrdir.destroy_repository()
247
94
 
248
 
    def create_branch(self, name=None):
249
 
        # as per meta1 formats - just delegate to the format object which may
250
 
        # be parameterised.
251
 
        real_branch = self._format.get_branch_format().initialize(self,
252
 
            name=name)
253
 
        if not isinstance(real_branch, RemoteBranch):
254
 
            result = RemoteBranch(self, self.find_repository(), real_branch,
255
 
                                  name=name)
256
 
        else:
257
 
            result = real_branch
258
 
        # BzrDir.clone_on_transport() uses the result of create_branch but does
259
 
        # not return it to its callers; we save approximately 8% of our round
260
 
        # trips by handing the branch we created back to the first caller to
261
 
        # open_branch rather than probing anew. Long term we need a API in
262
 
        # bzrdir that doesn't discard result objects (like result_branch).
263
 
        # RBC 20090225
264
 
        self._next_open_branch_result = result
265
 
        return result
 
95
    def create_branch(self):
 
96
        self._ensure_real()
 
97
        real_branch = self._real_bzrdir.create_branch()
 
98
        return RemoteBranch(self, self.find_repository(), real_branch)
266
99
 
267
 
    def destroy_branch(self, name=None):
 
100
    def destroy_branch(self):
268
101
        """See BzrDir.destroy_branch"""
269
102
        self._ensure_real()
270
 
        self._real_bzrdir.destroy_branch(name=name)
271
 
        self._next_open_branch_result = None
 
103
        self._real_bzrdir.destroy_branch()
272
104
 
273
105
    def create_workingtree(self, revision_id=None, from_branch=None):
274
106
        raise errors.NotLocalUrl(self.transport.base)
283
115
 
284
116
    def get_branch_reference(self):
285
117
        """See BzrDir.get_branch_reference()."""
286
 
        response = self._get_branch_reference()
287
 
        if response[0] == 'ref':
288
 
            return response[1]
289
 
        else:
290
 
            return None
291
 
 
292
 
    def _get_branch_reference(self):
293
118
        path = self._path_for_remote_call(self._client)
294
 
        medium = self._client._medium
295
 
        candidate_calls = [
296
 
            ('BzrDir.open_branchV3', (2, 1)),
297
 
            ('BzrDir.open_branchV2', (1, 13)),
298
 
            ('BzrDir.open_branch', None),
299
 
            ]
300
 
        for verb, required_version in candidate_calls:
301
 
            if required_version and medium._is_remote_before(required_version):
302
 
                continue
303
 
            try:
304
 
                response = self._call(verb, path)
305
 
            except errors.UnknownSmartMethod:
306
 
                if required_version is None:
307
 
                    raise
308
 
                medium._remember_remote_is_before(required_version)
309
 
            else:
310
 
                break
311
 
        if verb == 'BzrDir.open_branch':
312
 
            if response[0] != 'ok':
313
 
                raise errors.UnexpectedSmartServerResponse(response)
314
 
            if response[1] != '':
315
 
                return ('ref', response[1])
316
 
            else:
317
 
                return ('branch', '')
318
 
        if response[0] not in ('ref', 'branch'):
 
119
        response = self._client.call('BzrDir.open_branch', path)
 
120
        if response[0] == 'ok':
 
121
            if response[1] == '':
 
122
                # branch at this location.
 
123
                return None
 
124
            else:
 
125
                # a branch reference, use the existing BranchReference logic.
 
126
                return response[1]
 
127
        elif response == ('nobranch',):
 
128
            raise errors.NotBranchError(path=self.root_transport.base)
 
129
        else:
319
130
            raise errors.UnexpectedSmartServerResponse(response)
320
 
        return response
321
 
 
322
 
    def _get_tree_branch(self):
323
 
        """See BzrDir._get_tree_branch()."""
324
 
        return None, self.open_branch()
325
 
 
326
 
    def open_branch(self, name=None, unsupported=False,
327
 
                    ignore_fallbacks=False):
328
 
        if unsupported:
329
 
            raise NotImplementedError('unsupported flag support not implemented yet.')
330
 
        if self._next_open_branch_result is not None:
331
 
            # See create_branch for details.
332
 
            result = self._next_open_branch_result
333
 
            self._next_open_branch_result = None
334
 
            return result
335
 
        response = self._get_branch_reference()
336
 
        if response[0] == 'ref':
 
131
 
 
132
    def open_branch(self, _unsupported=False):
 
133
        assert _unsupported == False, 'unsupported flag support not implemented yet.'
 
134
        reference_url = self.get_branch_reference()
 
135
        if reference_url is None:
 
136
            # branch at this location.
 
137
            return RemoteBranch(self, self.find_repository())
 
138
        else:
337
139
            # a branch reference, use the existing BranchReference logic.
338
140
            format = BranchReferenceFormat()
339
 
            return format.open(self, name=name, _found=True,
340
 
                location=response[1], ignore_fallbacks=ignore_fallbacks)
341
 
        branch_format_name = response[1]
342
 
        if not branch_format_name:
343
 
            branch_format_name = None
344
 
        format = RemoteBranchFormat(network_name=branch_format_name)
345
 
        return RemoteBranch(self, self.find_repository(), format=format,
346
 
            setup_stacking=not ignore_fallbacks, name=name)
347
 
 
348
 
    def _open_repo_v1(self, path):
349
 
        verb = 'BzrDir.find_repository'
350
 
        response = self._call(verb, path)
351
 
        if response[0] != 'ok':
352
 
            raise errors.UnexpectedSmartServerResponse(response)
353
 
        # servers that only support the v1 method don't support external
354
 
        # references either.
355
 
        self._ensure_real()
356
 
        repo = self._real_bzrdir.open_repository()
357
 
        response = response + ('no', repo._format.network_name())
358
 
        return response, repo
359
 
 
360
 
    def _open_repo_v2(self, path):
361
 
        verb = 'BzrDir.find_repositoryV2'
362
 
        response = self._call(verb, path)
363
 
        if response[0] != 'ok':
364
 
            raise errors.UnexpectedSmartServerResponse(response)
365
 
        self._ensure_real()
366
 
        repo = self._real_bzrdir.open_repository()
367
 
        response = response + (repo._format.network_name(),)
368
 
        return response, repo
369
 
 
370
 
    def _open_repo_v3(self, path):
371
 
        verb = 'BzrDir.find_repositoryV3'
372
 
        medium = self._client._medium
373
 
        if medium._is_remote_before((1, 13)):
374
 
            raise errors.UnknownSmartMethod(verb)
375
 
        try:
376
 
            response = self._call(verb, path)
377
 
        except errors.UnknownSmartMethod:
378
 
            medium._remember_remote_is_before((1, 13))
379
 
            raise
380
 
        if response[0] != 'ok':
381
 
            raise errors.UnexpectedSmartServerResponse(response)
382
 
        return response, None
383
 
 
 
141
            return format.open(self, _found=True, location=reference_url)
 
142
                
384
143
    def open_repository(self):
385
144
        path = self._path_for_remote_call(self._client)
386
 
        response = None
387
 
        for probe in [self._open_repo_v3, self._open_repo_v2,
388
 
            self._open_repo_v1]:
389
 
            try:
390
 
                response, real_repo = probe(path)
391
 
                break
392
 
            except errors.UnknownSmartMethod:
393
 
                pass
394
 
        if response is None:
395
 
            raise errors.UnknownSmartMethod('BzrDir.find_repository{3,2,}')
396
 
        if response[0] != 'ok':
397
 
            raise errors.UnexpectedSmartServerResponse(response)
398
 
        if len(response) != 6:
399
 
            raise SmartProtocolError('incorrect response length %s' % (response,))
 
145
        response = self._client.call('BzrDir.find_repository', path)
 
146
        assert response[0] in ('ok', 'norepository'), \
 
147
            'unexpected response code %s' % (response,)
 
148
        if response[0] == 'norepository':
 
149
            raise errors.NoRepositoryPresent(self)
 
150
        assert len(response) == 4, 'incorrect response length %s' % (response,)
400
151
        if response[1] == '':
401
 
            # repo is at this dir.
402
 
            format = response_tuple_to_repo_format(response[2:])
403
 
            # Used to support creating a real format instance when needed.
404
 
            format._creating_bzrdir = self
405
 
            remote_repo = RemoteRepository(self, format)
406
 
            format._creating_repo = remote_repo
407
 
            if real_repo is not None:
408
 
                remote_repo._set_real_repository(real_repo)
409
 
            return remote_repo
 
152
            format = RemoteRepositoryFormat()
 
153
            format.rich_root_data = (response[2] == 'yes')
 
154
            format.supports_tree_reference = (response[3] == 'yes')
 
155
            return RemoteRepository(self, format)
410
156
        else:
411
157
            raise errors.NoRepositoryPresent(self)
412
158
 
413
 
    def has_workingtree(self):
414
 
        if self._has_working_tree is None:
415
 
            self._ensure_real()
416
 
            self._has_working_tree = self._real_bzrdir.has_workingtree()
417
 
        return self._has_working_tree
418
 
 
419
159
    def open_workingtree(self, recommend_upgrade=True):
420
 
        if self.has_workingtree():
 
160
        self._ensure_real()
 
161
        if self._real_bzrdir.has_workingtree():
421
162
            raise errors.NotLocalUrl(self.root_transport)
422
163
        else:
423
164
            raise errors.NoWorkingTree(self.root_transport.base)
426
167
        """Return the path to be used for this bzrdir in a remote call."""
427
168
        return client.remote_path_from_transport(self.root_transport)
428
169
 
429
 
    def get_branch_transport(self, branch_format, name=None):
 
170
    def get_branch_transport(self, branch_format):
430
171
        self._ensure_real()
431
 
        return self._real_bzrdir.get_branch_transport(branch_format, name=name)
 
172
        return self._real_bzrdir.get_branch_transport(branch_format)
432
173
 
433
174
    def get_repository_transport(self, repository_format):
434
175
        self._ensure_real()
444
185
 
445
186
    def needs_format_conversion(self, format=None):
446
187
        """Upgrading of remote bzrdirs is not supported yet."""
447
 
        if format is None:
448
 
            symbol_versioning.warn(symbol_versioning.deprecated_in((1, 13, 0))
449
 
                % 'needs_format_conversion(format=None)')
450
188
        return False
451
189
 
452
 
    def clone(self, url, revision_id=None, force_new_repo=False,
453
 
              preserve_stacking=False):
 
190
    def clone(self, url, revision_id=None, force_new_repo=False):
454
191
        self._ensure_real()
455
192
        return self._real_bzrdir.clone(url, revision_id=revision_id,
456
 
            force_new_repo=force_new_repo, preserve_stacking=preserve_stacking)
457
 
 
458
 
    def _get_config(self):
459
 
        return RemoteBzrDirConfig(self)
 
193
            force_new_repo=force_new_repo)
460
194
 
461
195
 
462
196
class RemoteRepositoryFormat(repository.RepositoryFormat):
470
204
    the attributes rich_root_data and supports_tree_reference are set
471
205
    on a per instance basis, and are not set (and should not be) at
472
206
    the class level.
473
 
 
474
 
    :ivar _custom_format: If set, a specific concrete repository format that
475
 
        will be used when initializing a repository with this
476
 
        RemoteRepositoryFormat.
477
 
    :ivar _creating_repo: If set, the repository object that this
478
 
        RemoteRepositoryFormat was created for: it can be called into
479
 
        to obtain data like the network name.
480
207
    """
481
208
 
482
 
    _matchingbzrdir = RemoteBzrDirFormat()
483
 
 
484
 
    def __init__(self):
485
 
        repository.RepositoryFormat.__init__(self)
486
 
        self._custom_format = None
487
 
        self._network_name = None
488
 
        self._creating_bzrdir = None
489
 
        self._supports_chks = None
490
 
        self._supports_external_lookups = None
491
 
        self._supports_tree_reference = None
492
 
        self._rich_root_data = None
493
 
 
494
 
    def __repr__(self):
495
 
        return "%s(_network_name=%r)" % (self.__class__.__name__,
496
 
            self._network_name)
497
 
 
498
 
    @property
499
 
    def fast_deltas(self):
500
 
        self._ensure_real()
501
 
        return self._custom_format.fast_deltas
502
 
 
503
 
    @property
504
 
    def rich_root_data(self):
505
 
        if self._rich_root_data is None:
506
 
            self._ensure_real()
507
 
            self._rich_root_data = self._custom_format.rich_root_data
508
 
        return self._rich_root_data
509
 
 
510
 
    @property
511
 
    def supports_chks(self):
512
 
        if self._supports_chks is None:
513
 
            self._ensure_real()
514
 
            self._supports_chks = self._custom_format.supports_chks
515
 
        return self._supports_chks
516
 
 
517
 
    @property
518
 
    def supports_external_lookups(self):
519
 
        if self._supports_external_lookups is None:
520
 
            self._ensure_real()
521
 
            self._supports_external_lookups = \
522
 
                self._custom_format.supports_external_lookups
523
 
        return self._supports_external_lookups
524
 
 
525
 
    @property
526
 
    def supports_tree_reference(self):
527
 
        if self._supports_tree_reference is None:
528
 
            self._ensure_real()
529
 
            self._supports_tree_reference = \
530
 
                self._custom_format.supports_tree_reference
531
 
        return self._supports_tree_reference
532
 
 
533
 
    def _vfs_initialize(self, a_bzrdir, shared):
534
 
        """Helper for common code in initialize."""
535
 
        if self._custom_format:
536
 
            # Custom format requested
537
 
            result = self._custom_format.initialize(a_bzrdir, shared=shared)
538
 
        elif self._creating_bzrdir is not None:
539
 
            # Use the format that the repository we were created to back
540
 
            # has.
541
 
            prior_repo = self._creating_bzrdir.open_repository()
542
 
            prior_repo._ensure_real()
543
 
            result = prior_repo._real_repository._format.initialize(
544
 
                a_bzrdir, shared=shared)
545
 
        else:
546
 
            # assume that a_bzr is a RemoteBzrDir but the smart server didn't
547
 
            # support remote initialization.
548
 
            # We delegate to a real object at this point (as RemoteBzrDir
549
 
            # delegate to the repository format which would lead to infinite
550
 
            # recursion if we just called a_bzrdir.create_repository.
551
 
            a_bzrdir._ensure_real()
552
 
            result = a_bzrdir._real_bzrdir.create_repository(shared=shared)
553
 
        if not isinstance(result, RemoteRepository):
554
 
            return self.open(a_bzrdir)
555
 
        else:
556
 
            return result
 
209
    _matchingbzrdir = RemoteBzrDirFormat
557
210
 
558
211
    def initialize(self, a_bzrdir, shared=False):
559
 
        # Being asked to create on a non RemoteBzrDir:
560
 
        if not isinstance(a_bzrdir, RemoteBzrDir):
561
 
            return self._vfs_initialize(a_bzrdir, shared)
562
 
        medium = a_bzrdir._client._medium
563
 
        if medium._is_remote_before((1, 13)):
564
 
            return self._vfs_initialize(a_bzrdir, shared)
565
 
        # Creating on a remote bzr dir.
566
 
        # 1) get the network name to use.
567
 
        if self._custom_format:
568
 
            network_name = self._custom_format.network_name()
569
 
        elif self._network_name:
570
 
            network_name = self._network_name
571
 
        else:
572
 
            # Select the current bzrlib default and ask for that.
573
 
            reference_bzrdir_format = bzrdir.format_registry.get('default')()
574
 
            reference_format = reference_bzrdir_format.repository_format
575
 
            network_name = reference_format.network_name()
576
 
        # 2) try direct creation via RPC
577
 
        path = a_bzrdir._path_for_remote_call(a_bzrdir._client)
578
 
        verb = 'BzrDir.create_repository'
579
 
        if shared:
580
 
            shared_str = 'True'
581
 
        else:
582
 
            shared_str = 'False'
583
 
        try:
584
 
            response = a_bzrdir._call(verb, path, network_name, shared_str)
585
 
        except errors.UnknownSmartMethod:
586
 
            # Fallback - use vfs methods
587
 
            medium._remember_remote_is_before((1, 13))
588
 
            return self._vfs_initialize(a_bzrdir, shared)
589
 
        else:
590
 
            # Turn the response into a RemoteRepository object.
591
 
            format = response_tuple_to_repo_format(response[1:])
592
 
            # Used to support creating a real format instance when needed.
593
 
            format._creating_bzrdir = a_bzrdir
594
 
            remote_repo = RemoteRepository(a_bzrdir, format)
595
 
            format._creating_repo = remote_repo
596
 
            return remote_repo
597
 
 
 
212
        assert isinstance(a_bzrdir, RemoteBzrDir), \
 
213
            '%r is not a RemoteBzrDir' % (a_bzrdir,)
 
214
        return a_bzrdir.create_repository(shared=shared)
 
215
    
598
216
    def open(self, a_bzrdir):
599
 
        if not isinstance(a_bzrdir, RemoteBzrDir):
600
 
            raise AssertionError('%r is not a RemoteBzrDir' % (a_bzrdir,))
 
217
        assert isinstance(a_bzrdir, RemoteBzrDir)
601
218
        return a_bzrdir.open_repository()
602
219
 
603
 
    def _ensure_real(self):
604
 
        if self._custom_format is None:
605
 
            self._custom_format = repository.network_format_registry.get(
606
 
                self._network_name)
607
 
 
608
 
    @property
609
 
    def _fetch_order(self):
610
 
        self._ensure_real()
611
 
        return self._custom_format._fetch_order
612
 
 
613
 
    @property
614
 
    def _fetch_uses_deltas(self):
615
 
        self._ensure_real()
616
 
        return self._custom_format._fetch_uses_deltas
617
 
 
618
 
    @property
619
 
    def _fetch_reconcile(self):
620
 
        self._ensure_real()
621
 
        return self._custom_format._fetch_reconcile
622
 
 
623
220
    def get_format_description(self):
624
 
        self._ensure_real()
625
 
        return 'Remote: ' + self._custom_format.get_format_description()
 
221
        return 'bzr remote repository'
626
222
 
627
223
    def __eq__(self, other):
628
 
        return self.__class__ is other.__class__
629
 
 
630
 
    def network_name(self):
631
 
        if self._network_name:
632
 
            return self._network_name
633
 
        self._creating_repo._ensure_real()
634
 
        return self._creating_repo._real_repository._format.network_name()
635
 
 
636
 
    @property
637
 
    def pack_compresses(self):
638
 
        self._ensure_real()
639
 
        return self._custom_format.pack_compresses
640
 
 
641
 
    @property
642
 
    def _serializer(self):
643
 
        self._ensure_real()
644
 
        return self._custom_format._serializer
645
 
 
646
 
 
647
 
class RemoteRepository(_RpcHelper, lock._RelockDebugMixin,
648
 
    bzrdir.ControlComponent):
 
224
        return self.__class__ == other.__class__
 
225
 
 
226
    def check_conversion_target(self, target_format):
 
227
        if self.rich_root_data and not target_format.rich_root_data:
 
228
            raise errors.BadConversionTarget(
 
229
                'Does not support rich root data.', target_format)
 
230
        if (self.supports_tree_reference and
 
231
            not getattr(target_format, 'supports_tree_reference', False)):
 
232
            raise errors.BadConversionTarget(
 
233
                'Does not support nested trees', target_format)
 
234
 
 
235
 
 
236
class RemoteRepository(object):
649
237
    """Repository accessed over rpc.
650
238
 
651
239
    For the moment most operations are performed using local transport-backed
654
242
 
655
243
    def __init__(self, remote_bzrdir, format, real_repository=None, _client=None):
656
244
        """Create a RemoteRepository instance.
657
 
 
 
245
        
658
246
        :param remote_bzrdir: The bzrdir hosting this repository.
659
247
        :param format: The RemoteFormat object to use.
660
248
        :param real_repository: If not None, a local implementation of the
669
257
            self._real_repository = None
670
258
        self.bzrdir = remote_bzrdir
671
259
        if _client is None:
672
 
            self._client = remote_bzrdir._client
 
260
            self._client = client._SmartClient(self.bzrdir._shared_medium)
673
261
        else:
674
262
            self._client = _client
675
263
        self._format = format
677
265
        self._lock_token = None
678
266
        self._lock_count = 0
679
267
        self._leave_lock = False
680
 
        # Cache of revision parents; misses are cached during read locks, and
681
 
        # write locks when no _real_repository has been set.
682
 
        self._unstacked_provider = graph.CachingParentsProvider(
683
 
            get_parent_map=self._get_parent_map_rpc)
684
 
        self._unstacked_provider.disable_cache()
 
268
        # A cache of looked up revision parent data; reset at unlock time.
 
269
        self._parents_map = None
685
270
        # For tests:
686
271
        # These depend on the actual remote format, so force them off for
687
272
        # maximum compatibility. XXX: In future these should depend on the
691
276
        self._reconcile_fixes_text_parents = False
692
277
        self._reconcile_backsup_inventory = False
693
278
        self.base = self.bzrdir.transport.base
694
 
        # Additional places to query for data.
695
 
        self._fallback_repositories = []
696
 
 
697
 
    @property
698
 
    def user_transport(self):
699
 
        return self.bzrdir.user_transport
700
 
 
701
 
    @property
702
 
    def control_transport(self):
703
 
        # XXX: Normally you shouldn't directly get at the remote repository
704
 
        # transport, but I'm not sure it's worth making this method
705
 
        # optional -- mbp 2010-04-21
706
 
        return self.bzrdir.get_repository_transport(None)
707
 
        
 
279
 
708
280
    def __str__(self):
709
281
        return "%s(%s)" % (self.__class__.__name__, self.base)
710
282
 
711
283
    __repr__ = __str__
712
284
 
713
 
    def abort_write_group(self, suppress_errors=False):
 
285
    def abort_write_group(self):
714
286
        """Complete a write group on the decorated repository.
715
 
 
716
 
        Smart methods perform operations in a single step so this API
 
287
        
 
288
        Smart methods peform operations in a single step so this api
717
289
        is not really applicable except as a compatibility thunk
718
290
        for older plugins that don't use e.g. the CommitBuilder
719
291
        facility.
720
 
 
721
 
        :param suppress_errors: see Repository.abort_write_group.
722
 
        """
723
 
        self._ensure_real()
724
 
        return self._real_repository.abort_write_group(
725
 
            suppress_errors=suppress_errors)
726
 
 
727
 
    @property
728
 
    def chk_bytes(self):
729
 
        """Decorate the real repository for now.
730
 
 
731
 
        In the long term a full blown network facility is needed to avoid
732
 
        creating a real repository object locally.
733
 
        """
734
 
        self._ensure_real()
735
 
        return self._real_repository.chk_bytes
 
292
        """
 
293
        self._ensure_real()
 
294
        return self._real_repository.abort_write_group()
736
295
 
737
296
    def commit_write_group(self):
738
297
        """Complete a write group on the decorated repository.
739
 
 
740
 
        Smart methods perform operations in a single step so this API
 
298
        
 
299
        Smart methods peform operations in a single step so this api
741
300
        is not really applicable except as a compatibility thunk
742
301
        for older plugins that don't use e.g. the CommitBuilder
743
302
        facility.
745
304
        self._ensure_real()
746
305
        return self._real_repository.commit_write_group()
747
306
 
748
 
    def resume_write_group(self, tokens):
749
 
        self._ensure_real()
750
 
        return self._real_repository.resume_write_group(tokens)
751
 
 
752
 
    def suspend_write_group(self):
753
 
        self._ensure_real()
754
 
        return self._real_repository.suspend_write_group()
755
 
 
756
 
    def get_missing_parent_inventories(self, check_for_missing_texts=True):
757
 
        self._ensure_real()
758
 
        return self._real_repository.get_missing_parent_inventories(
759
 
            check_for_missing_texts=check_for_missing_texts)
760
 
 
761
 
    def _get_rev_id_for_revno_vfs(self, revno, known_pair):
762
 
        self._ensure_real()
763
 
        return self._real_repository.get_rev_id_for_revno(
764
 
            revno, known_pair)
765
 
 
766
 
    def get_rev_id_for_revno(self, revno, known_pair):
767
 
        """See Repository.get_rev_id_for_revno."""
768
 
        path = self.bzrdir._path_for_remote_call(self._client)
769
 
        try:
770
 
            if self._client._medium._is_remote_before((1, 17)):
771
 
                return self._get_rev_id_for_revno_vfs(revno, known_pair)
772
 
            response = self._call(
773
 
                'Repository.get_rev_id_for_revno', path, revno, known_pair)
774
 
        except errors.UnknownSmartMethod:
775
 
            self._client._medium._remember_remote_is_before((1, 17))
776
 
            return self._get_rev_id_for_revno_vfs(revno, known_pair)
777
 
        if response[0] == 'ok':
778
 
            return True, response[1]
779
 
        elif response[0] == 'history-incomplete':
780
 
            known_pair = response[1:3]
781
 
            for fallback in self._fallback_repositories:
782
 
                found, result = fallback.get_rev_id_for_revno(revno, known_pair)
783
 
                if found:
784
 
                    return True, result
785
 
                else:
786
 
                    known_pair = result
787
 
            # Not found in any fallbacks
788
 
            return False, known_pair
789
 
        else:
790
 
            raise errors.UnexpectedSmartServerResponse(response)
791
 
 
792
307
    def _ensure_real(self):
793
308
        """Ensure that there is a _real_repository set.
794
309
 
795
310
        Used before calls to self._real_repository.
796
 
 
797
 
        Note that _ensure_real causes many roundtrips to the server which are
798
 
        not desirable, and prevents the use of smart one-roundtrip RPC's to
799
 
        perform complex operations (such as accessing parent data, streaming
800
 
        revisions etc). Adding calls to _ensure_real should only be done when
801
 
        bringing up new functionality, adding fallbacks for smart methods that
802
 
        require a fallback path, and never to replace an existing smart method
803
 
        invocation. If in doubt chat to the bzr network team.
804
311
        """
805
 
        if self._real_repository is None:
806
 
            if 'hpssvfs' in debug.debug_flags:
807
 
                import traceback
808
 
                warning('VFS Repository access triggered\n%s',
809
 
                    ''.join(traceback.format_stack()))
810
 
            self._unstacked_provider.missing_keys.clear()
 
312
        if not self._real_repository:
811
313
            self.bzrdir._ensure_real()
812
 
            self._set_real_repository(
813
 
                self.bzrdir._real_bzrdir.open_repository())
814
 
 
815
 
    def _translate_error(self, err, **context):
816
 
        self.bzrdir._translate_error(err, repository=self, **context)
 
314
            #self._real_repository = self.bzrdir._real_bzrdir.open_repository()
 
315
            self._set_real_repository(self.bzrdir._real_bzrdir.open_repository())
817
316
 
818
317
    def find_text_key_references(self):
819
318
        """Find the text key references within the repository.
840
339
        self._ensure_real()
841
340
        return self._real_repository._generate_text_key_index()
842
341
 
843
 
    def _get_revision_graph(self, revision_id):
844
 
        """Private method for using with old (< 1.2) servers to fallback."""
 
342
    def get_revision_graph(self, revision_id=None):
 
343
        """See Repository.get_revision_graph()."""
845
344
        if revision_id is None:
846
345
            revision_id = ''
847
346
        elif revision.is_null(revision_id):
848
347
            return {}
849
348
 
850
349
        path = self.bzrdir._path_for_remote_call(self._client)
851
 
        response = self._call_expecting_body(
 
350
        assert type(revision_id) is str
 
351
        response = self._client.call_expecting_body(
852
352
            'Repository.get_revision_graph', path, revision_id)
853
 
        response_tuple, response_handler = response
854
 
        if response_tuple[0] != 'ok':
855
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
856
 
        coded = response_handler.read_body_bytes()
857
 
        if coded == '':
858
 
            # no revisions in this repository!
859
 
            return {}
860
 
        lines = coded.split('\n')
861
 
        revision_graph = {}
862
 
        for line in lines:
863
 
            d = tuple(line.split())
864
 
            revision_graph[d[0]] = d[1:]
865
 
 
866
 
        return revision_graph
867
 
 
868
 
    def _get_sink(self):
869
 
        """See Repository._get_sink()."""
870
 
        return RemoteStreamSink(self)
871
 
 
872
 
    def _get_source(self, to_format):
873
 
        """Return a source for streaming from this repository."""
874
 
        return RemoteStreamSource(self, to_format)
875
 
 
876
 
    @needs_read_lock
 
353
        if response[0][0] not in ['ok', 'nosuchrevision']:
 
354
            raise errors.UnexpectedSmartServerResponse(response[0])
 
355
        if response[0][0] == 'ok':
 
356
            coded = response[1].read_body_bytes()
 
357
            if coded == '':
 
358
                # no revisions in this repository!
 
359
                return {}
 
360
            lines = coded.split('\n')
 
361
            revision_graph = {}
 
362
            for line in lines:
 
363
                d = tuple(line.split())
 
364
                revision_graph[d[0]] = d[1:]
 
365
                
 
366
            return revision_graph
 
367
        else:
 
368
            response_body = response[1].read_body_bytes()
 
369
            assert response_body == ''
 
370
            raise NoSuchRevision(self, revision_id)
 
371
 
877
372
    def has_revision(self, revision_id):
878
 
        """True if this repository has a copy of the revision."""
879
 
        # Copy of bzrlib.repository.Repository.has_revision
880
 
        return revision_id in self.has_revisions((revision_id,))
 
373
        """See Repository.has_revision()."""
 
374
        if revision_id == NULL_REVISION:
 
375
            # The null revision is always present.
 
376
            return True
 
377
        path = self.bzrdir._path_for_remote_call(self._client)
 
378
        response = self._client.call('Repository.has_revision', path, revision_id)
 
379
        assert response[0] in ('yes', 'no'), 'unexpected response code %s' % (response,)
 
380
        return response[0] == 'yes'
881
381
 
882
 
    @needs_read_lock
883
382
    def has_revisions(self, revision_ids):
884
 
        """Probe to find out the presence of multiple revisions.
885
 
 
886
 
        :param revision_ids: An iterable of revision_ids.
887
 
        :return: A set of the revision_ids that were present.
888
 
        """
889
 
        # Copy of bzrlib.repository.Repository.has_revisions
890
 
        parent_map = self.get_parent_map(revision_ids)
891
 
        result = set(parent_map)
892
 
        if _mod_revision.NULL_REVISION in revision_ids:
893
 
            result.add(_mod_revision.NULL_REVISION)
 
383
        """See Repository.has_revisions()."""
 
384
        result = set()
 
385
        for revision_id in revision_ids:
 
386
            if self.has_revision(revision_id):
 
387
                result.add(revision_id)
894
388
        return result
895
389
 
896
 
    def _has_same_fallbacks(self, other_repo):
897
 
        """Returns true if the repositories have the same fallbacks."""
898
 
        # XXX: copied from Repository; it should be unified into a base class
899
 
        # <https://bugs.edge.launchpad.net/bzr/+bug/401622>
900
 
        my_fb = self._fallback_repositories
901
 
        other_fb = other_repo._fallback_repositories
902
 
        if len(my_fb) != len(other_fb):
903
 
            return False
904
 
        for f, g in zip(my_fb, other_fb):
905
 
            if not f.has_same_location(g):
906
 
                return False
907
 
        return True
908
 
 
909
390
    def has_same_location(self, other):
910
 
        # TODO: Move to RepositoryBase and unify with the regular Repository
911
 
        # one; unfortunately the tests rely on slightly different behaviour at
912
 
        # present -- mbp 20090710
913
 
        return (self.__class__ is other.__class__ and
 
391
        return (self.__class__ == other.__class__ and
914
392
                self.bzrdir.transport.base == other.bzrdir.transport.base)
915
 
 
 
393
        
916
394
    def get_graph(self, other_repository=None):
917
395
        """Return the graph for this repository format"""
918
 
        parents_provider = self._make_parents_provider(other_repository)
 
396
        parents_provider = self
 
397
        if (other_repository is not None and
 
398
            other_repository.bzrdir.transport.base !=
 
399
            self.bzrdir.transport.base):
 
400
            parents_provider = graph._StackedParentsProvider(
 
401
                [parents_provider, other_repository._make_parents_provider()])
919
402
        return graph.Graph(parents_provider)
920
403
 
921
 
    @needs_read_lock
922
 
    def get_known_graph_ancestry(self, revision_ids):
923
 
        """Return the known graph for a set of revision ids and their ancestors.
924
 
        """
925
 
        st = static_tuple.StaticTuple
926
 
        revision_keys = [st(r_id).intern() for r_id in revision_ids]
927
 
        known_graph = self.revisions.get_known_graph_ancestry(revision_keys)
928
 
        return graph.GraphThunkIdsToKeys(known_graph)
929
 
 
930
404
    def gather_stats(self, revid=None, committers=None):
931
405
        """See Repository.gather_stats()."""
932
406
        path = self.bzrdir._path_for_remote_call(self._client)
939
413
            fmt_committers = 'no'
940
414
        else:
941
415
            fmt_committers = 'yes'
942
 
        response_tuple, response_handler = self._call_expecting_body(
 
416
        response = self._client.call_expecting_body(
943
417
            'Repository.gather_stats', path, fmt_revid, fmt_committers)
944
 
        if response_tuple[0] != 'ok':
945
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
 
418
        assert response[0][0] == 'ok', \
 
419
            'unexpected response code %s' % (response[0],)
946
420
 
947
 
        body = response_handler.read_body_bytes()
 
421
        body = response[1].read_body_bytes()
948
422
        result = {}
949
423
        for line in body.split('\n'):
950
424
            if not line:
984
458
    def is_shared(self):
985
459
        """See Repository.is_shared()."""
986
460
        path = self.bzrdir._path_for_remote_call(self._client)
987
 
        response = self._call('Repository.is_shared', path)
988
 
        if response[0] not in ('yes', 'no'):
989
 
            raise SmartProtocolError('unexpected response code %s' % (response,))
 
461
        response = self._client.call('Repository.is_shared', path)
 
462
        assert response[0] in ('yes', 'no'), 'unexpected response code %s' % (response,)
990
463
        return response[0] == 'yes'
991
464
 
992
465
    def is_write_locked(self):
993
466
        return self._lock_mode == 'w'
994
467
 
995
 
    def _warn_if_deprecated(self, branch=None):
996
 
        # If we have a real repository, the check will be done there, if we
997
 
        # don't the check will be done remotely.
998
 
        pass
999
 
 
1000
468
    def lock_read(self):
1001
 
        """Lock the repository for read operations.
1002
 
 
1003
 
        :return: An object with an unlock method which will release the lock
1004
 
            obtained.
1005
 
        """
1006
469
        # wrong eventually - want a local lock cache context
1007
470
        if not self._lock_mode:
1008
 
            self._note_lock('r')
1009
471
            self._lock_mode = 'r'
1010
472
            self._lock_count = 1
1011
 
            self._unstacked_provider.enable_cache(cache_misses=True)
 
473
            self._parents_map = {}
1012
474
            if self._real_repository is not None:
1013
475
                self._real_repository.lock_read()
1014
 
            for repo in self._fallback_repositories:
1015
 
                repo.lock_read()
1016
476
        else:
1017
477
            self._lock_count += 1
1018
 
        return self
1019
478
 
1020
479
    def _remote_lock_write(self, token):
1021
480
        path = self.bzrdir._path_for_remote_call(self._client)
1022
481
        if token is None:
1023
482
            token = ''
1024
 
        err_context = {'token': token}
1025
 
        response = self._call('Repository.lock_write', path, token,
1026
 
                              **err_context)
 
483
        response = self._client.call('Repository.lock_write', path, token)
1027
484
        if response[0] == 'ok':
1028
485
            ok, token = response
1029
486
            return token
 
487
        elif response[0] == 'LockContention':
 
488
            raise errors.LockContention('(remote lock)')
 
489
        elif response[0] == 'UnlockableTransport':
 
490
            raise errors.UnlockableTransport(self.bzrdir.root_transport)
 
491
        elif response[0] == 'LockFailed':
 
492
            raise errors.LockFailed(response[1], response[2])
1030
493
        else:
1031
494
            raise errors.UnexpectedSmartServerResponse(response)
1032
495
 
1033
 
    def lock_write(self, token=None, _skip_rpc=False):
 
496
    def lock_write(self, token=None):
1034
497
        if not self._lock_mode:
1035
 
            self._note_lock('w')
1036
 
            if _skip_rpc:
1037
 
                if self._lock_token is not None:
1038
 
                    if token != self._lock_token:
1039
 
                        raise errors.TokenMismatch(token, self._lock_token)
1040
 
                self._lock_token = token
1041
 
            else:
1042
 
                self._lock_token = self._remote_lock_write(token)
 
498
            self._lock_token = self._remote_lock_write(token)
1043
499
            # if self._lock_token is None, then this is something like packs or
1044
500
            # svn where we don't get to lock the repo, or a weave style repository
1045
501
            # where we cannot lock it over the wire and attempts to do so will
1052
508
                self._leave_lock = False
1053
509
            self._lock_mode = 'w'
1054
510
            self._lock_count = 1
1055
 
            cache_misses = self._real_repository is None
1056
 
            self._unstacked_provider.enable_cache(cache_misses=cache_misses)
1057
 
            for repo in self._fallback_repositories:
1058
 
                # Writes don't affect fallback repos
1059
 
                repo.lock_read()
 
511
            self._parents_map = {}
1060
512
        elif self._lock_mode == 'r':
1061
513
            raise errors.ReadOnlyError(self)
1062
514
        else:
1063
515
            self._lock_count += 1
1064
 
        return RepositoryWriteLockResult(self.unlock, self._lock_token or None)
 
516
        return self._lock_token or None
1065
517
 
1066
518
    def leave_lock_in_place(self):
1067
519
        if not self._lock_token:
1079
531
        :param repository: The repository to fallback to for non-hpss
1080
532
            implemented operations.
1081
533
        """
1082
 
        if self._real_repository is not None:
1083
 
            # Replacing an already set real repository.
1084
 
            # We cannot do this [currently] if the repository is locked -
1085
 
            # synchronised state might be lost.
1086
 
            if self.is_locked():
1087
 
                raise AssertionError('_real_repository is already set')
1088
 
        if isinstance(repository, RemoteRepository):
1089
 
            raise AssertionError()
 
534
        assert not isinstance(repository, RemoteRepository)
1090
535
        self._real_repository = repository
1091
 
        # three code paths happen here:
1092
 
        # 1) old servers, RemoteBranch.open() calls _ensure_real before setting
1093
 
        # up stacking. In this case self._fallback_repositories is [], and the
1094
 
        # real repo is already setup. Preserve the real repo and
1095
 
        # RemoteRepository.add_fallback_repository will avoid adding
1096
 
        # duplicates.
1097
 
        # 2) new servers, RemoteBranch.open() sets up stacking, and when
1098
 
        # ensure_real is triggered from a branch, the real repository to
1099
 
        # set already has a matching list with separate instances, but
1100
 
        # as they are also RemoteRepositories we don't worry about making the
1101
 
        # lists be identical.
1102
 
        # 3) new servers, RemoteRepository.ensure_real is triggered before
1103
 
        # RemoteBranch.ensure real, in this case we get a repo with no fallbacks
1104
 
        # and need to populate it.
1105
 
        if (self._fallback_repositories and
1106
 
            len(self._real_repository._fallback_repositories) !=
1107
 
            len(self._fallback_repositories)):
1108
 
            if len(self._real_repository._fallback_repositories):
1109
 
                raise AssertionError(
1110
 
                    "cannot cleanly remove existing _fallback_repositories")
1111
 
        for fb in self._fallback_repositories:
1112
 
            self._real_repository.add_fallback_repository(fb)
1113
536
        if self._lock_mode == 'w':
1114
537
            # if we are already locked, the real repository must be able to
1115
538
            # acquire the lock with our token.
1119
542
 
1120
543
    def start_write_group(self):
1121
544
        """Start a write group on the decorated repository.
1122
 
 
1123
 
        Smart methods perform operations in a single step so this API
 
545
        
 
546
        Smart methods peform operations in a single step so this api
1124
547
        is not really applicable except as a compatibility thunk
1125
548
        for older plugins that don't use e.g. the CommitBuilder
1126
549
        facility.
1133
556
        if not token:
1134
557
            # with no token the remote repository is not persistently locked.
1135
558
            return
1136
 
        err_context = {'token': token}
1137
 
        response = self._call('Repository.unlock', path, token,
1138
 
                              **err_context)
 
559
        response = self._client.call('Repository.unlock', path, token)
1139
560
        if response == ('ok',):
1140
561
            return
 
562
        elif response[0] == 'TokenMismatch':
 
563
            raise errors.TokenMismatch(token, '(remote token)')
1141
564
        else:
1142
565
            raise errors.UnexpectedSmartServerResponse(response)
1143
566
 
1144
 
    @only_raises(errors.LockNotHeld, errors.LockBroken)
1145
567
    def unlock(self):
1146
 
        if not self._lock_count:
1147
 
            return lock.cant_unlock_not_held(self)
1148
568
        self._lock_count -= 1
1149
569
        if self._lock_count > 0:
1150
570
            return
1151
 
        self._unstacked_provider.disable_cache()
 
571
        self._parents_map = None
1152
572
        old_mode = self._lock_mode
1153
573
        self._lock_mode = None
1154
574
        try:
1164
584
            # problem releasing the vfs-based lock.
1165
585
            if old_mode == 'w':
1166
586
                # Only write-locked repositories need to make a remote method
1167
 
                # call to perform the unlock.
 
587
                # call to perfom the unlock.
1168
588
                old_token = self._lock_token
1169
589
                self._lock_token = None
1170
590
                if not self._leave_lock:
1171
591
                    self._unlock(old_token)
1172
 
        # Fallbacks are always 'lock_read()' so we don't pay attention to
1173
 
        # self._leave_lock
1174
 
        for repo in self._fallback_repositories:
1175
 
            repo.unlock()
1176
592
 
1177
593
    def break_lock(self):
1178
594
        # should hand off to the network
1181
597
 
1182
598
    def _get_tarball(self, compression):
1183
599
        """Return a TemporaryFile containing a repository tarball.
1184
 
 
 
600
        
1185
601
        Returns None if the server does not support sending tarballs.
1186
602
        """
1187
603
        import tempfile
1188
604
        path = self.bzrdir._path_for_remote_call(self._client)
1189
 
        try:
1190
 
            response, protocol = self._call_expecting_body(
1191
 
                'Repository.tarball', path, compression)
1192
 
        except errors.UnknownSmartMethod:
1193
 
            protocol.cancel_read_body()
1194
 
            return None
 
605
        response, protocol = self._client.call_expecting_body(
 
606
            'Repository.tarball', path, compression)
1195
607
        if response[0] == 'ok':
1196
608
            # Extract the tarball and return it
1197
609
            t = tempfile.NamedTemporaryFile()
1199
611
            t.write(protocol.read_body_bytes())
1200
612
            t.seek(0)
1201
613
            return t
 
614
        if (response == ('error', "Generic bzr smart protocol error: "
 
615
                "bad request 'Repository.tarball'") or
 
616
              response == ('error', "Generic bzr smart protocol error: "
 
617
                "bad request u'Repository.tarball'")):
 
618
            protocol.cancel_read_body()
 
619
            return None
1202
620
        raise errors.UnexpectedSmartServerResponse(response)
1203
621
 
1204
622
    def sprout(self, to_bzrdir, revision_id=None):
1225
643
        # FIXME: It ought to be possible to call this without immediately
1226
644
        # triggering _ensure_real.  For now it's the easiest thing to do.
1227
645
        self._ensure_real()
1228
 
        real_repo = self._real_repository
1229
 
        builder = real_repo.get_commit_builder(branch, parents,
 
646
        builder = self._real_repository.get_commit_builder(branch, parents,
1230
647
                config, timestamp=timestamp, timezone=timezone,
1231
648
                committer=committer, revprops=revprops, revision_id=revision_id)
1232
649
        return builder
1233
650
 
1234
 
    def add_fallback_repository(self, repository):
1235
 
        """Add a repository to use for looking up data not held locally.
1236
 
 
1237
 
        :param repository: A repository.
1238
 
        """
1239
 
        if not self._format.supports_external_lookups:
1240
 
            raise errors.UnstackableRepositoryFormat(
1241
 
                self._format.network_name(), self.base)
1242
 
        # We need to accumulate additional repositories here, to pass them in
1243
 
        # on various RPC's.
1244
 
        #
1245
 
        if self.is_locked():
1246
 
            # We will call fallback.unlock() when we transition to the unlocked
1247
 
            # state, so always add a lock here. If a caller passes us a locked
1248
 
            # repository, they are responsible for unlocking it later.
1249
 
            repository.lock_read()
1250
 
        self._check_fallback_repository(repository)
1251
 
        self._fallback_repositories.append(repository)
1252
 
        # If self._real_repository was parameterised already (e.g. because a
1253
 
        # _real_branch had its get_stacked_on_url method called), then the
1254
 
        # repository to be added may already be in the _real_repositories list.
1255
 
        if self._real_repository is not None:
1256
 
            fallback_locations = [repo.user_url for repo in
1257
 
                self._real_repository._fallback_repositories]
1258
 
            if repository.user_url not in fallback_locations:
1259
 
                self._real_repository.add_fallback_repository(repository)
1260
 
 
1261
 
    def _check_fallback_repository(self, repository):
1262
 
        """Check that this repository can fallback to repository safely.
1263
 
 
1264
 
        Raise an error if not.
1265
 
 
1266
 
        :param repository: A repository to fallback to.
1267
 
        """
1268
 
        return _mod_repository.InterRepository._assert_same_model(
1269
 
            self, repository)
1270
 
 
 
651
    @needs_write_lock
1271
652
    def add_inventory(self, revid, inv, parents):
1272
653
        self._ensure_real()
1273
654
        return self._real_repository.add_inventory(revid, inv, parents)
1274
655
 
1275
 
    def add_inventory_by_delta(self, basis_revision_id, delta, new_revision_id,
1276
 
            parents, basis_inv=None, propagate_caches=False):
1277
 
        self._ensure_real()
1278
 
        return self._real_repository.add_inventory_by_delta(basis_revision_id,
1279
 
            delta, new_revision_id, parents, basis_inv=basis_inv,
1280
 
            propagate_caches=propagate_caches)
1281
 
 
 
656
    @needs_write_lock
1282
657
    def add_revision(self, rev_id, rev, inv=None, config=None):
1283
658
        self._ensure_real()
1284
659
        return self._real_repository.add_revision(
1289
664
        self._ensure_real()
1290
665
        return self._real_repository.get_inventory(revision_id)
1291
666
 
1292
 
    def iter_inventories(self, revision_ids, ordering=None):
 
667
    def iter_inventories(self, revision_ids):
1293
668
        self._ensure_real()
1294
 
        return self._real_repository.iter_inventories(revision_ids, ordering)
 
669
        return self._real_repository.iter_inventories(revision_ids)
1295
670
 
1296
671
    @needs_read_lock
1297
672
    def get_revision(self, revision_id):
1298
673
        self._ensure_real()
1299
674
        return self._real_repository.get_revision(revision_id)
1300
675
 
 
676
    @property
 
677
    def weave_store(self):
 
678
        self._ensure_real()
 
679
        return self._real_repository.weave_store
 
680
 
1301
681
    def get_transaction(self):
1302
682
        self._ensure_real()
1303
683
        return self._real_repository.get_transaction()
1308
688
        return self._real_repository.clone(a_bzrdir, revision_id=revision_id)
1309
689
 
1310
690
    def make_working_trees(self):
1311
 
        """See Repository.make_working_trees"""
1312
 
        self._ensure_real()
1313
 
        return self._real_repository.make_working_trees()
1314
 
 
1315
 
    def refresh_data(self):
1316
 
        """Re-read any data needed to to synchronise with disk.
1317
 
 
1318
 
        This method is intended to be called after another repository instance
1319
 
        (such as one used by a smart server) has inserted data into the
1320
 
        repository. It may not be called during a write group, but may be
1321
 
        called at any other time.
1322
 
        """
1323
 
        if self.is_in_write_group():
1324
 
            raise errors.InternalBzrError(
1325
 
                "May not refresh_data while in a write group.")
1326
 
        if self._real_repository is not None:
1327
 
            self._real_repository.refresh_data()
 
691
        """RemoteRepositories never create working trees by default."""
 
692
        return False
1328
693
 
1329
694
    def revision_ids_to_search_result(self, result_set):
1330
695
        """Convert a set of revision ids to a graph SearchResult."""
1342
707
    @needs_read_lock
1343
708
    def search_missing_revision_ids(self, other, revision_id=None, find_ghosts=True):
1344
709
        """Return the revision ids that other has that this does not.
1345
 
 
 
710
        
1346
711
        These are returned in topological order.
1347
712
 
1348
713
        revision_id: only return revision ids included by revision_id.
1350
715
        return repository.InterRepository.get(
1351
716
            other, self).search_missing_revision_ids(revision_id, find_ghosts)
1352
717
 
1353
 
    def fetch(self, source, revision_id=None, pb=None, find_ghosts=False,
1354
 
            fetch_spec=None):
1355
 
        # No base implementation to use as RemoteRepository is not a subclass
1356
 
        # of Repository; so this is a copy of Repository.fetch().
1357
 
        if fetch_spec is not None and revision_id is not None:
1358
 
            raise AssertionError(
1359
 
                "fetch_spec and revision_id are mutually exclusive.")
1360
 
        if self.is_in_write_group():
1361
 
            raise errors.InternalBzrError(
1362
 
                "May not fetch while in a write group.")
1363
 
        # fast path same-url fetch operations
1364
 
        if (self.has_same_location(source)
1365
 
            and fetch_spec is None
1366
 
            and self._has_same_fallbacks(source)):
 
718
    def fetch(self, source, revision_id=None, pb=None):
 
719
        if self.has_same_location(source):
1367
720
            # check that last_revision is in 'from' and then return a
1368
721
            # no-operation.
1369
722
            if (revision_id is not None and
1370
723
                not revision.is_null(revision_id)):
1371
724
                self.get_revision(revision_id)
1372
725
            return 0, []
1373
 
        # if there is no specific appropriate InterRepository, this will get
1374
 
        # the InterRepository base class, which raises an
1375
 
        # IncompatibleRepositories when asked to fetch.
1376
 
        inter = repository.InterRepository.get(source, self)
1377
 
        return inter.fetch(revision_id=revision_id, pb=pb,
1378
 
            find_ghosts=find_ghosts, fetch_spec=fetch_spec)
 
726
        self._ensure_real()
 
727
        return self._real_repository.fetch(
 
728
            source, revision_id=revision_id, pb=pb)
1379
729
 
1380
730
    def create_bundle(self, target, base, fileobj, format=None):
1381
731
        self._ensure_real()
1382
732
        self._real_repository.create_bundle(target, base, fileobj, format)
1383
733
 
 
734
    @property
 
735
    def control_weaves(self):
 
736
        self._ensure_real()
 
737
        return self._real_repository.control_weaves
 
738
 
1384
739
    @needs_read_lock
1385
740
    def get_ancestry(self, revision_id, topo_sorted=True):
1386
741
        self._ensure_real()
1387
742
        return self._real_repository.get_ancestry(revision_id, topo_sorted)
1388
743
 
 
744
    @needs_read_lock
 
745
    def get_inventory_weave(self):
 
746
        self._ensure_real()
 
747
        return self._real_repository.get_inventory_weave()
 
748
 
1389
749
    def fileids_altered_by_revision_ids(self, revision_ids):
1390
750
        self._ensure_real()
1391
751
        return self._real_repository.fileids_altered_by_revision_ids(revision_ids)
1394
754
        self._ensure_real()
1395
755
        return self._real_repository._get_versioned_file_checker(
1396
756
            revisions, revision_versions_cache)
1397
 
 
 
757
        
1398
758
    def iter_files_bytes(self, desired_files):
1399
759
        """See Repository.iter_file_bytes.
1400
760
        """
1401
761
        self._ensure_real()
1402
762
        return self._real_repository.iter_files_bytes(desired_files)
1403
763
 
1404
 
    def get_parent_map(self, revision_ids):
 
764
    def get_parent_map(self, keys):
1405
765
        """See bzrlib.Graph.get_parent_map()."""
1406
 
        return self._make_parents_provider().get_parent_map(revision_ids)
1407
 
 
1408
 
    def _get_parent_map_rpc(self, keys):
 
766
        # Hack to build up the caching logic.
 
767
        ancestry = self._parents_map
 
768
        missing_revisions = set(key for key in keys if key not in ancestry)
 
769
        if missing_revisions:
 
770
            self._parents_map.update(self._get_parent_map(missing_revisions))
 
771
        return dict((k, ancestry[k]) for k in keys if k in ancestry)
 
772
 
 
773
    def _response_is_unknown_method(self, response, verb):
 
774
        """Return True if response is an unknonwn method response to verb.
 
775
        
 
776
        :param response: The response from a smart client call_expecting_body
 
777
            call.
 
778
        :param verb: The verb used in that call.
 
779
        :return: True if an unknown method was encountered.
 
780
        """
 
781
        # This might live better on
 
782
        # bzrlib.smart.protocol.SmartClientRequestProtocolOne
 
783
        if (response[0] == ('error', "Generic bzr smart protocol error: "
 
784
                "bad request '%s'" % verb) or
 
785
              response[0] == ('error', "Generic bzr smart protocol error: "
 
786
                "bad request u'%s'" % verb)):
 
787
           response[1].cancel_read_body()
 
788
           return True
 
789
        return False
 
790
 
 
791
    def _get_parent_map(self, keys):
1409
792
        """Helper for get_parent_map that performs the RPC."""
1410
 
        medium = self._client._medium
1411
 
        if medium._is_remote_before((1, 2)):
1412
 
            # We already found out that the server can't understand
1413
 
            # Repository.get_parent_map requests, so just fetch the whole
1414
 
            # graph.
1415
 
            #
1416
 
            # Note that this reads the whole graph, when only some keys are
1417
 
            # wanted.  On this old server there's no way (?) to get them all
1418
 
            # in one go, and the user probably will have seen a warning about
1419
 
            # the server being old anyhow.
1420
 
            rg = self._get_revision_graph(None)
1421
 
            # There is an API discrepancy between get_parent_map and
1422
 
            # get_revision_graph. Specifically, a "key:()" pair in
1423
 
            # get_revision_graph just means a node has no parents. For
1424
 
            # "get_parent_map" it means the node is a ghost. So fix up the
1425
 
            # graph to correct this.
1426
 
            #   https://bugs.launchpad.net/bzr/+bug/214894
1427
 
            # There is one other "bug" which is that ghosts in
1428
 
            # get_revision_graph() are not returned at all. But we won't worry
1429
 
            # about that for now.
1430
 
            for node_id, parent_ids in rg.iteritems():
1431
 
                if parent_ids == ():
1432
 
                    rg[node_id] = (NULL_REVISION,)
1433
 
            rg[NULL_REVISION] = ()
1434
 
            return rg
1435
 
 
1436
793
        keys = set(keys)
1437
 
        if None in keys:
1438
 
            raise ValueError('get_parent_map(None) is not valid')
1439
794
        if NULL_REVISION in keys:
1440
795
            keys.discard(NULL_REVISION)
1441
796
            found_parents = {NULL_REVISION:()}
1443
798
                return found_parents
1444
799
        else:
1445
800
            found_parents = {}
1446
 
        # TODO(Needs analysis): We could assume that the keys being requested
1447
 
        # from get_parent_map are in a breadth first search, so typically they
1448
 
        # will all be depth N from some common parent, and we don't have to
1449
 
        # have the server iterate from the root parent, but rather from the
1450
 
        # keys we're searching; and just tell the server the keyspace we
1451
 
        # already have; but this may be more traffic again.
1452
 
 
1453
 
        # Transform self._parents_map into a search request recipe.
1454
 
        # TODO: Manage this incrementally to avoid covering the same path
1455
 
        # repeatedly. (The server will have to on each request, but the less
1456
 
        # work done the better).
1457
 
        #
1458
 
        # Negative caching notes:
1459
 
        # new server sends missing when a request including the revid
1460
 
        # 'include-missing:' is present in the request.
1461
 
        # missing keys are serialised as missing:X, and we then call
1462
 
        # provider.note_missing(X) for-all X
1463
 
        parents_map = self._unstacked_provider.get_cached_map()
1464
 
        if parents_map is None:
1465
 
            # Repository is not locked, so there's no cache.
1466
 
            parents_map = {}
1467
 
        # start_set is all the keys in the cache
1468
 
        start_set = set(parents_map)
1469
 
        # result set is all the references to keys in the cache
1470
 
        result_parents = set()
1471
 
        for parents in parents_map.itervalues():
1472
 
            result_parents.update(parents)
1473
 
        stop_keys = result_parents.difference(start_set)
1474
 
        # We don't need to send ghosts back to the server as a position to
1475
 
        # stop either.
1476
 
        stop_keys.difference_update(self._unstacked_provider.missing_keys)
1477
 
        key_count = len(parents_map)
1478
 
        if (NULL_REVISION in result_parents
1479
 
            and NULL_REVISION in self._unstacked_provider.missing_keys):
1480
 
            # If we pruned NULL_REVISION from the stop_keys because it's also
1481
 
            # in our cache of "missing" keys we need to increment our key count
1482
 
            # by 1, because the reconsitituted SearchResult on the server will
1483
 
            # still consider NULL_REVISION to be an included key.
1484
 
            key_count += 1
1485
 
        included_keys = start_set.intersection(result_parents)
1486
 
        start_set.difference_update(included_keys)
1487
 
        recipe = ('manual', start_set, stop_keys, key_count)
1488
 
        body = self._serialise_search_recipe(recipe)
1489
801
        path = self.bzrdir._path_for_remote_call(self._client)
1490
802
        for key in keys:
1491
 
            if type(key) is not str:
1492
 
                raise ValueError(
1493
 
                    "key %r not a plain string" % (key,))
 
803
            assert type(key) is str
1494
804
        verb = 'Repository.get_parent_map'
1495
 
        args = (path, 'include-missing:') + tuple(keys)
1496
 
        try:
1497
 
            response = self._call_with_body_bytes_expecting_body(
1498
 
                verb, args, body)
1499
 
        except errors.UnknownSmartMethod:
1500
 
            # Server does not support this method, so get the whole graph.
1501
 
            # Worse, we have to force a disconnection, because the server now
1502
 
            # doesn't realise it has a body on the wire to consume, so the
1503
 
            # only way to recover is to abandon the connection.
1504
 
            warning(
1505
 
                'Server is too old for fast get_parent_map, reconnecting.  '
1506
 
                '(Upgrade the server to Bazaar 1.2 to avoid this)')
1507
 
            medium.disconnect()
1508
 
            # To avoid having to disconnect repeatedly, we keep track of the
1509
 
            # fact the server doesn't understand remote methods added in 1.2.
1510
 
            medium._remember_remote_is_before((1, 2))
1511
 
            # Recurse just once and we should use the fallback code.
1512
 
            return self._get_parent_map_rpc(keys)
1513
 
        response_tuple, response_handler = response
1514
 
        if response_tuple[0] not in ['ok']:
1515
 
            response_handler.cancel_read_body()
1516
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
1517
 
        if response_tuple[0] == 'ok':
1518
 
            coded = bz2.decompress(response_handler.read_body_bytes())
 
805
        response = self._client.call_expecting_body(
 
806
            verb, path, *keys)
 
807
        if self._response_is_unknown_method(response, verb):
 
808
            # Server that does not support this method, get the whole graph.
 
809
            response = self._client.call_expecting_body(
 
810
                'Repository.get_revision_graph', path, '')
 
811
            if response[0][0] not in ['ok', 'nosuchrevision']:
 
812
                reponse[1].cancel_read_body()
 
813
                raise errors.UnexpectedSmartServerResponse(response[0])
 
814
        elif response[0][0] not in ['ok']:
 
815
            reponse[1].cancel_read_body()
 
816
            raise errors.UnexpectedSmartServerResponse(response[0])
 
817
        if response[0][0] == 'ok':
 
818
            coded = response[1].read_body_bytes()
1519
819
            if coded == '':
1520
820
                # no revisions found
1521
821
                return {}
1526
826
                if len(d) > 1:
1527
827
                    revision_graph[d[0]] = d[1:]
1528
828
                else:
1529
 
                    # No parents:
1530
 
                    if d[0].startswith('missing:'):
1531
 
                        revid = d[0][8:]
1532
 
                        self._unstacked_provider.note_missing_key(revid)
1533
 
                    else:
1534
 
                        # no parents - so give the Graph result
1535
 
                        # (NULL_REVISION,).
1536
 
                        revision_graph[d[0]] = (NULL_REVISION,)
 
829
                    # No parents - so give the Graph result (NULL_REVISION,).
 
830
                    revision_graph[d[0]] = (NULL_REVISION,)
1537
831
            return revision_graph
1538
832
 
1539
833
    @needs_read_lock
1542
836
        return self._real_repository.get_signature_text(revision_id)
1543
837
 
1544
838
    @needs_read_lock
1545
 
    def _get_inventory_xml(self, revision_id):
1546
 
        self._ensure_real()
1547
 
        return self._real_repository._get_inventory_xml(revision_id)
 
839
    def get_revision_graph_with_ghosts(self, revision_ids=None):
 
840
        self._ensure_real()
 
841
        return self._real_repository.get_revision_graph_with_ghosts(
 
842
            revision_ids=revision_ids)
 
843
 
 
844
    @needs_read_lock
 
845
    def get_inventory_xml(self, revision_id):
 
846
        self._ensure_real()
 
847
        return self._real_repository.get_inventory_xml(revision_id)
 
848
 
 
849
    def deserialise_inventory(self, revision_id, xml):
 
850
        self._ensure_real()
 
851
        return self._real_repository.deserialise_inventory(revision_id, xml)
1548
852
 
1549
853
    def reconcile(self, other=None, thorough=False):
1550
854
        self._ensure_real()
1551
855
        return self._real_repository.reconcile(other=other, thorough=thorough)
1552
 
 
 
856
        
1553
857
    def all_revision_ids(self):
1554
858
        self._ensure_real()
1555
859
        return self._real_repository.all_revision_ids()
1556
 
 
1557
 
    @needs_read_lock
1558
 
    def get_deltas_for_revisions(self, revisions, specific_fileids=None):
1559
 
        self._ensure_real()
1560
 
        return self._real_repository.get_deltas_for_revisions(revisions,
1561
 
            specific_fileids=specific_fileids)
1562
 
 
1563
 
    @needs_read_lock
1564
 
    def get_revision_delta(self, revision_id, specific_fileids=None):
1565
 
        self._ensure_real()
1566
 
        return self._real_repository.get_revision_delta(revision_id,
1567
 
            specific_fileids=specific_fileids)
 
860
    
 
861
    @needs_read_lock
 
862
    def get_deltas_for_revisions(self, revisions):
 
863
        self._ensure_real()
 
864
        return self._real_repository.get_deltas_for_revisions(revisions)
 
865
 
 
866
    @needs_read_lock
 
867
    def get_revision_delta(self, revision_id):
 
868
        self._ensure_real()
 
869
        return self._real_repository.get_revision_delta(revision_id)
1568
870
 
1569
871
    @needs_read_lock
1570
872
    def revision_trees(self, revision_ids):
1577
879
        return self._real_repository.get_revision_reconcile(revision_id)
1578
880
 
1579
881
    @needs_read_lock
1580
 
    def check(self, revision_ids=None, callback_refs=None, check_repo=True):
 
882
    def check(self, revision_ids=None):
1581
883
        self._ensure_real()
1582
 
        return self._real_repository.check(revision_ids=revision_ids,
1583
 
            callback_refs=callback_refs, check_repo=check_repo)
 
884
        return self._real_repository.check(revision_ids=revision_ids)
1584
885
 
1585
886
    def copy_content_into(self, destination, revision_id=None):
1586
887
        self._ensure_real()
1592
893
        # destination
1593
894
        from bzrlib import osutils
1594
895
        import tarfile
 
896
        import tempfile
1595
897
        # TODO: Maybe a progress bar while streaming the tarball?
1596
898
        note("Copying repository content as tarball...")
1597
899
        tar_file = self._get_tarball('bz2')
1601
903
        try:
1602
904
            tar = tarfile.open('repository', fileobj=tar_file,
1603
905
                mode='r|bz2')
1604
 
            tmpdir = osutils.mkdtemp()
 
906
            tmpdir = tempfile.mkdtemp()
1605
907
            try:
1606
908
                _extract_tar(tar, tmpdir)
1607
909
                tmp_bzrdir = BzrDir.open(tmpdir)
1615
917
        # TODO: Suggestion from john: using external tar is much faster than
1616
918
        # python's tarfile library, but it may not work on windows.
1617
919
 
1618
 
    @property
1619
 
    def inventories(self):
1620
 
        """Decorate the real repository for now.
1621
 
 
1622
 
        In the long term a full blown network facility is needed to
1623
 
        avoid creating a real repository object locally.
1624
 
        """
1625
 
        self._ensure_real()
1626
 
        return self._real_repository.inventories
1627
 
 
1628
920
    @needs_write_lock
1629
 
    def pack(self, hint=None, clean_obsolete_packs=False):
 
921
    def pack(self):
1630
922
        """Compress the data within the repository.
1631
923
 
1632
924
        This is not currently implemented within the smart server.
1633
925
        """
1634
926
        self._ensure_real()
1635
 
        return self._real_repository.pack(hint=hint, clean_obsolete_packs=clean_obsolete_packs)
1636
 
 
1637
 
    @property
1638
 
    def revisions(self):
1639
 
        """Decorate the real repository for now.
1640
 
 
1641
 
        In the short term this should become a real object to intercept graph
1642
 
        lookups.
1643
 
 
1644
 
        In the long term a full blown network facility is needed.
1645
 
        """
1646
 
        self._ensure_real()
1647
 
        return self._real_repository.revisions
 
927
        return self._real_repository.pack()
1648
928
 
1649
929
    def set_make_working_trees(self, new_value):
1650
 
        if new_value:
1651
 
            new_value_str = "True"
1652
 
        else:
1653
 
            new_value_str = "False"
1654
 
        path = self.bzrdir._path_for_remote_call(self._client)
1655
 
        try:
1656
 
            response = self._call(
1657
 
                'Repository.set_make_working_trees', path, new_value_str)
1658
 
        except errors.UnknownSmartMethod:
1659
 
            self._ensure_real()
1660
 
            self._real_repository.set_make_working_trees(new_value)
1661
 
        else:
1662
 
            if response[0] != 'ok':
1663
 
                raise errors.UnexpectedSmartServerResponse(response)
1664
 
 
1665
 
    @property
1666
 
    def signatures(self):
1667
 
        """Decorate the real repository for now.
1668
 
 
1669
 
        In the long term a full blown network facility is needed to avoid
1670
 
        creating a real repository object locally.
1671
 
        """
1672
 
        self._ensure_real()
1673
 
        return self._real_repository.signatures
 
930
        raise NotImplementedError(self.set_make_working_trees)
1674
931
 
1675
932
    @needs_write_lock
1676
933
    def sign_revision(self, revision_id, gpg_strategy):
1677
934
        self._ensure_real()
1678
935
        return self._real_repository.sign_revision(revision_id, gpg_strategy)
1679
936
 
1680
 
    @property
1681
 
    def texts(self):
1682
 
        """Decorate the real repository for now.
1683
 
 
1684
 
        In the long term a full blown network facility is needed to avoid
1685
 
        creating a real repository object locally.
1686
 
        """
1687
 
        self._ensure_real()
1688
 
        return self._real_repository.texts
1689
 
 
1690
937
    @needs_read_lock
1691
938
    def get_revisions(self, revision_ids):
1692
939
        self._ensure_real()
1693
940
        return self._real_repository.get_revisions(revision_ids)
1694
941
 
1695
942
    def supports_rich_root(self):
1696
 
        return self._format.rich_root_data
 
943
        self._ensure_real()
 
944
        return self._real_repository.supports_rich_root()
1697
945
 
1698
946
    def iter_reverse_revision_history(self, revision_id):
1699
947
        self._ensure_real()
1701
949
 
1702
950
    @property
1703
951
    def _serializer(self):
1704
 
        return self._format._serializer
 
952
        self._ensure_real()
 
953
        return self._real_repository._serializer
1705
954
 
1706
955
    def store_revision_signature(self, gpg_strategy, plaintext, revision_id):
1707
956
        self._ensure_real()
1716
965
        self._ensure_real()
1717
966
        return self._real_repository.has_signature_for_revision_id(revision_id)
1718
967
 
 
968
    def get_data_stream_for_search(self, search):
 
969
        revision_ids = search.get_keys()
 
970
        REQUEST_NAME = 'Repository.stream_revisions_chunked'
 
971
        path = self.bzrdir._path_for_remote_call(self._client)
 
972
        response, protocol = self._client.call_expecting_body(
 
973
            REQUEST_NAME, path, *revision_ids)
 
974
 
 
975
        if response == ('ok',):
 
976
            return self._deserialise_stream(protocol)
 
977
        elif (response == ('error', "Generic bzr smart protocol error: "
 
978
                "bad request '%s'" % REQUEST_NAME) or
 
979
              response == ('error', "Generic bzr smart protocol error: "
 
980
                "bad request u'%s'" % REQUEST_NAME)):
 
981
            protocol.cancel_read_body()
 
982
            self._ensure_real()
 
983
            return self._real_repository.get_data_stream_for_search(search)
 
984
        else:
 
985
            raise errors.UnexpectedSmartServerResponse(response)
 
986
 
 
987
    def _deserialise_stream(self, protocol):
 
988
        stream = protocol.read_streamed_body()
 
989
        container_parser = ContainerPushParser()
 
990
        for bytes in stream:
 
991
            container_parser.accept_bytes(bytes)
 
992
            records = container_parser.read_pending_records()
 
993
            for record_names, record_bytes in records:
 
994
                if len(record_names) != 1:
 
995
                    # These records should have only one name, and that name
 
996
                    # should be a one-element tuple.
 
997
                    raise errors.SmartProtocolError(
 
998
                        'Repository data stream had invalid record name %r'
 
999
                        % (record_names,))
 
1000
                name_tuple = record_names[0]
 
1001
                yield name_tuple, record_bytes
 
1002
 
 
1003
    def insert_data_stream(self, stream):
 
1004
        self._ensure_real()
 
1005
        self._real_repository.insert_data_stream(stream)
 
1006
 
1719
1007
    def item_keys_introduced_by(self, revision_ids, _files_pb=None):
1720
1008
        self._ensure_real()
1721
1009
        return self._real_repository.item_keys_introduced_by(revision_ids,
1726
1014
        self._ensure_real()
1727
1015
        return self._real_repository.revision_graph_can_have_wrong_parents()
1728
1016
 
1729
 
    def _find_inconsistent_revision_parents(self, revisions_iterator=None):
 
1017
    def _find_inconsistent_revision_parents(self):
1730
1018
        self._ensure_real()
1731
 
        return self._real_repository._find_inconsistent_revision_parents(
1732
 
            revisions_iterator)
 
1019
        return self._real_repository._find_inconsistent_revision_parents()
1733
1020
 
1734
1021
    def _check_for_inconsistent_revision_parents(self):
1735
1022
        self._ensure_real()
1736
1023
        return self._real_repository._check_for_inconsistent_revision_parents()
1737
1024
 
1738
 
    def _make_parents_provider(self, other=None):
1739
 
        providers = [self._unstacked_provider]
1740
 
        if other is not None:
1741
 
            providers.insert(0, other)
1742
 
        providers.extend(r._make_parents_provider() for r in
1743
 
                         self._fallback_repositories)
1744
 
        return graph.StackedParentsProvider(providers)
1745
 
 
1746
 
    def _serialise_search_recipe(self, recipe):
1747
 
        """Serialise a graph search recipe.
1748
 
 
1749
 
        :param recipe: A search recipe (start, stop, count).
1750
 
        :return: Serialised bytes.
1751
 
        """
1752
 
        start_keys = ' '.join(recipe[1])
1753
 
        stop_keys = ' '.join(recipe[2])
1754
 
        count = str(recipe[3])
1755
 
        return '\n'.join((start_keys, stop_keys, count))
1756
 
 
1757
 
    def _serialise_search_result(self, search_result):
1758
 
        if isinstance(search_result, graph.PendingAncestryResult):
1759
 
            parts = ['ancestry-of']
1760
 
            parts.extend(search_result.heads)
1761
 
        else:
1762
 
            recipe = search_result.get_recipe()
1763
 
            parts = [recipe[0], self._serialise_search_recipe(recipe)]
1764
 
        return '\n'.join(parts)
1765
 
 
1766
 
    def autopack(self):
1767
 
        path = self.bzrdir._path_for_remote_call(self._client)
1768
 
        try:
1769
 
            response = self._call('PackRepository.autopack', path)
1770
 
        except errors.UnknownSmartMethod:
1771
 
            self._ensure_real()
1772
 
            self._real_repository._pack_collection.autopack()
1773
 
            return
1774
 
        self.refresh_data()
1775
 
        if response[0] != 'ok':
1776
 
            raise errors.UnexpectedSmartServerResponse(response)
1777
 
 
1778
 
 
1779
 
class RemoteStreamSink(repository.StreamSink):
1780
 
 
1781
 
    def _insert_real(self, stream, src_format, resume_tokens):
1782
 
        self.target_repo._ensure_real()
1783
 
        sink = self.target_repo._real_repository._get_sink()
1784
 
        result = sink.insert_stream(stream, src_format, resume_tokens)
1785
 
        if not result:
1786
 
            self.target_repo.autopack()
1787
 
        return result
1788
 
 
1789
 
    def insert_stream(self, stream, src_format, resume_tokens):
1790
 
        target = self.target_repo
1791
 
        target._unstacked_provider.missing_keys.clear()
1792
 
        candidate_calls = [('Repository.insert_stream_1.19', (1, 19))]
1793
 
        if target._lock_token:
1794
 
            candidate_calls.append(('Repository.insert_stream_locked', (1, 14)))
1795
 
            lock_args = (target._lock_token or '',)
1796
 
        else:
1797
 
            candidate_calls.append(('Repository.insert_stream', (1, 13)))
1798
 
            lock_args = ()
1799
 
        client = target._client
1800
 
        medium = client._medium
1801
 
        path = target.bzrdir._path_for_remote_call(client)
1802
 
        # Probe for the verb to use with an empty stream before sending the
1803
 
        # real stream to it.  We do this both to avoid the risk of sending a
1804
 
        # large request that is then rejected, and because we don't want to
1805
 
        # implement a way to buffer, rewind, or restart the stream.
1806
 
        found_verb = False
1807
 
        for verb, required_version in candidate_calls:
1808
 
            if medium._is_remote_before(required_version):
1809
 
                continue
1810
 
            if resume_tokens:
1811
 
                # We've already done the probing (and set _is_remote_before) on
1812
 
                # a previous insert.
1813
 
                found_verb = True
1814
 
                break
1815
 
            byte_stream = smart_repo._stream_to_byte_stream([], src_format)
1816
 
            try:
1817
 
                response = client.call_with_body_stream(
1818
 
                    (verb, path, '') + lock_args, byte_stream)
1819
 
            except errors.UnknownSmartMethod:
1820
 
                medium._remember_remote_is_before(required_version)
1821
 
            else:
1822
 
                found_verb = True
1823
 
                break
1824
 
        if not found_verb:
1825
 
            # Have to use VFS.
1826
 
            return self._insert_real(stream, src_format, resume_tokens)
1827
 
        self._last_inv_record = None
1828
 
        self._last_substream = None
1829
 
        if required_version < (1, 19):
1830
 
            # Remote side doesn't support inventory deltas.  Wrap the stream to
1831
 
            # make sure we don't send any.  If the stream contains inventory
1832
 
            # deltas we'll interrupt the smart insert_stream request and
1833
 
            # fallback to VFS.
1834
 
            stream = self._stop_stream_if_inventory_delta(stream)
1835
 
        byte_stream = smart_repo._stream_to_byte_stream(
1836
 
            stream, src_format)
1837
 
        resume_tokens = ' '.join(resume_tokens)
1838
 
        response = client.call_with_body_stream(
1839
 
            (verb, path, resume_tokens) + lock_args, byte_stream)
1840
 
        if response[0][0] not in ('ok', 'missing-basis'):
1841
 
            raise errors.UnexpectedSmartServerResponse(response)
1842
 
        if self._last_substream is not None:
1843
 
            # The stream included an inventory-delta record, but the remote
1844
 
            # side isn't new enough to support them.  So we need to send the
1845
 
            # rest of the stream via VFS.
1846
 
            self.target_repo.refresh_data()
1847
 
            return self._resume_stream_with_vfs(response, src_format)
1848
 
        if response[0][0] == 'missing-basis':
1849
 
            tokens, missing_keys = bencode.bdecode_as_tuple(response[0][1])
1850
 
            resume_tokens = tokens
1851
 
            return resume_tokens, set(missing_keys)
1852
 
        else:
1853
 
            self.target_repo.refresh_data()
1854
 
            return [], set()
1855
 
 
1856
 
    def _resume_stream_with_vfs(self, response, src_format):
1857
 
        """Resume sending a stream via VFS, first resending the record and
1858
 
        substream that couldn't be sent via an insert_stream verb.
1859
 
        """
1860
 
        if response[0][0] == 'missing-basis':
1861
 
            tokens, missing_keys = bencode.bdecode_as_tuple(response[0][1])
1862
 
            # Ignore missing_keys, we haven't finished inserting yet
1863
 
        else:
1864
 
            tokens = []
1865
 
        def resume_substream():
1866
 
            # Yield the substream that was interrupted.
1867
 
            for record in self._last_substream:
1868
 
                yield record
1869
 
            self._last_substream = None
1870
 
        def resume_stream():
1871
 
            # Finish sending the interrupted substream
1872
 
            yield ('inventory-deltas', resume_substream())
1873
 
            # Then simply continue sending the rest of the stream.
1874
 
            for substream_kind, substream in self._last_stream:
1875
 
                yield substream_kind, substream
1876
 
        return self._insert_real(resume_stream(), src_format, tokens)
1877
 
 
1878
 
    def _stop_stream_if_inventory_delta(self, stream):
1879
 
        """Normally this just lets the original stream pass-through unchanged.
1880
 
 
1881
 
        However if any 'inventory-deltas' substream occurs it will stop
1882
 
        streaming, and store the interrupted substream and stream in
1883
 
        self._last_substream and self._last_stream so that the stream can be
1884
 
        resumed by _resume_stream_with_vfs.
1885
 
        """
1886
 
                    
1887
 
        stream_iter = iter(stream)
1888
 
        for substream_kind, substream in stream_iter:
1889
 
            if substream_kind == 'inventory-deltas':
1890
 
                self._last_substream = substream
1891
 
                self._last_stream = stream_iter
1892
 
                return
1893
 
            else:
1894
 
                yield substream_kind, substream
1895
 
            
1896
 
 
1897
 
class RemoteStreamSource(repository.StreamSource):
1898
 
    """Stream data from a remote server."""
1899
 
 
1900
 
    def get_stream(self, search):
1901
 
        if (self.from_repository._fallback_repositories and
1902
 
            self.to_format._fetch_order == 'topological'):
1903
 
            return self._real_stream(self.from_repository, search)
1904
 
        sources = []
1905
 
        seen = set()
1906
 
        repos = [self.from_repository]
1907
 
        while repos:
1908
 
            repo = repos.pop(0)
1909
 
            if repo in seen:
1910
 
                continue
1911
 
            seen.add(repo)
1912
 
            repos.extend(repo._fallback_repositories)
1913
 
            sources.append(repo)
1914
 
        return self.missing_parents_chain(search, sources)
1915
 
 
1916
 
    def get_stream_for_missing_keys(self, missing_keys):
1917
 
        self.from_repository._ensure_real()
1918
 
        real_repo = self.from_repository._real_repository
1919
 
        real_source = real_repo._get_source(self.to_format)
1920
 
        return real_source.get_stream_for_missing_keys(missing_keys)
1921
 
 
1922
 
    def _real_stream(self, repo, search):
1923
 
        """Get a stream for search from repo.
1924
 
        
1925
 
        This never called RemoteStreamSource.get_stream, and is a heler
1926
 
        for RemoteStreamSource._get_stream to allow getting a stream 
1927
 
        reliably whether fallback back because of old servers or trying
1928
 
        to stream from a non-RemoteRepository (which the stacked support
1929
 
        code will do).
1930
 
        """
1931
 
        source = repo._get_source(self.to_format)
1932
 
        if isinstance(source, RemoteStreamSource):
1933
 
            repo._ensure_real()
1934
 
            source = repo._real_repository._get_source(self.to_format)
1935
 
        return source.get_stream(search)
1936
 
 
1937
 
    def _get_stream(self, repo, search):
1938
 
        """Core worker to get a stream from repo for search.
1939
 
 
1940
 
        This is used by both get_stream and the stacking support logic. It
1941
 
        deliberately gets a stream for repo which does not need to be
1942
 
        self.from_repository. In the event that repo is not Remote, or
1943
 
        cannot do a smart stream, a fallback is made to the generic
1944
 
        repository._get_stream() interface, via self._real_stream.
1945
 
 
1946
 
        In the event of stacking, streams from _get_stream will not
1947
 
        contain all the data for search - this is normal (see get_stream).
1948
 
 
1949
 
        :param repo: A repository.
1950
 
        :param search: A search.
1951
 
        """
1952
 
        # Fallbacks may be non-smart
1953
 
        if not isinstance(repo, RemoteRepository):
1954
 
            return self._real_stream(repo, search)
1955
 
        client = repo._client
1956
 
        medium = client._medium
1957
 
        path = repo.bzrdir._path_for_remote_call(client)
1958
 
        search_bytes = repo._serialise_search_result(search)
1959
 
        args = (path, self.to_format.network_name())
1960
 
        candidate_verbs = [
1961
 
            ('Repository.get_stream_1.19', (1, 19)),
1962
 
            ('Repository.get_stream', (1, 13))]
1963
 
        found_verb = False
1964
 
        for verb, version in candidate_verbs:
1965
 
            if medium._is_remote_before(version):
1966
 
                continue
1967
 
            try:
1968
 
                response = repo._call_with_body_bytes_expecting_body(
1969
 
                    verb, args, search_bytes)
1970
 
            except errors.UnknownSmartMethod:
1971
 
                medium._remember_remote_is_before(version)
1972
 
            else:
1973
 
                response_tuple, response_handler = response
1974
 
                found_verb = True
1975
 
                break
1976
 
        if not found_verb:
1977
 
            return self._real_stream(repo, search)
1978
 
        if response_tuple[0] != 'ok':
1979
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
1980
 
        byte_stream = response_handler.read_streamed_body()
1981
 
        src_format, stream = smart_repo._byte_stream_to_stream(byte_stream)
1982
 
        if src_format.network_name() != repo._format.network_name():
1983
 
            raise AssertionError(
1984
 
                "Mismatched RemoteRepository and stream src %r, %r" % (
1985
 
                src_format.network_name(), repo._format.network_name()))
1986
 
        return stream
1987
 
 
1988
 
    def missing_parents_chain(self, search, sources):
1989
 
        """Chain multiple streams together to handle stacking.
1990
 
 
1991
 
        :param search: The overall search to satisfy with streams.
1992
 
        :param sources: A list of Repository objects to query.
1993
 
        """
1994
 
        self.from_serialiser = self.from_repository._format._serializer
1995
 
        self.seen_revs = set()
1996
 
        self.referenced_revs = set()
1997
 
        # If there are heads in the search, or the key count is > 0, we are not
1998
 
        # done.
1999
 
        while not search.is_empty() and len(sources) > 1:
2000
 
            source = sources.pop(0)
2001
 
            stream = self._get_stream(source, search)
2002
 
            for kind, substream in stream:
2003
 
                if kind != 'revisions':
2004
 
                    yield kind, substream
2005
 
                else:
2006
 
                    yield kind, self.missing_parents_rev_handler(substream)
2007
 
            search = search.refine(self.seen_revs, self.referenced_revs)
2008
 
            self.seen_revs = set()
2009
 
            self.referenced_revs = set()
2010
 
        if not search.is_empty():
2011
 
            for kind, stream in self._get_stream(sources[0], search):
2012
 
                yield kind, stream
2013
 
 
2014
 
    def missing_parents_rev_handler(self, substream):
2015
 
        for content in substream:
2016
 
            revision_bytes = content.get_bytes_as('fulltext')
2017
 
            revision = self.from_serialiser.read_revision_from_string(
2018
 
                revision_bytes)
2019
 
            self.seen_revs.add(content.key[-1])
2020
 
            self.referenced_revs.update(revision.parent_ids)
2021
 
            yield content
 
1025
    def _make_parents_provider(self):
 
1026
        return self
2022
1027
 
2023
1028
 
2024
1029
class RemoteBranchLockableFiles(LockableFiles):
2025
1030
    """A 'LockableFiles' implementation that talks to a smart server.
2026
 
 
 
1031
    
2027
1032
    This is not a public interface class.
2028
1033
    """
2029
1034
 
2040
1045
        self._dir_mode = None
2041
1046
        self._file_mode = None
2042
1047
 
 
1048
    def get(self, path):
 
1049
        """'get' a remote path as per the LockableFiles interface.
 
1050
 
 
1051
        :param path: the file to 'get'. If this is 'branch.conf', we do not
 
1052
             just retrieve a file, instead we ask the smart server to generate
 
1053
             a configuration for us - which is retrieved as an INI file.
 
1054
        """
 
1055
        if path == 'branch.conf':
 
1056
            path = self.bzrdir._path_for_remote_call(self._client)
 
1057
            response = self._client.call_expecting_body(
 
1058
                'Branch.get_config_file', path)
 
1059
            assert response[0][0] == 'ok', \
 
1060
                'unexpected response code %s' % (response[0],)
 
1061
            return StringIO(response[1].read_body_bytes())
 
1062
        else:
 
1063
            # VFS fallback.
 
1064
            return LockableFiles.get(self, path)
 
1065
 
2043
1066
 
2044
1067
class RemoteBranchFormat(branch.BranchFormat):
2045
1068
 
2046
 
    def __init__(self, network_name=None):
2047
 
        super(RemoteBranchFormat, self).__init__()
2048
 
        self._matchingbzrdir = RemoteBzrDirFormat()
2049
 
        self._matchingbzrdir.set_branch_format(self)
2050
 
        self._custom_format = None
2051
 
        self._network_name = network_name
2052
 
 
2053
1069
    def __eq__(self, other):
2054
 
        return (isinstance(other, RemoteBranchFormat) and
 
1070
        return (isinstance(other, RemoteBranchFormat) and 
2055
1071
            self.__dict__ == other.__dict__)
2056
1072
 
2057
 
    def _ensure_real(self):
2058
 
        if self._custom_format is None:
2059
 
            self._custom_format = branch.network_format_registry.get(
2060
 
                self._network_name)
2061
 
 
2062
1073
    def get_format_description(self):
2063
 
        self._ensure_real()
2064
 
        return 'Remote: ' + self._custom_format.get_format_description()
2065
 
 
2066
 
    def network_name(self):
2067
 
        return self._network_name
2068
 
 
2069
 
    def open(self, a_bzrdir, name=None, ignore_fallbacks=False):
2070
 
        return a_bzrdir.open_branch(name=name, 
2071
 
            ignore_fallbacks=ignore_fallbacks)
2072
 
 
2073
 
    def _vfs_initialize(self, a_bzrdir, name):
2074
 
        # Initialisation when using a local bzrdir object, or a non-vfs init
2075
 
        # method is not available on the server.
2076
 
        # self._custom_format is always set - the start of initialize ensures
2077
 
        # that.
2078
 
        if isinstance(a_bzrdir, RemoteBzrDir):
2079
 
            a_bzrdir._ensure_real()
2080
 
            result = self._custom_format.initialize(a_bzrdir._real_bzrdir,
2081
 
                name)
2082
 
        else:
2083
 
            # We assume the bzrdir is parameterised; it may not be.
2084
 
            result = self._custom_format.initialize(a_bzrdir, name)
2085
 
        if (isinstance(a_bzrdir, RemoteBzrDir) and
2086
 
            not isinstance(result, RemoteBranch)):
2087
 
            result = RemoteBranch(a_bzrdir, a_bzrdir.find_repository(), result,
2088
 
                                  name=name)
2089
 
        return result
2090
 
 
2091
 
    def initialize(self, a_bzrdir, name=None):
2092
 
        # 1) get the network name to use.
2093
 
        if self._custom_format:
2094
 
            network_name = self._custom_format.network_name()
2095
 
        else:
2096
 
            # Select the current bzrlib default and ask for that.
2097
 
            reference_bzrdir_format = bzrdir.format_registry.get('default')()
2098
 
            reference_format = reference_bzrdir_format.get_branch_format()
2099
 
            self._custom_format = reference_format
2100
 
            network_name = reference_format.network_name()
2101
 
        # Being asked to create on a non RemoteBzrDir:
2102
 
        if not isinstance(a_bzrdir, RemoteBzrDir):
2103
 
            return self._vfs_initialize(a_bzrdir, name=name)
2104
 
        medium = a_bzrdir._client._medium
2105
 
        if medium._is_remote_before((1, 13)):
2106
 
            return self._vfs_initialize(a_bzrdir, name=name)
2107
 
        # Creating on a remote bzr dir.
2108
 
        # 2) try direct creation via RPC
2109
 
        path = a_bzrdir._path_for_remote_call(a_bzrdir._client)
2110
 
        if name is not None:
2111
 
            # XXX JRV20100304: Support creating colocated branches
2112
 
            raise errors.NoColocatedBranchSupport(self)
2113
 
        verb = 'BzrDir.create_branch'
2114
 
        try:
2115
 
            response = a_bzrdir._call(verb, path, network_name)
2116
 
        except errors.UnknownSmartMethod:
2117
 
            # Fallback - use vfs methods
2118
 
            medium._remember_remote_is_before((1, 13))
2119
 
            return self._vfs_initialize(a_bzrdir, name=name)
2120
 
        if response[0] != 'ok':
2121
 
            raise errors.UnexpectedSmartServerResponse(response)
2122
 
        # Turn the response into a RemoteRepository object.
2123
 
        format = RemoteBranchFormat(network_name=response[1])
2124
 
        repo_format = response_tuple_to_repo_format(response[3:])
2125
 
        if response[2] == '':
2126
 
            repo_bzrdir = a_bzrdir
2127
 
        else:
2128
 
            repo_bzrdir = RemoteBzrDir(
2129
 
                a_bzrdir.root_transport.clone(response[2]), a_bzrdir._format,
2130
 
                a_bzrdir._client)
2131
 
        remote_repo = RemoteRepository(repo_bzrdir, repo_format)
2132
 
        remote_branch = RemoteBranch(a_bzrdir, remote_repo,
2133
 
            format=format, setup_stacking=False, name=name)
2134
 
        # XXX: We know this is a new branch, so it must have revno 0, revid
2135
 
        # NULL_REVISION. Creating the branch locked would make this be unable
2136
 
        # to be wrong; here its simply very unlikely to be wrong. RBC 20090225
2137
 
        remote_branch._last_revision_info_cache = 0, NULL_REVISION
2138
 
        return remote_branch
2139
 
 
2140
 
    def make_tags(self, branch):
2141
 
        self._ensure_real()
2142
 
        return self._custom_format.make_tags(branch)
 
1074
        return 'Remote BZR Branch'
 
1075
 
 
1076
    def get_format_string(self):
 
1077
        return 'Remote BZR Branch'
 
1078
 
 
1079
    def open(self, a_bzrdir):
 
1080
        assert isinstance(a_bzrdir, RemoteBzrDir)
 
1081
        return a_bzrdir.open_branch()
 
1082
 
 
1083
    def initialize(self, a_bzrdir):
 
1084
        assert isinstance(a_bzrdir, RemoteBzrDir)
 
1085
        return a_bzrdir.create_branch()
2143
1086
 
2144
1087
    def supports_tags(self):
2145
1088
        # Remote branches might support tags, but we won't know until we
2146
1089
        # access the real remote branch.
2147
 
        self._ensure_real()
2148
 
        return self._custom_format.supports_tags()
2149
 
 
2150
 
    def supports_stacking(self):
2151
 
        self._ensure_real()
2152
 
        return self._custom_format.supports_stacking()
2153
 
 
2154
 
    def supports_set_append_revisions_only(self):
2155
 
        self._ensure_real()
2156
 
        return self._custom_format.supports_set_append_revisions_only()
2157
 
 
2158
 
 
2159
 
class RemoteBranch(branch.Branch, _RpcHelper, lock._RelockDebugMixin):
 
1090
        return True
 
1091
 
 
1092
 
 
1093
class RemoteBranch(branch.Branch):
2160
1094
    """Branch stored on a server accessed by HPSS RPC.
2161
1095
 
2162
1096
    At the moment most operations are mapped down to simple file operations.
2163
1097
    """
2164
1098
 
2165
1099
    def __init__(self, remote_bzrdir, remote_repository, real_branch=None,
2166
 
        _client=None, format=None, setup_stacking=True, name=None):
 
1100
        _client=None):
2167
1101
        """Create a RemoteBranch instance.
2168
1102
 
2169
1103
        :param real_branch: An optional local implementation of the branch
2170
1104
            format, usually accessing the data via the VFS.
2171
1105
        :param _client: Private parameter for testing.
2172
 
        :param format: A RemoteBranchFormat object, None to create one
2173
 
            automatically. If supplied it should have a network_name already
2174
 
            supplied.
2175
 
        :param setup_stacking: If True make an RPC call to determine the
2176
 
            stacked (or not) status of the branch. If False assume the branch
2177
 
            is not stacked.
2178
 
        :param name: Colocated branch name
2179
1106
        """
2180
1107
        # We intentionally don't call the parent class's __init__, because it
2181
1108
        # will try to assign to self.tags, which is a property in this subclass.
2182
1109
        # And the parent's __init__ doesn't do much anyway.
 
1110
        self._revision_id_to_revno_cache = None
 
1111
        self._revision_history_cache = None
2183
1112
        self.bzrdir = remote_bzrdir
2184
1113
        if _client is not None:
2185
1114
            self._client = _client
2186
1115
        else:
2187
 
            self._client = remote_bzrdir._client
 
1116
            self._client = client._SmartClient(self.bzrdir._shared_medium)
2188
1117
        self.repository = remote_repository
2189
1118
        if real_branch is not None:
2190
1119
            self._real_branch = real_branch
2198
1127
            self._real_branch.repository = self.repository
2199
1128
        else:
2200
1129
            self._real_branch = None
2201
 
        # Fill out expected attributes of branch for bzrlib API users.
2202
 
        self._clear_cached_state()
2203
 
        # TODO: deprecate self.base in favor of user_url
2204
 
        self.base = self.bzrdir.user_url
2205
 
        self._name = name
 
1130
        # Fill out expected attributes of branch for bzrlib api users.
 
1131
        self._format = RemoteBranchFormat()
 
1132
        self.base = self.bzrdir.root_transport.base
2206
1133
        self._control_files = None
2207
1134
        self._lock_mode = None
2208
1135
        self._lock_token = None
2209
 
        self._repo_lock_token = None
2210
1136
        self._lock_count = 0
2211
1137
        self._leave_lock = False
2212
 
        # Setup a format: note that we cannot call _ensure_real until all the
2213
 
        # attributes above are set: This code cannot be moved higher up in this
2214
 
        # function.
2215
 
        if format is None:
2216
 
            self._format = RemoteBranchFormat()
2217
 
            if real_branch is not None:
2218
 
                self._format._network_name = \
2219
 
                    self._real_branch._format.network_name()
2220
 
        else:
2221
 
            self._format = format
2222
 
        # when we do _ensure_real we may need to pass ignore_fallbacks to the
2223
 
        # branch.open_branch method.
2224
 
        self._real_ignore_fallbacks = not setup_stacking
2225
 
        if not self._format._network_name:
2226
 
            # Did not get from open_branchV2 - old server.
2227
 
            self._ensure_real()
2228
 
            self._format._network_name = \
2229
 
                self._real_branch._format.network_name()
2230
 
        self.tags = self._format.make_tags(self)
2231
 
        # The base class init is not called, so we duplicate this:
2232
 
        hooks = branch.Branch.hooks['open']
2233
 
        for hook in hooks:
2234
 
            hook(self)
2235
 
        self._is_stacked = False
2236
 
        if setup_stacking:
2237
 
            self._setup_stacking()
2238
 
 
2239
 
    def _setup_stacking(self):
2240
 
        # configure stacking into the remote repository, by reading it from
2241
 
        # the vfs branch.
2242
 
        try:
2243
 
            fallback_url = self.get_stacked_on_url()
2244
 
        except (errors.NotStacked, errors.UnstackableBranchFormat,
2245
 
            errors.UnstackableRepositoryFormat), e:
2246
 
            return
2247
 
        self._is_stacked = True
2248
 
        self._activate_fallback_location(fallback_url)
2249
 
 
2250
 
    def _get_config(self):
2251
 
        return RemoteBranchConfig(self)
2252
 
 
2253
 
    def _get_real_transport(self):
2254
 
        # if we try vfs access, return the real branch's vfs transport
2255
 
        self._ensure_real()
2256
 
        return self._real_branch._transport
2257
 
 
2258
 
    _transport = property(_get_real_transport)
2259
1138
 
2260
1139
    def __str__(self):
2261
1140
        return "%s(%s)" % (self.__class__.__name__, self.base)
2267
1146
 
2268
1147
        Used before calls to self._real_branch.
2269
1148
        """
2270
 
        if self._real_branch is None:
2271
 
            if not vfs.vfs_enabled():
2272
 
                raise AssertionError('smart server vfs must be enabled '
2273
 
                    'to use vfs implementation')
 
1149
        if not self._real_branch:
 
1150
            assert vfs.vfs_enabled()
2274
1151
            self.bzrdir._ensure_real()
2275
 
            self._real_branch = self.bzrdir._real_bzrdir.open_branch(
2276
 
                ignore_fallbacks=self._real_ignore_fallbacks, name=self._name)
2277
 
            if self.repository._real_repository is None:
2278
 
                # Give the remote repository the matching real repo.
2279
 
                real_repo = self._real_branch.repository
2280
 
                if isinstance(real_repo, RemoteRepository):
2281
 
                    real_repo._ensure_real()
2282
 
                    real_repo = real_repo._real_repository
2283
 
                self.repository._set_real_repository(real_repo)
2284
 
            # Give the real branch the remote repository to let fast-pathing
2285
 
            # happen.
 
1152
            self._real_branch = self.bzrdir._real_bzrdir.open_branch()
 
1153
            # Give the remote repository the matching real repo.
 
1154
            real_repo = self._real_branch.repository
 
1155
            if isinstance(real_repo, RemoteRepository):
 
1156
                real_repo._ensure_real()
 
1157
                real_repo = real_repo._real_repository
 
1158
            self.repository._set_real_repository(real_repo)
 
1159
            # Give the branch the remote repository to let fast-pathing happen.
2286
1160
            self._real_branch.repository = self.repository
 
1161
            # XXX: deal with _lock_mode == 'w'
2287
1162
            if self._lock_mode == 'r':
2288
1163
                self._real_branch.lock_read()
2289
 
            elif self._lock_mode == 'w':
2290
 
                self._real_branch.lock_write(token=self._lock_token)
2291
 
 
2292
 
    def _translate_error(self, err, **context):
2293
 
        self.repository._translate_error(err, branch=self, **context)
2294
 
 
2295
 
    def _clear_cached_state(self):
2296
 
        super(RemoteBranch, self)._clear_cached_state()
2297
 
        if self._real_branch is not None:
2298
 
            self._real_branch._clear_cached_state()
2299
 
 
2300
 
    def _clear_cached_state_of_remote_branch_only(self):
2301
 
        """Like _clear_cached_state, but doesn't clear the cache of
2302
 
        self._real_branch.
2303
 
 
2304
 
        This is useful when falling back to calling a method of
2305
 
        self._real_branch that changes state.  In that case the underlying
2306
 
        branch changes, so we need to invalidate this RemoteBranch's cache of
2307
 
        it.  However, there's no need to invalidate the _real_branch's cache
2308
 
        too, in fact doing so might harm performance.
2309
 
        """
2310
 
        super(RemoteBranch, self)._clear_cached_state()
2311
1164
 
2312
1165
    @property
2313
1166
    def control_files(self):
2328
1181
        self._ensure_real()
2329
1182
        return self._real_branch.get_physical_lock_status()
2330
1183
 
2331
 
    def get_stacked_on_url(self):
2332
 
        """Get the URL this branch is stacked against.
2333
 
 
2334
 
        :raises NotStacked: If the branch is not stacked.
2335
 
        :raises UnstackableBranchFormat: If the branch does not support
2336
 
            stacking.
2337
 
        :raises UnstackableRepositoryFormat: If the repository does not support
2338
 
            stacking.
2339
 
        """
2340
 
        try:
2341
 
            # there may not be a repository yet, so we can't use
2342
 
            # self._translate_error, so we can't use self._call either.
2343
 
            response = self._client.call('Branch.get_stacked_on_url',
2344
 
                self._remote_path())
2345
 
        except errors.ErrorFromSmartServer, err:
2346
 
            # there may not be a repository yet, so we can't call through
2347
 
            # its _translate_error
2348
 
            _translate_error(err, branch=self)
2349
 
        except errors.UnknownSmartMethod, err:
2350
 
            self._ensure_real()
2351
 
            return self._real_branch.get_stacked_on_url()
2352
 
        if response[0] != 'ok':
2353
 
            raise errors.UnexpectedSmartServerResponse(response)
2354
 
        return response[1]
2355
 
 
2356
 
    def set_stacked_on_url(self, url):
2357
 
        branch.Branch.set_stacked_on_url(self, url)
2358
 
        if not url:
2359
 
            self._is_stacked = False
2360
 
        else:
2361
 
            self._is_stacked = True
2362
 
        
2363
 
    def _vfs_get_tags_bytes(self):
2364
 
        self._ensure_real()
2365
 
        return self._real_branch._get_tags_bytes()
2366
 
 
2367
 
    def _get_tags_bytes(self):
2368
 
        medium = self._client._medium
2369
 
        if medium._is_remote_before((1, 13)):
2370
 
            return self._vfs_get_tags_bytes()
2371
 
        try:
2372
 
            response = self._call('Branch.get_tags_bytes', self._remote_path())
2373
 
        except errors.UnknownSmartMethod:
2374
 
            medium._remember_remote_is_before((1, 13))
2375
 
            return self._vfs_get_tags_bytes()
2376
 
        return response[0]
2377
 
 
2378
 
    def _vfs_set_tags_bytes(self, bytes):
2379
 
        self._ensure_real()
2380
 
        return self._real_branch._set_tags_bytes(bytes)
2381
 
 
2382
 
    def _set_tags_bytes(self, bytes):
2383
 
        medium = self._client._medium
2384
 
        if medium._is_remote_before((1, 18)):
2385
 
            self._vfs_set_tags_bytes(bytes)
2386
 
            return
2387
 
        try:
2388
 
            args = (
2389
 
                self._remote_path(), self._lock_token, self._repo_lock_token)
2390
 
            response = self._call_with_body_bytes(
2391
 
                'Branch.set_tags_bytes', args, bytes)
2392
 
        except errors.UnknownSmartMethod:
2393
 
            medium._remember_remote_is_before((1, 18))
2394
 
            self._vfs_set_tags_bytes(bytes)
2395
 
 
2396
1184
    def lock_read(self):
2397
 
        """Lock the branch for read operations.
2398
 
 
2399
 
        :return: An object with an unlock method which will release the lock
2400
 
            obtained.
2401
 
        """
2402
 
        self.repository.lock_read()
2403
1185
        if not self._lock_mode:
2404
 
            self._note_lock('r')
2405
1186
            self._lock_mode = 'r'
2406
1187
            self._lock_count = 1
2407
1188
            if self._real_branch is not None:
2408
1189
                self._real_branch.lock_read()
2409
1190
        else:
2410
1191
            self._lock_count += 1
2411
 
        return self
2412
1192
 
2413
1193
    def _remote_lock_write(self, token):
2414
1194
        if token is None:
2415
1195
            branch_token = repo_token = ''
2416
1196
        else:
2417
1197
            branch_token = token
2418
 
            repo_token = self.repository.lock_write().repository_token
 
1198
            repo_token = self.repository.lock_write()
2419
1199
            self.repository.unlock()
2420
 
        err_context = {'token': token}
2421
 
        response = self._call(
2422
 
            'Branch.lock_write', self._remote_path(), branch_token,
2423
 
            repo_token or '', **err_context)
2424
 
        if response[0] != 'ok':
 
1200
        path = self.bzrdir._path_for_remote_call(self._client)
 
1201
        response = self._client.call('Branch.lock_write', path, branch_token,
 
1202
                                     repo_token or '')
 
1203
        if response[0] == 'ok':
 
1204
            ok, branch_token, repo_token = response
 
1205
            return branch_token, repo_token
 
1206
        elif response[0] == 'LockContention':
 
1207
            raise errors.LockContention('(remote lock)')
 
1208
        elif response[0] == 'TokenMismatch':
 
1209
            raise errors.TokenMismatch(token, '(remote token)')
 
1210
        elif response[0] == 'UnlockableTransport':
 
1211
            raise errors.UnlockableTransport(self.bzrdir.root_transport)
 
1212
        elif response[0] == 'ReadOnlyError':
 
1213
            raise errors.ReadOnlyError(self)
 
1214
        elif response[0] == 'LockFailed':
 
1215
            raise errors.LockFailed(response[1], response[2])
 
1216
        else:
2425
1217
            raise errors.UnexpectedSmartServerResponse(response)
2426
 
        ok, branch_token, repo_token = response
2427
 
        return branch_token, repo_token
2428
 
 
 
1218
            
2429
1219
    def lock_write(self, token=None):
2430
1220
        if not self._lock_mode:
2431
 
            self._note_lock('w')
2432
 
            # Lock the branch and repo in one remote call.
2433
1221
            remote_tokens = self._remote_lock_write(token)
2434
1222
            self._lock_token, self._repo_lock_token = remote_tokens
2435
 
            if not self._lock_token:
2436
 
                raise SmartProtocolError('Remote server did not return a token!')
2437
 
            # Tell the self.repository object that it is locked.
2438
 
            self.repository.lock_write(
2439
 
                self._repo_lock_token, _skip_rpc=True)
2440
 
 
 
1223
            assert self._lock_token, 'Remote server did not return a token!'
 
1224
            # TODO: We really, really, really don't want to call _ensure_real
 
1225
            # here, but it's the easiest way to ensure coherency between the
 
1226
            # state of the RemoteBranch and RemoteRepository objects and the
 
1227
            # physical locks.  If we don't materialise the real objects here,
 
1228
            # then getting everything in the right state later is complex, so
 
1229
            # for now we just do it the lazy way.
 
1230
            #   -- Andrew Bennetts, 2007-02-22.
 
1231
            self._ensure_real()
2441
1232
            if self._real_branch is not None:
2442
 
                self._real_branch.lock_write(token=self._lock_token)
 
1233
                self._real_branch.repository.lock_write(
 
1234
                    token=self._repo_lock_token)
 
1235
                try:
 
1236
                    self._real_branch.lock_write(token=self._lock_token)
 
1237
                finally:
 
1238
                    self._real_branch.repository.unlock()
2443
1239
            if token is not None:
2444
1240
                self._leave_lock = True
2445
1241
            else:
 
1242
                # XXX: this case seems to be unreachable; token cannot be None.
2446
1243
                self._leave_lock = False
2447
1244
            self._lock_mode = 'w'
2448
1245
            self._lock_count = 1
2450
1247
            raise errors.ReadOnlyTransaction
2451
1248
        else:
2452
1249
            if token is not None:
2453
 
                # A token was given to lock_write, and we're relocking, so
2454
 
                # check that the given token actually matches the one we
2455
 
                # already have.
 
1250
                # A token was given to lock_write, and we're relocking, so check
 
1251
                # that the given token actually matches the one we already have.
2456
1252
                if token != self._lock_token:
2457
1253
                    raise errors.TokenMismatch(token, self._lock_token)
2458
1254
            self._lock_count += 1
2459
 
            # Re-lock the repository too.
2460
 
            self.repository.lock_write(self._repo_lock_token)
2461
 
        return BranchWriteLockResult(self.unlock, self._lock_token or None)
 
1255
        return self._lock_token or None
2462
1256
 
2463
1257
    def _unlock(self, branch_token, repo_token):
2464
 
        err_context = {'token': str((branch_token, repo_token))}
2465
 
        response = self._call(
2466
 
            'Branch.unlock', self._remote_path(), branch_token,
2467
 
            repo_token or '', **err_context)
 
1258
        path = self.bzrdir._path_for_remote_call(self._client)
 
1259
        response = self._client.call('Branch.unlock', path, branch_token,
 
1260
                                     repo_token or '')
2468
1261
        if response == ('ok',):
2469
1262
            return
2470
 
        raise errors.UnexpectedSmartServerResponse(response)
 
1263
        elif response[0] == 'TokenMismatch':
 
1264
            raise errors.TokenMismatch(
 
1265
                str((branch_token, repo_token)), '(remote tokens)')
 
1266
        else:
 
1267
            raise errors.UnexpectedSmartServerResponse(response)
2471
1268
 
2472
 
    @only_raises(errors.LockNotHeld, errors.LockBroken)
2473
1269
    def unlock(self):
2474
 
        try:
2475
 
            self._lock_count -= 1
2476
 
            if not self._lock_count:
2477
 
                self._clear_cached_state()
2478
 
                mode = self._lock_mode
2479
 
                self._lock_mode = None
2480
 
                if self._real_branch is not None:
2481
 
                    if (not self._leave_lock and mode == 'w' and
2482
 
                        self._repo_lock_token):
2483
 
                        # If this RemoteBranch will remove the physical lock
2484
 
                        # for the repository, make sure the _real_branch
2485
 
                        # doesn't do it first.  (Because the _real_branch's
2486
 
                        # repository is set to be the RemoteRepository.)
2487
 
                        self._real_branch.repository.leave_lock_in_place()
2488
 
                    self._real_branch.unlock()
2489
 
                if mode != 'w':
2490
 
                    # Only write-locked branched need to make a remote method
2491
 
                    # call to perform the unlock.
2492
 
                    return
2493
 
                if not self._lock_token:
2494
 
                    raise AssertionError('Locked, but no token!')
2495
 
                branch_token = self._lock_token
2496
 
                repo_token = self._repo_lock_token
2497
 
                self._lock_token = None
2498
 
                self._repo_lock_token = None
2499
 
                if not self._leave_lock:
2500
 
                    self._unlock(branch_token, repo_token)
2501
 
        finally:
2502
 
            self.repository.unlock()
 
1270
        self._lock_count -= 1
 
1271
        if not self._lock_count:
 
1272
            self._clear_cached_state()
 
1273
            mode = self._lock_mode
 
1274
            self._lock_mode = None
 
1275
            if self._real_branch is not None:
 
1276
                if (not self._leave_lock and mode == 'w' and
 
1277
                    self._repo_lock_token):
 
1278
                    # If this RemoteBranch will remove the physical lock for the
 
1279
                    # repository, make sure the _real_branch doesn't do it
 
1280
                    # first.  (Because the _real_branch's repository is set to
 
1281
                    # be the RemoteRepository.)
 
1282
                    self._real_branch.repository.leave_lock_in_place()
 
1283
                self._real_branch.unlock()
 
1284
            if mode != 'w':
 
1285
                # Only write-locked branched need to make a remote method call
 
1286
                # to perfom the unlock.
 
1287
                return
 
1288
            assert self._lock_token, 'Locked, but no token!'
 
1289
            branch_token = self._lock_token
 
1290
            repo_token = self._repo_lock_token
 
1291
            self._lock_token = None
 
1292
            self._repo_lock_token = None
 
1293
            if not self._leave_lock:
 
1294
                self._unlock(branch_token, repo_token)
2503
1295
 
2504
1296
    def break_lock(self):
2505
1297
        self._ensure_real()
2515
1307
            raise NotImplementedError(self.dont_leave_lock_in_place)
2516
1308
        self._leave_lock = False
2517
1309
 
2518
 
    @needs_read_lock
2519
 
    def get_rev_id(self, revno, history=None):
2520
 
        if revno == 0:
2521
 
            return _mod_revision.NULL_REVISION
2522
 
        last_revision_info = self.last_revision_info()
2523
 
        ok, result = self.repository.get_rev_id_for_revno(
2524
 
            revno, last_revision_info)
2525
 
        if ok:
2526
 
            return result
2527
 
        missing_parent = result[1]
2528
 
        # Either the revision named by the server is missing, or its parent
2529
 
        # is.  Call get_parent_map to determine which, so that we report a
2530
 
        # useful error.
2531
 
        parent_map = self.repository.get_parent_map([missing_parent])
2532
 
        if missing_parent in parent_map:
2533
 
            missing_parent = parent_map[missing_parent]
2534
 
        raise errors.RevisionNotPresent(missing_parent, self.repository)
2535
 
 
2536
 
    def _last_revision_info(self):
2537
 
        response = self._call('Branch.last_revision_info', self._remote_path())
2538
 
        if response[0] != 'ok':
2539
 
            raise SmartProtocolError('unexpected response code %s' % (response,))
 
1310
    def last_revision_info(self):
 
1311
        """See Branch.last_revision_info()."""
 
1312
        path = self.bzrdir._path_for_remote_call(self._client)
 
1313
        response = self._client.call('Branch.last_revision_info', path)
 
1314
        assert response[0] == 'ok', 'unexpected response code %s' % (response,)
2540
1315
        revno = int(response[1])
2541
1316
        last_revision = response[2]
2542
1317
        return (revno, last_revision)
2543
1318
 
2544
1319
    def _gen_revision_history(self):
2545
1320
        """See Branch._gen_revision_history()."""
2546
 
        if self._is_stacked:
2547
 
            self._ensure_real()
2548
 
            return self._real_branch._gen_revision_history()
2549
 
        response_tuple, response_handler = self._call_expecting_body(
2550
 
            'Branch.revision_history', self._remote_path())
2551
 
        if response_tuple[0] != 'ok':
2552
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
2553
 
        result = response_handler.read_body_bytes().split('\x00')
 
1321
        path = self.bzrdir._path_for_remote_call(self._client)
 
1322
        response = self._client.call_expecting_body(
 
1323
            'Branch.revision_history', path)
 
1324
        assert response[0][0] == 'ok', ('unexpected response code %s'
 
1325
                                        % (response[0],))
 
1326
        result = response[1].read_body_bytes().split('\x00')
2554
1327
        if result == ['']:
2555
1328
            return []
2556
1329
        return result
2557
1330
 
2558
 
    def _remote_path(self):
2559
 
        return self.bzrdir._path_for_remote_call(self._client)
2560
 
 
2561
 
    def _set_last_revision_descendant(self, revision_id, other_branch,
2562
 
            allow_diverged=False, allow_overwrite_descendant=False):
2563
 
        # This performs additional work to meet the hook contract; while its
2564
 
        # undesirable, we have to synthesise the revno to call the hook, and
2565
 
        # not calling the hook is worse as it means changes can't be prevented.
2566
 
        # Having calculated this though, we can't just call into
2567
 
        # set_last_revision_info as a simple call, because there is a set_rh
2568
 
        # hook that some folk may still be using.
2569
 
        old_revno, old_revid = self.last_revision_info()
2570
 
        history = self._lefthand_history(revision_id)
2571
 
        self._run_pre_change_branch_tip_hooks(len(history), revision_id)
2572
 
        err_context = {'other_branch': other_branch}
2573
 
        response = self._call('Branch.set_last_revision_ex',
2574
 
            self._remote_path(), self._lock_token, self._repo_lock_token,
2575
 
            revision_id, int(allow_diverged), int(allow_overwrite_descendant),
2576
 
            **err_context)
2577
 
        self._clear_cached_state()
2578
 
        if len(response) != 3 and response[0] != 'ok':
2579
 
            raise errors.UnexpectedSmartServerResponse(response)
2580
 
        new_revno, new_revision_id = response[1:]
2581
 
        self._last_revision_info_cache = new_revno, new_revision_id
2582
 
        self._run_post_change_branch_tip_hooks(old_revno, old_revid)
2583
 
        if self._real_branch is not None:
2584
 
            cache = new_revno, new_revision_id
2585
 
            self._real_branch._last_revision_info_cache = cache
2586
 
 
2587
 
    def _set_last_revision(self, revision_id):
2588
 
        old_revno, old_revid = self.last_revision_info()
2589
 
        # This performs additional work to meet the hook contract; while its
2590
 
        # undesirable, we have to synthesise the revno to call the hook, and
2591
 
        # not calling the hook is worse as it means changes can't be prevented.
2592
 
        # Having calculated this though, we can't just call into
2593
 
        # set_last_revision_info as a simple call, because there is a set_rh
2594
 
        # hook that some folk may still be using.
2595
 
        history = self._lefthand_history(revision_id)
2596
 
        self._run_pre_change_branch_tip_hooks(len(history), revision_id)
2597
 
        self._clear_cached_state()
2598
 
        response = self._call('Branch.set_last_revision',
2599
 
            self._remote_path(), self._lock_token, self._repo_lock_token,
2600
 
            revision_id)
2601
 
        if response != ('ok',):
2602
 
            raise errors.UnexpectedSmartServerResponse(response)
2603
 
        self._run_post_change_branch_tip_hooks(old_revno, old_revid)
2604
 
 
2605
1331
    @needs_write_lock
2606
1332
    def set_revision_history(self, rev_history):
2607
1333
        # Send just the tip revision of the history; the server will generate
2608
1334
        # the full history from that.  If the revision doesn't exist in this
2609
1335
        # branch, NoSuchRevision will be raised.
 
1336
        path = self.bzrdir._path_for_remote_call(self._client)
2610
1337
        if rev_history == []:
2611
1338
            rev_id = 'null:'
2612
1339
        else:
2613
1340
            rev_id = rev_history[-1]
2614
 
        self._set_last_revision(rev_id)
2615
 
        for hook in branch.Branch.hooks['set_rh']:
2616
 
            hook(self, rev_history)
 
1341
        self._clear_cached_state()
 
1342
        response = self._client.call('Branch.set_last_revision',
 
1343
            path, self._lock_token, self._repo_lock_token, rev_id)
 
1344
        if response[0] == 'NoSuchRevision':
 
1345
            raise NoSuchRevision(self, rev_id)
 
1346
        else:
 
1347
            assert response == ('ok',), (
 
1348
                'unexpected response code %r' % (response,))
2617
1349
        self._cache_revision_history(rev_history)
2618
1350
 
2619
 
    def _get_parent_location(self):
2620
 
        medium = self._client._medium
2621
 
        if medium._is_remote_before((1, 13)):
2622
 
            return self._vfs_get_parent_location()
2623
 
        try:
2624
 
            response = self._call('Branch.get_parent', self._remote_path())
2625
 
        except errors.UnknownSmartMethod:
2626
 
            medium._remember_remote_is_before((1, 13))
2627
 
            return self._vfs_get_parent_location()
2628
 
        if len(response) != 1:
2629
 
            raise errors.UnexpectedSmartServerResponse(response)
2630
 
        parent_location = response[0]
2631
 
        if parent_location == '':
2632
 
            return None
2633
 
        return parent_location
2634
 
 
2635
 
    def _vfs_get_parent_location(self):
2636
 
        self._ensure_real()
2637
 
        return self._real_branch._get_parent_location()
2638
 
 
2639
 
    def _set_parent_location(self, url):
2640
 
        medium = self._client._medium
2641
 
        if medium._is_remote_before((1, 15)):
2642
 
            return self._vfs_set_parent_location(url)
2643
 
        try:
2644
 
            call_url = url or ''
2645
 
            if type(call_url) is not str:
2646
 
                raise AssertionError('url must be a str or None (%s)' % url)
2647
 
            response = self._call('Branch.set_parent_location',
2648
 
                self._remote_path(), self._lock_token, self._repo_lock_token,
2649
 
                call_url)
2650
 
        except errors.UnknownSmartMethod:
2651
 
            medium._remember_remote_is_before((1, 15))
2652
 
            return self._vfs_set_parent_location(url)
2653
 
        if response != ():
2654
 
            raise errors.UnexpectedSmartServerResponse(response)
2655
 
 
2656
 
    def _vfs_set_parent_location(self, url):
2657
 
        self._ensure_real()
2658
 
        return self._real_branch._set_parent_location(url)
 
1351
    def get_parent(self):
 
1352
        self._ensure_real()
 
1353
        return self._real_branch.get_parent()
 
1354
        
 
1355
    def set_parent(self, url):
 
1356
        self._ensure_real()
 
1357
        return self._real_branch.set_parent(url)
 
1358
        
 
1359
    def get_config(self):
 
1360
        return RemoteBranchConfig(self)
 
1361
 
 
1362
    def sprout(self, to_bzrdir, revision_id=None):
 
1363
        # Like Branch.sprout, except that it sprouts a branch in the default
 
1364
        # format, because RemoteBranches can't be created at arbitrary URLs.
 
1365
        # XXX: if to_bzrdir is a RemoteBranch, this should perhaps do
 
1366
        # to_bzrdir.create_branch...
 
1367
        self._ensure_real()
 
1368
        result = self._real_branch._format.initialize(to_bzrdir)
 
1369
        self.copy_content_into(result, revision_id=revision_id)
 
1370
        result.set_parent(self.bzrdir.root_transport.base)
 
1371
        return result
2659
1372
 
2660
1373
    @needs_write_lock
2661
1374
    def pull(self, source, overwrite=False, stop_revision=None,
2662
1375
             **kwargs):
2663
 
        self._clear_cached_state_of_remote_branch_only()
 
1376
        # FIXME: This asks the real branch to run the hooks, which means
 
1377
        # they're called with the wrong target branch parameter. 
 
1378
        # The test suite specifically allows this at present but it should be
 
1379
        # fixed.  It should get a _override_hook_target branch,
 
1380
        # as push does.  -- mbp 20070405
2664
1381
        self._ensure_real()
2665
 
        return self._real_branch.pull(
 
1382
        self._real_branch.pull(
2666
1383
            source, overwrite=overwrite, stop_revision=stop_revision,
2667
 
            _override_hook_target=self, **kwargs)
 
1384
            **kwargs)
2668
1385
 
2669
1386
    @needs_read_lock
2670
1387
    def push(self, target, overwrite=False, stop_revision=None):
2676
1393
    def is_locked(self):
2677
1394
        return self._lock_count >= 1
2678
1395
 
2679
 
    @needs_read_lock
2680
 
    def revision_id_to_revno(self, revision_id):
2681
 
        self._ensure_real()
2682
 
        return self._real_branch.revision_id_to_revno(revision_id)
2683
 
 
2684
 
    @needs_write_lock
2685
1396
    def set_last_revision_info(self, revno, revision_id):
2686
 
        # XXX: These should be returned by the set_last_revision_info verb
2687
 
        old_revno, old_revid = self.last_revision_info()
2688
 
        self._run_pre_change_branch_tip_hooks(revno, revision_id)
2689
 
        revision_id = ensure_null(revision_id)
2690
 
        try:
2691
 
            response = self._call('Branch.set_last_revision_info',
2692
 
                self._remote_path(), self._lock_token, self._repo_lock_token,
2693
 
                str(revno), revision_id)
2694
 
        except errors.UnknownSmartMethod:
2695
 
            self._ensure_real()
2696
 
            self._clear_cached_state_of_remote_branch_only()
2697
 
            self._real_branch.set_last_revision_info(revno, revision_id)
2698
 
            self._last_revision_info_cache = revno, revision_id
2699
 
            return
2700
 
        if response == ('ok',):
2701
 
            self._clear_cached_state()
2702
 
            self._last_revision_info_cache = revno, revision_id
2703
 
            self._run_post_change_branch_tip_hooks(old_revno, old_revid)
2704
 
            # Update the _real_branch's cache too.
2705
 
            if self._real_branch is not None:
2706
 
                cache = self._last_revision_info_cache
2707
 
                self._real_branch._last_revision_info_cache = cache
2708
 
        else:
2709
 
            raise errors.UnexpectedSmartServerResponse(response)
 
1397
        self._ensure_real()
 
1398
        self._clear_cached_state()
 
1399
        return self._real_branch.set_last_revision_info(revno, revision_id)
2710
1400
 
2711
 
    @needs_write_lock
2712
1401
    def generate_revision_history(self, revision_id, last_rev=None,
2713
1402
                                  other_branch=None):
2714
 
        medium = self._client._medium
2715
 
        if not medium._is_remote_before((1, 6)):
2716
 
            # Use a smart method for 1.6 and above servers
2717
 
            try:
2718
 
                self._set_last_revision_descendant(revision_id, other_branch,
2719
 
                    allow_diverged=True, allow_overwrite_descendant=True)
2720
 
                return
2721
 
            except errors.UnknownSmartMethod:
2722
 
                medium._remember_remote_is_before((1, 6))
2723
 
        self._clear_cached_state_of_remote_branch_only()
2724
 
        self.set_revision_history(self._lefthand_history(revision_id,
2725
 
            last_rev=last_rev,other_branch=other_branch))
 
1403
        self._ensure_real()
 
1404
        return self._real_branch.generate_revision_history(
 
1405
            revision_id, last_rev=last_rev, other_branch=other_branch)
 
1406
 
 
1407
    @property
 
1408
    def tags(self):
 
1409
        self._ensure_real()
 
1410
        return self._real_branch.tags
2726
1411
 
2727
1412
    def set_push_location(self, location):
2728
1413
        self._ensure_real()
2729
1414
        return self._real_branch.set_push_location(location)
2730
1415
 
2731
 
 
2732
 
class RemoteConfig(object):
2733
 
    """A Config that reads and writes from smart verbs.
2734
 
 
2735
 
    It is a low-level object that considers config data to be name/value pairs
2736
 
    that may be associated with a section. Assigning meaning to the these
2737
 
    values is done at higher levels like bzrlib.config.TreeConfig.
2738
 
    """
2739
 
 
2740
 
    def get_option(self, name, section=None, default=None):
2741
 
        """Return the value associated with a named option.
2742
 
 
2743
 
        :param name: The name of the value
2744
 
        :param section: The section the option is in (if any)
2745
 
        :param default: The value to return if the value is not set
2746
 
        :return: The value or default value
2747
 
        """
2748
 
        try:
2749
 
            configobj = self._get_configobj()
2750
 
            if section is None:
2751
 
                section_obj = configobj
2752
 
            else:
2753
 
                try:
2754
 
                    section_obj = configobj[section]
2755
 
                except KeyError:
2756
 
                    return default
2757
 
            return section_obj.get(name, default)
2758
 
        except errors.UnknownSmartMethod:
2759
 
            return self._vfs_get_option(name, section, default)
2760
 
 
2761
 
    def _response_to_configobj(self, response):
2762
 
        if len(response[0]) and response[0][0] != 'ok':
2763
 
            raise errors.UnexpectedSmartServerResponse(response)
2764
 
        lines = response[1].read_body_bytes().splitlines()
2765
 
        return config.ConfigObj(lines, encoding='utf-8')
2766
 
 
2767
 
 
2768
 
class RemoteBranchConfig(RemoteConfig):
2769
 
    """A RemoteConfig for Branches."""
2770
 
 
2771
 
    def __init__(self, branch):
2772
 
        self._branch = branch
2773
 
 
2774
 
    def _get_configobj(self):
2775
 
        path = self._branch._remote_path()
2776
 
        response = self._branch._client.call_expecting_body(
2777
 
            'Branch.get_config_file', path)
2778
 
        return self._response_to_configobj(response)
2779
 
 
2780
 
    def set_option(self, value, name, section=None):
2781
 
        """Set the value associated with a named option.
2782
 
 
2783
 
        :param value: The value to set
2784
 
        :param name: The name of the value to set
2785
 
        :param section: The section the option is in (if any)
2786
 
        """
2787
 
        medium = self._branch._client._medium
2788
 
        if medium._is_remote_before((1, 14)):
2789
 
            return self._vfs_set_option(value, name, section)
2790
 
        try:
2791
 
            path = self._branch._remote_path()
2792
 
            response = self._branch._client.call('Branch.set_config_option',
2793
 
                path, self._branch._lock_token, self._branch._repo_lock_token,
2794
 
                value.encode('utf8'), name, section or '')
2795
 
        except errors.UnknownSmartMethod:
2796
 
            medium._remember_remote_is_before((1, 14))
2797
 
            return self._vfs_set_option(value, name, section)
2798
 
        if response != ():
2799
 
            raise errors.UnexpectedSmartServerResponse(response)
2800
 
 
2801
 
    def _real_object(self):
2802
 
        self._branch._ensure_real()
2803
 
        return self._branch._real_branch
2804
 
 
2805
 
    def _vfs_set_option(self, value, name, section=None):
2806
 
        return self._real_object()._get_config().set_option(
2807
 
            value, name, section)
2808
 
 
2809
 
 
2810
 
class RemoteBzrDirConfig(RemoteConfig):
2811
 
    """A RemoteConfig for BzrDirs."""
2812
 
 
2813
 
    def __init__(self, bzrdir):
2814
 
        self._bzrdir = bzrdir
2815
 
 
2816
 
    def _get_configobj(self):
2817
 
        medium = self._bzrdir._client._medium
2818
 
        verb = 'BzrDir.get_config_file'
2819
 
        if medium._is_remote_before((1, 15)):
2820
 
            raise errors.UnknownSmartMethod(verb)
2821
 
        path = self._bzrdir._path_for_remote_call(self._bzrdir._client)
2822
 
        response = self._bzrdir._call_expecting_body(
2823
 
            verb, path)
2824
 
        return self._response_to_configobj(response)
2825
 
 
2826
 
    def _vfs_get_option(self, name, section, default):
2827
 
        return self._real_object()._get_config().get_option(
2828
 
            name, section, default)
2829
 
 
2830
 
    def set_option(self, value, name, section=None):
2831
 
        """Set the value associated with a named option.
2832
 
 
2833
 
        :param value: The value to set
2834
 
        :param name: The name of the value to set
2835
 
        :param section: The section the option is in (if any)
2836
 
        """
2837
 
        return self._real_object()._get_config().set_option(
2838
 
            value, name, section)
2839
 
 
2840
 
    def _real_object(self):
2841
 
        self._bzrdir._ensure_real()
2842
 
        return self._bzrdir._real_bzrdir
2843
 
 
 
1416
    def update_revisions(self, other, stop_revision=None, overwrite=False):
 
1417
        self._ensure_real()
 
1418
        return self._real_branch.update_revisions(
 
1419
            other, stop_revision=stop_revision, overwrite=overwrite)
 
1420
 
 
1421
 
 
1422
class RemoteBranchConfig(BranchConfig):
 
1423
 
 
1424
    def username(self):
 
1425
        self.branch._ensure_real()
 
1426
        return self.branch._real_branch.get_config().username()
 
1427
 
 
1428
    def _get_branch_data_config(self):
 
1429
        self.branch._ensure_real()
 
1430
        if self._branch_data_config is None:
 
1431
            self._branch_data_config = TreeConfig(self.branch._real_branch)
 
1432
        return self._branch_data_config
2844
1433
 
2845
1434
 
2846
1435
def _extract_tar(tar, to_dir):
2850
1439
    """
2851
1440
    for tarinfo in tar:
2852
1441
        tar.extract(tarinfo, to_dir)
2853
 
 
2854
 
 
2855
 
def _translate_error(err, **context):
2856
 
    """Translate an ErrorFromSmartServer into a more useful error.
2857
 
 
2858
 
    Possible context keys:
2859
 
      - branch
2860
 
      - repository
2861
 
      - bzrdir
2862
 
      - token
2863
 
      - other_branch
2864
 
      - path
2865
 
 
2866
 
    If the error from the server doesn't match a known pattern, then
2867
 
    UnknownErrorFromSmartServer is raised.
2868
 
    """
2869
 
    def find(name):
2870
 
        try:
2871
 
            return context[name]
2872
 
        except KeyError, key_err:
2873
 
            mutter('Missing key %r in context %r', key_err.args[0], context)
2874
 
            raise err
2875
 
    def get_path():
2876
 
        """Get the path from the context if present, otherwise use first error
2877
 
        arg.
2878
 
        """
2879
 
        try:
2880
 
            return context['path']
2881
 
        except KeyError, key_err:
2882
 
            try:
2883
 
                return err.error_args[0]
2884
 
            except IndexError, idx_err:
2885
 
                mutter(
2886
 
                    'Missing key %r in context %r', key_err.args[0], context)
2887
 
                raise err
2888
 
 
2889
 
    if err.error_verb == 'IncompatibleRepositories':
2890
 
        raise errors.IncompatibleRepositories(err.error_args[0],
2891
 
            err.error_args[1], err.error_args[2])
2892
 
    elif err.error_verb == 'NoSuchRevision':
2893
 
        raise NoSuchRevision(find('branch'), err.error_args[0])
2894
 
    elif err.error_verb == 'nosuchrevision':
2895
 
        raise NoSuchRevision(find('repository'), err.error_args[0])
2896
 
    elif err.error_verb == 'nobranch':
2897
 
        if len(err.error_args) >= 1:
2898
 
            extra = err.error_args[0]
2899
 
        else:
2900
 
            extra = None
2901
 
        raise errors.NotBranchError(path=find('bzrdir').root_transport.base,
2902
 
            detail=extra)
2903
 
    elif err.error_verb == 'norepository':
2904
 
        raise errors.NoRepositoryPresent(find('bzrdir'))
2905
 
    elif err.error_verb == 'LockContention':
2906
 
        raise errors.LockContention('(remote lock)')
2907
 
    elif err.error_verb == 'UnlockableTransport':
2908
 
        raise errors.UnlockableTransport(find('bzrdir').root_transport)
2909
 
    elif err.error_verb == 'LockFailed':
2910
 
        raise errors.LockFailed(err.error_args[0], err.error_args[1])
2911
 
    elif err.error_verb == 'TokenMismatch':
2912
 
        raise errors.TokenMismatch(find('token'), '(remote token)')
2913
 
    elif err.error_verb == 'Diverged':
2914
 
        raise errors.DivergedBranches(find('branch'), find('other_branch'))
2915
 
    elif err.error_verb == 'TipChangeRejected':
2916
 
        raise errors.TipChangeRejected(err.error_args[0].decode('utf8'))
2917
 
    elif err.error_verb == 'UnstackableBranchFormat':
2918
 
        raise errors.UnstackableBranchFormat(*err.error_args)
2919
 
    elif err.error_verb == 'UnstackableRepositoryFormat':
2920
 
        raise errors.UnstackableRepositoryFormat(*err.error_args)
2921
 
    elif err.error_verb == 'NotStacked':
2922
 
        raise errors.NotStacked(branch=find('branch'))
2923
 
    elif err.error_verb == 'PermissionDenied':
2924
 
        path = get_path()
2925
 
        if len(err.error_args) >= 2:
2926
 
            extra = err.error_args[1]
2927
 
        else:
2928
 
            extra = None
2929
 
        raise errors.PermissionDenied(path, extra=extra)
2930
 
    elif err.error_verb == 'ReadError':
2931
 
        path = get_path()
2932
 
        raise errors.ReadError(path)
2933
 
    elif err.error_verb == 'NoSuchFile':
2934
 
        path = get_path()
2935
 
        raise errors.NoSuchFile(path)
2936
 
    elif err.error_verb == 'FileExists':
2937
 
        raise errors.FileExists(err.error_args[0])
2938
 
    elif err.error_verb == 'DirectoryNotEmpty':
2939
 
        raise errors.DirectoryNotEmpty(err.error_args[0])
2940
 
    elif err.error_verb == 'ShortReadvError':
2941
 
        args = err.error_args
2942
 
        raise errors.ShortReadvError(
2943
 
            args[0], int(args[1]), int(args[2]), int(args[3]))
2944
 
    elif err.error_verb in ('UnicodeEncodeError', 'UnicodeDecodeError'):
2945
 
        encoding = str(err.error_args[0]) # encoding must always be a string
2946
 
        val = err.error_args[1]
2947
 
        start = int(err.error_args[2])
2948
 
        end = int(err.error_args[3])
2949
 
        reason = str(err.error_args[4]) # reason must always be a string
2950
 
        if val.startswith('u:'):
2951
 
            val = val[2:].decode('utf-8')
2952
 
        elif val.startswith('s:'):
2953
 
            val = val[2:].decode('base64')
2954
 
        if err.error_verb == 'UnicodeDecodeError':
2955
 
            raise UnicodeDecodeError(encoding, val, start, end, reason)
2956
 
        elif err.error_verb == 'UnicodeEncodeError':
2957
 
            raise UnicodeEncodeError(encoding, val, start, end, reason)
2958
 
    elif err.error_verb == 'ReadOnlyError':
2959
 
        raise errors.TransportNotPossible('readonly transport')
2960
 
    raise errors.UnknownErrorFromSmartServer(err)