← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/remote.py

  • Committer: John Arbash Meinel
  • Date: 2009-03-24 16:35:22 UTC
  • mto: This revision was merged to the branch mainline in revision 4198.
  • Revision ID: john@arbash-meinel.com-20090324163522-p0p9s5ahzsnem1oc
A few notes, some updates from ian.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/remote.py
1
 
# Copyright (C) 2006-2010 Canonical Ltd
 
1
# Copyright (C) 2006, 2007, 2008 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
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
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
 
17
# TODO: At some point, handle upgrades by just passing the whole request
 
18
# across to run on the server.
16
19
 
17
20
import bz2
18
21
 
19
22
from bzrlib import (
20
 
    bencode,
21
23
    branch,
22
24
    bzrdir,
23
 
    config,
24
25
    debug,
25
26
    errors,
26
27
    graph,
27
 
    lock,
28
28
    lockdir,
 
29
    pack,
29
30
    repository,
30
 
    repository as _mod_repository,
31
31
    revision,
32
 
    revision as _mod_revision,
33
 
    static_tuple,
34
32
    symbol_versioning,
 
33
    urlutils,
35
34
)
36
35
from bzrlib.branch import BranchReferenceFormat
37
36
from bzrlib.bzrdir import BzrDir, RemoteBzrDirFormat
38
 
from bzrlib.decorators import needs_read_lock, needs_write_lock, only_raises
 
