1
# Copyright (C) 2006, 2007, 2008 Canonical Ltd
 
 
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.
 
 
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.
 
 
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
 
 
17
# TODO: At some point, handle upgrades by just passing the whole request
 
 
18
# across to run on the server.
 
 
21
from cStringIO import StringIO
 
 
33
from bzrlib.branch import BranchReferenceFormat
 
 
34
from bzrlib.bzrdir import BzrDir, RemoteBzrDirFormat
 
 
35
from bzrlib.config import BranchConfig, TreeConfig
 
 
36
from bzrlib.decorators import needs_read_lock, needs_write_lock
 
 
37
from bzrlib.errors import (
 
 
41
from bzrlib.lockable_files import LockableFiles
 
 
42
from bzrlib.pack import ContainerPushParser
 
 
43
from bzrlib.smart import client, vfs
 
 
44
from bzrlib.symbol_versioning import (
 
 
48
from bzrlib.revision import ensure_null, NULL_REVISION
 
 
49
from bzrlib.trace import mutter, note, warning
 
 
51
# Note: RemoteBzrDirFormat is in bzrdir.py
 
 
53
class RemoteBzrDir(BzrDir):
 
 
54
    """Control directory on a remote server, accessed via bzr:// or similar."""
 
 
56
    def __init__(self, transport, _client=None):
 
 
57
        """Construct a RemoteBzrDir.
 
 
59
        :param _client: Private parameter for testing. Disables probing and the
 
 
62
        BzrDir.__init__(self, transport, RemoteBzrDirFormat())
 
 
63
        # this object holds a delegated bzrdir that uses file-level operations
 
 
64
        # to talk to the other side
 
 
65
        self._real_bzrdir = None
 
 
68
            medium = transport.get_smart_medium()
 
 
69
            self._client = client._SmartClient(medium)
 
 
71
            self._client = _client
 
 
74
        path = self._path_for_remote_call(self._client)
 
 
75
        response = self._client.call('BzrDir.open', path)
 
 
76
        if response not in [('yes',), ('no',)]:
 
 
77
            raise errors.UnexpectedSmartServerResponse(response)
 
 
78
        if response == ('no',):
 
 
79
            raise errors.NotBranchError(path=transport.base)
 
 
81
    def _ensure_real(self):
 
 
82
        """Ensure that there is a _real_bzrdir set.
 
 
84
        Used before calls to self._real_bzrdir.
 
 
86
        if not self._real_bzrdir:
 
 
87
            self._real_bzrdir = BzrDir.open_from_transport(
 
 
88
                self.root_transport, _server_formats=False)
 
 
90
    def create_repository(self, shared=False):
 
 
92
        self._real_bzrdir.create_repository(shared=shared)
 
 
93
        return self.open_repository()
 
 
95
    def destroy_repository(self):
 
 
96
        """See BzrDir.destroy_repository"""
 
 
98
        self._real_bzrdir.destroy_repository()
 
 
100
    def create_branch(self):
 
 
102
        real_branch = self._real_bzrdir.create_branch()
 
 
103
        return RemoteBranch(self, self.find_repository(), real_branch)
 
 
105
    def destroy_branch(self):
 
 
106
        """See BzrDir.destroy_branch"""
 
 
108
        self._real_bzrdir.destroy_branch()
 
 
110
    def create_workingtree(self, revision_id=None, from_branch=None):
 
 
111
        raise errors.NotLocalUrl(self.transport.base)
 
 
113
    def find_branch_format(self):
 
 
114
        """Find the branch 'format' for this bzrdir.
 
 
116
        This might be a synthetic object for e.g. RemoteBranch and SVN.
 
 
118
        b = self.open_branch()
 
 
121
    def get_branch_reference(self):
 
 
122
        """See BzrDir.get_branch_reference()."""
 
 
123
        path = self._path_for_remote_call(self._client)
 
 
125
            response = self._client.call('BzrDir.open_branch', path)
 
 
126
        except errors.ErrorFromSmartServer, err:
 
 
127
            if err.error_tuple == ('nobranch',):
 
 
128
                raise errors.NotBranchError(path=self.root_transport.base)
 
 
130
        if response[0] == 'ok':
 
 
131
            if response[1] == '':
 
 
132
                # branch at this location.
 
 
135
                # a branch reference, use the existing BranchReference logic.
 
 
138
            raise errors.UnexpectedSmartServerResponse(response)
 
 
140
    def _get_tree_branch(self):
 
 
141
        """See BzrDir._get_tree_branch()."""
 
 
142
        return None, self.open_branch()
 
 
144
    def open_branch(self, _unsupported=False):
 
 
146
            raise NotImplementedError('unsupported flag support not implemented yet.')
 
 
147
        reference_url = self.get_branch_reference()
 
 
148
        if reference_url is None:
 
 
149
            # branch at this location.
 
 
150
            return RemoteBranch(self, self.find_repository())
 
 
152
            # a branch reference, use the existing BranchReference logic.
 
 
153
            format = BranchReferenceFormat()
 
 
154
            return format.open(self, _found=True, location=reference_url)
 
 
156
    def open_repository(self):
 
 
157
        path = self._path_for_remote_call(self._client)
 
 
158
        verb = 'BzrDir.find_repositoryV2'
 
 
161
                response = self._client.call(verb, path)
 
 
162
            except errors.UnknownSmartMethod:
 
 
163
                verb = 'BzrDir.find_repository'
 
 
164
                response = self._client.call(verb, path)
 
 
165
        except errors.ErrorFromSmartServer, err:
 
 
166
            if err.error_verb == 'norepository':
 
 
167
                raise errors.NoRepositoryPresent(self)
 
 
169
        if response[0] != 'ok':
 
 
170
            raise errors.UnexpectedSmartServerResponse(response)
 
 
171
        if verb == 'BzrDir.find_repository':
 
 
172
            # servers that don't support the V2 method don't support external
 
 
174
            response = response + ('no', )
 
 
175
        if not (len(response) == 5):
 
 
176
            raise SmartProtocolError('incorrect response length %s' % (response,))
 
 
177
        if response[1] == '':
 
 
178
            format = RemoteRepositoryFormat()
 
 
179
            format.rich_root_data = (response[2] == 'yes')
 
 
180
            format.supports_tree_reference = (response[3] == 'yes')
 
 
181
            # No wire format to check this yet.
 
 
182
            format.supports_external_lookups = (response[4] == 'yes')
 
 
183
            return RemoteRepository(self, format)
 
 
185
            raise errors.NoRepositoryPresent(self)
 
 
187
    def open_workingtree(self, recommend_upgrade=True):
 
 
189
        if self._real_bzrdir.has_workingtree():
 
 
190
            raise errors.NotLocalUrl(self.root_transport)
 
 
192
            raise errors.NoWorkingTree(self.root_transport.base)
 
 
194
    def _path_for_remote_call(self, client):
 
 
195
        """Return the path to be used for this bzrdir in a remote call."""
 
 
196
        return client.remote_path_from_transport(self.root_transport)
 
 
198
    def get_branch_transport(self, branch_format):
 
 
200
        return self._real_bzrdir.get_branch_transport(branch_format)
 
 
202
    def get_repository_transport(self, repository_format):
 
 
204
        return self._real_bzrdir.get_repository_transport(repository_format)
 
 
206
    def get_workingtree_transport(self, workingtree_format):
 
 
208
        return self._real_bzrdir.get_workingtree_transport(workingtree_format)
 
 
210
    def can_convert_format(self):
 
 
211
        """Upgrading of remote bzrdirs is not supported yet."""
 
 
214
    def needs_format_conversion(self, format=None):
 
 
215
        """Upgrading of remote bzrdirs is not supported yet."""
 
 
218
    def clone(self, url, revision_id=None, force_new_repo=False):
 
 
220
        return self._real_bzrdir.clone(url, revision_id=revision_id,
 
 
221
            force_new_repo=force_new_repo)
 
 
224
class RemoteRepositoryFormat(repository.RepositoryFormat):
 
 
225
    """Format for repositories accessed over a _SmartClient.
 
 
227
    Instances of this repository are represented by RemoteRepository
 
 
230
    The RemoteRepositoryFormat is parameterized during construction
 
 
231
    to reflect the capabilities of the real, remote format. Specifically
 
 
232
    the attributes rich_root_data and supports_tree_reference are set
 
 
233
    on a per instance basis, and are not set (and should not be) at
 
 
237
    _matchingbzrdir = RemoteBzrDirFormat
 
 
239
    def initialize(self, a_bzrdir, shared=False):
 
 
240
        if not isinstance(a_bzrdir, RemoteBzrDir):
 
 
241
            raise AssertionError('%r is not a RemoteBzrDir' % (a_bzrdir,))
 
 
242
        return a_bzrdir.create_repository(shared=shared)
 
 
244
    def open(self, a_bzrdir):
 
 
245
        if not isinstance(a_bzrdir, RemoteBzrDir):
 
 
246
            raise AssertionError('%r is not a RemoteBzrDir' % (a_bzrdir,))
 
 
247
        return a_bzrdir.open_repository()
 
 
249
    def get_format_description(self):
 
 
250
        return 'bzr remote repository'
 
 
252
    def __eq__(self, other):
 
 
253
        return self.__class__ == other.__class__
 
 
255
    def check_conversion_target(self, target_format):
 
 
256
        if self.rich_root_data and not target_format.rich_root_data:
 
 
257
            raise errors.BadConversionTarget(
 
 
258
                'Does not support rich root data.', target_format)
 
 
259
        if (self.supports_tree_reference and
 
 
260
            not getattr(target_format, 'supports_tree_reference', False)):
 
 
261
            raise errors.BadConversionTarget(
 
 
262
                'Does not support nested trees', target_format)
 
 
265
class RemoteRepository(object):
 
 
266
    """Repository accessed over rpc.
 
 
268
    For the moment most operations are performed using local transport-backed
 
 
272
    def __init__(self, remote_bzrdir, format, real_repository=None, _client=None):
 
 
273
        """Create a RemoteRepository instance.
 
 
275
        :param remote_bzrdir: The bzrdir hosting this repository.
 
 
276
        :param format: The RemoteFormat object to use.
 
 
277
        :param real_repository: If not None, a local implementation of the
 
 
278
            repository logic for the repository, usually accessing the data
 
 
280
        :param _client: Private testing parameter - override the smart client
 
 
281
            to be used by the repository.
 
 
284
            self._real_repository = real_repository
 
 
286
            self._real_repository = None
 
 
287
        self.bzrdir = remote_bzrdir
 
 
289
            self._client = remote_bzrdir._client
 
 
291
            self._client = _client
 
 
292
        self._format = format
 
 
293
        self._lock_mode = None
 
 
294
        self._lock_token = None
 
 
296
        self._leave_lock = False
 
 
297
        # A cache of looked up revision parent data; reset at unlock time.
 
 
298
        self._parents_map = None
 
 
299
        if 'hpss' in debug.debug_flags:
 
 
300
            self._requested_parents = None
 
 
302
        # These depend on the actual remote format, so force them off for
 
 
303
        # maximum compatibility. XXX: In future these should depend on the
 
 
304
        # remote repository instance, but this is irrelevant until we perform
 
 
305
        # reconcile via an RPC call.
 
 
306
        self._reconcile_does_inventory_gc = False
 
 
307
        self._reconcile_fixes_text_parents = False
 
 
308
        self._reconcile_backsup_inventory = False
 
 
309
        self.base = self.bzrdir.transport.base
 
 
312
        return "%s(%s)" % (self.__class__.__name__, self.base)
 
 
316
    def abort_write_group(self):
 
 
317
        """Complete a write group on the decorated repository.
 
 
319
        Smart methods peform operations in a single step so this api
 
 
320
        is not really applicable except as a compatibility thunk
 
 
321
        for older plugins that don't use e.g. the CommitBuilder
 
 
325
        return self._real_repository.abort_write_group()
 
 
327
    def commit_write_group(self):
 
 
328
        """Complete a write group on the decorated repository.
 
 
330
        Smart methods peform operations in a single step so this api
 
 
331
        is not really applicable except as a compatibility thunk
 
 
332
        for older plugins that don't use e.g. the CommitBuilder
 
 
336
        return self._real_repository.commit_write_group()
 
 
338
    def _ensure_real(self):
 
 
339
        """Ensure that there is a _real_repository set.
 
 
341
        Used before calls to self._real_repository.
 
 
343
        if not self._real_repository:
 
 
344
            self.bzrdir._ensure_real()
 
 
345
            #self._real_repository = self.bzrdir._real_bzrdir.open_repository()
 
 
346
            self._set_real_repository(self.bzrdir._real_bzrdir.open_repository())
 
 
348
    def find_text_key_references(self):
 
 
349
        """Find the text key references within the repository.
 
 
351
        :return: a dictionary mapping (file_id, revision_id) tuples to altered file-ids to an iterable of
 
 
352
        revision_ids. Each altered file-ids has the exact revision_ids that
 
 
353
        altered it listed explicitly.
 
 
354
        :return: A dictionary mapping text keys ((fileid, revision_id) tuples)
 
 
355
            to whether they were referred to by the inventory of the
 
 
356
            revision_id that they contain. The inventory texts from all present
 
 
357
            revision ids are assessed to generate this report.
 
 
360
        return self._real_repository.find_text_key_references()
 
 
362
    def _generate_text_key_index(self):
 
 
363
        """Generate a new text key index for the repository.
 
 
365
        This is an expensive function that will take considerable time to run.
 
 
367
        :return: A dict mapping (file_id, revision_id) tuples to a list of
 
 
368
            parents, also (file_id, revision_id) tuples.
 
 
371
        return self._real_repository._generate_text_key_index()
 
 
373
    @symbol_versioning.deprecated_method(symbol_versioning.one_four)
 
 
374
    def get_revision_graph(self, revision_id=None):
 
 
375
        """See Repository.get_revision_graph()."""
 
 
376
        return self._get_revision_graph(revision_id)
 
 
378
    def _get_revision_graph(self, revision_id):
 
 
379
        """Private method for using with old (< 1.2) servers to fallback."""
 
 
380
        if revision_id is None:
 
 
382
        elif revision.is_null(revision_id):
 
 
385
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
387
            response = self._client.call_expecting_body(
 
 
388
                'Repository.get_revision_graph', path, revision_id)
 
 
389
        except errors.ErrorFromSmartServer, err:
 
 
390
            if err.error_verb == 'nosuchrevision':
 
 
391
                raise NoSuchRevision(self, revision_id)
 
 
393
        response_tuple, response_handler = response
 
 
394
        if response_tuple[0] != 'ok':
 
 
395
            raise errors.UnexpectedSmartServerResponse(response_tuple)
 
 
396
        coded = response_handler.read_body_bytes()
 
 
398
            # no revisions in this repository!
 
 
400
        lines = coded.split('\n')
 
 
403
            d = tuple(line.split())
 
 
404
            revision_graph[d[0]] = d[1:]
 
 
406
        return revision_graph
 
 
408
    def has_revision(self, revision_id):
 
 
409
        """See Repository.has_revision()."""
 
 
410
        if revision_id == NULL_REVISION:
 
 
411
            # The null revision is always present.
 
 
413
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
414
        response = self._client.call(
 
 
415
            'Repository.has_revision', path, revision_id)
 
 
416
        if response[0] not in ('yes', 'no'):
 
 
417
            raise errors.UnexpectedSmartServerResponse(response)
 
 
418
        return response[0] == 'yes'
 
 
420
    def has_revisions(self, revision_ids):
 
 
421
        """See Repository.has_revisions()."""
 
 
423
        for revision_id in revision_ids:
 
 
424
            if self.has_revision(revision_id):
 
 
425
                result.add(revision_id)
 
 
428
    def has_same_location(self, other):
 
 
429
        return (self.__class__ == other.__class__ and
 
 
430
                self.bzrdir.transport.base == other.bzrdir.transport.base)
 
 
432
    def get_graph(self, other_repository=None):
 
 
433
        """Return the graph for this repository format"""
 
 
434
        parents_provider = self
 
 
435
        if (other_repository is not None and
 
 
436
            other_repository.bzrdir.transport.base !=
 
 
437
            self.bzrdir.transport.base):
 
 
438
            parents_provider = graph._StackedParentsProvider(
 
 
439
                [parents_provider, other_repository._make_parents_provider()])
 
 
440
        return graph.Graph(parents_provider)
 
 
442
    def gather_stats(self, revid=None, committers=None):
 
 
443
        """See Repository.gather_stats()."""
 
 
444
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
445
        # revid can be None to indicate no revisions, not just NULL_REVISION
 
 
446
        if revid is None or revision.is_null(revid):
 
 
450
        if committers is None or not committers:
 
 
451
            fmt_committers = 'no'
 
 
453
            fmt_committers = 'yes'
 
 
454
        response_tuple, response_handler = self._client.call_expecting_body(
 
 
455
            'Repository.gather_stats', path, fmt_revid, fmt_committers)
 
 
456
        if response_tuple[0] != 'ok':
 
 
457
            raise errors.UnexpectedSmartServerResponse(response_tuple)
 
 
459
        body = response_handler.read_body_bytes()
 
 
461
        for line in body.split('\n'):
 
 
464
            key, val_text = line.split(':')
 
 
465
            if key in ('revisions', 'size', 'committers'):
 
 
466
                result[key] = int(val_text)
 
 
467
            elif key in ('firstrev', 'latestrev'):
 
 
468
                values = val_text.split(' ')[1:]
 
 
469
                result[key] = (float(values[0]), long(values[1]))
 
 
473
    def find_branches(self, using=False):
 
 
474
        """See Repository.find_branches()."""
 
 
475
        # should be an API call to the server.
 
 
477
        return self._real_repository.find_branches(using=using)
 
 
479
    def get_physical_lock_status(self):
 
 
480
        """See Repository.get_physical_lock_status()."""
 
 
481
        # should be an API call to the server.
 
 
483
        return self._real_repository.get_physical_lock_status()
 
 
485
    def is_in_write_group(self):
 
 
486
        """Return True if there is an open write group.
 
 
488
        write groups are only applicable locally for the smart server..
 
 
490
        if self._real_repository:
 
 
491
            return self._real_repository.is_in_write_group()
 
 
494
        return self._lock_count >= 1
 
 
497
        """See Repository.is_shared()."""
 
 
498
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
499
        response = self._client.call('Repository.is_shared', path)
 
 
500
        if response[0] not in ('yes', 'no'):
 
 
501
            raise SmartProtocolError('unexpected response code %s' % (response,))
 
 
502
        return response[0] == 'yes'
 
 
504
    def is_write_locked(self):
 
 
505
        return self._lock_mode == 'w'
 
 
508
        # wrong eventually - want a local lock cache context
 
 
509
        if not self._lock_mode:
 
 
510
            self._lock_mode = 'r'
 
 
512
            self._parents_map = {}
 
 
513
            if 'hpss' in debug.debug_flags:
 
 
514
                self._requested_parents = set()
 
 
515
            if self._real_repository is not None:
 
 
516
                self._real_repository.lock_read()
 
 
518
            self._lock_count += 1
 
 
520
    def _remote_lock_write(self, token):
 
 
521
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
525
            response = self._client.call('Repository.lock_write', path, token)
 
 
526
        except errors.ErrorFromSmartServer, err:
 
 
527
            if err.error_verb == 'LockContention':
 
 
528
                raise errors.LockContention('(remote lock)')
 
 
529
            elif err.error_verb == 'UnlockableTransport':
 
 
530
                raise errors.UnlockableTransport(self.bzrdir.root_transport)
 
 
531
            elif err.error_verb == 'LockFailed':
 
 
532
                raise errors.LockFailed(err.error_args[0], err.error_args[1])
 
 
535
        if response[0] == 'ok':
 
 
539
            raise errors.UnexpectedSmartServerResponse(response)
 
 
541
    def lock_write(self, token=None):
 
 
542
        if not self._lock_mode:
 
 
543
            self._lock_token = self._remote_lock_write(token)
 
 
544
            # if self._lock_token is None, then this is something like packs or
 
 
545
            # svn where we don't get to lock the repo, or a weave style repository
 
 
546
            # where we cannot lock it over the wire and attempts to do so will
 
 
548
            if self._real_repository is not None:
 
 
549
                self._real_repository.lock_write(token=self._lock_token)
 
 
550
            if token is not None:
 
 
551
                self._leave_lock = True
 
 
553
                self._leave_lock = False
 
 
554
            self._lock_mode = 'w'
 
 
556
            self._parents_map = {}
 
 
557
            if 'hpss' in debug.debug_flags:
 
 
558
                self._requested_parents = set()
 
 
559
        elif self._lock_mode == 'r':
 
 
560
            raise errors.ReadOnlyError(self)
 
 
562
            self._lock_count += 1
 
 
563
        return self._lock_token or None
 
 
565
    def leave_lock_in_place(self):
 
 
566
        if not self._lock_token:
 
 
567
            raise NotImplementedError(self.leave_lock_in_place)
 
 
568
        self._leave_lock = True
 
 
570
    def dont_leave_lock_in_place(self):
 
 
571
        if not self._lock_token:
 
 
572
            raise NotImplementedError(self.dont_leave_lock_in_place)
 
 
573
        self._leave_lock = False
 
 
575
    def _set_real_repository(self, repository):
 
 
576
        """Set the _real_repository for this repository.
 
 
578
        :param repository: The repository to fallback to for non-hpss
 
 
579
            implemented operations.
 
 
581
        if isinstance(repository, RemoteRepository):
 
 
582
            raise AssertionError()
 
 
583
        self._real_repository = repository
 
 
584
        if self._lock_mode == 'w':
 
 
585
            # if we are already locked, the real repository must be able to
 
 
586
            # acquire the lock with our token.
 
 
587
            self._real_repository.lock_write(self._lock_token)
 
 
588
        elif self._lock_mode == 'r':
 
 
589
            self._real_repository.lock_read()
 
 
591
    def start_write_group(self):
 
 
592
        """Start a write group on the decorated repository.
 
 
594
        Smart methods peform operations in a single step so this api
 
 
595
        is not really applicable except as a compatibility thunk
 
 
596
        for older plugins that don't use e.g. the CommitBuilder
 
 
600
        return self._real_repository.start_write_group()
 
 
602
    def _unlock(self, token):
 
 
603
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
605
            # with no token the remote repository is not persistently locked.
 
 
608
            response = self._client.call('Repository.unlock', path, token)
 
 
609
        except errors.ErrorFromSmartServer, err:
 
 
610
            if err.error_verb == 'TokenMismatch':
 
 
611
                raise errors.TokenMismatch(token, '(remote token)')
 
 
613
        if response == ('ok',):
 
 
616
            raise errors.UnexpectedSmartServerResponse(response)
 
 
619
        self._lock_count -= 1
 
 
620
        if self._lock_count > 0:
 
 
622
        self._parents_map = None
 
 
623
        if 'hpss' in debug.debug_flags:
 
 
624
            self._requested_parents = None
 
 
625
        old_mode = self._lock_mode
 
 
626
        self._lock_mode = None
 
 
628
            # The real repository is responsible at present for raising an
 
 
629
            # exception if it's in an unfinished write group.  However, it
 
 
630
            # normally will *not* actually remove the lock from disk - that's
 
 
631
            # done by the server on receiving the Repository.unlock call.
 
 
632
            # This is just to let the _real_repository stay up to date.
 
 
633
            if self._real_repository is not None:
 
 
634
                self._real_repository.unlock()
 
 
636
            # The rpc-level lock should be released even if there was a
 
 
637
            # problem releasing the vfs-based lock.
 
 
639
                # Only write-locked repositories need to make a remote method
 
 
640
                # call to perfom the unlock.
 
 
641
                old_token = self._lock_token
 
 
642
                self._lock_token = None
 
 
643
                if not self._leave_lock:
 
 
644
                    self._unlock(old_token)
 
 
646
    def break_lock(self):
 
 
647
        # should hand off to the network
 
 
649
        return self._real_repository.break_lock()
 
 
651
    def _get_tarball(self, compression):
 
 
652
        """Return a TemporaryFile containing a repository tarball.
 
 
654
        Returns None if the server does not support sending tarballs.
 
 
657
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
659
            response, protocol = self._client.call_expecting_body(
 
 
660
                'Repository.tarball', path, compression)
 
 
661
        except errors.UnknownSmartMethod:
 
 
662
            protocol.cancel_read_body()
 
 
664
        if response[0] == 'ok':
 
 
665
            # Extract the tarball and return it
 
 
666
            t = tempfile.NamedTemporaryFile()
 
 
667
            # TODO: rpc layer should read directly into it...
 
 
668
            t.write(protocol.read_body_bytes())
 
 
671
        raise errors.UnexpectedSmartServerResponse(response)
 
 
673
    def sprout(self, to_bzrdir, revision_id=None):
 
 
674
        # TODO: Option to control what format is created?
 
 
676
        dest_repo = self._real_repository._format.initialize(to_bzrdir,
 
 
678
        dest_repo.fetch(self, revision_id=revision_id)
 
 
681
    ### These methods are just thin shims to the VFS object for now.
 
 
683
    def revision_tree(self, revision_id):
 
 
685
        return self._real_repository.revision_tree(revision_id)
 
 
687
    def get_serializer_format(self):
 
 
689
        return self._real_repository.get_serializer_format()
 
 
691
    def get_commit_builder(self, branch, parents, config, timestamp=None,
 
 
692
                           timezone=None, committer=None, revprops=None,
 
 
694
        # FIXME: It ought to be possible to call this without immediately
 
 
695
        # triggering _ensure_real.  For now it's the easiest thing to do.
 
 
697
        builder = self._real_repository.get_commit_builder(branch, parents,
 
 
698
                config, timestamp=timestamp, timezone=timezone,
 
 
699
                committer=committer, revprops=revprops, revision_id=revision_id)
 
 
702
    def add_inventory(self, revid, inv, parents):
 
 
704
        return self._real_repository.add_inventory(revid, inv, parents)
 
 
706
    def add_revision(self, rev_id, rev, inv=None, config=None):
 
 
708
        return self._real_repository.add_revision(
 
 
709
            rev_id, rev, inv=inv, config=config)
 
 
712
    def get_inventory(self, revision_id):
 
 
714
        return self._real_repository.get_inventory(revision_id)
 
 
716
    def iter_inventories(self, revision_ids):
 
 
718
        return self._real_repository.iter_inventories(revision_ids)
 
 
721
    def get_revision(self, revision_id):
 
 
723
        return self._real_repository.get_revision(revision_id)
 
 
726
    def weave_store(self):
 
 
728
        return self._real_repository.weave_store
 
 
730
    def get_transaction(self):
 
 
732
        return self._real_repository.get_transaction()
 
 
735
    def clone(self, a_bzrdir, revision_id=None):
 
 
737
        return self._real_repository.clone(a_bzrdir, revision_id=revision_id)
 
 
739
    def make_working_trees(self):
 
 
740
        """See Repository.make_working_trees"""
 
 
742
        return self._real_repository.make_working_trees()
 
 
744
    def revision_ids_to_search_result(self, result_set):
 
 
745
        """Convert a set of revision ids to a graph SearchResult."""
 
 
746
        result_parents = set()
 
 
747
        for parents in self.get_graph().get_parent_map(
 
 
748
            result_set).itervalues():
 
 
749
            result_parents.update(parents)
 
 
750
        included_keys = result_set.intersection(result_parents)
 
 
751
        start_keys = result_set.difference(included_keys)
 
 
752
        exclude_keys = result_parents.difference(result_set)
 
 
753
        result = graph.SearchResult(start_keys, exclude_keys,
 
 
754
            len(result_set), result_set)
 
 
758
    def search_missing_revision_ids(self, other, revision_id=None, find_ghosts=True):
 
 
759
        """Return the revision ids that other has that this does not.
 
 
761
        These are returned in topological order.
 
 
763
        revision_id: only return revision ids included by revision_id.
 
 
765
        return repository.InterRepository.get(
 
 
766
            other, self).search_missing_revision_ids(revision_id, find_ghosts)
 
 
768
    def fetch(self, source, revision_id=None, pb=None):
 
 
769
        if self.has_same_location(source):
 
 
770
            # check that last_revision is in 'from' and then return a
 
 
772
            if (revision_id is not None and
 
 
773
                not revision.is_null(revision_id)):
 
 
774
                self.get_revision(revision_id)
 
 
777
        return self._real_repository.fetch(
 
 
778
            source, revision_id=revision_id, pb=pb)
 
 
780
    def create_bundle(self, target, base, fileobj, format=None):
 
 
782
        self._real_repository.create_bundle(target, base, fileobj, format)
 
 
785
    def control_weaves(self):
 
 
787
        return self._real_repository.control_weaves
 
 
790
    def get_ancestry(self, revision_id, topo_sorted=True):
 
 
792
        return self._real_repository.get_ancestry(revision_id, topo_sorted)
 
 
795
    def get_inventory_weave(self):
 
 
797
        return self._real_repository.get_inventory_weave()
 
 
799
    def fileids_altered_by_revision_ids(self, revision_ids):
 
 
801
        return self._real_repository.fileids_altered_by_revision_ids(revision_ids)
 
 
803
    def _get_versioned_file_checker(self, revisions, revision_versions_cache):
 
 
805
        return self._real_repository._get_versioned_file_checker(
 
 
806
            revisions, revision_versions_cache)
 
 
808
    def iter_files_bytes(self, desired_files):
 
 
809
        """See Repository.iter_file_bytes.
 
 
812
        return self._real_repository.iter_files_bytes(desired_files)
 
 
814
    def get_parent_map(self, keys):
 
 
815
        """See bzrlib.Graph.get_parent_map()."""
 
 
816
        # Hack to build up the caching logic.
 
 
817
        ancestry = self._parents_map
 
 
819
            # Repository is not locked, so there's no cache.
 
 
820
            missing_revisions = set(keys)
 
 
823
            missing_revisions = set(key for key in keys if key not in ancestry)
 
 
824
        if missing_revisions:
 
 
825
            parent_map = self._get_parent_map(missing_revisions)
 
 
826
            if 'hpss' in debug.debug_flags:
 
 
827
                mutter('retransmitted revisions: %d of %d',
 
 
828
                        len(set(ancestry).intersection(parent_map)),
 
 
830
            ancestry.update(parent_map)
 
 
831
        present_keys = [k for k in keys if k in ancestry]
 
 
832
        if 'hpss' in debug.debug_flags:
 
 
833
            if self._requested_parents is not None and len(ancestry) != 0:
 
 
834
                self._requested_parents.update(present_keys)
 
 
835
                mutter('Current RemoteRepository graph hit rate: %d%%',
 
 
836
                    100.0 * len(self._requested_parents) / len(ancestry))
 
 
837
        return dict((k, ancestry[k]) for k in present_keys)
 
 
839
    def _get_parent_map(self, keys):
 
 
840
        """Helper for get_parent_map that performs the RPC."""
 
 
841
        medium = self._client._medium
 
 
842
        if not medium._remote_is_at_least_1_2:
 
 
843
            # We already found out that the server can't understand
 
 
844
            # Repository.get_parent_map requests, so just fetch the whole
 
 
846
            # XXX: Note that this will issue a deprecation warning. This is ok
 
 
847
            # :- its because we're working with a deprecated server anyway, and
 
 
848
            # the user will almost certainly have seen a warning about the
 
 
849
            # server version already.
 
 
850
            rg = self.get_revision_graph()
 
 
851
            # There is an api discrepency between get_parent_map and
 
 
852
            # get_revision_graph. Specifically, a "key:()" pair in
 
 
853
            # get_revision_graph just means a node has no parents. For
 
 
854
            # "get_parent_map" it means the node is a ghost. So fix up the
 
 
855
            # graph to correct this.
 
 
856
            #   https://bugs.launchpad.net/bzr/+bug/214894
 
 
857
            # There is one other "bug" which is that ghosts in
 
 
858
            # get_revision_graph() are not returned at all. But we won't worry
 
 
859
            # about that for now.
 
 
860
            for node_id, parent_ids in rg.iteritems():
 
 
862
                    rg[node_id] = (NULL_REVISION,)
 
 
863
            rg[NULL_REVISION] = ()
 
 
868
            raise ValueError('get_parent_map(None) is not valid')
 
 
869
        if NULL_REVISION in keys:
 
 
870
            keys.discard(NULL_REVISION)
 
 
871
            found_parents = {NULL_REVISION:()}
 
 
876
        # TODO(Needs analysis): We could assume that the keys being requested
 
 
877
        # from get_parent_map are in a breadth first search, so typically they
 
 
878
        # will all be depth N from some common parent, and we don't have to
 
 
879
        # have the server iterate from the root parent, but rather from the
 
 
880
        # keys we're searching; and just tell the server the keyspace we
 
 
881
        # already have; but this may be more traffic again.
 
 
883
        # Transform self._parents_map into a search request recipe.
 
 
884
        # TODO: Manage this incrementally to avoid covering the same path
 
 
885
        # repeatedly. (The server will have to on each request, but the less
 
 
886
        # work done the better).
 
 
887
        parents_map = self._parents_map
 
 
888
        if parents_map is None:
 
 
889
            # Repository is not locked, so there's no cache.
 
 
891
        start_set = set(parents_map)
 
 
892
        result_parents = set()
 
 
893
        for parents in parents_map.itervalues():
 
 
894
            result_parents.update(parents)
 
 
895
        stop_keys = result_parents.difference(start_set)
 
 
896
        included_keys = start_set.intersection(result_parents)
 
 
897
        start_set.difference_update(included_keys)
 
 
898
        recipe = (start_set, stop_keys, len(parents_map))
 
 
899
        body = self._serialise_search_recipe(recipe)
 
 
900
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
902
            if type(key) is not str:
 
 
904
                    "key %r not a plain string" % (key,))
 
 
905
        verb = 'Repository.get_parent_map'
 
 
906
        args = (path,) + tuple(keys)
 
 
908
            response = self._client.call_with_body_bytes_expecting_body(
 
 
909
                verb, args, self._serialise_search_recipe(recipe))
 
 
910
        except errors.UnknownSmartMethod:
 
 
911
            # Server does not support this method, so get the whole graph.
 
 
912
            # Worse, we have to force a disconnection, because the server now
 
 
913
            # doesn't realise it has a body on the wire to consume, so the
 
 
914
            # only way to recover is to abandon the connection.
 
 
916
                'Server is too old for fast get_parent_map, reconnecting.  '
 
 
917
                '(Upgrade the server to Bazaar 1.2 to avoid this)')
 
 
919
            # To avoid having to disconnect repeatedly, we keep track of the
 
 
920
            # fact the server doesn't understand remote methods added in 1.2.
 
 
921
            medium._remote_is_at_least_1_2 = False
 
 
922
            return self.get_revision_graph(None)
 
 
923
        response_tuple, response_handler = response
 
 
924
        if response_tuple[0] not in ['ok']:
 
 
925
            response_handler.cancel_read_body()
 
 
926
            raise errors.UnexpectedSmartServerResponse(response_tuple)
 
 
927
        if response_tuple[0] == 'ok':
 
 
928
            coded = bz2.decompress(response_handler.read_body_bytes())
 
 
932
            lines = coded.split('\n')
 
 
935
                d = tuple(line.split())
 
 
937
                    revision_graph[d[0]] = d[1:]
 
 
939
                    # No parents - so give the Graph result (NULL_REVISION,).
 
 
940
                    revision_graph[d[0]] = (NULL_REVISION,)
 
 
941
            return revision_graph
 
 
944
    def get_signature_text(self, revision_id):
 
 
946
        return self._real_repository.get_signature_text(revision_id)
 
 
949
    @symbol_versioning.deprecated_method(symbol_versioning.one_three)
 
 
950
    def get_revision_graph_with_ghosts(self, revision_ids=None):
 
 
952
        return self._real_repository.get_revision_graph_with_ghosts(
 
 
953
            revision_ids=revision_ids)
 
 
956
    def get_inventory_xml(self, revision_id):
 
 
958
        return self._real_repository.get_inventory_xml(revision_id)
 
 
960
    def deserialise_inventory(self, revision_id, xml):
 
 
962
        return self._real_repository.deserialise_inventory(revision_id, xml)
 
 
964
    def reconcile(self, other=None, thorough=False):
 
 
966
        return self._real_repository.reconcile(other=other, thorough=thorough)
 
 
968
    def all_revision_ids(self):
 
 
970
        return self._real_repository.all_revision_ids()
 
 
973
    def get_deltas_for_revisions(self, revisions):
 
 
975
        return self._real_repository.get_deltas_for_revisions(revisions)
 
 
978
    def get_revision_delta(self, revision_id):
 
 
980
        return self._real_repository.get_revision_delta(revision_id)
 
 
983
    def revision_trees(self, revision_ids):
 
 
985
        return self._real_repository.revision_trees(revision_ids)
 
 
988
    def get_revision_reconcile(self, revision_id):
 
 
990
        return self._real_repository.get_revision_reconcile(revision_id)
 
 
993
    def check(self, revision_ids=None):
 
 
995
        return self._real_repository.check(revision_ids=revision_ids)
 
 
997
    def copy_content_into(self, destination, revision_id=None):
 
 
999
        return self._real_repository.copy_content_into(
 
 
1000
            destination, revision_id=revision_id)
 
 
1002
    def _copy_repository_tarball(self, to_bzrdir, revision_id=None):
 
 
1003
        # get a tarball of the remote repository, and copy from that into the
 
 
1005
        from bzrlib import osutils
 
 
1008
        # TODO: Maybe a progress bar while streaming the tarball?
 
 
1009
        note("Copying repository content as tarball...")
 
 
1010
        tar_file = self._get_tarball('bz2')
 
 
1011
        if tar_file is None:
 
 
1013
        destination = to_bzrdir.create_repository()
 
 
1015
            tar = tarfile.open('repository', fileobj=tar_file,
 
 
1017
            tmpdir = tempfile.mkdtemp()
 
 
1019
                _extract_tar(tar, tmpdir)
 
 
1020
                tmp_bzrdir = BzrDir.open(tmpdir)
 
 
1021
                tmp_repo = tmp_bzrdir.open_repository()
 
 
1022
                tmp_repo.copy_content_into(destination, revision_id)
 
 
1024
                osutils.rmtree(tmpdir)
 
 
1028
        # TODO: Suggestion from john: using external tar is much faster than
 
 
1029
        # python's tarfile library, but it may not work on windows.
 
 
1033
        """Compress the data within the repository.
 
 
1035
        This is not currently implemented within the smart server.
 
 
1038
        return self._real_repository.pack()
 
 
1040
    def set_make_working_trees(self, new_value):
 
 
1042
        self._real_repository.set_make_working_trees(new_value)
 
 
1045
    def sign_revision(self, revision_id, gpg_strategy):
 
 
1047
        return self._real_repository.sign_revision(revision_id, gpg_strategy)
 
 
1050
    def get_revisions(self, revision_ids):
 
 
1052
        return self._real_repository.get_revisions(revision_ids)
 
 
1054
    def supports_rich_root(self):
 
 
1056
        return self._real_repository.supports_rich_root()
 
 
1058
    def iter_reverse_revision_history(self, revision_id):
 
 
1060
        return self._real_repository.iter_reverse_revision_history(revision_id)
 
 
1063
    def _serializer(self):
 
 
1065
        return self._real_repository._serializer
 
 
1067
    def store_revision_signature(self, gpg_strategy, plaintext, revision_id):
 
 
1069
        return self._real_repository.store_revision_signature(
 
 
1070
            gpg_strategy, plaintext, revision_id)
 
 
1072
    def add_signature_text(self, revision_id, signature):
 
 
1074
        return self._real_repository.add_signature_text(revision_id, signature)
 
 
1076
    def has_signature_for_revision_id(self, revision_id):
 
 
1078
        return self._real_repository.has_signature_for_revision_id(revision_id)
 
 
1080
    def get_data_stream_for_search(self, search):
 
 
1081
        medium = self._client._medium
 
 
1082
        if not medium._remote_is_at_least_1_2:
 
 
1084
            return self._real_repository.get_data_stream_for_search(search)
 
 
1085
        REQUEST_NAME = 'Repository.stream_revisions_chunked'
 
 
1086
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
1087
        body = self._serialise_search_recipe(search.get_recipe())
 
 
1089
            result = self._client.call_with_body_bytes_expecting_body(
 
 
1090
                REQUEST_NAME, (path,), body)
 
 
1091
            response, protocol = result
 
 
1092
        except errors.UnknownSmartMethod:
 
 
1093
            # Server does not support this method, so fall back to VFS.
 
 
1094
            # Worse, we have to force a disconnection, because the server now
 
 
1095
            # doesn't realise it has a body on the wire to consume, so the
 
 
1096
            # only way to recover is to abandon the connection.
 
 
1098
                'Server is too old for streaming pull, reconnecting.  '
 
 
1099
                '(Upgrade the server to Bazaar 1.2 to avoid this)')
 
 
1101
            # To avoid having to disconnect repeatedly, we keep track of the
 
 
1102
            # fact the server doesn't understand this remote method.
 
 
1103
            medium._remote_is_at_least_1_2 = False
 
 
1105
            return self._real_repository.get_data_stream_for_search(search)
 
 
1107
        if response == ('ok',):
 
 
1108
            return self._deserialise_stream(protocol)
 
 
1109
        if response == ('NoSuchRevision', ):
 
 
1110
            # We cannot easily identify the revision that is missing in this
 
 
1111
            # situation without doing much more network IO. For now, bail.
 
 
1112
            raise NoSuchRevision(self, "unknown")
 
 
1114
            raise errors.UnexpectedSmartServerResponse(response)
 
 
1116
    def _deserialise_stream(self, protocol):
 
 
1117
        stream = protocol.read_streamed_body()
 
 
1118
        container_parser = ContainerPushParser()
 
 
1119
        for bytes in stream:
 
 
1120
            container_parser.accept_bytes(bytes)
 
 
1121
            records = container_parser.read_pending_records()
 
 
1122
            for record_names, record_bytes in records:
 
 
1123
                if len(record_names) != 1:
 
 
1124
                    # These records should have only one name, and that name
 
 
1125
                    # should be a one-element tuple.
 
 
1126
                    raise errors.SmartProtocolError(
 
 
1127
                        'Repository data stream had invalid record name %r'
 
 
1129
                name_tuple = record_names[0]
 
 
1130
                yield name_tuple, record_bytes
 
 
1132
    def insert_data_stream(self, stream):
 
 
1134
        self._real_repository.insert_data_stream(stream)
 
 
1136
    def item_keys_introduced_by(self, revision_ids, _files_pb=None):
 
 
1138
        return self._real_repository.item_keys_introduced_by(revision_ids,
 
 
1139
            _files_pb=_files_pb)
 
 
1141
    def revision_graph_can_have_wrong_parents(self):
 
 
1142
        # The answer depends on the remote repo format.
 
 
1144
        return self._real_repository.revision_graph_can_have_wrong_parents()
 
 
1146
    def _find_inconsistent_revision_parents(self):
 
 
1148
        return self._real_repository._find_inconsistent_revision_parents()
 
 
1150
    def _check_for_inconsistent_revision_parents(self):
 
 
1152
        return self._real_repository._check_for_inconsistent_revision_parents()
 
 
1154
    def _make_parents_provider(self):
 
 
1157
    def _serialise_search_recipe(self, recipe):
 
 
1158
        """Serialise a graph search recipe.
 
 
1160
        :param recipe: A search recipe (start, stop, count).
 
 
1161
        :return: Serialised bytes.
 
 
1163
        start_keys = ' '.join(recipe[0])
 
 
1164
        stop_keys = ' '.join(recipe[1])
 
 
1165
        count = str(recipe[2])
 
 
1166
        return '\n'.join((start_keys, stop_keys, count))
 
 
1169
class RemoteBranchLockableFiles(LockableFiles):
 
 
1170
    """A 'LockableFiles' implementation that talks to a smart server.
 
 
1172
    This is not a public interface class.
 
 
1175
    def __init__(self, bzrdir, _client):
 
 
1176
        self.bzrdir = bzrdir
 
 
1177
        self._client = _client
 
 
1178
        self._need_find_modes = True
 
 
1179
        LockableFiles.__init__(
 
 
1180
            self, bzrdir.get_branch_transport(None),
 
 
1181
            'lock', lockdir.LockDir)
 
 
1183
    def _find_modes(self):
 
 
1184
        # RemoteBranches don't let the client set the mode of control files.
 
 
1185
        self._dir_mode = None
 
 
1186
        self._file_mode = None
 
 
1189
class RemoteBranchFormat(branch.BranchFormat):
 
 
1191
    def __eq__(self, other):
 
 
1192
        return (isinstance(other, RemoteBranchFormat) and 
 
 
1193
            self.__dict__ == other.__dict__)
 
 
1195
    def get_format_description(self):
 
 
1196
        return 'Remote BZR Branch'
 
 
1198
    def get_format_string(self):
 
 
1199
        return 'Remote BZR Branch'
 
 
1201
    def open(self, a_bzrdir):
 
 
1202
        return a_bzrdir.open_branch()
 
 
1204
    def initialize(self, a_bzrdir):
 
 
1205
        return a_bzrdir.create_branch()
 
 
1207
    def supports_tags(self):
 
 
1208
        # Remote branches might support tags, but we won't know until we
 
 
1209
        # access the real remote branch.
 
 
1213
class RemoteBranch(branch.Branch):
 
 
1214
    """Branch stored on a server accessed by HPSS RPC.
 
 
1216
    At the moment most operations are mapped down to simple file operations.
 
 
1219
    def __init__(self, remote_bzrdir, remote_repository, real_branch=None,
 
 
1221
        """Create a RemoteBranch instance.
 
 
1223
        :param real_branch: An optional local implementation of the branch
 
 
1224
            format, usually accessing the data via the VFS.
 
 
1225
        :param _client: Private parameter for testing.
 
 
1227
        # We intentionally don't call the parent class's __init__, because it
 
 
1228
        # will try to assign to self.tags, which is a property in this subclass.
 
 
1229
        # And the parent's __init__ doesn't do much anyway.
 
 
1230
        self._revision_id_to_revno_cache = None
 
 
1231
        self._revision_history_cache = None
 
 
1232
        self.bzrdir = remote_bzrdir
 
 
1233
        if _client is not None:
 
 
1234
            self._client = _client
 
 
1236
            self._client = remote_bzrdir._client
 
 
1237
        self.repository = remote_repository
 
 
1238
        if real_branch is not None:
 
 
1239
            self._real_branch = real_branch
 
 
1240
            # Give the remote repository the matching real repo.
 
 
1241
            real_repo = self._real_branch.repository
 
 
1242
            if isinstance(real_repo, RemoteRepository):
 
 
1243
                real_repo._ensure_real()
 
 
1244
                real_repo = real_repo._real_repository
 
 
1245
            self.repository._set_real_repository(real_repo)
 
 
1246
            # Give the branch the remote repository to let fast-pathing happen.
 
 
1247
            self._real_branch.repository = self.repository
 
 
1249
            self._real_branch = None
 
 
1250
        # Fill out expected attributes of branch for bzrlib api users.
 
 
1251
        self._format = RemoteBranchFormat()
 
 
1252
        self.base = self.bzrdir.root_transport.base
 
 
1253
        self._control_files = None
 
 
1254
        self._lock_mode = None
 
 
1255
        self._lock_token = None
 
 
1256
        self._repo_lock_token = None
 
 
1257
        self._lock_count = 0
 
 
1258
        self._leave_lock = False
 
 
1260
    def _ensure_real_transport(self):
 
 
1261
        # if we try vfs access, return the real branch's vfs transport
 
 
1263
        return self._real_branch._transport
 
 
1265
    _transport = property(_ensure_real_transport)
 
 
1268
        return "%s(%s)" % (self.__class__.__name__, self.base)
 
 
1272
    def _ensure_real(self):
 
 
1273
        """Ensure that there is a _real_branch set.
 
 
1275
        Used before calls to self._real_branch.
 
 
1277
        if self._real_branch is None:
 
 
1278
            if not vfs.vfs_enabled():
 
 
1279
                raise AssertionError('smart server vfs must be enabled '
 
 
1280
                    'to use vfs implementation')
 
 
1281
            self.bzrdir._ensure_real()
 
 
1282
            self._real_branch = self.bzrdir._real_bzrdir.open_branch()
 
 
1283
            # Give the remote repository the matching real repo.
 
 
1284
            real_repo = self._real_branch.repository
 
 
1285
            if isinstance(real_repo, RemoteRepository):
 
 
1286
                real_repo._ensure_real()
 
 
1287
                real_repo = real_repo._real_repository
 
 
1288
            self.repository._set_real_repository(real_repo)
 
 
1289
            # Give the branch the remote repository to let fast-pathing happen.
 
 
1290
            self._real_branch.repository = self.repository
 
 
1291
            # XXX: deal with _lock_mode == 'w'
 
 
1292
            if self._lock_mode == 'r':
 
 
1293
                self._real_branch.lock_read()
 
 
1296
    def control_files(self):
 
 
1297
        # Defer actually creating RemoteBranchLockableFiles until its needed,
 
 
1298
        # because it triggers an _ensure_real that we otherwise might not need.
 
 
1299
        if self._control_files is None:
 
 
1300
            self._control_files = RemoteBranchLockableFiles(
 
 
1301
                self.bzrdir, self._client)
 
 
1302
        return self._control_files
 
 
1304
    def _get_checkout_format(self):
 
 
1306
        return self._real_branch._get_checkout_format()
 
 
1308
    def get_physical_lock_status(self):
 
 
1309
        """See Branch.get_physical_lock_status()."""
 
 
1310
        # should be an API call to the server, as branches must be lockable.
 
 
1312
        return self._real_branch.get_physical_lock_status()
 
 
1314
    def lock_read(self):
 
 
1315
        if not self._lock_mode:
 
 
1316
            self._lock_mode = 'r'
 
 
1317
            self._lock_count = 1
 
 
1318
            if self._real_branch is not None:
 
 
1319
                self._real_branch.lock_read()
 
 
1321
            self._lock_count += 1
 
 
1323
    def _remote_lock_write(self, token):
 
 
1325
            branch_token = repo_token = ''
 
 
1327
            branch_token = token
 
 
1328
            repo_token = self.repository.lock_write()
 
 
1329
            self.repository.unlock()
 
 
1330
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
1332
            response = self._client.call(
 
 
1333
                'Branch.lock_write', path, branch_token, repo_token or '')
 
 
1334
        except errors.ErrorFromSmartServer, err:
 
 
1335
            if err.error_verb == 'LockContention':
 
 
1336
                raise errors.LockContention('(remote lock)')
 
 
1337
            elif err.error_verb == 'TokenMismatch':
 
 
1338
                raise errors.TokenMismatch(token, '(remote token)')
 
 
1339
            elif err.error_verb == 'UnlockableTransport':
 
 
1340
                raise errors.UnlockableTransport(self.bzrdir.root_transport)
 
 
1341
            elif err.error_verb == 'ReadOnlyError':
 
 
1342
                raise errors.ReadOnlyError(self)
 
 
1343
            elif err.error_verb == 'LockFailed':
 
 
1344
                raise errors.LockFailed(err.error_args[0], err.error_args[1])
 
 
1346
        if response[0] != 'ok':
 
 
1347
            raise errors.UnexpectedSmartServerResponse(response)
 
 
1348
        ok, branch_token, repo_token = response
 
 
1349
        return branch_token, repo_token
 
 
1351
    def lock_write(self, token=None):
 
 
1352
        if not self._lock_mode:
 
 
1353
            remote_tokens = self._remote_lock_write(token)
 
 
1354
            self._lock_token, self._repo_lock_token = remote_tokens
 
 
1355
            if not self._lock_token:
 
 
1356
                raise SmartProtocolError('Remote server did not return a token!')
 
 
1357
            # TODO: We really, really, really don't want to call _ensure_real
 
 
1358
            # here, but it's the easiest way to ensure coherency between the
 
 
1359
            # state of the RemoteBranch and RemoteRepository objects and the
 
 
1360
            # physical locks.  If we don't materialise the real objects here,
 
 
1361
            # then getting everything in the right state later is complex, so
 
 
1362
            # for now we just do it the lazy way.
 
 
1363
            #   -- Andrew Bennetts, 2007-02-22.
 
 
1365
            if self._real_branch is not None:
 
 
1366
                self._real_branch.repository.lock_write(
 
 
1367
                    token=self._repo_lock_token)
 
 
1369
                    self._real_branch.lock_write(token=self._lock_token)
 
 
1371
                    self._real_branch.repository.unlock()
 
 
1372
            if token is not None:
 
 
1373
                self._leave_lock = True
 
 
1375
                # XXX: this case seems to be unreachable; token cannot be None.
 
 
1376
                self._leave_lock = False
 
 
1377
            self._lock_mode = 'w'
 
 
1378
            self._lock_count = 1
 
 
1379
        elif self._lock_mode == 'r':
 
 
1380
            raise errors.ReadOnlyTransaction
 
 
1382
            if token is not None:
 
 
1383
                # A token was given to lock_write, and we're relocking, so check
 
 
1384
                # that the given token actually matches the one we already have.
 
 
1385
                if token != self._lock_token:
 
 
1386
                    raise errors.TokenMismatch(token, self._lock_token)
 
 
1387
            self._lock_count += 1
 
 
1388
        return self._lock_token or None
 
 
1390
    def _unlock(self, branch_token, repo_token):
 
 
1391
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
1393
            response = self._client.call('Branch.unlock', path, branch_token,
 
 
1395
        except errors.ErrorFromSmartServer, err:
 
 
1396
            if err.error_verb == 'TokenMismatch':
 
 
1397
                raise errors.TokenMismatch(
 
 
1398
                    str((branch_token, repo_token)), '(remote tokens)')
 
 
1400
        if response == ('ok',):
 
 
1402
        raise errors.UnexpectedSmartServerResponse(response)
 
 
1405
        self._lock_count -= 1
 
 
1406
        if not self._lock_count:
 
 
1407
            self._clear_cached_state()
 
 
1408
            mode = self._lock_mode
 
 
1409
            self._lock_mode = None
 
 
1410
            if self._real_branch is not None:
 
 
1411
                if (not self._leave_lock and mode == 'w' and
 
 
1412
                    self._repo_lock_token):
 
 
1413
                    # If this RemoteBranch will remove the physical lock for the
 
 
1414
                    # repository, make sure the _real_branch doesn't do it
 
 
1415
                    # first.  (Because the _real_branch's repository is set to
 
 
1416
                    # be the RemoteRepository.)
 
 
1417
                    self._real_branch.repository.leave_lock_in_place()
 
 
1418
                self._real_branch.unlock()
 
 
1420
                # Only write-locked branched need to make a remote method call
 
 
1421
                # to perfom the unlock.
 
 
1423
            if not self._lock_token:
 
 
1424
                raise AssertionError('Locked, but no token!')
 
 
1425
            branch_token = self._lock_token
 
 
1426
            repo_token = self._repo_lock_token
 
 
1427
            self._lock_token = None
 
 
1428
            self._repo_lock_token = None
 
 
1429
            if not self._leave_lock:
 
 
1430
                self._unlock(branch_token, repo_token)
 
 
1432
    def break_lock(self):
 
 
1434
        return self._real_branch.break_lock()
 
 
1436
    def leave_lock_in_place(self):
 
 
1437
        if not self._lock_token:
 
 
1438
            raise NotImplementedError(self.leave_lock_in_place)
 
 
1439
        self._leave_lock = True
 
 
1441
    def dont_leave_lock_in_place(self):
 
 
1442
        if not self._lock_token:
 
 
1443
            raise NotImplementedError(self.dont_leave_lock_in_place)
 
 
1444
        self._leave_lock = False
 
 
1446
    def last_revision_info(self):
 
 
1447
        """See Branch.last_revision_info()."""
 
 
1448
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
1449
        response = self._client.call('Branch.last_revision_info', path)
 
 
1450
        if response[0] != 'ok':
 
 
1451
            raise SmartProtocolError('unexpected response code %s' % (response,))
 
 
1452
        revno = int(response[1])
 
 
1453
        last_revision = response[2]
 
 
1454
        return (revno, last_revision)
 
 
1456
    def _gen_revision_history(self):
 
 
1457
        """See Branch._gen_revision_history()."""
 
 
1458
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
1459
        response_tuple, response_handler = self._client.call_expecting_body(
 
 
1460
            'Branch.revision_history', path)
 
 
1461
        if response_tuple[0] != 'ok':
 
 
1462
            raise UnexpectedSmartServerResponse(response_tuple)
 
 
1463
        result = response_handler.read_body_bytes().split('\x00')
 
 
1469
    def set_revision_history(self, rev_history):
 
 
1470
        # Send just the tip revision of the history; the server will generate
 
 
1471
        # the full history from that.  If the revision doesn't exist in this
 
 
1472
        # branch, NoSuchRevision will be raised.
 
 
1473
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
1474
        if rev_history == []:
 
 
1477
            rev_id = rev_history[-1]
 
 
1478
        self._clear_cached_state()
 
 
1480
            response = self._client.call('Branch.set_last_revision',
 
 
1481
                path, self._lock_token, self._repo_lock_token, rev_id)
 
 
1482
        except errors.ErrorFromSmartServer, err:
 
 
1483
            if err.error_verb == 'NoSuchRevision':
 
 
1484
                raise NoSuchRevision(self, rev_id)
 
 
1486
        if response != ('ok',):
 
 
1487
            raise errors.UnexpectedSmartServerResponse(response)
 
 
1488
        self._cache_revision_history(rev_history)
 
 
1490
    def get_parent(self):
 
 
1492
        return self._real_branch.get_parent()
 
 
1494
    def set_parent(self, url):
 
 
1496
        return self._real_branch.set_parent(url)
 
 
1498
    def sprout(self, to_bzrdir, revision_id=None):
 
 
1499
        # Like Branch.sprout, except that it sprouts a branch in the default
 
 
1500
        # format, because RemoteBranches can't be created at arbitrary URLs.
 
 
1501
        # XXX: if to_bzrdir is a RemoteBranch, this should perhaps do
 
 
1502
        # to_bzrdir.create_branch...
 
 
1504
        result = self._real_branch._format.initialize(to_bzrdir)
 
 
1505
        self.copy_content_into(result, revision_id=revision_id)
 
 
1506
        result.set_parent(self.bzrdir.root_transport.base)
 
 
1510
    def pull(self, source, overwrite=False, stop_revision=None,
 
 
1512
        # FIXME: This asks the real branch to run the hooks, which means
 
 
1513
        # they're called with the wrong target branch parameter. 
 
 
1514
        # The test suite specifically allows this at present but it should be
 
 
1515
        # fixed.  It should get a _override_hook_target branch,
 
 
1516
        # as push does.  -- mbp 20070405
 
 
1518
        self._real_branch.pull(
 
 
1519
            source, overwrite=overwrite, stop_revision=stop_revision,
 
 
1523
    def push(self, target, overwrite=False, stop_revision=None):
 
 
1525
        return self._real_branch.push(
 
 
1526
            target, overwrite=overwrite, stop_revision=stop_revision,
 
 
1527
            _override_hook_source_branch=self)
 
 
1529
    def is_locked(self):
 
 
1530
        return self._lock_count >= 1
 
 
1533
    def set_last_revision_info(self, revno, revision_id):
 
 
1534
        revision_id = ensure_null(revision_id)
 
 
1535
        path = self.bzrdir._path_for_remote_call(self._client)
 
 
1537
            response = self._client.call('Branch.set_last_revision_info',
 
 
1538
                path, self._lock_token, self._repo_lock_token, str(revno), revision_id)
 
 
1539
        except errors.UnknownSmartMethod:
 
 
1541
            self._clear_cached_state()
 
 
1542
            return self._real_branch.set_last_revision_info(revno, revision_id)
 
 
1543
        except errors.ErrorFromSmartServer, err:
 
 
1544
            if err.error_verb == 'NoSuchRevision':
 
 
1545
                raise NoSuchRevision(self, err.error_args[0])
 
 
1547
        if response == ('ok',):
 
 
1548
            self._clear_cached_state()
 
 
1550
            raise errors.UnexpectedSmartServerResponse(response)
 
 
1552
    def generate_revision_history(self, revision_id, last_rev=None,
 
 
1555
        return self._real_branch.generate_revision_history(
 
 
1556
            revision_id, last_rev=last_rev, other_branch=other_branch)
 
 
1561
        return self._real_branch.tags
 
 
1563
    def set_push_location(self, location):
 
 
1565
        return self._real_branch.set_push_location(location)
 
 
1567
    def update_revisions(self, other, stop_revision=None, overwrite=False):
 
 
1569
        return self._real_branch.update_revisions(
 
 
1570
            other, stop_revision=stop_revision, overwrite=overwrite)
 
 
1573
def _extract_tar(tar, to_dir):
 
 
1574
    """Extract all the contents of a tarfile object.
 
 
1576
    A replacement for extractall, which is not present in python2.4
 
 
1579
        tar.extract(tarinfo, to_dir)