/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: Martin Pool
  • Date: 2009-03-12 05:32:56 UTC
  • mfrom: (4124 +trunk)
  • mto: This revision was merged to the branch mainline in revision 4140.
  • Revision ID: mbp@sourcefrog.net-20090312053256-071khr6k4wwuuyja
merge news

Show diffs side-by-side

added added

removed removed

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