/brz/remove-bazaar

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

« back to all changes in this revision

Viewing changes to bzrlib/remote.py

  • Committer: Ian Clatworthy
  • Date: 2008-03-28 07:24:55 UTC
  • mfrom: (3277.1.4 bzr.scode)
  • mto: This revision was merged to the branch mainline in revision 3314.
  • Revision ID: ian.clatworthy@canonical.com-20080328072455-0xlxool8cm4ibem8
Improve doc on send/merge relationship (Peter Schuller)

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