/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/remote.py

  • Committer: James Westby
  • Date: 2009-03-12 06:04:54 UTC
  • mto: This revision was merged to the branch mainline in revision 4139.
  • Revision ID: james.westby@canonical.com-20090312060454-f04pmpufns32zyk6
Move the shelve docs from bzrtools to the main help.

Also change them to document the new "shelve" rather than the old one.

Show diffs side-by-side

added added

removed removed

Lines of Context:
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
 
from bzrlib.branch import BranchReferenceFormat, BranchWriteLockResult
 
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,
43
42
from bzrlib.lockable_files import LockableFiles
44
43
from bzrlib.smart import client, vfs, repository as smart_repo
45
44
from bzrlib.revision import ensure_null, NULL_REVISION
46
 
from bzrlib.repository import RepositoryWriteLockResult
47
45
from bzrlib.trace import mutter, note, warning
 
46
from bzrlib.util import bencode
48
47
 
49
48
 
50
49
class _RpcHelper(object):
62
61
        except errors.ErrorFromSmartServer, err:
63
62
            self._translate_error(err, **err_context)
64
63
 
65
 
    def _call_with_body_bytes(self, method, args, body_bytes, **err_context):
66
 
        try:
67
 
            return self._client.call_with_body_bytes(method, args, body_bytes)
68
 
        except errors.ErrorFromSmartServer, err:
69
 
            self._translate_error(err, **err_context)
70
 
 
71
64
    def _call_with_body_bytes_expecting_body(self, method, args, body_bytes,
72
65
                                             **err_context):
73
66
        try:
80
73
def response_tuple_to_repo_format(response):
81
74
    """Convert a response tuple describing a repository format to a format."""
82
75
    format = RemoteRepositoryFormat()
83
 
    format._rich_root_data = (response[0] == 'yes')
84
 
    format._supports_tree_reference = (response[1] == 'yes')
85
 
    format._supports_external_lookups = (response[2] == 'yes')
 
76
    format.rich_root_data = (response[0] == 'yes')
 
77
    format.supports_tree_reference = (response[1] == 'yes')
 
78
    format.supports_external_lookups = (response[2] == 'yes')
86
79
    format._network_name = response[3]
87
80
    return format
88
81
 
92
85
class RemoteBzrDir(BzrDir, _RpcHelper):
93
86
    """Control directory on a remote server, accessed via bzr:// or similar."""
94
87
 
95
 
    def __init__(self, transport, format, _client=None, _force_probe=False):
 
88
    def __init__(self, transport, format, _client=None):
96
89
        """Construct a RemoteBzrDir.
97
90
 
98
91
        :param _client: Private parameter for testing. Disables probing and the
102
95
        # this object holds a delegated bzrdir that uses file-level operations
103
96
        # to talk to the other side
104
97
        self._real_bzrdir = None
105
 
        self._has_working_tree = None
106
98
        # 1-shot cache for the call pattern 'create_branch; open_branch' - see
107
99
        # create_branch for details.
108
100
        self._next_open_branch_result = None
112
104
            self._client = client._SmartClient(medium)
113
105
        else:
114
106
            self._client = _client
115
 
            if not _force_probe:
116
 
                return
117
 
 
118
 
        self._probe_bzrdir()
119
 
 
120
 
    def __repr__(self):
121
 
        return '%s(%r)' % (self.__class__.__name__, self._client)
122
 
 
123
 
    def _probe_bzrdir(self):
124
 
        medium = self._client._medium
 
107
            return
 
108
 
125
109
        path = self._path_for_remote_call(self._client)
126
 
        if medium._is_remote_before((2, 1)):
127
 
            self._rpc_open(path)
128
 
            return
129
 
        try:
130
 
            self._rpc_open_2_1(path)
131
 
            return
132
 
        except errors.UnknownSmartMethod:
133
 
            medium._remember_remote_is_before((2, 1))
134
 
            self._rpc_open(path)
135
 
 
136
 
    def _rpc_open_2_1(self, path):
137
 
        response = self._call('BzrDir.open_2.1', path)
138
 
        if response == ('no',):
139
 
            raise errors.NotBranchError(path=self.root_transport.base)
140
 
        elif response[0] == 'yes':
141
 
            if response[1] == 'yes':
142
 
                self._has_working_tree = True
143
 
            elif response[1] == 'no':
144
 
                self._has_working_tree = False
145
 
            else:
146
 
                raise errors.UnexpectedSmartServerResponse(response)
147
 
        else:
148
 
            raise errors.UnexpectedSmartServerResponse(response)
149
 
 
150
 
    def _rpc_open(self, path):
151
110
        response = self._call('BzrDir.open', path)
152
111
        if response not in [('yes',), ('no',)]:
153
112
            raise errors.UnexpectedSmartServerResponse(response)
154
113
        if response == ('no',):
155
 
            raise errors.NotBranchError(path=self.root_transport.base)
 
114
            raise errors.NotBranchError(path=transport.base)
156
115
 
157
116
    def _ensure_real(self):
158
117
        """Ensure that there is a _real_bzrdir set.
160
119
        Used before calls to self._real_bzrdir.
161
120
        """
162
121
        if not self._real_bzrdir:
163
 
            if 'hpssvfs' in debug.debug_flags:
164
 
                import traceback
165
 
                warning('VFS BzrDir access triggered\n%s',
166
 
                    ''.join(traceback.format_stack()))
167
122
            self._real_bzrdir = BzrDir.open_from_transport(
168
123
                self.root_transport, _server_formats=False)
169
124
            self._format._network_name = \
198
153
        except errors.UnknownSmartMethod:
199
154
            medium._remember_remote_is_before((1, 13))
200
155
            return self._vfs_cloning_metadir(require_stacking=require_stacking)
201
 
        except errors.UnknownErrorFromSmartServer, err:
202
 
            if err.error_tuple != ('BranchReference',):
203
 
                raise
204
 
            # We need to resolve the branch reference to determine the
205
 
            # cloning_metadir.  This causes unnecessary RPCs to open the
206
 
            # referenced branch (and bzrdir, etc) but only when the caller
207
 
            # didn't already resolve the branch reference.
208
 
            referenced_branch = self.open_branch()
209
 
            return referenced_branch.bzrdir.cloning_metadir()
210
156
        if len(response) != 3:
211
157
            raise errors.UnexpectedSmartServerResponse(response)
212
158
        control_name, repo_name, branch_info = response
245
191
        self._ensure_real()
246
192
        self._real_bzrdir.destroy_repository()
247
193
 
248
 
    def create_branch(self, name=None):
 
194
    def create_branch(self):
249
195
        # as per meta1 formats - just delegate to the format object which may
250
196
        # be parameterised.
251
 
        real_branch = self._format.get_branch_format().initialize(self,
252
 
            name=name)
 
197
        real_branch = self._format.get_branch_format().initialize(self)
253
198
        if not isinstance(real_branch, RemoteBranch):
254
 
            result = RemoteBranch(self, self.find_repository(), real_branch,
255
 
                                  name=name)
 
199
            result = RemoteBranch(self, self.find_repository(), real_branch)
256
200
        else:
257
201
            result = real_branch
258
202
        # BzrDir.clone_on_transport() uses the result of create_branch but does
264
208
        self._next_open_branch_result = result
265
209
        return result
266
210
 
267
 
    def destroy_branch(self, name=None):
 
211
    def destroy_branch(self):
268
212
        """See BzrDir.destroy_branch"""
269
213
        self._ensure_real()
270
 
        self._real_bzrdir.destroy_branch(name=name)
 
214
        self._real_bzrdir.destroy_branch()
271
215
        self._next_open_branch_result = None
272
216
 
273
217
    def create_workingtree(self, revision_id=None, from_branch=None):
292
236
    def _get_branch_reference(self):
293
237
        path = self._path_for_remote_call(self._client)
294
238
        medium = self._client._medium
295
 
        candidate_calls = [
296
 
            ('BzrDir.open_branchV3', (2, 1)),
297
 
            ('BzrDir.open_branchV2', (1, 13)),
298
 
            ('BzrDir.open_branch', None),
299
 
            ]
300
 
        for verb, required_version in candidate_calls:
301
 
            if required_version and medium._is_remote_before(required_version):
302
 
                continue
 
239
        if not medium._is_remote_before((1, 13)):
303
240
            try:
304
 
                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
305
245
            except errors.UnknownSmartMethod:
306
 
                if required_version is None:
307
 
                    raise
308
 
                medium._remember_remote_is_before(required_version)
309
 
            else:
310
 
                break
311
 
        if verb == 'BzrDir.open_branch':
312
 
            if response[0] != 'ok':
313
 
                raise errors.UnexpectedSmartServerResponse(response)
314
 
            if response[1] != '':
315
 
                return ('ref', response[1])
316
 
            else:
317
 
                return ('branch', '')
318
 
        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':
319
249
            raise errors.UnexpectedSmartServerResponse(response)
320
 
        return response
 
250
        if response[1] != '':
 
251
            return ('ref', response[1])
 
252
        else:
 
253
            return ('branch', '')
321
254
 
322
255
    def _get_tree_branch(self):
323
256
        """See BzrDir._get_tree_branch()."""
324
257
        return None, self.open_branch()
325
258
 
326
 
    def open_branch(self, name=None, unsupported=False,
327
 
                    ignore_fallbacks=False):
328
 
        if unsupported:
 
259
    def open_branch(self, _unsupported=False):
 
260
        if _unsupported:
329
261
            raise NotImplementedError('unsupported flag support not implemented yet.')
330
262
        if self._next_open_branch_result is not None:
331
263
            # See create_branch for details.
336
268
        if response[0] == 'ref':
337
269
            # a branch reference, use the existing BranchReference logic.
338
270
            format = BranchReferenceFormat()
339
 
            return format.open(self, name=name, _found=True,
340
 
                location=response[1], ignore_fallbacks=ignore_fallbacks)
 
271
            return format.open(self, _found=True, location=response[1])
341
272
        branch_format_name = response[1]
342
273
        if not branch_format_name:
343
274
            branch_format_name = None
344
275
        format = RemoteBranchFormat(network_name=branch_format_name)
345
 
        return RemoteBranch(self, self.find_repository(), format=format,
346
 
            setup_stacking=not ignore_fallbacks, name=name)
 
276
        return RemoteBranch(self, self.find_repository(), format=format)
347
277
 
348
278
    def _open_repo_v1(self, path):
349
279
        verb = 'BzrDir.find_repository'
410
340
        else:
411
341
            raise errors.NoRepositoryPresent(self)
412
342
 
413
 
    def has_workingtree(self):
414
 
        if self._has_working_tree is None:
415
 
            self._ensure_real()
416
 
            self._has_working_tree = self._real_bzrdir.has_workingtree()
417
 
        return self._has_working_tree
418
 
 
419
343
    def open_workingtree(self, recommend_upgrade=True):
420
 
        if self.has_workingtree():
 
344
        self._ensure_real()
 
345
        if self._real_bzrdir.has_workingtree():
421
346
            raise errors.NotLocalUrl(self.root_transport)
422
347
        else:
423
348
            raise errors.NoWorkingTree(self.root_transport.base)
426
351
        """Return the path to be used for this bzrdir in a remote call."""
427
352
        return client.remote_path_from_transport(self.root_transport)
428
353
 
429
 
    def get_branch_transport(self, branch_format, name=None):
 
354
    def get_branch_transport(self, branch_format):
430
355
        self._ensure_real()
431
 
        return self._real_bzrdir.get_branch_transport(branch_format, name=name)
 
356
        return self._real_bzrdir.get_branch_transport(branch_format)
432
357
 
433
358
    def get_repository_transport(self, repository_format):
434
359
        self._ensure_real()
455
380
        return self._real_bzrdir.clone(url, revision_id=revision_id,
456
381
            force_new_repo=force_new_repo, preserve_stacking=preserve_stacking)
457
382
 
458
 
    def _get_config(self):
459
 
        return RemoteBzrDirConfig(self)
 
383
    def get_config(self):
 
384
        self._ensure_real()
 
385
        return self._real_bzrdir.get_config()
460
386
 
461
387
 
462
388
class RemoteRepositoryFormat(repository.RepositoryFormat):
486
412
        self._custom_format = None
487
413
        self._network_name = None
488
414
        self._creating_bzrdir = None
489
 
        self._supports_chks = None
490
 
        self._supports_external_lookups = None
491
 
        self._supports_tree_reference = None
492
 
        self._rich_root_data = None
493
 
 
494
 
    def __repr__(self):
495
 
        return "%s(_network_name=%r)" % (self.__class__.__name__,
496
 
            self._network_name)
497
 
 
498
 
    @property
499
 
    def fast_deltas(self):
500
 
        self._ensure_real()
501
 
        return self._custom_format.fast_deltas
502
 
 
503
 
    @property
504
 
    def rich_root_data(self):
505
 
        if self._rich_root_data is None:
506
 
            self._ensure_real()
507
 
            self._rich_root_data = self._custom_format.rich_root_data
508
 
        return self._rich_root_data
509
 
 
510
 
    @property
511
 
    def supports_chks(self):
512
 
        if self._supports_chks is None:
513
 
            self._ensure_real()
514
 
            self._supports_chks = self._custom_format.supports_chks
515
 
        return self._supports_chks
516
 
 
517
 
    @property
518
 
    def supports_external_lookups(self):
519
 
        if self._supports_external_lookups is None:
520
 
            self._ensure_real()
521
 
            self._supports_external_lookups = \
522
 
                self._custom_format.supports_external_lookups
523
 
        return self._supports_external_lookups
524
 
 
525
 
    @property
526
 
    def supports_tree_reference(self):
527
 
        if self._supports_tree_reference is None:
528
 
            self._ensure_real()
529
 
            self._supports_tree_reference = \
530
 
                self._custom_format.supports_tree_reference
531
 
        return self._supports_tree_reference
532
415
 
533
416
    def _vfs_initialize(self, a_bzrdir, shared):
534
417
        """Helper for common code in initialize."""
566
449
        # 1) get the network name to use.
567
450
        if self._custom_format:
568
451
            network_name = self._custom_format.network_name()
569
 
        elif self._network_name:
570
 
            network_name = self._network_name
571
452
        else:
572
453
            # Select the current bzrlib default and ask for that.
573
454
            reference_bzrdir_format = bzrdir.format_registry.get('default')()
621
502
        return self._custom_format._fetch_reconcile
622
503
 
623
504
    def get_format_description(self):
624
 
        self._ensure_real()
625
 
        return 'Remote: ' + self._custom_format.get_format_description()
 
505
        return 'bzr remote repository'
626
506
 
627
507
    def __eq__(self, other):
628
508
        return self.__class__ is other.__class__
629
509
 
 
510
    def check_conversion_target(self, target_format):
 
511
        if self.rich_root_data and not target_format.rich_root_data:
 
512
            raise errors.BadConversionTarget(
 
513
                'Does not support rich root data.', target_format)
 
514
        if (self.supports_tree_reference and
 
515
            not getattr(target_format, 'supports_tree_reference', False)):
 
516
            raise errors.BadConversionTarget(
 
517
                'Does not support nested trees', target_format)
 
518
 
630
519
    def network_name(self):
631
520
        if self._network_name:
632
521
            return self._network_name
634
523
        return self._creating_repo._real_repository._format.network_name()
635
524
 
636
525
    @property
637
 
    def pack_compresses(self):
638
 
        self._ensure_real()
639
 
        return self._custom_format.pack_compresses
640
 
 
641
 
    @property
642
526
    def _serializer(self):
643
527
        self._ensure_real()
644
528
        return self._custom_format._serializer
645
529
 
646
530
 
647
 
class RemoteRepository(_RpcHelper, lock._RelockDebugMixin,
648
 
    bzrdir.ControlComponent):
 
531
class RemoteRepository(_RpcHelper):
649
532
    """Repository accessed over rpc.