37
from bzrlib.decorators import needs_read_lock, needs_write_lock
39
38
from bzrlib.errors import (
40
39
    NoSuchRevision,
41
40
    SmartProtocolError,
44
43
from bzrlib.smart import client, vfs, repository as smart_repo
45
44
from bzrlib.revision import ensure_null, NULL_REVISION
46
45
from bzrlib.trace import mutter, note, warning
 
46
from bzrlib.util import bencode
47
47
 
48
48
 
49
49
class _RpcHelper(object):
61
61
        except errors.ErrorFromSmartServer, err:
62
62
            self._translate_error(err, **err_context)
63
63
 
64
 
    def _call_with_body_bytes(self, method, args, body_bytes, **err_context):
65
 
        try:
66
 
            return self._client.call_with_body_bytes(method, args, body_bytes)
67
 
        except errors.ErrorFromSmartServer, err:
68
 
            self._translate_error(err, **err_context)
69
 
 
70
64
    def _call_with_body_bytes_expecting_body(self, method, args, body_bytes,
71
65
                                             **err_context):
72
66
        try:
91
85
class RemoteBzrDir(BzrDir, _RpcHelper):
92
86
    """Control directory on a remote server, accessed via bzr:// or similar."""
93
87
 
94
 
    def __init__(self, transport, format, _client=None, _force_probe=False):
 
88
    def __init__(self, transport, format, _client=None):
95
89
        """Construct a RemoteBzrDir.
96
90
 
97
91
        :param _client: Private parameter for testing. Disables probing and the
101
95
        # this object holds a delegated bzrdir that uses file-level operations
102
96
        # to talk to the other side
103
97
        self._real_bzrdir = None
104
 
        self._has_working_tree = None
105
98
        # 1-shot cache for the call pattern 'create_branch; open_branch' - see
106
99
        # create_branch for details.
107
100
        self._next_open_branch_result = None
111
104
            self._client = client._SmartClient(medium)
112
105
        else:
113
106
            self._client = _client
114
 
            if not _force_probe:
115
 
                return
116
 
 
117
 
        self._probe_bzrdir()
118
 
 
119
 
    def __repr__(self):
120
 
        return '%s(%r)' % (self.__class__.__name__, self._client)
121
 
 
122
 
    def _probe_bzrdir(self):
123
 
        medium = self._client._medium
 
107
            return
 
108
 
124
109
        path = self._path_for_remote_call(self._client)
125
 
        if medium._is_remote_before((2, 1)):
126
 
            self._rpc_open(path)
127
 
            return
128
 
        try:
129
 
            self._rpc_open_2_1(path)
130
 
            return
131
 
        except errors.UnknownSmartMethod:
132
 
            medium._remember_remote_is_before((2, 1))
133
 
            self._rpc_open(path)
134
 
 
135
 
    def _rpc_open_2_1(self, path):
136
 
        response = self._call('BzrDir.open_2.1', path)
137
 
        if response == ('no',):
138
 
            raise errors.NotBranchError(path=self.root_transport.base)
139
 
        elif response[0] == 'yes':
140
 
            if response[1] == 'yes':
141
 
                self._has_working_tree = True
142
 
            elif response[1] == 'no':
143
 
                self._has_working_tree = False
144
 
            else:
145
 
                raise errors.UnexpectedSmartServerResponse(response)
146
 
        else:
147
 
            raise errors.UnexpectedSmartServerResponse(response)
148
 
 
149
 
    def _rpc_open(self, path):
150
110
        response = self._call('BzrDir.open', path)
151
111
        if response not in [('yes',), ('no',)]:
152
112
            raise errors.UnexpectedSmartServerResponse(response)
153
113
        if response == ('no',):
154
 
            raise errors.NotBranchError(path=self.root_transport.base)
 
114
            raise errors.NotBranchError(path=transport.base)
155
115
 
156
116
    def _ensure_real(self):
157
117
        """Ensure that there is a _real_bzrdir set.
159
119
        Used before calls to self._real_bzrdir.
160
120
        """
161
121
        if not self._real_bzrdir:
162
 
            if 'hpssvfs' in debug.debug_flags:
163
 
                import traceback
164
 
                warning('VFS BzrDir access triggered\n%s',
165
 
                    ''.join(traceback.format_stack()))
166
122
            self._real_bzrdir = BzrDir.open_from_transport(
167
123
                self.root_transport, _server_formats=False)
168
124
            self._format._network_name = \
197
153
        except errors.UnknownSmartMethod:
198
154
            medium._remember_remote_is_before((1, 13))
199
155
            return self._vfs_cloning_metadir(require_stacking=require_stacking)
200
 
        except errors.UnknownErrorFromSmartServer, err:
201
 
            if err.error_tuple != ('BranchReference',):
202
 
                raise
203
 
            # We need to resolve the branch reference to determine the
204
 
            # cloning_metadir.  This causes unnecessary RPCs to open the
205
 
            # referenced branch (and bzrdir, etc) but only when the caller
206
 
            # didn't already resolve the branch reference.
207
 
            referenced_branch = self.open_branch()
208
 
            return referenced_branch.bzrdir.cloning_metadir()
209
156
        if len(response) != 3:
210
157
            raise errors.UnexpectedSmartServerResponse(response)
211
158
        control_name, repo_name, branch_info = response
244
191
        self._ensure_real()
245
192
        self._real_bzrdir.destroy_repository()
246
193
 
247
 
    def create_branch(self, name=None):
 
194
    def create_branch(self):
248
195
        # as per meta1 formats - just delegate to the format object which may
249
196
        # be parameterised.
250
 
        real_branch = self._format.get_branch_format().initialize(self,
251
 
            name=name)
 
197
        real_branch = self._format.get_branch_format().initialize(self)
252
198
        if not isinstance(real_branch, RemoteBranch):
253
 
            result = RemoteBranch(self, self.find_repository(), real_branch,
254
 
                                  name=name)
 
199
            result = RemoteBranch(self, self.find_repository(), real_branch)
255
200
        else:
256
201
            result = real_branch
257
202
        # BzrDir.clone_on_transport() uses the result of create_branch but does
263
208
        self._next_open_branch_result = result
264
209
        return result
265
210
 
266
 
    def destroy_branch(self, name=None):
 
211
    def destroy_branch(self):
267
212
        """See BzrDir.destroy_branch"""
268
213
        self._ensure_real()
269
 
        self._real_bzrdir.destroy_branch(name=name)
 
214
        self._real_bzrdir.destroy_branch()
270
215
        self._next_open_branch_result = None
271
216
 
272
217
    def create_workingtree(self, revision_id=None, from_branch=None):
291
236
    def _get_branch_reference(self):
292
237
        path = self._path_for_remote_call(self._client)
293
238
        medium = self._client._medium
294
 
        candidate_calls = [
295
 
            ('BzrDir.open_branchV3', (2, 1)),
296
 
            ('BzrDir.open_branchV2', (1, 13)),
297
 
            ('BzrDir.open_branch', None),
298
 
            ]
299
 
        for verb, required_version in candidate_calls:
300
 
            if required_version and medium._is_remote_before(required_version):
301
 
                continue
 
239
        if not medium._is_remote_before((1, 13)):
302
240
            try:
303
 
                response = self._call(verb, path)
 
241
                response = self._call('BzrDir.open_branchV2', path)
 
242
                if response[0] not in ('ref', 'branch'):
 
243
                    raise errors.UnexpectedSmartServerResponse(response)
 
244
                return response
304
245
            except errors.UnknownSmartMethod:
305
 
                if required_version is None:
306
 
                    raise
307
 
                medium._remember_remote_is_before(required_version)
308
 
            else:
309
 
                break
310
 
        if verb == 'BzrDir.open_branch':
311
 
            if response[0] != 'ok':
312
 
                raise errors.UnexpectedSmartServerResponse(response)
313
 
            if response[1] != '':
314
 
                return ('ref', response[1])
315
 
            else:
316
 
                return ('branch', '')
317
 
        if response[0] not in ('ref', 'branch'):
 
246
                medium._remember_remote_is_before((1, 13))
 
247
        response = self._call('BzrDir.open_branch', path)
 
248
        if response[0] != 'ok':
318
249
            raise errors.UnexpectedSmartServerResponse(response)
319
 
        return response
 
250
        if response[1] != '':
 
251
            return ('ref', response[1])
 
252
        else:
 
253
            return ('branch', '')
320
254
 
321
255
    def _get_tree_branch(self):
322
256
        """See BzrDir._get_tree_branch()."""
323
257
        return None, self.open_branch()
324
258
 
325
 
    def open_branch(self, name=None, unsupported=False,
326
 
                    ignore_fallbacks=False):
327
 
        if unsupported:
 
259
    def open_branch(self, _unsupported=False):
 
260
        if _unsupported:
328
261
            raise NotImplementedError('unsupported flag support not implemented yet.')
329
262
        if self._next_open_branch_result is not None:
330
263
            # See create_branch for details.
335
268
        if response[0] == 'ref':
336
269
            # a branch reference, use the existing BranchReference logic.
337
270
            format = BranchReferenceFormat()
338
 
            return format.open(self, name=name, _found=True,
339
 
                location=response[1], ignore_fallbacks=ignore_fallbacks)
 
271
            return format.open(self, _found=True, location=response[1])
340
272
        branch_format_name = response[1]
341
273
        if not branch_format_name:
342
274
            branch_format_name = None
343
275
        format = RemoteBranchFormat(network_name=branch_format_name)
344
 
        return RemoteBranch(self, self.find_repository(), format=format,
345
 
            setup_stacking=not ignore_fallbacks, name=name)
 
276
        return RemoteBranch(self, self.find_repository(), format=format)
346
277
 
347
278
    def _open_repo_v1(self, path):
348
279
        verb = 'BzrDir.find_repository'
409
340
        else:
410
341
            raise errors.NoRepositoryPresent(self)
411
342
 
412
 
    def has_workingtree(self):
413
 
        if self._has_working_tree is None:
414
 
            self._ensure_real()
415
 
            self._has_working_tree = self._real_bzrdir.has_workingtree()
416
 
        return self._has_working_tree
417
 
 
418
343
    def open_workingtree(self, recommend_upgrade=True):
419
 
        if self.has_workingtree():
 
344
        self._ensure_real()
 
345
        if self._real_bzrdir.has_workingtree():
420
346
            raise errors.NotLocalUrl(self.root_transport)
421
347
        else:
422
348
            raise errors.NoWorkingTree(self.root_transport.base)
425
351
        """Return the path to be used for this bzrdir in a remote call."""
426
352
        return client.remote_path_from_transport(self.root_transport)
427
353
 
428
 
    def get_branch_transport(self, branch_format, name=None):
 
354
    def get_branch_transport(self, branch_format):
429
355
        self._ensure_real()
430
 
        return self._real_bzrdir.get_branch_transport(branch_format, name=name)
 
356
        return self._real_bzrdir.get_branch_transport(branch_format)
431
357
 
432
358
    def get_repository_transport(self, repository_format):
433
359
        self._ensure_real()
454
380
        return self._real_bzrdir.clone(url, revision_id=revision_id,
455
381
            force_new_repo=force_new_repo, preserve_stacking=preserve_stacking)
456
382
 
457
 
    def _get_config(self):
458
 
        return RemoteBzrDirConfig(self)
 
383
    def get_config(self):
 
384
        self._ensure_real()
 
385
        return self._real_bzrdir.get_config()
459
386
 
460
387
 
461
388
class RemoteRepositoryFormat(repository.RepositoryFormat):
485
412
        self._custom_format = None
486
413
        self._network_name = None
487
414
        self._creating_bzrdir = None
488
 
        self._supports_chks = None
489
415
        self._supports_external_lookups = None
490
416
        self._supports_tree_reference = None
491
417
        self._rich_root_data = None
492
418
 
493
 
    def __repr__(self):
494
 
        return "%s(_network_name=%r)" % (self.__class__.__name__,
495
 
            self._network_name)
496
 
 
497
 
    @property
498
 
    def fast_deltas(self):
499
 
        self._ensure_real()
500
 
        return self._custom_format.fast_deltas
501
 
 
502
419
    @property
503
420
    def rich_root_data(self):
504
421
        if self._rich_root_data is None:
507
424
        return self._rich_root_data
508
425
 
509
426
    @property
510
 
    def supports_chks(self):
511
 
        if self._supports_chks is None:
512
 
            self._ensure_real()
513
 
            self._supports_chks = self._custom_format.supports_chks
514
 
        return self._supports_chks
515
 
 
516
 
    @property
517
427
    def supports_external_lookups(self):
518
428
        if self._supports_external_lookups is None:
519
429
            self._ensure_real()
565
475
        # 1) get the network name to use.
566
476
        if self._custom_format:
567
477
            network_name = self._custom_format.network_name()
568
 
        elif self._network_name:
569
 
            network_name = self._network_name
570
478
        else:
571
479
            # Select the current bzrlib default and ask for that.
572
480
            reference_bzrdir_format = bzrdir.format_registry.get('default')()
620
528
        return self._custom_format._fetch_reconcile
621
529
 
622
530
    def get_format_description(self):
623
 
        self._ensure_real()
624
 
        return 'Remote: ' + self._custom_format.get_format_description()
 
531
        return 'bzr remote repository'
625
532
 
626
533
    def __eq__(self, other):
627
534
        return self.__class__ is other.__class__
628
535
 
 
536
    def check_conversion_target(self, target_format):
 
537
        if self.rich_root_data and not target_format.rich_root_data:
 
538
            raise errors.BadConversionTarget(
 
539
                'Does not support rich root data.', target_format)
 
540
        if (self.supports_tree_reference and
 
541
            not getattr(target_format, 'supports_tree_reference', False)):
 
542
            raise errors.BadConversionTarget(
 
543
                'Does not support nested trees', target_format)
 
544
 
629
545
    def network_name(self):
630
546
        if self._network_name:
631
547
            return self._network_name
633
549
        return self._creating_repo._real_repository._format.network_name()
634
550
 
635
551
    @property
636
 
    def pack_compresses(self):
637
 
        self._ensure_real()
638
 
        return self._custom_format.pack_compresses
639
 
 
640
 
    @property
641
552
    def _serializer(self):
642
553
        self._ensure_real()
643
554
        return self._custom_format._serializer
644
555
 
645
556
 
646
 
class RemoteRepository(_RpcHelper, lock._RelockDebugMixin,
647
 
    bzrdir.ControlComponent):
 
557
class RemoteRepository(_RpcHelper):
648
558
    """Repository accessed over rpc.
649
559
 
650
560
    For the moment most operations are performed using local transport-backed
676
586
        self._lock_token = None
677
587
        self._lock_count = 0
678
588
        self._leave_lock = False
679
 
        # Cache of revision parents; misses are cached during read locks, and
680
 
        # write locks when no _real_repository has been set.
681
589
        self._unstacked_provider = graph.CachingParentsProvider(
682
590
            get_parent_map=self._get_parent_map_rpc)
683
591
        self._unstacked_provider.disable_cache()
693
601
        # Additional places to query for data.
694
602
        self._fallback_repositories = []
695
603
 
696
 
    @property
697
 
    def user_transport(self):
698
 
        return self.bzrdir.user_transport
699
 
 
700
 
    @property
701
 
    def control_transport(self):
702
 
        # XXX: Normally you shouldn't directly get at the remote repository
703
 
        # transport, but I'm not sure it's worth making this method
704
 
        # optional -- mbp 2010-04-21
705
 
        return self.bzrdir.get_repository_transport(None)
706
 
        
707
604
    def __str__(self):
708
605
        return "%s(%s)" % (self.__class__.__name__, self.base)
709
606
 
712
609
    def abort_write_group(self, suppress_errors=False):
713
610
        """Complete a write group on the decorated repository.
714
611
 
715
 
        Smart methods perform operations in a single step so this API
 
612
        Smart methods peform operations in a single step so this api
716
613
        is not really applicable except as a compatibility thunk
717
614
        for older plugins that don't use e.g. the CommitBuilder
718
615
        facility.
723
620
        return self._real_repository.abort_write_group(
724
621
            suppress_errors=suppress_errors)
725
622
 
726
 
    @property
727
 
    def chk_bytes(self):
728
 
        """Decorate the real repository for now.
729
 
 
730
 
        In the long term a full blown network facility is needed to avoid
731
 
        creating a real repository object locally.
732
 
        """
733
 
        self._ensure_real()
734
 
        return self._real_repository.chk_bytes
735
 
 
736
623
    def commit_write_group(self):
737
624
        """Complete a write group on the decorated repository.
738
625
 
739
 
        Smart methods perform operations in a single step so this API
 
626
        Smart methods peform operations in a single step so this api
740
627
        is not really applicable except as a compatibility thunk
741
628
        for older plugins that don't use e.g. the CommitBuilder
742
629
        facility.
752
639
        self._ensure_real()
753
640
        return self._real_repository.suspend_write_group()
754
641
 
755
 
    def get_missing_parent_inventories(self, check_for_missing_texts=True):
756
 
        self._ensure_real()
757
 
        return self._real_repository.get_missing_parent_inventories(
758
 
            check_for_missing_texts=check_for_missing_texts)
759
 
 
760
 
    def _get_rev_id_for_revno_vfs(self, revno, known_pair):
761
 
        self._ensure_real()
762
 
        return self._real_repository.get_rev_id_for_revno(
763
 
            revno, known_pair)
764
 
 
765
 
    def get_rev_id_for_revno(self, revno, known_pair):
766
 
        """See Repository.get_rev_id_for_revno."""
767
 
        path = self.bzrdir._path_for_remote_call(self._client)
768
 
        try:
769
 
            if self._client._medium._is_remote_before((1, 17)):
770
 
                return self._get_rev_id_for_revno_vfs(revno, known_pair)
771
 
            response = self._call(
772
 
                'Repository.get_rev_id_for_revno', path, revno, known_pair)
773
 
        except errors.UnknownSmartMethod:
774
 
            self._client._medium._remember_remote_is_before((1, 17))
775
 
            return self._get_rev_id_for_revno_vfs(revno, known_pair)
776
 
        if response[0] == 'ok':
777
 
            return True, response[1]
778
 
        elif response[0] == 'history-incomplete':
779
 
            known_pair = response[1:3]
780
 
            for fallback in self._fallback_repositories:
781
 
                found, result = fallback.get_rev_id_for_revno(revno, known_pair)
782
 
                if found:
783
 
                    return True, result
784
 
                else:
785
 
                    known_pair = result
786
 
            # Not found in any fallbacks
787
 
            return False, known_pair
788
 
        else:
789
 
            raise errors.UnexpectedSmartServerResponse(response)
790
 
 
791
642
    def _ensure_real(self):
792
643
        """Ensure that there is a _real_repository set.
793
644
 
802
653
        invocation. If in doubt chat to the bzr network team.
803
654
        """
804
655
        if self._real_repository is None:
805
 
            if 'hpssvfs' in debug.debug_flags:
806
 
                import traceback
807
 
                warning('VFS Repository access triggered\n%s',
808
 
                    ''.join(traceback.format_stack()))
809
 
            self._unstacked_provider.missing_keys.clear()
810
656
            self.bzrdir._ensure_real()
811
657
            self._set_real_repository(
812
658
                self.bzrdir._real_bzrdir.open_repository())
839
685
        self._ensure_real()
840
686
        return self._real_repository._generate_text_key_index()
841
687
 
 
688
    @symbol_versioning.deprecated_method(symbol_versioning.one_four)
 
689
    def get_revision_graph(self, revision_id=None):
 
690
        """See Repository.get_revision_graph()."""
 
691
        return self._get_revision_graph(revision_id)
 
692
 
842
693
    def _get_revision_graph(self, revision_id):
843
694
        """Private method for using with old (< 1.2) servers to fallback."""
844
695
        if revision_id is None:
872
723
        """Return a source for streaming from this repository."""
873
724
        return RemoteStreamSource(self, to_format)
874
725
 
875
 
    @needs_read_lock
876
726
    def has_revision(self, revision_id):
877
 
        """True if this repository has a copy of the revision."""
878
 
        # Copy of bzrlib.repository.Repository.has_revision
879
 
        return revision_id in self.has_revisions((revision_id,))
 
727
        """See Repository.has_revision()."""
 
728
        if revision_id == NULL_REVISION:
 
729
            # The null revision is always present.
 
730
            return True
 
731
        path = self.bzrdir._path_for_remote_call(self._client)
 
732
        response = self._call('Repository.has_revision', path, revision_id)
 
733
        if response[0] not in ('yes', 'no'):
 
734
            raise errors.UnexpectedSmartServerResponse(response)
 
735
        if response[0] == 'yes':
 
736
            return True
 
737
        for fallback_repo in self._fallback_repositories:
 
738
            if fallback_repo.has_revision(revision_id):
 
739
                return True
 
740
        return False
880
741
 
881
 
    @needs_read_lock
882
742
    def has_revisions(self, revision_ids):
883
 
        """Probe to find out the presence of multiple revisions.
884
 
 
885
 
        :param revision_ids: An iterable of revision_ids.
886
 
        :return: A set of the revision_ids that were present.
887
 
        """
888
 
        # Copy of bzrlib.repository.Repository.has_revisions
889
 
        parent_map = self.get_parent_map(revision_ids)
890
 
        result = set(parent_map)
891
 
        if _mod_revision.NULL_REVISION in revision_ids:
892
 
            result.add(_mod_revision.NULL_REVISION)
 
743
        """See Repository.has_revisions()."""
 
744
        # FIXME: This does many roundtrips, particularly when there are
 
745
        # fallback repositories.  -- mbp 20080905
 
746
        result = set()
 
747
        for revision_id in revision_ids:
 
748
            if self.has_revision(revision_id):
 
749
                result.add(revision_id)
893
750
        return result
894
751
 
895
 
    def _has_same_fallbacks(self, other_repo):
896
 
        """Returns true if the repositories have the same fallbacks."""
897
 
        # XXX: copied from Repository; it should be unified into a base class
898
 
        # <https://bugs.edge.launchpad.net/bzr/+bug/401622>
899
 
        my_fb = self._fallback_repositories
900
 
        other_fb = other_repo._fallback_repositories
901
 
        if len(my_fb) != len(other_fb):
902
 
            return False
903
 
        for f, g in zip(my_fb, other_fb):
904
 
            if not f.has_same_location(g):
905
 
                return False
906
 
        return True
907
 
 
908
752
    def has_same_location(self, other):
909
 
        # TODO: Move to RepositoryBase and unify with the regular Repository
910
 
        # one; unfortunately the tests rely on slightly different behaviour at
911
 
        # present -- mbp 20090710
912
753
        return (self.__class__ is other.__class__ and
913
754
                self.bzrdir.transport.base == other.bzrdir.transport.base)
914
755
 
917
758
        parents_provider = self._make_parents_provider(other_repository)
918
759
        return graph.Graph(parents_provider)
919
760
 
920
 
    @needs_read_lock
921
 
    def get_known_graph_ancestry(self, revision_ids):
922
 
        """Return the known graph for a set of revision ids and their ancestors.
923
 
        """
924
 
        st = static_tuple.StaticTuple
925
 
        revision_keys = [st(r_id).intern() for r_id in revision_ids]
926
 
        known_graph = self.revisions.get_known_graph_ancestry(revision_keys)
927
 
        return graph.GraphThunkIdsToKeys(known_graph)
928
 
 
929
761
    def gather_stats(self, revid=None, committers=None):
930
762
        """See Repository.gather_stats()."""
931
763
        path = self.bzrdir._path_for_remote_call(self._client)
991
823
    def is_write_locked(self):
992
824
        return self._lock_mode == 'w'
993
825
 
994
 
    def _warn_if_deprecated(self, branch=None):
995
 
        # If we have a real repository, the check will be done there, if we
996
 
        # don't the check will be done remotely.
997
 
        pass
998
 
 
999
826
    def lock_read(self):
1000
827
        # wrong eventually - want a local lock cache context
1001
828
        if not self._lock_mode:
1002
 
            self._note_lock('r')
1003
829
            self._lock_mode = 'r'
1004
830
            self._lock_count = 1
1005
 
            self._unstacked_provider.enable_cache(cache_misses=True)
 
831
            self._unstacked_provider.enable_cache(cache_misses=False)
1006
832
            if self._real_repository is not None:
1007
833
                self._real_repository.lock_read()
1008
 
            for repo in self._fallback_repositories:
1009
 
                repo.lock_read()
1010
834
        else:
1011
835
            self._lock_count += 1
1012
836
 
1025
849
 
1026
850
    def lock_write(self, token=None, _skip_rpc=False):
1027
851
        if not self._lock_mode:
1028
 
            self._note_lock('w')
1029
852
            if _skip_rpc:
1030
853
                if self._lock_token is not None:
1031
854
                    if token != self._lock_token:
1045
868
                self._leave_lock = False
1046
869
            self._lock_mode = 'w'
1047
870
            self._lock_count = 1
1048
 
            cache_misses = self._real_repository is None
1049
 
            self._unstacked_provider.enable_cache(cache_misses=cache_misses)
1050
 
            for repo in self._fallback_repositories:
1051
 
                # Writes don't affect fallback repos
1052
 
                repo.lock_read()
 
871
            self._unstacked_provider.enable_cache(cache_misses=False)
1053
872
        elif self._lock_mode == 'r':
1054
873
            raise errors.ReadOnlyError(self)
1055
874
        else:
1081
900
        if isinstance(repository, RemoteRepository):
1082
901
            raise AssertionError()
1083
902
        self._real_repository = repository
1084
 
        # three code paths happen here:
1085
 
        # 1) old servers, RemoteBranch.open() calls _ensure_real before setting
1086
 
        # up stacking. In this case self._fallback_repositories is [], and the
1087
 
        # real repo is already setup. Preserve the real repo and
1088
 
        # RemoteRepository.add_fallback_repository will avoid adding
1089
 
        # duplicates.
1090
 
        # 2) new servers, RemoteBranch.open() sets up stacking, and when
1091
 
        # ensure_real is triggered from a branch, the real repository to
1092
 
        # set already has a matching list with separate instances, but
1093
 
        # as they are also RemoteRepositories we don't worry about making the
1094
 
        # lists be identical.
1095
 
        # 3) new servers, RemoteRepository.ensure_real is triggered before
1096
 
        # RemoteBranch.ensure real, in this case we get a repo with no fallbacks
1097
 
        # and need to populate it.
1098
 
        if (self._fallback_repositories and
1099
 
            len(self._real_repository._fallback_repositories) !=
1100
 
            len(self._fallback_repositories)):
1101
 
            if len(self._real_repository._fallback_repositories):
1102
 
                raise AssertionError(
1103
 
                    "cannot cleanly remove existing _fallback_repositories")
 
903
        # If the _real_repository has _fallback_repositories, clear them out,
 
904
        # because we want it to have the same set as this repository.  This is
 
905
        # reasonable to do because the fallbacks we clear here are from a
 
906
        # "real" branch, and we're about to replace them with the equivalents
 
907
        # from a RemoteBranch.
 
908
        self._real_repository._fallback_repositories = []
1104
909
        for fb in self._fallback_repositories:
1105
910
            self._real_repository.add_fallback_repository(fb)
1106
911
        if self._lock_mode == 'w':
1113
918
    def start_write_group(self):
1114
919
        """Start a write group on the decorated repository.
1115
920
 
1116
 
        Smart methods perform operations in a single step so this API
 
921
        Smart methods peform operations in a single step so this api
1117
922
        is not really applicable except as a compatibility thunk
1118
923
        for older plugins that don't use e.g. the CommitBuilder
1119
924
        facility.
1134
939
        else:
1135
940
            raise errors.UnexpectedSmartServerResponse(response)
1136
941
 
1137
 
    @only_raises(errors.LockNotHeld, errors.LockBroken)
1138
942
    def unlock(self):
1139
943
        if not self._lock_count:
1140
 
            return lock.cant_unlock_not_held(self)
 
944
            raise errors.LockNotHeld(self)
1141
945
        self._lock_count -= 1
1142
946
        if self._lock_count > 0:
1143
947
            return
1157
961
            # problem releasing the vfs-based lock.
1158
962
            if old_mode == 'w':
1159
963
                # Only write-locked repositories need to make a remote method
1160
 
                # call to perform the unlock.
 
964
                # call to perfom the unlock.
1161
965
                old_token = self._lock_token
1162
966
                self._lock_token = None
1163
967
                if not self._leave_lock:
1164
968
                    self._unlock(old_token)
1165
 
        # Fallbacks are always 'lock_read()' so we don't pay attention to
1166
 
        # self._leave_lock
1167
 
        for repo in self._fallback_repositories:
1168
 
            repo.unlock()
1169
969
 
1170
970
    def break_lock(self):
1171
971
        # should hand off to the network
1235
1035
        # We need to accumulate additional repositories here, to pass them in
1236
1036
        # on various RPC's.
1237
1037
        #
1238
 
        if self.is_locked():
1239
 
            # We will call fallback.unlock() when we transition to the unlocked
1240
 
            # state, so always add a lock here. If a caller passes us a locked
1241
 
            # repository, they are responsible for unlocking it later.
1242
 
            repository.lock_read()
1243
 
        self._check_fallback_repository(repository)
1244
1038
        self._fallback_repositories.append(repository)
1245
1039
        # If self._real_repository was parameterised already (e.g. because a
1246
1040
        # _real_branch had its get_stacked_on_url method called), then the
1247
1041
        # repository to be added may already be in the _real_repositories list.
1248
1042
        if self._real_repository is not None:
1249
 
            fallback_locations = [repo.user_url for repo in
1250
 
                self._real_repository._fallback_repositories]
1251
 
            if repository.user_url not in fallback_locations:
 
1043
            if repository not in self._real_repository._fallback_repositories:
1252
1044
                self._real_repository.add_fallback_repository(repository)
1253
 
 
1254
 
    def _check_fallback_repository(self, repository):
1255
 
        """Check that this repository can fallback to repository safely.
1256
 
 
1257
 
        Raise an error if not.
1258
 
 
1259
 
        :param repository: A repository to fallback to.
1260
 
        """
1261
 
        return _mod_repository.InterRepository._assert_same_model(
1262
 
            self, repository)
 
1045
        else:
 
1046
            # They are also seen by the fallback repository.  If it doesn't
 
1047
            # exist yet they'll be added then.  This implicitly copies them.
 
1048
            self._ensure_real()
1263
1049
 
1264
1050
    def add_inventory(self, revid, inv, parents):
1265
1051
        self._ensure_real()
1266
1052
        return self._real_repository.add_inventory(revid, inv, parents)
1267
1053
 
1268
1054
    def add_inventory_by_delta(self, basis_revision_id, delta, new_revision_id,
1269
 
            parents, basis_inv=None, propagate_caches=False):
 
1055
                               parents):
1270
1056
        self._ensure_real()
1271
1057
        return self._real_repository.add_inventory_by_delta(basis_revision_id,
1272
 
            delta, new_revision_id, parents, basis_inv=basis_inv,
1273
 
            propagate_caches=propagate_caches)
 
1058
            delta, new_revision_id, parents)
1274
1059
 
1275
1060
    def add_revision(self, rev_id, rev, inv=None, config=None):
1276
1061
        self._ensure_real()
1282
1067
        self._ensure_real()
1283
1068
        return self._real_repository.get_inventory(revision_id)
1284
1069
 
1285
 
    def iter_inventories(self, revision_ids, ordering=None):
 
1070
    def iter_inventories(self, revision_ids):
1286
1071
        self._ensure_real()
1287
 
        return self._real_repository.iter_inventories(revision_ids, ordering)
 
1072
        return self._real_repository.iter_inventories(revision_ids)
1288
1073
 
1289
1074
    @needs_read_lock
1290
1075
    def get_revision(self, revision_id):
1354
1139
            raise errors.InternalBzrError(
1355
1140
                "May not fetch while in a write group.")
1356
1141
        # fast path same-url fetch operations
1357
 
        if (self.has_same_location(source)
1358
 
            and fetch_spec is None
1359
 
            and self._has_same_fallbacks(source)):
 
1142
        if self.has_same_location(source) and fetch_spec is None:
1360
1143
            # check that last_revision is in 'from' and then return a
1361
1144
            # no-operation.
1362
1145
            if (revision_id is not None and
1405
1188
            # We already found out that the server can't understand
1406
1189
            # Repository.get_parent_map requests, so just fetch the whole
1407
1190
            # graph.
1408
 
            #
1409
 
            # Note that this reads the whole graph, when only some keys are
1410
 
            # wanted.  On this old server there's no way (?) to get them all
1411
 
            # in one go, and the user probably will have seen a warning about
1412
 
            # the server being old anyhow.
1413
 
            rg = self._get_revision_graph(None)
1414
 
            # There is an API discrepancy between get_parent_map and
 
1191
            # XXX: Note that this will issue a deprecation warning. This is ok
 
1192
            # :- its because we're working with a deprecated server anyway, and
 
1193
            # the user will almost certainly have seen a warning about the
 
1194
            # server version already.
 
1195
            rg = self.get_revision_graph()
 
1196
            # There is an api discrepency between get_parent_map and
1415
1197
            # get_revision_graph. Specifically, a "key:()" pair in
1416
1198
            # get_revision_graph just means a node has no parents. For
1417
1199
            # "get_parent_map" it means the node is a ghost. So fix up the
1447
1229
        # TODO: Manage this incrementally to avoid covering the same path
1448
1230
        # repeatedly. (The server will have to on each request, but the less
1449
1231
        # work done the better).
1450
 
        #
1451
 
        # Negative caching notes:
1452
 
        # new server sends missing when a request including the revid
1453
 
        # 'include-missing:' is present in the request.
1454
 
        # missing keys are serialised as missing:X, and we then call
1455
 
        # provider.note_missing(X) for-all X
1456
1232
        parents_map = self._unstacked_provider.get_cached_map()
1457
1233
        if parents_map is None:
1458
1234
            # Repository is not locked, so there's no cache.
1459
1235
            parents_map = {}
1460
 
        # start_set is all the keys in the cache
1461
1236
        start_set = set(parents_map)
1462
 
        # result set is all the references to keys in the cache
1463
1237
        result_parents = set()
1464
1238
        for parents in parents_map.itervalues():
1465
1239
            result_parents.update(parents)
1466
1240
        stop_keys = result_parents.difference(start_set)
1467
 
        # We don't need to send ghosts back to the server as a position to
1468
 
        # stop either.
1469
 
        stop_keys.difference_update(self._unstacked_provider.missing_keys)
1470
 
        key_count = len(parents_map)
1471
 
        if (NULL_REVISION in result_parents
1472
 
            and NULL_REVISION in self._unstacked_provider.missing_keys):
1473
 
            # If we pruned NULL_REVISION from the stop_keys because it's also
1474
 
            # in our cache of "missing" keys we need to increment our key count
1475
 
            # by 1, because the reconsitituted SearchResult on the server will
1476
 
            # still consider NULL_REVISION to be an included key.
1477
 
            key_count += 1
1478
1241
        included_keys = start_set.intersection(result_parents)
1479
1242
        start_set.difference_update(included_keys)
1480
 
        recipe = ('manual', start_set, stop_keys, key_count)
 
1243
        recipe = ('manual', start_set, stop_keys, len(parents_map))
1481
1244
        body = self._serialise_search_recipe(recipe)
1482
1245
        path = self.bzrdir._path_for_remote_call(self._client)
1483
1246
        for key in keys:
1485
1248
                raise ValueError(
1486
1249
                    "key %r not a plain string" % (key,))
1487
1250
        verb = 'Repository.get_parent_map'
1488
 
        args = (path, 'include-missing:') + tuple(keys)
 
1251
        args = (path,) + tuple(keys)
1489
1252
        try:
1490
1253
            response = self._call_with_body_bytes_expecting_body(
1491
1254
                verb, args, body)
1501
1264
            # To avoid having to disconnect repeatedly, we keep track of the
1502
1265
            # fact the server doesn't understand remote methods added in 1.2.
1503
1266
            medium._remember_remote_is_before((1, 2))
1504
 
            # Recurse just once and we should use the fallback code.
1505
 
            return self._get_parent_map_rpc(keys)
 
1267
            return self.get_revision_graph(None)
1506
1268
        response_tuple, response_handler = response
1507
1269
        if response_tuple[0] not in ['ok']:
1508
1270
            response_handler.cancel_read_body()
1519
1281
                if len(d) > 1:
1520
1282
                    revision_graph[d[0]] = d[1:]
1521
1283
                else:
1522
 
                    # No parents:
1523
 
                    if d[0].startswith('missing:'):
1524
 
                        revid = d[0][8:]
1525
 
                        self._unstacked_provider.note_missing_key(revid)
1526
 
                    else:
1527
 
                        # no parents - so give the Graph result
1528
 
                        # (NULL_REVISION,).
1529
 
                        revision_graph[d[0]] = (NULL_REVISION,)
 
1284
                    # No parents - so give the Graph result (NULL_REVISION,).
 
1285
                    revision_graph[d[0]] = (NULL_REVISION,)
1530
1286
            return revision_graph
1531
1287
 
1532
1288
    @needs_read_lock
1535
1291
        return self._real_repository.get_signature_text(revision_id)
1536
1292
 
1537
1293
    @needs_read_lock
1538
 
    def _get_inventory_xml(self, revision_id):
1539
 
        self._ensure_real()
1540
 
        return self._real_repository._get_inventory_xml(revision_id)
 
1294
    @symbol_versioning.deprecated_method(symbol_versioning.one_three)
 
1295
    def get_revision_graph_with_ghosts(self, revision_ids=None):
 
1296
        self._ensure_real()
 
1297
        return self._real_repository.get_revision_graph_with_ghosts(
 
1298
            revision_ids=revision_ids)
 
1299
 
 
1300
    @needs_read_lock
 
1301
    def get_inventory_xml(self, revision_id):
 
1302
        self._ensure_real()
 
1303
        return self._real_repository.get_inventory_xml(revision_id)
 
1304
 
 
1305
    def deserialise_inventory(self, revision_id, xml):
 
1306
        self._ensure_real()
 
1307
        return self._real_repository.deserialise_inventory(revision_id, xml)
1541
1308
 
1542
1309
    def reconcile(self, other=None, thorough=False):
1543
1310
        self._ensure_real()
1548
1315
        return self._real_repository.all_revision_ids()
1549
1316
 
1550
1317
    @needs_read_lock
1551
 
    def get_deltas_for_revisions(self, revisions, specific_fileids=None):
 
1318
    def get_deltas_for_revisions(self, revisions):
1552
1319
        self._ensure_real()
1553
 
        return self._real_repository.get_deltas_for_revisions(revisions,
1554
 
            specific_fileids=specific_fileids)
 
1320
        return self._real_repository.get_deltas_for_revisions(revisions)
1555
1321
 
1556
1322
    @needs_read_lock
1557
 
    def get_revision_delta(self, revision_id, specific_fileids=None):
 
1323
    def get_revision_delta(self, revision_id):
1558
1324
        self._ensure_real()
1559
 
        return self._real_repository.get_revision_delta(revision_id,
1560
 
            specific_fileids=specific_fileids)
 
1325
        return self._real_repository.get_revision_delta(revision_id)
1561
1326
 
1562
1327
    @needs_read_lock
1563
1328
    def revision_trees(self, revision_ids):
1570
1335
        return self._real_repository.get_revision_reconcile(revision_id)
1571
1336
 
1572
1337
    @needs_read_lock
1573
 
    def check(self, revision_ids=None, callback_refs=None, check_repo=True):
 
1338
    def check(self, revision_ids=None):
1574
1339
        self._ensure_real()
1575
 
        return self._real_repository.check(revision_ids=revision_ids,
1576
 
            callback_refs=callback_refs, check_repo=check_repo)
 
1340
        return self._real_repository.check(revision_ids=revision_ids)
1577
1341
 
1578
1342
    def copy_content_into(self, destination, revision_id=None):
1579
1343
        self._ensure_real()
1619
1383
        return self._real_repository.inventories
1620
1384
 
1621
1385
    @needs_write_lock
1622
 
    def pack(self, hint=None, clean_obsolete_packs=False):
 
1386
    def pack(self):
1623
1387
        """Compress the data within the repository.
1624
1388
 
1625
1389
        This is not currently implemented within the smart server.
1626
1390
        """
1627
1391
        self._ensure_real()
1628
 
        return self._real_repository.pack(hint=hint, clean_obsolete_packs=clean_obsolete_packs)
 
1392
        return self._real_repository.pack()
1629
1393
 
1630
1394
    @property
1631
1395
    def revisions(self):
1719
1483
        self._ensure_real()
1720
1484
        return self._real_repository.revision_graph_can_have_wrong_parents()
1721
1485
 
1722
 
    def _find_inconsistent_revision_parents(self, revisions_iterator=None):
 
1486
    def _find_inconsistent_revision_parents(self):
1723
1487
        self._ensure_real()
1724
 
        return self._real_repository._find_inconsistent_revision_parents(
1725
 
            revisions_iterator)
 
1488
        return self._real_repository._find_inconsistent_revision_parents()
1726
1489
 
1727
1490
    def _check_for_inconsistent_revision_parents(self):
1728
1491
        self._ensure_real()
1734
1497
            providers.insert(0, other)
1735
1498
        providers.extend(r._make_parents_provider() for r in
1736
1499
                         self._fallback_repositories)
1737
 
        return graph.StackedParentsProvider(providers)
 
1500
        return graph._StackedParentsProvider(providers)
1738
1501
 
1739
1502
    def _serialise_search_recipe(self, recipe):
1740
1503
        """Serialise a graph search recipe.
1781
1544
 
1782
1545
    def insert_stream(self, stream, src_format, resume_tokens):
1783
1546
        target = self.target_repo
1784
 
        target._unstacked_provider.missing_keys.clear()
1785
 
        candidate_calls = [('Repository.insert_stream_1.19', (1, 19))]
1786
1547
        if target._lock_token:
1787
 
            candidate_calls.append(('Repository.insert_stream_locked', (1, 14)))
1788
 
            lock_args = (target._lock_token or '',)
 
1548
            verb = 'Repository.insert_stream_locked'
 
1549
            extra_args = (target._lock_token or '',)
 
1550
            required_version = (1, 14)
1789
1551
        else:
1790
 
            candidate_calls.append(('Repository.insert_stream', (1, 13)))
1791
 
            lock_args = ()
 
1552
            verb = 'Repository.insert_stream'
 
1553
            extra_args = ()
 
1554
            required_version = (1, 13)
1792
1555
        client = target._client
1793
1556
        medium = client._medium
 
1557
        if medium._is_remote_before(required_version):
 
1558
            # No possible way this can work.
 
1559
            return self._insert_real(stream, src_format, resume_tokens)
1794
1560
        path = target.bzrdir._path_for_remote_call(client)
1795
 
        # Probe for the verb to use with an empty stream before sending the
1796
 
        # real stream to it.  We do this both to avoid the risk of sending a
1797
 
        # large request that is then rejected, and because we don't want to
1798
 
        # implement a way to buffer, rewind, or restart the stream.
1799
 
        found_verb = False
1800
 
        for verb, required_version in candidate_calls:
1801
 
            if medium._is_remote_before(required_version):
1802
 
                continue
1803
 
            if resume_tokens:
1804
 
                # We've already done the probing (and set _is_remote_before) on
1805
 
                # a previous insert.
1806
 
                found_verb = True
1807
 
                break
 
1561
        if not resume_tokens:
 
1562
            # XXX: Ugly but important for correctness, *will* be fixed during
 
1563
            # 1.13 cycle. Pushing a stream that is interrupted results in a
 
1564
            # fallback to the _real_repositories sink *with a partial stream*.
 
1565
            # Thats bad because we insert less data than bzr expected. To avoid
 
1566
            # this we do a trial push to make sure the verb is accessible, and
 
1567
            # do not fallback when actually pushing the stream. A cleanup patch
 
1568
            # is going to look at rewinding/restarting the stream/partial
 
1569
            # buffering etc.
1808
1570
            byte_stream = smart_repo._stream_to_byte_stream([], src_format)
1809
1571
            try:
1810
1572
                response = client.call_with_body_stream(
1811
 
                    (verb, path, '') + lock_args, byte_stream)
 
1573
                    (verb, path, '') + extra_args, byte_stream)
