/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: 2009-08-17 03:33:56 UTC
  • mto: This revision was merged to the branch mainline in revision 4627.
  • Revision ID: robertc@robertcollins.net-20090817033356-sgmkyhky3y0zayqw
Prepare dirstate tests for 2a as default.

Show diffs side-by-side

added added

removed removed

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