/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: Canonical.com Patch Queue Manager
  • Date: 2007-10-03 05:04:42 UTC
  • mfrom: (2776.4.19 commit)
  • Revision ID: pqm@pqm.ubuntu.com-20071003050442-e0x9ofdfo0hwxnal
(robertc) Move serialisation of inventory entries into CommitBuilder. (Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
# Copyright (C) 2006, 2007 Canonical Ltd
 
2
#
 
3
# This program is free software; you can redistribute it and/or modify
 
4
# it under the terms of the GNU General Public License as published by
 
5
# the Free Software Foundation; either version 2 of the License, or
 
6
# (at your option) any later version.
 
7
#
 
8
# This program is distributed in the hope that it will be useful,
 
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
 
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
11
# GNU General Public License for more details.
 
12
#
 
13
# You should have received a copy of the GNU General Public License
 
14
# along with this program; if not, write to the Free Software
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
 
17
# TODO: At some point, handle upgrades by just passing the whole request
 
18
# across to run on the server.
 
19
 
 
20
from cStringIO import StringIO
 
21
 
 
22
from bzrlib import (
 
23
    branch,
 
24
    errors,
 
25
    lockdir,
 
26
    repository,
 
27
)
 
28
from bzrlib.branch import Branch, BranchReferenceFormat
 
29
from bzrlib.bzrdir import BzrDir, RemoteBzrDirFormat
 
30
from bzrlib.config import BranchConfig, TreeConfig
 
31
from bzrlib.decorators import needs_read_lock, needs_write_lock
 
32
from bzrlib.errors import NoSuchRevision
 
33
from bzrlib.lockable_files import LockableFiles
 
34
from bzrlib.revision import NULL_REVISION
 
35
from bzrlib.smart import client, vfs
 
36
from bzrlib.symbol_versioning import (
 
37
    deprecated_method,
 
38
    zero_ninetyone,
 
39
    )
 
40
from bzrlib.trace import note
 
41
 
 
42
# Note: RemoteBzrDirFormat is in bzrdir.py
 
43
 
 
44
class RemoteBzrDir(BzrDir):
 
45
    """Control directory on a remote server, accessed via bzr:// or similar."""
 
46
 
 
47
    def __init__(self, transport, _client=None):
 
48
        """Construct a RemoteBzrDir.
 
49
 
 
50
        :param _client: Private parameter for testing. Disables probing and the
 
51
            use of a real bzrdir.
 
52
        """
 
53
        BzrDir.__init__(self, transport, RemoteBzrDirFormat())
 
54
        # this object holds a delegated bzrdir that uses file-level operations
 
55
        # to talk to the other side
 
56
        self._real_bzrdir = None
 
57
 
 
58
        if _client is None:
 
59
            self._shared_medium = transport.get_shared_medium()
 
60
            self._client = client._SmartClient(self._shared_medium)
 
61
        else:
 
62
            self._client = _client
 
63
            self._shared_medium = None
 
64
            return
 
65
 
 
66
        path = self._path_for_remote_call(self._client)
 
67
        response = self._client.call('BzrDir.open', path)
 
68
        if response not in [('yes',), ('no',)]:
 
69
            raise errors.UnexpectedSmartServerResponse(response)
 
70
        if response == ('no',):
 
71
            raise errors.NotBranchError(path=transport.base)
 
72
 
 
73
    def _ensure_real(self):
 
74
        """Ensure that there is a _real_bzrdir set.
 
75
 
 
76
        Used before calls to self._real_bzrdir.
 
77
        """
 
78
        if not self._real_bzrdir:
 
79
            self._real_bzrdir = BzrDir.open_from_transport(
 
80
                self.root_transport, _server_formats=False)
 
81
 
 
82
    def create_repository(self, shared=False):
 
83
        self._ensure_real()
 
84
        self._real_bzrdir.create_repository(shared=shared)
 
85
        return self.open_repository()
 
86
 
 
87
    def create_branch(self):
 
88
        self._ensure_real()
 
89
        real_branch = self._real_bzrdir.create_branch()
 
90
        return RemoteBranch(self, self.find_repository(), real_branch)
 
91
 
 
92
    def destroy_branch(self):
 
93
        """See BzrDir.destroy_branch"""
 
94
        self._ensure_real()
 
95
        self._real_bzrdir.destroy_branch()
 
96
 
 
97
    def create_workingtree(self, revision_id=None):
 
98
        raise errors.NotLocalUrl(self.transport.base)
 
99
 
 
100
    def find_branch_format(self):
 
101
        """Find the branch 'format' for this bzrdir.
 
102
 
 
103
        This might be a synthetic object for e.g. RemoteBranch and SVN.
 
104
        """
 
105
        b = self.open_branch()
 
106
        return b._format
 
107
 
 
108
    def get_branch_reference(self):
 
109
        """See BzrDir.get_branch_reference()."""
 
110
        path = self._path_for_remote_call(self._client)
 
111
        response = self._client.call('BzrDir.open_branch', path)
 
112
        if response[0] == 'ok':
 
113
            if response[1] == '':
 
114
                # branch at this location.
 
115
                return None
 
116
            else:
 
117
                # a branch reference, use the existing BranchReference logic.
 
118
                return response[1]
 
119
        elif response == ('nobranch',):
 
120
            raise errors.NotBranchError(path=self.root_transport.base)
 
121
        else:
 
122
            raise errors.UnexpectedSmartServerResponse(response)
 
123
 
 
124
    def open_branch(self, _unsupported=False):
 
125
        assert _unsupported == False, 'unsupported flag support not implemented yet.'
 
126
        reference_url = self.get_branch_reference()
 
127
        if reference_url is None:
 
128
            # branch at this location.
 
129
            return RemoteBranch(self, self.find_repository())
 
130
        else:
 
131
            # a branch reference, use the existing BranchReference logic.
 
132
            format = BranchReferenceFormat()
 
133
            return format.open(self, _found=True, location=reference_url)
 
134
                
 
135
    def open_repository(self):
 
136
        path = self._path_for_remote_call(self._client)
 
137
        response = self._client.call('BzrDir.find_repository', path)
 
138
        assert response[0] in ('ok', 'norepository'), \
 
139
            'unexpected response code %s' % (response,)
 
140
        if response[0] == 'norepository':
 
141
            raise errors.NoRepositoryPresent(self)
 
142
        assert len(response) == 4, 'incorrect response length %s' % (response,)
 
143
        if response[1] == '':
 
144
            format = RemoteRepositoryFormat()
 
145
            format.rich_root_data = (response[2] == 'yes')
 
146
            format.supports_tree_reference = (response[3] == 'yes')
 
147
            return RemoteRepository(self, format)
 
148
        else:
 
149
            raise errors.NoRepositoryPresent(self)
 
150
 
 
151
    def open_workingtree(self, recommend_upgrade=True):
 
152
        self._ensure_real()
 
153
        if self._real_bzrdir.has_workingtree():
 
154
            raise errors.NotLocalUrl(self.root_transport)
 
155
        else:
 
156
            raise errors.NoWorkingTree(self.root_transport.base)
 
157
 
 
158
    def _path_for_remote_call(self, client):
 
159
        """Return the path to be used for this bzrdir in a remote call."""
 
160
        return client.remote_path_from_transport(self.root_transport)
 
161
 
 
162
    def get_branch_transport(self, branch_format):
 
163
        self._ensure_real()
 
164
        return self._real_bzrdir.get_branch_transport(branch_format)
 
165
 
 
166
    def get_repository_transport(self, repository_format):
 
167
        self._ensure_real()
 
168
        return self._real_bzrdir.get_repository_transport(repository_format)
 
169
 
 
170
    def get_workingtree_transport(self, workingtree_format):
 
171
        self._ensure_real()
 
172
        return self._real_bzrdir.get_workingtree_transport(workingtree_format)
 
173
 
 
174
    def can_convert_format(self):
 
175
        """Upgrading of remote bzrdirs is not supported yet."""
 
176
        return False
 
177
 
 
178
    def needs_format_conversion(self, format=None):
 
179
        """Upgrading of remote bzrdirs is not supported yet."""
 
180
        return False
 
181
 
 
182
    def clone(self, url, revision_id=None, force_new_repo=False):
 
183
        self._ensure_real()
 
184
        return self._real_bzrdir.clone(url, revision_id=revision_id,
 
185
            force_new_repo=force_new_repo)
 
186
 
 
187
 
 
188
class RemoteRepositoryFormat(repository.RepositoryFormat):
 
189
    """Format for repositories accessed over a _SmartClient.
 
190
 
 
191
    Instances of this repository are represented by RemoteRepository
 
192
    instances.
 
193
 
 
194
    The RemoteRepositoryFormat is parameterised during construction
 
195
    to reflect the capabilities of the real, remote format. Specifically
 
196
    the attributes rich_root_data and supports_tree_reference are set
 
197
    on a per instance basis, and are not set (and should not be) at
 
198
    the class level.
 
199
    """
 
200
 
 
201
    _matchingbzrdir = RemoteBzrDirFormat
 
202
 
 
203
    def initialize(self, a_bzrdir, shared=False):
 
204
        assert isinstance(a_bzrdir, RemoteBzrDir), \
 
205
            '%r is not a RemoteBzrDir' % (a_bzrdir,)
 
206
        return a_bzrdir.create_repository(shared=shared)
 
207
    
 
208
    def open(self, a_bzrdir):
 
209
        assert isinstance(a_bzrdir, RemoteBzrDir)
 
210
        return a_bzrdir.open_repository()
 
211
 
 
212
    def get_format_description(self):
 
213
        return 'bzr remote repository'
 
214
 
 
215
    def __eq__(self, other):
 
216
        return self.__class__ == other.__class__
 
217
 
 
218
    def check_conversion_target(self, target_format):
 
219
        if self.rich_root_data and not target_format.rich_root_data:
 
220
            raise errors.BadConversionTarget(
 
221
                'Does not support rich root data.', target_format)
 
222
        if (self.supports_tree_reference and
 
223
            not getattr(target_format, 'supports_tree_reference', False)):
 
224
            raise errors.BadConversionTarget(
 
225
                'Does not support nested trees', target_format)
 
226
 
 
227
 
 
228
class RemoteRepository(object):
 
229
    """Repository accessed over rpc.
 
230
 
 
231
    For the moment most operations are performed using local transport-backed
 
232
    Repository objects.
 
233
    """
 
234
 
 
235
    def __init__(self, remote_bzrdir, format, real_repository=None, _client=None):
 
236
        """Create a RemoteRepository instance.
 
237
        
 
238
        :param remote_bzrdir: The bzrdir hosting this repository.
 
239
        :param format: The RemoteFormat object to use.
 
240
        :param real_repository: If not None, a local implementation of the
 
241
            repository logic for the repository, usually accessing the data
 
242
            via the VFS.
 
243
        :param _client: Private testing parameter - override the smart client
 
244
            to be used by the repository.
 
245
        """
 
246
        if real_repository:
 
247
            self._real_repository = real_repository
 
248
        else:
 
249
            self._real_repository = None
 
250
        self.bzrdir = remote_bzrdir
 
251
        if _client is None:
 
252
            self._client = client._SmartClient(self.bzrdir._shared_medium)
 
253
        else:
 
254
            self._client = _client
 
255
        self._format = format
 
256
        self._lock_mode = None
 
257
        self._lock_token = None
 
258
        self._lock_count = 0
 
259
        self._leave_lock = False
 
260
        # for tests
 
261
        self._reconcile_does_inventory_gc = True
 
262
        self.base = self.bzrdir.transport.base
 
263
 
 
264
    def __str__(self):
 
265
        return "%s(%s)" % (self.__class__.__name__, self.base)
 
266
 
 
267
    __repr__ = __str__
 
268
 
 
269
    def abort_write_group(self):
 
270
        """Complete a write group on the decorated repository.
 
271
        
 
272
        Smart methods peform operations in a single step so this api
 
273
        is not really applicable except as a compatibility thunk
 
274
        for older plugins that don't use e.g. the CommitBuilder
 
275
        facility.
 
276
        """
 
277
        self._ensure_real()
 
278
        return self._real_repository.abort_write_group()
 
279
 
 
280
    def commit_write_group(self):
 
281
        """Complete a write group on the decorated repository.
 
282
        
 
283
        Smart methods peform operations in a single step so this api
 
284
        is not really applicable except as a compatibility thunk
 
285
        for older plugins that don't use e.g. the CommitBuilder
 
286
        facility.
 
287
        """
 
288
        self._ensure_real()
 
289
        return self._real_repository.commit_write_group()
 
290
 
 
291
    def _ensure_real(self):
 
292
        """Ensure that there is a _real_repository set.
 
293
 
 
294
        Used before calls to self._real_repository.
 
295
        """
 
296
        if not self._real_repository:
 
297
            self.bzrdir._ensure_real()
 
298
            #self._real_repository = self.bzrdir._real_bzrdir.open_repository()
 
299
            self._set_real_repository(self.bzrdir._real_bzrdir.open_repository())
 
300
 
 
301
    def get_revision_graph(self, revision_id=None):
 
302
        """See Repository.get_revision_graph()."""
 
303
        if revision_id is None:
 
304
            revision_id = ''
 
305
        elif revision_id == NULL_REVISION:
 
306
            return {}
 
307
 
 
308
        path = self.bzrdir._path_for_remote_call(self._client)
 
309
        assert type(revision_id) is str
 
310
        response = self._client.call_expecting_body(
 
311
            'Repository.get_revision_graph', path, revision_id)
 
312
        if response[0][0] not in ['ok', 'nosuchrevision']:
 
313
            raise errors.UnexpectedSmartServerResponse(response[0])
 
314
        if response[0][0] == 'ok':
 
315
            coded = response[1].read_body_bytes()
 
316
            if coded == '':
 
317
                # no revisions in this repository!
 
318
                return {}
 
319
            lines = coded.split('\n')
 
320
            revision_graph = {}
 
321
            for line in lines:
 
322
                d = tuple(line.split())
 
323
                revision_graph[d[0]] = d[1:]
 
324
                
 
325
            return revision_graph
 
326
        else:
 
327
            response_body = response[1].read_body_bytes()
 
328
            assert response_body == ''
 
329
            raise NoSuchRevision(self, revision_id)
 
330
 
 
331
    def has_revision(self, revision_id):
 
332
        """See Repository.has_revision()."""
 
333
        if revision_id is None:
 
334
            # The null revision is always present.
 
335
            return True
 
336
        path = self.bzrdir._path_for_remote_call(self._client)
 
337
        response = self._client.call('Repository.has_revision', path, revision_id)
 
338
        assert response[0] in ('yes', 'no'), 'unexpected response code %s' % (response,)
 
339
        return response[0] == 'yes'
 
340
 
 
341
    def has_same_location(self, other):
 
342
        return (self.__class__ == other.__class__ and
 
343
                self.bzrdir.transport.base == other.bzrdir.transport.base)
 
344
        
 
345
    def get_graph(self, other_repository=None):
 
346
        """Return the graph for this repository format"""
 
347
        return self._real_repository.get_graph(other_repository)
 
348
 
 
349
    def gather_stats(self, revid=None, committers=None):
 
350
        """See Repository.gather_stats()."""
 
351
        path = self.bzrdir._path_for_remote_call(self._client)
 
352
        if revid in (None, NULL_REVISION):
 
353
            fmt_revid = ''
 
354
        else:
 
355
            fmt_revid = revid
 
356
        if committers is None or not committers:
 
357
            fmt_committers = 'no'
 
358
        else:
 
359
            fmt_committers = 'yes'
 
360
        response = self._client.call_expecting_body(
 
361
            'Repository.gather_stats', path, fmt_revid, fmt_committers)
 
362
        assert response[0][0] == 'ok', \
 
363
            'unexpected response code %s' % (response[0],)
 
364
 
 
365
        body = response[1].read_body_bytes()
 
366
        result = {}
 
367
        for line in body.split('\n'):
 
368
            if not line:
 
369
                continue
 
370
            key, val_text = line.split(':')
 
371
            if key in ('revisions', 'size', 'committers'):
 
372
                result[key] = int(val_text)
 
373
            elif key in ('firstrev', 'latestrev'):
 
374
                values = val_text.split(' ')[1:]
 
375
                result[key] = (float(values[0]), long(values[1]))
 
376
 
 
377
        return result
 
378
 
 
379
    def get_physical_lock_status(self):
 
380
        """See Repository.get_physical_lock_status()."""
 
381
        return False
 
382
 
 
383
    def is_in_write_group(self):
 
384
        """Return True if there is an open write group.
 
385
 
 
386
        write groups are only applicable locally for the smart server..
 
387
        """
 
388
        if self._real_repository:
 
389
            return self._real_repository.is_in_write_group()
 
390
 
 
391
    def is_locked(self):
 
392
        return self._lock_count >= 1
 
393
 
 
394
    def is_shared(self):
 
395
        """See Repository.is_shared()."""
 
396
        path = self.bzrdir._path_for_remote_call(self._client)
 
397
        response = self._client.call('Repository.is_shared', path)
 
398
        assert response[0] in ('yes', 'no'), 'unexpected response code %s' % (response,)
 
399
        return response[0] == 'yes'
 
400
 
 
401
    def lock_read(self):
 
402
        # wrong eventually - want a local lock cache context
 
403
        if not self._lock_mode:
 
404
            self._lock_mode = 'r'
 
405
            self._lock_count = 1
 
406
            if self._real_repository is not None:
 
407
                self._real_repository.lock_read()
 
408
        else:
 
409
            self._lock_count += 1
 
410
 
 
411
    def _remote_lock_write(self, token):
 
412
        path = self.bzrdir._path_for_remote_call(self._client)
 
413
        if token is None:
 
414
            token = ''
 
415
        response = self._client.call('Repository.lock_write', path, token)
 
416
        if response[0] == 'ok':
 
417
            ok, token = response
 
418
            return token
 
419
        elif response[0] == 'LockContention':
 
420
            raise errors.LockContention('(remote lock)')
 
421
        elif response[0] == 'UnlockableTransport':
 
422
            raise errors.UnlockableTransport(self.bzrdir.root_transport)
 
423
        else:
 
424
            raise errors.UnexpectedSmartServerResponse(response)
 
425
 
 
426
    def lock_write(self, token=None):
 
427
        if not self._lock_mode:
 
428
            self._lock_token = self._remote_lock_write(token)
 
429
            assert self._lock_token, 'Remote server did not return a token!'
 
430
            if self._real_repository is not None:
 
431
                self._real_repository.lock_write(token=self._lock_token)
 
432
            if token is not None:
 
433
                self._leave_lock = True
 
434
            else:
 
435
                self._leave_lock = False
 
436
            self._lock_mode = 'w'
 
437
            self._lock_count = 1
 
438
        elif self._lock_mode == 'r':
 
439
            raise errors.ReadOnlyError(self)
 
440
        else:
 
441
            self._lock_count += 1
 
442
        return self._lock_token
 
443
 
 
444
    def leave_lock_in_place(self):
 
445
        self._leave_lock = True
 
446
 
 
447
    def dont_leave_lock_in_place(self):
 
448
        self._leave_lock = False
 
449
 
 
450
    def _set_real_repository(self, repository):
 
451
        """Set the _real_repository for this repository.
 
452
 
 
453
        :param repository: The repository to fallback to for non-hpss
 
454
            implemented operations.
 
455
        """
 
456
        assert not isinstance(repository, RemoteRepository)
 
457
        self._real_repository = repository
 
458
        if self._lock_mode == 'w':
 
459
            # if we are already locked, the real repository must be able to
 
460
            # acquire the lock with our token.
 
461
            self._real_repository.lock_write(self._lock_token)
 
462
        elif self._lock_mode == 'r':
 
463
            self._real_repository.lock_read()
 
464
 
 
465
    def start_write_group(self):
 
466
        """Start a write group on the decorated repository.
 
467
        
 
468
        Smart methods peform operations in a single step so this api
 
469
        is not really applicable except as a compatibility thunk
 
470
        for older plugins that don't use e.g. the CommitBuilder
 
471
        facility.
 
472
        """
 
473
        self._ensure_real()
 
474
        return self._real_repository.start_write_group()
 
475
 
 
476
    def _unlock(self, token):
 
477
        path = self.bzrdir._path_for_remote_call(self._client)
 
478
        response = self._client.call('Repository.unlock', path, token)
 
479
        if response == ('ok',):
 
480
            return
 
481
        elif response[0] == 'TokenMismatch':
 
482
            raise errors.TokenMismatch(token, '(remote token)')
 
483
        else:
 
484
            raise errors.UnexpectedSmartServerResponse(response)
 
485
 
 
486
    def unlock(self):
 
487
        if self._lock_count == 1 and self._lock_mode == 'w':
 
488
            # don't unlock if inside a write group.
 
489
            if self.is_in_write_group():
 
490
                raise errors.BzrError(
 
491
                    'Must end write groups before releasing write locks.')
 
492
        self._lock_count -= 1
 
493
        if not self._lock_count:
 
494
            mode = self._lock_mode
 
495
            self._lock_mode = None
 
496
            if self._real_repository is not None:
 
497
                self._real_repository.unlock()
 
498
            if mode != 'w':
 
499
                # Only write-locked repositories need to make a remote method
 
500
                # call to perfom the unlock.
 
501
                return
 
502
            assert self._lock_token, 'Locked, but no token!'
 
503
            token = self._lock_token
 
504
            self._lock_token = None
 
505
            if not self._leave_lock:
 
506
                self._unlock(token)
 
507
 
 
508
    def break_lock(self):
 
509
        # should hand off to the network
 
510
        self._ensure_real()
 
511
        return self._real_repository.break_lock()
 
512
 
 
513
    def _get_tarball(self, compression):
 
514
        """Return a TemporaryFile containing a repository tarball"""
 
515
        import tempfile
 
516
        path = self.bzrdir._path_for_remote_call(self._client)
 
517
        response, protocol = self._client.call_expecting_body(
 
518
            'Repository.tarball', path, compression)
 
519
        assert response[0] in ('ok', 'failure'), \
 
520
            'unexpected response code %s' % (response,)
 
521
        if response[0] == 'ok':
 
522
            # Extract the tarball and return it
 
523
            t = tempfile.NamedTemporaryFile()
 
524
            # TODO: rpc layer should read directly into it...
 
525
            t.write(protocol.read_body_bytes())
 
526
            t.seek(0)
 
527
            return t
 
528
        else:
 
529
            raise errors.SmartServerError(error_code=response)
 
530
 
 
531
    def sprout(self, to_bzrdir, revision_id=None):
 
532
        # TODO: Option to control what format is created?
 
533
        to_repo = to_bzrdir.create_repository()
 
534
        self._copy_repository_tarball(to_repo, revision_id)
 
535
        return to_repo
 
536
 
 
537
    ### These methods are just thin shims to the VFS object for now.
 
538
 
 
539
    def revision_tree(self, revision_id):
 
540
        self._ensure_real()
 
541
        return self._real_repository.revision_tree(revision_id)
 
542
 
 
543
    def get_serializer_format(self):
 
544
        self._ensure_real()
 
545
        return self._real_repository.get_serializer_format()
 
546
 
 
547
    def get_commit_builder(self, branch, parents, config, timestamp=None,
 
548
                           timezone=None, committer=None, revprops=None,
 
549
                           revision_id=None):
 
550
        # FIXME: It ought to be possible to call this without immediately
 
551
        # triggering _ensure_real.  For now it's the easiest thing to do.
 
552
        self._ensure_real()
 
553
        builder = self._real_repository.get_commit_builder(branch, parents,
 
554
                config, timestamp=timestamp, timezone=timezone,
 
555
                committer=committer, revprops=revprops, revision_id=revision_id)
 
556
        # Make the builder use this RemoteRepository rather than the real one.
 
557
        builder.repository = self
 
558
        return builder
 
559
 
 
560
    @needs_write_lock
 
561
    def add_inventory(self, revid, inv, parents):
 
562
        self._ensure_real()
 
563
        return self._real_repository.add_inventory(revid, inv, parents)
 
564
 
 
565
    @needs_write_lock
 
566
    def add_revision(self, rev_id, rev, inv=None, config=None):
 
567
        self._ensure_real()
 
568
        return self._real_repository.add_revision(
 
569
            rev_id, rev, inv=inv, config=config)
 
570
 
 
571
    @needs_read_lock
 
572
    def get_inventory(self, revision_id):
 
573
        self._ensure_real()
 
574
        return self._real_repository.get_inventory(revision_id)
 
575
 
 
576
    @needs_read_lock
 
577
    def get_revision(self, revision_id):
 
578
        self._ensure_real()
 
579
        return self._real_repository.get_revision(revision_id)
 
580
 
 
581
    @property
 
582
    def weave_store(self):
 
583
        self._ensure_real()
 
584
        return self._real_repository.weave_store
 
585
 
 
586
    def get_transaction(self):
 
587
        self._ensure_real()
 
588
        return self._real_repository.get_transaction()
 
589
 
 
590
    @needs_read_lock
 
591
    def clone(self, a_bzrdir, revision_id=None):
 
592
        self._ensure_real()
 
593
        return self._real_repository.clone(a_bzrdir, revision_id=revision_id)
 
594
 
 
595
    def make_working_trees(self):
 
596
        """RemoteRepositories never create working trees by default."""
 
597
        return False
 
598
 
 
599
    def fetch(self, source, revision_id=None, pb=None):
 
600
        self._ensure_real()
 
601
        return self._real_repository.fetch(
 
602
            source, revision_id=revision_id, pb=pb)
 
603
 
 
604
    def create_bundle(self, target, base, fileobj, format=None):
 
605
        self._ensure_real()
 
606
        self._real_repository.create_bundle(target, base, fileobj, format)
 
607
 
 
608
    @property
 
609
    def control_weaves(self):
 
610
        self._ensure_real()
 
611
        return self._real_repository.control_weaves
 
612
 
 
613
    @needs_read_lock
 
614
    def get_ancestry(self, revision_id, topo_sorted=True):
 
615
        self._ensure_real()
 
616
        return self._real_repository.get_ancestry(revision_id, topo_sorted)
 
617
 
 
618
    @needs_read_lock
 
619
    def get_inventory_weave(self):
 
620
        self._ensure_real()
 
621
        return self._real_repository.get_inventory_weave()
 
622
 
 
623
    def fileids_altered_by_revision_ids(self, revision_ids):
 
624
        self._ensure_real()
 
625
        return self._real_repository.fileids_altered_by_revision_ids(revision_ids)
 
626
 
 
627
    def iter_files_bytes(self, desired_files):
 
628
        """See Repository.iter_file_bytes.
 
629
        """
 
630
        self._ensure_real()
 
631
        return self._real_repository.iter_files_bytes(desired_files)
 
632
 
 
633
    @needs_read_lock
 
634
    def get_signature_text(self, revision_id):
 
635
        self._ensure_real()
 
636
        return self._real_repository.get_signature_text(revision_id)
 
637
 
 
638
    @needs_read_lock
 
639
    def get_revision_graph_with_ghosts(self, revision_ids=None):
 
640
        self._ensure_real()
 
641
        return self._real_repository.get_revision_graph_with_ghosts(
 
642
            revision_ids=revision_ids)
 
643
 
 
644
    @needs_read_lock
 
645
    def get_inventory_xml(self, revision_id):
 
646
        self._ensure_real()
 
647
        return self._real_repository.get_inventory_xml(revision_id)
 
648
 
 
649
    def deserialise_inventory(self, revision_id, xml):
 
650
        self._ensure_real()
 
651
        return self._real_repository.deserialise_inventory(revision_id, xml)
 
652
 
 
653
    def reconcile(self, other=None, thorough=False):
 
654
        self._ensure_real()
 
655
        return self._real_repository.reconcile(other=other, thorough=thorough)
 
656
        
 
657
    def all_revision_ids(self):
 
658
        self._ensure_real()
 
659
        return self._real_repository.all_revision_ids()
 
660
    
 
661
    @needs_read_lock
 
662
    def get_deltas_for_revisions(self, revisions):
 
663
        self._ensure_real()
 
664
        return self._real_repository.get_deltas_for_revisions(revisions)
 
665
 
 
666
    @needs_read_lock
 
667
    def get_revision_delta(self, revision_id):
 
668
        self._ensure_real()
 
669
        return self._real_repository.get_revision_delta(revision_id)
 
670
 
 
671
    @needs_read_lock
 
672
    def revision_trees(self, revision_ids):
 
673
        self._ensure_real()
 
674
        return self._real_repository.revision_trees(revision_ids)
 
675
 
 
676
    @needs_read_lock
 
677
    def get_revision_reconcile(self, revision_id):
 
678
        self._ensure_real()
 
679
        return self._real_repository.get_revision_reconcile(revision_id)
 
680
 
 
681
    @needs_read_lock
 
682
    def check(self, revision_ids):
 
683
        self._ensure_real()
 
684
        return self._real_repository.check(revision_ids)
 
685
 
 
686
    def copy_content_into(self, destination, revision_id=None):
 
687
        self._ensure_real()
 
688
        return self._real_repository.copy_content_into(
 
689
            destination, revision_id=revision_id)
 
690
 
 
691
    def _copy_repository_tarball(self, destination, revision_id=None):
 
692
        # get a tarball of the remote repository, and copy from that into the
 
693
        # destination
 
694
        from bzrlib import osutils
 
695
        import tarfile
 
696
        import tempfile
 
697
        from StringIO import StringIO
 
698
        # TODO: Maybe a progress bar while streaming the tarball?
 
699
        note("Copying repository content as tarball...")
 
700
        tar_file = self._get_tarball('bz2')
 
701
        try:
 
702
            tar = tarfile.open('repository', fileobj=tar_file,
 
703
                mode='r|bz2')
 
704
            tmpdir = tempfile.mkdtemp()
 
705
            try:
 
706
                _extract_tar(tar, tmpdir)
 
707
                tmp_bzrdir = BzrDir.open(tmpdir)
 
708
                tmp_repo = tmp_bzrdir.open_repository()
 
709
                tmp_repo.copy_content_into(destination, revision_id)
 
710
            finally:
 
711
                osutils.rmtree(tmpdir)
 
712
        finally:
 
713
            tar_file.close()
 
714
        # TODO: if the server doesn't support this operation, maybe do it the
 
715
        # slow way using the _real_repository?
 
716
        #
 
717
        # TODO: Suggestion from john: using external tar is much faster than
 
718
        # python's tarfile library, but it may not work on windows.
 
719
 
 
720
    @needs_write_lock
 
721
    def pack(self):
 
722
        """Compress the data within the repository.
 
723
 
 
724
        This is not currently implemented within the smart server.
 
725
        """
 
726
        self._ensure_real()
 
727
        return self._real_repository.pack()
 
728
 
 
729
    def set_make_working_trees(self, new_value):
 
730
        raise NotImplementedError(self.set_make_working_trees)
 
731
 
 
732
    @needs_write_lock
 
733
    def sign_revision(self, revision_id, gpg_strategy):
 
734
        self._ensure_real()
 
735
        return self._real_repository.sign_revision(revision_id, gpg_strategy)
 
736
 
 
737
    @needs_read_lock
 
738
    def get_revisions(self, revision_ids):
 
739
        self._ensure_real()
 
740
        return self._real_repository.get_revisions(revision_ids)
 
741
 
 
742
    def supports_rich_root(self):
 
743
        self._ensure_real()
 
744
        return self._real_repository.supports_rich_root()
 
745
 
 
746
    def iter_reverse_revision_history(self, revision_id):
 
747
        self._ensure_real()
 
748
        return self._real_repository.iter_reverse_revision_history(revision_id)
 
749
 
 
750
    @property
 
751
    def _serializer(self):
 
752
        self._ensure_real()
 
753
        return self._real_repository._serializer
 
754
 
 
755
    def store_revision_signature(self, gpg_strategy, plaintext, revision_id):
 
756
        self._ensure_real()
 
757
        return self._real_repository.store_revision_signature(
 
758
            gpg_strategy, plaintext, revision_id)
 
759
 
 
760
    def has_signature_for_revision_id(self, revision_id):
 
761
        self._ensure_real()
 
762
        return self._real_repository.has_signature_for_revision_id(revision_id)
 
763
 
 
764
 
 
765
class RemoteBranchLockableFiles(LockableFiles):
 
766
    """A 'LockableFiles' implementation that talks to a smart server.
 
767
    
 
768
    This is not a public interface class.
 
769
    """
 
770
 
 
771
    def __init__(self, bzrdir, _client):
 
772
        self.bzrdir = bzrdir
 
773
        self._client = _client
 
774
        self._need_find_modes = True
 
775
        LockableFiles.__init__(
 
776
            self, bzrdir.get_branch_transport(None),
 
777
            'lock', lockdir.LockDir)
 
778
 
 
779
    def _find_modes(self):
 
780
        # RemoteBranches don't let the client set the mode of control files.
 
781
        self._dir_mode = None
 
782
        self._file_mode = None
 
783
 
 
784
    def get(self, path):
 
785
        """'get' a remote path as per the LockableFiles interface.
 
786
 
 
787
        :param path: the file to 'get'. If this is 'branch.conf', we do not
 
788
             just retrieve a file, instead we ask the smart server to generate
 
789
             a configuration for us - which is retrieved as an INI file.
 
790
        """
 
791
        if path == 'branch.conf':
 
792
            path = self.bzrdir._path_for_remote_call(self._client)
 
793
            response = self._client.call_expecting_body(
 
794
                'Branch.get_config_file', path)
 
795
            assert response[0][0] == 'ok', \
 
796
                'unexpected response code %s' % (response[0],)
 
797
            return StringIO(response[1].read_body_bytes())
 
798
        else:
 
799
            # VFS fallback.
 
800
            return LockableFiles.get(self, path)
 
801
 
 
802
 
 
803
class RemoteBranchFormat(branch.BranchFormat):
 
804
 
 
805
    def __eq__(self, other):
 
806
        return (isinstance(other, RemoteBranchFormat) and 
 
807
            self.__dict__ == other.__dict__)
 
808
 
 
809
    def get_format_description(self):
 
810
        return 'Remote BZR Branch'
 
811
 
 
812
    def get_format_string(self):
 
813
        return 'Remote BZR Branch'
 
814
 
 
815
    def open(self, a_bzrdir):
 
816
        assert isinstance(a_bzrdir, RemoteBzrDir)
 
817
        return a_bzrdir.open_branch()
 
818
 
 
819
    def initialize(self, a_bzrdir):
 
820
        assert isinstance(a_bzrdir, RemoteBzrDir)
 
821
        return a_bzrdir.create_branch()
 
822
 
 
823
    def supports_tags(self):
 
824
        # Remote branches might support tags, but we won't know until we
 
825
        # access the real remote branch.
 
826
        return True
 
827
 
 
828
 
 
829
class RemoteBranch(branch.Branch):
 
830
    """Branch stored on a server accessed by HPSS RPC.
 
831
 
 
832
    At the moment most operations are mapped down to simple file operations.
 
833
    """
 
834
 
 
835
    def __init__(self, remote_bzrdir, remote_repository, real_branch=None,
 
836
        _client=None):
 
837
        """Create a RemoteBranch instance.
 
838
 
 
839
        :param real_branch: An optional local implementation of the branch
 
840
            format, usually accessing the data via the VFS.
 
841
        :param _client: Private parameter for testing.
 
842
        """
 
843
        # We intentionally don't call the parent class's __init__, because it
 
844
        # will try to assign to self.tags, which is a property in this subclass.
 
845
        # And the parent's __init__ doesn't do much anyway.
 
846
        self._revision_history_cache = None
 
847
        self.bzrdir = remote_bzrdir
 
848
        if _client is not None:
 
849
            self._client = _client
 
850
        else:
 
851
            self._client = client._SmartClient(self.bzrdir._shared_medium)
 
852
        self.repository = remote_repository
 
853
        if real_branch is not None:
 
854
            self._real_branch = real_branch
 
855
            # Give the remote repository the matching real repo.
 
856
            real_repo = self._real_branch.repository
 
857
            if isinstance(real_repo, RemoteRepository):
 
858
                real_repo._ensure_real()
 
859
                real_repo = real_repo._real_repository
 
860
            self.repository._set_real_repository(real_repo)
 
861
            # Give the branch the remote repository to let fast-pathing happen.
 
862
            self._real_branch.repository = self.repository
 
863
        else:
 
864
            self._real_branch = None
 
865
        # Fill out expected attributes of branch for bzrlib api users.
 
866
        self._format = RemoteBranchFormat()
 
867
        self.base = self.bzrdir.root_transport.base
 
868
        self._control_files = None
 
869
        self._lock_mode = None
 
870
        self._lock_token = None
 
871
        self._lock_count = 0
 
872
        self._leave_lock = False
 
873
 
 
874
    def __str__(self):
 
875
        return "%s(%s)" % (self.__class__.__name__, self.base)
 
876
 
 
877
    __repr__ = __str__
 
878
 
 
879
    def _ensure_real(self):
 
880
        """Ensure that there is a _real_branch set.
 
881
 
 
882
        Used before calls to self._real_branch.
 
883
        """
 
884
        if not self._real_branch:
 
885
            assert vfs.vfs_enabled()
 
886
            self.bzrdir._ensure_real()
 
887
            self._real_branch = self.bzrdir._real_bzrdir.open_branch()
 
888
            # Give the remote repository the matching real repo.
 
889
            real_repo = self._real_branch.repository
 
890
            if isinstance(real_repo, RemoteRepository):
 
891
                real_repo._ensure_real()
 
892
                real_repo = real_repo._real_repository
 
893
            self.repository._set_real_repository(real_repo)
 
894
            # Give the branch the remote repository to let fast-pathing happen.
 
895
            self._real_branch.repository = self.repository
 
896
            # XXX: deal with _lock_mode == 'w'
 
897
            if self._lock_mode == 'r':
 
898
                self._real_branch.lock_read()
 
899
 
 
900
    @property
 
901
    def control_files(self):
 
902
        # Defer actually creating RemoteBranchLockableFiles until its needed,
 
903
        # because it triggers an _ensure_real that we otherwise might not need.
 
904
        if self._control_files is None:
 
905
            self._control_files = RemoteBranchLockableFiles(
 
906
                self.bzrdir, self._client)
 
907
        return self._control_files
 
908
 
 
909
    def _get_checkout_format(self):
 
910
        self._ensure_real()
 
911
        return self._real_branch._get_checkout_format()
 
912
 
 
913
    def get_physical_lock_status(self):
 
914
        """See Branch.get_physical_lock_status()."""
 
915
        # should be an API call to the server, as branches must be lockable.
 
916
        self._ensure_real()
 
917
        return self._real_branch.get_physical_lock_status()
 
918
 
 
919
    def lock_read(self):
 
920
        if not self._lock_mode:
 
921
            self._lock_mode = 'r'
 
922
            self._lock_count = 1
 
923
            if self._real_branch is not None:
 
924
                self._real_branch.lock_read()
 
925
        else:
 
926
            self._lock_count += 1
 
927
 
 
928
    def _remote_lock_write(self, token):
 
929
        if token is None:
 
930
            branch_token = repo_token = ''
 
931
        else:
 
932
            branch_token = token
 
933
            repo_token = self.repository.lock_write()
 
934
            self.repository.unlock()
 
935
        path = self.bzrdir._path_for_remote_call(self._client)
 
936
        response = self._client.call('Branch.lock_write', path, branch_token,
 
937
                                     repo_token)
 
938
        if response[0] == 'ok':
 
939
            ok, branch_token, repo_token = response
 
940
            return branch_token, repo_token
 
941
        elif response[0] == 'LockContention':
 
942
            raise errors.LockContention('(remote lock)')
 
943
        elif response[0] == 'TokenMismatch':
 
944
            raise errors.TokenMismatch(token, '(remote token)')
 
945
        elif response[0] == 'UnlockableTransport':
 
946
            raise errors.UnlockableTransport(self.bzrdir.root_transport)
 
947
        elif response[0] == 'ReadOnlyError':
 
948
            raise errors.ReadOnlyError(self)
 
949
        else:
 
950
            raise errors.UnexpectedSmartServerResponse(response)
 
951
            
 
952
    def lock_write(self, token=None):
 
953
        if not self._lock_mode:
 
954
            remote_tokens = self._remote_lock_write(token)
 
955
            self._lock_token, self._repo_lock_token = remote_tokens
 
956
            assert self._lock_token, 'Remote server did not return a token!'
 
957
            # TODO: We really, really, really don't want to call _ensure_real
 
958
            # here, but it's the easiest way to ensure coherency between the
 
959
            # state of the RemoteBranch and RemoteRepository objects and the
 
960
            # physical locks.  If we don't materialise the real objects here,
 
961
            # then getting everything in the right state later is complex, so
 
962
            # for now we just do it the lazy way.
 
963
            #   -- Andrew Bennetts, 2007-02-22.
 
964
            self._ensure_real()
 
965
            if self._real_branch is not None:
 
966
                self._real_branch.repository.lock_write(
 
967
                    token=self._repo_lock_token)
 
968
                try:
 
969
                    self._real_branch.lock_write(token=self._lock_token)
 
970
                finally:
 
971
                    self._real_branch.repository.unlock()
 
972
            if token is not None:
 
973
                self._leave_lock = True
 
974
            else:
 
975
                # XXX: this case seems to be unreachable; token cannot be None.
 
976
                self._leave_lock = False
 
977
            self._lock_mode = 'w'
 
978
            self._lock_count = 1
 
979
        elif self._lock_mode == 'r':
 
980
            raise errors.ReadOnlyTransaction
 
981
        else:
 
982
            if token is not None:
 
983
                # A token was given to lock_write, and we're relocking, so check
 
984
                # that the given token actually matches the one we already have.
 
985
                if token != self._lock_token:
 
986
                    raise errors.TokenMismatch(token, self._lock_token)
 
987
            self._lock_count += 1
 
988
        return self._lock_token
 
989
 
 
990
    def _unlock(self, branch_token, repo_token):
 
991
        path = self.bzrdir._path_for_remote_call(self._client)
 
992
        response = self._client.call('Branch.unlock', path, branch_token,
 
993
                                     repo_token)
 
994
        if response == ('ok',):
 
995
            return
 
996
        elif response[0] == 'TokenMismatch':
 
997
            raise errors.TokenMismatch(
 
998
                str((branch_token, repo_token)), '(remote tokens)')
 
999
        else:
 
1000
            raise errors.UnexpectedSmartServerResponse(response)
 
1001
 
 
1002
    def unlock(self):
 
1003
        self._lock_count -= 1
 
1004
        if not self._lock_count:
 
1005
            self._clear_cached_state()
 
1006
            mode = self._lock_mode
 
1007
            self._lock_mode = None
 
1008
            if self._real_branch is not None:
 
1009
                if not self._leave_lock:
 
1010
                    # If this RemoteBranch will remove the physical lock for the
 
1011
                    # repository, make sure the _real_branch doesn't do it
 
1012
                    # first.  (Because the _real_branch's repository is set to
 
1013
                    # be the RemoteRepository.)
 
1014
                    self._real_branch.repository.leave_lock_in_place()
 
1015
                self._real_branch.unlock()
 
1016
            if mode != 'w':
 
1017
                # Only write-locked branched need to make a remote method call
 
1018
                # to perfom the unlock.
 
1019
                return
 
1020
            assert self._lock_token, 'Locked, but no token!'
 
1021
            branch_token = self._lock_token
 
1022
            repo_token = self._repo_lock_token
 
1023
            self._lock_token = None
 
1024
            self._repo_lock_token = None
 
1025
            if not self._leave_lock:
 
1026
                self._unlock(branch_token, repo_token)
 
1027
 
 
1028
    def break_lock(self):
 
1029
        self._ensure_real()
 
1030
        return self._real_branch.break_lock()
 
1031
 
 
1032
    def leave_lock_in_place(self):
 
1033
        self._leave_lock = True
 
1034
 
 
1035
    def dont_leave_lock_in_place(self):
 
1036
        self._leave_lock = False
 
1037
 
 
1038
    def last_revision_info(self):
 
1039
        """See Branch.last_revision_info()."""
 
1040
        path = self.bzrdir._path_for_remote_call(self._client)
 
1041
        response = self._client.call('Branch.last_revision_info', path)
 
1042
        assert response[0] == 'ok', 'unexpected response code %s' % (response,)
 
1043
        revno = int(response[1])
 
1044
        last_revision = response[2]
 
1045
        return (revno, last_revision)
 
1046
 
 
1047
    def _gen_revision_history(self):
 
1048
        """See Branch._gen_revision_history()."""
 
1049
        path = self.bzrdir._path_for_remote_call(self._client)
 
1050
        response = self._client.call_expecting_body(
 
1051
            'Branch.revision_history', path)
 
1052
        assert response[0][0] == 'ok', ('unexpected response code %s'
 
1053
                                        % (response[0],))
 
1054
        result = response[1].read_body_bytes().split('\x00')
 
1055
        if result == ['']:
 
1056
            return []
 
1057
        return result
 
1058
 
 
1059
    @needs_write_lock
 
1060
    def set_revision_history(self, rev_history):
 
1061
        # Send just the tip revision of the history; the server will generate
 
1062
        # the full history from that.  If the revision doesn't exist in this
 
1063
        # branch, NoSuchRevision will be raised.
 
1064
        path = self.bzrdir._path_for_remote_call(self._client)
 
1065
        if rev_history == []:
 
1066
            rev_id = 'null:'
 
1067
        else:
 
1068
            rev_id = rev_history[-1]
 
1069
        self._clear_cached_state()
 
1070
        response = self._client.call('Branch.set_last_revision',
 
1071
            path, self._lock_token, self._repo_lock_token, rev_id)
 
1072
        if response[0] == 'NoSuchRevision':
 
1073
            raise NoSuchRevision(self, rev_id)
 
1074
        else:
 
1075
            assert response == ('ok',), (
 
1076
                'unexpected response code %r' % (response,))
 
1077
        self._cache_revision_history(rev_history)
 
1078
 
 
1079
    def get_parent(self):
 
1080
        self._ensure_real()
 
1081
        return self._real_branch.get_parent()
 
1082
        
 
1083
    def set_parent(self, url):
 
1084
        self._ensure_real()
 
1085
        return self._real_branch.set_parent(url)
 
1086
        
 
1087
    def get_config(self):
 
1088
        return RemoteBranchConfig(self)
 
1089
 
 
1090
    def sprout(self, to_bzrdir, revision_id=None):
 
1091
        # Like Branch.sprout, except that it sprouts a branch in the default
 
1092
        # format, because RemoteBranches can't be created at arbitrary URLs.
 
1093
        # XXX: if to_bzrdir is a RemoteBranch, this should perhaps do
 
1094
        # to_bzrdir.create_branch...
 
1095
        result = branch.BranchFormat.get_default_format().initialize(to_bzrdir)
 
1096
        self.copy_content_into(result, revision_id=revision_id)
 
1097
        result.set_parent(self.bzrdir.root_transport.base)
 
1098
        return result
 
1099
 
 
1100
    @needs_write_lock
 
1101
    def pull(self, source, overwrite=False, stop_revision=None,
 
1102
             **kwargs):
 
1103
        # FIXME: This asks the real branch to run the hooks, which means
 
1104
        # they're called with the wrong target branch parameter. 
 
1105
        # The test suite specifically allows this at present but it should be
 
1106
        # fixed.  It should get a _override_hook_target branch,
 
1107
        # as push does.  -- mbp 20070405
 
1108
        self._ensure_real()
 
1109
        self._real_branch.pull(
 
1110
            source, overwrite=overwrite, stop_revision=stop_revision,
 
1111
            **kwargs)
 
1112
 
 
1113
    @needs_read_lock
 
1114
    def push(self, target, overwrite=False, stop_revision=None):
 
1115
        self._ensure_real()
 
1116
        return self._real_branch.push(
 
1117
            target, overwrite=overwrite, stop_revision=stop_revision,
 
1118
            _override_hook_source_branch=self)
 
1119
 
 
1120
    def is_locked(self):
 
1121
        return self._lock_count >= 1
 
1122
 
 
1123
    def set_last_revision_info(self, revno, revision_id):
 
1124
        self._ensure_real()
 
1125
        self._clear_cached_state()
 
1126
        return self._real_branch.set_last_revision_info(revno, revision_id)
 
1127
 
 
1128
    def generate_revision_history(self, revision_id, last_rev=None,
 
1129
                                  other_branch=None):
 
1130
        self._ensure_real()
 
1131
        return self._real_branch.generate_revision_history(
 
1132
            revision_id, last_rev=last_rev, other_branch=other_branch)
 
1133
 
 
1134
    @property
 
1135
    def tags(self):
 
1136
        self._ensure_real()
 
1137
        return self._real_branch.tags
 
1138
 
 
1139
    def set_push_location(self, location):
 
1140
        self._ensure_real()
 
1141
        return self._real_branch.set_push_location(location)
 
1142
 
 
1143
    def update_revisions(self, other, stop_revision=None):
 
1144
        self._ensure_real()
 
1145
        return self._real_branch.update_revisions(
 
1146
            other, stop_revision=stop_revision)
 
1147
 
 
1148
 
 
1149
class RemoteBranchConfig(BranchConfig):
 
1150
 
 
1151
    def username(self):
 
1152
        self.branch._ensure_real()
 
1153
        return self.branch._real_branch.get_config().username()
 
1154
 
 
1155
    def _get_branch_data_config(self):
 
1156
        self.branch._ensure_real()
 
1157
        if self._branch_data_config is None:
 
1158
            self._branch_data_config = TreeConfig(self.branch._real_branch)
 
1159
        return self._branch_data_config
 
1160
 
 
1161
 
 
1162
def _extract_tar(tar, to_dir):
 
1163
    """Extract all the contents of a tarfile object.
 
1164
 
 
1165
    A replacement for extractall, which is not present in python2.4
 
1166
    """
 
1167
    for tarinfo in tar:
 
1168
        tar.extract(tarinfo, to_dir)