/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: Aaron Bentley
  • Date: 2007-07-05 00:17:17 UTC
  • mto: This revision was merged to the branch mainline in revision 2631.
  • Revision ID: aaron.bentley@utoronto.ca-20070705001717-xvjziyhsvaehxz01
Raise BadBundle for records with wrong number of names

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