1812
1574
            except errors.UnknownSmartMethod:
1813
1575
                medium._remember_remote_is_before(required_version)
1814
 
            else:
1815
 
                found_verb = True
1816
 
                break
1817
 
        if not found_verb:
1818
 
            # Have to use VFS.
1819
 
            return self._insert_real(stream, src_format, resume_tokens)
1820
 
        self._last_inv_record = None
1821
 
        self._last_substream = None
1822
 
        if required_version < (1, 19):
1823
 
            # Remote side doesn't support inventory deltas.  Wrap the stream to
1824
 
            # make sure we don't send any.  If the stream contains inventory
1825
 
            # deltas we'll interrupt the smart insert_stream request and
1826
 
            # fallback to VFS.
1827
 
            stream = self._stop_stream_if_inventory_delta(stream)
 
1576
                return self._insert_real(stream, src_format, resume_tokens)
1828
1577
        byte_stream = smart_repo._stream_to_byte_stream(
1829
1578
            stream, src_format)
1830
1579
        resume_tokens = ' '.join(resume_tokens)
1831
1580
        response = client.call_with_body_stream(
1832
 
            (verb, path, resume_tokens) + lock_args, byte_stream)
 
1581
            (verb, path, resume_tokens) + extra_args, byte_stream)
1833
1582
        if response[0][0] not in ('ok', 'missing-basis'):