650
533
 
651
534
    For the moment most operations are performed using local transport-backed
677
560
        self._lock_token = None
678
561
        self._lock_count = 0
679
562
        self._leave_lock = False
680
 
        # Cache of revision parents; misses are cached during read locks, and
681
 
        # write locks when no _real_repository has been set.
682
563
        self._unstacked_provider = graph.CachingParentsProvider(
683
564
            get_parent_map=self._get_parent_map_rpc)
684
565
        self._unstacked_provider.disable_cache()
694
575
        # Additional places to query for data.
695
576
        self._fallback_repositories = []
696
577
 
697
 
    @property
698
 
    def user_transport(self):
699
 
        return self.bzrdir.user_transport
700
 
 
701
 
    @property
702
 
    def control_transport(self):
703
 
        # XXX: Normally you shouldn't directly get at the remote repository
704
 
        # transport, but I'm not sure it's worth making this method
705
 
        # optional -- mbp 2010-04-21
706
 
        return self.bzrdir.get_repository_transport(None)
707
 
        
708
578
    def __str__(self):
709
579
        return "%s(%s)" % (self.__class__.__name__, self.base)
710
580
 
713
583
    def abort_write_group(self, suppress_errors=False):
714
584
        """Complete a write group on the decorated repository.
715
585
 
716
 
        Smart methods perform operations in a single step so this API
 
586
        Smart methods peform operations in a single step so this api
717
587
        is not really applicable except as a compatibility thunk
718
588
        for older plugins that don't use e.g. the CommitBuilder
719
589
        facility.
724
594
        return self._real_repository.abort_write_group(
725
595
            suppress_errors=suppress_errors)
726
596
 
727
 
    @property
728
 
    def chk_bytes(self):
729
 
        """Decorate the real repository for now.
730
 
 
731
 
        In the long term a full blown network facility is needed to avoid
732
 
        creating a real repository object locally.
733
 
        """
734
 
        self._ensure_real()
735
 
        return self._real_repository.chk_bytes
736
 
 
737
597
    def commit_write_group(self):
738
598
        """Complete a write group on the decorated repository.
739
599
 
740
 
        Smart methods perform operations in a single step so this API
 
600
        Smart methods peform operations in a single step so this api
741
601
        is not really applicable except as a compatibility thunk
742
602
        for older plugins that don't use e.g. the CommitBuilder
743
603
        facility.
753
613
        self._ensure_real()
754
614
        return self._real_repository.suspend_write_group()
755
615
 
756
 
    def get_missing_parent_inventories(self, check_for_missing_texts=True):
757
 
        self._ensure_real()
758
 
        return self._real_repository.get_missing_parent_inventories(
759
 
            check_for_missing_texts=check_for_missing_texts)
760
 
 
761
 
    def _get_rev_id_for_revno_vfs(self, revno, known_pair):
762
 
        self._ensure_real()
763
 
        return self._real_repository.get_rev_id_for_revno(
764
 
            revno, known_pair)
765
 
 
766
 
    def get_rev_id_for_revno(self, revno, known_pair):
767
 
        """See Repository.get_rev_id_for_revno."""
768
 
        path = self.bzrdir._path_for_remote_call(self._client)
769
 
        try:
770
 
            if self._client._medium._is_remote_before((1, 17)):
771
 
                return self._get_rev_id_for_revno_vfs(revno, known_pair)
772
 
            response = self._call(
773
 
                'Repository.get_rev_id_for_revno', path, revno, known_pair)
774
 
        except errors.UnknownSmartMethod:
775
 
            self._client._medium._remember_remote_is_before((1, 17))
776
 
            return self._get_rev_id_for_revno_vfs(revno, known_pair)
777
 
        if response[0] == 'ok':
778
 
            return True, response[1]
779
 
        elif response[0] == 'history-incomplete':
780
 
            known_pair = response[1:3]
781
 
            for fallback in self._fallback_repositories:
782
 
                found, result = fallback.get_rev_id_for_revno(revno, known_pair)
783
 
                if found:
784
 
                    return True, result
785
 
                else:
786
 
                    known_pair = result
787
 
            # Not found in any fallbacks
788
 
            return False, known_pair
789
 
        else:
790
 
            raise errors.UnexpectedSmartServerResponse(response)
791
 
 
792
616
    def _ensure_real(self):
793
617
        """Ensure that there is a _real_repository set.
794
618
 
795
619
        Used before calls to self._real_repository.
796
 
 
797
 
        Note that _ensure_real causes many roundtrips to the server which are
798
 
        not desirable, and prevents the use of smart one-roundtrip RPC's to
799
 
        perform complex operations (such as accessing parent data, streaming
800
 
        revisions etc). Adding calls to _ensure_real should only be done when
801
 
        bringing up new functionality, adding fallbacks for smart methods that
802
 
        require a fallback path, and never to replace an existing smart method
803
 
        invocation. If in doubt chat to the bzr network team.
804
620
        """
805
621
        if self._real_repository is None:
806
 
            if 'hpssvfs' in debug.debug_flags:
807
 
                import traceback
808
 
                warning('VFS Repository access triggered\n%s',
809
 
                    ''.join(traceback.format_stack()))
810
 
            self._unstacked_provider.missing_keys.clear()
811
622
            self.bzrdir._ensure_real()
812
623
            self._set_real_repository(
813
624
                self.bzrdir._real_bzrdir.open_repository())
840
651
        self._ensure_real()
841
652
        return self._real_repository._generate_text_key_index()
842
653
 
 
654
    @symbol_versioning.deprecated_method(symbol_versioning.one_four)
 
655
    def get_revision_graph(self, revision_id=None):
 
656
        """See Repository.get_revision_graph()."""
 
657
        return self._get_revision_graph(revision_id)
 
658
 
843
659
    def _get_revision_graph(self, revision_id):
844
660
        """Private method for using with old (< 1.2) servers to fallback."""
845
661
        if revision_id is None:
873
689
        """Return a source for streaming from this repository."""
