~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/remote.py

  • Committer: Aaron Bentley
  • Date: 2005-07-26 14:06:11 UTC
  • mto: (1092.1.41) (1185.3.4) (974.1.47)
  • mto: This revision was merged to the branch mainline in revision 982.
  • Revision ID: abentley@panoramicfeedback.com-20050726140611-403e366f3c79c1f1
Fixed python invocation

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2006-2011 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
 
 
17
 
from __future__ import absolute_import
18
 
 
19
 
import bz2
20
 
import zlib
21
 
 
22
 
from bzrlib import (
23
 
    bencode,
24
 
    branch,
25
 
    bzrdir as _mod_bzrdir,
26
 
    config as _mod_config,
27
 
    controldir,
28
 
    debug,
29
 
    errors,
30
 
    gpg,
31
 
    graph,
32
 
    inventory_delta,
33
 
    lock,
34
 
    lockdir,
35
 
    osutils,
36
 
    registry,
37
 
    repository as _mod_repository,
38
 
    revision as _mod_revision,
39
 
    static_tuple,
40
 
    symbol_versioning,
41
 
    testament as _mod_testament,
42
 
    urlutils,
43
 
    vf_repository,
44
 
    vf_search,
45
 
    )
46
 
from bzrlib.branch import BranchReferenceFormat, BranchWriteLockResult
47
 
from bzrlib.decorators import needs_read_lock, needs_write_lock, only_raises
48
 
from bzrlib.errors import (
49
 
    NoSuchRevision,
50
 
    SmartProtocolError,
51
 
    )
52
 
from bzrlib.i18n import gettext
53
 
from bzrlib.inventory import Inventory
54
 
from bzrlib.lockable_files import LockableFiles
55
 
from bzrlib.smart import client, vfs, repository as smart_repo
56
 
from bzrlib.smart.client import _SmartClient
57
 
from bzrlib.revision import NULL_REVISION
58
 
from bzrlib.revisiontree import InventoryRevisionTree
59
 
from bzrlib.repository import RepositoryWriteLockResult, _LazyListJoin
60
 
from bzrlib.serializer import format_registry as serializer_format_registry
61
 
from bzrlib.trace import mutter, note, warning, log_exception_quietly
62
 
from bzrlib.versionedfile import ChunkedContentFactory, FulltextContentFactory
63
 
 
64
 
 
65
 
_DEFAULT_SEARCH_DEPTH = 100
66
 
 
67
 
 
68
 
class _RpcHelper(object):
69
 
    """Mixin class that helps with issuing RPCs."""
70
 
 
71
 
    def _call(self, method, *args, **err_context):
72
 
        try:
73
 
            return self._client.call(method, *args)
74
 
        except errors.ErrorFromSmartServer, err:
75
 
            self._translate_error(err, **err_context)
76
 
 
77
 
    def _call_expecting_body(self, method, *args, **err_context):
78
 
        try:
79
 
            return self._client.call_expecting_body(method, *args)
80
 
        except errors.ErrorFromSmartServer, err:
81
 
            self._translate_error(err, **err_context)
82
 
 
83
 
    def _call_with_body_bytes(self, method, args, body_bytes, **err_context):
84
 
        try:
85
 
            return self._client.call_with_body_bytes(method, args, body_bytes)
86
 
        except errors.ErrorFromSmartServer, err:
87
 
            self._translate_error(err, **err_context)
88
 
 
89
 
    def _call_with_body_bytes_expecting_body(self, method, args, body_bytes,
90
 
                                             **err_context):
91
 
        try:
92
 
            return self._client.call_with_body_bytes_expecting_body(
93
 
                method, args, body_bytes)
94
 
        except errors.ErrorFromSmartServer, err:
95
 
            self._translate_error(err, **err_context)
96
 
 
97
 
 
98
 
def response_tuple_to_repo_format(response):
99
 
    """Convert a response tuple describing a repository format to a format."""
100
 
    format = RemoteRepositoryFormat()
101
 
    format._rich_root_data = (response[0] == 'yes')
102
 
    format._supports_tree_reference = (response[1] == 'yes')
103
 
    format._supports_external_lookups = (response[2] == 'yes')
104
 
    format._network_name = response[3]
105
 
    return format
106
 
 
107
 
 
108
 
# Note that RemoteBzrDirProber lives in bzrlib.bzrdir so bzrlib.remote
109
 
# does not have to be imported unless a remote format is involved.
110
 
 
111
 
class RemoteBzrDirFormat(_mod_bzrdir.BzrDirMetaFormat1):
112
 
    """Format representing bzrdirs accessed via a smart server"""
113
 
 
114
 
    supports_workingtrees = False
115
 
 
116
 
    def __init__(self):
117
 
        _mod_bzrdir.BzrDirMetaFormat1.__init__(self)
118
 
        # XXX: It's a bit ugly that the network name is here, because we'd
119
 
        # like to believe that format objects are stateless or at least
120
 
        # immutable,  However, we do at least avoid mutating the name after
121
 
        # it's returned.  See <https://bugs.launchpad.net/bzr/+bug/504102>
122
 
        self._network_name = None
123
 
 
124
 
    def __repr__(self):
125
 
        return "%s(_network_name=%r)" % (self.__class__.__name__,
126
 
            self._network_name)
127
 
 
128
 
    def get_format_description(self):
129
 
        if self._network_name:
130
 
            try:
131
 
                real_format = controldir.network_format_registry.get(
132
 
                        self._network_name)
133
 
            except KeyError:
134
 
                pass
135
 
            else:
136
 
                return 'Remote: ' + real_format.get_format_description()
137
 
        return 'bzr remote bzrdir'
138
 
 
139
 
    def get_format_string(self):
140
 
        raise NotImplementedError(self.get_format_string)
141
 
 
142
 
    def network_name(self):
143
 
        if self._network_name:
144
 
            return self._network_name
145
 
        else:
146
 
            raise AssertionError("No network name set.")
147
 
 
148
 
    def initialize_on_transport(self, transport):
149
 
        try:
150
 
            # hand off the request to the smart server
151
 
            client_medium = transport.get_smart_medium()
152
 
        except errors.NoSmartMedium:
153
 
            # TODO: lookup the local format from a server hint.
154
 
            local_dir_format = _mod_bzrdir.BzrDirMetaFormat1()
155
 
            return local_dir_format.initialize_on_transport(transport)
156
 
        client = _SmartClient(client_medium)
157
 
        path = client.remote_path_from_transport(transport)
158
 
        try:
159
 
            response = client.call('BzrDirFormat.initialize', path)
160
 
        except errors.ErrorFromSmartServer, err:
161
 
            _translate_error(err, path=path)
162
 
        if response[0] != 'ok':
163
 
            raise errors.SmartProtocolError('unexpected response code %s' % (response,))
164
 
        format = RemoteBzrDirFormat()
165
 
        self._supply_sub_formats_to(format)
166
 
        return RemoteBzrDir(transport, format)
167
 
 
168
 
    def parse_NoneTrueFalse(self, arg):
169
 
        if not arg:
170
 
            return None
171
 
        if arg == 'False':
172
 
            return False
173
 
        if arg == 'True':
174
 
            return True
175
 
        raise AssertionError("invalid arg %r" % arg)
176
 
 
177
 
    def _serialize_NoneTrueFalse(self, arg):
178
 
        if arg is False:
179
 
            return 'False'
180
 
        if arg:
181
 
            return 'True'
182
 
        return ''
183
 
 
184
 
    def _serialize_NoneString(self, arg):
185
 
        return arg or ''
186
 
 
187
 
    def initialize_on_transport_ex(self, transport, use_existing_dir=False,
188
 
        create_prefix=False, force_new_repo=False, stacked_on=None,
189
 
        stack_on_pwd=None, repo_format_name=None, make_working_trees=None,
190
 
        shared_repo=False):
191
 
        try:
192
 
            # hand off the request to the smart server
193
 
            client_medium = transport.get_smart_medium()
194
 
        except errors.NoSmartMedium:
195
 
            do_vfs = True
196
 
        else:
197
 
            # Decline to open it if the server doesn't support our required
198
 
            # version (3) so that the VFS-based transport will do it.
199
 
            if client_medium.should_probe():
200
 
                try:
201
 
                    server_version = client_medium.protocol_version()
202
 
                    if server_version != '2':
203
 
                        do_vfs = True
204
 
                    else:
205
 
                        do_vfs = False
206
 
                except errors.SmartProtocolError:
207
 
                    # Apparently there's no usable smart server there, even though
208
 
                    # the medium supports the smart protocol.
209
 
                    do_vfs = True
210
 
            else:
211
 
                do_vfs = False
212
 
        if not do_vfs:
213
 
            client = _SmartClient(client_medium)
214
 
            path = client.remote_path_from_transport(transport)
215
 
            if client_medium._is_remote_before((1, 16)):
216
 
                do_vfs = True
217
 
        if do_vfs:
218
 
            # TODO: lookup the local format from a server hint.
219
 
            local_dir_format = _mod_bzrdir.BzrDirMetaFormat1()
220
 
            self._supply_sub_formats_to(local_dir_format)
221
 
            return local_dir_format.initialize_on_transport_ex(transport,
222
 
                use_existing_dir=use_existing_dir, create_prefix=create_prefix,
223
 
                force_new_repo=force_new_repo, stacked_on=stacked_on,
224
 
                stack_on_pwd=stack_on_pwd, repo_format_name=repo_format_name,
225
 
                make_working_trees=make_working_trees, shared_repo=shared_repo,
226
 
                vfs_only=True)
227
 
        return self._initialize_on_transport_ex_rpc(client, path, transport,
228
 
            use_existing_dir, create_prefix, force_new_repo, stacked_on,
229
 
            stack_on_pwd, repo_format_name, make_working_trees, shared_repo)
230
 
 
231
 
    def _initialize_on_transport_ex_rpc(self, client, path, transport,
232
 
        use_existing_dir, create_prefix, force_new_repo, stacked_on,
233
 
        stack_on_pwd, repo_format_name, make_working_trees, shared_repo):
234
 
        args = []
235
 
        args.append(self._serialize_NoneTrueFalse(use_existing_dir))
236
 
        args.append(self._serialize_NoneTrueFalse(create_prefix))
237
 
        args.append(self._serialize_NoneTrueFalse(force_new_repo))
238
 
        args.append(self._serialize_NoneString(stacked_on))
239
 
        # stack_on_pwd is often/usually our transport
240
 
        if stack_on_pwd:
241
 
            try:
242
 
                stack_on_pwd = transport.relpath(stack_on_pwd)
243
 
                if not stack_on_pwd:
244
 
                    stack_on_pwd = '.'
245
 
            except errors.PathNotChild:
246
 
                pass
247
 
        args.append(self._serialize_NoneString(stack_on_pwd))
248
 
        args.append(self._serialize_NoneString(repo_format_name))
249
 
        args.append(self._serialize_NoneTrueFalse(make_working_trees))
250
 
        args.append(self._serialize_NoneTrueFalse(shared_repo))
251
 
        request_network_name = self._network_name or \
252
 
            _mod_bzrdir.BzrDirFormat.get_default_format().network_name()
253
 
        try:
254
 
            response = client.call('BzrDirFormat.initialize_ex_1.16',
255
 
                request_network_name, path, *args)
256
 
        except errors.UnknownSmartMethod:
257
 
            client._medium._remember_remote_is_before((1,16))
258
 
            local_dir_format = _mod_bzrdir.BzrDirMetaFormat1()
259
 
            self._supply_sub_formats_to(local_dir_format)
260
 
            return local_dir_format.initialize_on_transport_ex(transport,
261
 
                use_existing_dir=use_existing_dir, create_prefix=create_prefix,
262
 
                force_new_repo=force_new_repo, stacked_on=stacked_on,
263
 
                stack_on_pwd=stack_on_pwd, repo_format_name=repo_format_name,
264
 
                make_working_trees=make_working_trees, shared_repo=shared_repo,
265
 
                vfs_only=True)
266
 
        except errors.ErrorFromSmartServer, err:
267
 
            _translate_error(err, path=path)
268
 
        repo_path = response[0]
269
 
        bzrdir_name = response[6]
270
 
        require_stacking = response[7]
271
 
        require_stacking = self.parse_NoneTrueFalse(require_stacking)
272
 
        format = RemoteBzrDirFormat()
273
 
        format._network_name = bzrdir_name
274
 
        self._supply_sub_formats_to(format)
275
 
        bzrdir = RemoteBzrDir(transport, format, _client=client)
276
 
        if repo_path:
277
 
            repo_format = response_tuple_to_repo_format(response[1:])
278
 
            if repo_path == '.':
279
 
                repo_path = ''
280
 
            if repo_path:
281
 
                repo_bzrdir_format = RemoteBzrDirFormat()
282
 
                repo_bzrdir_format._network_name = response[5]
283
 
                repo_bzr = RemoteBzrDir(transport.clone(repo_path),
284
 
                    repo_bzrdir_format)
285
 
            else:
286
 
                repo_bzr = bzrdir
287
 
            final_stack = response[8] or None
288
 
            final_stack_pwd = response[9] or None
289
 
            if final_stack_pwd:
290
 
                final_stack_pwd = urlutils.join(
291
 
                    transport.base, final_stack_pwd)
292
 
            remote_repo = RemoteRepository(repo_bzr, repo_format)
293
 
            if len(response) > 10:
294
 
                # Updated server verb that locks remotely.
295
 
                repo_lock_token = response[10] or None
296
 
                remote_repo.lock_write(repo_lock_token, _skip_rpc=True)
297
 
                if repo_lock_token:
298
 
                    remote_repo.dont_leave_lock_in_place()
299
 
            else:
300
 
                remote_repo.lock_write()
301
 
            policy = _mod_bzrdir.UseExistingRepository(remote_repo, final_stack,
302
 
                final_stack_pwd, require_stacking)
303
 
            policy.acquire_repository()
304
 
        else:
305
 
            remote_repo = None
306
 
            policy = None
307
 
        bzrdir._format.set_branch_format(self.get_branch_format())
308
 
        if require_stacking:
309
 
            # The repo has already been created, but we need to make sure that
310
 
            # we'll make a stackable branch.
311
 
            bzrdir._format.require_stacking(_skip_repo=True)
312
 
        return remote_repo, bzrdir, require_stacking, policy
313
 
 
314
 
    def _open(self, transport):
315
 
        return RemoteBzrDir(transport, self)
316
 
 
317
 
    def __eq__(self, other):
318
 
        if not isinstance(other, RemoteBzrDirFormat):
319
 
            return False
320
 
        return self.get_format_description() == other.get_format_description()
321
 
 
322
 
    def __return_repository_format(self):
323
 
        # Always return a RemoteRepositoryFormat object, but if a specific bzr
324
 
        # repository format has been asked for, tell the RemoteRepositoryFormat
325
 
        # that it should use that for init() etc.
326
 
        result = RemoteRepositoryFormat()
327
 
        custom_format = getattr(self, '_repository_format', None)
328
 
        if custom_format:
329
 
            if isinstance(custom_format, RemoteRepositoryFormat):
330
 
                return custom_format
331
 
            else:
332
 
                # We will use the custom format to create repositories over the
333
 
                # wire; expose its details like rich_root_data for code to
334
 
                # query
335
 
                result._custom_format = custom_format
336
 
        return result
337
 
 
338
 
    def get_branch_format(self):
339
 
        result = _mod_bzrdir.BzrDirMetaFormat1.get_branch_format(self)
340
 
        if not isinstance(result, RemoteBranchFormat):
341
 
            new_result = RemoteBranchFormat()
342
 
            new_result._custom_format = result
343
 
            # cache the result
344
 
            self.set_branch_format(new_result)
345
 
            result = new_result
346
 
        return result
347
 
 
348
 
    repository_format = property(__return_repository_format,
349
 
        _mod_bzrdir.BzrDirMetaFormat1._set_repository_format) #.im_func)
350
 
 
351
 
 
352
 
class RemoteControlStore(_mod_config.IniFileStore):
353
 
    """Control store which attempts to use HPSS calls to retrieve control store.
354
 
 
355
 
    Note that this is specific to bzr-based formats.
356
 
    """
357
 
 
358
 
    def __init__(self, bzrdir):
359
 
        super(RemoteControlStore, self).__init__()
360
 
        self.bzrdir = bzrdir
361
 
        self._real_store = None
362
 
 
363
 
    def lock_write(self, token=None):
364
 
        self._ensure_real()
365
 
        return self._real_store.lock_write(token)
366
 
 
367
 
    def unlock(self):
368
 
        self._ensure_real()
369
 
        return self._real_store.unlock()
370
 
 
371
 
    @needs_write_lock
372
 
    def save(self):
373
 
        # We need to be able to override the undecorated implementation
374
 
        self.save_without_locking()
375
 
 
376
 
    def save_without_locking(self):
377
 
        super(RemoteControlStore, self).save()
378
 
 
379
 
    def _ensure_real(self):
380
 
        self.bzrdir._ensure_real()
381
 
        if self._real_store is None:
382
 
            self._real_store = _mod_config.ControlStore(self.bzrdir)
383
 
 
384
 
    def external_url(self):
385
 
        return self.bzrdir.user_url
386
 
 
387
 
    def _load_content(self):
388
 
        medium = self.bzrdir._client._medium
389
 
        path = self.bzrdir._path_for_remote_call(self.bzrdir._client)
390
 
        try:
391
 
            response, handler = self.bzrdir._call_expecting_body(
392
 
                'BzrDir.get_config_file', path)
393
 
        except errors.UnknownSmartMethod:
394
 
            self._ensure_real()
395
 
            return self._real_store._load_content()
396
 
        if len(response) and response[0] != 'ok':
397
 
            raise errors.UnexpectedSmartServerResponse(response)
398
 
        return handler.read_body_bytes()
399
 
 
400
 
    def _save_content(self, content):
401
 
        # FIXME JRV 2011-11-22: Ideally this should use a
402
 
        # HPSS call too, but at the moment it is not possible
403
 
        # to write lock control directories.
404
 
        self._ensure_real()
405
 
        return self._real_store._save_content(content)
406
 
 
407
 
 
408
 
class RemoteBzrDir(_mod_bzrdir.BzrDir, _RpcHelper):
409
 
    """Control directory on a remote server, accessed via bzr:// or similar."""
410
 
 
411
 
    def __init__(self, transport, format, _client=None, _force_probe=False):
412
 
        """Construct a RemoteBzrDir.
413
 
 
414
 
        :param _client: Private parameter for testing. Disables probing and the
415
 
            use of a real bzrdir.
416
 
        """
417
 
        _mod_bzrdir.BzrDir.__init__(self, transport, format)
418
 
        # this object holds a delegated bzrdir that uses file-level operations
419
 
        # to talk to the other side
420
 
        self._real_bzrdir = None
421
 
        self._has_working_tree = None
422
 
        # 1-shot cache for the call pattern 'create_branch; open_branch' - see
423
 
        # create_branch for details.
424
 
        self._next_open_branch_result = None
425
 
 
426
 
        if _client is None:
427
 
            medium = transport.get_smart_medium()
428
 
            self._client = client._SmartClient(medium)
429
 
        else:
430
 
            self._client = _client
431
 
            if not _force_probe:
432
 
                return
433
 
 
434
 
        self._probe_bzrdir()
435
 
 
436
 
    def __repr__(self):
437
 
        return '%s(%r)' % (self.__class__.__name__, self._client)
438
 
 
439
 
    def _probe_bzrdir(self):
440
 
        medium = self._client._medium
441
 
        path = self._path_for_remote_call(self._client)
442
 
        if medium._is_remote_before((2, 1)):
443
 
            self._rpc_open(path)
444
 
            return
445
 
        try:
446
 
            self._rpc_open_2_1(path)
447
 
            return
448
 
        except errors.UnknownSmartMethod:
449
 
            medium._remember_remote_is_before((2, 1))
450
 
            self._rpc_open(path)
451
 
 
452
 
    def _rpc_open_2_1(self, path):
453
 
        response = self._call('BzrDir.open_2.1', path)
454
 
        if response == ('no',):
455
 
            raise errors.NotBranchError(path=self.root_transport.base)
456
 
        elif response[0] == 'yes':
457
 
            if response[1] == 'yes':
458
 
                self._has_working_tree = True
459
 
            elif response[1] == 'no':
460
 
                self._has_working_tree = False
461
 
            else:
462
 
                raise errors.UnexpectedSmartServerResponse(response)
463
 
        else:
464
 
            raise errors.UnexpectedSmartServerResponse(response)
465
 
 
466
 
    def _rpc_open(self, path):
467
 
        response = self._call('BzrDir.open', path)
468
 
        if response not in [('yes',), ('no',)]:
469
 
            raise errors.UnexpectedSmartServerResponse(response)
470
 
        if response == ('no',):
471
 
            raise errors.NotBranchError(path=self.root_transport.base)
472
 
 
473
 
    def _ensure_real(self):
474
 
        """Ensure that there is a _real_bzrdir set.
475
 
 
476
 
        Used before calls to self._real_bzrdir.
477
 
        """
478
 
        if not self._real_bzrdir:
479
 
            if 'hpssvfs' in debug.debug_flags:
480
 
                import traceback
481
 
                warning('VFS BzrDir access triggered\n%s',
482
 
                    ''.join(traceback.format_stack()))
483
 
            self._real_bzrdir = _mod_bzrdir.BzrDir.open_from_transport(
484
 
                self.root_transport, probers=[_mod_bzrdir.BzrProber])
485
 
            self._format._network_name = \
486
 
                self._real_bzrdir._format.network_name()
487
 
 
488
 
    def _translate_error(self, err, **context):
489
 
        _translate_error(err, bzrdir=self, **context)
490
 
 
491
 
    def break_lock(self):
492
 
        # Prevent aliasing problems in the next_open_branch_result cache.
493
 
        # See create_branch for rationale.
494
 
        self._next_open_branch_result = None
495
 
        return _mod_bzrdir.BzrDir.break_lock(self)
496
 
 
497
 
    def _vfs_checkout_metadir(self):
498
 
        self._ensure_real()
499
 
        return self._real_bzrdir.checkout_metadir()
500
 
 
501
 
    def checkout_metadir(self):
502
 
        """Retrieve the controldir format to use for checkouts of this one.
503
 
        """
504
 
        medium = self._client._medium
505
 
        if medium._is_remote_before((2, 5)):
506
 
            return self._vfs_checkout_metadir()
507
 
        path = self._path_for_remote_call(self._client)
508
 
        try:
509
 
            response = self._client.call('BzrDir.checkout_metadir',
510
 
                path)
511
 
        except errors.UnknownSmartMethod:
512
 
            medium._remember_remote_is_before((2, 5))
513
 
            return self._vfs_checkout_metadir()
514
 
        if len(response) != 3:
515
 
            raise errors.UnexpectedSmartServerResponse(response)
516
 
        control_name, repo_name, branch_name = response
517
 
        try:
518
 
            format = controldir.network_format_registry.get(control_name)
519
 
        except KeyError:
520
 
            raise errors.UnknownFormatError(kind='control',
521
 
                format=control_name)
522
 
        if repo_name:
523
 
            try:
524
 
                repo_format = _mod_repository.network_format_registry.get(
525
 
                    repo_name)
526
 
            except KeyError:
527
 
                raise errors.UnknownFormatError(kind='repository',
528
 
                    format=repo_name)
529
 
            format.repository_format = repo_format
530
 
        if branch_name:
531
 
            try:
532
 
                format.set_branch_format(
533
 
                    branch.network_format_registry.get(branch_name))
534
 
            except KeyError:
535
 
                raise errors.UnknownFormatError(kind='branch',
536
 
                    format=branch_name)
537
 
        return format
538
 
 
539
 
    def _vfs_cloning_metadir(self, require_stacking=False):
540
 
        self._ensure_real()
541
 
        return self._real_bzrdir.cloning_metadir(
542
 
            require_stacking=require_stacking)
543
 
 
544
 
    def cloning_metadir(self, require_stacking=False):
545
 
        medium = self._client._medium
546
 
        if medium._is_remote_before((1, 13)):
547
 
            return self._vfs_cloning_metadir(require_stacking=require_stacking)
548
 
        verb = 'BzrDir.cloning_metadir'
549
 
        if require_stacking:
550
 
            stacking = 'True'
551
 
        else:
552
 
            stacking = 'False'
553
 
        path = self._path_for_remote_call(self._client)
554
 
        try:
555
 
            response = self._call(verb, path, stacking)
556
 
        except errors.UnknownSmartMethod:
557
 
            medium._remember_remote_is_before((1, 13))
558
 
            return self._vfs_cloning_metadir(require_stacking=require_stacking)
559
 
        except errors.UnknownErrorFromSmartServer, err:
560
 
            if err.error_tuple != ('BranchReference',):
561
 
                raise
562
 
            # We need to resolve the branch reference to determine the
