/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: Andrew Bennetts
  • Date: 2008-02-06 03:52:25 UTC
  • mto: This revision was merged to the branch mainline in revision 3220.
  • Revision ID: andrew.bennetts@canonical.com-20080206035225-q572lt8uhrpl22dj
Recover (by reconnecting) if the server turns out not to understand the new requests in 1.2 that send bodies.

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