874
690
        return RemoteStreamSource(self, to_format)
875
691
 
876
 
    @needs_read_lock
877
692
    def has_revision(self, revision_id):
878
 
        """True if this repository has a copy of the revision."""
879
 
        # Copy of bzrlib.repository.Repository.has_revision
880
 
        return revision_id in self.has_revisions((revision_id,))
 
693
        """See Repository.has_revision()."""
 
694
        if revision_id == NULL_REVISION:
 
695
            # The null revision is always present.
 
696
            return True
 
697
        path = self.bzrdir._path_for_remote_call(self._client)
 
698
        response = self._call('Repository.has_revision', path, revision_id)
 
699
        if response[0] not in ('yes', 'no'):
 
700
            raise errors.UnexpectedSmartServerResponse(response)
 
701
        if response[0] == 'yes':
 
702
            return True
 
703
        for fallback_repo in self._fallback_repositories:
 
704
            if fallback_repo.has_revision(revision_id):
 
705
                return True
 
706
        return False
881
707
 
882
 
    @needs_read_lock
883
708
    def has_revisions(self, revision_ids):
884
 
        """Probe to find out the presence of multiple revisions.
885
 
 
886
 
        :param revision_ids: An iterable of revision_ids.
887
 
        :return: A set of the revision_ids that were present.
888
 
        """
889
 
        # Copy of bzrlib.repository.Repository.has_revisions
890
 
        parent_map = self.get_parent_map(revision_ids)
891
 
        result = set(parent_map)
892
 
        if _mod_revision.NULL_REVISION in revision_ids:
893
 
            result.add(_mod_revision.NULL_REVISION)
 
709
        """See Repository.has_revisions()."""
 
710
        # FIXME: This does many roundtrips, particularly when there are
 
711
        # fallback repositories.  -- mbp 20080905
 
712
        result = set()
 
713
        for revision_id in revision_ids:
 
714
            if self.has_revision(revision_id):
 
715
                result.add(revision_id)
894
716
        return result
895
717
 
896
 
    def _has_same_fallbacks(self, other_repo):
897
 
        """Returns true if the repositories have the same fallbacks."""
898
 
        # XXX: copied from Repository; it should be unified into a base class
899
 
        # <https://bugs.edge.launchpad.net/bzr/+bug/401622>
900
 
        my_fb = self._fallback_repositories
901
 
        other_fb = other_repo._fallback_repositories
902
 
        if len(my_fb) != len(other_fb):
903
 
            return False
904
 
        for f, g in zip(my_fb, other_fb):
905
 
            if not f.has_same_location(g):
906
 
                return False
907
 
        return True
908
 
 
909
718
    def has_same_location(self, other):
910
 
        # TODO: Move to RepositoryBase and unify with the regular Repository
911
 
        # one; unfortunately the tests rely on slightly different behaviour at
912
 
        # present -- mbp 20090710
913
719
        return (self.__class__ is other.__class__ and
914
720
                self.bzrdir.transport.base == other.bzrdir.transport.base)
915
721
 
918
724
        parents_provider = self._make_parents_provider(other_repository)
919
725
        return graph.Graph(parents_provider)
920
726
 
921
 
    @needs_read_lock
922
 
    def get_known_graph_ancestry(self, revision_ids):
923
 
        """Return the known graph for a set of revision ids and their ancestors.
924
 
        """
925
 
        st = static_tuple.StaticTuple
926
 
        revision_keys = [st(r_id).intern() for r_id in revision_ids]
927
 
        known_graph = self.revisions.get_known_graph_ancestry(revision_keys)
928
 
        return graph.GraphThunkIdsToKeys(known_graph)
929
 
 
930
727
    def gather_stats(self, revid=None, committers=None):
931
728
        """See Repository.gather_stats()."""
932
729
        path = self.bzrdir._path_for_remote_call(self._client)
992
789
    def is_write_locked(self):
993
790
        return self._lock_mode == 'w'
994
791
 
995
 
    def _warn_if_deprecated(self, branch=None):
996
 
        # If we have a real repository, the check will be done there, if we
997
 
        # don't the check will be done remotely.
998
 
        pass
999
 
 
1000
792
    def lock_read(self):
1001
 
        """Lock the repository for read operations.
1002
 
 
1003
 
        :return: A bzrlib.lock.LogicalLockResult.
1004
 
        """
1005
793
        # wrong eventually - want a local lock cache context
1006
794
        if not self._lock_mode:
1007
 
            self._note_lock('r')
1008
795
            self._lock_mode = 'r'
1009
796
            self._lock_count = 1
1010
 
            self._unstacked_provider.enable_cache(cache_misses=True)
 
797
            self._unstacked_provider.enable_cache(cache_misses=False)
1011
798
            if self._real_repository is not None:
1012
799
                self._real_repository.lock_read()
1013
 
            for repo in self._fallback_repositories:
1014
 
                repo.lock_read()
1015
800
        else:
1016
801
            self._lock_count += 1
1017
 
        return lock.LogicalLockResult(self.unlock)
1018
802
 
1019
803
    def _remote_lock_write(self, token):
1020
804
        path = self.bzrdir._path_for_remote_call(self._client)
1031
815
 
1032
816
    def lock_write(self, token=None, _skip_rpc=False):
1033
817
        if not self._lock_mode:
1034
 
            self._note_lock('w')
1035
818
            if _skip_rpc:
1036
819
                if self._lock_token is not None:
1037
820
                    if token != self._lock_token:
1051
834
                self._leave_lock = False
1052
835
            self._lock_mode = 'w'
1053
836
            self._lock_count = 1
1054
 
            cache_misses = self._real_repository is None
1055
 
            self._unstacked_provider.enable_cache(cache_misses=cache_misses)
1056
 
            for repo in self._fallback_repositories:
1057
 
                # Writes don't affect fallback repos
1058
 
                repo.lock_read()
 
837
            self._unstacked_provider.enable_cache(cache_misses=False)
1059
838
        elif self._lock_mode == 'r':
1060
839
            raise errors.ReadOnlyError(self)
1061
840
        else:
1062
841
            self._lock_count += 1
1063
 
        return RepositoryWriteLockResult(self.unlock, self._lock_token or None)
 
842
        return self._lock_token or None
1064
843
 
1065
844
    def leave_lock_in_place(self):
1066
845
        if not self._lock_token:
1087
866
        if isinstance(repository, RemoteRepository):
1088
867
            raise AssertionError()
1089
868
        self._real_repository = repository
1090
 
        # three code paths happen here:
1091
 
        # 1) old servers, RemoteBranch.open() calls _ensure_real before setting
1092
 
        # up stacking. In this case self._fallback_repositories is [], and the
1093
 
        # real repo is already setup. Preserve the real repo and
1094
 
        # RemoteRepository.add_fallback_repository will avoid adding
1095
 
        # duplicates.
1096
 
        # 2) new servers, RemoteBranch.open() sets up stacking, and when
1097
 
        # ensure_real is triggered from a branch, the real repository to
1098
 
        # set already has a matching list with separate instances, but
1099
 
        # as they are also RemoteRepositories we don't worry about making the
1100
 
        # lists be identical.
1101
 
        # 3) new servers, RemoteRepository.ensure_real is triggered before
1102
 
        # RemoteBranch.ensure real, in this case we get a repo with no fallbacks
1103
 
        # and need to populate it.
1104
 
        if (self._fallback_repositories and
1105
 
            len(self._real_repository._fallback_repositories) !=
1106
 
            len(self._fallback_repositories)):
1107
 
            if len(self._real_repository._fallback_repositories):
1108
 
                raise AssertionError(
1109
 
                    "cannot cleanly remove existing _fallback_repositories")
 
869
        # If the _real_repository has _fallback_repositories, clear them out,
 
870
        # because we want it to have the same set as this repository.  This is
 
871
        # reasonable to do because the fallbacks we clear here are from a
 
872
        # "real" branch, and we're about to replace them with the equivalents
 
873
        # from a RemoteBranch.
 
874
        self._real_repository._fallback_repositories = []
1110
875
        for fb in self._fallback_repositories:
1111
876
            self._real_repository.add_fallback_repository(fb)
1112
877
        if self._lock_mode == 'w':
1119
884
    def start_write_group(self):
1120
885
        """Start a write group on the decorated repository.
1121
886
 
1122
 
        Smart methods perform operations in a single step so this API
 
887
        Smart methods peform operations in a single step so this api
1123
888
        is not really applicable except as a compatibility thunk
1124
889
        for older plugins that don't use e.g. the CommitBuilder
1125
890
        facility.
1140
905
        else:
1141
906
            raise errors.UnexpectedSmartServerResponse(response)
1142
907
 
1143
 
    @only_raises(errors.LockNotHeld, errors.LockBroken)
1144
908
    def unlock(self):
1145
909
        if not self._lock_count:
1146
 
            return lock.cant_unlock_not_held(self)
 
910
            raise errors.LockNotHeld(self)
1147
911
        self._lock_count -= 1
1148
912
        if self._lock_count > 0:
1149
913
            return
1163
927
            # problem releasing the vfs-based lock.
1164
928
            if old_mode == 'w':
1165
929
                # Only write-locked repositories need to make a remote method
1166
 
                # call to perform the unlock.
 
930
                # call to perfom the unlock.
1167
931
                old_token = self._lock_token
1168
932
                self._lock_token = None
1169
933
                if not self._leave_lock:
1170
934
                    self._unlock(old_token)
1171
 
        # Fallbacks are always 'lock_read()' so we don't pay attention to
1172
 
        # self._leave_lock
1173
 
        for repo in self._fallback_repositories:
1174
 
            repo.unlock()
1175
935
 
1176
936
    def break_lock(self):
1177
937
        # should hand off to the network
1235
995
 
1236
996
        :param repository: A repository.
1237
997
        """
1238
 
        if not self._format.supports_external_lookups:
1239
 
            raise errors.UnstackableRepositoryFormat(
1240
 
                self._format.network_name(), self.base)
 
998
        # XXX: At the moment the RemoteRepository will allow fallbacks
 
999
        # unconditionally - however, a _real_repository will usually exist,
 
1000
        # and may raise an error if it's not accommodated by the underlying
 
1001
        # format.  Eventually we should check when opening the repository
 
1002
        # whether it's willing to allow them or not.
 
1003
        #
1241
1004
        # We need to accumulate additional repositories here, to pass them in
1242
1005
        # on various RPC's.
1243
1006
        #
1244
 
        if self.is_locked():
1245
 
            # We will call fallback.unlock() when we transition to the unlocked
1246
 
            # state, so always add a lock here. If a caller passes us a locked
1247
 
            # repository, they are responsible for unlocking it later.
1248
 
            repository.lock_read()
1249
 
        self._check_fallback_repository(repository)
1250
1007
        self._fallback_repositories.append(repository)
1251
1008
        # If self._real_repository was parameterised already (e.g. because a
1252
1009
        # _real_branch had its get_stacked_on_url method called), then the