563
 
            # cloning_metadir.  This causes unnecessary RPCs to open the
564
 
            # referenced branch (and bzrdir, etc) but only when the caller
565
 
            # didn't already resolve the branch reference.
566
 
            referenced_branch = self.open_branch()
567
 
            return referenced_branch.bzrdir.cloning_metadir()
568
 
        if len(response) != 3:
569
 
            raise errors.UnexpectedSmartServerResponse(response)
570
 
        control_name, repo_name, branch_info = response
571
 
        if len(branch_info) != 2:
572
 
            raise errors.UnexpectedSmartServerResponse(response)
573
 
        branch_ref, branch_name = branch_info
574
 
        try:
575
 
            format = controldir.network_format_registry.get(control_name)
576
 
        except KeyError:
577
 
            raise errors.UnknownFormatError(kind='control', format=control_name)
578
 
 
579
 
        if repo_name:
580
 
            try:
581
 
                format.repository_format = _mod_repository.network_format_registry.get(
582
 
                    repo_name)
583
 
            except KeyError:
584
 
                raise errors.UnknownFormatError(kind='repository',
585
 
                    format=repo_name)
586
 
        if branch_ref == 'ref':
587
 
            # XXX: we need possible_transports here to avoid reopening the
588
 
            # connection to the referenced location
589
 
            ref_bzrdir = _mod_bzrdir.BzrDir.open(branch_name)
590
 
            branch_format = ref_bzrdir.cloning_metadir().get_branch_format()
591
 
            format.set_branch_format(branch_format)
592
 
        elif branch_ref == 'branch':
593
 
            if branch_name:
594
 
                try:
595
 
                    branch_format = branch.network_format_registry.get(
596
 
                        branch_name)
597
 
                except KeyError:
598
 
                    raise errors.UnknownFormatError(kind='branch',
599
 
                        format=branch_name)
600
 
                format.set_branch_format(branch_format)
601
 
        else:
602
 
            raise errors.UnexpectedSmartServerResponse(response)
603
 
        return format
604
 
 
605
 
    def create_repository(self, shared=False):
606
 
        # as per meta1 formats - just delegate to the format object which may
607
 
        # be parameterised.
608
 
        result = self._format.repository_format.initialize(self, shared)
609
 
        if not isinstance(result, RemoteRepository):
610
 
            return self.open_repository()
611
 
        else:
612
 
            return result
613
 
 
614
 
    def destroy_repository(self):
615
 
        """See BzrDir.destroy_repository"""
616
 
        path = self._path_for_remote_call(self._client)
617
 
        try:
618
 
            response = self._call('BzrDir.destroy_repository', path)
619
 
        except errors.UnknownSmartMethod:
620
 
            self._ensure_real()
621
 
            self._real_bzrdir.destroy_repository()
622
 
            return
623
 
        if response[0] != 'ok':
624
 
            raise SmartProtocolError('unexpected response code %s' % (response,))
625
 
 
626
 
    def create_branch(self, name=None, repository=None,
627
 
                      append_revisions_only=None):
628
 
        # as per meta1 formats - just delegate to the format object which may
629
 
        # be parameterised.
630
 
        real_branch = self._format.get_branch_format().initialize(self,
631
 
            name=name, repository=repository,
632
 
            append_revisions_only=append_revisions_only)
633
 
        if not isinstance(real_branch, RemoteBranch):
634
 
            if not isinstance(repository, RemoteRepository):
635
 
                raise AssertionError(
636
 
                    'need a RemoteRepository to use with RemoteBranch, got %r'
637
 
                    % (repository,))
638
 
            result = RemoteBranch(self, repository, real_branch, name=name)
639
 
        else:
640
 
            result = real_branch
641
 
        # BzrDir.clone_on_transport() uses the result of create_branch but does
642
 
        # not return it to its callers; we save approximately 8% of our round
643
 
        # trips by handing the branch we created back to the first caller to
644
 
        # open_branch rather than probing anew. Long term we need a API in
645
 
        # bzrdir that doesn't discard result objects (like result_branch).
646
 
        # RBC 20090225
647
 
        self._next_open_branch_result = result
648
 
        return result
649
 
 
650
 
    def destroy_branch(self, name=None):
651
 
        """See BzrDir.destroy_branch"""
652
 
        path = self._path_for_remote_call(self._client)
653
 
        try:
654
 
            if name is not None:
655
 
                args = (name, )
656
 
            else:
657
 
                args = ()
658
 
            response = self._call('BzrDir.destroy_branch', path, *args)
659
 
        except errors.UnknownSmartMethod:
660
 
            self._ensure_real()
661
 
            self._real_bzrdir.destroy_branch(name=name)
662
 
            self._next_open_branch_result = None
663
 
            return
664
 
        self._next_open_branch_result = None
665
 
        if response[0] != 'ok':
666
 
            raise SmartProtocolError('unexpected response code %s' % (response,))
667
 
 
668
 
    def create_workingtree(self, revision_id=None, from_branch=None,
669
 
        accelerator_tree=None, hardlink=False):
670
 
        raise errors.NotLocalUrl(self.transport.base)
671
 
 
672
 
    def find_branch_format(self, name=None):
673
 
        """Find the branch 'format' for this bzrdir.
674
 
 
675
 
        This might be a synthetic object for e.g. RemoteBranch and SVN.
676
 
        """
677
 
        b = self.open_branch(name=name)
678
 
        return b._format
679
 
 
680
 
    def get_branch_reference(self, name=None):
681
 
        """See BzrDir.get_branch_reference()."""
682
 
        if name is not None:
683
 
            # XXX JRV20100304: Support opening colocated branches
684
 
            raise errors.NoColocatedBranchSupport(self)
685
 
        response = self._get_branch_reference()
686
 
        if response[0] == 'ref':
687
 
            return response[1]
688
 
        else:
689
 
            return None
690
 
 
691
 
    def _get_branch_reference(self):
692
 
        path = self._path_for_remote_call(self._client)
693
 
        medium = self._client._medium
694
 
        candidate_calls = [
695
 
            ('BzrDir.open_branchV3', (2, 1)),
696
 
            ('BzrDir.open_branchV2', (1, 13)),
697
 
            ('BzrDir.open_branch', None),
698
 
            ]
699
 
        for verb, required_version in candidate_calls:
700
 
            if required_version and medium._is_remote_before(required_version):
701
 
                continue
702
 
            try:
703
 
                response = self._call(verb, path)
704
 
            except errors.UnknownSmartMethod:
705
 
                if required_version is None:
706
 
                    raise
707
 
                medium._remember_remote_is_before(required_version)
708
 
            else:
709
 
                break
710
 
        if verb == 'BzrDir.open_branch':
711
 
            if response[0] != 'ok':
712
 
                raise errors.UnexpectedSmartServerResponse(response)
713
 
            if response[1] != '':
714
 
                return ('ref', response[1])
715
 
            else:
716
 
                return ('branch', '')
717
 
        if response[0] not in ('ref', 'branch'):
718
 
            raise errors.UnexpectedSmartServerResponse(response)
719
 
        return response
720
 
 
721
 
    def _get_tree_branch(self, name=None):
722
 
        """See BzrDir._get_tree_branch()."""
723
 
        return None, self.open_branch(name=name)
724
 
 
725
 
    def open_branch(self, name=None, unsupported=False,
726
 
                    ignore_fallbacks=False, possible_transports=None):
727
 
        if unsupported:
728
 
            raise NotImplementedError('unsupported flag support not implemented yet.')
729
 
        if self._next_open_branch_result is not None:
730
 
            # See create_branch for details.
731
 
            result = self._next_open_branch_result
732
 
            self._next_open_branch_result = None
733
 
            return result
734
 
        response = self._get_branch_reference()
735
 
        if response[0] == 'ref':
736
 
            # a branch reference, use the existing BranchReference logic.
737
 
            format = BranchReferenceFormat()
738
 
            return format.open(self, name=name, _found=True,
739
 
                location=response[1], ignore_fallbacks=ignore_fallbacks,
740
 
                possible_transports=possible_transports)
741
 
        branch_format_name = response[1]
742
 
        if not branch_format_name:
743
 
            branch_format_name = None
744
 
        format = RemoteBranchFormat(network_name=branch_format_name)
745
 
        return RemoteBranch(self, self.find_repository(), format=format,
746
 
            setup_stacking=not ignore_fallbacks, name=name,
747
 
            possible_transports=possible_transports)
748
 
 
749
 
    def _open_repo_v1(self, path):
750
 
        verb = 'BzrDir.find_repository'
751
 
        response = self._call(verb, path)
752
 
        if response[0] != 'ok':
753
 
            raise errors.UnexpectedSmartServerResponse(response)
754
 
        # servers that only support the v1 method don't support external
755
 
        # references either.
756
 
        self._ensure_real()
757
 
        repo = self._real_bzrdir.open_repository()
758
 
        response = response + ('no', repo._format.network_name())
759
 
        return response, repo
760
 
 
761
 
    def _open_repo_v2(self, path):
762
 
        verb = 'BzrDir.find_repositoryV2'
763
 
        response = self._call(verb, path)
764
 
        if response[0] != 'ok':
765
 
            raise errors.UnexpectedSmartServerResponse(response)
766
 
        self._ensure_real()
767
 
        repo = self._real_bzrdir.open_repository()
768
 
        response = response + (repo._format.network_name(),)
769
 
        return response, repo
770
 
 
771
 
    def _open_repo_v3(self, path):
772
 
        verb = 'BzrDir.find_repositoryV3'
773
 
        medium = self._client._medium
774
 
        if medium._is_remote_before((1, 13)):
775
 
            raise errors.UnknownSmartMethod(verb)
776
 
        try:
777
 
            response = self._call(verb, path)
778
 
        except errors.UnknownSmartMethod:
779
 
            medium._remember_remote_is_before((1, 13))
780
 
            raise
781
 
        if response[0] != 'ok':
782
 
            raise errors.UnexpectedSmartServerResponse(response)
783
 
        return response, None
784
 
 
785
 
    def open_repository(self):
786
 
        path = self._path_for_remote_call(self._client)
787
 
        response = None
788
 
        for probe in [self._open_repo_v3, self._open_repo_v2,
789
 
            self._open_repo_v1]:
790
 
            try:
791
 
                response, real_repo = probe(path)
792
 
                break
793
 
            except errors.UnknownSmartMethod:
794
 
                pass
795
 
        if response is None:
796
 
            raise errors.UnknownSmartMethod('BzrDir.find_repository{3,2,}')
797
 
        if response[0] != 'ok':
798
 
            raise errors.UnexpectedSmartServerResponse(response)
799
 
        if len(response) != 6:
800
 
            raise SmartProtocolError('incorrect response length %s' % (response,))
801
 
        if response[1] == '':
802
 
            # repo is at this dir.
803
 
            format = response_tuple_to_repo_format(response[2:])
804
 
            # Used to support creating a real format instance when needed.
805
 
            format._creating_bzrdir = self
806
 
            remote_repo = RemoteRepository(self, format)
807
 
            format._creating_repo = remote_repo
808
 
            if real_repo is not None:
809
 
                remote_repo._set_real_repository(real_repo)
810
 
            return remote_repo
811
 
        else:
812
 
            raise errors.NoRepositoryPresent(self)
813
 
 
814
 
    def has_workingtree(self):
815
 
        if self._has_working_tree is None:
816
 
            path = self._path_for_remote_call(self._client)
817
 
            try:
818
 
                response = self._call('BzrDir.has_workingtree', path)
819
 
            except errors.UnknownSmartMethod:
820
 
                self._ensure_real()
821
 
                self._has_working_tree = self._real_bzrdir.has_workingtree()
822
 
            else:
823
 
                if response[0] not in ('yes', 'no'):
824
 
                    raise SmartProtocolError('unexpected response code %s' % (response,))
825
 
                self._has_working_tree = (response[0] == 'yes')
826
 
        return self._has_working_tree
827
 
 
828
 
    def open_workingtree(self, recommend_upgrade=True):
829
 
        if self.has_workingtree():
830
 
            raise errors.NotLocalUrl(self.root_transport)
831
 
        else:
832
 
            raise errors.NoWorkingTree(self.root_transport.base)
833
 
 
834
 
    def _path_for_remote_call(self, client):
835
 
        """Return the path to be used for this bzrdir in a remote call."""
836
 
        return urlutils.split_segment_parameters_raw(
837
 
            client.remote_path_from_transport(self.root_transport))[0]
838
 
 
839
 
    def get_branch_transport(self, branch_format, name=None):
840
 
        self._ensure_real()
841
 
        return self._real_bzrdir.get_branch_transport(branch_format, name=name)
842
 
 
843
 
    def get_repository_transport(self, repository_format):
844
 
        self._ensure_real()
845
 
        return self._real_bzrdir.get_repository_transport(repository_format)
846
 
 
847
 
    def get_workingtree_transport(self, workingtree_format):
848
 
        self._ensure_real()
849
 
        return self._real_bzrdir.get_workingtree_transport(workingtree_format)
850
 
 
851
 
    def can_convert_format(self):
852
 
        """Upgrading of remote bzrdirs is not supported yet."""
853
 
        return False
854
 
 
855
 
    def needs_format_conversion(self, format):
856
 
        """Upgrading of remote bzrdirs is not supported yet."""
857
 
        return False
858
 
 
859
 
    def _get_config(self):
860
 
        return RemoteBzrDirConfig(self)
861
 
 
862
 
    def _get_config_store(self):
863
 
        return RemoteControlStore(self)
864
 
 
865
 
 
866
 
class RemoteRepositoryFormat(vf_repository.VersionedFileRepositoryFormat):
867
 
    """Format for repositories accessed over a _SmartClient.
868
 
 
869
 
    Instances of this repository are represented by RemoteRepository
870
 
    instances.
871
 
 
872
 
    The RemoteRepositoryFormat is parameterized during construction
873
 
    to reflect the capabilities of the real, remote format. Specifically
874
 
    the attributes rich_root_data and supports_tree_reference are set
875
 
    on a per instance basis, and are not set (and should not be) at
876
 
    the class level.
877
 
 
878
 
    :ivar _custom_format: If set, a specific concrete repository format that
879
 
        will be used when initializing a repository with this
880
 
        RemoteRepositoryFormat.
881
 
    :ivar _creating_repo: If set, the repository object that this
882
 
        RemoteRepositoryFormat was created for: it can be called into
883
 
        to obtain data like the network name.
884
 
    """
885
 
 
886
 
    _matchingbzrdir = RemoteBzrDirFormat()
887
 
    supports_full_versioned_files = True
888
 
    supports_leaving_lock = True
889
 
 
890
 
    def __init__(self):
891
 
        _mod_repository.RepositoryFormat.__init__(self)
892
 
        self._custom_format = None
893
 
        self._network_name = None
894
 
        self._creating_bzrdir = None
895
 
        self._revision_graph_can_have_wrong_parents = None
896
 
        self._supports_chks = None
897
 
        self._supports_external_lookups = None
898
 
        self._supports_tree_reference = None
899
 
        self._supports_funky_characters = None
900
 
        self._supports_nesting_repositories = None
901
 
        self._rich_root_data = None
902
 
 
903
 
    def __repr__(self):
904
 
        return "%s(_network_name=%r)" % (self.__class__.__name__,
905
 
            self._network_name)
906
 
 
907
 
    @property
908
 
    def fast_deltas(self):
909
 
        self._ensure_real()
910
 
        return self._custom_format.fast_deltas
911
 
 
912
 
    @property
913
 
    def rich_root_data(self):
914
 
        if self._rich_root_data is None:
915
 
            self._ensure_real()
916
 
            self._rich_root_data = self._custom_format.rich_root_data
917
 
        return self._rich_root_data
918
 
 
919
 
    @property
920
 
    def supports_chks(self):
921
 
        if self._supports_chks is None:
922
 
            self._ensure_real()
923
 
            self._supports_chks = self._custom_format.supports_chks
924
 
        return self._supports_chks
925
 
 
926
 
    @property
927
 
    def supports_external_lookups(self):
928
 
        if self._supports_external_lookups is None:
929
 
            self._ensure_real()
930
 
            self._supports_external_lookups = \
931
 
                self._custom_format.supports_external_lookups
932
 
        return self._supports_external_lookups
933
 
 
934
 
    @property
935
 
    def supports_funky_characters(self):
936
 
        if self._supports_funky_characters is None:
937
 
            self._ensure_real()
938
 
            self._supports_funky_characters = \
939
 
                self._custom_format.supports_funky_characters
940
 
        return self._supports_funky_characters
941
 
 
942
 
    @property
943
 
    def supports_nesting_repositories(self):
944
 
        if self._supports_nesting_repositories is None:
945
 
            self._ensure_real()
946
 
            self._supports_nesting_repositories = \
947
 
                self._custom_format.supports_nesting_repositories
948
 
        return self._supports_nesting_repositories
949
 
 
950
 
    @property
951
 
    def supports_tree_reference(self):
952
 
        if self._supports_tree_reference is None:
953
 
            self._ensure_real()
954
 
            self._supports_tree_reference = \
955
 
                self._custom_format.supports_tree_reference
956
 
        return self._supports_tree_reference
957
 
 
958
 
    @property
959
 
    def revision_graph_can_have_wrong_parents(self):
960
 
        if self._revision_graph_can_have_wrong_parents is None:
961
 
            self._ensure_real()
962
 
            self._revision_graph_can_have_wrong_parents = \
963
 
                self._custom_format.revision_graph_can_have_wrong_parents
964
 
        return self._revision_graph_can_have_wrong_parents
965
 
 
966
 
    def _vfs_initialize(self, a_bzrdir, shared):
967
 
        """Helper for common code in initialize."""
968
 
        if self._custom_format:
969
 
            # Custom format requested
970
 
            result = self._custom_format.initialize(a_bzrdir, shared=shared)
971
 
        elif self._creating_bzrdir is not None:
972
 
            # Use the format that the repository we were created to back
973
 
            # has.
974
 
            prior_repo = self._creating_bzrdir.open_repository()
975
 
            prior_repo._ensure_real()
976
 
            result = prior_repo._real_repository._format.initialize(
977
 
                a_bzrdir, shared=shared)
978
 
        else:
979
 
            # assume that a_bzr is a RemoteBzrDir but the smart server didn't
980
 
            # support remote initialization.
981
 
            # We delegate to a real object at this point (as RemoteBzrDir
982
 
            # delegate to the repository format which would lead to infinite
983
 
            # recursion if we just called a_bzrdir.create_repository.
984
 
            a_bzrdir._ensure_real()
985
 
            result = a_bzrdir._real_bzrdir.create_repository(shared=shared)
986
 
        if not isinstance(result, RemoteRepository):
987
 
            return self.open(a_bzrdir)
988
 
        else:
989
 
            return result
990
 
 
991
 
    def initialize(self, a_bzrdir, shared=False):
992
 
        # Being asked to create on a non RemoteBzrDir:
993
 
        if not isinstance(a_bzrdir, RemoteBzrDir):
994
 
            return self._vfs_initialize(a_bzrdir, shared)
995
 
        medium = a_bzrdir._client._medium
996
 
        if medium._is_remote_before((1, 13)):
997
 
            return self._vfs_initialize(a_bzrdir, shared)
998
 
        # Creating on a remote bzr dir.
999
 
        # 1) get the network name to use.
1000
 
        if self._custom_format:
1001
 
            network_name = self._custom_format.network_name()
1002
 
        elif self._network_name:
1003
 
            network_name = self._network_name
1004
 
        else:
1005
 
            # Select the current bzrlib default and ask for that.
1006
 
            reference_bzrdir_format = _mod_bzrdir.format_registry.get('default')()
1007
 
            reference_format = reference_bzrdir_format.repository_format
1008
 
            network_name = reference_format.network_name()
1009
 
        # 2) try direct creation via RPC
1010
 
        path = a_bzrdir._path_for_remote_call(a_bzrdir._client)
1011
 
        verb = 'BzrDir.create_repository'
1012
 
        if shared:
1013
 
            shared_str = 'True'
1014
 
        else:
1015
 
            shared_str = 'False'
1016
 
        try:
1017
 
            response = a_bzrdir._call(verb, path, network_name, shared_str)
1018
 
        except errors.UnknownSmartMethod:
1019
 
            # Fallback - use vfs methods
1020
 
            medium._remember_remote_is_before((1, 13))
1021
 
            return self._vfs_initialize(a_bzrdir, shared)
1022
 
        else:
1023
 
            # Turn the response into a RemoteRepository object.
1024
 
            format = response_tuple_to_repo_format(response[1:])
1025
 
            # Used to support creating a real format instance when needed.
1026
 
            format._creating_bzrdir = a_bzrdir
1027
 
            remote_repo = RemoteRepository(a_bzrdir, format)
1028
 
            format._creating_repo = remote_repo
1029
 
            return remote_repo
1030
 
 
1031
 
    def open(self, a_bzrdir):
1032
 
        if not isinstance(a_bzrdir, RemoteBzrDir):
1033
 
            raise AssertionError('%r is not a RemoteBzrDir' % (a_bzrdir,))
1034
 
        return a_bzrdir.open_repository()
1035
 
 
1036
 
    def _ensure_real(self):
1037
 
        if self._custom_format is None:
1038
 
            try:
1039
 
                self._custom_format = _mod_repository.network_format_registry.get(
1040
 
                    self._network_name)
1041
 
            except KeyError:
1042
 
                raise errors.UnknownFormatError(kind='repository',
1043
 
                    format=self._network_name)
1044
 
 
1045
 
    @property
1046
 
    def _fetch_order(self):
1047
 
        self._ensure_real()
1048
 
        return self._custom_format._fetch_order
1049
 
 
1050
 
    @property
1051
 
    def _fetch_uses_deltas(self):
1052
 
        self._ensure_real()
1053
 
        return self._custom_format._fetch_uses_deltas
1054
 
 
1055
 
    @property
1056
 
    def _fetch_reconcile(self):
1057
 
        self._ensure_real()
1058
 
        return self._custom_format._fetch_reconcile
1059
 
 
1060
 
    def get_format_description(self):
1061
 
        self._ensure_real()
1062
 
        return 'Remote: ' + self._custom_format.get_format_description()
1063
 
 
1064
 
    def __eq__(self, other):
1065
 
        return self.__class__ is other.__class__
1066
 
 
1067
 
    def network_name(self):
1068
 
        if self._network_name:
1069
 
            return self._network_name
1070
 
        self._creating_repo._ensure_real()
1071
 
        return self._creating_repo._real_repository._format.network_name()
1072
 
 
1073
 
    @property
1074
 
    def pack_compresses(self):
1075
 
        self._ensure_real()
1076
 
        return self._custom_format.pack_compresses
1077
 
 
1078
 
    @property
1079
 
    def _serializer(self):
1080
 
        self._ensure_real()
1081
 
        return self._custom_format._serializer
1082
 
 
1083
 
 
1084
 
class RemoteRepository(_mod_repository.Repository, _RpcHelper,
1085
 
        lock._RelockDebugMixin):
1086
 
    """Repository accessed over rpc.
1087
 
 
1088
 
    For the moment most operations are performed using local transport-backed
1089
 
    Repository objects.
1090
 
    """
1091
 
 
1092
 
    def __init__(self, remote_bzrdir, format, real_repository=None, _client=None):
1093
 
        """Create a RemoteRepository instance.
1094
 
 
1095
 
        :param remote_bzrdir: The bzrdir hosting this repository.
1096
 
        :param format: The RemoteFormat object to use.
1097
 
        :param real_repository: If not None, a local implementation of the
1098
 
            repository logic for the repository, usually accessing the data
1099
 
            via the VFS.
1100
 
        :param _client: Private testing parameter - override the smart client
1101
 
            to be used by the repository.
1102
 
        """
1103
 
        if real_repository:
1104
 
            self._real_repository = real_repository
1105
 
        else:
1106
 
            self._real_repository = None
1107
 
        self.bzrdir = remote_bzrdir
1108
 
        if _client is None:
1109
 
            self._client = remote_bzrdir._client
1110
 
        else:
1111
 
            self._client = _client
1112
 
        self._format = format
1113
 
        self._lock_mode = None
1114
 
        self._lock_token = None
1115
 
        self._write_group_tokens = None
1116
 
        self._lock_count = 0
1117
 
        self._leave_lock = False
1118
 
        # Cache of revision parents; misses are cached during read locks, and
1119
 
        # write locks when no _real_repository has been set.
1120
 
        self._unstacked_provider = graph.CachingParentsProvider(
1121
 
            get_parent_map=self._get_parent_map_rpc)
1122
 
        self._unstacked_provider.disable_cache()
1123
 
        # For tests:
1124
 
        # These depend on the actual remote format, so force them off for
1125
 
        # maximum compatibility. XXX: In future these should depend on the
1126
 
        # remote repository instance, but this is irrelevant until we perform
1127
 
        # reconcile via an RPC call.