1834
1583
            raise errors.UnexpectedSmartServerResponse(response)
1835
 
        if self._last_substream is not None:
1836
 
            # The stream included an inventory-delta record, but the remote
1837
 
            # side isn't new enough to support them.  So we need to send the
1838
 
            # rest of the stream via VFS.
1839
 
            self.target_repo.refresh_data()
1840
 
            return self._resume_stream_with_vfs(response, src_format)
1841
1584
        if response[0][0] == 'missing-basis':
1842
1585
            tokens, missing_keys = bencode.bdecode_as_tuple(response[0][1])
1843
1586
            resume_tokens = tokens
1844
 
            return resume_tokens, set(missing_keys)
 
1587
            return resume_tokens, missing_keys
1845
1588
        else:
1846
1589
            self.target_repo.refresh_data()
1847
1590
            return [], set()
1848
1591
 
1849
 
    def _resume_stream_with_vfs(self, response, src_format):
1850
 
        """Resume sending a stream via VFS, first resending the record and
1851
 
        substream that couldn't be sent via an insert_stream verb.
1852
 
        """
1853
 
        if response[0][0] == 'missing-basis':
1854
 
            tokens, missing_keys = bencode.bdecode_as_tuple(response[0][1])
1855
 
            # Ignore missing_keys, we haven't finished inserting yet