1253
1010
        # repository to be added may already be in the _real_repositories list.
1254
1011
        if self._real_repository is not None:
1255
 
            fallback_locations = [repo.user_url for repo in
1256
 
                self._real_repository._fallback_repositories]
1257
 
            if repository.user_url not in fallback_locations:
 
1012
            if repository not in self._real_repository._fallback_repositories:
1258
1013
                self._real_repository.add_fallback_repository(repository)
1259
 
 
1260
 
    def _check_fallback_repository(self, repository):
1261
 
        """Check that this repository can fallback to repository safely.
1262
 
 
1263
 
        Raise an error if not.
1264
 
 
1265
 
        :param repository: A repository to fallback to.
1266
 
        """
1267
 
        return _mod_repository.InterRepository._assert_same_model(
1268
 
            self, repository)
 
1014
        else:
 
1015
            # They are also seen by the fallback repository.  If it doesn't
 
1016
            # exist yet they'll be added then.  This implicitly copies them.
 
1017
            self._ensure_real()
1269
1018
 
1270
1019
    def add_inventory(self, revid, inv, parents):
1271
1020
        self._ensure_real()
1272
1021
        return self._real_repository.add_inventory(revid, inv, parents)
1273
1022
 
1274
1023
    def add_inventory_by_delta(self, basis_revision_id, delta, new_revision_id,
1275
 
            parents, basis_inv=None, propagate_caches=False):
 
1024
                               parents):
1276
1025
        self._ensure_real()
1277
1026
        return self._real_repository.add_inventory_by_delta(basis_revision_id,
1278
 
            delta, new_revision_id, parents, basis_inv=basis_inv,
1279
 
            propagate_caches=propagate_caches)
 
1027
            delta, new_revision_id, parents)
1280
1028
 
1281
1029
    def add_revision(self, rev_id, rev, inv=None, config=None):
1282
1030
        self._ensure_real()
1288
1036
        self._ensure_real()
1289
1037
        return self._real_repository.get_inventory(revision_id)
1290
1038
 
1291
 
    def iter_inventories(self, revision_ids, ordering=None):
 
1039
    def iter_inventories(self, revision_ids):
1292
1040
        self._ensure_real()
1293
 
        return self._real_repository.iter_inventories(revision_ids, ordering)
 
1041
        return self._real_repository.iter_inventories(revision_ids)
1294
1042
 
1295
1043
    @needs_read_lock
1296
1044
    def get_revision(self, revision_id):
1311
1059
        self._ensure_real()
1312
1060
        return self._real_repository.make_working_trees()
1313
1061
 
1314
 
    def refresh_data(self):
1315
 
        """Re-read any data needed to to synchronise with disk.
1316
 
 
1317
 
        This method is intended to be called after another repository instance
1318
 
        (such as one used by a smart server) has inserted data into the
1319
 
        repository. It may not be called during a write group, but may be
1320
 
        called at any other time.
1321
 
        """
1322
 
        if self.is_in_write_group():
1323
 
            raise errors.InternalBzrError(
1324
 
                "May not refresh_data while in a write group.")
1325
 
        if self._real_repository is not None:
1326
 
            self._real_repository.refresh_data()
1327
 
 
1328
1062
    def revision_ids_to_search_result(self, result_set):
1329
1063
        """Convert a set of revision ids to a graph SearchResult."""
1330
1064
        result_parents = set()
1351
1085
 
1352
1086
    def fetch(self, source, revision_id=None, pb=None, find_ghosts=False,
1353
1087
            fetch_spec=None):
1354
 
        # No base implementation to use as RemoteRepository is not a subclass
1355
 
        # of Repository; so this is a copy of Repository.fetch().
1356
1088
        if fetch_spec is not None and revision_id is not None:
1357
1089
            raise AssertionError(
1358
1090
                "fetch_spec and revision_id are mutually exclusive.")
1359
 
        if self.is_in_write_group():
1360
 
            raise errors.InternalBzrError(
1361
 
                "May not fetch while in a write group.")
1362
 
        # fast path same-url fetch operations
1363
 
        if (self.has_same_location(source)
1364
 
            and fetch_spec is None
1365
 
            and self._has_same_fallbacks(source)):
 
1091
        # Not delegated to _real_repository so that InterRepository.get has a
 
1092
        # chance to find an InterRepository specialised for RemoteRepository.
 
1093
        if self.has_same_location(source) and fetch_spec is None:
1366
1094
            # check that last_revision is in 'from' and then return a
1367
1095
            # no-operation.
1368
1096
            if (revision_id is not None and
1369
1097
                not revision.is_null(revision_id)):
1370
1098
                self.get_revision(revision_id)
1371
1099
            return 0, []
1372
 
        # if there is no specific appropriate InterRepository, this will get
1373
 
        # the InterRepository base class, which raises an
1374
 
        # IncompatibleRepositories when asked to fetch.
1375
1100
        inter = repository.InterRepository.get(source, self)
1376
 
        return inter.fetch(revision_id=revision_id, pb=pb,
1377
 
            find_ghosts=find_ghosts, fetch_spec=fetch_spec)
 
1101
        try:
 
1102
            return inter.fetch(revision_id=revision_id, pb=pb,
 
1103
                    find_ghosts=find_ghosts, fetch_spec=fetch_spec)
 
1104
        except NotImplementedError:
 
1105
            raise errors.IncompatibleRepositories(source, self)
1378
1106
 
1379
1107
    def create_bundle(self, target, base, fileobj, format=None):
1380
1108
        self._ensure_real()
1411
1139
            # We already found out that the server can't understand
1412
1140
            # Repository.get_parent_map requests, so just fetch the whole
1413
1141
            # graph.
1414
 
            #
1415
 
            # Note that this reads the whole graph, when only some keys are
1416
 
            # wanted.  On this old server there's no way (?) to get them all
1417
 
            # in one go, and the user probably will have seen a warning about
1418
 
            # the server being old anyhow.
1419
 
            rg = self._get_revision_graph(None)
1420
 
            # There is an API discrepancy between get_parent_map and
 
1142
            # XXX: Note that this will issue a deprecation warning. This is ok
 
1143
            # :- its because we're working with a deprecated server anyway, and
 
1144
            # the user will almost certainly have seen a warning about the
 
1145
            # server version already.
 
1146
            rg = self.get_revision_graph()
 
1147
            # There is an api discrepency between get_parent_map and
1421
1148
            # get_revision_graph. Specifically, a "key:()" pair in
1422
1149
            # get_revision_graph just means a node has no parents. For
1423
1150
            # "get_parent_map" it means the node is a ghost. So fix up the
1453
1180
        # TODO: Manage this incrementally to avoid covering the same path
1454
1181
        # repeatedly. (The server will have to on each request, but the less
1455
1182
        # work done the better).
1456
 
        #
1457
 
        # Negative caching notes:
1458
 
        # new server sends missing when a request including the revid
1459
 
        # 'include-missing:' is present in the request.
1460
 
        # missing keys are serialised as missing:X, and we then call
1461
 
        # provider.note_missing(X) for-all X
1462
1183
        parents_map = self._unstacked_provider.get_cached_map()
1463
1184
        if parents_map is None:
1464
1185
            # Repository is not locked, so there's no cache.
1465
1186
            parents_map = {}
1466
 
        # start_set is all the keys in the cache
1467
1187
        start_set = set(parents_map)
1468
 
        # result set is all the references to keys in the cache
1469
1188
        result_parents = set()
1470
1189
        for parents in parents_map.itervalues():
1471
1190
            result_parents.update(parents)
1472
1191
        stop_keys = result_parents.difference(start_set)
1473
 
        # We don't need to send ghosts back to the server as a position to
1474
 
        # stop either.
1475
 
        stop_keys.difference_update(self._unstacked_provider.missing_keys)
1476
 
        key_count = len(parents_map)
1477
 
        if (NULL_REVISION in result_parents
1478
 
            and NULL_REVISION in self._unstacked_provider.missing_keys):
1479
 
            # If we pruned NULL_REVISION from the stop_keys because it's also
1480
 
            # in our cache of "missing" keys we need to increment our key count
1481
 
            # by 1, because the reconsitituted SearchResult on the server will
1482
 
            # still consider NULL_REVISION to be an included key.
1483
 
            key_count += 1
1484
1192
        included_keys = start_set.intersection(result_parents)
1485
1193
        start_set.difference_update(included_keys)
1486
 
        recipe = ('manual', start_set, stop_keys, key_count)
 
1194
        recipe = (start_set, stop_keys, len(parents_map))
1487
1195
        body = self._serialise_search_recipe(recipe)
1488
1196
        path = self.bzrdir._path_for_remote_call(self._client)
1489
1197
        for key in keys:
1491
1199
                raise ValueError(
1492
1200
                    "key %r not a plain string" % (key,))
1493
1201
        verb = 'Repository.get_parent_map'
1494
 
        args = (path, 'include-missing:') + tuple(keys)
 
1202
        args = (path,) + tuple(keys)
1495
1203
        try:
1496
1204
            response = self._call_with_body_bytes_expecting_body(
1497
1205
                verb, args, body)
1507
1215
            # To avoid having to disconnect repeatedly, we keep track of the
1508
1216
            # fact the server doesn't understand remote methods added in 1.2.
1509
1217
            medium._remember_remote_is_before((1, 2))
1510
 
            # Recurse just once and we should use the fallback code.
1511
 
            return self._get_parent_map_rpc(keys)
 
1218
            return self.get_revision_graph(None)
1512
1219
        response_tuple, response_handler = response
1513
1220
        if response_tuple[0] not in ['ok']:
1514
1221
            response_handler.cancel_read_body()
1525
1232
                if len(d) > 1:
1526
1233
                    revision_graph[d[0]] = d[1:]
1527
1234
                else:
1528
 
                    # No parents:
1529
 
                    if d[0].startswith('missing:'):
1530
 
                        revid = d[0][8:]
1531
 
                        self._unstacked_provider.note_missing_key(revid)
1532
 
                    else:
1533
 
                        # no parents - so give the Graph result
1534
 
                        # (NULL_REVISION,).
1535
 
                        revision_graph[d[0]] = (NULL_REVISION,)
 
1235
                    # No parents - so give the Graph result (NULL_REVISION,).
 
1236
                    revision_graph[d[0]] = (NULL_REVISION,)
1536
1237
            return revision_graph
1537
1238
 
1538
1239
    @needs_read_lock
1541
1242
        return self._real_repository.get_signature_text(revision_id)
1542
1243
 
1543
1244
    @needs_read_lock
1544
 
    def _get_inventory_xml(self, revision_id):
1545
 
        self._ensure_real()
1546
 
        return self._real_repository._get_inventory_xml(revision_id)
 
1245
    @symbol_versioning.deprecated_method(symbol_versioning.one_three)
 
1246
    def get_revision_graph_with_ghosts(self, revision_ids=None):
 
1247
        self._ensure_real()
 