1128
 
        self._reconcile_does_inventory_gc = False
1129
 
        self._reconcile_fixes_text_parents = False
1130
 
        self._reconcile_backsup_inventory = False
1131
 
        self.base = self.bzrdir.transport.base
1132
 
        # Additional places to query for data.
1133
 
        self._fallback_repositories = []
1134
 
 
1135
 
    @property
1136
 
    def user_transport(self):
1137
 
        return self.bzrdir.user_transport
1138
 
 
1139
 
    @property
1140
 
    def control_transport(self):
1141
 
        # XXX: Normally you shouldn't directly get at the remote repository
1142
 
        # transport, but I'm not sure it's worth making this method
1143
 
        # optional -- mbp 2010-04-21
1144
 
        return self.bzrdir.get_repository_transport(None)
1145
 
 
1146
 
    def __str__(self):
1147
 
        return "%s(%s)" % (self.__class__.__name__, self.base)
1148
 
 
1149
 
    __repr__ = __str__
1150
 
 
1151
 
    def abort_write_group(self, suppress_errors=False):
1152
 
        """Complete a write group on the decorated repository.
1153
 
 
1154
 
        Smart methods perform operations in a single step so this API
1155
 
        is not really applicable except as a compatibility thunk
1156
 
        for older plugins that don't use e.g. the CommitBuilder
1157
 
        facility.
1158
 
 
1159
 
        :param suppress_errors: see Repository.abort_write_group.
1160
 
        """
1161
 
        if self._real_repository:
1162
 
            self._ensure_real()
1163
 
            return self._real_repository.abort_write_group(
1164
 
                suppress_errors=suppress_errors)
1165
 
        if not self.is_in_write_group():
1166
 
            if suppress_errors:
1167
 
                mutter('(suppressed) not in write group')
1168
 
                return
1169
 
            raise errors.BzrError("not in write group")
1170
 
        path = self.bzrdir._path_for_remote_call(self._client)
1171
 
        try:
1172
 
            response = self._call('Repository.abort_write_group', path,
1173
 
                self._lock_token, self._write_group_tokens)
1174
 
        except Exception, exc:
1175
 
            self._write_group = None
1176
 
            if not suppress_errors:
1177
 
                raise
1178
 
            mutter('abort_write_group failed')
1179
 
            log_exception_quietly()
1180
 
            note(gettext('bzr: ERROR (ignored): %s'), exc)
1181
 
        else:
1182
 
            if response != ('ok', ):
1183
 
                raise errors.UnexpectedSmartServerResponse(response)
1184
 
            self._write_group_tokens = None
1185
 
 
1186
 
    @property
1187
 
    def chk_bytes(self):
1188
 
        """Decorate the real repository for now.
1189
 
 
1190
 
        In the long term a full blown network facility is needed to avoid
1191
 
        creating a real repository object locally.
1192
 
        """
1193
 
        self._ensure_real()
1194
 
        return self._real_repository.chk_bytes
1195
 
 
1196
 
    def commit_write_group(self):
1197
 
        """Complete a write group on the decorated repository.
1198
 
 
1199
 
        Smart methods perform operations in a single step so this API
1200
 
        is not really applicable except as a compatibility thunk
1201
 
        for older plugins that don't use e.g. the CommitBuilder
1202
 
        facility.
1203
 
        """
1204
 
        if self._real_repository:
1205
 
            self._ensure_real()
1206
 
            return self._real_repository.commit_write_group()
1207
 
        if not self.is_in_write_group():
1208
 
            raise errors.BzrError("not in write group")
1209
 
        path = self.bzrdir._path_for_remote_call(self._client)
1210
 
        response = self._call('Repository.commit_write_group', path,
1211
 
            self._lock_token, self._write_group_tokens)
1212
 
        if response != ('ok', ):
1213
 
            raise errors.UnexpectedSmartServerResponse(response)
1214
 
        self._write_group_tokens = None
1215
 
        # Refresh data after writing to the repository.
1216
 
        self.refresh_data()
1217
 
 
1218
 
    def resume_write_group(self, tokens):
1219
 
        if self._real_repository:
1220
 
            return self._real_repository.resume_write_group(tokens)
1221
 
        path = self.bzrdir._path_for_remote_call(self._client)
1222
 
        try:
1223
 
            response = self._call('Repository.check_write_group', path,
1224
 
               self._lock_token, tokens)
1225
 
        except errors.UnknownSmartMethod:
1226
 
            self._ensure_real()
1227
 
            return self._real_repository.resume_write_group(tokens)
1228
 
        if response != ('ok', ):
1229
 
            raise errors.UnexpectedSmartServerResponse(response)
1230
 
        self._write_group_tokens = tokens
1231
 
 
1232
 
    def suspend_write_group(self):
1233
 
        if self._real_repository:
1234
 
            return self._real_repository.suspend_write_group()
1235
 
        ret = self._write_group_tokens or []
1236
 
        self._write_group_tokens = None
1237
 
        return ret
1238
 
 
1239
 
    def get_missing_parent_inventories(self, check_for_missing_texts=True):
1240
 
        self._ensure_real()
1241
 
        return self._real_repository.get_missing_parent_inventories(
1242
 
            check_for_missing_texts=check_for_missing_texts)
1243
 
 
1244
 
    def _get_rev_id_for_revno_vfs(self, revno, known_pair):
1245
 
        self._ensure_real()
1246
 
        return self._real_repository.get_rev_id_for_revno(
1247
 
            revno, known_pair)
1248
 
 
1249
 
    def get_rev_id_for_revno(self, revno, known_pair):
1250
 
        """See Repository.get_rev_id_for_revno."""
1251
 
        path = self.bzrdir._path_for_remote_call(self._client)
1252
 
        try:
1253
 
            if self._client._medium._is_remote_before((1, 17)):
1254
 
                return self._get_rev_id_for_revno_vfs(revno, known_pair)
1255
 
            response = self._call(
1256
 
                'Repository.get_rev_id_for_revno', path, revno, known_pair)
1257
 
        except errors.UnknownSmartMethod:
1258
 
            self._client._medium._remember_remote_is_before((1, 17))
1259
 
            return self._get_rev_id_for_revno_vfs(revno, known_pair)
1260
 
        if response[0] == 'ok':
1261
 
            return True, response[1]
1262
 
        elif response[0] == 'history-incomplete':
1263
 
            known_pair = response[1:3]
1264
 
            for fallback in self._fallback_repositories:
1265
 
                found, result = fallback.get_rev_id_for_revno(revno, known_pair)
1266
 
                if found:
1267
 
                    return True, result
1268
 
                else:
1269
 
                    known_pair = result
1270
 
            # Not found in any fallbacks
1271
 
            return False, known_pair
1272
 
        else:
1273
 
            raise errors.UnexpectedSmartServerResponse(response)
1274
 
 
1275
 
    def _ensure_real(self):
1276
 
        """Ensure that there is a _real_repository set.
1277
 
 
1278
 
        Used before calls to self._real_repository.
1279
 
 
1280
 
        Note that _ensure_real causes many roundtrips to the server which are
1281
 
        not desirable, and prevents the use of smart one-roundtrip RPC's to
1282
 
        perform complex operations (such as accessing parent data, streaming
1283
 
        revisions etc). Adding calls to _ensure_real should only be done when
1284
 
        bringing up new functionality, adding fallbacks for smart methods that
1285
 
        require a fallback path, and never to replace an existing smart method
1286
 
        invocation. If in doubt chat to the bzr network team.
1287
 
        """
1288
 
        if self._real_repository is None:
1289
 
            if 'hpssvfs' in debug.debug_flags:
1290
 
                import traceback
1291
 
                warning('VFS Repository access triggered\n%s',
1292
 
                    ''.join(traceback.format_stack()))
1293
 
            self._unstacked_provider.missing_keys.clear()
1294
 
            self.bzrdir._ensure_real()
1295
 
            self._set_real_repository(
1296
 
                self.bzrdir._real_bzrdir.open_repository())
1297
 
 
1298
 
    def _translate_error(self, err, **context):
1299
 
        self.bzrdir._translate_error(err, repository=self, **context)
1300
 
 
1301
 
    def find_text_key_references(self):
1302
 
        """Find the text key references within the repository.
1303
 
 
1304
 
        :return: A dictionary mapping text keys ((fileid, revision_id) tuples)
1305
 
            to whether they were referred to by the inventory of the
1306
 
            revision_id that they contain. The inventory texts from all present
1307
 
            revision ids are assessed to generate this report.
1308
 
        """
1309
 
        self._ensure_real()
1310
 
        return self._real_repository.find_text_key_references()
1311
 
 
1312
 
    def _generate_text_key_index(self):
1313
 
        """Generate a new text key index for the repository.
1314
 
 
1315
 
        This is an expensive function that will take considerable time to run.
1316
 
 
1317
 
        :return: A dict mapping (file_id, revision_id) tuples to a list of
1318
 
            parents, also (file_id, revision_id) tuples.
1319
 
        """
1320
 
        self._ensure_real()
1321
 
        return self._real_repository._generate_text_key_index()
1322
 
 
1323
 
    def _get_revision_graph(self, revision_id):
1324
 
        """Private method for using with old (< 1.2) servers to fallback."""
1325
 
        if revision_id is None:
1326
 
            revision_id = ''
1327
 
        elif _mod_revision.is_null(revision_id):
1328
 
            return {}
1329
 
 
1330
 
        path = self.bzrdir._path_for_remote_call(self._client)
1331
 
        response = self._call_expecting_body(
1332
 
            'Repository.get_revision_graph', path, revision_id)
1333
 
        response_tuple, response_handler = response
1334
 
        if response_tuple[0] != 'ok':
1335
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
1336
 
        coded = response_handler.read_body_bytes()
1337
 
        if coded == '':
1338
 
            # no revisions in this repository!
1339
 
            return {}
1340
 
        lines = coded.split('\n')
1341
 
        revision_graph = {}
1342
 
        for line in lines:
1343
 
            d = tuple(line.split())
1344
 
            revision_graph[d[0]] = d[1:]
1345
 
 
1346
 
        return revision_graph
1347
 
 
1348
 
    def _get_sink(self):
1349
 
        """See Repository._get_sink()."""
1350
 
        return RemoteStreamSink(self)
1351
 
 
1352
 
    def _get_source(self, to_format):
1353
 
        """Return a source for streaming from this repository."""
1354
 
        return RemoteStreamSource(self, to_format)
1355
 
 
1356
 
    @needs_read_lock
1357
 
    def get_file_graph(self):
1358
 
        return graph.Graph(self.texts)
1359
 
 
1360
 
    @needs_read_lock
1361
 
    def has_revision(self, revision_id):
1362
 
        """True if this repository has a copy of the revision."""
1363
 
        # Copy of bzrlib.repository.Repository.has_revision
1364
 
        return revision_id in self.has_revisions((revision_id,))
1365
 
 
1366
 
    @needs_read_lock
1367
 
    def has_revisions(self, revision_ids):
1368
 
        """Probe to find out the presence of multiple revisions.
1369
 
 
1370
 
        :param revision_ids: An iterable of revision_ids.
1371
 
        :return: A set of the revision_ids that were present.
1372
 
        """
1373
 
        # Copy of bzrlib.repository.Repository.has_revisions
1374
 
        parent_map = self.get_parent_map(revision_ids)
1375
 
        result = set(parent_map)
1376
 
        if _mod_revision.NULL_REVISION in revision_ids:
1377
 
            result.add(_mod_revision.NULL_REVISION)
1378
 
        return result
1379
 
 
1380
 
    def _has_same_fallbacks(self, other_repo):
1381
 
        """Returns true if the repositories have the same fallbacks."""
1382
 
        # XXX: copied from Repository; it should be unified into a base class
1383
 
        # <https://bugs.launchpad.net/bzr/+bug/401622>
1384
 
        my_fb = self._fallback_repositories
1385
 
        other_fb = other_repo._fallback_repositories
1386
 
        if len(my_fb) != len(other_fb):
1387
 
            return False
1388
 
        for f, g in zip(my_fb, other_fb):
1389
 
            if not f.has_same_location(g):
1390
 
                return False
1391
 
        return True
1392
 
 
1393
 
    def has_same_location(self, other):
1394
 
        # TODO: Move to RepositoryBase and unify with the regular Repository
1395
 
        # one; unfortunately the tests rely on slightly different behaviour at
1396
 
        # present -- mbp 20090710
1397
 
        return (self.__class__ is other.__class__ and
1398
 
                self.bzrdir.transport.base == other.bzrdir.transport.base)
1399
 
 
1400
 
    def get_graph(self, other_repository=None):
1401
 
        """Return the graph for this repository format"""
1402
 
        parents_provider = self._make_parents_provider(other_repository)
1403
 
        return graph.Graph(parents_provider)
1404
 
 
1405
 
    @needs_read_lock
1406
 
    def get_known_graph_ancestry(self, revision_ids):
1407
 
        """Return the known graph for a set of revision ids and their ancestors.
1408
 
        """
1409
 
        st = static_tuple.StaticTuple
1410
 
        revision_keys = [st(r_id).intern() for r_id in revision_ids]
1411
 
        known_graph = self.revisions.get_known_graph_ancestry(revision_keys)
1412
 
        return graph.GraphThunkIdsToKeys(known_graph)
1413
 
 
1414
 
    def gather_stats(self, revid=None, committers=None):
1415
 
        """See Repository.gather_stats()."""
1416
 
        path = self.bzrdir._path_for_remote_call(self._client)
1417
 
        # revid can be None to indicate no revisions, not just NULL_REVISION
1418
 
        if revid is None or _mod_revision.is_null(revid):
1419
 
            fmt_revid = ''
1420
 
        else:
1421
 
            fmt_revid = revid
1422
 
        if committers is None or not committers:
1423
 
            fmt_committers = 'no'
1424
 
        else:
1425
 
            fmt_committers = 'yes'
1426
 
        response_tuple, response_handler = self._call_expecting_body(
1427
 
            'Repository.gather_stats', path, fmt_revid, fmt_committers)
1428
 
        if response_tuple[0] != 'ok':
1429
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
1430
 
 
1431
 
        body = response_handler.read_body_bytes()
1432
 
        result = {}
1433
 
        for line in body.split('\n'):
1434
 
            if not line:
1435
 
                continue
1436
 
            key, val_text = line.split(':')
1437
 
            if key in ('revisions', 'size', 'committers'):
1438
 
                result[key] = int(val_text)
1439
 
            elif key in ('firstrev', 'latestrev'):
1440
 
                values = val_text.split(' ')[1:]
1441
 
                result[key] = (float(values[0]), long(values[1]))
1442
 
 
1443
 
        return result
1444
 
 
1445
 
    def find_branches(self, using=False):
1446
 
        """See Repository.find_branches()."""
1447
 
        # should be an API call to the server.
1448
 
        self._ensure_real()
1449
 
        return self._real_repository.find_branches(using=using)
1450
 
 
1451
 
    def get_physical_lock_status(self):
1452
 
        """See Repository.get_physical_lock_status()."""
1453
 
        path = self.bzrdir._path_for_remote_call(self._client)
1454
 
        try:
1455
 
            response = self._call('Repository.get_physical_lock_status', path)
1456
 
        except errors.UnknownSmartMethod:
1457
 
            self._ensure_real()
1458
 
            return self._real_repository.get_physical_lock_status()
1459
 
        if response[0] not in ('yes', 'no'):
1460
 
            raise errors.UnexpectedSmartServerResponse(response)
1461
 
        return (response[0] == 'yes')
1462
 
 
1463
 
    def is_in_write_group(self):
1464
 
        """Return True if there is an open write group.
1465
 
 
1466
 
        write groups are only applicable locally for the smart server..
1467
 
        """
1468
 
        if self._write_group_tokens is not None:
1469
 
            return True
1470
 
        if self._real_repository:
1471
 
            return self._real_repository.is_in_write_group()
1472
 
 
1473
 
    def is_locked(self):
1474
 
        return self._lock_count >= 1
1475
 
 
1476
 
    def is_shared(self):
1477
 
        """See Repository.is_shared()."""
1478
 
        path = self.bzrdir._path_for_remote_call(self._client)
1479
 
        response = self._call('Repository.is_shared', path)
1480
 
        if response[0] not in ('yes', 'no'):
1481
 
            raise SmartProtocolError('unexpected response code %s' % (response,))
1482
 
        return response[0] == 'yes'
1483
 
 
1484
 
    def is_write_locked(self):
1485
 
        return self._lock_mode == 'w'
1486
 
 
1487
 
    def _warn_if_deprecated(self, branch=None):
1488
 
        # If we have a real repository, the check will be done there, if we
1489
 
        # don't the check will be done remotely.
1490
 
        pass
1491
 
 
1492
 
    def lock_read(self):
1493
 
        """Lock the repository for read operations.
1494
 
 
1495
 
        :return: A bzrlib.lock.LogicalLockResult.
1496
 
        """
1497
 
        # wrong eventually - want a local lock cache context
1498
 
        if not self._lock_mode:
1499
 
            self._note_lock('r')
1500
 
            self._lock_mode = 'r'
1501
 
            self._lock_count = 1
1502
 
            self._unstacked_provider.enable_cache(cache_misses=True)
1503
 
            if self._real_repository is not None:
1504
 
                self._real_repository.lock_read()
1505
 
            for repo in self._fallback_repositories:
1506
 
                repo.lock_read()
1507
 
        else:
1508
 
            self._lock_count += 1
1509
 
        return lock.LogicalLockResult(self.unlock)
1510
 
 
1511
 
    def _remote_lock_write(self, token):
1512
 
        path = self.bzrdir._path_for_remote_call(self._client)
1513
 
        if token is None:
1514
 
            token = ''
1515
 
        err_context = {'token': token}
1516
 
        response = self._call('Repository.lock_write', path, token,
1517
 
                              **err_context)
1518
 
        if response[0] == 'ok':
1519
 
            ok, token = response
1520
 
            return token
1521
 
        else:
1522
 
            raise errors.UnexpectedSmartServerResponse(response)
1523
 
 
1524
 
    def lock_write(self, token=None, _skip_rpc=False):
1525
 
        if not self._lock_mode:
1526
 
            self._note_lock('w')
1527
 
            if _skip_rpc:
1528
 
                if self._lock_token is not None:
1529
 
                    if token != self._lock_token:
1530
 
                        raise errors.TokenMismatch(token, self._lock_token)
1531
 
                self._lock_token = token
1532
 
            else:
1533
 
                self._lock_token = self._remote_lock_write(token)
1534
 
            # if self._lock_token is None, then this is something like packs or
1535
 
            # svn where we don't get to lock the repo, or a weave style repository
1536
 
            # where we cannot lock it over the wire and attempts to do so will
1537
 
            # fail.
1538
 
            if self._real_repository is not None:
1539
 
                self._real_repository.lock_write(token=self._lock_token)
1540
 
            if token is not None:
1541
 
                self._leave_lock = True
1542
 
            else:
1543
 
                self._leave_lock = False
1544
 
            self._lock_mode = 'w'
1545
 
            self._lock_count = 1
1546
 
            cache_misses = self._real_repository is None
1547
 
            self._unstacked_provider.enable_cache(cache_misses=cache_misses)
1548
 
            for repo in self._fallback_repositories:
1549
 
                # Writes don't affect fallback repos
1550
 
                repo.lock_read()
1551
 
        elif self._lock_mode == 'r':
1552
 
            raise errors.ReadOnlyError(self)
1553
 
        else:
1554
 
            self._lock_count += 1
1555
 
        return RepositoryWriteLockResult(self.unlock, self._lock_token or None)
1556
 
 
1557
 
    def leave_lock_in_place(self):
1558
 
        if not self._lock_token:
1559
 
            raise NotImplementedError(self.leave_lock_in_place)
1560
 
        self._leave_lock = True
1561
 
 
1562
 
    def dont_leave_lock_in_place(self):
1563
 
        if not self._lock_token:
1564
 
            raise NotImplementedError(self.dont_leave_lock_in_place)
1565
 
        self._leave_lock = False
1566
 
 
1567
 
    def _set_real_repository(self, repository):
1568
 
        """Set the _real_repository for this repository.
1569
 
 
1570
 
        :param repository: The repository to fallback to for non-hpss
1571
 
            implemented operations.
1572
 
        """
1573
 
        if self._real_repository is not None:
1574
 
            # Replacing an already set real repository.
1575
 
            # We cannot do this [currently] if the repository is locked -
1576
 
            # synchronised state might be lost.
1577
 
            if self.is_locked():
1578
 
                raise AssertionError('_real_repository is already set')
1579
 
        if isinstance(repository, RemoteRepository):
1580
 
            raise AssertionError()
1581
 
        self._real_repository = repository
1582
 
        # three code paths happen here:
1583
 
        # 1) old servers, RemoteBranch.open() calls _ensure_real before setting
1584
 
        # up stacking. In this case self._fallback_repositories is [], and the
1585
 
        # real repo is already setup. Preserve the real repo and
1586
 
        # RemoteRepository.add_fallback_repository will avoid adding
1587
 
        # duplicates.
1588
 
        # 2) new servers, RemoteBranch.open() sets up stacking, and when
1589
 
        # ensure_real is triggered from a branch, the real repository to
1590
 
        # set already has a matching list with separate instances, but
1591
 
        # as they are also RemoteRepositories we don't worry about making the
1592
 
        # lists be identical.
1593
 
        # 3) new servers, RemoteRepository.ensure_real is triggered before
1594
 
        # RemoteBranch.ensure real, in this case we get a repo with no fallbacks
1595
 
        # and need to populate it.
1596
 
        if (self._fallback_repositories and
1597
 
            len(self._real_repository._fallback_repositories) !=
1598
 
            len(self._fallback_repositories)):
1599
 
            if len(self._real_repository._fallback_repositories):
1600
 
                raise AssertionError(
1601
 
                    "cannot cleanly remove existing _fallback_repositories")
1602
 
        for fb in self._fallback_repositories:
1603
 
            self._real_repository.add_fallback_repository(fb)
1604
 
        if self._lock_mode == 'w':
1605
 
            # if we are already locked, the real repository must be able to
1606
 
            # acquire the lock with our token.
1607
 
            self._real_repository.lock_write(self._lock_token)
1608
 
        elif self._lock_mode == 'r':
1609
 
            self._real_repository.lock_read()
1610
 
        if self._write_group_tokens is not None:
1611
 
            # if we are already in a write group, resume it
1612
 
            self._real_repository.resume_write_group(self._write_group_tokens)
1613
 
            self._write_group_tokens = None
1614
 
 
1615
 
    def start_write_group(self):
1616
 
        """Start a write group on the decorated repository.
1617
 
 
1618
 
        Smart methods perform operations in a single step so this API
1619
 
        is not really applicable except as a compatibility thunk
1620
 
        for older plugins that don't use e.g. the CommitBuilder
1621
 
        facility.
1622
 
        """
1623
 
        if self._real_repository:
1624
 
            self._ensure_real()
1625
 
            return self._real_repository.start_write_group()
1626
 
        if not self.is_write_locked():
1627
 
            raise errors.NotWriteLocked(self)
1628
 
        if self._write_group_tokens is not None:
1629
 
            raise errors.BzrError('already in a write group')
1630
 
        path = self.bzrdir._path_for_remote_call(self._client)
1631
 
        try:
1632
 
            response = self._call('Repository.start_write_group', path,
1633
 
                self._lock_token)
1634
 
        except (errors.UnknownSmartMethod, errors.UnsuspendableWriteGroup):
1635
 
            self._ensure_real()
1636
 
            return self._real_repository.start_write_group()
1637
 
        if response[0] != 'ok':
1638
 
            raise errors.UnexpectedSmartServerResponse(response)
1639
 
        self._write_group_tokens = response[1]
1640
 
 
1641
 
    def _unlock(self, token):
1642
 
        path = self.bzrdir._path_for_remote_call(self._client)
1643
 
        if not token:
1644
 
            # with no token the remote repository is not persistently locked.
1645
 
            return
1646
 
        err_context = {'token': token}
1647
 
        response = self._call('Repository.unlock', path, token,
1648
 
                              **err_context)
1649
 
        if response == ('ok',):
1650
 
            return
1651
 
        else:
1652
 
            raise errors.UnexpectedSmartServerResponse(response)
1653
 
 
1654
 
    @only_raises(errors.LockNotHeld, errors.LockBroken)
1655
 
    def unlock(self):
1656
 
        if not self._lock_count:
1657
 
            return lock.cant_unlock_not_held(self)
1658
 
        self._lock_count -= 1
1659
 
        if self._lock_count > 0:
1660
 
            return
1661
 
        self._unstacked_provider.disable_cache()
1662
 
        old_mode = self._lock_mode
1663
 
        self._lock_mode = None
1664
 
        try:
1665
 
            # The real repository is responsible at present for raising an
1666
 
            # exception if it's in an unfinished write group.  However, it