1856
 
        else:
1857
 
            tokens = []
1858
 
        def resume_substream():
1859
 
            # Yield the substream that was interrupted.
1860
 
            for record in self._last_substream:
1861
 
                yield record
1862
 
            self._last_substream = None
1863
 
        def resume_stream():
1864
 
            # Finish sending the interrupted substream
1865
 
            yield ('inventory-deltas', resume_substream())
1866
 
            # Then simply continue sending the rest of the stream.
1867
 
            for substream_kind, substream in self._last_stream:
1868
 
                yield substream_kind, substream
1869
 
        return self._insert_real(resume_stream(), src_format, tokens)
1870
 
 
1871
 
    def _stop_stream_if_inventory_delta(self, stream):
1872
 
        """Normally this just lets the original stream pass-through unchanged.
1873
 
 
1874
 
        However if any 'inventory-deltas' substream occurs it will stop
1875
 
        streaming, and store the interrupted substream and stream in
1876
 
        self._last_substream and self._last_stream so that the stream can be
1877
 
        resumed by _resume_stream_with_vfs.
1878
 
        """
1879
 
                    
1880
 
        stream_iter = iter(stream)
1881
 
        for substream_kind, substream in stream_iter:
1882
 
            if substream_kind == 'inventory-deltas':
1883
 
                self._last_substream = substream