1248
        return self._real_repository.get_revision_graph_with_ghosts(
 
1249
            revision_ids=revision_ids)
 
1250
 
 
1251
    @needs_read_lock
 
1252
    def get_inventory_xml(self, revision_id):
 
1253
        self._ensure_real()
 
1254
        return self._real_repository.get_inventory_xml(revision_id)
 
1255
 
 
1256
    def deserialise_inventory(self, revision_id, xml):
 
1257
        self._ensure_real()
 
1258
        return self._real_repository.deserialise_inventory(revision_id, xml)
1547
1259
 
1548
1260
    def reconcile(self, other=None, thorough=False):
1549
1261
        self._ensure_real()
1554
1266
        return self._real_repository.all_revision_ids()
1555
1267
 
1556
1268
    @needs_read_lock
1557
 
    def get_deltas_for_revisions(self, revisions, specific_fileids=None):
 
1269
    def get_deltas_for_revisions(self, revisions):
1558
1270
        self._ensure_real()
1559
 
        return self._real_repository.get_deltas_for_revisions(revisions,
1560
 
            specific_fileids=specific_fileids)
 
1271
        return self._real_repository.get_deltas_for_revisions(revisions)
1561
1272
 
1562
1273
    @needs_read_lock
1563
 
    def get_revision_delta(self, revision_id, specific_fileids=None):
 
1274
    def get_revision_delta(self, revision_id):
1564
1275
        self._ensure_real()
1565
 
        return self._real_repository.get_revision_delta(revision_id,
1566
 
            specific_fileids=specific_fileids)
 
1276
        return self._real_repository.get_revision_delta(revision_id)
1567
1277
 
1568
1278
    @needs_read_lock
1569
1279
    def revision_trees(self, revision_ids):
1576
1286
        return self._real_repository.get_revision_reconcile(revision_id)
1577
1287
 
1578
1288
    @needs_read_lock
1579
 
    def check(self, revision_ids=None, callback_refs=None, check_repo=True):
 
1289
    def check(self, revision_ids=None):
1580
1290
        self._ensure_real()
1581
 
        return self._real_repository.check(revision_ids=revision_ids,
1582
 
            callback_refs=callback_refs, check_repo=check_repo)
 
1291
        return self._real_repository.check(revision_ids=revision_ids)
1583
1292
 
1584
1293
    def copy_content_into(self, destination, revision_id=None):
1585
1294
        self._ensure_real()
1625
1334
        return self._real_repository.inventories
1626
1335
 
1627
1336
    @needs_write_lock
1628
 
    def pack(self, hint=None, clean_obsolete_packs=False):
 
1337
    def pack(self):
1629
1338
        """Compress the data within the repository.
1630
1339
 
1631
1340
        This is not currently implemented within the smart server.
1632
1341
        """
1633
1342
        self._ensure_real()
1634
 
        return self._real_repository.pack(hint=hint, clean_obsolete_packs=clean_obsolete_packs)
 
1343
        return self._real_repository.pack()
1635
1344
 
1636
1345
    @property
1637
1346
    def revisions(self):
1725
1434
        self._ensure_real()
1726
1435
        return self._real_repository.revision_graph_can_have_wrong_parents()
1727
1436
 
1728
 
    def _find_inconsistent_revision_parents(self, revisions_iterator=None):
 
1437
    def _find_inconsistent_revision_parents(self):
1729
1438
        self._ensure_real()
1730
 
        return self._real_repository._find_inconsistent_revision_parents(
1731
 
            revisions_iterator)
 
1439
        return self._real_repository._find_inconsistent_revision_parents()
1732
1440
 
1733
1441
    def _check_for_inconsistent_revision_parents(self):
1734
1442
        self._ensure_real()
1740
1448
            providers.insert(0, other)
1741
1449
        providers.extend(r._make_parents_provider() for r in
1742
1450
                         self._fallback_repositories)
1743
 
        return graph.StackedParentsProvider(providers)
 
1451
        return graph._StackedParentsProvider(providers)
1744
1452
 
1745
1453
    def _serialise_search_recipe(self, recipe):
1746
1454
        """Serialise a graph search recipe.
1748
1456
        :param recipe: A search recipe (start, stop, count).
1749
1457
        :return: Serialised bytes.
1750
1458
        """
1751
 
        start_keys = ' '.join(recipe[1])
1752
 
        stop_keys = ' '.join(recipe[2])
1753
 
        count = str(recipe[3])
 
1459
        start_keys = ' '.join(recipe[0])
 
1460
        stop_keys = ' '.join(recipe[1])
 
1461
        count = str(recipe[2])
1754
1462
        return '\n'.join((start_keys, stop_keys, count))
1755
1463
 
1756
1464
    def _serialise_search_result(self, search_result):
1759
1467
            parts.extend(search_result.heads)
1760
1468
        else:
1761
1469
            recipe = search_result.get_recipe()
1762
 
            parts = [recipe[0], self._serialise_search_recipe(recipe)]
 
1470
            parts = ['search', self._serialise_search_recipe(recipe)]
1763
1471
        return '\n'.join(parts)
1764
1472
 
1765
1473
    def autopack(self):
1770
1478
            self._ensure_real()
1771
1479
            self._real_repository._pack_collection.autopack()
1772
1480
            return
1773
 
        self.refresh_data()
 
1481
        if self._real_repository is not None:
 
1482
            # Reset the real repository's cache of pack names.
 
1483
            # XXX: At some point we may be able to skip this and just rely on
 
1484
            # the automatic retry logic to do the right thing, but for now we
 
1485
            # err on the side of being correct rather than being optimal.
 
1486
            self._real_repository._pack_collection.reload_pack_names()
1774
1487
        if response[0] != 'ok':
1775
1488
            raise errors.UnexpectedSmartServerResponse(response)
1776
1489
 
1786
1499
        return result
1787
1500
 
1788
1501
    def insert_stream(self, stream, src_format, resume_tokens):
1789
 
        target = self.target_repo
1790
 
        target._unstacked_provider.missing_keys.clear()
1791
 
        candidate_calls = [('Repository.insert_stream_1.19', (1, 19))]
1792
 
        if target._lock_token:
1793
 
            candidate_calls.append(('Repository.insert_stream_locked', (1, 14)))
1794
 
            lock_args = (target._lock_token or '',)
1795
 
        else:
1796
 
            candidate_calls.append(('Repository.insert_stream', (1, 13)))
1797
 
            lock_args = ()
1798
 
        client = target._client
 
1502
        repo = self.target_repo
 
1503
        client = repo._client
1799
1504
        medium = client._medium
1800
 
        path = target.bzrdir._path_for_remote_call(client)
1801
 
        # Probe for the verb to use with an empty stream before sending the
1802
 
        # real stream to it.  We do this both to avoid the risk of sending a
1803
 
        # large request that is then rejected, and because we don't want to
1804
 
        # implement a way to buffer, rewind, or restart the stream.
1805
 
        found_verb = False
1806
 
        for verb, required_version in candidate_calls:
1807
 
            if medium._is_remote_before(required_version):
1808
 
                continue
1809
 
            if resume_tokens:
1810
 
                # We've already done the probing (and set _is_remote_before) on
1811
 
                # a previous insert.
1812
 
                found_verb = True
1813
 
                break
 
1505
        if medium._is_remote_before((1, 13)):
 
1506
            # No possible way this can work.
 
1507
            return self._insert_real(stream, src_format, resume_tokens)
 
1508
        path = repo.bzrdir._path_for_remote_call(client)
 
1509
        if not resume_tokens:
 
1510
            # XXX: Ugly but important for correctness, *will* be fixed during
 
1511
            # 1.13 cycle. Pushing a stream that is interrupted results in a
 
1512
            # fallback to the _real_repositories sink *with a partial stream*.
 
1513
            # Thats bad because we insert less data than bzr expected. To avoid
 
1514
            # this we do a trial push to make sure the verb is accessible, and
 
1515
            # do not fallback when actually pushing the stream. A cleanup patch
 
1516
            # is going to look at rewinding/restarting the stream/partial
 
1517
            # buffering etc.
1814
1518
            byte_stream = smart_repo._stream_to_byte_stream([], src_format)
1815
1519
            try:
1816
1520
                response = client.call_with_body_stream(
1817
 
                    (verb, path, '') + lock_args, byte_stream)
 
1521
                    ('Repository.insert_stream', path, ''), byte_stream)
1818
1522
            except errors.UnknownSmartMethod:
1819
 
                medium._remember_remote_is_before(required_version)
1820
 
            else:
1821
 
                found_verb = True
1822
 
                break
1823
 
        if not found_verb:
1824
 
            # Have to use VFS.
1825
 
            return self._insert_real(stream, src_format, resume_tokens)
1826
 
        self._last_inv_record = None
1827
 
        self._last_substream = None
1828
 
        if required_version < (1, 19):
1829
 
            # Remote side doesn't support inventory deltas.  Wrap the stream to
1830
 
            # make sure we don't send any.  If the stream contains inventory
1831
 
            # deltas we'll interrupt the smart insert_stream request and
1832
 
            # fallback to VFS.
1833
 
            stream = self._stop_stream_if_inventory_delta(stream)
 
1523
                medium._remember_remote_is_before((1,13))
 
1524
                return self._insert_real(stream, src_format, resume_tokens)
1834
1525
        byte_stream = smart_repo._stream_to_byte_stream(
1835
1526
            stream, src_format)
1836
1527
        resume_tokens = ' '.join(resume_tokens)
1837
1528
        response = client.call_with_body_stream(
1838
 
            (verb, path, resume_tokens) + lock_args, byte_stream)
 
1529
            ('Repository.insert_stream', path, resume_tokens), byte_stream)
1839
1530
        if response[0][0] not in ('ok', 'missing-basis'):
1840
1531
            raise errors.UnexpectedSmartServerResponse(response)
1841
 
        if self._last_substream is not None:
1842
 
            # The stream included an inventory-delta record, but the remote
1843
 
            # side isn't new enough to support them.  So we need to send the
1844
 
            # rest of the stream via VFS.
1845
 
            self.target_repo.refresh_data()
1846
 
            return self._resume_stream_with_vfs(response, src_format)
1847
1532
        if response[0][0] == 'missing-basis':
1848
1533
            tokens, missing_keys = bencode.bdecode_as_tuple(response[0][1])
1849
1534
            resume_tokens = tokens
1850
 
            return resume_tokens, set(missing_keys)
 
1535
            return resume_tokens, missing_keys
1851
1536
        else:
1852
 
            self.target_repo.refresh_data()
 
1537
            if self.target_repo._real_repository is not None:
 
1538
                collection = getattr(self.target_repo._real_repository,
 
1539
                    '_pack_collection', None)
 
1540
                if collection is not None:
 
1541
                    collection.reload_pack_names()
1853
1542
            return [], set()
1854
1543
 
1855
 
    def _resume_stream_with_vfs(self, response, src_format):
