/brz/remove-bazaar

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

« back to all changes in this revision

Viewing changes to bzrlib/remote.py

  • Committer: Robert Collins
  • Date: 2010-05-06 11:08:10 UTC
  • mto: This revision was merged to the branch mainline in revision 5223.
  • Revision ID: robertc@robertcollins.net-20100506110810-h3j07fh5gmw54s25
Cleaner matcher matching revised unlocking protocol.

Show diffs side-by-side

added added

removed removed

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