1884
 
                self._last_stream = stream_iter
1885
 
                return
1886
 
            else:
1887
 
                yield substream_kind, substream
1888
 
            
1889
1592
 
1890
1593
class RemoteStreamSource(repository.StreamSource):
1891
1594
    """Stream data from a remote server."""
1894
1597
        if (self.from_repository._fallback_repositories and
1895
1598
            self.to_format._fetch_order == 'topological'):
1896
1599
            return self._real_stream(self.from_repository, search)
1897
 
        sources = []
1898
 
        seen = set()
1899
 
        repos = [self.from_repository]
1900
 
        while repos:
1901
 
            repo = repos.pop(0)
1902
 
            if repo in seen:
1903
 
                continue
1904
 
            seen.add(repo)
1905
 
            repos.extend(repo._fallback_repositories)
1906
 
            sources.append(repo)
1907
 
        return self.missing_parents_chain(search, sources)
1908
 
 
1909
 
    def get_stream_for_missing_keys(self, missing_keys):
1910
 
        self.from_repository._ensure_real()
1911
 
        real_repo = self.from_repository._real_repository
1912
 
        real_source = real_repo._get_source(self.to_format)
1913
 
        return real_source.get_stream_for_missing_keys(missing_keys)
 
1600
        return self.missing_parents_chain(search, [self.from_repository] +
 
1601
            self.from_repository._fallback_repositories)
1914
1602
 
1915
1603
    def _real_stream(self, repo, search):
1916
1604
        """Get a stream for search from repo.
1923
1611
        """
1924
1612
        source = repo._get_source(self.to_format)
1925
1613
        if isinstance(source, RemoteStreamSource):
1926
 
            repo._ensure_real()
1927
 
            source = repo._real_repository._get_source(self.to_format)
 
1614
            return repository.StreamSource.get_stream(source, search)
1928
1615
        return source.get_stream(search)
1929
1616
 
1930
1617
    def _get_stream(self, repo, search):
1947
1634
            return self._real_stream(repo, search)
1948
1635
        client = repo._client
1949
1636
        medium = client._medium
 
1637
        if medium._is_remote_before((1, 13)):
 
1638
            # streaming was added in 1.13
 
1639
            return self._real_stream(repo, search)
1950
1640
        path = repo.bzrdir._path_for_remote_call(client)
1951
 
        search_bytes = repo._serialise_search_result(search)
1952
 
        args = (path, self.to_format.network_name())
1953
 
        candidate_verbs = [
1954
 
            ('Repository.get_stream_1.19', (1, 19)),
1955
 
            ('Repository.get_stream', (1, 13))]
1956
 
        found_verb = False
1957
 
        for verb, version in candidate_verbs:
1958
 
            if medium._is_remote_before(version):
1959
 
                continue
1960
 
            try:
1961
 
                response = repo._call_with_body_bytes_expecting_body(
1962
 
                    verb, args, search_bytes)
1963
 
            except errors.UnknownSmartMethod:
1964
 
                medium._remember_remote_is_before(version)
1965
 
            else:
1966
 
                response_tuple, response_handler = response
1967
 
                found_verb = True
1968
 
                break
1969
 
        if not found_verb:
 
1641
        try:
 
1642
            search_bytes = repo._serialise_search_result(search)
 
1643
            response = repo._call_with_body_bytes_expecting_body(
 
1644
                'Repository.get_stream',
 
1645
                (path, self.to_format.network_name()), search_bytes)
 
1646
            response_tuple, response_handler = response
 
1647
        except errors.UnknownSmartMethod:
 
1648
            medium._remember_remote_is_before((1,13))
1970
1649
            return self._real_stream(repo, search)
1971
1650
        if response_tuple[0] != 'ok':
1972
1651
            raise errors.UnexpectedSmartServerResponse(response_tuple)
1984
1663
        :param search: The overall search to satisfy with streams.
1985
1664
        :param sources: A list of Repository objects to query.
1986
1665
        """
1987
 
        self.from_serialiser = self.from_repository._format._serializer
 
1666
        self.serialiser = self.to_format._serializer
1988
1667
        self.seen_revs = set()
1989
1668
        self.referenced_revs = set()
1990
1669
        # If there are heads in the search, or the key count is > 0, we are not
2007
1686
    def missing_parents_rev_handler(self, substream):
2008
1687
        for content in substream:
2009
1688
            revision_bytes = content.get_bytes_as('fulltext')
2010
 
            revision = self.from_serialiser.read_revision_from_string(
2011
 
                revision_bytes)
 
1689
            revision = self.serialiser.read_revision_from_string(revision_bytes)
2012
1690
            self.seen_revs.add(content.key[-1])
2013
1691
            self.referenced_revs.update(revision.parent_ids)
2014
1692
            yield content
2053
1731
                self._network_name)
2054
1732
 
2055
1733
    def get_format_description(self):
2056
 
        self._ensure_real()
2057
 
        return 'Remote: ' + self._custom_format.get_format_description()
 
1734
        return 'Remote BZR Branch'
2058
1735
 
2059
1736
    def network_name(self):
2060
1737
        return self._network_name
2061
1738
 
2062
 
    def open(self, a_bzrdir, name=None, ignore_fallbacks=False):
2063
 
        return a_bzrdir.open_branch(name=name, 
2064
 
            ignore_fallbacks=ignore_fallbacks)
 
1739
    def open(self, a_bzrdir):
 
1740
        return a_bzrdir.open_branch()
2065
1741
 
2066
 
    def _vfs_initialize(self, a_bzrdir, name):
 
1742
    def _vfs_initialize(self, a_bzrdir):
2067
1743
        # Initialisation when using a local bzrdir object, or a non-vfs init
2068
1744
        # method is not available on the server.
2069
1745
        # self._custom_format is always set - the start of initialize ensures
2070
1746
        # that.
2071
1747
        if isinstance(a_bzrdir, RemoteBzrDir):
2072
1748
            a_bzrdir._ensure_real()
2073
 
            result = self._custom_format.initialize(a_bzrdir._real_bzrdir,
2074
 
                name)
 
1749
            result = self._custom_format.initialize(a_bzrdir._real_bzrdir)
2075
1750
        else:
2076
1751
            # We assume the bzrdir is parameterised; it may not be.
2077
 
            result = self._custom_format.initialize(a_bzrdir, name)
 
1752
            result = self._custom_format.initialize(a_bzrdir)
2078
1753
        if (isinstance(a_bzrdir, RemoteBzrDir) and
2079
1754
            not isinstance(result, RemoteBranch)):
2080
 
            result = RemoteBranch(a_bzrdir, a_bzrdir.find_repository(), result,
2081
 
                                  name=name)
 
1755
            result = RemoteBranch(a_bzrdir, a_bzrdir.find_repository(), result)
2082
1756
        return result
2083
1757
 
2084
 
    def initialize(self, a_bzrdir, name=None):
 
1758
    def initialize(self, a_bzrdir):
2085
1759
        # 1) get the network name to use.
2086
1760
        if self._custom_format:
2087
1761
            network_name = self._custom_format.network_name()
2093
1767
            network_name = reference_format.network_name()
2094
1768
        # Being asked to create on a non RemoteBzrDir:
2095
1769
        if not isinstance(a_bzrdir, RemoteBzrDir):
2096
 
            return self._vfs_initialize(a_bzrdir, name=name)
 
1770
            return self._vfs_initialize(a_bzrdir)
2097
1771
        medium = a_bzrdir._client._medium
2098
1772
        if medium._is_remote_before((1, 13)):
2099
 
            return self._vfs_initialize(a_bzrdir, name=name)
 
1773
            return self._vfs_initialize(a_bzrdir)
2100
1774
        # Creating on a remote bzr dir.
2101
1775
        # 2) try direct creation via RPC
2102
1776
        path = a_bzrdir._path_for_remote_call(a_bzrdir._client)
2103
 
        if name is not None:
2104
 
            # XXX JRV20100304: Support creating colocated branches
2105
 
            raise errors.NoColocatedBranchSupport(self)
2106
1777
        verb = 'BzrDir.create_branch'
2107
1778
        try:
2108
1779
            response = a_bzrdir._call(verb, path, network_name)
2109
1780
        except errors.UnknownSmartMethod:
2110
1781
            # Fallback - use vfs methods
2111
1782
            medium._remember_remote_is_before((1, 13))
2112
 
            return self._vfs_initialize(a_bzrdir, name=name)
 
1783
            return self._vfs_initialize(a_bzrdir)
2113
1784
        if response[0] != 'ok':
2114
1785
            raise errors.UnexpectedSmartServerResponse(response)
2115
1786
        # Turn the response into a RemoteRepository object.
2123
1794
                a_bzrdir._client)
2124
1795
        remote_repo = RemoteRepository(repo_bzrdir, repo_format)
2125
1796
        remote_branch = RemoteBranch(a_bzrdir, remote_repo,
2126
 
            format=format, setup_stacking=False, name=name)
 
1797
            format=format, setup_stacking=False)
2127
1798
        # XXX: We know this is a new branch, so it must have revno 0, revid
2128
1799
        # NULL_REVISION. Creating the branch locked would make this be unable
2129
1800
        # to be wrong; here its simply very unlikely to be wrong. RBC 20090225
2144
1815
        self._ensure_real()
2145
1816
        return self._custom_format.supports_stacking()
2146
1817
 
2147
 
    def supports_set_append_revisions_only(self):
2148
 
        self._ensure_real()
2149
 
        return self._custom_format.supports_set_append_revisions_only()
2150
 
 
2151
 
 
2152
 
class RemoteBranch(branch.Branch, _RpcHelper, lock._RelockDebugMixin):
 
1818
 
 
1819
class RemoteBranch(branch.Branch, _RpcHelper):
2153
1820
    """Branch stored on a server accessed by HPSS RPC.