1667
 
            # normally will *not* actually remove the lock from disk - that's
1668
 
            # done by the server on receiving the Repository.unlock call.
1669
 
            # This is just to let the _real_repository stay up to date.
1670
 
            if self._real_repository is not None:
1671
 
                self._real_repository.unlock()
1672
 
            elif self._write_group_tokens is not None:
1673
 
                self.abort_write_group()
1674
 
        finally:
1675
 
            # The rpc-level lock should be released even if there was a
1676
 
            # problem releasing the vfs-based lock.
1677
 
            if old_mode == 'w':
1678
 
                # Only write-locked repositories need to make a remote method
1679
 
                # call to perform the unlock.
1680
 
                old_token = self._lock_token
1681
 
                self._lock_token = None
1682
 
                if not self._leave_lock:
1683
 
                    self._unlock(old_token)
1684
 
        # Fallbacks are always 'lock_read()' so we don't pay attention to
1685
 
        # self._leave_lock
1686
 
        for repo in self._fallback_repositories:
1687
 
            repo.unlock()
1688
 
 
1689
 
    def break_lock(self):
1690
 
        # should hand off to the network
1691
 
        path = self.bzrdir._path_for_remote_call(self._client)
1692
 
        try:
1693
 
            response = self._call("Repository.break_lock", path)
1694
 
        except errors.UnknownSmartMethod:
1695
 
            self._ensure_real()
1696
 
            return self._real_repository.break_lock()
1697
 
        if response != ('ok',):
1698
 
            raise errors.UnexpectedSmartServerResponse(response)
1699
 
 
1700
 
    def _get_tarball(self, compression):
1701
 
        """Return a TemporaryFile containing a repository tarball.
1702
 
 
1703
 
        Returns None if the server does not support sending tarballs.
1704
 
        """
1705
 
        import tempfile
1706
 
        path = self.bzrdir._path_for_remote_call(self._client)
1707
 
        try:
1708
 
            response, protocol = self._call_expecting_body(
1709
 
                'Repository.tarball', path, compression)
1710
 
        except errors.UnknownSmartMethod:
1711
 
            protocol.cancel_read_body()
1712
 
            return None
1713
 
        if response[0] == 'ok':
1714
 
            # Extract the tarball and return it
1715
 
            t = tempfile.NamedTemporaryFile()
1716
 
            # TODO: rpc layer should read directly into it...
1717
 
            t.write(protocol.read_body_bytes())
1718
 
            t.seek(0)
1719
 
            return t
1720
 
        raise errors.UnexpectedSmartServerResponse(response)
1721
 
 
1722
 
    @needs_read_lock
1723
 
    def sprout(self, to_bzrdir, revision_id=None):
1724
 
        """Create a descendent repository for new development.
1725
 
 
1726
 
        Unlike clone, this does not copy the settings of the repository.
1727
 
        """
1728
 
        dest_repo = self._create_sprouting_repo(to_bzrdir, shared=False)
1729
 
        dest_repo.fetch(self, revision_id=revision_id)
1730
 
        return dest_repo
1731
 
 
1732
 
    def _create_sprouting_repo(self, a_bzrdir, shared):
1733
 
        if not isinstance(a_bzrdir._format, self.bzrdir._format.__class__):
1734
 
            # use target default format.
1735
 
            dest_repo = a_bzrdir.create_repository()
1736
 
        else:
1737
 
            # Most control formats need the repository to be specifically
1738
 
            # created, but on some old all-in-one formats it's not needed
1739
 
            try:
1740
 
                dest_repo = self._format.initialize(a_bzrdir, shared=shared)
1741
 
            except errors.UninitializableFormat:
1742
 
                dest_repo = a_bzrdir.open_repository()
1743
 
        return dest_repo
1744
 
 
1745
 
    ### These methods are just thin shims to the VFS object for now.
1746
 
 
1747
 
    @needs_read_lock
1748
 
    def revision_tree(self, revision_id):
1749
 
        revision_id = _mod_revision.ensure_null(revision_id)
1750
 
        if revision_id == _mod_revision.NULL_REVISION:
1751
 
            return InventoryRevisionTree(self,
1752
 
                Inventory(root_id=None), _mod_revision.NULL_REVISION)
1753
 
        else:
1754
 
            return list(self.revision_trees([revision_id]))[0]
1755
 
 
1756
 
    def get_serializer_format(self):
1757
 
        path = self.bzrdir._path_for_remote_call(self._client)
1758
 
        try:
1759
 
            response = self._call('VersionedFileRepository.get_serializer_format',
1760
 
                path)
1761
 
        except errors.UnknownSmartMethod:
1762
 
            self._ensure_real()
1763
 
            return self._real_repository.get_serializer_format()
1764
 
        if response[0] != 'ok':
1765
 
            raise errors.UnexpectedSmartServerResponse(response)
1766
 
        return response[1]
1767
 
 
1768
 
    def get_commit_builder(self, branch, parents, config, timestamp=None,
1769
 
                           timezone=None, committer=None, revprops=None,
1770
 
                           revision_id=None, lossy=False):
1771
 
        """Obtain a CommitBuilder for this repository.
1772
 
 
1773
 
        :param branch: Branch to commit to.
1774
 
        :param parents: Revision ids of the parents of the new revision.
1775
 
        :param config: Configuration to use.
1776
 
        :param timestamp: Optional timestamp recorded for commit.
1777
 
        :param timezone: Optional timezone for timestamp.
1778
 
        :param committer: Optional committer to set for commit.
1779
 
        :param revprops: Optional dictionary of revision properties.
1780
 
        :param revision_id: Optional revision id.
1781
 
        :param lossy: Whether to discard data that can not be natively
1782
 
            represented, when pushing to a foreign VCS
1783
 
        """
1784
 
        if self._fallback_repositories and not self._format.supports_chks:
1785
 
            raise errors.BzrError("Cannot commit directly to a stacked branch"
1786
 
                " in pre-2a formats. See "
1787
 
                "https://bugs.launchpad.net/bzr/+bug/375013 for details.")
1788
 
        if self._format.rich_root_data:
1789
 
            commit_builder_kls = vf_repository.VersionedFileRootCommitBuilder
1790
 
        else:
1791
 
            commit_builder_kls = vf_repository.VersionedFileCommitBuilder
1792
 
        result = commit_builder_kls(self, parents, config,
1793
 
            timestamp, timezone, committer, revprops, revision_id,
1794
 
            lossy)
1795
 
        self.start_write_group()
1796
 
        return result
1797
 
 
1798
 
    def add_fallback_repository(self, repository):
1799
 
        """Add a repository to use for looking up data not held locally.
1800
 
 
1801
 
        :param repository: A repository.
1802
 
        """
1803
 
        if not self._format.supports_external_lookups:
1804
 
            raise errors.UnstackableRepositoryFormat(
1805
 
                self._format.network_name(), self.base)
1806
 
        # We need to accumulate additional repositories here, to pass them in
1807
 
        # on various RPC's.
1808
 
        #
1809
 
        # Make the check before we lock: this raises an exception.
1810
 
        self._check_fallback_repository(repository)
1811
 
        if self.is_locked():
1812
 
            # We will call fallback.unlock() when we transition to the unlocked
1813
 
            # state, so always add a lock here. If a caller passes us a locked
1814
 
            # repository, they are responsible for unlocking it later.
1815
 
            repository.lock_read()
1816
 
        self._fallback_repositories.append(repository)
1817
 
        # If self._real_repository was parameterised already (e.g. because a
1818
 
        # _real_branch had its get_stacked_on_url method called), then the
1819
 
        # repository to be added may already be in the _real_repositories list.
1820
 
        if self._real_repository is not None:
1821
 
            fallback_locations = [repo.user_url for repo in
1822
 
                self._real_repository._fallback_repositories]
1823
 
            if repository.user_url not in fallback_locations:
1824
 
                self._real_repository.add_fallback_repository(repository)
1825
 
 
1826
 
    def _check_fallback_repository(self, repository):
1827
 
        """Check that this repository can fallback to repository safely.
1828
 
 
1829
 
        Raise an error if not.
1830
 
 
1831
 
        :param repository: A repository to fallback to.
1832
 
        """
1833
 
        return _mod_repository.InterRepository._assert_same_model(
1834
 
            self, repository)
1835
 
 
1836
 
    def add_inventory(self, revid, inv, parents):
1837
 
        self._ensure_real()
1838
 
        return self._real_repository.add_inventory(revid, inv, parents)
1839
 
 
1840
 
    def add_inventory_by_delta(self, basis_revision_id, delta, new_revision_id,
1841
 
            parents, basis_inv=None, propagate_caches=False):
1842
 
        self._ensure_real()
1843
 
        return self._real_repository.add_inventory_by_delta(basis_revision_id,
1844
 
            delta, new_revision_id, parents, basis_inv=basis_inv,
1845
 
            propagate_caches=propagate_caches)
1846
 
 
1847
 
    def add_revision(self, revision_id, rev, inv=None):
1848
 
        _mod_revision.check_not_reserved_id(revision_id)
1849
 
        key = (revision_id,)
1850
 
        # check inventory present
1851
 
        if not self.inventories.get_parent_map([key]):
1852
 
            if inv is None:
1853
 
                raise errors.WeaveRevisionNotPresent(revision_id,
1854
 
                                                     self.inventories)
1855
 
            else:
1856
 
                # yes, this is not suitable for adding with ghosts.
1857
 
                rev.inventory_sha1 = self.add_inventory(revision_id, inv,
1858
 
                                                        rev.parent_ids)
1859
 
        else:
1860
 
            rev.inventory_sha1 = self.inventories.get_sha1s([key])[key]
1861
 
        self._add_revision(rev)
1862
 
 
1863
 
    def _add_revision(self, rev):
1864
 
        if self._real_repository is not None:
1865
 
            return self._real_repository._add_revision(rev)
1866
 
        text = self._serializer.write_revision_to_string(rev)
1867
 
        key = (rev.revision_id,)
1868
 
        parents = tuple((parent,) for parent in rev.parent_ids)
1869
 
        self._write_group_tokens, missing_keys = self._get_sink().insert_stream(
1870
 
            [('revisions', [FulltextContentFactory(key, parents, None, text)])],
1871
 
            self._format, self._write_group_tokens)
1872
 
 
1873
 
    @needs_read_lock
1874
 
    def get_inventory(self, revision_id):
1875
 
        return list(self.iter_inventories([revision_id]))[0]
1876
 
 
1877
 
    def _iter_inventories_rpc(self, revision_ids, ordering):
1878
 
        if ordering is None:
1879
 
            ordering = 'unordered'
1880
 
        path = self.bzrdir._path_for_remote_call(self._client)
1881
 
        body = "\n".join(revision_ids)
1882
 
        response_tuple, response_handler = (
1883
 
            self._call_with_body_bytes_expecting_body(
1884
 
                "VersionedFileRepository.get_inventories",
1885
 
                (path, ordering), body))
1886
 
        if response_tuple[0] != "ok":
1887
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
1888
 
        deserializer = inventory_delta.InventoryDeltaDeserializer()
1889
 
        byte_stream = response_handler.read_streamed_body()
1890
 
        decoded = smart_repo._byte_stream_to_stream(byte_stream)
1891
 
        if decoded is None:
1892
 
            # no results whatsoever
1893
 
            return
1894
 
        src_format, stream = decoded
1895
 
        if src_format.network_name() != self._format.network_name():
1896
 
            raise AssertionError(
1897
 
                "Mismatched RemoteRepository and stream src %r, %r" % (
1898
 
                src_format.network_name(), self._format.network_name()))
1899
 
        # ignore the src format, it's not really relevant
1900
 
        prev_inv = Inventory(root_id=None,
1901
 
            revision_id=_mod_revision.NULL_REVISION)
1902
 
        # there should be just one substream, with inventory deltas
1903
 
        substream_kind, substream = stream.next()
1904
 
        if substream_kind != "inventory-deltas":
1905
 
            raise AssertionError(
1906
 
                 "Unexpected stream %r received" % substream_kind)
1907
 
        for record in substream:
1908
 
            (parent_id, new_id, versioned_root, tree_references, invdelta) = (
1909
 
                deserializer.parse_text_bytes(record.get_bytes_as("fulltext")))
1910
 
            if parent_id != prev_inv.revision_id:
1911
 
                raise AssertionError("invalid base %r != %r" % (parent_id,
1912
 
                    prev_inv.revision_id))
1913
 
            inv = prev_inv.create_by_apply_delta(invdelta, new_id)
1914
 
            yield inv, inv.revision_id
1915
 
            prev_inv = inv
1916
 
 
1917
 
    def _iter_inventories_vfs(self, revision_ids, ordering=None):
1918
 
        self._ensure_real()
1919
 
        return self._real_repository._iter_inventories(revision_ids, ordering)
1920
 
 
1921
 
    def iter_inventories(self, revision_ids, ordering=None):
1922
 
        """Get many inventories by revision_ids.
1923
 
 
1924
 
        This will buffer some or all of the texts used in constructing the
1925
 
        inventories in memory, but will only parse a single inventory at a
1926
 
        time.
1927
 
 
1928
 
        :param revision_ids: The expected revision ids of the inventories.
1929
 
        :param ordering: optional ordering, e.g. 'topological'.  If not
1930
 
            specified, the order of revision_ids will be preserved (by
1931
 
            buffering if necessary).
1932
 
        :return: An iterator of inventories.
1933
 
        """
1934
 
        if ((None in revision_ids)
1935
 
            or (_mod_revision.NULL_REVISION in revision_ids)):
1936
 
            raise ValueError('cannot get null revision inventory')
1937
 
        for inv, revid in self._iter_inventories(revision_ids, ordering):
1938
 
            if inv is None:
1939
 
                raise errors.NoSuchRevision(self, revid)
1940
 
            yield inv
1941
 
 
1942
 
    def _iter_inventories(self, revision_ids, ordering=None):
1943
 
        if len(revision_ids) == 0:
1944
 
            return
1945
 
        missing = set(revision_ids)
1946
 
        if ordering is None:
1947
 
            order_as_requested = True
1948
 
            invs = {}
1949
 
            order = list(revision_ids)
1950
 
            order.reverse()
1951
 
            next_revid = order.pop()
1952
 
        else:
1953
 
            order_as_requested = False
1954
 
            if ordering != 'unordered' and self._fallback_repositories:
1955
 
                raise ValueError('unsupported ordering %r' % ordering)
1956
 
        iter_inv_fns = [self._iter_inventories_rpc] + [
1957
 
            fallback._iter_inventories for fallback in
1958
 
            self._fallback_repositories]
1959
 
        try:
1960
 
            for iter_inv in iter_inv_fns:
1961
 
                request = [revid for revid in revision_ids if revid in missing]
1962
 
                for inv, revid in iter_inv(request, ordering):
1963
 
                    if inv is None:
1964
 
                        continue
1965
 
                    missing.remove(inv.revision_id)
1966
 
                    if ordering != 'unordered':
1967
 
                        invs[revid] = inv
1968
 
                    else:
1969
 
                        yield inv, revid
1970
 
                if order_as_requested:
1971
 
                    # Yield as many results as we can while preserving order.
1972
 
                    while next_revid in invs:
1973
 
                        inv = invs.pop(next_revid)
1974
 
                        yield inv, inv.revision_id
1975
 
                        try:
1976
 
                            next_revid = order.pop()
1977
 
                        except IndexError:
1978
 
                            # We still want to fully consume the stream, just
1979
 
                            # in case it is not actually finished at this point
1980
 
                            next_revid = None
1981
 
                            break
1982
 
        except errors.UnknownSmartMethod:
1983
 
            for inv, revid in self._iter_inventories_vfs(revision_ids, ordering):
1984
 
                yield inv, revid
1985
 
            return
1986
 
        # Report missing
1987
 
        if order_as_requested:
1988
 
            if next_revid is not None:
1989
 
                yield None, next_revid
1990
 
            while order:
1991
 
                revid = order.pop()
1992
 
                yield invs.get(revid), revid
1993
 
        else:
1994
 
            while missing:
1995
 
                yield None, missing.pop()
1996
 
 
1997
 
    @needs_read_lock
1998
 
    def get_revision(self, revision_id):
1999
 
        return self.get_revisions([revision_id])[0]
2000
 
 
2001
 
    def get_transaction(self):
2002
 
        self._ensure_real()
2003
 
        return self._real_repository.get_transaction()
2004
 
 
2005
 
    @needs_read_lock
2006
 
    def clone(self, a_bzrdir, revision_id=None):
2007
 
        dest_repo = self._create_sprouting_repo(
2008
 
            a_bzrdir, shared=self.is_shared())
2009
 
        self.copy_content_into(dest_repo, revision_id)
2010
 
        return dest_repo
2011
 
 
2012
 
    def make_working_trees(self):
2013
 
        """See Repository.make_working_trees"""
2014
 
        path = self.bzrdir._path_for_remote_call(self._client)
2015
 
        try:
2016
 
            response = self._call('Repository.make_working_trees', path)
2017
 
        except errors.UnknownSmartMethod:
2018
 
            self._ensure_real()
2019
 
            return self._real_repository.make_working_trees()
2020
 
        if response[0] not in ('yes', 'no'):
2021
 
            raise SmartProtocolError('unexpected response code %s' % (response,))
2022
 
        return response[0] == 'yes'
2023
 
 
2024
 
    def refresh_data(self):
2025
 
        """Re-read any data needed to synchronise with disk.
2026
 
 
2027
 
        This method is intended to be called after another repository instance
2028
 
        (such as one used by a smart server) has inserted data into the
2029
 
        repository. On all repositories this will work outside of write groups.
2030
 
        Some repository formats (pack and newer for bzrlib native formats)
2031
 
        support refresh_data inside write groups. If called inside a write
2032
 
        group on a repository that does not support refreshing in a write group
2033
 
        IsInWriteGroupError will be raised.
2034
 
        """
2035
 
        if self._real_repository is not None:
2036
 
            self._real_repository.refresh_data()
2037
 
        # Refresh the parents cache for this object
2038
 
        self._unstacked_provider.disable_cache()
2039
 
        self._unstacked_provider.enable_cache()
2040
 
 
2041
 
    def revision_ids_to_search_result(self, result_set):
2042
 
        """Convert a set of revision ids to a graph SearchResult."""
2043
 
        result_parents = set()
2044
 
        for parents in self.get_graph().get_parent_map(
2045
 
            result_set).itervalues():
2046
 
            result_parents.update(parents)
2047
 
        included_keys = result_set.intersection(result_parents)
2048
 
        start_keys = result_set.difference(included_keys)
2049
 
        exclude_keys = result_parents.difference(result_set)
2050
 
        result = vf_search.SearchResult(start_keys, exclude_keys,
2051
 
            len(result_set), result_set)
2052
 
        return result
2053
 
 
2054
 
    @needs_read_lock
2055
 
    def search_missing_revision_ids(self, other,
2056
 
            revision_id=symbol_versioning.DEPRECATED_PARAMETER,
2057
 
            find_ghosts=True, revision_ids=None, if_present_ids=None,
2058
 
            limit=None):
2059
 
        """Return the revision ids that other has that this does not.
2060
 
 
2061
 
        These are returned in topological order.
2062
 
 
2063
 
        revision_id: only return revision ids included by revision_id.
2064
 
        """
2065
 
        if symbol_versioning.deprecated_passed(revision_id):
2066
 
            symbol_versioning.warn(
2067
 
                'search_missing_revision_ids(revision_id=...) was '
2068
 
                'deprecated in 2.4.  Use revision_ids=[...] instead.',
2069
 
                DeprecationWarning, stacklevel=2)
2070
 
            if revision_ids is not None:
2071
 
                raise AssertionError(
2072
 
                    'revision_ids is mutually exclusive with revision_id')
2073
 
            if revision_id is not None:
2074
 
                revision_ids = [revision_id]
2075
 
        inter_repo = _mod_repository.InterRepository.get(other, self)
2076
 
        return inter_repo.search_missing_revision_ids(
2077
 
            find_ghosts=find_ghosts, revision_ids=revision_ids,
2078
 
            if_present_ids=if_present_ids, limit=limit)
2079
 
 
2080
 
    def fetch(self, source, revision_id=None, find_ghosts=False,
2081
 
            fetch_spec=None):
2082
 
        # No base implementation to use as RemoteRepository is not a subclass
2083
 
        # of Repository; so this is a copy of Repository.fetch().
2084
 
        if fetch_spec is not None and revision_id is not None:
2085
 
            raise AssertionError(
2086
 
                "fetch_spec and revision_id are mutually exclusive.")
2087
 
        if self.is_in_write_group():
2088
 
            raise errors.InternalBzrError(
2089
 
                "May not fetch while in a write group.")
2090
 
        # fast path same-url fetch operations
2091
 
        if (self.has_same_location(source)
2092
 
            and fetch_spec is None
2093
 
            and self._has_same_fallbacks(source)):
2094
 
            # check that last_revision is in 'from' and then return a
2095
 
            # no-operation.
2096
 
            if (revision_id is not None and
2097
 
                not _mod_revision.is_null(revision_id)):
2098
 
                self.get_revision(revision_id)
2099
 
            return 0, []
2100
 
        # if there is no specific appropriate InterRepository, this will get
2101
 
        # the InterRepository base class, which raises an
2102
 
        # IncompatibleRepositories when asked to fetch.
2103
 
        inter = _mod_repository.InterRepository.get(source, self)
2104
 
        if (fetch_spec is not None and
2105
 
            not getattr(inter, "supports_fetch_spec", False)):
2106
 
            raise errors.UnsupportedOperation(
2107
 
                "fetch_spec not supported for %r" % inter)
2108
 
        return inter.fetch(revision_id=revision_id,
2109
 
            find_ghosts=find_ghosts, fetch_spec=fetch_spec)
2110
 
 
2111
 
    def create_bundle(self, target, base, fileobj, format=None):
2112
 
        self._ensure_real()
2113
 
        self._real_repository.create_bundle(target, base, fileobj, format)
2114
 
 
2115
 
    @needs_read_lock
2116
 
    @symbol_versioning.deprecated_method(
2117
 
        symbol_versioning.deprecated_in((2, 4, 0)))
2118
 
    def get_ancestry(self, revision_id, topo_sorted=True):
2119
 
        self._ensure_real()
2120
 
        return self._real_repository.get_ancestry(revision_id, topo_sorted)
2121
 
 
2122
 
    def fileids_altered_by_revision_ids(self, revision_ids):
2123
 
        self._ensure_real()
2124
 
        return self._real_repository.fileids_altered_by_revision_ids(revision_ids)
2125
 
 
2126
 
    def _get_versioned_file_checker(self, revisions, revision_versions_cache):
2127
 
        self._ensure_real()
2128
 
        return self._real_repository._get_versioned_file_checker(
2129
 
            revisions, revision_versions_cache)
2130
 
 
2131
 
    def _iter_files_bytes_rpc(self, desired_files, absent):
2132
 
        path = self.bzrdir._path_for_remote_call(self._client)
2133
 
        lines = []
2134
 
        identifiers = []
2135
 
        for (file_id, revid, identifier) in desired_files:
2136
 
            lines.append("%s\0%s" % (
2137
 
                osutils.safe_file_id(file_id),
2138
 
                osutils.safe_revision_id(revid)))
2139
 
            identifiers.append(identifier)
2140
 
        (response_tuple, response_handler) = (
2141
 
            self._call_with_body_bytes_expecting_body(
2142
 
            "Repository.iter_files_bytes", (path, ), "\n".join(lines)))
2143
 
        if response_tuple != ('ok', ):
2144
 
            response_handler.cancel_read_body()
2145
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
2146
 
        byte_stream = response_handler.read_streamed_body()
2147
 
        def decompress_stream(start, byte_stream, unused):
2148
 
            decompressor = zlib.decompressobj()
2149
 
            yield decompressor.decompress(start)
2150
 
            while decompressor.unused_data == "":
2151
 
                try:
2152
 
                    data = byte_stream.next()
2153
 
                except StopIteration:
2154
 
                    break
2155
 
                yield decompressor.decompress(data)
2156
 
            yield decompressor.flush()
2157
 
            unused.append(decompressor.unused_data)
2158
 
        unused = ""
2159
 
        while True:
2160
 
            while not "\n" in unused:
2161
 
                unused += byte_stream.next()
2162
 
            header, rest = unused.split("\n", 1)
2163
 
            args = header.split("\0")
2164
 
            if args[0] == "absent":
2165
 
                absent[identifiers[int(args[3])]] = (args[1], args[2])
2166
 
                unused = rest
2167
 
                continue
2168
 
            elif args[0] == "ok":
2169
 
                idx = int(args[1])
2170
 
            else:
2171
 
                raise errors.UnexpectedSmartServerResponse(args)
2172
 
            unused_chunks = []
2173
 
            yield (identifiers[idx],
2174
 
                decompress_stream(rest, byte_stream, unused_chunks))