1856
 
        """Resume sending a stream via VFS, first resending the record and
1857
 
        substream that couldn't be sent via an insert_stream verb.
1858
 
        """
1859
 
        if response[0][0] == 'missing-basis':
1860
 
            tokens, missing_keys = bencode.bdecode_as_tuple(response[0][1])
1861
 
            # Ignore missing_keys, we haven't finished inserting yet
1862
 
        else:
1863
 
            tokens = []
1864
 
        def resume_substream():
1865
 
            # Yield the substream that was interrupted.
1866
 
            for record in self._last_substream:
1867
 
                yield record
1868
 
            self._last_substream = None
1869
 
        def resume_stream():
1870
 
            # Finish sending the interrupted substream
1871
 
            yield ('inventory-deltas', resume_substream())
1872
 
            # Then simply continue sending the rest of the stream.
1873
 
            for substream_kind, substream in self._last_stream:
1874
 
                yield substream_kind, substream
1875
 
        return self._insert_real(resume_stream(), src_format, tokens)
1876
 
 
1877
 
    def _stop_stream_if_inventory_delta(self, stream):
1878
 
        """Normally this just lets the original stream pass-through unchanged.
1879
 
 
1880
 
        However if any 'inventory-deltas' substream occurs it will stop
1881
 
        streaming, and store the interrupted substream and stream in
1882
 
        self._last_substream and self._last_stream so that the stream can be
1883
 
        resumed by _resume_stream_with_vfs.
1884
 
        """
1885
 
                    
1886
 
        stream_iter = iter(stream)
1887
 
        for substream_kind, substream in stream_iter:
1888
 
            if substream_kind == 'inventory-deltas':
1889
 
                self._last_substream = substream
1890
 
                self._last_stream = stream_iter
1891
 
                return
1892
 
            else:
1893
 
                yield substream_kind, substream
1894
 
            
1895
1544
 
1896
1545
class RemoteStreamSource(repository.StreamSource):
1897
1546
    """Stream data from a remote server."""
1898
1547
 
1899
1548
    def get_stream(self, search):
1900
 
        if (self.from_repository._fallback_repositories and
1901
 
            self.to_format._fetch_order == 'topological'):
1902
 
            return self._real_stream(self.from_repository, search)
1903
 
        sources = []
1904
 
        seen = set()
1905
 
        repos = [self.from_repository]
1906
 
        while repos:
1907
 
            repo = repos.pop(0)
1908
 
            if repo in seen:
1909
 
                continue
1910
 
            seen.add(repo)
1911
 
            repos.extend(repo._fallback_repositories)
1912
 
            sources.append(repo)
1913
 
        return self.missing_parents_chain(search, sources)
1914
 
 
1915
 
    def get_stream_for_missing_keys(self, missing_keys):
1916
 
        self.from_repository._ensure_real()
1917
 
        real_repo = self.from_repository._real_repository
1918
 
        real_source = real_repo._get_source(self.to_format)
1919
 
        return real_source.get_stream_for_missing_keys(missing_keys)
1920
 
 
1921
 
    def _real_stream(self, repo, search):
1922
 
        """Get a stream for search from repo.
1923
 
        
1924
 
        This never called RemoteStreamSource.get_stream, and is a heler
1925
 
        for RemoteStreamSource._get_stream to allow getting a stream 
1926
 
        reliably whether fallback back because of old servers or trying
1927
 
        to stream from a non-RemoteRepository (which the stacked support
1928
 
        code will do).
1929
 
        """
1930
 
        source = repo._get_source(self.to_format)
1931
 
        if isinstance(source, RemoteStreamSource):
1932
 
            repo._ensure_real()
1933
 
            source = repo._real_repository._get_source(self.to_format)
1934
 
        return source.get_stream(search)
1935
 
 
1936
 
    def _get_stream(self, repo, search):
1937
 
        """Core worker to get a stream from repo for search.
1938
 
 
1939
 
        This is used by both get_stream and the stacking support logic. It
1940
 
        deliberately gets a stream for repo which does not need to be
1941
 
        self.from_repository. In the event that repo is not Remote, or
1942
 
        cannot do a smart stream, a fallback is made to the generic
1943
 
        repository._get_stream() interface, via self._real_stream.
1944
 
 
1945
 
        In the event of stacking, streams from _get_stream will not
1946
 
        contain all the data for search - this is normal (see get_stream).
1947
 
 
1948
 
        :param repo: A repository.
1949
 
        :param search: A search.
1950
 
        """
1951
 
        # Fallbacks may be non-smart
1952
 
        if not isinstance(repo, RemoteRepository):
1953
 
            return self._real_stream(repo, search)
 
1549
        # streaming with fallback repositories is not well defined yet: The
 
1550
        # remote repository cannot see the fallback repositories, and thus
 
1551
        # cannot satisfy the entire search in the general case. Likewise the
 
1552
        # fallback repositories cannot reify the search to determine what they
 
1553
        # should send. It likely needs a return value in the stream listing the
 
1554
        # edge of the search to resume from in fallback repositories.
 
1555
        if self.from_repository._fallback_repositories:
 
1556
            return repository.StreamSource.get_stream(self, search)
 
1557
        repo = self.from_repository
1954
1558
        client = repo._client
1955
1559
        medium = client._medium
 
1560
        if medium._is_remote_before((1, 13)):
 
1561
            # No possible way this can work.
 
1562
            return repository.StreamSource.get_stream(self, search)
1956
1563
        path = repo.bzrdir._path_for_remote_call(client)
1957
 
        search_bytes = repo._serialise_search_result(search)
1958
 
        args = (path, self.to_format.network_name())
1959
 
        candidate_verbs = [
1960
 
            ('Repository.get_stream_1.19', (1, 19)),
1961
 
            ('Repository.get_stream', (1, 13))]
1962
 
        found_verb = False
1963
 
        for verb, version in candidate_verbs:
1964
 
            if medium._is_remote_before(version):
1965
 
                continue
1966
 
            try:
1967
 
                response = repo._call_with_body_bytes_expecting_body(
1968
 
                    verb, args, search_bytes)
1969
 
            except errors.UnknownSmartMethod:
1970
 
                medium._remember_remote_is_before(version)
1971
 
            else:
1972
 
                response_tuple, response_handler = response
1973
 
                found_verb = True
1974
 
                break
1975
 
        if not found_verb:
1976
 
            return self._real_stream(repo, search)
 
1564
        try:
 
1565
            search_bytes = repo._serialise_search_result(search)
 
1566
            response = repo._call_with_body_bytes_expecting_body(
 
1567
                'Repository.get_stream',
 
1568
                (path, self.to_format.network_name()), search_bytes)
 
1569
            response_tuple, response_handler = response
 
1570
        except errors.UnknownSmartMethod:
 
1571
            medium._remember_remote_is_before((1,13))
 
1572
            return repository.StreamSource.get_stream(self, search)
1977
1573
        if response_tuple[0] != 'ok':
1978
1574
            raise errors.UnexpectedSmartServerResponse(response_tuple)
1979
1575
        byte_stream = response_handler.read_streamed_body()
1984
1580
                src_format.network_name(), repo._format.network_name()))
1985
1581
        return stream
1986
1582
 
1987
 
    def missing_parents_chain(self, search, sources):
1988
 
        """Chain multiple streams together to handle stacking.
1989
 
 
1990
 
        :param search: The overall search to satisfy with streams.
1991
 
        :param sources: A list of Repository objects to query.
1992
 
        """
1993
 
        self.from_serialiser = self.from_repository._format._serializer
1994
 
        self.seen_revs = set()
1995
 
        self.referenced_revs = set()
1996
 
        # If there are heads in the search, or the key count is > 0, we are not
1997
 
        # done.
1998
 
        while not search.is_empty() and len(sources) > 1:
1999
 
            source = sources.pop(0)
2000
 
            stream = self._get_stream(source, search)
2001
 
            for kind, substream in stream:
2002
 
                if kind != 'revisions':
2003
 
                    yield kind, substream
2004
 
                else:
2005
 
                    yield kind, self.missing_parents_rev_handler(substream)
2006
 
            search = search.refine(self.seen_revs, self.referenced_revs)
2007
 
            self.seen_revs = set()
2008
 
            self.referenced_revs = set()
2009
 
        if not search.is_empty():
2010
 
            for kind, stream in self._get_stream(sources[0], search):
2011
 
                yield kind, stream
2012
 
 
2013
 
    def missing_parents_rev_handler(self, substream):
2014
 
        for content in substream:
2015
 
            revision_bytes = content.get_bytes_as('fulltext')
2016
 
            revision = self.from_serialiser.read_revision_from_string(
2017
 
                revision_bytes)
2018
 
            self.seen_revs.add(content.key[-1])
2019
 
            self.referenced_revs.update(revision.parent_ids)
2020
 
            yield content
2021
 
 
2022
1583
 
