~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/remote.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2008-02-06 01:45:28 UTC
  • mfrom: (3211.5.4 integration)
  • Revision ID: pqm@pqm.ubuntu.com-20080206014528-rb8v4hl04mgxulb7
(robertc) Tune RemoteRepository.get_parent_map to not send duplicate
        results, and to compress the data,
        reducing round trips further. (Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
# Copyright (C) 2006, 2007 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
from cStringIO import StringIO
 
22
 
 
23
from bzrlib import (
 
24
    branch,
 
25
    debug,
 
26
    errors,
 
27
    graph,
 
28
    lockdir,
 
29
    repository,
 
30
    revision,
 
31
)
 
32
from bzrlib.branch import BranchReferenceFormat
 
33
from bzrlib.bzrdir import BzrDir, RemoteBzrDirFormat
 
34
from bzrlib.config import BranchConfig, TreeConfig
 
35
from bzrlib.decorators import needs_read_lock, needs_write_lock
 
36
from bzrlib.errors import NoSuchRevision
 
37
from bzrlib.lockable_files import LockableFiles
 
38
from bzrlib.pack import ContainerPushParser
 
39
from bzrlib.smart import client, vfs
 
40
from bzrlib.symbol_versioning import (
 
41
    deprecated_method,
 
42
    zero_ninetyone,
 
43
    )
 
44
from bzrlib.revision import NULL_REVISION
 
45
from bzrlib.trace import mutter, note
 
46
 
 
47
# Note: RemoteBzrDirFormat is in bzrdir.py
 
48
 
 
49
class RemoteBzrDir(BzrDir):
 
50
    """Control directory on a remote server, accessed via bzr:// or similar."""
 
51
 
 
52
    def __init__(self, transport, _client=None):
 
53
        """Construct a RemoteBzrDir.
 
54
 
 
55
        :param _client: Private parameter for testing. Disables probing and the
 
56
            use of a real bzrdir.
 
57
        """
 
58
        BzrDir.__init__(self, transport, RemoteBzrDirFormat())
 
59
        # this object holds a delegated bzrdir that uses file-level operations
 
60
        # to talk to the other side
 
61
        self._real_bzrdir = None
 
62
 
 
63
        if _client is None:
 
64
            self._shared_medium = transport.get_shared_medium()
 
65
            self._client = client._SmartClient(self._shared_medium)
 
66
        else:
 
67
            self._client = _client
 
68
            self._shared_medium = None
 
69
            return
 
70
 
 
71
        path = self._path_for_remote_call(self._client)
 
72
        response = self._client.call('BzrDir.open', path)
 
73
        if response not in [('yes',), ('no',)]:
 
74
            raise errors.UnexpectedSmartServerResponse(response)
 
75
        if response == ('no',):
 
76
            raise errors.NotBranchError(path=transport.base)
 
77
 
 
78
    def _ensure_real(self):
 
79
        """Ensure that there is a _real_bzrdir set.
 
80
 
 
81
        Used before calls to self._real_bzrdir.
 
82
        """
 
83
        if not self._real_bzrdir:
 
84
            self._real_bzrdir = BzrDir.open_from_transport(
 
85
                self.root_transport, _server_formats=False)
 
86
 
 
87
    def create_repository(self, shared=False):
 
88
        self._ensure_real()
 
89
        self._real_bzrdir.create_repository(shared=shared)
 
90
        return self.open_repository()
 
91
 
 
92
    def destroy_repository(self):
 
93
        """See BzrDir.destroy_repository"""
 
94
        self._ensure_real()
 
95
        self._real_bzrdir.destroy_repository()
 
96
 
 
97
    def create_branch(self):
 
98
        self._ensure_real()
 
99
        real_branch = self._real_bzrdir.create_branch()
 
100
        return RemoteBranch(self, self.find_repository(), real_branch)
 
101
 
 
102
    def destroy_branch(self):
 
103
        """See BzrDir.destroy_branch"""
 
104
        self._ensure_real()
 
105
        self._real_bzrdir.destroy_branch()
 
106
 
 
107
    def create_workingtree(self, revision_id=None, from_branch=None):
 
108
        raise errors.NotLocalUrl(self.transport.base)
 
109
 
 
110
    def find_branch_format(self):
 
111
        """Find the branch 'format' for this bzrdir.
 
112
 
 
113
        This might be a synthetic object for e.g. RemoteBranch and SVN.
 
114
        """
 
115
        b = self.open_branch()
 
116
        return b._format
 
117
 
 
118
    def get_branch_reference(self):
 
119
        """See BzrDir.get_branch_reference()."""
 
120
        path = self._path_for_remote_call(self._client)
 
121
        response = self._client.call('BzrDir.open_branch', path)
 
122
        if response[0] == 'ok':
 
123
            if response[1] == '':
 
124
                # branch at this location.
 
125
                return None
 
126
            else:
 
127
                # a branch reference, use the existing BranchReference logic.
 
128
                return response[1]
 
129
        elif response == ('nobranch',):
 
130
            raise errors.NotBranchError(path=self.root_transport.base)
 
131
        else:
 
132
            raise errors.UnexpectedSmartServerResponse(response)
 
133
 
 
134
    def _get_tree_branch(self):
 
135
        """See BzrDir._get_tree_branch()."""
 
136
        return None, self.open_branch()
 
137
 
 
138
    def open_branch(self, _unsupported=False):
 
139
        assert _unsupported == False, 'unsupported flag support not implemented yet.'
 
140
        reference_url = self.get_branch_reference()
 
141
        if reference_url is None:
 
142
            # branch at this location.
 
143
            return RemoteBranch(self, self.find_repository())
 
144
        else:
 
145
            # a branch reference, use the existing BranchReference logic.
 
146
            format = BranchReferenceFormat()
 
147
            return format.open(self, _found=True, location=reference_url)
 
148
                
 
149
    def open_repository(self):
 
150
        path = self._path_for_remote_call(self._client)
 
151
        response = self._client.call('BzrDir.find_repository', path)
 
152
        assert response[0] in ('ok', 'norepository'), \
 
153
            'unexpected response code %s' % (response,)
 
154
        if response[0] == 'norepository':
 
155
            raise errors.NoRepositoryPresent(self)
 
156
        assert len(response) == 4, 'incorrect response length %s' % (response,)
 
157
        if response[1] == '':
 
158
            format = RemoteRepositoryFormat()
 
159
            format.rich_root_data = (response[2] == 'yes')
 
160
            format.supports_tree_reference = (response[3] == 'yes')
 
161
            return RemoteRepository(self, format)
 
162
        else:
 
163
            raise errors.NoRepositoryPresent(self)
 
164
 
 
165
    def open_workingtree(self, recommend_upgrade=True):
 
166
        self._ensure_real()
 
167
        if self._real_bzrdir.has_workingtree():
 
168
            raise errors.NotLocalUrl(self.root_transport)
 
169
        else:
 
170
            raise errors.NoWorkingTree(self.root_transport.base)
 
171
 
 
172
    def _path_for_remote_call(self, client):
 
173
        """Return the path to be used for this bzrdir in a remote call."""
 
174
        return client.remote_path_from_transport(self.root_transport)
 
175
 
 
176
    def get_branch_transport(self, branch_format):
 
177
        self._ensure_real()
 
178
        return self._real_bzrdir.get_branch_transport(branch_format)
 
179
 
 
180
    def get_repository_transport(self, repository_format):
 
181
        self._ensure_real()
 
182
        return self._real_bzrdir.get_repository_transport(repository_format)
 
183
 
 
184
    def get_workingtree_transport(self, workingtree_format):
 
185
        self._ensure_real()
 
186
        return self._real_bzrdir.get_workingtree_transport(workingtree_format)
 
187
 
 
188
    def can_convert_format(self):
 
189
        """Upgrading of remote bzrdirs is not supported yet."""
 
190
        return False
 
191
 
 
192
    def needs_format_conversion(self, format=None):
 
193
        """Upgrading of remote bzrdirs is not supported yet."""
 
194
        return False
 
195
 
 
196
    def clone(self, url, revision_id=None, force_new_repo=False):
 
197
        self._ensure_real()
 
198
        return self._real_bzrdir.clone(url, revision_id=revision_id,
 
199
            force_new_repo=force_new_repo)
 
200
 
 
201
 
 
202
class RemoteRepositoryFormat(repository.RepositoryFormat):
 
203
    """Format for repositories accessed over a _SmartClient.
 
204
 
 
205
    Instances of this repository are represented by RemoteRepository
 
206
    instances.
 
207
 
 
208
    The RemoteRepositoryFormat is parameterized during construction
 
209
    to reflect the capabilities of the real, remote format. Specifically
 
210
    the attributes rich_root_data and supports_tree_reference are set
 
211
    on a per instance basis, and are not set (and should not be) at
 
212
    the class level.
 
213
    """
 
214
 
 
215
    _matchingbzrdir = RemoteBzrDirFormat
 
216
 
 
217
    def initialize(self, a_bzrdir, shared=False):
 
218
        assert isinstance(a_bzrdir, RemoteBzrDir), \
 
219
            '%r is not a RemoteBzrDir' % (a_bzrdir,)
 
220
        return a_bzrdir.create_repository(shared=shared)
 
221
    
 
222
    def open(self, a_bzrdir):
 
223
        assert isinstance(a_bzrdir, RemoteBzrDir)
 
224
        return a_bzrdir.open_repository()
 
225
 
 
226
    def get_format_description(self):
 
227
        return 'bzr remote repository'
 
228
 
 
229
    def __eq__(self, other):
 
230
        return self.__class__ == other.__class__
 
231
 
 
232
    def check_conversion_target(self, target_format):
 
233
        if self.rich_root_data and not target_format.rich_root_data:
 
234
            raise errors.BadConversionTarget(
 
235
                'Does not support rich root data.', target_format)
 
236
        if (self.supports_tree_reference and
 
237
            not getattr(target_format, 'supports_tree_reference', False)):
 
238
            raise errors.BadConversionTarget(
 
239
                'Does not support nested trees', target_format)
 
240
 
 
241
 
 
242
class RemoteRepository(object):
 
243
    """Repository accessed over rpc.
 
244
 
 
245
    For the moment most operations are performed using local transport-backed
 
246
    Repository objects.
 
247
    """
 
248
 
 
249
    def __init__(self, remote_bzrdir, format, real_repository=None, _client=None):
 
250
        """Create a RemoteRepository instance.
 
251
        
 
252
        :param remote_bzrdir: The bzrdir hosting this repository.
 
253
        :param format: The RemoteFormat object to use.
 
254
        :param real_repository: If not None, a local implementation of the
 
255
            repository logic for the repository, usually accessing the data
 
256
            via the VFS.
 
257
        :param _client: Private testing parameter - override the smart client
 
258
            to be used by the repository.
 
259
        """
 
260
        if real_repository:
 
261
            self._real_repository = real_repository
 
262
        else:
 
263
            self._real_repository = None
 
264
        self.bzrdir = remote_bzrdir
 
265
        if _client is None:
 
266
            self._client = client._SmartClient(self.bzrdir._shared_medium)
 
267
        else:
 
268
            self._client = _client
 
269
        self._format = format
 
270
        self._lock_mode = None
 
271
        self._lock_token = None
 
272
        self._lock_count = 0
 
273
        self._leave_lock = False
 
274
        # A cache of looked up revision parent data; reset at unlock time.
 
275
        self._parents_map = None
 
276
        if 'hpss' in debug.debug_flags:
 
277
            self._requested_parents = None
 
278
        # For tests:
 
279
        # These depend on the actual remote format, so force them off for
 
280
        # maximum compatibility. XXX: In future these should depend on the
 
281
        # remote repository instance, but this is irrelevant until we perform
 
282
        # reconcile via an RPC call.
 
283
        self._reconcile_does_inventory_gc = False
 
284
        self._reconcile_fixes_text_parents = False
 
285
        self._reconcile_backsup_inventory = False
 
286
        self.base = self.bzrdir.transport.base
 
287
 
 
288
    def __str__(self):
 
289
        return "%s(%s)" % (self.__class__.__name__, self.base)
 
290
 
 
291
    __repr__ = __str__
 
292
 
 
293
    def abort_write_group(self):
 
294
        """Complete a write group on the decorated repository.
 
295
        
 
296
        Smart methods peform operations in a single step so this api
 
297
        is not really applicable except as a compatibility thunk
 
298
        for older plugins that don't use e.g. the CommitBuilder
 
299
        facility.
 
300
        """
 
301
        self._ensure_real()
 
302
        return self._real_repository.abort_write_group()
 
303
 
 
304
    def commit_write_group(self):
 
305
        """Complete a write group on the decorated repository.
 
306
        
 
307
        Smart methods peform operations in a single step so this api
 
308
        is not really applicable except as a compatibility thunk
 
309
        for older plugins that don't use e.g. the CommitBuilder
 
310
        facility.
 
311
        """
 
312
        self._ensure_real()
 
313
        return self._real_repository.commit_write_group()
 
314
 
 
315
    def _ensure_real(self):
 
316
        """Ensure that there is a _real_repository set.
 
317
 
 
318
        Used before calls to self._real_repository.
 
319
        """
 
320
        if not self._real_repository:
 
321
            self.bzrdir._ensure_real()
 
322
            #self._real_repository = self.bzrdir._real_bzrdir.open_repository()
 
323
            self._set_real_repository(self.bzrdir._real_bzrdir.open_repository())
 
324
 
 
325
    def find_text_key_references(self):
 
326
        """Find the text key references within the repository.
 
327
 
 
328
        :return: a dictionary mapping (file_id, revision_id) tuples to altered file-ids to an iterable of
 
329
        revision_ids. Each altered file-ids has the exact revision_ids that
 
330
        altered it listed explicitly.
 
331
        :return: A dictionary mapping text keys ((fileid, revision_id) tuples)
 
332
            to whether they were referred to by the inventory of the
 
333
            revision_id that they contain. The inventory texts from all present
 
334
            revision ids are assessed to generate this report.
 
335
        """
 
336
        self._ensure_real()
 
337
        return self._real_repository.find_text_key_references()
 
338
 
 
339
    def _generate_text_key_index(self):
 
340
        """Generate a new text key index for the repository.
 
341
 
 
342
        This is an expensive function that will take considerable time to run.
 
343
 
 
344
        :return: A dict mapping (file_id, revision_id) tuples to a list of
 
345
            parents, also (file_id, revision_id) tuples.
 
346
        """
 
347
        self._ensure_real()
 
348
        return self._real_repository._generate_text_key_index()
 
349
 
 
350
    def get_revision_graph(self, revision_id=None):
 
351
        """See Repository.get_revision_graph()."""
 
352
        if revision_id is None:
 
353
            revision_id = ''
 
354
        elif revision.is_null(revision_id):
 
355
            return {}
 
356
 
 
357
        path = self.bzrdir._path_for_remote_call(self._client)
 
358
        assert type(revision_id) is str
 
359
        response = self._client.call_expecting_body(
 
360
            'Repository.get_revision_graph', path, revision_id)
 
361
        if response[0][0] not in ['ok', 'nosuchrevision']:
 
362
            raise errors.UnexpectedSmartServerResponse(response[0])
 
363
        if response[0][0] == 'ok':
 
364
            coded = response[1].read_body_bytes()
 
365
            if coded == '':
 
366
                # no revisions in this repository!
 
367
                return {}
 
368
            lines = coded.split('\n')
 
369
            revision_graph = {}
 
370
            for line in lines:
 
371
                d = tuple(line.split())
 
372
                revision_graph[d[0]] = d[1:]
 
373
                
 
374
            return revision_graph
 
375
        else:
 
376
            response_body = response[1].read_body_bytes()
 
377
            assert response_body == ''
 
378
            raise NoSuchRevision(self, revision_id)
 
379
 
 
380
    def has_revision(self, revision_id):
 
381
        """See Repository.has_revision()."""
 
382
        if revision_id == NULL_REVISION:
 
383
            # The null revision is always present.
 
384
            return True
 
385
        path = self.bzrdir._path_for_remote_call(self._client)
 
386
        response = self._client.call('Repository.has_revision', path, revision_id)
 
387
        assert response[0] in ('yes', 'no'), 'unexpected response code %s' % (response,)
 
388
        return response[0] == 'yes'
 
389
 
 
390
    def has_revisions(self, revision_ids):
 
391
        """See Repository.has_revisions()."""
 
392
        result = set()
 
393
        for revision_id in revision_ids:
 
394
            if self.has_revision(revision_id):
 
395
                result.add(revision_id)
 
396
        return result
 
397
 
 
398
    def has_same_location(self, other):
 
399
        return (self.__class__ == other.__class__ and
 
400
                self.bzrdir.transport.base == other.bzrdir.transport.base)
 
401
        
 
402
    def get_graph(self, other_repository=None):
 
403
        """Return the graph for this repository format"""
 
404
        parents_provider = self
 
405
        if (other_repository is not None and
 
406
            other_repository.bzrdir.transport.base !=
 
407
            self.bzrdir.transport.base):
 
408
            parents_provider = graph._StackedParentsProvider(
 
409
                [parents_provider, other_repository._make_parents_provider()])
 
410
        return graph.Graph(parents_provider)
 
411
 
 
412
    def gather_stats(self, revid=None, committers=None):
 
413
        """See Repository.gather_stats()."""
 
414
        path = self.bzrdir._path_for_remote_call(self._client)
 
415
        # revid can be None to indicate no revisions, not just NULL_REVISION
 
416
        if revid is None or revision.is_null(revid):
 
417
            fmt_revid = ''
 
418
        else:
 
419
            fmt_revid = revid
 
420
        if committers is None or not committers:
 
421
            fmt_committers = 'no'
 
422
        else:
 
423
            fmt_committers = 'yes'
 
424
        response = self._client.call_expecting_body(
 
425
            'Repository.gather_stats', path, fmt_revid, fmt_committers)
 
426
        assert response[0][0] == 'ok', \
 
427
            'unexpected response code %s' % (response[0],)
 
428
 
 
429
        body = response[1].read_body_bytes()
 
430
        result = {}
 
431
        for line in body.split('\n'):
 
432
            if not line:
 
433
                continue
 
434
            key, val_text = line.split(':')
 
435
            if key in ('revisions', 'size', 'committers'):
 
436
                result[key] = int(val_text)
 
437
            elif key in ('firstrev', 'latestrev'):
 
438
                values = val_text.split(' ')[1:]
 
439
                result[key] = (float(values[0]), long(values[1]))
 
440
 
 
441
        return result
 
442
 
 
443
    def find_branches(self, using=False):
 
444
        """See Repository.find_branches()."""
 
445
        # should be an API call to the server.
 
446
        self._ensure_real()
 
447
        return self._real_repository.find_branches(using=using)
 
448
 
 
449
    def get_physical_lock_status(self):
 
450
        """See Repository.get_physical_lock_status()."""
 
451
        # should be an API call to the server.
 
452
        self._ensure_real()
 
453
        return self._real_repository.get_physical_lock_status()
 
454
 
 
455
    def is_in_write_group(self):
 
456
        """Return True if there is an open write group.
 
457
 
 
458
        write groups are only applicable locally for the smart server..
 
459
        """
 
460
        if self._real_repository:
 
461
            return self._real_repository.is_in_write_group()
 
462
 
 
463
    def is_locked(self):
 
464
        return self._lock_count >= 1
 
465
 
 
466
    def is_shared(self):
 
467
        """See Repository.is_shared()."""
 
468
        path = self.bzrdir._path_for_remote_call(self._client)
 
469
        response = self._client.call('Repository.is_shared', path)
 
470
        assert response[0] in ('yes', 'no'), 'unexpected response code %s' % (response,)
 
471
        return response[0] == 'yes'
 
472
 
 
473
    def is_write_locked(self):
 
474
        return self._lock_mode == 'w'
 
475
 
 
476
    def lock_read(self):
 
477
        # wrong eventually - want a local lock cache context
 
478
        if not self._lock_mode:
 
479
            self._lock_mode = 'r'
 
480
            self._lock_count = 1
 
481
            self._parents_map = {}
 
482
            if 'hpss' in debug.debug_flags:
 
483
                self._requested_parents = set()
 
484
            if self._real_repository is not None:
 
485
                self._real_repository.lock_read()
 
486
        else:
 
487
            self._lock_count += 1
 
488
 
 
489
    def _remote_lock_write(self, token):
 
490
        path = self.bzrdir._path_for_remote_call(self._client)
 
491
        if token is None:
 
492
            token = ''
 
493
        response = self._client.call('Repository.lock_write', path, token)
 
494
        if response[0] == 'ok':
 
495
            ok, token = response
 
496
            return token
 
497
        elif response[0] == 'LockContention':
 
498
            raise errors.LockContention('(remote lock)')
 
499
        elif response[0] == 'UnlockableTransport':
 
500
            raise errors.UnlockableTransport(self.bzrdir.root_transport)
 
501
        elif response[0] == 'LockFailed':
 
502
            raise errors.LockFailed(response[1], response[2])
 
503
        else:
 
504
            raise errors.UnexpectedSmartServerResponse(response)
 
505
 
 
506
    def lock_write(self, token=None):
 
507
        if not self._lock_mode:
 
508
            self._lock_token = self._remote_lock_write(token)
 
509
            # if self._lock_token is None, then this is something like packs or
 
510
            # svn where we don't get to lock the repo, or a weave style repository
 
511
            # where we cannot lock it over the wire and attempts to do so will
 
512
            # fail.
 
513
            if self._real_repository is not None:
 
514
                self._real_repository.lock_write(token=self._lock_token)
 
515
            if token is not None:
 
516
                self._leave_lock = True
 
517
            else:
 
518
                self._leave_lock = False
 
519
            self._lock_mode = 'w'
 
520
            self._lock_count = 1
 
521
            self._parents_map = {}
 
522
            if 'hpss' in debug.debug_flags:
 
523
                self._requested_parents = set()
 
524
        elif self._lock_mode == 'r':
 
525
            raise errors.ReadOnlyError(self)
 
526
        else:
 
527
            self._lock_count += 1
 
528
        return self._lock_token or None
 
529
 
 
530
    def leave_lock_in_place(self):
 
531
        if not self._lock_token:
 
532
            raise NotImplementedError(self.leave_lock_in_place)
 
533
        self._leave_lock = True
 
534
 
 
535
    def dont_leave_lock_in_place(self):
 
536
        if not self._lock_token:
 
537
            raise NotImplementedError(self.dont_leave_lock_in_place)
 
538
        self._leave_lock = False
 
539
 
 
540
    def _set_real_repository(self, repository):
 
541
        """Set the _real_repository for this repository.
 
542
 
 
543
        :param repository: The repository to fallback to for non-hpss
 
544
            implemented operations.
 
545
        """
 
546
        assert not isinstance(repository, RemoteRepository)
 
547
        self._real_repository = repository
 
548
        if self._lock_mode == 'w':
 
549
            # if we are already locked, the real repository must be able to
 
550
            # acquire the lock with our token.
 
551
            self._real_repository.lock_write(self._lock_token)
 
552
        elif self._lock_mode == 'r':
 
553
            self._real_repository.lock_read()
 
554
 
 
555
    def start_write_group(self):
 
556
        """Start a write group on the decorated repository.
 
557
        
 
558
        Smart methods peform operations in a single step so this api
 
559
        is not really applicable except as a compatibility thunk
 
560
        for older plugins that don't use e.g. the CommitBuilder
 
561
        facility.
 
562
        """
 
563
        self._ensure_real()
 
564
        return self._real_repository.start_write_group()
 
565
 
 
566
    def _unlock(self, token):
 
567
        path = self.bzrdir._path_for_remote_call(self._client)
 
568
        if not token:
 
569
            # with no token the remote repository is not persistently locked.
 
570
            return
 
571
        response = self._client.call('Repository.unlock', path, token)
 
572
        if response == ('ok',):
 
573
            return
 
574
        elif response[0] == 'TokenMismatch':
 
575
            raise errors.TokenMismatch(token, '(remote token)')
 
576
        else:
 
577
            raise errors.UnexpectedSmartServerResponse(response)
 
578
 
 
579
    def unlock(self):
 
580
        self._lock_count -= 1
 
581
        if self._lock_count > 0:
 
582
            return
 
583
        self._parents_map = None
 
584
        if 'hpss' in debug.debug_flags:
 
585
            self._requested_parents = None
 
586
        old_mode = self._lock_mode
 
587
        self._lock_mode = None
 
588
        try:
 
589
            # The real repository is responsible at present for raising an
 
590
            # exception if it's in an unfinished write group.  However, it
 
591
            # normally will *not* actually remove the lock from disk - that's
 
592
            # done by the server on receiving the Repository.unlock call.
 
593
            # This is just to let the _real_repository stay up to date.
 
594
            if self._real_repository is not None:
 
595
                self._real_repository.unlock()
 
596
        finally:
 
597
            # The rpc-level lock should be released even if there was a
 
598
            # problem releasing the vfs-based lock.
 
599
            if old_mode == 'w':
 
600
                # Only write-locked repositories need to make a remote method
 
601
                # call to perfom the unlock.
 
602
                old_token = self._lock_token
 
603
                self._lock_token = None
 
604
                if not self._leave_lock:
 
605
                    self._unlock(old_token)
 
606
 
 
607
    def break_lock(self):
 
608
        # should hand off to the network
 
609
        self._ensure_real()
 
610
        return self._real_repository.break_lock()
 
611
 
 
612
    def _get_tarball(self, compression):
 
613
        """Return a TemporaryFile containing a repository tarball.
 
614
        
 
615
        Returns None if the server does not support sending tarballs.
 
616
        """
 
617
        import tempfile
 
618
        path = self.bzrdir._path_for_remote_call(self._client)
 
619
        response, protocol = self._client.call_expecting_body(
 
620
            'Repository.tarball', path, compression)
 
621
        if response[0] == 'ok':
 
622
            # Extract the tarball and return it
 
623
            t = tempfile.NamedTemporaryFile()
 
624
            # TODO: rpc layer should read directly into it...
 
625
            t.write(protocol.read_body_bytes())
 
626
            t.seek(0)
 
627
            return t
 
628
        if (response == ('error', "Generic bzr smart protocol error: "
 
629
                "bad request 'Repository.tarball'") or
 
630
              response == ('error', "Generic bzr smart protocol error: "
 
631
                "bad request u'Repository.tarball'")):
 
632
            protocol.cancel_read_body()
 
633
            return None
 
634
        raise errors.UnexpectedSmartServerResponse(response)
 
635
 
 
636
    def sprout(self, to_bzrdir, revision_id=None):
 
637
        # TODO: Option to control what format is created?
 
638
        self._ensure_real()
 
639
        dest_repo = self._real_repository._format.initialize(to_bzrdir,
 
640
                                                             shared=False)
 
641
        dest_repo.fetch(self, revision_id=revision_id)
 
642
        return dest_repo
 
643
 
 
644
    ### These methods are just thin shims to the VFS object for now.
 
645
 
 
646
    def revision_tree(self, revision_id):
 
647
        self._ensure_real()
 
648
        return self._real_repository.revision_tree(revision_id)
 
649
 
 
650
    def get_serializer_format(self):
 
651
        self._ensure_real()
 
652
        return self._real_repository.get_serializer_format()
 
653
 
 
654
    def get_commit_builder(self, branch, parents, config, timestamp=None,
 
655
                           timezone=None, committer=None, revprops=None,
 
656
                           revision_id=None):
 
657
        # FIXME: It ought to be possible to call this without immediately
 
658
        # triggering _ensure_real.  For now it's the easiest thing to do.
 
659
        self._ensure_real()
 
660
        builder = self._real_repository.get_commit_builder(branch, parents,
 
661
                config, timestamp=timestamp, timezone=timezone,
 
662
                committer=committer, revprops=revprops, revision_id=revision_id)
 
663
        return builder
 
664
 
 
665
    def add_inventory(self, revid, inv, parents):
 
666
        self._ensure_real()
 
667
        return self._real_repository.add_inventory(revid, inv, parents)
 
668
 
 
669
    def add_revision(self, rev_id, rev, inv=None, config=None):
 
670
        self._ensure_real()
 
671
        return self._real_repository.add_revision(
 
672
            rev_id, rev, inv=inv, config=config)
 
673
 
 
674
    @needs_read_lock
 
675
    def get_inventory(self, revision_id):
 
676
        self._ensure_real()
 
677
        return self._real_repository.get_inventory(revision_id)
 
678
 
 
679
    def iter_inventories(self, revision_ids):
 
680
        self._ensure_real()
 
681
        return self._real_repository.iter_inventories(revision_ids)
 
682
 
 
683
    @needs_read_lock
 
684
    def get_revision(self, revision_id):
 
685
        self._ensure_real()
 
686
        return self._real_repository.get_revision(revision_id)
 
687
 
 
688
    @property
 
689
    def weave_store(self):
 
690
        self._ensure_real()
 
691
        return self._real_repository.weave_store
 
692
 
 
693
    def get_transaction(self):
 
694
        self._ensure_real()
 
695
        return self._real_repository.get_transaction()
 
696
 
 
697
    @needs_read_lock
 
698
    def clone(self, a_bzrdir, revision_id=None):
 
699
        self._ensure_real()
 
700
        return self._real_repository.clone(a_bzrdir, revision_id=revision_id)
 
701
 
 
702
    def make_working_trees(self):
 
703
        """RemoteRepositories never create working trees by default."""
 
704
        return False
 
705
 
 
706
    def revision_ids_to_search_result(self, result_set):
 
707
        """Convert a set of revision ids to a graph SearchResult."""
 
708
        result_parents = set()
 
709
        for parents in self.get_graph().get_parent_map(
 
710
            result_set).itervalues():
 
711
            result_parents.update(parents)
 
712
        included_keys = result_set.intersection(result_parents)
 
713
        start_keys = result_set.difference(included_keys)
 
714
        exclude_keys = result_parents.difference(result_set)
 
715
        result = graph.SearchResult(start_keys, exclude_keys,
 
716
            len(result_set), result_set)
 
717
        return result
 
718
 
 
719
    @needs_read_lock
 
720
    def search_missing_revision_ids(self, other, revision_id=None, find_ghosts=True):
 
721
        """Return the revision ids that other has that this does not.
 
722
        
 
723
        These are returned in topological order.
 
724
 
 
725
        revision_id: only return revision ids included by revision_id.
 
726
        """
 
727
        return repository.InterRepository.get(
 
728
            other, self).search_missing_revision_ids(revision_id, find_ghosts)
 
729
 
 
730
    def fetch(self, source, revision_id=None, pb=None):
 
731
        if self.has_same_location(source):
 
732
            # check that last_revision is in 'from' and then return a
 
733
            # no-operation.
 
734
            if (revision_id is not None and
 
735
                not revision.is_null(revision_id)):
 
736
                self.get_revision(revision_id)
 
737
            return 0, []
 
738
        self._ensure_real()
 
739
        return self._real_repository.fetch(
 
740
            source, revision_id=revision_id, pb=pb)
 
741
 
 
742
    def create_bundle(self, target, base, fileobj, format=None):
 
743
        self._ensure_real()
 
744
        self._real_repository.create_bundle(target, base, fileobj, format)
 
745
 
 
746
    @property
 
747
    def control_weaves(self):
 
748
        self._ensure_real()
 
749
        return self._real_repository.control_weaves
 
750
 
 
751
    @needs_read_lock
 
752
    def get_ancestry(self, revision_id, topo_sorted=True):
 
753
        self._ensure_real()
 
754
        return self._real_repository.get_ancestry(revision_id, topo_sorted)
 
755
 
 
756
    @needs_read_lock
 
757
    def get_inventory_weave(self):
 
758
        self._ensure_real()
 
759
        return self._real_repository.get_inventory_weave()
 
760
 
 
761
    def fileids_altered_by_revision_ids(self, revision_ids):
 
762
        self._ensure_real()
 
763
        return self._real_repository.fileids_altered_by_revision_ids(revision_ids)
 
764
 
 
765
    def _get_versioned_file_checker(self, revisions, revision_versions_cache):
 
766
        self._ensure_real()
 
767
        return self._real_repository._get_versioned_file_checker(
 
768
            revisions, revision_versions_cache)
 
769
        
 
770
    def iter_files_bytes(self, desired_files):
 
771
        """See Repository.iter_file_bytes.
 
772
        """
 
773
        self._ensure_real()
 
774
        return self._real_repository.iter_files_bytes(desired_files)
 
775
 
 
776
    def get_parent_map(self, keys):
 
777
        """See bzrlib.Graph.get_parent_map()."""
 
778
        # Hack to build up the caching logic.
 
779
        ancestry = self._parents_map
 
780
        missing_revisions = set(key for key in keys if key not in ancestry)
 
781
        if missing_revisions:
 
782
            parent_map = self._get_parent_map(missing_revisions)
 
783
            if 'hpss' in debug.debug_flags:
 
784
                mutter('retransmitted revisions: %d of %d',
 
785
                        len(set(self._parents_map).intersection(parent_map)),
 
786
                        len(parent_map))
 
787
            self._parents_map.update(parent_map)
 
788
        present_keys = [k for k in keys if k in ancestry]
 
789
        if 'hpss' in debug.debug_flags:
 
790
            self._requested_parents.update(present_keys)
 
791
            mutter('Current RemoteRepository graph hit rate: %d%%',
 
792
                100.0 * len(self._requested_parents) / len(self._parents_map))
 
793
        return dict((k, ancestry[k]) for k in present_keys)
 
794
 
 
795
    def _response_is_unknown_method(self, response, verb):
 
796
        """Return True if response is an unknonwn method response to verb.
 
797
        
 
798
        :param response: The response from a smart client call_expecting_body
 
799
            call.
 
800
        :param verb: The verb used in that call.
 
801
        :return: True if an unknown method was encountered.
 
802
        """
 
803
        # This might live better on
 
804
        # bzrlib.smart.protocol.SmartClientRequestProtocolOne
 
805
        if (response[0] == ('error', "Generic bzr smart protocol error: "
 
806
                "bad request '%s'" % verb) or
 
807
              response[0] == ('error', "Generic bzr smart protocol error: "
 
808
                "bad request u'%s'" % verb)):
 
809
           response[1].cancel_read_body()
 
810
           return True
 
811
        return False
 
812
 
 
813
    def _get_parent_map(self, keys):
 
814
        """Helper for get_parent_map that performs the RPC."""
 
815
        keys = set(keys)
 
816
        if NULL_REVISION in keys:
 
817
            keys.discard(NULL_REVISION)
 
818
            found_parents = {NULL_REVISION:()}
 
819
            if not keys:
 
820
                return found_parents
 
821
        else:
 
822
            found_parents = {}
 
823
        # TODO(Needs analysis): We could assume that the keys being requested
 
824
        # from get_parent_map are in a breadth first search, so typically they
 
825
        # will all be depth N from some common parent, and we don't have to
 
826
        # have the server iterate from the root parent, but rather from the
 
827
        # keys we're searching; and just tell the server the keyspace we
 
828
        # already have; but this may be more traffic again.
 
829
 
 
830
        # Transform self._parents_map into a search request recipe.
 
831
        # TODO: Manage this incrementally to avoid covering the same path
 
832
        # repeatedly. (The server will have to on each request, but the less
 
833
        # work done the better).
 
834
        start_set = set(self._parents_map)
 
835
        result_parents = set()
 
836
        for parents in self._parents_map.itervalues():
 
837
            result_parents.update(parents)
 
838
        stop_keys = result_parents.difference(start_set)
 
839
        included_keys = start_set.intersection(result_parents)
 
840
        start_set.difference_update(included_keys)
 
841
        recipe = (start_set, stop_keys, len(self._parents_map))
 
842
        body = self._serialise_search_recipe(recipe)
 
843
        path = self.bzrdir._path_for_remote_call(self._client)
 
844
        for key in keys:
 
845
            assert type(key) is str
 
846
        verb = 'Repository.get_parent_map'
 
847
        args = (path,) + tuple(keys)
 
848
        response = self._client.call_with_body_bytes_expecting_body(
 
849
            verb, args, self._serialise_search_recipe(recipe))
 
850
        if self._response_is_unknown_method(response, verb):
 
851
            # Server that does not support this method, get the whole graph.
 
852
            response = self._client.call_expecting_body(
 
853
                'Repository.get_revision_graph', path, '')
 
854
            if response[0][0] not in ['ok', 'nosuchrevision']:
 
855
                reponse[1].cancel_read_body()
 
856
                raise errors.UnexpectedSmartServerResponse(response[0])
 
857
        elif response[0][0] not in ['ok']:
 
858
            reponse[1].cancel_read_body()
 
859
            raise errors.UnexpectedSmartServerResponse(response[0])
 
860
        if response[0][0] == 'ok':
 
861
            coded = bz2.decompress(response[1].read_body_bytes())
 
862
            if coded == '':
 
863
                # no revisions found
 
864
                return {}
 
865
            lines = coded.split('\n')
 
866
            revision_graph = {}
 
867
            for line in lines:
 
868
                d = tuple(line.split())
 
869
                if len(d) > 1:
 
870
                    revision_graph[d[0]] = d[1:]
 
871
                else:
 
872
                    # No parents - so give the Graph result (NULL_REVISION,).
 
873
                    revision_graph[d[0]] = (NULL_REVISION,)
 
874
            return revision_graph
 
875
 
 
876
    @needs_read_lock
 
877
    def get_signature_text(self, revision_id):
 
878
        self._ensure_real()
 
879
        return self._real_repository.get_signature_text(revision_id)
 
880
 
 
881
    @needs_read_lock
 
882
    def get_revision_graph_with_ghosts(self, revision_ids=None):
 
883
        self._ensure_real()
 
884
        return self._real_repository.get_revision_graph_with_ghosts(
 
885
            revision_ids=revision_ids)
 
886
 
 
887
    @needs_read_lock
 
888
    def get_inventory_xml(self, revision_id):
 
889
        self._ensure_real()
 
890
        return self._real_repository.get_inventory_xml(revision_id)
 
891
 
 
892
    def deserialise_inventory(self, revision_id, xml):
 
893
        self._ensure_real()
 
894
        return self._real_repository.deserialise_inventory(revision_id, xml)
 
895
 
 
896
    def reconcile(self, other=None, thorough=False):
 
897
        self._ensure_real()
 
898
        return self._real_repository.reconcile(other=other, thorough=thorough)
 
899
        
 
900
    def all_revision_ids(self):
 
901
        self._ensure_real()
 
902
        return self._real_repository.all_revision_ids()
 
903
    
 
904
    @needs_read_lock
 
905
    def get_deltas_for_revisions(self, revisions):
 
906
        self._ensure_real()
 
907
        return self._real_repository.get_deltas_for_revisions(revisions)
 
908
 
 
909
    @needs_read_lock
 
910
    def get_revision_delta(self, revision_id):
 
911
        self._ensure_real()
 
912
        return self._real_repository.get_revision_delta(revision_id)
 
913
 
 
914
    @needs_read_lock
 
915
    def revision_trees(self, revision_ids):
 
916
        self._ensure_real()
 
917
        return self._real_repository.revision_trees(revision_ids)
 
918
 
 
919
    @needs_read_lock
 
920
    def get_revision_reconcile(self, revision_id):
 
921
        self._ensure_real()
 
922
        return self._real_repository.get_revision_reconcile(revision_id)
 
923
 
 
924
    @needs_read_lock
 
925
    def check(self, revision_ids=None):
 
926
        self._ensure_real()
 
927
        return self._real_repository.check(revision_ids=revision_ids)
 
928
 
 
929
    def copy_content_into(self, destination, revision_id=None):
 
930
        self._ensure_real()
 
931
        return self._real_repository.copy_content_into(
 
932
            destination, revision_id=revision_id)
 
933
 
 
934
    def _copy_repository_tarball(self, to_bzrdir, revision_id=None):
 
935
        # get a tarball of the remote repository, and copy from that into the
 
936
        # destination
 
937
        from bzrlib import osutils
 
938
        import tarfile
 
939
        import tempfile
 
940
        # TODO: Maybe a progress bar while streaming the tarball?
 
941
        note("Copying repository content as tarball...")
 
942
        tar_file = self._get_tarball('bz2')
 
943
        if tar_file is None:
 
944
            return None
 
945
        destination = to_bzrdir.create_repository()
 
946
        try:
 
947
            tar = tarfile.open('repository', fileobj=tar_file,
 
948
                mode='r|bz2')
 
949
            tmpdir = tempfile.mkdtemp()
 
950
            try:
 
951
                _extract_tar(tar, tmpdir)
 
952
                tmp_bzrdir = BzrDir.open(tmpdir)
 
953
                tmp_repo = tmp_bzrdir.open_repository()
 
954
                tmp_repo.copy_content_into(destination, revision_id)
 
955
            finally:
 
956
                osutils.rmtree(tmpdir)
 
957
        finally:
 
958
            tar_file.close()
 
959
        return destination
 
960
        # TODO: Suggestion from john: using external tar is much faster than
 
961
        # python's tarfile library, but it may not work on windows.
 
962
 
 
963
    @needs_write_lock
 
964
    def pack(self):
 
965
        """Compress the data within the repository.
 
966
 
 
967
        This is not currently implemented within the smart server.
 
968
        """
 
969
        self._ensure_real()
 
970
        return self._real_repository.pack()
 
971
 
 
972
    def set_make_working_trees(self, new_value):
 
973
        raise NotImplementedError(self.set_make_working_trees)
 
974
 
 
975
    @needs_write_lock
 
976
    def sign_revision(self, revision_id, gpg_strategy):
 
977
        self._ensure_real()
 
978
        return self._real_repository.sign_revision(revision_id, gpg_strategy)
 
979
 
 
980
    @needs_read_lock
 
981
    def get_revisions(self, revision_ids):
 
982
        self._ensure_real()
 
983
        return self._real_repository.get_revisions(revision_ids)
 
984
 
 
985
    def supports_rich_root(self):
 
986
        self._ensure_real()
 
987
        return self._real_repository.supports_rich_root()
 
988
 
 
989
    def iter_reverse_revision_history(self, revision_id):
 
990
        self._ensure_real()
 
991
        return self._real_repository.iter_reverse_revision_history(revision_id)
 
992
 
 
993
    @property
 
994
    def _serializer(self):
 
995
        self._ensure_real()
 
996
        return self._real_repository._serializer
 
997
 
 
998
    def store_revision_signature(self, gpg_strategy, plaintext, revision_id):
 
999
        self._ensure_real()
 
1000
        return self._real_repository.store_revision_signature(
 
1001
            gpg_strategy, plaintext, revision_id)
 
1002
 
 
1003
    def add_signature_text(self, revision_id, signature):
 
1004
        self._ensure_real()
 
1005
        return self._real_repository.add_signature_text(revision_id, signature)
 
1006
 
 
1007
    def has_signature_for_revision_id(self, revision_id):
 
1008
        self._ensure_real()
 
1009
        return self._real_repository.has_signature_for_revision_id(revision_id)
 
1010
 
 
1011
    def get_data_stream_for_search(self, search):
 
1012
        REQUEST_NAME = 'Repository.stream_revisions_chunked'
 
1013
        path = self.bzrdir._path_for_remote_call(self._client)
 
1014
        body = self._serialise_search_recipe(search.get_recipe())
 
1015
        response, protocol = self._client.call_with_body_bytes_expecting_body(
 
1016
            REQUEST_NAME, (path,), body)
 
1017
 
 
1018
        if response == ('ok',):
 
1019
            return self._deserialise_stream(protocol)
 
1020
        if response == ('NoSuchRevision', ):
 
1021
            # We cannot easily identify the revision that is missing in this
 
1022
            # situation without doing much more network IO. For now, bail.
 
1023
            raise NoSuchRevision(self, "unknown")
 
1024
        elif (response == ('error', "Generic bzr smart protocol error: "
 
1025
                "bad request '%s'" % REQUEST_NAME) or
 
1026
              response == ('error', "Generic bzr smart protocol error: "
 
1027
                "bad request u'%s'" % REQUEST_NAME)):
 
1028
            protocol.cancel_read_body()
 
1029
            self._ensure_real()
 
1030
            return self._real_repository.get_data_stream_for_search(search)
 
1031
        else:
 
1032
            raise errors.UnexpectedSmartServerResponse(response)
 
1033
 
 
1034
    def _deserialise_stream(self, protocol):
 
1035
        stream = protocol.read_streamed_body()
 
1036
        container_parser = ContainerPushParser()
 
1037
        for bytes in stream:
 
1038
            container_parser.accept_bytes(bytes)
 
1039
            records = container_parser.read_pending_records()
 
1040
            for record_names, record_bytes in records:
 
1041
                if len(record_names) != 1:
 
1042
                    # These records should have only one name, and that name
 
1043
                    # should be a one-element tuple.
 
1044
                    raise errors.SmartProtocolError(
 
1045
                        'Repository data stream had invalid record name %r'
 
1046
                        % (record_names,))
 
1047
                name_tuple = record_names[0]
 
1048
                yield name_tuple, record_bytes
 
1049
 
 
1050
    def insert_data_stream(self, stream):
 
1051
        self._ensure_real()
 
1052
        self._real_repository.insert_data_stream(stream)
 
1053
 
 
1054
    def item_keys_introduced_by(self, revision_ids, _files_pb=None):
 
1055
        self._ensure_real()
 
1056
        return self._real_repository.item_keys_introduced_by(revision_ids,
 
1057
            _files_pb=_files_pb)
 
1058
 
 
1059
    def revision_graph_can_have_wrong_parents(self):
 
1060
        # The answer depends on the remote repo format.
 
1061
        self._ensure_real()
 
1062
        return self._real_repository.revision_graph_can_have_wrong_parents()
 
1063
 
 
1064
    def _find_inconsistent_revision_parents(self):
 
1065
        self._ensure_real()
 
1066
        return self._real_repository._find_inconsistent_revision_parents()
 
1067
 
 
1068
    def _check_for_inconsistent_revision_parents(self):
 
1069
        self._ensure_real()
 
1070
        return self._real_repository._check_for_inconsistent_revision_parents()
 
1071
 
 
1072
    def _make_parents_provider(self):
 
1073
        return self
 
1074
 
 
1075
    def _serialise_search_recipe(self, recipe):
 
1076
        """Serialise a graph search recipe.
 
1077
 
 
1078
        :param recipe: A search recipe (start, stop, count).
 
1079
        :return: Serialised bytes.
 
1080
        """
 
1081
        start_keys = ' '.join(recipe[0])
 
1082
        stop_keys = ' '.join(recipe[1])
 
1083
        count = str(recipe[2])
 
1084
        return '\n'.join((start_keys, stop_keys, count))
 
1085
 
 
1086
 
 
1087
class RemoteBranchLockableFiles(LockableFiles):
 
1088
    """A 'LockableFiles' implementation that talks to a smart server.
 
1089
    
 
1090
    This is not a public interface class.
 
1091
    """
 
1092
 
 
1093
    def __init__(self, bzrdir, _client):
 
1094
        self.bzrdir = bzrdir
 
1095
        self._client = _client
 
1096
        self._need_find_modes = True
 
1097
        LockableFiles.__init__(
 
1098
            self, bzrdir.get_branch_transport(None),
 
1099
            'lock', lockdir.LockDir)
 
1100
 
 
1101
    def _find_modes(self):
 
1102
        # RemoteBranches don't let the client set the mode of control files.
 
1103
        self._dir_mode = None
 
1104
        self._file_mode = None
 
1105
 
 
1106
    def get(self, path):
 
1107
        """'get' a remote path as per the LockableFiles interface.
 
1108
 
 
1109
        :param path: the file to 'get'. If this is 'branch.conf', we do not
 
1110
             just retrieve a file, instead we ask the smart server to generate
 
1111
             a configuration for us - which is retrieved as an INI file.
 
1112
        """
 
1113
        if path == 'branch.conf':
 
1114
            path = self.bzrdir._path_for_remote_call(self._client)
 
1115
            response = self._client.call_expecting_body(
 
1116
                'Branch.get_config_file', path)
 
1117
            assert response[0][0] == 'ok', \
 
1118
                'unexpected response code %s' % (response[0],)
 
1119
            return StringIO(response[1].read_body_bytes())
 
1120
        else:
 
1121
            # VFS fallback.
 
1122
            return LockableFiles.get(self, path)
 
1123
 
 
1124
 
 
1125
class RemoteBranchFormat(branch.BranchFormat):
 
1126
 
 
1127
    def __eq__(self, other):
 
1128
        return (isinstance(other, RemoteBranchFormat) and 
 
1129
            self.__dict__ == other.__dict__)
 
1130
 
 
1131
    def get_format_description(self):
 
1132
        return 'Remote BZR Branch'
 
1133
 
 
1134
    def get_format_string(self):
 
1135
        return 'Remote BZR Branch'
 
1136
 
 
1137
    def open(self, a_bzrdir):
 
1138
        assert isinstance(a_bzrdir, RemoteBzrDir)
 
1139
        return a_bzrdir.open_branch()
 
1140
 
 
1141
    def initialize(self, a_bzrdir):
 
1142
        assert isinstance(a_bzrdir, RemoteBzrDir)
 
1143
        return a_bzrdir.create_branch()
 
1144
 
 
1145
    def supports_tags(self):
 
1146
        # Remote branches might support tags, but we won't know until we
 
1147
        # access the real remote branch.
 
1148
        return True
 
1149
 
 
1150
 
 
1151
class RemoteBranch(branch.Branch):
 
1152
    """Branch stored on a server accessed by HPSS RPC.
 
1153
 
 
1154
    At the moment most operations are mapped down to simple file operations.
 
1155
    """
 
1156
 
 
1157
    def __init__(self, remote_bzrdir, remote_repository, real_branch=None,
 
1158
        _client=None):
 
1159
        """Create a RemoteBranch instance.
 
1160
 
 
1161
        :param real_branch: An optional local implementation of the branch
 
1162
            format, usually accessing the data via the VFS.
 
1163
        :param _client: Private parameter for testing.
 
1164
        """
 
1165
        # We intentionally don't call the parent class's __init__, because it
 
1166
        # will try to assign to self.tags, which is a property in this subclass.
 
1167
        # And the parent's __init__ doesn't do much anyway.
 
1168
        self._revision_id_to_revno_cache = None
 
1169
        self._revision_history_cache = None
 
1170
        self.bzrdir = remote_bzrdir
 
1171
        if _client is not None:
 
1172
            self._client = _client
 
1173
        else:
 
1174
            self._client = client._SmartClient(self.bzrdir._shared_medium)
 
1175
        self.repository = remote_repository
 
1176
        if real_branch is not None:
 
1177
            self._real_branch = real_branch
 
1178
            # Give the remote repository the matching real repo.
 
1179
            real_repo = self._real_branch.repository
 
1180
            if isinstance(real_repo, RemoteRepository):
 
1181
                real_repo._ensure_real()
 
1182
                real_repo = real_repo._real_repository
 
1183
            self.repository._set_real_repository(real_repo)
 
1184
            # Give the branch the remote repository to let fast-pathing happen.
 
1185
            self._real_branch.repository = self.repository
 
1186
        else:
 
1187
            self._real_branch = None
 
1188
        # Fill out expected attributes of branch for bzrlib api users.
 
1189
        self._format = RemoteBranchFormat()
 
1190
        self.base = self.bzrdir.root_transport.base
 
1191
        self._control_files = None
 
1192
        self._lock_mode = None
 
1193
        self._lock_token = None
 
1194
        self._lock_count = 0
 
1195
        self._leave_lock = False
 
1196
 
 
1197
    def __str__(self):
 
1198
        return "%s(%s)" % (self.__class__.__name__, self.base)
 
1199
 
 
1200
    __repr__ = __str__
 
1201
 
 
1202
    def _ensure_real(self):
 
1203
        """Ensure that there is a _real_branch set.
 
1204
 
 
1205
        Used before calls to self._real_branch.
 
1206
        """
 
1207
        if not self._real_branch:
 
1208
            assert vfs.vfs_enabled()
 
1209
            self.bzrdir._ensure_real()
 
1210
            self._real_branch = self.bzrdir._real_bzrdir.open_branch()
 
1211
            # Give the remote repository the matching real repo.
 
1212
            real_repo = self._real_branch.repository
 
1213
            if isinstance(real_repo, RemoteRepository):
 
1214
                real_repo._ensure_real()
 
1215
                real_repo = real_repo._real_repository
 
1216
            self.repository._set_real_repository(real_repo)
 
1217
            # Give the branch the remote repository to let fast-pathing happen.
 
1218
            self._real_branch.repository = self.repository
 
1219
            # XXX: deal with _lock_mode == 'w'
 
1220
            if self._lock_mode == 'r':
 
1221
                self._real_branch.lock_read()
 
1222
 
 
1223
    @property
 
1224
    def control_files(self):
 
1225
        # Defer actually creating RemoteBranchLockableFiles until its needed,
 
1226
        # because it triggers an _ensure_real that we otherwise might not need.
 
1227
        if self._control_files is None:
 
1228
            self._control_files = RemoteBranchLockableFiles(
 
1229
                self.bzrdir, self._client)
 
1230
        return self._control_files
 
1231
 
 
1232
    def _get_checkout_format(self):
 
1233
        self._ensure_real()
 
1234
        return self._real_branch._get_checkout_format()
 
1235
 
 
1236
    def get_physical_lock_status(self):
 
1237
        """See Branch.get_physical_lock_status()."""
 
1238
        # should be an API call to the server, as branches must be lockable.
 
1239
        self._ensure_real()
 
1240
        return self._real_branch.get_physical_lock_status()
 
1241
 
 
1242
    def lock_read(self):
 
1243
        if not self._lock_mode:
 
1244
            self._lock_mode = 'r'
 
1245
            self._lock_count = 1
 
1246
            if self._real_branch is not None:
 
1247
                self._real_branch.lock_read()
 
1248
        else:
 
1249
            self._lock_count += 1
 
1250
 
 
1251
    def _remote_lock_write(self, token):
 
1252
        if token is None:
 
1253
            branch_token = repo_token = ''
 
1254
        else:
 
1255
            branch_token = token
 
1256
            repo_token = self.repository.lock_write()
 
1257
            self.repository.unlock()
 
1258
        path = self.bzrdir._path_for_remote_call(self._client)
 
1259
        response = self._client.call('Branch.lock_write', path, branch_token,
 
1260
                                     repo_token or '')
 
1261
        if response[0] == 'ok':
 
1262
            ok, branch_token, repo_token = response
 
1263
            return branch_token, repo_token
 
1264
        elif response[0] == 'LockContention':
 
1265
            raise errors.LockContention('(remote lock)')
 
1266
        elif response[0] == 'TokenMismatch':
 
1267
            raise errors.TokenMismatch(token, '(remote token)')
 
1268
        elif response[0] == 'UnlockableTransport':
 
1269
            raise errors.UnlockableTransport(self.bzrdir.root_transport)
 
1270
        elif response[0] == 'ReadOnlyError':
 
1271
            raise errors.ReadOnlyError(self)
 
1272
        elif response[0] == 'LockFailed':
 
1273
            raise errors.LockFailed(response[1], response[2])
 
1274
        else:
 
1275
            raise errors.UnexpectedSmartServerResponse(response)
 
1276
            
 
1277
    def lock_write(self, token=None):
 
1278
        if not self._lock_mode:
 
1279
            remote_tokens = self._remote_lock_write(token)
 
1280
            self._lock_token, self._repo_lock_token = remote_tokens
 
1281
            assert self._lock_token, 'Remote server did not return a token!'
 
1282
            # TODO: We really, really, really don't want to call _ensure_real
 
1283
            # here, but it's the easiest way to ensure coherency between the
 
1284
            # state of the RemoteBranch and RemoteRepository objects and the
 
1285
            # physical locks.  If we don't materialise the real objects here,
 
1286
            # then getting everything in the right state later is complex, so
 
1287
            # for now we just do it the lazy way.
 
1288
            #   -- Andrew Bennetts, 2007-02-22.
 
1289
            self._ensure_real()
 
1290
            if self._real_branch is not None:
 
1291
                self._real_branch.repository.lock_write(
 
1292
                    token=self._repo_lock_token)
 
1293
                try:
 
1294
                    self._real_branch.lock_write(token=self._lock_token)
 
1295
                finally:
 
1296
                    self._real_branch.repository.unlock()
 
1297
            if token is not None:
 
1298
                self._leave_lock = True
 
1299
            else:
 
1300
                # XXX: this case seems to be unreachable; token cannot be None.
 
1301
                self._leave_lock = False
 
1302
            self._lock_mode = 'w'
 
1303
            self._lock_count = 1
 
1304
        elif self._lock_mode == 'r':
 
1305
            raise errors.ReadOnlyTransaction
 
1306
        else:
 
1307
            if token is not None:
 
1308
                # A token was given to lock_write, and we're relocking, so check
 
1309
                # that the given token actually matches the one we already have.
 
1310
                if token != self._lock_token:
 
1311
                    raise errors.TokenMismatch(token, self._lock_token)
 
1312
            self._lock_count += 1
 
1313
        return self._lock_token or None
 
1314
 
 
1315
    def _unlock(self, branch_token, repo_token):
 
1316
        path = self.bzrdir._path_for_remote_call(self._client)
 
1317
        response = self._client.call('Branch.unlock', path, branch_token,
 
1318
                                     repo_token or '')
 
1319
        if response == ('ok',):
 
1320
            return
 
1321
        elif response[0] == 'TokenMismatch':
 
1322
            raise errors.TokenMismatch(
 
1323
                str((branch_token, repo_token)), '(remote tokens)')
 
1324
        else:
 
1325
            raise errors.UnexpectedSmartServerResponse(response)
 
1326
 
 
1327
    def unlock(self):
 
1328
        self._lock_count -= 1
 
1329
        if not self._lock_count:
 
1330
            self._clear_cached_state()
 
1331
            mode = self._lock_mode
 
1332
            self._lock_mode = None
 
1333
            if self._real_branch is not None:
 
1334
                if (not self._leave_lock and mode == 'w' and
 
1335
                    self._repo_lock_token):
 
1336
                    # If this RemoteBranch will remove the physical lock for the
 
1337
                    # repository, make sure the _real_branch doesn't do it
 
1338
                    # first.  (Because the _real_branch's repository is set to
 
1339
                    # be the RemoteRepository.)
 
1340
                    self._real_branch.repository.leave_lock_in_place()
 
1341
                self._real_branch.unlock()
 
1342
            if mode != 'w':
 
1343
                # Only write-locked branched need to make a remote method call
 
1344
                # to perfom the unlock.
 
1345
                return
 
1346
            assert self._lock_token, 'Locked, but no token!'
 
1347
            branch_token = self._lock_token
 
1348
            repo_token = self._repo_lock_token
 
1349
            self._lock_token = None
 
1350
            self._repo_lock_token = None
 
1351
            if not self._leave_lock:
 
1352
                self._unlock(branch_token, repo_token)
 
1353
 
 
1354
    def break_lock(self):
 
1355
        self._ensure_real()
 
1356
        return self._real_branch.break_lock()
 
1357
 
 
1358
    def leave_lock_in_place(self):
 
1359
        if not self._lock_token:
 
1360
            raise NotImplementedError(self.leave_lock_in_place)
 
1361
        self._leave_lock = True
 
1362
 
 
1363
    def dont_leave_lock_in_place(self):
 
1364
        if not self._lock_token:
 
1365
            raise NotImplementedError(self.dont_leave_lock_in_place)
 
1366
        self._leave_lock = False
 
1367
 
 
1368
    def last_revision_info(self):
 
1369
        """See Branch.last_revision_info()."""
 
1370
        path = self.bzrdir._path_for_remote_call(self._client)
 
1371
        response = self._client.call('Branch.last_revision_info', path)
 
1372
        assert response[0] == 'ok', 'unexpected response code %s' % (response,)
 
1373
        revno = int(response[1])
 
1374
        last_revision = response[2]
 
1375
        return (revno, last_revision)
 
1376
 
 
1377
    def _gen_revision_history(self):
 
1378
        """See Branch._gen_revision_history()."""
 
1379
        path = self.bzrdir._path_for_remote_call(self._client)
 
1380
        response = self._client.call_expecting_body(
 
1381
            'Branch.revision_history', path)
 
1382
        assert response[0][0] == 'ok', ('unexpected response code %s'
 
1383
                                        % (response[0],))
 
1384
        result = response[1].read_body_bytes().split('\x00')
 
1385
        if result == ['']:
 
1386
            return []
 
1387
        return result
 
1388
 
 
1389
    @needs_write_lock
 
1390
    def set_revision_history(self, rev_history):
 
1391
        # Send just the tip revision of the history; the server will generate
 
1392
        # the full history from that.  If the revision doesn't exist in this
 
1393
        # branch, NoSuchRevision will be raised.
 
1394
        path = self.bzrdir._path_for_remote_call(self._client)
 
1395
        if rev_history == []:
 
1396
            rev_id = 'null:'
 
1397
        else:
 
1398
            rev_id = rev_history[-1]
 
1399
        self._clear_cached_state()
 
1400
        response = self._client.call('Branch.set_last_revision',
 
1401
            path, self._lock_token, self._repo_lock_token, rev_id)
 
1402
        if response[0] == 'NoSuchRevision':
 
1403
            raise NoSuchRevision(self, rev_id)
 
1404
        else:
 
1405
            assert response == ('ok',), (
 
1406
                'unexpected response code %r' % (response,))
 
1407
        self._cache_revision_history(rev_history)
 
1408
 
 
1409
    def get_parent(self):
 
1410
        self._ensure_real()
 
1411
        return self._real_branch.get_parent()
 
1412
        
 
1413
    def set_parent(self, url):
 
1414
        self._ensure_real()
 
1415
        return self._real_branch.set_parent(url)
 
1416
        
 
1417
    def get_config(self):
 
1418
        return RemoteBranchConfig(self)
 
1419
 
 
1420
    def sprout(self, to_bzrdir, revision_id=None):
 
1421
        # Like Branch.sprout, except that it sprouts a branch in the default
 
1422
        # format, because RemoteBranches can't be created at arbitrary URLs.
 
1423
        # XXX: if to_bzrdir is a RemoteBranch, this should perhaps do
 
1424
        # to_bzrdir.create_branch...
 
1425
        self._ensure_real()
 
1426
        result = self._real_branch._format.initialize(to_bzrdir)
 
1427
        self.copy_content_into(result, revision_id=revision_id)
 
1428
        result.set_parent(self.bzrdir.root_transport.base)
 
1429
        return result
 
1430
 
 
1431
    @needs_write_lock
 
1432
    def pull(self, source, overwrite=False, stop_revision=None,
 
1433
             **kwargs):
 
1434
        # FIXME: This asks the real branch to run the hooks, which means
 
1435
        # they're called with the wrong target branch parameter. 
 
1436
        # The test suite specifically allows this at present but it should be
 
1437
        # fixed.  It should get a _override_hook_target branch,
 
1438
        # as push does.  -- mbp 20070405
 
1439
        self._ensure_real()
 
1440
        self._real_branch.pull(
 
1441
            source, overwrite=overwrite, stop_revision=stop_revision,
 
1442
            **kwargs)
 
1443
 
 
1444
    @needs_read_lock
 
1445
    def push(self, target, overwrite=False, stop_revision=None):
 
1446
        self._ensure_real()
 
1447
        return self._real_branch.push(
 
1448
            target, overwrite=overwrite, stop_revision=stop_revision,
 
1449
            _override_hook_source_branch=self)
 
1450
 
 
1451
    def is_locked(self):
 
1452
        return self._lock_count >= 1
 
1453
 
 
1454
    def set_last_revision_info(self, revno, revision_id):
 
1455
        self._ensure_real()
 
1456
        self._clear_cached_state()
 
1457
        return self._real_branch.set_last_revision_info(revno, revision_id)
 
1458
 
 
1459
    def generate_revision_history(self, revision_id, last_rev=None,
 
1460
                                  other_branch=None):
 
1461
        self._ensure_real()
 
1462
        return self._real_branch.generate_revision_history(
 
1463
            revision_id, last_rev=last_rev, other_branch=other_branch)
 
1464
 
 
1465
    @property
 
1466
    def tags(self):
 
1467
        self._ensure_real()
 
1468
        return self._real_branch.tags
 
1469
 
 
1470
    def set_push_location(self, location):
 
1471
        self._ensure_real()
 
1472
        return self._real_branch.set_push_location(location)
 
1473
 
 
1474
    def update_revisions(self, other, stop_revision=None, overwrite=False):
 
1475
        self._ensure_real()
 
1476
        return self._real_branch.update_revisions(
 
1477
            other, stop_revision=stop_revision, overwrite=overwrite)
 
1478
 
 
1479
 
 
1480
class RemoteBranchConfig(BranchConfig):
 
1481
 
 
1482
    def username(self):
 
1483
        self.branch._ensure_real()
 
1484
        return self.branch._real_branch.get_config().username()
 
1485
 
 
1486
    def _get_branch_data_config(self):
 
1487
        self.branch._ensure_real()
 
1488
        if self._branch_data_config is None:
 
1489
            self._branch_data_config = TreeConfig(self.branch._real_branch)
 
1490
        return self._branch_data_config
 
1491
 
 
1492
 
 
1493
def _extract_tar(tar, to_dir):
 
1494
    """Extract all the contents of a tarfile object.
 
1495
 
 
1496
    A replacement for extractall, which is not present in python2.4
 
1497
    """
 
1498
    for tarinfo in tar:
 
1499
        tar.extract(tarinfo, to_dir)