2175
 
            unused = "".join(unused_chunks)
2176
 
 
2177
 
    def iter_files_bytes(self, desired_files):
2178
 
        """See Repository.iter_file_bytes.
2179
 
        """
2180
 
        try:
2181
 
            absent = {}
2182
 
            for (identifier, bytes_iterator) in self._iter_files_bytes_rpc(
2183
 
                    desired_files, absent):
2184
 
                yield identifier, bytes_iterator
2185
 
            for fallback in self._fallback_repositories:
2186
 
                if not absent:
2187
 
                    break
2188
 
                desired_files = [(key[0], key[1], identifier) for
2189
 
                    (identifier, key) in absent.iteritems()]
2190
 
                for (identifier, bytes_iterator) in fallback.iter_files_bytes(desired_files):
2191
 
                    del absent[identifier]
2192
 
                    yield identifier, bytes_iterator
2193
 
            if absent:
2194
 
                # There may be more missing items, but raise an exception
2195
 
                # for just one.
2196
 
                missing_identifier = absent.keys()[0]
2197
 
                missing_key = absent[missing_identifier]
2198
 
                raise errors.RevisionNotPresent(revision_id=missing_key[1],
2199
 
                    file_id=missing_key[0])
2200
 
        except errors.UnknownSmartMethod:
2201
 
            self._ensure_real()
2202
 
            for (identifier, bytes_iterator) in (
2203
 
                self._real_repository.iter_files_bytes(desired_files)):
2204
 
                yield identifier, bytes_iterator
2205
 
 
2206
 
    def get_cached_parent_map(self, revision_ids):
2207
 
        """See bzrlib.CachingParentsProvider.get_cached_parent_map"""
2208
 
        return self._unstacked_provider.get_cached_parent_map(revision_ids)
2209
 
 
2210
 
    def get_parent_map(self, revision_ids):
2211
 
        """See bzrlib.Graph.get_parent_map()."""
2212
 
        return self._make_parents_provider().get_parent_map(revision_ids)
2213
 
 
2214
 
    def _get_parent_map_rpc(self, keys):
2215
 
        """Helper for get_parent_map that performs the RPC."""
2216
 
        medium = self._client._medium
2217
 
        if medium._is_remote_before((1, 2)):
2218
 
            # We already found out that the server can't understand
2219
 
            # Repository.get_parent_map requests, so just fetch the whole
2220
 
            # graph.
2221
 
            #
2222
 
            # Note that this reads the whole graph, when only some keys are
2223
 
            # wanted.  On this old server there's no way (?) to get them all
2224
 
            # in one go, and the user probably will have seen a warning about
2225
 
            # the server being old anyhow.
2226
 
            rg = self._get_revision_graph(None)
2227
 
            # There is an API discrepancy between get_parent_map and
2228
 
            # get_revision_graph. Specifically, a "key:()" pair in
2229
 
            # get_revision_graph just means a node has no parents. For
2230
 
            # "get_parent_map" it means the node is a ghost. So fix up the
2231
 
            # graph to correct this.
2232
 
            #   https://bugs.launchpad.net/bzr/+bug/214894
2233
 
            # There is one other "bug" which is that ghosts in
2234
 
            # get_revision_graph() are not returned at all. But we won't worry
2235
 
            # about that for now.
2236
 
            for node_id, parent_ids in rg.iteritems():
2237
 
                if parent_ids == ():
2238
 
                    rg[node_id] = (NULL_REVISION,)
2239
 
            rg[NULL_REVISION] = ()
2240
 
            return rg
2241
 
 
2242
 
        keys = set(keys)
2243
 
        if None in keys:
2244
 
            raise ValueError('get_parent_map(None) is not valid')
2245
 
        if NULL_REVISION in keys:
2246
 
            keys.discard(NULL_REVISION)
2247
 
            found_parents = {NULL_REVISION:()}
2248
 
            if not keys:
2249
 
                return found_parents
2250
 
        else:
2251
 
            found_parents = {}
2252
 
        # TODO(Needs analysis): We could assume that the keys being requested
2253
 
        # from get_parent_map are in a breadth first search, so typically they
2254
 
        # will all be depth N from some common parent, and we don't have to
2255
 
        # have the server iterate from the root parent, but rather from the
2256
 
        # keys we're searching; and just tell the server the keyspace we
2257
 
        # already have; but this may be more traffic again.
2258
 
 
2259
 
        # Transform self._parents_map into a search request recipe.
2260
 
        # TODO: Manage this incrementally to avoid covering the same path
2261
 
        # repeatedly. (The server will have to on each request, but the less
2262
 
        # work done the better).
2263
 
        #
2264
 
        # Negative caching notes:
2265
 
        # new server sends missing when a request including the revid
2266
 
        # 'include-missing:' is present in the request.
2267
 
        # missing keys are serialised as missing:X, and we then call
2268
 
        # provider.note_missing(X) for-all X
2269
 
        parents_map = self._unstacked_provider.get_cached_map()
2270
 
        if parents_map is None:
2271
 
            # Repository is not locked, so there's no cache.
2272
 
            parents_map = {}
2273
 
        if _DEFAULT_SEARCH_DEPTH <= 0:
2274
 
            (start_set, stop_keys,
2275
 
             key_count) = vf_search.search_result_from_parent_map(
2276
 
                parents_map, self._unstacked_provider.missing_keys)
2277
 
        else:
2278
 
            (start_set, stop_keys,
2279
 
             key_count) = vf_search.limited_search_result_from_parent_map(
2280
 
                parents_map, self._unstacked_provider.missing_keys,
2281
 
                keys, depth=_DEFAULT_SEARCH_DEPTH)
2282
 
        recipe = ('manual', start_set, stop_keys, key_count)
2283
 
        body = self._serialise_search_recipe(recipe)
2284
 
        path = self.bzrdir._path_for_remote_call(self._client)
2285
 
        for key in keys:
2286
 
            if type(key) is not str:
2287
 
                raise ValueError(
2288
 
                    "key %r not a plain string" % (key,))
2289
 
        verb = 'Repository.get_parent_map'
2290
 
        args = (path, 'include-missing:') + tuple(keys)
2291
 
        try:
2292
 
            response = self._call_with_body_bytes_expecting_body(
2293
 
                verb, args, body)
2294
 
        except errors.UnknownSmartMethod:
2295
 
            # Server does not support this method, so get the whole graph.
2296
 
            # Worse, we have to force a disconnection, because the server now
2297
 
            # doesn't realise it has a body on the wire to consume, so the
2298
 
            # only way to recover is to abandon the connection.
2299
 
            warning(
2300
 
                'Server is too old for fast get_parent_map, reconnecting.  '
2301
 
                '(Upgrade the server to Bazaar 1.2 to avoid this)')
2302
 
            medium.disconnect()
2303
 
            # To avoid having to disconnect repeatedly, we keep track of the
2304
 
            # fact the server doesn't understand remote methods added in 1.2.
2305
 
            medium._remember_remote_is_before((1, 2))
2306
 
            # Recurse just once and we should use the fallback code.
2307
 
            return self._get_parent_map_rpc(keys)
2308
 
        response_tuple, response_handler = response
2309
 
        if response_tuple[0] not in ['ok']:
2310
 
            response_handler.cancel_read_body()
2311
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
2312
 
        if response_tuple[0] == 'ok':
2313
 
            coded = bz2.decompress(response_handler.read_body_bytes())
2314
 
            if coded == '':
2315
 
                # no revisions found
2316
 
                return {}
2317
 
            lines = coded.split('\n')
2318
 
            revision_graph = {}
2319
 
            for line in lines:
2320
 
                d = tuple(line.split())
2321
 
                if len(d) > 1:
2322
 
                    revision_graph[d[0]] = d[1:]
2323
 
                else:
2324
 
                    # No parents:
2325
 
                    if d[0].startswith('missing:'):
2326
 
                        revid = d[0][8:]
2327
 
                        self._unstacked_provider.note_missing_key(revid)
2328
 
                    else:
2329
 
                        # no parents - so give the Graph result
2330
 
                        # (NULL_REVISION,).
2331
 
                        revision_graph[d[0]] = (NULL_REVISION,)
2332
 
            return revision_graph
2333
 
 
2334
 
    @needs_read_lock
2335
 
    def get_signature_text(self, revision_id):
2336
 
        path = self.bzrdir._path_for_remote_call(self._client)
2337
 
        try:
2338
 
            response_tuple, response_handler = self._call_expecting_body(
2339
 
                'Repository.get_revision_signature_text', path, revision_id)
2340
 
        except errors.UnknownSmartMethod:
2341
 
            self._ensure_real()
2342
 
            return self._real_repository.get_signature_text(revision_id)
2343
 
        except errors.NoSuchRevision, err:
2344
 
            for fallback in self._fallback_repositories:
2345
 
                try:
2346
 
                    return fallback.get_signature_text(revision_id)
2347
 
                except errors.NoSuchRevision:
2348
 
                    pass
2349
 
            raise err
2350
 
        else:
2351
 
            if response_tuple[0] != 'ok':
2352
 
                raise errors.UnexpectedSmartServerResponse(response_tuple)
2353
 
            return response_handler.read_body_bytes()
2354
 
 
2355
 
    @needs_read_lock
2356
 
    def _get_inventory_xml(self, revision_id):
2357
 
        # This call is used by older working tree formats,
2358
 
        # which stored a serialized basis inventory.
2359
 
        self._ensure_real()
2360
 
        return self._real_repository._get_inventory_xml(revision_id)
2361
 
 
2362
 
    @needs_write_lock
2363
 
    def reconcile(self, other=None, thorough=False):
2364
 
        from bzrlib.reconcile import RepoReconciler
2365
 
        path = self.bzrdir._path_for_remote_call(self._client)
2366
 
        try:
2367
 
            response, handler = self._call_expecting_body(
2368
 
                'Repository.reconcile', path, self._lock_token)
2369
 
        except (errors.UnknownSmartMethod, errors.TokenLockingNotSupported):
2370
 
            self._ensure_real()
2371
 
            return self._real_repository.reconcile(other=other, thorough=thorough)
2372
 
        if response != ('ok', ):
2373
 
            raise errors.UnexpectedSmartServerResponse(response)
2374
 
        body = handler.read_body_bytes()
2375
 
        result = RepoReconciler(self)
2376
 
        for line in body.split('\n'):
2377
 
            if not line:
2378
 
                continue
2379
 
            key, val_text = line.split(':')
2380
 
            if key == "garbage_inventories":
2381
 
                result.garbage_inventories = int(val_text)
2382
 
            elif key == "inconsistent_parents":
2383
 
                result.inconsistent_parents = int(val_text)
2384
 
            else:
2385
 
                mutter("unknown reconcile key %r" % key)
2386
 
        return result
2387
 
 
2388
 
    def all_revision_ids(self):
2389
 
        path = self.bzrdir._path_for_remote_call(self._client)
2390
 
        try:
2391
 
            response_tuple, response_handler = self._call_expecting_body(
2392
 
                "Repository.all_revision_ids", path)
2393
 
        except errors.UnknownSmartMethod:
2394
 
            self._ensure_real()
2395
 
            return self._real_repository.all_revision_ids()
2396
 
        if response_tuple != ("ok", ):
2397
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
2398
 
        revids = set(response_handler.read_body_bytes().splitlines())
2399
 
        for fallback in self._fallback_repositories:
2400
 
            revids.update(set(fallback.all_revision_ids()))
2401
 
        return list(revids)
2402
 
 
2403
 
    def _filtered_revision_trees(self, revision_ids, file_ids):
2404
 
        """Return Tree for a revision on this branch with only some files.
2405
 
 
2406
 
        :param revision_ids: a sequence of revision-ids;
2407
 
          a revision-id may not be None or 'null:'
2408
 
        :param file_ids: if not None, the result is filtered
2409
 
          so that only those file-ids, their parents and their
2410
 
          children are included.
2411
 
        """
2412
 
        inventories = self.iter_inventories(revision_ids)
2413
 
        for inv in inventories:
2414
 
            # Should we introduce a FilteredRevisionTree class rather
2415
 
            # than pre-filter the inventory here?
2416
 
            filtered_inv = inv.filter(file_ids)
2417
 
            yield InventoryRevisionTree(self, filtered_inv, filtered_inv.revision_id)
2418
 
 
2419
 
    @needs_read_lock
2420
 
    def get_deltas_for_revisions(self, revisions, specific_fileids=None):
2421
 
        medium = self._client._medium
2422
 
        if medium._is_remote_before((1, 2)):
2423
 
            self._ensure_real()
2424
 
            for delta in self._real_repository.get_deltas_for_revisions(
2425
 
                    revisions, specific_fileids):
2426
 
                yield delta
2427
 
            return
2428
 
        # Get the revision-ids of interest
2429
 
        required_trees = set()
2430
 
        for revision in revisions:
2431
 
            required_trees.add(revision.revision_id)
2432
 
            required_trees.update(revision.parent_ids[:1])
2433
 
 
2434
 
        # Get the matching filtered trees. Note that it's more
2435
 
        # efficient to pass filtered trees to changes_from() rather
2436
 
        # than doing the filtering afterwards. changes_from() could
2437
 
        # arguably do the filtering itself but it's path-based, not
2438
 
        # file-id based, so filtering before or afterwards is
2439
 
        # currently easier.
2440
 
        if specific_fileids is None:
2441
 
            trees = dict((t.get_revision_id(), t) for
2442
 
                t in self.revision_trees(required_trees))
2443
 
        else:
2444
 
            trees = dict((t.get_revision_id(), t) for
2445
 
                t in self._filtered_revision_trees(required_trees,
2446
 
                specific_fileids))
2447
 
 
2448
 
        # Calculate the deltas
2449
 
        for revision in revisions:
2450
 
            if not revision.parent_ids:
2451
 
                old_tree = self.revision_tree(_mod_revision.NULL_REVISION)
2452
 
            else:
2453
 
                old_tree = trees[revision.parent_ids[0]]
2454
 
            yield trees[revision.revision_id].changes_from(old_tree)
2455
 
 
2456
 
    @needs_read_lock
2457
 
    def get_revision_delta(self, revision_id, specific_fileids=None):
2458
 
        r = self.get_revision(revision_id)
2459
 
        return list(self.get_deltas_for_revisions([r],
2460
 
            specific_fileids=specific_fileids))[0]
2461
 
 
2462
 
    @needs_read_lock
2463
 
    def revision_trees(self, revision_ids):
2464
 
        inventories = self.iter_inventories(revision_ids)
2465
 
        for inv in inventories:
2466
 
            yield InventoryRevisionTree(self, inv, inv.revision_id)
2467
 
 
2468
 
    @needs_read_lock
2469
 
    def get_revision_reconcile(self, revision_id):
2470
 
        self._ensure_real()
2471
 
        return self._real_repository.get_revision_reconcile(revision_id)
2472
 
 
2473
 
    @needs_read_lock
2474
 
    def check(self, revision_ids=None, callback_refs=None, check_repo=True):
2475
 
        self._ensure_real()
2476
 
        return self._real_repository.check(revision_ids=revision_ids,
2477
 
            callback_refs=callback_refs, check_repo=check_repo)
2478
 
 
2479
 
    def copy_content_into(self, destination, revision_id=None):
2480
 
        """Make a complete copy of the content in self into destination.
2481
 
 
2482
 
        This is a destructive operation! Do not use it on existing
2483
 
        repositories.
2484
 
        """
2485
 
        interrepo = _mod_repository.InterRepository.get(self, destination)
2486
 
        return interrepo.copy_content(revision_id)
2487
 
 
2488
 
    def _copy_repository_tarball(self, to_bzrdir, revision_id=None):
2489
 
        # get a tarball of the remote repository, and copy from that into the
2490
 
        # destination
2491
 
        import tarfile
2492
 
        # TODO: Maybe a progress bar while streaming the tarball?
2493
 
        note(gettext("Copying repository content as tarball..."))
2494
 
        tar_file = self._get_tarball('bz2')
2495
 
        if tar_file is None:
2496
 
            return None
2497
 
        destination = to_bzrdir.create_repository()
2498
 
        try:
2499
 
            tar = tarfile.open('repository', fileobj=tar_file,
2500
 
                mode='r|bz2')
2501
 
            tmpdir = osutils.mkdtemp()
2502
 
            try:
2503
 
                _extract_tar(tar, tmpdir)
2504
 
                tmp_bzrdir = _mod_bzrdir.BzrDir.open(tmpdir)
2505
 
                tmp_repo = tmp_bzrdir.open_repository()
2506
 
                tmp_repo.copy_content_into(destination, revision_id)
2507
 
            finally:
2508
 
                osutils.rmtree(tmpdir)
2509
 
        finally:
2510
 
            tar_file.close()
2511
 
        return destination
2512
 
        # TODO: Suggestion from john: using external tar is much faster than
2513
 
        # python's tarfile library, but it may not work on windows.
2514
 
 
2515
 
    @property
2516
 
    def inventories(self):
2517
 
        """Decorate the real repository for now.
2518
 
 
2519
 
        In the long term a full blown network facility is needed to
2520
 
        avoid creating a real repository object locally.
2521
 
        """
2522
 
        self._ensure_real()
2523
 
        return self._real_repository.inventories
2524
 
 
2525
 
    @needs_write_lock
2526
 
    def pack(self, hint=None, clean_obsolete_packs=False):
2527
 
        """Compress the data within the repository.
2528
 
        """
2529
 
        if hint is None:
2530
 
            body = ""
2531
 
        else:
2532
 
            body = "".join([l+"\n" for l in hint])
2533
 
        path = self.bzrdir._path_for_remote_call(self._client)
2534
 
        try:
2535
 
            response, handler = self._call_with_body_bytes_expecting_body(
2536
 
                'Repository.pack', (path, self._lock_token,
2537
 
                    str(clean_obsolete_packs)), body)
2538
 
        except errors.UnknownSmartMethod:
2539
 
            self._ensure_real()
2540
 
            return self._real_repository.pack(hint=hint,
2541
 
                clean_obsolete_packs=clean_obsolete_packs)
2542
 
        handler.cancel_read_body()
2543
 
        if response != ('ok', ):
2544
 
            raise errors.UnexpectedSmartServerResponse(response)
2545
 
 
2546
 
    @property
2547
 
    def revisions(self):
2548
 
        """Decorate the real repository for now.
2549
 
 
2550
 
        In the long term a full blown network facility is needed.
2551
 
        """
2552
 
        self._ensure_real()
2553
 
        return self._real_repository.revisions
2554
 
 
2555
 
    def set_make_working_trees(self, new_value):
2556
 
        if new_value:
2557
 
            new_value_str = "True"
2558
 
        else:
2559
 
            new_value_str = "False"
2560
 
        path = self.bzrdir._path_for_remote_call(self._client)
2561
 
        try:
2562
 
            response = self._call(
2563
 
                'Repository.set_make_working_trees', path, new_value_str)
2564
 
        except errors.UnknownSmartMethod:
2565
 
            self._ensure_real()
2566
 
            self._real_repository.set_make_working_trees(new_value)
2567
 
        else:
2568
 
            if response[0] != 'ok':
2569
 
                raise errors.UnexpectedSmartServerResponse(response)
2570
 
 
2571
 
    @property
2572
 
    def signatures(self):
2573
 
        """Decorate the real repository for now.
2574
 
 
2575
 
        In the long term a full blown network facility is needed to avoid
2576
 
        creating a real repository object locally.
2577
 
        """
2578
 
        self._ensure_real()
2579
 
        return self._real_repository.signatures
2580
 
 
2581
 
    @needs_write_lock
2582
 
    def sign_revision(self, revision_id, gpg_strategy):
2583
 
        testament = _mod_testament.Testament.from_revision(self, revision_id)
2584
 
        plaintext = testament.as_short_text()
2585
 
        self.store_revision_signature(gpg_strategy, plaintext, revision_id)
2586
 
 
2587
 
    @property
2588
 
    def texts(self):
2589
 
        """Decorate the real repository for now.
2590
 
 
2591
 
        In the long term a full blown network facility is needed to avoid
2592
 
        creating a real repository object locally.
2593
 
        """
2594
 
        self._ensure_real()
2595
 
        return self._real_repository.texts
2596
 
 
2597
 
    def _iter_revisions_rpc(self, revision_ids):
2598
 
        body = "\n".join(revision_ids)
2599
 
        path = self.bzrdir._path_for_remote_call(self._client)
2600
 
        response_tuple, response_handler = (
2601
 
            self._call_with_body_bytes_expecting_body(
2602
 
            "Repository.iter_revisions", (path, ), body))
2603
 
        if response_tuple[0] != "ok":
2604
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
2605
 
        serializer_format = response_tuple[1]
2606
 
        serializer = serializer_format_registry.get(serializer_format)
2607
 
        byte_stream = response_handler.read_streamed_body()
2608
 
        decompressor = zlib.decompressobj()
2609
 
        chunks = []
2610
 
        for bytes in byte_stream:
2611
 
            chunks.append(decompressor.decompress(bytes))
2612
 
            if decompressor.unused_data != "":
2613
 
                chunks.append(decompressor.flush())
2614
 
                yield serializer.read_revision_from_string("".join(chunks))
2615
 
                unused = decompressor.unused_data
2616
 
                decompressor = zlib.decompressobj()
2617
 
                chunks = [decompressor.decompress(unused)]
2618
 
        chunks.append(decompressor.flush())
2619
 
        text = "".join(chunks)
2620
 
        if text != "":
2621
 
            yield serializer.read_revision_from_string("".join(chunks))
2622
 
 
2623
 
    @needs_read_lock
2624
 
    def get_revisions(self, revision_ids):
2625
 
        if revision_ids is None:
2626
 
            revision_ids = self.all_revision_ids()
2627
 
        else:
2628
 
            for rev_id in revision_ids:
2629
 
                if not rev_id or not isinstance(rev_id, basestring):
2630
 
                    raise errors.InvalidRevisionId(
2631
 
                        revision_id=rev_id, branch=self)
2632
 
        try:
2633
 
            missing = set(revision_ids)
2634
 
            revs = {}
2635
 
            for rev in self._iter_revisions_rpc(revision_ids):
2636
 
                missing.remove(rev.revision_id)
2637
 
                revs[rev.revision_id] = rev
2638
 
        except errors.UnknownSmartMethod:
2639
 
            self._ensure_real()
2640
 
            return self._real_repository.get_revisions(revision_ids)
2641
 
        for fallback in self._fallback_repositories:
2642
 
            if not missing:
2643
 
                break
2644
 
            for revid in list(missing):
2645
 
                # XXX JRV 2011-11-20: It would be nice if there was a
2646
 
                # public method on Repository that could be used to query
2647
 
                # for revision objects *without* failing completely if one
2648
 
                # was missing. There is VersionedFileRepository._iter_revisions,
2649
 
                # but unfortunately that's private and not provided by
2650
 
                # all repository implementations.
2651
 
                try:
2652
 
                    revs[revid] = fallback.get_revision(revid)
2653
 
                except errors.NoSuchRevision:
2654
 
                    pass
2655
 
                else:
2656
 
                    missing.remove(revid)
2657
 
        if missing:
2658
 
            raise errors.NoSuchRevision(self, list(missing)[0])
2659
 
        return [revs[revid] for revid in revision_ids]
2660
 
 
2661
 
    def supports_rich_root(self):
2662
 
        return self._format.rich_root_data
2663
 
 
2664
 
    @symbol_versioning.deprecated_method(symbol_versioning.deprecated_in((2, 4, 0)))
2665
 
    def iter_reverse_revision_history(self, revision_id):
2666
 
        self._ensure_real()
2667
 
        return self._real_repository.iter_reverse_revision_history(revision_id)
2668
 
 
2669
 
    @property
2670
 
    def _serializer(self):
2671
 
        return self._format._serializer
2672
 
 
2673
 
    @needs_write_lock
2674
 
    def store_revision_signature(self, gpg_strategy, plaintext, revision_id):
2675
 
        signature = gpg_strategy.sign(plaintext)
2676
 
        self.add_signature_text(revision_id, signature)
2677
 
 
2678
 
    def add_signature_text(self, revision_id, signature):
2679
 
        if self._real_repository:
2680
 
            # If there is a real repository the write group will
2681
 
            # be in the real repository as well, so use that:
2682
 
            self._ensure_real()
2683
 
            return self._real_repository.add_signature_text(
2684
 
                revision_id, signature)
2685
 
        path = self.bzrdir._path_for_remote_call(self._client)
2686
 
        response, handler = self._call_with_body_bytes_expecting_body(
2687
 
            'Repository.add_signature_text', (path, self._lock_token,
2688
 
                revision_id) + tuple(self._write_group_tokens), signature)
2689
 
        handler.cancel_read_body()
2690
 
        self.refresh_data()
2691
 
        if response[0] != 'ok':
2692
 
            raise errors.UnexpectedSmartServerResponse(response)