2023
1584
class RemoteBranchLockableFiles(LockableFiles):
2024
1585
    """A 'LockableFiles' implementation that talks to a smart server.
2059
1620
                self._network_name)
2060
1621
 
2061
1622
    def get_format_description(self):
2062
 
        self._ensure_real()
2063
 
        return 'Remote: ' + self._custom_format.get_format_description()
 
1623
        return 'Remote BZR Branch'
2064
1624
 
2065
1625
    def network_name(self):
2066
1626
        return self._network_name
2067
1627
 
2068
 
    def open(self, a_bzrdir, name=None, ignore_fallbacks=False):
2069
 
        return a_bzrdir.open_branch(name=name, 
2070
 
            ignore_fallbacks=ignore_fallbacks)
 
1628
    def open(self, a_bzrdir):
 
1629
        return a_bzrdir.open_branch()
2071
1630
 
2072
 
    def _vfs_initialize(self, a_bzrdir, name):
 
1631
    def _vfs_initialize(self, a_bzrdir):
2073
1632
        # Initialisation when using a local bzrdir object, or a non-vfs init
2074
1633
        # method is not available on the server.
2075
1634
        # self._custom_format is always set - the start of initialize ensures
2076
1635
        # that.
2077
1636
        if isinstance(a_bzrdir, RemoteBzrDir):
2078
1637
            a_bzrdir._ensure_real()
2079
 
            result = self._custom_format.initialize(a_bzrdir._real_bzrdir,
2080
 
                name)
 
1638
            result = self._custom_format.initialize(a_bzrdir._real_bzrdir)
2081
1639
        else:
2082
1640
            # We assume the bzrdir is parameterised; it may not be.
2083
 
            result = self._custom_format.initialize(a_bzrdir, name)
 
1641
            result = self._custom_format.initialize(a_bzrdir)
2084
1642
        if (isinstance(a_bzrdir, RemoteBzrDir) and
2085
1643
            not isinstance(result, RemoteBranch)):
2086
 
            result = RemoteBranch(a_bzrdir, a_bzrdir.find_repository(), result,
2087
 
                                  name=name)
 
1644
            result = RemoteBranch(a_bzrdir, a_bzrdir.find_repository(), result)
2088
1645
        return result
2089
1646
 
2090
 
    def initialize(self, a_bzrdir, name=None):
 
1647
    def initialize(self, a_bzrdir):
2091
1648
        # 1) get the network name to use.
2092
1649
        if self._custom_format:
2093
1650
            network_name = self._custom_format.network_name()
2099
1656
            network_name = reference_format.network_name()
2100
1657
        # Being asked to create on a non RemoteBzrDir:
2101
1658
        if not isinstance(a_bzrdir, RemoteBzrDir):
2102
 
            return self._vfs_initialize(a_bzrdir, name=name)
 
1659
            return self._vfs_initialize(a_bzrdir)
2103
1660
        medium = a_bzrdir._client._medium
2104
1661
        if medium._is_remote_before((1, 13)):
2105
 
            return self._vfs_initialize(a_bzrdir, name=name)
 
1662
            return self._vfs_initialize(a_bzrdir)
2106
1663
        # Creating on a remote bzr dir.
2107
1664
        # 2) try direct creation via RPC
2108
1665
        path = a_bzrdir._path_for_remote_call(a_bzrdir._client)
2109
 
        if name is not None:
2110
 
            # XXX JRV20100304: Support creating colocated branches
2111
 
            raise errors.NoColocatedBranchSupport(self)
2112
1666
        verb = 'BzrDir.create_branch'
2113
1667
        try:
2114
1668
            response = a_bzrdir._call(verb, path, network_name)
2115
1669
        except errors.UnknownSmartMethod:
2116
1670
            # Fallback - use vfs methods
2117
1671
            medium._remember_remote_is_before((1, 13))
2118
 
            return self._vfs_initialize(a_bzrdir, name=name)
 
1672
            return self._vfs_initialize(a_bzrdir)
2119
1673
        if response[0] != 'ok':
2120
1674
            raise errors.UnexpectedSmartServerResponse(response)
2121
1675
        # Turn the response into a RemoteRepository object.
2129
1683
                a_bzrdir._client)
2130
1684
        remote_repo = RemoteRepository(repo_bzrdir, repo_format)
2131
1685
        remote_branch = RemoteBranch(a_bzrdir, remote_repo,
2132
 
            format=format, setup_stacking=False, name=name)
 
1686
            format=format, setup_stacking=False)
2133
1687
        # XXX: We know this is a new branch, so it must have revno 0, revid
2134
1688
        # NULL_REVISION. Creating the branch locked would make this be unable
2135
1689
        # to be wrong; here its simply very unlikely to be wrong. RBC 20090225
2150
1704
        self._ensure_real()
2151
1705
        return self._custom_format.supports_stacking()
2152
1706
 
2153
 
    def supports_set_append_revisions_only(self):
2154
 
        self._ensure_real()
2155
 
        return self._custom_format.supports_set_append_revisions_only()
2156
 
 
2157
 
 
2158
 
class RemoteBranch(branch.Branch, _RpcHelper, lock._RelockDebugMixin):
 
1707
 
 
1708
class RemoteBranch(branch.Branch, _RpcHelper):
2159
1709
    """Branch stored on a server accessed by HPSS RPC.
2160
1710
 
2161
1711
    At the moment most operations are mapped down to simple file operations.
2162
1712
    """
2163
1713
 
2164
1714
    def __init__(self, remote_bzrdir, remote_repository, real_branch=None,
2165
 
        _client=None, format=None, setup_stacking=True, name=None):
 
1715
        _client=None, format=None, setup_stacking=True):
2166
1716
        """Create a RemoteBranch instance.
2167
1717
 
2168
1718
        :param real_branch: An optional local implementation of the branch
2174
1724
        :param setup_stacking: If True make an RPC call to determine the
2175
1725
            stacked (or not) status of the branch. If False assume the branch
2176
1726
            is not stacked.
2177
 
        :param name: Colocated branch name
2178
1727
        """
2179
1728
        # We intentionally don't call the parent class's __init__, because it
2180
1729
        # will try to assign to self.tags, which is a property in this subclass.
2181
1730
        # And the parent's __init__ doesn't do much anyway.
 
1731
        self._revision_id_to_revno_cache = None
 
1732
        self._partial_revision_id_to_revno_cache = {}
 
1733
        self._revision_history_cache = None
 
1734
        self._last_revision_info_cache = None
 
1735
        self._merge_sorted_revisions_cache = None
2182
1736
        self.bzrdir = remote_bzrdir
2183
1737
        if _client is not None:
2184
1738
            self._client = _client
2197
1751
            self._real_branch.repository = self.repository
2198
1752
        else:
2199
1753
            self._real_branch = None
2200
 
        # Fill out expected attributes of branch for bzrlib API users.
2201
 
        self._clear_cached_state()
2202
 
        # TODO: deprecate self.base in favor of user_url
2203
 
        self.base = self.bzrdir.user_url
2204
 
        self._name = name
 
1754
        # Fill out expected attributes of branch for bzrlib api users.
 
1755
        self.base = self.bzrdir.root_transport.base
2205
1756
        self._control_files = None
2206
1757
        self._lock_mode = None
2207
1758
        self._lock_token = None
2218
1769
                    self._real_branch._format.network_name()
2219
1770
        else:
2220
1771
            self._format = format
2221
 
        # when we do _ensure_real we may need to pass ignore_fallbacks to the
2222
 
        # branch.open_branch method.
2223
 
        self._real_ignore_fallbacks = not setup_stacking
2224
1772
        if not self._format._network_name:
2225
1773
            # Did not get from open_branchV2 - old server.
2226
1774
            self._ensure_real()
2231
1779
        hooks = branch.Branch.hooks['open']
2232
1780
        for hook in hooks:
2233
1781
            hook(self)
2234
 
        self._is_stacked = False
2235
1782
        if setup_stacking:
2236
1783
            self._setup_stacking()
2237
1784
 
2243
1790
        except (errors.NotStacked, errors.UnstackableBranchFormat,
2244
1791
            errors.UnstackableRepositoryFormat), e:
2245
1792
            return
2246
 
        self._is_stacked = True
2247
 
        self._activate_fallback_location(fallback_url)
2248
 
 
2249
 
    def _get_config(self):
2250
 
        return RemoteBranchConfig(self)
 
1793
        # it's relative to this branch...
 
1794
        fallback_url = urlutils.join(self.base, fallback_url)
 
1795
        transports = [self.bzrdir.root_transport]
 
1796
        stacked_on = branch.Branch.open(fallback_url,
 
1797
                                        possible_transports=transports)
 
1798
        self.repository.add_fallback_repository(stacked_on.repository)
2251
1799
 
2252
1800
    def _get_real_transport(self):
2253
1801
        # if we try vfs access, return the real branch's vfs transport
2271
1819
                raise AssertionError('smart server vfs must be enabled '
2272
1820
                    'to use vfs implementation')
2273
1821
            self.bzrdir._ensure_real()
2274
 
            self._real_branch = self.bzrdir._real_bzrdir.open_branch(
2275
 
                ignore_fallbacks=self._real_ignore_fallbacks, name=self._name)
 
1822
            self._real_branch = self.bzrdir._real_bzrdir.open_branch()
2276
1823
            if self.repository._real_repository is None:
2277
1824
                # Give the remote repository the matching real repo.
2278
1825
                real_repo = self._real_branch.repository
2352
1899
            raise errors.UnexpectedSmartServerResponse(response)
2353
1900
        return response[1]
2354
1901
 
2355
 
    def set_stacked_on_url(self, url):
2356
 
        branch.Branch.set_stacked_on_url(self, url)
2357
 
        if not url:
2358
 
            self._is_stacked = False
2359
 
        else:
2360
 
            self._is_stacked = True
2361
 
        
2362
1902
    def _vfs_get_tags_bytes(self):
2363
1903
        self._ensure_real()
2364
1904
        return self._real_branch._get_tags_bytes()
2374
1914
            return self._vfs_get_tags_bytes()
2375
1915
        return response[0]
2376
1916
 
2377
 
    def _vfs_set_tags_bytes(self, bytes):
2378
 
        self._ensure_real()
2379
 
        return self._real_branch._set_tags_bytes(bytes)
2380
 
 
2381
 
    def _set_tags_bytes(self, bytes):
2382
 
        medium = self._client._medium
2383
 
        if medium._is_remote_before((1, 18)):
2384
 
            self._vfs_set_tags_bytes(bytes)
2385
 
            return
2386
 
        try:
2387
 
            args = (
2388
 
                self._remote_path(), self._lock_token, self._repo_lock_token)
2389
 
            response = self._call_with_body_bytes(
2390
 
                'Branch.set_tags_bytes', args, bytes)
2391
 
        except errors.UnknownSmartMethod:
2392
 
            medium._remember_remote_is_before((1, 18))
2393
 
            self._vfs_set_tags_bytes(bytes)
2394
 
 
2395
1917
    def lock_read(self):
2396
 
        """Lock the branch for read operations.
2397
 
 
2398
 
        :return: A bzrlib.lock.LogicalLockResult.