2154
1821
 
2155
1822
    At the moment most operations are mapped down to simple file operations.
2156
1823
    """
2157
1824
 
2158
1825
    def __init__(self, remote_bzrdir, remote_repository, real_branch=None,
2159
 
        _client=None, format=None, setup_stacking=True, name=None):
 
1826
        _client=None, format=None, setup_stacking=True):
2160
1827
        """Create a RemoteBranch instance.
2161
1828
 
2162
1829
        :param real_branch: An optional local implementation of the branch
2168
1835
        :param setup_stacking: If True make an RPC call to determine the
2169
1836
            stacked (or not) status of the branch. If False assume the branch
2170
1837
            is not stacked.
2171
 
        :param name: Colocated branch name
2172
1838
        """
2173
1839
        # We intentionally don't call the parent class's __init__, because it
2174
1840
        # will try to assign to self.tags, which is a property in this subclass.
2175
1841
        # And the parent's __init__ doesn't do much anyway.
 
1842
        self._revision_id_to_revno_cache = None
 
1843
        self._partial_revision_id_to_revno_cache = {}
 
1844
        self._revision_history_cache = None
 
1845
        self._last_revision_info_cache = None
 
1846
        self._merge_sorted_revisions_cache = None
2176
1847
        self.bzrdir = remote_bzrdir
2177
1848
        if _client is not None:
2178
1849
            self._client = _client
2191
1862
            self._real_branch.repository = self.repository
2192
1863
        else:
2193
1864
            self._real_branch = None
2194
 
        # Fill out expected attributes of branch for bzrlib API users.
2195
 
        self._clear_cached_state()
2196
 
        # TODO: deprecate self.base in favor of user_url
2197
 
        self.base = self.bzrdir.user_url
2198
 
        self._name = name
 
1865
        # Fill out expected attributes of branch for bzrlib api users.
 
1866
        self.base = self.bzrdir.root_transport.base
2199
1867
        self._control_files = None
2200
1868
        self._lock_mode = None
2201
1869
        self._lock_token = None
2212
1880
                    self._real_branch._format.network_name()
2213
1881
        else:
2214
1882
            self._format = format
2215
 
        # when we do _ensure_real we may need to pass ignore_fallbacks to the
2216
 
        # branch.open_branch method.
2217
 
        self._real_ignore_fallbacks = not setup_stacking
2218
1883
        if not self._format._network_name:
2219
1884
            # Did not get from open_branchV2 - old server.
2220
1885
            self._ensure_real()
2225
1890
        hooks = branch.Branch.hooks['open']
2226
1891
        for hook in hooks:
2227
1892
            hook(self)
2228
 
        self._is_stacked = False
2229
1893
        if setup_stacking:
2230
1894
            self._setup_stacking()
2231
1895
 
2237
1901
        except (errors.NotStacked, errors.UnstackableBranchFormat,
2238
1902
            errors.UnstackableRepositoryFormat), e:
2239
1903
            return
2240
 
        self._is_stacked = True
2241
 
        self._activate_fallback_location(fallback_url)
2242
 
 
2243
 
    def _get_config(self):
2244
 
        return RemoteBranchConfig(self)
 
1904
        # it's relative to this branch...
 
1905
        fallback_url = urlutils.join(self.base, fallback_url)
 
1906
        transports = [self.bzrdir.root_transport]
 
1907
        stacked_on = branch.Branch.open(fallback_url,
 
1908
                                        possible_transports=transports)
 
1909
        self.repository.add_fallback_repository(stacked_on.repository)
2245
1910
 
2246
1911
    def _get_real_transport(self):
2247
1912
        # if we try vfs access, return the real branch's vfs transport
2265
1930
                raise AssertionError('smart server vfs must be enabled '
2266
1931
                    'to use vfs implementation')
2267
1932
            self.bzrdir._ensure_real()
2268
 
            self._real_branch = self.bzrdir._real_bzrdir.open_branch(
2269
 
                ignore_fallbacks=self._real_ignore_fallbacks, name=self._name)
 
1933
            self._real_branch = self.bzrdir._real_bzrdir.open_branch()
2270
1934
            if self.repository._real_repository is None:
2271
1935
                # Give the remote repository the matching real repo.
2272
1936
                real_repo = self._real_branch.repository
2346
2010
            raise errors.UnexpectedSmartServerResponse(response)
2347
2011
        return response[1]
2348
2012
 
2349
 
    def set_stacked_on_url(self, url):
2350
 
        branch.Branch.set_stacked_on_url(self, url)
2351
 
        if not url:
2352
 
            self._is_stacked = False
2353
 
        else:
2354
 
            self._is_stacked = True
2355
 
        
2356
2013
    def _vfs_get_tags_bytes(self):
2357
2014
        self._ensure_real()
2358
2015
        return self._real_branch._get_tags_bytes()
2368
2025
            return self._vfs_get_tags_bytes()
2369
2026
        return response[0]
2370
2027
 
2371
 
    def _vfs_set_tags_bytes(self, bytes):
2372
 
        self._ensure_real()
2373
 
        return self._real_branch._set_tags_bytes(bytes)
2374
 
 
2375
 
    def _set_tags_bytes(self, bytes):
2376
 
        medium = self._client._medium
2377
 
        if medium._is_remote_before((1, 18)):
2378
 
            self._vfs_set_tags_bytes(bytes)
2379
 
            return
2380
 
        try:
2381
 
            args = (
2382
 
                self._remote_path(), self._lock_token, self._repo_lock_token)
2383
 
            response = self._call_with_body_bytes(
2384
 
                'Branch.set_tags_bytes', args, bytes)
2385
 
        except errors.UnknownSmartMethod:
2386
 
            medium._remember_remote_is_before((1, 18))
2387
 
            self._vfs_set_tags_bytes(bytes)
2388
 
 
2389
2028
    def lock_read(self):
2390
2029
        self.repository.lock_read()
2391
2030
        if not self._lock_mode:
2392
 
            self._note_lock('r')
2393
2031
            self._lock_mode = 'r'
2394
2032
            self._lock_count = 1
2395
2033
            if self._real_branch is not None:
2415
2053
 
2416
2054
    def lock_write(self, token=None):
2417
2055
        if not self._lock_mode:
2418
 
            self._note_lock('w')
2419
2056
            # Lock the branch and repo in one remote call.
2420
2057
            remote_tokens = self._remote_lock_write(token)
2421
2058
            self._lock_token, self._repo_lock_token = remote_tokens
2447
2084
            self.repository.lock_write(self._repo_lock_token)
2448
2085
        return self._lock_token or None
2449
2086
 
 
2087
    def _set_tags_bytes(self, bytes):
 
2088
        self._ensure_real()
 
2089
        return self._real_branch._set_tags_bytes(bytes)
 
2090
 
2450
2091
    def _unlock(self, branch_token, repo_token):
2451
2092
        err_context = {'token': str((branch_token, repo_token))}
2452
2093
        response = self._call(
2456
2097
            return
2457
2098
        raise errors.UnexpectedSmartServerResponse(response)
2458
2099
 
2459
 
    @only_raises(errors.LockNotHeld, errors.LockBroken)
2460
2100
    def unlock(self):
2461
2101
        try:
2462
2102
            self._lock_count -= 1
2475
2115
                    self._real_branch.unlock()
2476
2116
                if mode != 'w':
2477
2117
                    # Only write-locked branched need to make a remote method
2478
 
                    # call to perform the unlock.
 
2118
                    # call to perfom the unlock.
2479
2119
                    return
2480
2120
                if not self._lock_token:
2481
2121
                    raise AssertionError('Locked, but no token!')
2502
2142
            raise NotImplementedError(self.dont_leave_lock_in_place)
2503
2143
        self._leave_lock = False
2504
2144
 
2505
 
    @needs_read_lock
2506
 
    def get_rev_id(self, revno, history=None):
2507
 
        if revno == 0:
2508
 
            return _mod_revision.NULL_REVISION
2509
 
        last_revision_info = self.last_revision_info()
2510
 
        ok, result = self.repository.get_rev_id_for_revno(
2511
 
            revno, last_revision_info)
2512
 
        if ok:
2513
 
            return result
2514
 
        missing_parent = result[1]
2515
 
        # Either the revision named by the server is missing, or its parent
2516
 
        # is.  Call get_parent_map to determine which, so that we report a
2517
 
        # useful error.
2518
 
        parent_map = self.repository.get_parent_map([missing_parent])
2519
 
        if missing_parent in parent_map:
2520
 
            missing_parent = parent_map[missing_parent]
2521
 
        raise errors.RevisionNotPresent(missing_parent, self.repository)
2522
 
 
2523
2145
    def _last_revision_info(self):
2524
2146
        response = self._call('Branch.last_revision_info', self._remote_path())
2525
2147
        if response[0] != 'ok':
2530
2152
 
2531
2153
    def _gen_revision_history(self):
2532
2154
        """See Branch._gen_revision_history()."""
2533
 
        if self._is_stacked:
2534
 
            self._ensure_real()
2535
 
            return self._real_branch._gen_revision_history()
2536
2155
        response_tuple, response_handler = self._call_expecting_body(
2537
2156
            'Branch.revision_history', self._remote_path())
2538
2157
        if response_tuple[0] != 'ok':
2623
2242
        self._ensure_real()
2624
2243
        return self._real_branch._get_parent_location()
2625
2244
 
 
2245
    def set_parent(self, url):
 
2246
        self._ensure_real()
 
2247
        return self._real_branch.set_parent(url)
 
2248
 
2626
2249
    def _set_parent_location(self, url):
2627
 
        medium = self._client._medium
2628
 
        if medium._is_remote_before((1, 15)):
2629
 
            return self._vfs_set_parent_location(url)
2630
 
        try:
2631
 
            call_url = url or ''
2632
 
            if type(call_url) is not str:
2633
 
                raise AssertionError('url must be a str or None (%s)' % url)
2634
 
            response = self._call('Branch.set_parent_location',
2635
 
                self._remote_path(), self._lock_token, self._repo_lock_token,
2636
 
                call_url)
2637
 
        except errors.UnknownSmartMethod:
2638
 
            medium._remember_remote_is_before((1, 15))
2639
 
            return self._vfs_set_parent_location(url)
2640
 
        if response != ():
2641
 
            raise errors.UnexpectedSmartServerResponse(response)
2642
 
 
2643
 
    def _vfs_set_parent_location(self, url):
 
2250
        # Used by tests, to poke bad urls into branch configurations
 
2251
        if url is None:
 
2252
            self.set_parent(url)
 
2253
        else:
 
2254
            self._ensure_real()
 
2255
            return self._real_branch._set_parent_location(url)
 
2256
 
 
2257
    def set_stacked_on_url(self, stacked_location):
 
2258
        """Set the URL this branch is stacked against.
 