2693
 
        self._write_group_tokens = response[1:]
2694
 
 
2695
 
    def has_signature_for_revision_id(self, revision_id):
2696
 
        path = self.bzrdir._path_for_remote_call(self._client)
2697
 
        try:
2698
 
            response = self._call('Repository.has_signature_for_revision_id',
2699
 
                path, revision_id)
2700
 
        except errors.UnknownSmartMethod:
2701
 
            self._ensure_real()
2702
 
            return self._real_repository.has_signature_for_revision_id(
2703
 
                revision_id)
2704
 
        if response[0] not in ('yes', 'no'):
2705
 
            raise SmartProtocolError('unexpected response code %s' % (response,))
2706
 
        if response[0] == 'yes':
2707
 
            return True
2708
 
        for fallback in self._fallback_repositories:
2709
 
            if fallback.has_signature_for_revision_id(revision_id):
2710
 
                return True
2711
 
        return False
2712
 
 
2713
 
    @needs_read_lock
2714
 
    def verify_revision_signature(self, revision_id, gpg_strategy):
2715
 
        if not self.has_signature_for_revision_id(revision_id):
2716
 
            return gpg.SIGNATURE_NOT_SIGNED, None
2717
 
        signature = self.get_signature_text(revision_id)
2718
 
 
2719
 
        testament = _mod_testament.Testament.from_revision(self, revision_id)
2720
 
        plaintext = testament.as_short_text()
2721
 
 
2722
 
        return gpg_strategy.verify(signature, plaintext)
2723
 
 
2724
 
    def item_keys_introduced_by(self, revision_ids, _files_pb=None):
2725
 
        self._ensure_real()
2726
 
        return self._real_repository.item_keys_introduced_by(revision_ids,
2727
 
            _files_pb=_files_pb)
2728
 
 
2729
 
    def _find_inconsistent_revision_parents(self, revisions_iterator=None):
2730
 
        self._ensure_real()
2731
 
        return self._real_repository._find_inconsistent_revision_parents(
2732
 
            revisions_iterator)
2733
 
 
2734
 
    def _check_for_inconsistent_revision_parents(self):
2735
 
        self._ensure_real()
2736
 
        return self._real_repository._check_for_inconsistent_revision_parents()
2737
 
 
2738
 
    def _make_parents_provider(self, other=None):
2739
 
        providers = [self._unstacked_provider]
2740
 
        if other is not None:
2741
 
            providers.insert(0, other)
2742
 
        return graph.StackedParentsProvider(_LazyListJoin(
2743
 
            providers, self._fallback_repositories))
2744
 
 
2745
 
    def _serialise_search_recipe(self, recipe):
2746
 
        """Serialise a graph search recipe.
2747
 
 
2748
 
        :param recipe: A search recipe (start, stop, count).
2749
 
        :return: Serialised bytes.
2750
 
        """
2751
 
        start_keys = ' '.join(recipe[1])
2752
 
        stop_keys = ' '.join(recipe[2])
2753
 
        count = str(recipe[3])
2754
 
        return '\n'.join((start_keys, stop_keys, count))
2755
 
 
2756
 
    def _serialise_search_result(self, search_result):
2757
 
        parts = search_result.get_network_struct()
2758
 
        return '\n'.join(parts)
2759
 
 
2760
 
    def autopack(self):
2761
 
        path = self.bzrdir._path_for_remote_call(self._client)
2762
 
        try:
2763
 
            response = self._call('PackRepository.autopack', path)
2764
 
        except errors.UnknownSmartMethod:
2765
 
            self._ensure_real()
2766
 
            self._real_repository._pack_collection.autopack()
2767
 
            return
2768
 
        self.refresh_data()
2769
 
        if response[0] != 'ok':
2770
 
            raise errors.UnexpectedSmartServerResponse(response)
2771
 
 
2772
 
 
2773
 
class RemoteStreamSink(vf_repository.StreamSink):
2774
 
 
2775
 
    def _insert_real(self, stream, src_format, resume_tokens):
2776
 
        self.target_repo._ensure_real()
2777
 
        sink = self.target_repo._real_repository._get_sink()
2778
 
        result = sink.insert_stream(stream, src_format, resume_tokens)
2779
 
        if not result:
2780
 
            self.target_repo.autopack()
2781
 
        return result
2782
 
 
2783
 
    def insert_stream(self, stream, src_format, resume_tokens):
2784
 
        target = self.target_repo
2785
 
        target._unstacked_provider.missing_keys.clear()
2786
 
        candidate_calls = [('Repository.insert_stream_1.19', (1, 19))]
2787
 
        if target._lock_token:
2788
 
            candidate_calls.append(('Repository.insert_stream_locked', (1, 14)))
2789
 
            lock_args = (target._lock_token or '',)
2790
 
        else:
2791
 
            candidate_calls.append(('Repository.insert_stream', (1, 13)))
2792
 
            lock_args = ()
2793
 
        client = target._client
2794
 
        medium = client._medium
2795
 
        path = target.bzrdir._path_for_remote_call(client)
2796
 
        # Probe for the verb to use with an empty stream before sending the
2797
 
        # real stream to it.  We do this both to avoid the risk of sending a
2798
 
        # large request that is then rejected, and because we don't want to
2799
 
        # implement a way to buffer, rewind, or restart the stream.
2800
 
        found_verb = False
2801
 
        for verb, required_version in candidate_calls:
2802
 
            if medium._is_remote_before(required_version):
2803
 
                continue
2804
 
            if resume_tokens:
2805
 
                # We've already done the probing (and set _is_remote_before) on
2806
 
                # a previous insert.
2807
 
                found_verb = True
2808
 
                break
2809
 
            byte_stream = smart_repo._stream_to_byte_stream([], src_format)
2810
 
            try:
2811
 
                response = client.call_with_body_stream(
2812
 
                    (verb, path, '') + lock_args, byte_stream)
2813
 
            except errors.UnknownSmartMethod:
2814
 
                medium._remember_remote_is_before(required_version)
2815
 
            else:
2816
 
                found_verb = True
2817
 
                break
2818
 
        if not found_verb:
2819
 
            # Have to use VFS.
2820
 
            return self._insert_real(stream, src_format, resume_tokens)
2821
 
        self._last_inv_record = None
2822
 
        self._last_substream = None
2823
 
        if required_version < (1, 19):
2824
 
            # Remote side doesn't support inventory deltas.  Wrap the stream to
2825
 
            # make sure we don't send any.  If the stream contains inventory
2826
 
            # deltas we'll interrupt the smart insert_stream request and
2827
 
            # fallback to VFS.
2828
 
            stream = self._stop_stream_if_inventory_delta(stream)
2829
 
        byte_stream = smart_repo._stream_to_byte_stream(
2830
 
            stream, src_format)
2831
 
        resume_tokens = ' '.join(resume_tokens)
2832
 
        response = client.call_with_body_stream(
2833
 
            (verb, path, resume_tokens) + lock_args, byte_stream)
2834
 
        if response[0][0] not in ('ok', 'missing-basis'):
2835
 
            raise errors.UnexpectedSmartServerResponse(response)
2836
 
        if self._last_substream is not None:
2837
 
            # The stream included an inventory-delta record, but the remote
2838
 
            # side isn't new enough to support them.  So we need to send the
2839
 
            # rest of the stream via VFS.
2840
 
            self.target_repo.refresh_data()
2841
 
            return self._resume_stream_with_vfs(response, src_format)
2842
 
        if response[0][0] == 'missing-basis':
2843
 
            tokens, missing_keys = bencode.bdecode_as_tuple(response[0][1])
2844
 
            resume_tokens = tokens
2845
 
            return resume_tokens, set(missing_keys)
2846
 
        else:
2847
 
            self.target_repo.refresh_data()
2848
 
            return [], set()
2849
 
 
2850
 
    def _resume_stream_with_vfs(self, response, src_format):
2851
 
        """Resume sending a stream via VFS, first resending the record and
2852
 
        substream that couldn't be sent via an insert_stream verb.
2853
 
        """
2854
 
        if response[0][0] == 'missing-basis':
2855
 
            tokens, missing_keys = bencode.bdecode_as_tuple(response[0][1])
2856
 
            # Ignore missing_keys, we haven't finished inserting yet
2857
 
        else:
2858
 
            tokens = []
2859
 
        def resume_substream():
2860
 
            # Yield the substream that was interrupted.
2861
 
            for record in self._last_substream:
2862
 
                yield record
2863
 
            self._last_substream = None
2864
 
        def resume_stream():
2865
 
            # Finish sending the interrupted substream
2866
 
            yield ('inventory-deltas', resume_substream())
2867
 
            # Then simply continue sending the rest of the stream.
2868
 
            for substream_kind, substream in self._last_stream:
2869
 
                yield substream_kind, substream
2870
 
        return self._insert_real(resume_stream(), src_format, tokens)
2871
 
 
2872
 
    def _stop_stream_if_inventory_delta(self, stream):
2873
 
        """Normally this just lets the original stream pass-through unchanged.
2874
 
 
2875
 
        However if any 'inventory-deltas' substream occurs it will stop
2876
 
        streaming, and store the interrupted substream and stream in
2877
 
        self._last_substream and self._last_stream so that the stream can be
2878
 
        resumed by _resume_stream_with_vfs.
2879
 
        """
2880
 
 
2881
 
        stream_iter = iter(stream)
2882
 
        for substream_kind, substream in stream_iter:
2883
 
            if substream_kind == 'inventory-deltas':
2884
 
                self._last_substream = substream
2885
 
                self._last_stream = stream_iter
2886
 
                return
2887
 
            else:
2888
 
                yield substream_kind, substream
2889
 
 
2890
 
 
2891
 
class RemoteStreamSource(vf_repository.StreamSource):
2892
 
    """Stream data from a remote server."""
2893
 
 
2894
 
    def get_stream(self, search):
2895
 
        if (self.from_repository._fallback_repositories and
2896
 
            self.to_format._fetch_order == 'topological'):
2897
 
            return self._real_stream(self.from_repository, search)
2898
 
        sources = []
2899
 
        seen = set()
2900
 
        repos = [self.from_repository]
2901
 
        while repos:
2902
 
            repo = repos.pop(0)
2903
 
            if repo in seen:
2904
 
                continue
2905
 
            seen.add(repo)
2906
 
            repos.extend(repo._fallback_repositories)
2907
 
            sources.append(repo)
2908
 
        return self.missing_parents_chain(search, sources)
2909
 
 
2910
 
    def get_stream_for_missing_keys(self, missing_keys):
2911
 
        self.from_repository._ensure_real()
2912
 
        real_repo = self.from_repository._real_repository
2913
 
        real_source = real_repo._get_source(self.to_format)
2914
 
        return real_source.get_stream_for_missing_keys(missing_keys)
2915
 
 
2916
 
    def _real_stream(self, repo, search):
2917
 
        """Get a stream for search from repo.
2918
 
 
2919
 
        This never called RemoteStreamSource.get_stream, and is a helper
2920
 
        for RemoteStreamSource._get_stream to allow getting a stream
2921
 
        reliably whether fallback back because of old servers or trying
2922
 
        to stream from a non-RemoteRepository (which the stacked support
2923
 
        code will do).
2924
 
        """
2925
 
        source = repo._get_source(self.to_format)
2926
 
        if isinstance(source, RemoteStreamSource):
2927
 
            repo._ensure_real()
2928
 
            source = repo._real_repository._get_source(self.to_format)
2929
 
        return source.get_stream(search)
2930
 
 
2931
 
    def _get_stream(self, repo, search):
2932
 
        """Core worker to get a stream from repo for search.
2933
 
 
2934
 
        This is used by both get_stream and the stacking support logic. It
2935
 
        deliberately gets a stream for repo which does not need to be
2936
 
        self.from_repository. In the event that repo is not Remote, or
2937
 
        cannot do a smart stream, a fallback is made to the generic
2938
 
        repository._get_stream() interface, via self._real_stream.
2939
 
 
2940
 
        In the event of stacking, streams from _get_stream will not
2941
 
        contain all the data for search - this is normal (see get_stream).
2942
 
 
2943
 
        :param repo: A repository.
2944
 
        :param search: A search.
2945
 
        """
2946
 
        # Fallbacks may be non-smart
2947
 
        if not isinstance(repo, RemoteRepository):
2948
 
            return self._real_stream(repo, search)
2949
 
        client = repo._client
2950
 
        medium = client._medium
2951
 
        path = repo.bzrdir._path_for_remote_call(client)
2952
 
        search_bytes = repo._serialise_search_result(search)
2953
 
        args = (path, self.to_format.network_name())
2954
 
        candidate_verbs = [
2955
 
            ('Repository.get_stream_1.19', (1, 19)),
2956
 
            ('Repository.get_stream', (1, 13))]
2957
 
 
2958
 
        found_verb = False
2959
 
        for verb, version in candidate_verbs:
2960
 
            if medium._is_remote_before(version):
2961
 
                continue
2962
 
            try:
2963
 
                response = repo._call_with_body_bytes_expecting_body(
2964
 
                    verb, args, search_bytes)
2965
 
            except errors.UnknownSmartMethod:
2966
 
                medium._remember_remote_is_before(version)
2967
 
            except errors.UnknownErrorFromSmartServer, e:
2968
 
                if isinstance(search, vf_search.EverythingResult):
2969
 
                    error_verb = e.error_from_smart_server.error_verb
2970
 
                    if error_verb == 'BadSearch':
2971
 
                        # Pre-2.4 servers don't support this sort of search.
2972
 
                        # XXX: perhaps falling back to VFS on BadSearch is a
2973
 
                        # good idea in general?  It might provide a little bit
2974
 
                        # of protection against client-side bugs.
2975
 
                        medium._remember_remote_is_before((2, 4))
2976
 
                        break
2977
 
                raise
2978
 
            else:
2979
 
                response_tuple, response_handler = response
2980
 
                found_verb = True
2981
 
                break
2982
 
        if not found_verb:
2983
 
            return self._real_stream(repo, search)
2984
 
        if response_tuple[0] != 'ok':
2985
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
2986
 
        byte_stream = response_handler.read_streamed_body()
2987
 
        src_format, stream = smart_repo._byte_stream_to_stream(byte_stream,
2988
 
            self._record_counter)
2989
 
        if src_format.network_name() != repo._format.network_name():
2990
 
            raise AssertionError(
2991
 
                "Mismatched RemoteRepository and stream src %r, %r" % (
2992
 
                src_format.network_name(), repo._format.network_name()))
2993
 
        return stream
2994
 
 
2995
 
    def missing_parents_chain(self, search, sources):
2996
 
        """Chain multiple streams together to handle stacking.
2997
 
 
2998
 
        :param search: The overall search to satisfy with streams.
2999
 
        :param sources: A list of Repository objects to query.
3000
 
        """
3001
 
        self.from_serialiser = self.from_repository._format._serializer
3002
 
        self.seen_revs = set()
3003
 
        self.referenced_revs = set()
3004
 
        # If there are heads in the search, or the key count is > 0, we are not
3005
 
        # done.
3006
 
        while not search.is_empty() and len(sources) > 1:
3007
 
            source = sources.pop(0)
3008
 
            stream = self._get_stream(source, search)
3009
 
            for kind, substream in stream:
3010
 
                if kind != 'revisions':
3011
 
                    yield kind, substream
3012
 
                else:
3013
 
                    yield kind, self.missing_parents_rev_handler(substream)
3014
 
            search = search.refine(self.seen_revs, self.referenced_revs)
3015
 
            self.seen_revs = set()
3016
 
            self.referenced_revs = set()
3017
 
        if not search.is_empty():
3018
 
            for kind, stream in self._get_stream(sources[0], search):
3019
 
                yield kind, stream
3020
 
 
3021
 
    def missing_parents_rev_handler(self, substream):
3022
 
        for content in substream:
3023
 
            revision_bytes = content.get_bytes_as('fulltext')
3024
 
            revision = self.from_serialiser.read_revision_from_string(
3025
 
                revision_bytes)
3026
 
            self.seen_revs.add(content.key[-1])
3027
 
            self.referenced_revs.update(revision.parent_ids)
3028
 
            yield content
3029
 
 
3030
 
 
3031
 
class RemoteBranchLockableFiles(LockableFiles):
3032
 
    """A 'LockableFiles' implementation that talks to a smart server.
3033
 
 
3034
 
    This is not a public interface class.
3035
 
    """
3036
 
 
3037
 
    def __init__(self, bzrdir, _client):
3038
 
        self.bzrdir = bzrdir
3039
 
        self._client = _client
3040
 
        self._need_find_modes = True
3041
 
        LockableFiles.__init__(
3042
 
            self, bzrdir.get_branch_transport(None),
3043
 
            'lock', lockdir.LockDir)
3044
 
 
3045
 
    def _find_modes(self):
3046
 
        # RemoteBranches don't let the client set the mode of control files.
3047
 
        self._dir_mode = None
3048
 
        self._file_mode = None
3049
 
 
3050
 
 
3051
 
class RemoteBranchFormat(branch.BranchFormat):
3052
 
 
3053
 
    def __init__(self, network_name=None):
3054
 
        super(RemoteBranchFormat, self).__init__()
3055
 
        self._matchingbzrdir = RemoteBzrDirFormat()
3056
 
        self._matchingbzrdir.set_branch_format(self)
3057
 
        self._custom_format = None
3058
 
        self._network_name = network_name
3059
 
 
3060
 
    def __eq__(self, other):
3061
 
        return (isinstance(other, RemoteBranchFormat) and
3062
 
            self.__dict__ == other.__dict__)
3063
 
 
3064
 
    def _ensure_real(self):
3065
 
        if self._custom_format is None:
3066
 
            try:
3067
 
                self._custom_format = branch.network_format_registry.get(
3068
 
                    self._network_name)
3069
 
            except KeyError:
3070
 
                raise errors.UnknownFormatError(kind='branch',
3071
 
                    format=self._network_name)
3072
 
 
3073
 
    def get_format_description(self):
3074
 
        self._ensure_real()
3075
 
        return 'Remote: ' + self._custom_format.get_format_description()
3076
 
 
3077
 
    def network_name(self):
3078
 
        return self._network_name
3079
 
 
3080
 
    def open(self, a_bzrdir, name=None, ignore_fallbacks=False):
3081
 
        return a_bzrdir.open_branch(name=name, 
3082
 
            ignore_fallbacks=ignore_fallbacks)
3083
 
 
3084
 
    def _vfs_initialize(self, a_bzrdir, name, append_revisions_only):
3085
 
        # Initialisation when using a local bzrdir object, or a non-vfs init
3086
 
        # method is not available on the server.
3087
 
        # self._custom_format is always set - the start of initialize ensures
3088
 
        # that.
3089
 
        if isinstance(a_bzrdir, RemoteBzrDir):
3090
 
            a_bzrdir._ensure_real()
3091
 
            result = self._custom_format.initialize(a_bzrdir._real_bzrdir,
3092
 
                name, append_revisions_only=append_revisions_only)
3093
 
        else:
3094
 
            # We assume the bzrdir is parameterised; it may not be.
3095
 
            result = self._custom_format.initialize(a_bzrdir, name,
3096
 
                append_revisions_only=append_revisions_only)
3097
 
        if (isinstance(a_bzrdir, RemoteBzrDir) and
3098
 
            not isinstance(result, RemoteBranch)):
3099
 
            result = RemoteBranch(a_bzrdir, a_bzrdir.find_repository(), result,
3100
 
                                  name=name)
3101
 
        return result
3102
 
 
3103
 
    def initialize(self, a_bzrdir, name=None, repository=None,
3104
 
                   append_revisions_only=None):
3105
 
        # 1) get the network name to use.
3106
 
        if self._custom_format:
3107
 
            network_name = self._custom_format.network_name()
3108
 
        else:
3109
 
            # Select the current bzrlib default and ask for that.
3110
 
            reference_bzrdir_format = _mod_bzrdir.format_registry.get('default')()
3111
 
            reference_format = reference_bzrdir_format.get_branch_format()
3112
 
            self._custom_format = reference_format
3113
 
            network_name = reference_format.network_name()
3114
 
        # Being asked to create on a non RemoteBzrDir:
3115
 
        if not isinstance(a_bzrdir, RemoteBzrDir):
3116
 
            return self._vfs_initialize(a_bzrdir, name=name,
3117
 
                append_revisions_only=append_revisions_only)
3118
 
        medium = a_bzrdir._client._medium
3119
 
        if medium._is_remote_before((1, 13)):
3120
 
            return self._vfs_initialize(a_bzrdir, name=name,
3121
 
                append_revisions_only=append_revisions_only)
3122
 
        # Creating on a remote bzr dir.
3123
 
        # 2) try direct creation via RPC
3124
 
        path = a_bzrdir._path_for_remote_call(a_bzrdir._client)
3125
 
        if name is not None:
3126
 
            # XXX JRV20100304: Support creating colocated branches
3127
 
            raise errors.NoColocatedBranchSupport(self)
3128
 
        verb = 'BzrDir.create_branch'
3129
 
        try:
3130
 
            response = a_bzrdir._call(verb, path, network_name)
3131
 
        except errors.UnknownSmartMethod:
3132
 
            # Fallback - use vfs methods
3133
 
            medium._remember_remote_is_before((1, 13))
3134
 
            return self._vfs_initialize(a_bzrdir, name=name,
3135
 
                    append_revisions_only=append_revisions_only)
3136
 
        if response[0] != 'ok':
3137
 
            raise errors.UnexpectedSmartServerResponse(response)
3138
 
        # Turn the response into a RemoteRepository object.
3139
 
        format = RemoteBranchFormat(network_name=response[1])
3140
 
        repo_format = response_tuple_to_repo_format(response[3:])
3141
 
        repo_path = response[2]
3142
 
        if repository is not None:
3143
 
            remote_repo_url = urlutils.join(a_bzrdir.user_url, repo_path)
3144
 
            url_diff = urlutils.relative_url(repository.user_url,
3145
 
                    remote_repo_url)
3146
 
            if url_diff != '.':
3147
 
                raise AssertionError(
3148
 
                    'repository.user_url %r does not match URL from server '
3149
 
                    'response (%r + %r)'
3150
 
                    % (repository.user_url, a_bzrdir.user_url, repo_path))
3151
 
            remote_repo = repository
3152
 
        else:
3153
 
            if repo_path == '':
3154
 
                repo_bzrdir = a_bzrdir
3155
 
            else:
3156
 
                repo_bzrdir = RemoteBzrDir(
3157
 
                    a_bzrdir.root_transport.clone(repo_path), a_bzrdir._format,
3158
 
                    a_bzrdir._client)
3159
 
            remote_repo = RemoteRepository(repo_bzrdir, repo_format)
3160
 
        remote_branch = RemoteBranch(a_bzrdir, remote_repo,
3161
 
            format=format, setup_stacking=False, name=name)
3162
 
        if append_revisions_only:
3163
 
            remote_branch.set_append_revisions_only(append_revisions_only)
3164
 
        # XXX: We know this is a new branch, so it must have revno 0, revid
3165
 
        # NULL_REVISION. Creating the branch locked would make this be unable
3166
 
        # to be wrong; here its simply very unlikely to be wrong. RBC 20090225
3167
 
        remote_branch._last_revision_info_cache = 0, NULL_REVISION
3168
 
        return remote_branch
3169
 
 
3170
 
    def make_tags(self, branch):
3171
 
        self._ensure_real()
3172
 
        return self._custom_format.make_tags(branch)
3173
 
 
3174
 
    def supports_tags(self):
3175
 
        # Remote branches might support tags, but we won't know until we
3176
 
        # access the real remote branch.
3177
 
        self._ensure_real()
3178
 
        return self._custom_format.supports_tags()
3179
 
 
3180
 
    def supports_stacking(self):
3181
 
        self._ensure_real()
3182
 
        return self._custom_format.supports_stacking()
3183
 
 
3184
 
    def supports_set_append_revisions_only(self):
3185
 
        self._ensure_real()
3186
 
        return self._custom_format.supports_set_append_revisions_only()
3187
 
 
3188
 
    def _use_default_local_heads_to_fetch(self):
3189
 
        # If the branch format is a metadir format *and* its heads_to_fetch
3190
 
        # implementation is not overridden vs the base class, we can use the
3191
 
        # base class logic rather than use the heads_to_fetch RPC.  This is
3192
 
        # usually cheaper in terms of net round trips, as the last-revision and
3193
 
        # tags info fetched is cached and would be fetched anyway.
3194
 
        self._ensure_real()
3195
 
        if isinstance(self._custom_format, branch.BranchFormatMetadir):
3196
 
            branch_class = self._custom_format._branch_class()
3197
 
            heads_to_fetch_impl = branch_class.heads_to_fetch.im_func
3198
 
            if heads_to_fetch_impl is branch.Branch.heads_to_fetch.im_func:
3199
 
                return True
3200
 
        return False
3201
 
 
3202
 
 
3203
 