2399
 
        """
2400
1918
        self.repository.lock_read()
2401
1919
        if not self._lock_mode:
2402
 
            self._note_lock('r')
2403
1920
            self._lock_mode = 'r'
2404
1921
            self._lock_count = 1
2405
1922
            if self._real_branch is not None:
2406
1923
                self._real_branch.lock_read()
2407
1924
        else:
2408
1925
            self._lock_count += 1
2409
 
        return lock.LogicalLockResult(self.unlock)
2410
1926
 
2411
1927
    def _remote_lock_write(self, token):
2412
1928
        if token is None:
2413
1929
            branch_token = repo_token = ''
2414
1930
        else:
2415
1931
            branch_token = token
2416
 
            repo_token = self.repository.lock_write().repository_token
 
1932
            repo_token = self.repository.lock_write()
2417
1933
            self.repository.unlock()
2418
1934
        err_context = {'token': token}
2419
1935
        response = self._call(
2426
1942
 
2427
1943
    def lock_write(self, token=None):
2428
1944
        if not self._lock_mode:
2429
 
            self._note_lock('w')
2430
1945
            # Lock the branch and repo in one remote call.
2431
1946
            remote_tokens = self._remote_lock_write(token)
2432
1947
            self._lock_token, self._repo_lock_token = remote_tokens
2456
1971
            self._lock_count += 1
2457
1972
            # Re-lock the repository too.
2458
1973
            self.repository.lock_write(self._repo_lock_token)
2459
 
        return BranchWriteLockResult(self.unlock, self._lock_token or None)
 
1974
        return self._lock_token or None
 
1975
 
 
1976
    def _set_tags_bytes(self, bytes):
 
1977
        self._ensure_real()
 
1978
        return self._real_branch._set_tags_bytes(bytes)
2460
1979
 
2461
1980
    def _unlock(self, branch_token, repo_token):
2462
1981
        err_context = {'token': str((branch_token, repo_token))}
2467
1986
            return
2468
1987
        raise errors.UnexpectedSmartServerResponse(response)
2469
1988
 
2470
 
    @only_raises(errors.LockNotHeld, errors.LockBroken)
2471
1989
    def unlock(self):
2472
1990
        try:
2473
1991
            self._lock_count -= 1
2486
2004
                    self._real_branch.unlock()
2487
2005
                if mode != 'w':
2488
2006
                    # Only write-locked branched need to make a remote method
2489
 
                    # call to perform the unlock.
 
2007
                    # call to perfom the unlock.
2490
2008
                    return
2491
2009
                if not self._lock_token:
2492
2010
                    raise AssertionError('Locked, but no token!')
2513
2031
            raise NotImplementedError(self.dont_leave_lock_in_place)
2514
2032
        self._leave_lock = False
2515
2033
 
2516
 
    @needs_read_lock
2517
 
    def get_rev_id(self, revno, history=None):
2518
 
        if revno == 0:
2519
 
            return _mod_revision.NULL_REVISION
2520
 
        last_revision_info = self.last_revision_info()
2521
 
        ok, result = self.repository.get_rev_id_for_revno(
2522
 
            revno, last_revision_info)
2523
 
        if ok:
2524
 
            return result
2525
 
        missing_parent = result[1]
2526
 
        # Either the revision named by the server is missing, or its parent
2527
 
        # is.  Call get_parent_map to determine which, so that we report a
2528
 
        # useful error.
2529
 
        parent_map = self.repository.get_parent_map([missing_parent])
2530
 
        if missing_parent in parent_map:
2531
 
            missing_parent = parent_map[missing_parent]
2532
 
        raise errors.RevisionNotPresent(missing_parent, self.repository)
2533
 
 
2534
2034
    def _last_revision_info(self):
2535
2035
        response = self._call('Branch.last_revision_info', self._remote_path())
2536
2036
        if response[0] != 'ok':
2541
2041
 
2542
2042
    def _gen_revision_history(self):
2543
2043
        """See Branch._gen_revision_history()."""
2544
 
        if self._is_stacked:
2545
 
            self._ensure_real()
2546
 
            return self._real_branch._gen_revision_history()
2547
2044
        response_tuple, response_handler = self._call_expecting_body(
2548
2045
            'Branch.revision_history', self._remote_path())
2549
2046
        if response_tuple[0] != 'ok':
2634
2131
        self._ensure_real()
2635
2132
        return self._real_branch._get_parent_location()
2636
2133
 
 
2134
    def set_parent(self, url):
 
2135
        self._ensure_real()
 
2136
        return self._real_branch.set_parent(url)
 
2137
 
2637
2138
    def _set_parent_location(self, url):
2638
 
        medium = self._client._medium
2639
 
        if medium._is_remote_before((1, 15)):
2640
 
            return self._vfs_set_parent_location(url)
2641
 
        try:
2642
 
            call_url = url or ''
2643
 
            if type(call_url) is not str:
2644
 
                raise AssertionError('url must be a str or None (%s)' % url)
2645
 
            response = self._call('Branch.set_parent_location',
2646
 
                self._remote_path(), self._lock_token, self._repo_lock_token,
2647
 
                call_url)
2648
 
        except errors.UnknownSmartMethod:
2649
 
            medium._remember_remote_is_before((1, 15))
2650
 
            return self._vfs_set_parent_location(url)
2651
 
        if response != ():
2652
 
            raise errors.UnexpectedSmartServerResponse(response)
2653
 
 
2654
 
    def _vfs_set_parent_location(self, url):
 
2139
        # Used by tests, to poke bad urls into branch configurations
 
2140
        if url is None:
 
2141
            self.set_parent(url)
 
2142
        else:
 
2143
            self._ensure_real()
 
2144
            return self._real_branch._set_parent_location(url)
 
2145
 
 
2146
    def set_stacked_on_url(self, stacked_location):
 
2147
        """Set the URL this branch is stacked against.
 
2148
 
 
2149
        :raises UnstackableBranchFormat: If the branch does not support
 
2150
            stacking.
 
2151
        :raises UnstackableRepositoryFormat: If the repository does not support
 
2152
            stacking.
 
2153
        """
2655
2154
        self._ensure_real()
2656
 
        return self._real_branch._set_parent_location(url)
 
2155
        return self._real_branch.set_stacked_on_url(stacked_location)
2657
2156
 
2658
2157
    @needs_write_lock
2659
2158
    def pull(self, source, overwrite=False, stop_revision=None,
2727
2226
        return self._real_branch.set_push_location(location)
2728
2227
 
2729
2228
 
2730
 
class RemoteConfig(object):
2731
 
    """A Config that reads and writes from smart verbs.
2732
 
 
2733
 
    It is a low-level object that considers config data to be name/value pairs
2734
 
    that may be associated with a section. Assigning meaning to the these
2735
 
    values is done at higher levels like bzrlib.config.TreeConfig.
2736
 
    """
2737
 
 
2738
 
    def get_option(self, name, section=None, default=None):
2739
 
        """Return the value associated with a named option.
2740
 
 
2741
 
        :param name: The name of the value
2742
 
        :param section: The section the option is in (if any)
2743
 
        :param default: The value to return if the value is not set
2744
 
        :return: The value or default value
2745
 
        """
2746
 
        try:
2747
 
            configobj = self._get_configobj()
2748
 
            if section is None:
2749
 
                section_obj = configobj
2750
 
            else:
2751
 
                try:
2752
 
                    section_obj = configobj[section]
2753
 
                except KeyError:
2754
 
                    return default
2755
 
            return section_obj.get(name, default)
2756
 
        except errors.UnknownSmartMethod:
2757
 
            return self._vfs_get_option(name, section, default)
2758
 
 
2759
 
    def _response_to_configobj(self, response):
2760
 
        if len(response[0]) and response[0][0] != 'ok':
2761
 
            raise errors.UnexpectedSmartServerResponse(response)
2762
 
        lines = response[1].read_body_bytes().splitlines()
2763
 
        return config.ConfigObj(lines, encoding='utf-8')
2764
 
 
2765
 
 
2766
 
class RemoteBranchConfig(RemoteConfig):
2767
 
    """A RemoteConfig for Branches."""
2768
 
 
2769
 
    def __init__(self, branch):
2770
 
        self._branch = branch
2771
 
 
2772
 
    def _get_configobj(self):
2773
 
        path = self._branch._remote_path()
2774
 
        response = self._branch._client.call_expecting_body(
2775
 
            'Branch.get_config_file', path)
2776
 
        return self._response_to_configobj(response)
2777
 
 
2778
 
    def set_option(self, value, name, section=None):
2779
 
        """Set the value associated with a named option.
2780
 
 
2781
 
        :param value: The value to set
2782
 
        :param name: The name of the value to set
2783
 
        :param section: The section the option is in (if any)
2784
 
        """
2785
 
        medium = self._branch._client._medium
2786
 
        if medium._is_remote_before((1, 14)):
2787
 
            return self._vfs_set_option(value, name, section)
2788
 
        try:
2789
 
            path = self._branch._remote_path()
2790
 
            response = self._branch._client.call('Branch.set_config_option',
2791
 
                path, self._branch._lock_token, self._branch._repo_lock_token,
2792
 
                value.encode('utf8'), name, section or '')
2793
 
        except errors.UnknownSmartMethod:
2794
 
            medium._remember_remote_is_before((1, 14))
2795
 
            return self._vfs_set_option(value, name, section)
2796
 
        if response != ():
2797
 
            raise errors.UnexpectedSmartServerResponse(response)
2798
 
 
2799
 
    def _real_object(self):
2800
 
        self._branch._ensure_real()
2801
 
        return self._branch._real_branch
2802
 
 
2803
 
    def _vfs_set_option(self, value, name, section=None):
2804
 
        return self._real_object()._get_config().set_option(
2805
 
            value, name, section)
2806
 
 
2807
 
 
2808
 
class RemoteBzrDirConfig(RemoteConfig):
2809
 
    """A RemoteConfig for BzrDirs."""
2810
 
 
2811
 
    def __init__(self, bzrdir):
2812
 
        self._bzrdir = bzrdir
2813
 
 
2814
 
    def _get_configobj(self):
2815
 
        medium = self._bzrdir._client._medium
2816
 
        verb = 'BzrDir.get_config_file'
2817
 
        if medium._is_remote_before((1, 15)):
2818
 
            raise errors.UnknownSmartMethod(verb)
2819
 
        path = self._bzrdir._path_for_remote_call(self._bzrdir._client)
2820
 
        response = self._bzrdir._call_expecting_body(
2821
 
            verb, path)
2822
 
        return self._response_to_configobj(response)
2823
 
 
2824
 
    def _vfs_get_option(self, name, section, default):
2825
 
        return self._real_object()._get_config().get_option(
2826
 
            name, section, default)
2827
 
 
2828
 
    def set_option(self, value, name, section=None):
2829
 
        """Set the value associated with a named option.
2830
 
 
2831
 
        :param value: The value to set
2832
 
        :param name: The name of the value to set
2833
 
        :param section: The section the option is in (if any)
2834
 
        """
2835
 
        return self._real_object()._get_config().set_option(
2836
 
            value, name, section)
2837
 
 
2838
 
    def _real_object(self):
2839
 
        self._bzrdir._ensure_real()
2840
 
        return self._bzrdir._real_bzrdir
2841
 
 
2842
 
 
2843
 
 
2844
2229
def _extract_tar(tar, to_dir):
2845
2230
    """Extract all the contents of a tarfile object.
2846
2231
 
2884
2269
                    'Missing key %r in context %r', key_err.args[0], context)
2885
2270
                raise err
2886
2271
 
2887
 
    if err.error_verb == 'IncompatibleRepositories':
2888
 
        raise errors.IncompatibleRepositories(err.error_args[0],
2889
 
            err.error_args[1], err.error_args[2])
2890
 
    elif err.error_verb == 'NoSuchRevision':
 
2272
    if err.error_verb == 'NoSuchRevision':
2891
2273
        raise NoSuchRevision(find('branch'), err.error_args[0])
2892
2274
    elif err.error_verb == 'nosuchrevision':
2893
2275
        raise NoSuchRevision(find('repository'), err.error_args[0])
2894
 
    elif err.error_verb == 'nobranch':
2895
 
        if len(err.error_args) >= 1:
2896
 
            extra = err.error_args[0]
2897
 
        else:
2898
 
            extra = None
2899
 
        raise errors.NotBranchError(path=find('bzrdir').root_transport.base,
2900
 
            detail=extra)
 
2276
    elif err.error_tuple == ('nobranch',):
 
2277
        raise errors.NotBranchError(path=find('bzrdir').root_transport.base)
2901
2278
    elif err.error_verb == 'norepository':
2902
2279
        raise errors.NoRepositoryPresent(find('bzrdir'))
2903
2280
    elif err.error_verb == 'LockContention':