2259
 
 
2260
        :raises UnstackableBranchFormat: If the branch does not support
 
2261
            stacking.
 
2262
        :raises UnstackableRepositoryFormat: If the repository does not support
 
2263
            stacking.
 
2264
        """
2644
2265
        self._ensure_real()
2645
 
        return self._real_branch._set_parent_location(url)
 
2266
        return self._real_branch.set_stacked_on_url(stacked_location)
2646
2267
 
2647
2268
    @needs_write_lock
2648
2269
    def pull(self, source, overwrite=False, stop_revision=None,
2716
2337
        return self._real_branch.set_push_location(location)
2717
2338
 
2718
2339
 
2719
 
class RemoteConfig(object):
2720
 
    """A Config that reads and writes from smart verbs.
2721
 
 
2722
 
    It is a low-level object that considers config data to be name/value pairs
2723
 
    that may be associated with a section. Assigning meaning to the these
2724
 
    values is done at higher levels like bzrlib.config.TreeConfig.
2725
 
    """
2726
 
 
2727
 
    def get_option(self, name, section=None, default=None):
2728
 
        """Return the value associated with a named option.
2729
 
 
2730
 
        :param name: The name of the value
2731
 
        :param section: The section the option is in (if any)
2732
 
        :param default: The value to return if the value is not set
2733
 
        :return: The value or default value
2734
 
        """
2735
 
        try:
2736
 
            configobj = self._get_configobj()
2737
 
            if section is None:
2738
 
                section_obj = configobj
2739
 
            else:
2740
 
                try:
2741
 
                    section_obj = configobj[section]
2742
 
                except KeyError:
2743
 
                    return default
2744
 
            return section_obj.get(name, default)
2745
 
        except errors.UnknownSmartMethod:
2746
 
            return self._vfs_get_option(name, section, default)
2747
 
 
2748
 
    def _response_to_configobj(self, response):
2749
 
        if len(response[0]) and response[0][0] != 'ok':
2750
 
            raise errors.UnexpectedSmartServerResponse(response)
2751
 
        lines = response[1].read_body_bytes().splitlines()
2752
 
        return config.ConfigObj(lines, encoding='utf-8')
2753
 
 
2754
 
 
2755
 
class RemoteBranchConfig(RemoteConfig):
2756
 
    """A RemoteConfig for Branches."""
2757
 
 
2758
 
    def __init__(self, branch):
2759
 
        self._branch = branch
2760
 
 
2761
 
    def _get_configobj(self):
2762
 
        path = self._branch._remote_path()
2763
 
        response = self._branch._client.call_expecting_body(
2764
 
            'Branch.get_config_file', path)
2765
 
        return self._response_to_configobj(response)
2766
 
 
2767
 
    def set_option(self, value, name, section=None):
2768
 
        """Set the value associated with a named option.
2769
 
 
2770
 
        :param value: The value to set
2771
 
        :param name: The name of the value to set
2772
 
        :param section: The section the option is in (if any)
2773
 
        """
2774
 
        medium = self._branch._client._medium
2775
 
        if medium._is_remote_before((1, 14)):
2776
 
            return self._vfs_set_option(value, name, section)
2777
 
        try:
2778
 
            path = self._branch._remote_path()
2779
 
            response = self._branch._client.call('Branch.set_config_option',
2780
 
                path, self._branch._lock_token, self._branch._repo_lock_token,
2781
 
                value.encode('utf8'), name, section or '')
2782
 
        except errors.UnknownSmartMethod:
2783
 
            medium._remember_remote_is_before((1, 14))
2784
 
            return self._vfs_set_option(value, name, section)
2785
 
        if response != ():
2786
 
            raise errors.UnexpectedSmartServerResponse(response)
2787
 
 
2788
 
    def _real_object(self):
2789
 
        self._branch._ensure_real()
2790
 
        return self._branch._real_branch
2791
 
 
2792
 
    def _vfs_set_option(self, value, name, section=None):
2793
 
        return self._real_object()._get_config().set_option(
2794
 
            value, name, section)
2795
 
 
2796
 
 
2797
 
class RemoteBzrDirConfig(RemoteConfig):
2798
 
    """A RemoteConfig for BzrDirs."""
2799
 
 
2800
 
    def __init__(self, bzrdir):
2801
 
        self._bzrdir = bzrdir
2802
 
 
2803
 
    def _get_configobj(self):
2804
 
        medium = self._bzrdir._client._medium
2805
 
        verb = 'BzrDir.get_config_file'
2806
 
        if medium._is_remote_before((1, 15)):
2807
 
            raise errors.UnknownSmartMethod(verb)
2808
 
        path = self._bzrdir._path_for_remote_call(self._bzrdir._client)
2809
 
        response = self._bzrdir._call_expecting_body(
2810
 
            verb, path)
2811
 
        return self._response_to_configobj(response)
2812
 
 
2813
 
    def _vfs_get_option(self, name, section, default):
2814
 
        return self._real_object()._get_config().get_option(
2815
 
            name, section, default)
2816
 
 
2817
 
    def set_option(self, value, name, section=None):
2818
 
        """Set the value associated with a named option.
2819
 
 
2820
 
        :param value: The value to set
2821
 
        :param name: The name of the value to set
2822
 
        :param section: The section the option is in (if any)
2823
 
        """
2824
 
        return self._real_object()._get_config().set_option(
2825
 
            value, name, section)
2826
 
 
2827
 
    def _real_object(self):
2828
 
        self._bzrdir._ensure_real()
2829
 
        return self._bzrdir._real_bzrdir
2830
 
 
2831
 
 
2832
 
 
2833
2340
def _extract_tar(tar, to_dir):
2834
2341
    """Extract all the contents of a tarfile object.
2835
2342
 
2873
2380
                    'Missing key %r in context %r', key_err.args[0], context)
2874
2381
                raise err
2875
2382
 
2876
 
    if err.error_verb == 'IncompatibleRepositories':
2877
 
        raise errors.IncompatibleRepositories(err.error_args[0],
2878
 
            err.error_args[1], err.error_args[2])
2879
 
    elif err.error_verb == 'NoSuchRevision':
 
2383
    if err.error_verb == 'NoSuchRevision':
2880
2384
        raise NoSuchRevision(find('branch'), err.error_args[0])
2881
2385
    elif err.error_verb == 'nosuchrevision':
2882
2386
        raise NoSuchRevision(find('repository'), err.error_args[0])
2883
 
    elif err.error_verb == 'nobranch':
2884
 
        if len(err.error_args) >= 1:
2885
 
            extra = err.error_args[0]
2886
 
        else:
2887
 
            extra = None
2888
 
        raise errors.NotBranchError(path=find('bzrdir').root_transport.base,
2889
 
            detail=extra)
 
2387
    elif err.error_tuple == ('nobranch',):
 
2388
        raise errors.NotBranchError(path=find('bzrdir').root_transport.base)
2890
2389
    elif err.error_verb == 'norepository':
2891
2390
        raise errors.NoRepositoryPresent(find('bzrdir'))
2892
2391
    elif err.error_verb == 'LockContention':