class RemoteBranchStore(_mod_config.IniFileStore):
3204
 
    """Branch store which attempts to use HPSS calls to retrieve branch store.
3205
 
 
3206
 
    Note that this is specific to bzr-based formats.
3207
 
    """
3208
 
 
3209
 
    def __init__(self, branch):
3210
 
        super(RemoteBranchStore, self).__init__()
3211
 
        self.branch = branch
3212
 
        self.id = "branch"
3213
 
        self._real_store = None
3214
 
 
3215
 
    def lock_write(self, token=None):
3216
 
        return self.branch.lock_write(token)
3217
 
 
3218
 
    def unlock(self):
3219
 
        return self.branch.unlock()
3220
 
 
3221
 
    @needs_write_lock
3222
 
    def save(self):
3223
 
        # We need to be able to override the undecorated implementation
3224
 
        self.save_without_locking()
3225
 
 
3226
 
    def save_without_locking(self):
3227
 
        super(RemoteBranchStore, self).save()
3228
 
 
3229
 
    def external_url(self):
3230
 
        return self.branch.user_url
3231
 
 
3232
 
    def _load_content(self):
3233
 
        path = self.branch._remote_path()
3234
 
        try:
3235
 
            response, handler = self.branch._call_expecting_body(
3236
 
                'Branch.get_config_file', path)
3237
 
        except errors.UnknownSmartMethod:
3238
 
            self._ensure_real()
3239
 
            return self._real_store._load_content()
3240
 
        if len(response) and response[0] != 'ok':
3241
 
            raise errors.UnexpectedSmartServerResponse(response)
3242
 
        return handler.read_body_bytes()
3243
 
 
3244
 
    def _save_content(self, content):
3245
 
        path = self.branch._remote_path()
3246
 
        try:
3247
 
            response, handler = self.branch._call_with_body_bytes_expecting_body(
3248
 
                'Branch.put_config_file', (path,
3249
 
                    self.branch._lock_token, self.branch._repo_lock_token),
3250
 
                content)
3251
 
        except errors.UnknownSmartMethod:
3252
 
            self._ensure_real()
3253
 
            return self._real_store._save_content(content)
3254
 
        handler.cancel_read_body()
3255
 
        if response != ('ok', ):
3256
 
            raise errors.UnexpectedSmartServerResponse(response)
3257
 
 
3258
 
    def _ensure_real(self):
3259
 
        self.branch._ensure_real()
3260
 
        if self._real_store is None:
3261
 
            self._real_store = _mod_config.BranchStore(self.branch)
3262
 
 
3263
 
 
3264
 
class RemoteBranch(branch.Branch, _RpcHelper, lock._RelockDebugMixin):
3265
 
    """Branch stored on a server accessed by HPSS RPC.
3266
 
 
3267
 
    At the moment most operations are mapped down to simple file operations.
3268
 
    """
3269
 
 
3270
 
    def __init__(self, remote_bzrdir, remote_repository, real_branch=None,
3271
 
        _client=None, format=None, setup_stacking=True, name=None,
3272
 
        possible_transports=None):
3273
 
        """Create a RemoteBranch instance.
3274
 
 
3275
 
        :param real_branch: An optional local implementation of the branch
3276
 
            format, usually accessing the data via the VFS.
3277
 
        :param _client: Private parameter for testing.
3278
 
        :param format: A RemoteBranchFormat object, None to create one
3279
 
            automatically. If supplied it should have a network_name already
3280
 
            supplied.
3281
 
        :param setup_stacking: If True make an RPC call to determine the
3282
 
            stacked (or not) status of the branch. If False assume the branch
3283
 
            is not stacked.
3284
 
        :param name: Colocated branch name
3285
 
        """
3286
 
        # We intentionally don't call the parent class's __init__, because it
3287
 
        # will try to assign to self.tags, which is a property in this subclass.
3288
 
        # And the parent's __init__ doesn't do much anyway.
3289
 
        self.bzrdir = remote_bzrdir
3290
 
        if _client is not None:
3291
 
            self._client = _client
3292
 
        else:
3293
 
            self._client = remote_bzrdir._client
3294
 
        self.repository = remote_repository
3295
 
        if real_branch is not None:
3296
 
            self._real_branch = real_branch
3297
 
            # Give the remote repository the matching real repo.
3298
 
            real_repo = self._real_branch.repository
3299
 
            if isinstance(real_repo, RemoteRepository):
3300
 
                real_repo._ensure_real()
3301
 
                real_repo = real_repo._real_repository
3302
 
            self.repository._set_real_repository(real_repo)
3303
 
            # Give the branch the remote repository to let fast-pathing happen.
3304
 
            self._real_branch.repository = self.repository
3305
 
        else:
3306
 
            self._real_branch = None
3307
 
        # Fill out expected attributes of branch for bzrlib API users.
3308
 
        self._clear_cached_state()
3309
 
        # TODO: deprecate self.base in favor of user_url
3310
 
        self.base = self.bzrdir.user_url
3311
 
        self._name = name
3312
 
        self._control_files = None
3313
 
        self._lock_mode = None
3314
 
        self._lock_token = None
3315
 
        self._repo_lock_token = None
3316
 
        self._lock_count = 0
3317
 
        self._leave_lock = False
3318
 
        # Setup a format: note that we cannot call _ensure_real until all the
3319
 
        # attributes above are set: This code cannot be moved higher up in this
3320
 
        # function.
3321
 
        if format is None:
3322
 
            self._format = RemoteBranchFormat()
3323
 
            if real_branch is not None:
3324
 
                self._format._network_name = \
3325
 
                    self._real_branch._format.network_name()
3326
 
        else:
3327
 
            self._format = format
3328
 
        # when we do _ensure_real we may need to pass ignore_fallbacks to the
3329
 
        # branch.open_branch method.
3330
 
        self._real_ignore_fallbacks = not setup_stacking
3331
 
        if not self._format._network_name:
3332
 
            # Did not get from open_branchV2 - old server.
3333
 
            self._ensure_real()
3334
 
            self._format._network_name = \
3335
 
                self._real_branch._format.network_name()
3336
 
        self.tags = self._format.make_tags(self)
3337
 
        # The base class init is not called, so we duplicate this:
3338
 
        hooks = branch.Branch.hooks['open']
3339
 
        for hook in hooks:
3340
 
            hook(self)
3341
 
        self._is_stacked = False
3342
 
        if setup_stacking:
3343
 
            self._setup_stacking(possible_transports)
3344
 
 
3345
 
    def _setup_stacking(self, possible_transports):
3346
 
        # configure stacking into the remote repository, by reading it from
3347
 
        # the vfs branch.
3348
 
        try:
3349
 
            fallback_url = self.get_stacked_on_url()
3350
 
        except (errors.NotStacked, errors.UnstackableBranchFormat,
3351
 
            errors.UnstackableRepositoryFormat), e:
3352
 
            return
3353
 
        self._is_stacked = True
3354
 
        if possible_transports is None:
3355
 
            possible_transports = []
3356
 
        else:
3357
 
            possible_transports = list(possible_transports)
3358
 
        possible_transports.append(self.bzrdir.root_transport)
3359
 
        self._activate_fallback_location(fallback_url,
3360
 
            possible_transports=possible_transports)
3361
 
 
3362
 
    def _get_config(self):
3363
 
        return RemoteBranchConfig(self)
3364
 
 
3365
 
    def _get_config_store(self):
3366
 
        return RemoteBranchStore(self)
3367
 
 
3368
 
    def _get_real_transport(self):
3369
 
        # if we try vfs access, return the real branch's vfs transport
3370
 
        self._ensure_real()
3371
 
        return self._real_branch._transport
3372
 
 
3373
 
    _transport = property(_get_real_transport)
3374
 
 
3375
 
    def __str__(self):
3376
 
        return "%s(%s)" % (self.__class__.__name__, self.base)
3377
 
 
3378
 
    __repr__ = __str__
3379
 
 
3380
 
    def _ensure_real(self):
3381
 
        """Ensure that there is a _real_branch set.
3382
 
 
3383
 
        Used before calls to self._real_branch.
3384
 
        """
3385
 
        if self._real_branch is None:
3386
 
            if not vfs.vfs_enabled():
3387
 
                raise AssertionError('smart server vfs must be enabled '
3388
 
                    'to use vfs implementation')
3389
 
            self.bzrdir._ensure_real()
3390
 
            self._real_branch = self.bzrdir._real_bzrdir.open_branch(
3391
 
                ignore_fallbacks=self._real_ignore_fallbacks, name=self._name)
3392
 
            if self.repository._real_repository is None:
3393
 
                # Give the remote repository the matching real repo.
3394
 
                real_repo = self._real_branch.repository
3395
 
                if isinstance(real_repo, RemoteRepository):
3396
 
                    real_repo._ensure_real()
3397
 
                    real_repo = real_repo._real_repository
3398
 
                self.repository._set_real_repository(real_repo)
3399
 
            # Give the real branch the remote repository to let fast-pathing
3400
 
            # happen.
3401
 
            self._real_branch.repository = self.repository
3402
 
            if self._lock_mode == 'r':
3403
 
                self._real_branch.lock_read()
3404
 
            elif self._lock_mode == 'w':
3405
 
                self._real_branch.lock_write(token=self._lock_token)
3406
 
 
3407
 
    def _translate_error(self, err, **context):
3408
 
        self.repository._translate_error(err, branch=self, **context)
3409
 
 
3410
 
    def _clear_cached_state(self):
3411
 
        super(RemoteBranch, self)._clear_cached_state()
3412
 
        if self._real_branch is not None:
3413
 
            self._real_branch._clear_cached_state()
3414
 
 
3415
 
    def _clear_cached_state_of_remote_branch_only(self):
3416
 
        """Like _clear_cached_state, but doesn't clear the cache of
3417
 
        self._real_branch.
3418
 
 
3419
 
        This is useful when falling back to calling a method of
3420
 
        self._real_branch that changes state.  In that case the underlying
3421
 
        branch changes, so we need to invalidate this RemoteBranch's cache of
3422
 
        it.  However, there's no need to invalidate the _real_branch's cache
3423
 
        too, in fact doing so might harm performance.
3424
 
        """
3425
 
        super(RemoteBranch, self)._clear_cached_state()
3426
 
 
3427
 
    @property
3428
 
    def control_files(self):
3429
 
        # Defer actually creating RemoteBranchLockableFiles until its needed,
3430
 
        # because it triggers an _ensure_real that we otherwise might not need.
3431
 
        if self._control_files is None:
3432
 
            self._control_files = RemoteBranchLockableFiles(
3433
 
                self.bzrdir, self._client)
3434
 
        return self._control_files
3435
 
 
3436
 
    def get_physical_lock_status(self):
3437
 
        """See Branch.get_physical_lock_status()."""
3438
 
        try:
3439
 
            response = self._client.call('Branch.get_physical_lock_status',
3440
 
                self._remote_path())
3441
 
        except errors.UnknownSmartMethod:
3442
 
            self._ensure_real()
3443
 
            return self._real_branch.get_physical_lock_status()
3444
 
        if response[0] not in ('yes', 'no'):
3445
 
            raise errors.UnexpectedSmartServerResponse(response)
3446
 
        return (response[0] == 'yes')
3447
 
 
3448
 
    def get_stacked_on_url(self):
3449
 
        """Get the URL this branch is stacked against.
3450
 
 
3451
 
        :raises NotStacked: If the branch is not stacked.
3452
 
        :raises UnstackableBranchFormat: If the branch does not support
3453
 
            stacking.
3454
 
        :raises UnstackableRepositoryFormat: If the repository does not support
3455
 
            stacking.
3456
 
        """
3457
 
        try:
3458
 
            # there may not be a repository yet, so we can't use
3459
 
            # self._translate_error, so we can't use self._call either.
3460
 
            response = self._client.call('Branch.get_stacked_on_url',
3461
 
                self._remote_path())
3462
 
        except errors.ErrorFromSmartServer, err:
3463
 
            # there may not be a repository yet, so we can't call through
3464
 
            # its _translate_error
3465
 
            _translate_error(err, branch=self)
3466
 
        except errors.UnknownSmartMethod, err:
3467
 
            self._ensure_real()
3468
 
            return self._real_branch.get_stacked_on_url()
3469
 
        if response[0] != 'ok':
3470
 
            raise errors.UnexpectedSmartServerResponse(response)
3471
 
        return response[1]
3472
 
 
3473
 
    def set_stacked_on_url(self, url):
3474
 
        branch.Branch.set_stacked_on_url(self, url)
3475
 
        if not url:
3476
 
            self._is_stacked = False
3477
 
        else:
3478
 
            self._is_stacked = True
3479
 
 
3480
 
    def _vfs_get_tags_bytes(self):
3481
 
        self._ensure_real()
3482
 
        return self._real_branch._get_tags_bytes()
3483
 
 
3484
 
    @needs_read_lock
3485
 
    def _get_tags_bytes(self):
3486
 
        if self._tags_bytes is None:
3487
 
            self._tags_bytes = self._get_tags_bytes_via_hpss()
3488
 
        return self._tags_bytes
3489
 
 
3490
 
    def _get_tags_bytes_via_hpss(self):
3491
 
        medium = self._client._medium
3492
 
        if medium._is_remote_before((1, 13)):
3493
 
            return self._vfs_get_tags_bytes()
3494
 
        try:
3495
 
            response = self._call('Branch.get_tags_bytes', self._remote_path())
3496
 
        except errors.UnknownSmartMethod:
3497
 
            medium._remember_remote_is_before((1, 13))
3498
 
            return self._vfs_get_tags_bytes()
3499
 
        return response[0]
3500
 
 
3501
 
    def _vfs_set_tags_bytes(self, bytes):
3502
 
        self._ensure_real()
3503
 
        return self._real_branch._set_tags_bytes(bytes)
3504
 
 
3505
 
    def _set_tags_bytes(self, bytes):
3506
 
        if self.is_locked():
3507
 
            self._tags_bytes = bytes
3508
 
        medium = self._client._medium
3509
 
        if medium._is_remote_before((1, 18)):
3510
 
            self._vfs_set_tags_bytes(bytes)
3511
 
            return
3512
 
        try:
3513
 
            args = (
3514
 
                self._remote_path(), self._lock_token, self._repo_lock_token)
3515
 
            response = self._call_with_body_bytes(
3516
 
                'Branch.set_tags_bytes', args, bytes)
3517
 
        except errors.UnknownSmartMethod:
3518
 
            medium._remember_remote_is_before((1, 18))
3519
 
            self._vfs_set_tags_bytes(bytes)
3520
 
 
3521
 
    def lock_read(self):
3522
 
        """Lock the branch for read operations.
3523
 
 
3524
 
        :return: A bzrlib.lock.LogicalLockResult.
3525
 
        """
3526
 
        self.repository.lock_read()
3527
 
        if not self._lock_mode:
3528
 
            self._note_lock('r')
3529
 
            self._lock_mode = 'r'
3530
 
            self._lock_count = 1
3531
 
            if self._real_branch is not None:
3532
 
                self._real_branch.lock_read()
3533
 
        else:
3534
 
            self._lock_count += 1
3535
 
        return lock.LogicalLockResult(self.unlock)
3536
 
 
3537
 
    def _remote_lock_write(self, token):
3538
 
        if token is None:
3539
 
            branch_token = repo_token = ''
3540
 
        else:
3541
 
            branch_token = token
3542
 
            repo_token = self.repository.lock_write().repository_token
3543
 
            self.repository.unlock()
3544
 
        err_context = {'token': token}
3545
 
        try:
3546
 
            response = self._call(
3547
 
                'Branch.lock_write', self._remote_path(), branch_token,
3548
 
                repo_token or '', **err_context)
3549
 
        except errors.LockContention, e:
3550
 
            # The LockContention from the server doesn't have any
3551
 
            # information about the lock_url. We re-raise LockContention
3552
 
            # with valid lock_url.
3553
 
            raise errors.LockContention('(remote lock)',
3554
 
                self.repository.base.split('.bzr/')[0])
3555
 
        if response[0] != 'ok':
3556
 
            raise errors.UnexpectedSmartServerResponse(response)
3557
 
        ok, branch_token, repo_token = response
3558
 
        return branch_token, repo_token
3559
 
 
3560
 
    def lock_write(self, token=None):
3561
 
        if not self._lock_mode:
3562
 
            self._note_lock('w')
3563
 
            # Lock the branch and repo in one remote call.
3564
 
            remote_tokens = self._remote_lock_write(token)
3565
 
            self._lock_token, self._repo_lock_token = remote_tokens
3566
 
            if not self._lock_token:
3567
 
                raise SmartProtocolError('Remote server did not return a token!')
3568
 
            # Tell the self.repository object that it is locked.
3569
 
            self.repository.lock_write(
3570
 
                self._repo_lock_token, _skip_rpc=True)
3571
 
 
3572
 
            if self._real_branch is not None:
3573
 
                self._real_branch.lock_write(token=self._lock_token)
3574
 
            if token is not None:
3575
 
                self._leave_lock = True
3576
 
            else:
3577
 
                self._leave_lock = False
3578
 
            self._lock_mode = 'w'
3579
 
            self._lock_count = 1
3580
 
        elif self._lock_mode == 'r':
3581
 
            raise errors.ReadOnlyError(self)
3582
 
        else:
3583
 
            if token is not None:
3584
 
                # A token was given to lock_write, and we're relocking, so
3585
 
                # check that the given token actually matches the one we
3586
 
                # already have.
3587
 
                if token != self._lock_token:
3588
 
                    raise errors.TokenMismatch(token, self._lock_token)
3589
 
            self._lock_count += 1
3590
 
            # Re-lock the repository too.
3591
 
            self.repository.lock_write(self._repo_lock_token)
3592
 
        return BranchWriteLockResult(self.unlock, self._lock_token or None)
3593
 
 
3594
 
    def _unlock(self, branch_token, repo_token):
3595
 
        err_context = {'token': str((branch_token, repo_token))}
3596
 
        response = self._call(
3597
 
            'Branch.unlock', self._remote_path(), branch_token,
3598
 
            repo_token or '', **err_context)
3599
 
        if response == ('ok',):
3600
 
            return
3601
 
        raise errors.UnexpectedSmartServerResponse(response)
3602
 
 
3603
 
    @only_raises(errors.LockNotHeld, errors.LockBroken)
3604
 
    def unlock(self):
3605
 
        try:
3606
 
            self._lock_count -= 1
3607
 
            if not self._lock_count:
3608
 
                self._clear_cached_state()
3609
 
                mode = self._lock_mode
3610
 
                self._lock_mode = None
3611
 
                if self._real_branch is not None:
3612
 
                    if (not self._leave_lock and mode == 'w' and
3613
 
                        self._repo_lock_token):
3614
 
                        # If this RemoteBranch will remove the physical lock
3615
 
                        # for the repository, make sure the _real_branch
3616
 
                        # doesn't do it first.  (Because the _real_branch's
3617
 
                        # repository is set to be the RemoteRepository.)
3618
 
                        self._real_branch.repository.leave_lock_in_place()
3619
 
                    self._real_branch.unlock()
3620
 
                if mode != 'w':
3621
 
                    # Only write-locked branched need to make a remote method
3622
 
                    # call to perform the unlock.
3623
 
                    return
3624
 
                if not self._lock_token:
3625
 
                    raise AssertionError('Locked, but no token!')
3626
 
                branch_token = self._lock_token
3627
 
                repo_token = self._repo_lock_token
3628
 
                self._lock_token = None
3629
 
                self._repo_lock_token = None
3630
 
                if not self._leave_lock:
3631
 
                    self._unlock(branch_token, repo_token)
3632
 
        finally:
3633
 
            self.repository.unlock()
3634
 
 
3635
 
    def break_lock(self):
3636
 
        try:
3637
 
            response = self._call(
3638
 
                'Branch.break_lock', self._remote_path())
3639
 
        except errors.UnknownSmartMethod:
3640
 
            self._ensure_real()
3641
 
            return self._real_branch.break_lock()
3642
 
        if response != ('ok',):
3643
 
            raise errors.UnexpectedSmartServerResponse(response)
3644
 
 
3645
 
    def leave_lock_in_place(self):
3646
 
        if not self._lock_token:
3647
 
            raise NotImplementedError(self.leave_lock_in_place)
3648
 
        self._leave_lock = True
3649
 
 
3650
 
    def dont_leave_lock_in_place(self):
3651
 
        if not self._lock_token:
3652
 
            raise NotImplementedError(self.dont_leave_lock_in_place)
3653
 
        self._leave_lock = False
3654
 
 
3655
 
    @needs_read_lock
3656
 
    def get_rev_id(self, revno, history=None):
3657
 
        if revno == 0:
3658
 
            return _mod_revision.NULL_REVISION
3659
 
        last_revision_info = self.last_revision_info()
3660
 
        ok, result = self.repository.get_rev_id_for_revno(
3661
 
            revno, last_revision_info)
3662
 
        if ok:
3663
 
            return result
3664
 
        missing_parent = result[1]
3665
 
        # Either the revision named by the server is missing, or its parent
3666
 
        # is.  Call get_parent_map to determine which, so that we report a
3667
 
        # useful error.
3668
 
        parent_map = self.repository.get_parent_map([missing_parent])
3669
 
        if missing_parent in parent_map:
3670
 
            missing_parent = parent_map[missing_parent]
3671
 
        raise errors.RevisionNotPresent(missing_parent, self.repository)
3672
 
 
3673
 
    def _read_last_revision_info(self):
3674
 
        response = self._call('Branch.last_revision_info', self._remote_path())
3675
 
        if response[0] != 'ok':
3676
 
            raise SmartProtocolError('unexpected response code %s' % (response,))
3677
 
        revno = int(response[1])
3678
 
        last_revision = response[2]
3679
 
        return (revno, last_revision)
3680
 
 
3681
 
    def _gen_revision_history(self):
3682
 
        """See Branch._gen_revision_history()."""
3683
 
        if self._is_stacked:
3684
 
            self._ensure_real()
3685
 
            return self._real_branch._gen_revision_history()
3686
 
        response_tuple, response_handler = self._call_expecting_body(
3687
 
            'Branch.revision_history', self._remote_path())
3688
 
        if response_tuple[0] != 'ok':
3689
 
            raise errors.UnexpectedSmartServerResponse(response_tuple)
3690
 
        result = response_handler.read_body_bytes().split('\x00')
3691
 
        if result == ['']:
3692
 
            return []
3693
 
        return result
3694
 
 
3695
 
    def _remote_path(self):
3696
 
        return self.bzrdir._path_for_remote_call(self._client)
3697
 
 
3698
 
    def _set_last_revision_descendant(self, revision_id, other_branch,
3699
 
            allow_diverged=False, allow_overwrite_descendant=False):
3700
 
        # This performs additional work to meet the hook contract; while its
3701
 
        # undesirable, we have to synthesise the revno to call the hook, and
3702
 
        # not calling the hook is worse as it means changes can't be prevented.
3703
 
        # Having calculated this though, we can't just call into
3704
 
        # set_last_revision_info as a simple call, because there is a set_rh
3705
 
        # hook that some folk may still be using.
3706
 
        old_revno, old_revid = self.last_revision_info()
3707
 
        history = self._lefthand_history(revision_id)
3708
 
        self._run_pre_change_branch_tip_hooks(len(history), revision_id)
3709
 
        err_context = {'other_branch': other_branch}
3710
 
        response = self._call('Branch.set_last_revision_ex',
3711
 
            self._remote_path(), self._lock_token, self._repo_lock_token,
3712
 
            revision_id, int(allow_diverged), int(allow_overwrite_descendant),
3713
 
            **err_context)
3714
 
        self._clear_cached_state()
3715
 
        if len(response) != 3 and response[0] != 'ok':
3716
 
            raise errors.UnexpectedSmartServerResponse(response)
3717
 
        new_revno, new_revision_id = response[1:]
3718
 
        self._last_revision_info_cache = new_revno, new_revision_id
3719
 
        self._run_post_change_branch_tip_hooks(old_revno, old_revid)
3720
 
        if self._real_branch is not None:
3721
 
            cache = new_revno, new_revision_id
3722
 
            self._real_branch._last_revision_info_cache = cache
3723
 
 
3724
 
    def _set_last_revision(self, revision_id):
3725
 
        old_revno, old_revid = self.last_revision_info()
3726
 
        # This performs additional work to meet the hook contract; while its
3727
 
        # undesirable, we have to synthesise the revno to call the hook, and
3728
 
        # not calling the hook is worse as it means changes can't be prevented.
3729
 
        # Having calculated this though, we can't just call into
3730
 
        # set_last_revision_info as a simple call, because there is a set_rh
3731
 
        # hook that some folk may still be using.
3732
 
        history = self._lefthand_history(revision_id)
3733
 
        self._run_pre_change_branch_tip_hooks(len(history), revision_id)
3734
 
        self._clear_cached_state()
3735
 
        response = self._call('Branch.set_last_revision',
3736
 
            self._remote_path(), self._lock_token, self._repo_lock_token,
3737
 
            revision_id)
3738
 
        if response != ('ok',):
3739
 
            raise errors.UnexpectedSmartServerResponse(response)
3740
 
        self._run_post_change_branch_tip_hooks(old_revno, old_revid)
3741
 
 
3742
 
    @symbol_versioning.deprecated_method(symbol_versioning.deprecated_in((2, 4, 0)))
3743
 
    @needs_write_lock
3744
 
    def set_revision_history(self, rev_history):
3745
 
        """See Branch.set_revision_history."""
3746
 
        self._set_revision_history(rev_history)
3747
 
 
3748
 
    @needs_write_lock
3749
 
    def _set_revision_history(self, rev_history):
3750
 
        # Send just the tip revision of the history; the server will generate
3751
 
        # the full history from that.  If the revision doesn't exist in this
3752
 
        # branch, NoSuchRevision will be raised.
3753
 
        if rev_history == []:
3754
 
            rev_id = 'null:'
3755
 
        else:
3756
 
            rev_id = rev_history[-1]
3757
 
        self._set_last_revision(rev_id)
3758
 
        for hook in branch.Branch.hooks['set_rh']:
3759
 
            hook(self, rev_history)
3760
 
        self._cache_revision_history(rev_history)
3761
 
 
3762
 
    def _get_parent_location(self):
3763
 
        medium = self._client._medium
3764
 
        if medium._is_remote_before((1, 13)):
3765
 
            return self._vfs_get_parent_location()
3766
 
        try:
3767
 
            response = self._call('Branch.get_parent', self._remote_path())
3768
 
        except errors.UnknownSmartMethod:
3769
 
            medium._remember_remote_is_before((1, 13))
3770
 
            return self._vfs_get_parent_location()
3771
 
        if len(response) != 1:
3772
 
            raise errors.UnexpectedSmartServerResponse(response)
3773
 
        parent_location = response[0]
3774
 
        if parent_location == '':
3775
 
            return None
3776
 
        return parent_location
3777
 
 
3778
 
    def _vfs_get_parent_location(self):
3779
 
        self._ensure_real()
3780
 
        return self._real_branch._get_parent_location()
3781
 
 
3782
 
    def _set_parent_location(self, url):
3783
 
        medium = self._client._medium
3784
 
        if medium._is_remote_before((1, 15)):
3785
 
            return self._vfs_set_parent_location(url)
3786
 
        try:
3787
 
            call_url = url or ''
3788
 
            if type(call_url) is not str:
3789
 
                raise AssertionError('url must be a str or None (%s)' % url)
3790
 
            response = self._call('Branch.set_parent_location',
3791
 
                self._remote_path(), self._lock_token, self._repo_lock_token,
3792
 
                call_url)
3793
 
        except errors.UnknownSmartMethod:
3794
 
            medium._remember_remote_is_before((1, 15))
3795
 
            return self._vfs_set_parent_location(url)
3796
 
        if response != ():
3797
 
            raise errors.UnexpectedSmartServerResponse(response)
3798
 
 
3799
 
    def _vfs_set_parent_location(self, url):
3800
 
        self._ensure_real()
3801
 
        return self._real_branch._set_parent_location(url)
3802
 
 
3803
 
    @needs_write_lock
3804
 
    def pull(self, source, overwrite=False, stop_revision=None,
3805
 
             **kwargs):
3806
 
        self._clear_cached_state_of_remote_branch_only()
3807
 
        self._ensure_real()
3808
 
        return self._real_branch.pull(
3809
 
            source, overwrite=overwrite, stop_revision=stop_revision,
3810
 
            _override_hook_target=self, **kwargs)
3811
 
 
3812
 
    @needs_read_lock
3813
 
    def push(self, target, overwrite=False, stop_revision=None, lossy=False):
3814
 
        self._ensure_real()
3815
 
        return self._real_branch.push(
3816
 
            target, overwrite=overwrite, stop_revision=stop_revision, lossy=lossy,
3817
 
            _override_hook_source_branch=self)
3818
 
 
3819
 
    def is_locked(self):
3820
 
        return self._lock_count >= 1
3821
 
 
3822
 
    @needs_read_lock
3823
 
    def revision_id_to_dotted_revno(self, revision_id):
3824
 
        """Given a revision id, return its dotted revno.
3825
 
 
3826
 
        :return: a tuple like (1,) or (400,1,3).
3827
 
        """
3828
 
        try:
3829
 
            response = self._call('Branch.revision_id_to_revno',
3830
 
                self._remote_path(), revision_id)
3831
 
        except errors.UnknownSmartMethod:
3832
 
            self._ensure_real()
3833
 
            return self._real_branch.revision_id_to_dotted_revno(revision_id)
3834
 
        if response[0] == 'ok':
3835
 
            return tuple([int(x) for x in response[1:]])
3836
 
        else:
3837
 
            raise errors.UnexpectedSmartServerResponse(response)
3838
 
 
3839
 
    @needs_read_lock
3840
 
    def revision_id_to_revno(self, revision_id):
3841
 
        """Given a revision id on the branch mainline, return its revno.
3842
 
 
3843
 
        :return: an integer
3844
 
        """
3845
 
        try:
3846
 
            response = self._call('Branch.revision_id_to_revno',
3847
 
                self._remote_path(), revision_id)
3848
 
        except errors.UnknownSmartMethod:
3849
 
            self._ensure_real()
3850
 
            return self._real_branch.revision_id_to_revno(revision_id)
3851
 
        if response[0] == 'ok':
3852
 
            if len(response) == 2:
3853
 
                return int(response[1])
3854
 
            raise NoSuchRevision(self, revision_id)
3855
 
        else:
3856
 
            raise errors.UnexpectedSmartServerResponse(response)
3857
 
 
3858
 
    @needs_write_lock
3859
 
    def set_last_revision_info(self, revno, revision_id):
3860
 
        # XXX: These should be returned by the set_last_revision_info verb
3861
 
        old_revno, old_revid = self.last_revision_info()
3862
 
        self._run_pre_change_branch_tip_hooks(revno, revision_id)
3863
 
        if not revision_id or not isinstance(revision_id, basestring):
3864
 
            raise errors.InvalidRevisionId(revision_id=revision_id, branch=self)
3865
 
        try:
3866
 
            response = self._call('Branch.set_last_revision_info',
3867
 
                self._remote_path(), self._lock_token, self._repo_lock_token,
3868
 
                str(revno), revision_id)
3869
 
        except errors.UnknownSmartMethod:
3870
 
            self._ensure_real()
3871
 
            self._clear_cached_state_of_remote_branch_only()
3872
 
            self._real_branch.set_last_revision_info(revno, revision_id)
3873
 
            self._last_revision_info_cache = revno, revision_id
3874
 
            return
3875
 
        if response == ('ok',):
3876
 
            self._clear_cached_state()
3877
 
            self._last_revision_info_cache = revno, revision_id
3878
 
            self._run_post_change_branch_tip_hooks(old_revno, old_revid)
3879
 
            # Update the _real_branch's cache too.
3880
 
            if self._real_branch is not None:
3881
 
                cache = self._last_revision_info_cache
3882
 
                self._real_branch._last_revision_info_cache = cache
3883
 
        else:
3884
 
            raise errors.UnexpectedSmartServerResponse(response)
3885
 
 
3886
 
    @needs_write_lock
3887
 
    def generate_revision_history(self, revision_id, last_rev=None,
3888
 
                                  other_branch=None):
3889
 
        medium = self._client._medium
3890
 
        if not medium._is_remote_before((1, 6)):
3891
 
            # Use a smart method for 1.6 and above servers
3892
 
            try:
3893
 
                self._set_last_revision_descendant(revision_id, other_branch,
3894
 
                    allow_diverged=True, allow_overwrite_descendant=True)
3895
 
                return
3896
 
            except errors.UnknownSmartMethod:
3897
 
                medium._remember_remote_is_before((1, 6))
3898
 
        self._clear_cached_state_of_remote_branch_only()
3899
 
        self._set_revision_history(self._lefthand_history(revision_id,
3900
 
            last_rev=last_rev,other_branch=other_branch))
3901
 
 
3902
 
    def set_push_location(self, location):
3903
 
        self._ensure_real()
3904
 
        return self._real_branch.set_push_location(location)
3905
 
 
3906
 
    def heads_to_fetch(self):
3907
 
        if self._format._use_default_local_heads_to_fetch():
3908
 
            # We recognise this format, and its heads-to-fetch implementation
3909
 
            # is the default one (tip + tags).  In this case it's cheaper to
3910
 
            # just use the default implementation rather than a special RPC as
3911
 
            # the tip and tags data is cached.
3912
 
            return branch.Branch.heads_to_fetch(self)
3913
 
        medium = self._client._medium
3914
 
        if medium._is_remote_before((2, 4)):
3915
 
            return self._vfs_heads_to_fetch()
3916
 
        try:
3917
 
            return self._rpc_heads_to_fetch()
3918
 
        except errors.UnknownSmartMethod:
3919
 
            medium._remember_remote_is_before((2, 4))
3920
 
            return self._vfs_heads_to_fetch()
3921
 
 
3922
 
    def _rpc_heads_to_fetch(self):
3923
 
        response = self._call('Branch.heads_to_fetch', self._remote_path())
3924
 
        if len(response) != 2:
3925
 
            raise errors.UnexpectedSmartServerResponse(response)
3926
 
        must_fetch, if_present_fetch = response
3927
 
        return set(must_fetch), set(if_present_fetch)
3928
 
 
3929
 
    def _vfs_heads_to_fetch(self):
3930
 
        self._ensure_real()
3931
 
        return self._real_branch.heads_to_fetch()
3932
 
 
3933
 
 
3934
 
class RemoteConfig(object):
3935
 
    """A Config that reads and writes from smart verbs.
3936
 
 
3937
 
    It is a low-level object that considers config data to be name/value pairs
3938
 
    that may be associated with a section. Assigning meaning to the these
3939
 
    values is done at higher levels like bzrlib.config.TreeConfig.
3940
 
    """
3941
 
 
3942
 
    def get_option(self, name, section=None, default=None):
3943
 
        """Return the value associated with a named option.
3944
 
 
3945
 
        :param name: The name of the value
3946
 
        :param section: The section the option is in (if any)
3947
 
        :param default: The value to return if the value is not set
3948
 
        :return: The value or default value
3949
 
        """
3950
 
        try:
3951
 
            configobj = self._get_configobj()
3952
 
            section_obj = None
3953
 
            if section is None:
3954
 
                section_obj = configobj
3955
 
            else:
3956
 
                try:
3957
 
                    section_obj = configobj[section]
3958
 
                except KeyError:
3959
 
                    pass
3960
 
            if section_obj is None:
3961
 
                value = default
3962
 
            else:
3963
 
                value = section_obj.get(name, default)
3964
 
        except errors.UnknownSmartMethod:
3965
 
            value = self._vfs_get_option(name, section, default)
3966
 
        for hook in _mod_config.OldConfigHooks['get']:
3967
 
            hook(self, name, value)
3968
 
        return value
3969
 
 
3970
 
    def _response_to_configobj(self, response):
3971
 
        if len(response[0]) and response[0][0] != 'ok':
3972
 
            raise errors.UnexpectedSmartServerResponse(response)
3973
 
        lines = response[1].read_body_bytes().splitlines()
3974
 
        conf = _mod_config.ConfigObj(lines, encoding='utf-8')
3975
 
        for hook in _mod_config.OldConfigHooks['load']:
3976
 
            hook(self)
3977
 
        return conf
3978
 
 
3979
 
 
3980
 
class RemoteBranchConfig(RemoteConfig):
3981
 
    """A RemoteConfig for Branches."""
3982
 
 
3983
 
    def __init__(self, branch):
3984
 
        self._branch = branch
3985
 
 
3986
 
    def _get_configobj(self):
3987
 
        path = self._branch._remote_path()
3988
 
        response = self._branch._client.call_expecting_body(
3989
 
            'Branch.get_config_file', path)
3990
 
        return self._response_to_configobj(response)
3991
 
 
3992
 
    def set_option(self, value, name, section=None):
3993
 
        """Set the value associated with a named option.
3994
 
 
3995
 
        :param value: The value to set
3996
 
        :param name: The name of the value to set
3997
 
        :param section: The section the option is in (if any)
3998
 
        """
3999
 
        medium = self._branch._client._medium
4000
 
        if medium._is_remote_before((1, 14)):
4001
 
            return self._vfs_set_option(value, name, section)
4002
 
        if isinstance(value, dict):
4003
 
            if medium._is_remote_before((2, 2)):
4004
 
                return self._vfs_set_option(value, name, section)
4005
 
            return self._set_config_option_dict(value, name, section)
4006
 
        else:
4007
 
            return self._set_config_option(value, name, section)
4008
 
 
4009
 
    def _set_config_option(self, value, name, section):
4010
 
        try:
4011
 
            path = self._branch._remote_path()
4012
 
            response = self._branch._client.call('Branch.set_config_option',
4013
 
                path, self._branch._lock_token, self._branch._repo_lock_token,
4014
 
                value.encode('utf8'), name, section or '')
4015
 
        except errors.UnknownSmartMethod:
4016
 
            medium = self._branch._client._medium
4017
 
            medium._remember_remote_is_before((1, 14))
4018
 
            return self._vfs_set_option(value, name, section)
4019
 
        if response != ():
4020
 
            raise errors.UnexpectedSmartServerResponse(response)
4021
 
 
4022
 
    def _serialize_option_dict(self, option_dict):
4023
 
        utf8_dict = {}
4024
 
        for key, value in option_dict.items():
4025
 
            if isinstance(key, unicode):
4026
 
                key = key.encode('utf8')
4027
 
            if isinstance(value, unicode):
4028
 
                value = value.encode('utf8')
4029
 
            utf8_dict[key] = value
4030
 
        return bencode.bencode(utf8_dict)
4031
 
 
4032
 
    def _set_config_option_dict(self, value, name, section):
4033
 
        try:
4034
 
            path = self._branch._remote_path()
4035
 
            serialised_dict = self._serialize_option_dict(value)
4036
 
            response = self._branch._client.call(
4037
 
                'Branch.set_config_option_dict',
4038
 
                path, self._branch._lock_token, self._branch._repo_lock_token,
4039
 
                serialised_dict, name, section or '')
4040
 
        except errors.UnknownSmartMethod:
4041
 
            medium = self._branch._client._medium
4042
 
            medium._remember_remote_is_before((2, 2))
4043
 
            return self._vfs_set_option(value, name, section)
4044
 
        if response != ():
4045
 
            raise errors.UnexpectedSmartServerResponse(response)
4046
 
 
4047
 
    def _real_object(self):
4048
 
        self._branch._ensure_real()
4049
 
        return self._branch._real_branch
4050
 
 
4051
 
    def _vfs_set_option(self, value, name, section=None):
4052
 
        return self._real_object()._get_config().set_option(
4053
 
            value, name, section)
4054
 
 
4055
 
 
4056
 
class RemoteBzrDirConfig(RemoteConfig):
4057
 
    """A RemoteConfig for BzrDirs."""
4058
 
 
4059
 
    def __init__(self, bzrdir):
4060
 
        self._bzrdir = bzrdir
4061
 
 
4062
 
    def _get_configobj(self):
4063
 
        medium = self._bzrdir._client._medium
4064
 
        verb = 'BzrDir.get_config_file'
4065
 
        if medium._is_remote_before((1, 15)):
4066
 
            raise errors.UnknownSmartMethod(verb)
4067
 
        path = self._bzrdir._path_for_remote_call(self._bzrdir._client)
4068
 
        response = self._bzrdir._call_expecting_body(
4069
 
            verb, path)
4070
 
        return self._response_to_configobj(response)
4071
 
 
4072
 
    def _vfs_get_option(self, name, section, default):
4073
 
        return self._real_object()._get_config().get_option(
4074
 
            name, section, default)
4075
 
 
4076
 
    def set_option(self, value, name, section=None):
4077
 
        """Set the value associated with a named option.
4078
 
 
4079
 
        :param value: The value to set
4080
 
        :param name: The name of the value to set
4081
 
        :param section: The section the option is in (if any)
4082
 
        """
4083
 
        return self._real_object()._get_config().set_option(
4084
 
            value, name, section)
4085
 
 
4086
 
    def _real_object(self):
4087
 
        self._bzrdir._ensure_real()
4088
 
        return self._bzrdir._real_bzrdir
4089
 
 
4090
 
 
4091
 
def _extract_tar(tar, to_dir):
4092
 
    """Extract all the contents of a tarfile object.
4093
 
 
4094
 
    A replacement for extractall, which is not present in python2.4
4095
 
    """
4096
 
    for tarinfo in tar:
4097
 
        tar.extract(tarinfo, to_dir)
4098
 
 
4099
 
 
4100
 
error_translators = registry.Registry()
4101
 
no_context_error_translators = registry.Registry()
4102
 
 
4103
 
 
4104
 
def _translate_error(err, **context):
4105
 
    """Translate an ErrorFromSmartServer into a more useful error.
4106
 
 
4107
 
    Possible context keys:
4108
 
      - branch
4109
 
      - repository
4110
 
      - bzrdir
4111
 
      - token
4112
 
      - other_branch
4113
 
      - path
4114
 
 
4115
 
    If the error from the server doesn't match a known pattern, then
4116
 
    UnknownErrorFromSmartServer is raised.
4117
 
    """
4118
 
    def find(name):
4119
 
        try:
4120
 
            return context[name]
4121
 
        except KeyError, key_err:
4122
 
            mutter('Missing key %r in context %r', key_err.args[0], context)
4123
 
            raise err
4124
 
    def get_path():
4125
 
        """Get the path from the context if present, otherwise use first error
4126
 
        arg.
4127
 
        """
4128
 
        try:
4129
 
            return context['path']
4130
 
        except KeyError, key_err:
4131
 
            try:
4132
 
                return err.error_args[0]
4133
 
            except IndexError, idx_err:
4134
 
                mutter(
4135
 
                    'Missing key %r in context %r', key_err.args[0], context)
4136
 
                raise err
4137
 
 
4138
 
    try:
4139
 
        translator = error_translators.get(err.error_verb)
4140
 
    except KeyError:
4141
 
        pass
4142
 
    else:
4143
 
        raise translator(err, find, get_path)
4144
 
    try:
4145
 
        translator = no_context_error_translators.get(err.error_verb)
4146
 
    except KeyError:
4147
 
        raise errors.UnknownErrorFromSmartServer(err)
4148
 
    else:
4149
 
        raise translator(err)
4150
 
 
4151
 
 
4152
 
error_translators.register('NoSuchRevision',
4153
 
    lambda err, find, get_path: NoSuchRevision(
4154
 
        find('branch'), err.error_args[0]))
4155
 
error_translators.register('nosuchrevision',
4156
 
    lambda err, find, get_path: NoSuchRevision(
4157
 
        find('repository'), err.error_args[0]))
4158
 
 
4159
 
def _translate_nobranch_error(err, find, get_path):
4160
 
    if len(err.error_args) >= 1:
4161
 
        extra = err.error_args[0]
4162
 
    else:
4163
 
        extra = None
4164
 
    return errors.NotBranchError(path=find('bzrdir').root_transport.base,
4165
 
        detail=extra)
4166
 
 
4167
 
error_translators.register('nobranch', _translate_nobranch_error)
4168
 
error_translators.register('norepository',
4169
 
    lambda err, find, get_path: errors.NoRepositoryPresent(
4170
 
        find('bzrdir')))
4171
 
error_translators.register('UnlockableTransport',
4172
 
    lambda err, find, get_path: errors.UnlockableTransport(
4173
 
        find('bzrdir').root_transport))
4174
 
error_translators.register('TokenMismatch',
4175
 
    lambda err, find, get_path: errors.TokenMismatch(
4176
 
        find('token'), '(remote token)'))
4177
 
error_translators.register('Diverged',
4178
 
    lambda err, find, get_path: errors.DivergedBranches(
4179
 
        find('branch'), find('other_branch')))
4180
 
error_translators.register('NotStacked',
4181
 
    lambda err, find, get_path: errors.NotStacked(branch=find('branch')))
4182
 
 
4183
 
def _translate_PermissionDenied(err, find, get_path):
4184
 
    path = get_path()
4185
 
    if len(err.error_args) >= 2:
4186
 
        extra = err.error_args[1]
4187
 
    else:
4188
 
        extra = None
4189
 
    return errors.PermissionDenied(path, extra=extra)
4190
 
 
4191
 
error_translators.register('PermissionDenied', _translate_PermissionDenied)
4192
 
error_translators.register('ReadError',
4193
 
    lambda err, find, get_path: errors.ReadError(get_path()))
4194
 
error_translators.register('NoSuchFile',
4195
 
    lambda err, find, get_path: errors.NoSuchFile(get_path()))
4196
 
error_translators.register('TokenLockingNotSupported',
4197
 
    lambda err, find, get_path: errors.TokenLockingNotSupported(
4198
 
        find('repository')))
4199
 
error_translators.register('UnsuspendableWriteGroup',
4200
 
    lambda err, find, get_path: errors.UnsuspendableWriteGroup(
4201
 
        repository=find('repository')))
4202
 
error_translators.register('UnresumableWriteGroup',
4203
 
    lambda err, find, get_path: errors.UnresumableWriteGroup(
4204
 
        repository=find('repository'), write_groups=err.error_args[0],
4205
 
        reason=err.error_args[1]))
4206
 
no_context_error_translators.register('IncompatibleRepositories',
4207
 
    lambda err: errors.IncompatibleRepositories(
4208
 
        err.error_args[0], err.error_args[1], err.error_args[2]))
4209
 
no_context_error_translators.register('LockContention',
4210
 
    lambda err: errors.LockContention('(remote lock)'))
4211
 
no_context_error_translators.register('LockFailed',
4212
 
    lambda err: errors.LockFailed(err.error_args[0], err.error_args[1]))
4213
 
no_context_error_translators.register('TipChangeRejected',
4214
 
    lambda err: errors.TipChangeRejected(err.error_args[0].decode('utf8')))
4215
 
no_context_error_translators.register('UnstackableBranchFormat',
4216
 
    lambda err: errors.UnstackableBranchFormat(*err.error_args))
4217
 
no_context_error_translators.register('UnstackableRepositoryFormat',
4218
 
    lambda err: errors.UnstackableRepositoryFormat(*err.error_args))
4219
 
no_context_error_translators.register('FileExists',
4220
 
    lambda err: errors.FileExists(err.error_args[0]))
4221
 
no_context_error_translators.register('DirectoryNotEmpty',
4222
 
    lambda err: errors.DirectoryNotEmpty(err.error_args[0]))
4223
 
 
4224
 
def _translate_short_readv_error(err):
4225
 
    args = err.error_args
4226
 
    return errors.ShortReadvError(args[0], int(args[1]), int(args[2]),
4227
 
        int(args[3]))
4228
 
 
4229
 
no_context_error_translators.register('ShortReadvError',
4230
 
    _translate_short_readv_error)
4231
 
 
4232
 
def _translate_unicode_error(err):
4233
 
        encoding = str(err.error_args[0]) # encoding must always be a string
4234
 
        val = err.error_args[1]
4235
 
        start = int(err.error_args[2])
4236
 
        end = int(err.error_args[3])
4237
 
        reason = str(err.error_args[4]) # reason must always be a string
4238
 
        if val.startswith('u:'):
4239
 
            val = val[2:].decode('utf-8')
4240
 
        elif val.startswith('s:'):
4241
 
            val = val[2:].decode('base64')
4242
 
        if err.error_verb == 'UnicodeDecodeError':
4243
 
            raise UnicodeDecodeError(encoding, val, start, end, reason)
4244
 
        elif err.error_verb == 'UnicodeEncodeError':
4245
 
            raise UnicodeEncodeError(encoding, val, start, end, reason)
4246
 
 
4247
 
no_context_error_translators.register('UnicodeEncodeError',
4248
 
    _translate_unicode_error)
4249
 
no_context_error_translators.register('UnicodeDecodeError',
4250
 
    _translate_unicode_error)
4251
 
no_context_error_translators.register('ReadOnlyError',
4252
 
    lambda err: errors.TransportNotPossible('readonly transport'))
4253
 
no_context_error_translators.register('MemoryError',
4254
 
    lambda err: errors.BzrError("remote server out of memory\n"
4255
 
        "Retry non-remotely, or contact the server admin for details."))
4256
 
no_context_error_translators.register('RevisionNotPresent',
4257
 
    lambda err: errors.RevisionNotPresent(err.error_args[0], err.error_args[1]))
4258
 
 
4259
 
no_context_error_translators.register('BzrCheckError',
4260
 
    lambda err: errors.BzrCheckError(msg=err.error_args[0]))
4261