← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/remote.py

  • Committer: Vincent Ladeuil
  • Date: 2010-10-07 06:08:01 UTC
  • mto: This revision was merged to the branch mainline in revision 5491.
  • Revision ID: v.ladeuil+lp@free.fr-20101007060801-wfdhizfhfmctl8qa
Fix some typos and propose a release planning.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/remote.py
1
 
# Copyright (C) 2006-2011 Canonical Ltd
 
1
# Copyright (C) 2006-2010 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
19
19
from bzrlib import (
20
20
    bencode,
21
21
    branch,
22
 
    bzrdir as _mod_bzrdir,
 
22
    bzrdir,
23
23
    config,
24
24
    controldir,
25
25
    debug,
27
27
    graph,
28
28
    lock,
29
29
    lockdir,
 
30
    repository,
30
31
    repository as _mod_repository,
 
32
    revision,
31
33
    revision as _mod_revision,
32
34
    static_tuple,
33
35
    symbol_versioning,
34
 
    urlutils,
35
 
    vf_repository,
36
 
    )
 
36
)
37
37
from bzrlib.branch import BranchReferenceFormat, BranchWriteLockResult
 
38
from bzrlib.bzrdir import BzrDir, RemoteBzrDirFormat
38
39
from bzrlib.decorators import needs_read_lock, needs_write_lock, only_raises
39
40
from bzrlib.errors import (
40
41
    NoSuchRevision,
42
43
    )
43
44
from bzrlib.lockable_files import LockableFiles
44
45
from bzrlib.smart import client, vfs, repository as smart_repo
45
 
from bzrlib.smart.client import _SmartClient
46
 
from bzrlib.revision import NULL_REVISION
47
 
from bzrlib.repository import RepositoryWriteLockResult, _LazyListJoin
 
46
from bzrlib.revision import ensure_null, NULL_REVISION
 
47
from bzrlib.repository import RepositoryWriteLockResult
48
48
from bzrlib.trace import mutter, note, warning
49
49
 
50
50
 
88
88
    return format
89
89
 
90
90
 
91
 
# Note that RemoteBzrDirProber lives in bzrlib.bzrdir so bzrlib.remote
92
 
# does not have to be imported unless a remote format is involved.
93
 
 
94
 
class RemoteBzrDirFormat(_mod_bzrdir.BzrDirMetaFormat1):
95
 
    """Format representing bzrdirs accessed via a smart server"""
96
 
 
97
 
    supports_workingtrees = False
98
 
 
99
 
    def __init__(self):
100
 
        _mod_bzrdir.BzrDirMetaFormat1.__init__(self)
101
 
        # XXX: It's a bit ugly that the network name is here, because we'd
102
 
        # like to believe that format objects are stateless or at least
103
 
        # immutable,  However, we do at least avoid mutating the name after
104
 
        # it's returned.  See <https://bugs.launchpad.net/bzr/+bug/504102>
105
 
        self._network_name = None
106
 
 
107
 
    def __repr__(self):
108
 
        return "%s(_network_name=%r)" % (self.__class__.__name__,
109
 
            self._network_name)
110
 
 
111
 
    def get_format_description(self):
112
 
        if self._network_name:
113
 
            real_format = controldir.network_format_registry.get(self._network_name)
114
 
            return 'Remote: ' + real_format.get_format_description()
115
 
        return 'bzr remote bzrdir'
116
 
 
117
 
    def get_format_string(self):
118
 
        raise NotImplementedError(self.get_format_string)
119
 
 
120
 
    def network_name(self):
121
 
        if self._network_name:
122
 
            return self._network_name
123
 
        else:
124
 
            raise AssertionError("No network name set.")
125
 
 
126
 
    def initialize_on_transport(self, transport):
127
 
        try:
128
 
            # hand off the request to the smart server
129
 
            client_medium = transport.get_smart_medium()
130
 
        except errors.NoSmartMedium:
131
 
            # TODO: lookup the local format from a server hint.
132
 
            local_dir_format = _mod_bzrdir.BzrDirMetaFormat1()
133
 
            return local_dir_format.initialize_on_transport(transport)
134
 
        client = _SmartClient(client_medium)
135
 
        path = client.remote_path_from_transport(transport)
136
 
        try:
137
 
            response = client.call('BzrDirFormat.initialize', path)
138
 
        except errors.ErrorFromSmartServer, err:
139
 
            _translate_error(err, path=path)
140
 
        if response[0] != 'ok':
141
 
            raise errors.SmartProtocolError('unexpected response code %s' % (response,))
142
 
        format = RemoteBzrDirFormat()
143
 
        self._supply_sub_formats_to(format)
144
 
        return RemoteBzrDir(transport, format)
145
 
 
146
 
    def parse_NoneTrueFalse(self, arg):
147
 
        if not arg:
148
 
            return None
149
 
        if arg == 'False':
150
 
            return False
151
 
        if arg == 'True':
152
 
            return True
153
 
        raise AssertionError("invalid arg %r" % arg)
154
 
 
155
 
    def _serialize_NoneTrueFalse(self, arg):
156
 
        if arg is False:
157
 
            return 'False'
158
 
        if arg:
159
 
            return 'True'
160
 
        return ''
161
 
 
162
 
    def _serialize_NoneString(self, arg):
163
 
        return arg or ''
164
 
 
165
 
    def initialize_on_transport_ex(self, transport, use_existing_dir=False,
166
 
        create_prefix=False, force_new_repo=False, stacked_on=None,
167
 
        stack_on_pwd=None, repo_format_name=None, make_working_trees=None,
168
 
        shared_repo=False):
169
 
        try:
170
 
            # hand off the request to the smart server
171
 
            client_medium = transport.get_smart_medium()
172
 
        except errors.NoSmartMedium:
173
 
            do_vfs = True
174
 
        else:
175
 
            # Decline to open it if the server doesn't support our required
176
 
            # version (3) so that the VFS-based transport will do it.
177
 
            if client_medium.should_probe():
178
 
                try:
179
 
                    server_version = client_medium.protocol_version()
180
 
                    if server_version != '2':
181
 
                        do_vfs = True
182
 
                    else:
183
 
                        do_vfs = False
184
 
                except errors.SmartProtocolError:
185
 
                    # Apparently there's no usable smart server there, even though
186
 
                    # the medium supports the smart protocol.
187
 
                    do_vfs = True
188
 
            else:
189
 
                do_vfs = False
190
 
        if not do_vfs:
191
 
            client = _SmartClient(client_medium)
192
 
            path = client.remote_path_from_transport(transport)
193
 
            if client_medium._is_remote_before((1, 16)):
194
 
                do_vfs = True
195
 
        if do_vfs:
196
 
            # TODO: lookup the local format from a server hint.
197
 
            local_dir_format = _mod_bzrdir.BzrDirMetaFormat1()
198
 
            self._supply_sub_formats_to(local_dir_format)
199
 
            return local_dir_format.initialize_on_transport_ex(transport,
200
 
                use_existing_dir=use_existing_dir, create_prefix=create_prefix,
201
 
                force_new_repo=force_new_repo, stacked_on=stacked_on,
202
 
                stack_on_pwd=stack_on_pwd, repo_format_name=repo_format_name,
203
 
                make_working_trees=make_working_trees, shared_repo=shared_repo,
204
 
                vfs_only=True)
205
 
        return self._initialize_on_transport_ex_rpc(client, path, transport,
206
 
            use_existing_dir, create_prefix, force_new_repo, stacked_on,
207
 
            stack_on_pwd, repo_format_name, make_working_trees, shared_repo)
208
 
 
209
 
    def _initialize_on_transport_ex_rpc(self, client, path, transport,
210
 
        use_existing_dir, create_prefix, force_new_repo, stacked_on,
211
 
        stack_on_pwd, repo_format_name, make_working_trees, shared_repo):
212
 
        args = []
213
 
        args.append(self._serialize_NoneTrueFalse(use_existing_dir))
214
 
        args.append(self._serialize_NoneTrueFalse(create_prefix))
215
 
        args.append(self._serialize_NoneTrueFalse(force_new_repo))
216
 
        args.append(self._serialize_NoneString(stacked_on))
217
 
        # stack_on_pwd is often/usually our transport
218
 
        if stack_on_pwd:
219
 
            try:
220
 
                stack_on_pwd = transport.relpath(stack_on_pwd)
221
 
                if not stack_on_pwd:
222
 
                    stack_on_pwd = '.'
223
 
            except errors.PathNotChild:
224
 
                pass
225
 
        args.append(self._serialize_NoneString(stack_on_pwd))
226
 
        args.append(self._serialize_NoneString(repo_format_name))
227
 
        args.append(self._serialize_NoneTrueFalse(make_working_trees))
228
 
        args.append(self._serialize_NoneTrueFalse(shared_repo))
229
 
        request_network_name = self._network_name or \
230
 
            _mod_bzrdir.BzrDirFormat.get_default_format().network_name()
231
 
        try:
232
 
            response = client.call('BzrDirFormat.initialize_ex_1.16',
233
 
                request_network_name, path, *args)
234
 
        except errors.UnknownSmartMethod:
235
 
            client._medium._remember_remote_is_before((1,16))
236
 
            local_dir_format = _mod_bzrdir.BzrDirMetaFormat1()
237
 
            self._supply_sub_formats_to(local_dir_format)
238
 
            return local_dir_format.initialize_on_transport_ex(transport,
239
 
                use_existing_dir=use_existing_dir, create_prefix=create_prefix,
240
 
                force_new_repo=force_new_repo, stacked_on=stacked_on,
241
 
                stack_on_pwd=stack_on_pwd, repo_format_name=repo_format_name,
242
 
                make_working_trees=make_working_trees, shared_repo=shared_repo,
243
 
                vfs_only=True)
244
 
        except errors.ErrorFromSmartServer, err:
245
 
            _translate_error(err, path=path)
246
 
        repo_path = response[0]
247
 
        bzrdir_name = response[6]
248
 
        require_stacking = response[7]
249
 
        require_stacking = self.parse_NoneTrueFalse(require_stacking)
250
 
        format = RemoteBzrDirFormat()
251
 
        format._network_name = bzrdir_name
252
 
        self._supply_sub_formats_to(format)
253
 
        bzrdir = RemoteBzrDir(transport, format, _client=client)
254
 
        if repo_path:
255
 
            repo_format = response_tuple_to_repo_format(response[1:])
256
 
            if repo_path == '.':
257
 
                repo_path = ''
258
 
            if repo_path:
259
 
                repo_bzrdir_format = RemoteBzrDirFormat()
260
 
                repo_bzrdir_format._network_name = response[5]
261
 
                repo_bzr = RemoteBzrDir(transport.clone(repo_path),
262
 
                    repo_bzrdir_format)
263
 
            else:
264
 
                repo_bzr = bzrdir
265
 
            final_stack = response[8] or None
266
 
            final_stack_pwd = response[9] or None
267
 
            if final_stack_pwd:
268
 
                final_stack_pwd = urlutils.join(
269
 
                    transport.base, final_stack_pwd)
270
 
            remote_repo = RemoteRepository(repo_bzr, repo_format)
271
 
            if len(response) > 10:
272
 
                # Updated server verb that locks remotely.
273
 
                repo_lock_token = response[10] or None
274
 
                remote_repo.lock_write(repo_lock_token, _skip_rpc=True)
275
 
                if repo_lock_token:
276
 
                    remote_repo.dont_leave_lock_in_place()
277
 
            else:
278
 
                remote_repo.lock_write()
279
 
            policy = _mod_bzrdir.UseExistingRepository(remote_repo, final_stack,
280
 
                final_stack_pwd, require_stacking)
281
 
            policy.acquire_repository()
282
 
        else:
283
 
            remote_repo = None
284
 
            policy = None
285
 
        bzrdir._format.set_branch_format(self.get_branch_format())
286
 
        if require_stacking:
287
 
            # The repo has already been created, but we need to make sure that
288
 
            # we'll make a stackable branch.
289
 
            bzrdir._format.require_stacking(_skip_repo=True)
290
 
        return remote_repo, bzrdir, require_stacking, policy
291
 
 
292
 
    def _open(self, transport):
293
 
        return RemoteBzrDir(transport, self)
294
 
 
295
 
    def __eq__(self, other):
296
 
        if not isinstance(other, RemoteBzrDirFormat):
297
 
            return False
298
 
        return self.get_format_description() == other.get_format_description()
299
 
 
300
 
    def __return_repository_format(self):
301
 
        # Always return a RemoteRepositoryFormat object, but if a specific bzr
302
 
        # repository format has been asked for, tell the RemoteRepositoryFormat
303
 
        # that it should use that for init() etc.
304
 
        result = RemoteRepositoryFormat()
305
 
        custom_format = getattr(self, '_repository_format', None)
306
 
        if custom_format:
307
 
            if isinstance(custom_format, RemoteRepositoryFormat):
308
 
                return custom_format
309
 
            else:
310
 
                # We will use the custom format to create repositories over the
311
 
                # wire; expose its details like rich_root_data for code to
312
 
                # query
313
 
                result._custom_format = custom_format
314
 
        return result
315
 
 
316
 
    def get_branch_format(self):
317
 
        result = _mod_bzrdir.BzrDirMetaFormat1.get_branch_format(self)
318
 
        if not isinstance(result, RemoteBranchFormat):
319
 
            new_result = RemoteBranchFormat()
320
 
            new_result._custom_format = result
321
 
            # cache the result
322
 
            self.set_branch_format(new_result)
323
 
            result = new_result
324
 
        return result
325
 
 
326
 
    repository_format = property(__return_repository_format,
327
 
        _mod_bzrdir.BzrDirMetaFormat1._set_repository_format) #.im_func)
328
 
 
329
 
 
330
 
class RemoteBzrDir(_mod_bzrdir.BzrDir, _RpcHelper):
 
91
# Note: RemoteBzrDirFormat is in bzrdir.py
 
92
 
 
93
class RemoteBzrDir(BzrDir, _RpcHelper):
331
94
    """Control directory on a remote server, accessed via bzr:// or similar."""
332
95
 
333
96
    def __init__(self, transport, format, _client=None, _force_probe=False):
336
99
        :param _client: Private parameter for testing. Disables probing and the
337
100
            use of a real bzrdir.
338
101
        """
339
 
        _mod_bzrdir.BzrDir.__init__(self, transport, format)
 
102
        BzrDir.__init__(self, transport, format)
340
103
        # this object holds a delegated bzrdir that uses file-level operations
341
104
        # to talk to the other side
342
105
        self._real_bzrdir = None
402
165
                import traceback
403
166
                warning('VFS BzrDir access triggered\n%s',
404
167
                    ''.join(traceback.format_stack()))
405
 
            self._real_bzrdir = _mod_bzrdir.BzrDir.open_from_transport(
 
168
            self._real_bzrdir = BzrDir.open_from_transport(
406
169
                self.root_transport, _server_formats=False)
407
170
            self._format._network_name = \
408
171
                self._real_bzrdir._format.network_name()
414
177
        # Prevent aliasing problems in the next_open_branch_result cache.
415
178
        # See create_branch for rationale.
416
179
        self._next_open_branch_result = None
417
 
        return _mod_bzrdir.BzrDir.break_lock(self)
 
180
        return BzrDir.break_lock(self)
418
181
 
419
182
    def _vfs_cloning_metadir(self, require_stacking=False):
420
183
        self._ensure_real()
453
216
        branch_ref, branch_name = branch_info
454
217
        format = controldir.network_format_registry.get(control_name)
455
218
        if repo_name:
456
 
            format.repository_format = _mod_repository.network_format_registry.get(
 
219
            format.repository_format = repository.network_format_registry.get(
457
220
                repo_name)
458
221
        if branch_ref == 'ref':
459
222
            # XXX: we need possible_transports here to avoid reopening the
460
223
            # connection to the referenced location
461
 
            ref_bzrdir = _mod_bzrdir.BzrDir.open(branch_name)
 
224
            ref_bzrdir = BzrDir.open(branch_name)
462
225
            branch_format = ref_bzrdir.cloning_metadir().get_branch_format()
463
226
            format.set_branch_format(branch_format)
464
227
        elif branch_ref == 'branch':
483
246
        self._ensure_real()
484
247
        self._real_bzrdir.destroy_repository()
485
248
 
486
 
    def create_branch(self, name=None, repository=None):
 
249
    def create_branch(self, name=None):
487
250
        # as per meta1 formats - just delegate to the format object which may
488
251
        # be parameterised.
489
252
        real_branch = self._format.get_branch_format().initialize(self,
490
 
            name=name, repository=repository)
 
253
            name=name)
491
254
        if not isinstance(real_branch, RemoteBranch):
492
 
            if not isinstance(repository, RemoteRepository):
493
 
                raise AssertionError(
494
 
                    'need a RemoteRepository to use with RemoteBranch, got %r'
495
 
                    % (repository,))
496
 
            result = RemoteBranch(self, repository, real_branch, name=name)
 
255
            result = RemoteBranch(self, self.find_repository(), real_branch,
 
256
                                  name=name)
497
257
        else:
498
258
            result = real_branch
499
259
        # BzrDir.clone_on_transport() uses the result of create_branch but does
511
271
        self._real_bzrdir.destroy_branch(name=name)
512
272
        self._next_open_branch_result = None
513
273
 
514
 
    def create_workingtree(self, revision_id=None, from_branch=None,
515
 
        accelerator_tree=None, hardlink=False):
 
274
    def create_workingtree(self, revision_id=None, from_branch=None):
516
275
        raise errors.NotLocalUrl(self.transport.base)
517
276
 
518
277
    def find_branch_format(self, name=None):
669
428
 
670
429
    def _path_for_remote_call(self, client):
671
430
        """Return the path to be used for this bzrdir in a remote call."""
672
 
        return urlutils.split_segment_parameters_raw(
673
 
            client.remote_path_from_transport(self.root_transport))[0]
 
431
        return client.remote_path_from_transport(self.root_transport)
674
432
 
675
433
    def get_branch_transport(self, branch_format, name=None):
676
434
        self._ensure_real()
688
446
        """Upgrading of remote bzrdirs is not supported yet."""
689
447
        return False
690
448
 
691
 
    def needs_format_conversion(self, format):
 
449
    def needs_format_conversion(self, format=None):
692
450
        """Upgrading of remote bzrdirs is not supported yet."""
 
451
        if format is None:
 
452
            symbol_versioning.warn(symbol_versioning.deprecated_in((1, 13, 0))
 
453
                % 'needs_format_conversion(format=None)')
693
454
        return False
694
455
 
695
456
    def clone(self, url, revision_id=None, force_new_repo=False,
702
463
        return RemoteBzrDirConfig(self)
703
464
 
704
465
 
705
 
class RemoteRepositoryFormat(vf_repository.VersionedFileRepositoryFormat):
 
466
class RemoteRepositoryFormat(repository.RepositoryFormat):
706
467
    """Format for repositories accessed over a _SmartClient.
707
468
 
708
469
    Instances of this repository are represented by RemoteRepository
723
484
    """
724
485
 
725
486
    _matchingbzrdir = RemoteBzrDirFormat()
726
 
    supports_full_versioned_files = True
727
 
    supports_leaving_lock = True
728
487
 
729
488
    def __init__(self):
730
 
        _mod_repository.RepositoryFormat.__init__(self)
 
489
        repository.RepositoryFormat.__init__(self)
731
490
        self._custom_format = None
732
491
        self._network_name = None
733
492
        self._creating_bzrdir = None
734
 
        self._revision_graph_can_have_wrong_parents = None
735
493
        self._supports_chks = None
736
494
        self._supports_external_lookups = None
737
495
        self._supports_tree_reference = None
738
 
        self._supports_funky_characters = None
739
496
        self._rich_root_data = None
740
497
 
741
498
    def __repr__(self):
770
527
        return self._supports_external_lookups
771
528
 
772
529
    @property
773
 
    def supports_funky_characters(self):
774
 
        if self._supports_funky_characters is None:
775
 
            self._ensure_real()
776
 
            self._supports_funky_characters = \
777
 
                self._custom_format.supports_funky_characters
778
 
        return self._supports_funky_characters
779
 
 
780
 
    @property
781
530
    def supports_tree_reference(self):
782
531
        if self._supports_tree_reference is None:
783
532
            self._ensure_real()
785
534
                self._custom_format.supports_tree_reference
786
535
        return self._supports_tree_reference
787
536
 
788
 
    @property
789
 
    def revision_graph_can_have_wrong_parents(self):
790
 
        if self._revision_graph_can_have_wrong_parents is None:
791
 
            self._ensure_real()
792
 
            self._revision_graph_can_have_wrong_parents = \
793
 
                self._custom_format.revision_graph_can_have_wrong_parents
794
 
        return self._revision_graph_can_have_wrong_parents
795
 
 
796
537
    def _vfs_initialize(self, a_bzrdir, shared):
797
538
        """Helper for common code in initialize."""
798
539
        if self._custom_format:
833
574
            network_name = self._network_name
834
575
        else:
835
576
            # Select the current bzrlib default and ask for that.
836
 
            reference_bzrdir_format = _mod_bzrdir.format_registry.get('default')()
 
577
            reference_bzrdir_format = bzrdir.format_registry.get('default')()
837
578
            reference_format = reference_bzrdir_format.repository_format
838
579
            network_name = reference_format.network_name()
839
580
        # 2) try direct creation via RPC
865
606
 
866
607
    def _ensure_real(self):
867
608
        if self._custom_format is None:
868
 
            self._custom_format = _mod_repository.network_format_registry.get(
 
609
            self._custom_format = repository.network_format_registry.get(
869
610
                self._network_name)
870
611
 
871
612
    @property
967
708
        # transport, but I'm not sure it's worth making this method
968
709
        # optional -- mbp 2010-04-21
969
710
        return self.bzrdir.get_repository_transport(None)
970
 
 
 
711
        
971
712
    def __str__(self):
972
713
        return "%s(%s)" % (self.__class__.__name__, self.base)
973
714
 
1081
822
    def find_text_key_references(self):
1082
823
        """Find the text key references within the repository.
1083
824
 
 
825
        :return: a dictionary mapping (file_id, revision_id) tuples to altered file-ids to an iterable of
 
826
        revision_ids. Each altered file-ids has the exact revision_ids that
 
827
        altered it listed explicitly.
1084
828
        :return: A dictionary mapping text keys ((fileid, revision_id) tuples)
1085
829
            to whether they were referred to by the inventory of the
1086
830
            revision_id that they contain. The inventory texts from all present
1104
848
        """Private method for using with old (< 1.2) servers to fallback."""
1105
849
        if revision_id is None:
1106
850
            revision_id = ''
1107
 
        elif _mod_revision.is_null(revision_id):
 
851
        elif revision.is_null(revision_id):
1108
852
            return {}
1109
853
 
1110
854
        path = self.bzrdir._path_for_remote_call(self._client)
1134
878
        return RemoteStreamSource(self, to_format)
1135
879
 
1136
880
    @needs_read_lock
1137
 
    def get_file_graph(self):
1138
 
        return graph.Graph(self.texts)
1139
 
 
1140
 
    @needs_read_lock
1141
881
    def has_revision(self, revision_id):
1142
882
        """True if this repository has a copy of the revision."""
1143
883
        # Copy of bzrlib.repository.Repository.has_revision
1195
935
        """See Repository.gather_stats()."""
1196
936
        path = self.bzrdir._path_for_remote_call(self._client)
1197
937
        # revid can be None to indicate no revisions, not just NULL_REVISION
1198
 
        if revid is None or _mod_revision.is_null(revid):
 
938
        if revid is None or revision.is_null(revid):
1199
939
            fmt_revid = ''
1200
940
        else:
1201
941
            fmt_revid = revid
1484
1224
 
1485
1225
    def get_commit_builder(self, branch, parents, config, timestamp=None,
1486
1226
                           timezone=None, committer=None, revprops=None,
1487
 
                           revision_id=None, lossy=False):
 
1227
                           revision_id=None):
1488
1228
        # FIXME: It ought to be possible to call this without immediately
1489
1229
        # triggering _ensure_real.  For now it's the easiest thing to do.
1490
1230
        self._ensure_real()
1491
1231
        real_repo = self._real_repository
1492
1232
        builder = real_repo.get_commit_builder(branch, parents,
1493
1233
                config, timestamp=timestamp, timezone=timezone,
1494
 
                committer=committer, revprops=revprops,
1495
 
                revision_id=revision_id, lossy=lossy)
 
1234
                committer=committer, revprops=revprops, revision_id=revision_id)
1496
1235
        return builder
1497
1236
 
1498
1237
    def add_fallback_repository(self, repository):
1604
1343
        return result
1605
1344
 
1606
1345
    @needs_read_lock
1607
 
    def search_missing_revision_ids(self, other,
1608
 
            revision_id=symbol_versioning.DEPRECATED_PARAMETER,
1609
 
            find_ghosts=True, revision_ids=None, if_present_ids=None,
1610
 
            limit=None):
 
1346
    def search_missing_revision_ids(self, other, revision_id=None, find_ghosts=True):
1611
1347
        """Return the revision ids that other has that this does not.
1612
1348
 
1613
1349
        These are returned in topological order.
1614
1350
 
1615
1351
        revision_id: only return revision ids included by revision_id.
1616
1352
        """
1617
 
        if symbol_versioning.deprecated_passed(revision_id):
1618
 
            symbol_versioning.warn(
1619
 
                'search_missing_revision_ids(revision_id=...) was '
1620
 
                'deprecated in 2.4.  Use revision_ids=[...] instead.',
1621
 
                DeprecationWarning, stacklevel=2)
1622
 
            if revision_ids is not None:
1623
 
                raise AssertionError(
1624
 
                    'revision_ids is mutually exclusive with revision_id')
1625
 
            if revision_id is not None:
1626
 
                revision_ids = [revision_id]
1627
 
        inter_repo = _mod_repository.InterRepository.get(other, self)
1628
 
        return inter_repo.search_missing_revision_ids(
1629
 
            find_ghosts=find_ghosts, revision_ids=revision_ids,
1630
 
            if_present_ids=if_present_ids, limit=limit)
 
1353
        return repository.InterRepository.get(
 
1354
            other, self).search_missing_revision_ids(revision_id, find_ghosts)
1631
1355
 
1632
 
    def fetch(self, source, revision_id=None, find_ghosts=False,
 
1356
    def fetch(self, source, revision_id=None, pb=None, find_ghosts=False,
1633
1357
            fetch_spec=None):
1634
1358
        # No base implementation to use as RemoteRepository is not a subclass
1635
1359
        # of Repository; so this is a copy of Repository.fetch().
1646
1370
            # check that last_revision is in 'from' and then return a
1647
1371
            # no-operation.
1648
1372
            if (revision_id is not None and
1649
 
                not _mod_revision.is_null(revision_id)):
 
1373
                not revision.is_null(revision_id)):
1650
1374
                self.get_revision(revision_id)
1651
1375
            return 0, []
1652
1376
        # if there is no specific appropriate InterRepository, this will get
1653
1377
        # the InterRepository base class, which raises an
1654
1378
        # IncompatibleRepositories when asked to fetch.
1655
 
        inter = _mod_repository.InterRepository.get(source, self)
1656
 
        return inter.fetch(revision_id=revision_id,
 
1379
        inter = repository.InterRepository.get(source, self)
 
1380
        return inter.fetch(revision_id=revision_id, pb=pb,
1657
1381
            find_ghosts=find_ghosts, fetch_spec=fetch_spec)
1658
1382
 
1659
1383
    def create_bundle(self, target, base, fileobj, format=None):
1661
1385
        self._real_repository.create_bundle(target, base, fileobj, format)
1662
1386
 
1663
1387
    @needs_read_lock
1664
 
    @symbol_versioning.deprecated_method(
1665
 
        symbol_versioning.deprecated_in((2, 4, 0)))
1666
1388
    def get_ancestry(self, revision_id, topo_sorted=True):
1667
1389
        self._ensure_real()
1668
1390
        return self._real_repository.get_ancestry(revision_id, topo_sorted)
1885
1607
            tmpdir = osutils.mkdtemp()
1886
1608
            try:
1887
1609
                _extract_tar(tar, tmpdir)
1888
 
                tmp_bzrdir = _mod_bzrdir.BzrDir.open(tmpdir)
 
1610
                tmp_bzrdir = BzrDir.open(tmpdir)
1889
1611
                tmp_repo = tmp_bzrdir.open_repository()
1890
1612
                tmp_repo.copy_content_into(destination, revision_id)
1891
1613
            finally:
1976
1698
    def supports_rich_root(self):
1977
1699
        return self._format.rich_root_data
1978
1700
 
1979
 
    @symbol_versioning.deprecated_method(symbol_versioning.deprecated_in((2, 4, 0)))
1980
1701
    def iter_reverse_revision_history(self, revision_id):
1981
1702
        self._ensure_real()
1982
1703
        return self._real_repository.iter_reverse_revision_history(revision_id)
2003
1724
        return self._real_repository.item_keys_introduced_by(revision_ids,
2004
1725
            _files_pb=_files_pb)
2005
1726
 
 
1727
    def revision_graph_can_have_wrong_parents(self):
 
1728
        # The answer depends on the remote repo format.
 
1729
        self._ensure_real()
 
1730
        return self._real_repository.revision_graph_can_have_wrong_parents()
 
1731
 
2006
1732
    def _find_inconsistent_revision_parents(self, revisions_iterator=None):
2007
1733
        self._ensure_real()
2008
1734
        return self._real_repository._find_inconsistent_revision_parents(
2016
1742
        providers = [self._unstacked_provider]
2017
1743
        if other is not None:
2018
1744
            providers.insert(0, other)
2019
 
        return graph.StackedParentsProvider(_LazyListJoin(
2020
 
            providers, self._fallback_repositories))
 
1745
        providers.extend(r._make_parents_provider() for r in
 
1746
                         self._fallback_repositories)
 
1747
        return graph.StackedParentsProvider(providers)
2021
1748
 
2022
1749
    def _serialise_search_recipe(self, recipe):
2023
1750
        """Serialise a graph search recipe.
2031
1758
        return '\n'.join((start_keys, stop_keys, count))
2032
1759
 
2033
1760
    def _serialise_search_result(self, search_result):
2034
 
        parts = search_result.get_network_struct()
 
1761
        if isinstance(search_result, graph.PendingAncestryResult):
 
1762
            parts = ['ancestry-of']
 
1763
            parts.extend(search_result.heads)
 
1764
        else:
 
1765
            recipe = search_result.get_recipe()
 
1766
            parts = [recipe[0], self._serialise_search_recipe(recipe)]
2035
1767
        return '\n'.join(parts)
2036
1768
 
2037
1769
    def autopack(self):
2047
1779
            raise errors.UnexpectedSmartServerResponse(response)
2048
1780
 
2049
1781
 
2050
 
class RemoteStreamSink(vf_repository.StreamSink):
 
1782
class RemoteStreamSink(repository.StreamSink):
2051
1783
 
2052
1784
    def _insert_real(self, stream, src_format, resume_tokens):
2053
1785
        self.target_repo._ensure_real()
2154
1886
        self._last_substream and self._last_stream so that the stream can be
2155
1887
        resumed by _resume_stream_with_vfs.
2156
1888
        """
2157
 
 
 
1889
                    
2158
1890
        stream_iter = iter(stream)
2159
1891
        for substream_kind, substream in stream_iter:
2160
1892
            if substream_kind == 'inventory-deltas':
2163
1895
                return
2164
1896
            else:
2165
1897
                yield substream_kind, substream
2166
 
 
2167
 
 
2168
 
class RemoteStreamSource(vf_repository.StreamSource):
 
1898
            
 
1899
 
 
1900
class RemoteStreamSource(repository.StreamSource):
2169
1901
    """Stream data from a remote server."""
2170
1902
 
2171
1903
    def get_stream(self, search):
2231
1963
        candidate_verbs = [
2232
1964
            ('Repository.get_stream_1.19', (1, 19)),
2233
1965
            ('Repository.get_stream', (1, 13))]
2234
 
 
2235
1966
        found_verb = False
2236
1967
        for verb, version in candidate_verbs:
2237
1968
            if medium._is_remote_before(version):
2241
1972
                    verb, args, search_bytes)
2242
1973
            except errors.UnknownSmartMethod:
2243
1974
                medium._remember_remote_is_before(version)
2244
 
            except errors.UnknownErrorFromSmartServer, e:
2245
 
                if isinstance(search, graph.EverythingResult):
2246
 
                    error_verb = e.error_from_smart_server.error_verb
2247
 
                    if error_verb == 'BadSearch':
2248
 
                        # Pre-2.4 servers don't support this sort of search.
2249
 
                        # XXX: perhaps falling back to VFS on BadSearch is a
2250
 
                        # good idea in general?  It might provide a little bit
2251
 
                        # of protection against client-side bugs.
2252
 
                        medium._remember_remote_is_before((2, 4))
2253
 
                        break
2254
 
                raise
2255
1975
            else:
2256
1976
                response_tuple, response_handler = response
2257
1977
                found_verb = True
2372
2092
                                  name=name)
2373
2093
        return result
2374
2094
 
2375
 
    def initialize(self, a_bzrdir, name=None, repository=None):
 
2095
    def initialize(self, a_bzrdir, name=None):
2376
2096
        # 1) get the network name to use.
2377
2097
        if self._custom_format:
2378
2098
            network_name = self._custom_format.network_name()
2379
2099
        else:
2380
2100
            # Select the current bzrlib default and ask for that.
2381
 
            reference_bzrdir_format = _mod_bzrdir.format_registry.get('default')()
 
2101
            reference_bzrdir_format = bzrdir.format_registry.get('default')()
2382
2102
            reference_format = reference_bzrdir_format.get_branch_format()
2383
2103
            self._custom_format = reference_format
2384
2104
            network_name = reference_format.network_name()
2406
2126
        # Turn the response into a RemoteRepository object.
2407
2127
        format = RemoteBranchFormat(network_name=response[1])
2408
2128
        repo_format = response_tuple_to_repo_format(response[3:])
2409
 
        repo_path = response[2]
2410
 
        if repository is not None:
2411
 
            remote_repo_url = urlutils.join(a_bzrdir.user_url, repo_path)
2412
 
            url_diff = urlutils.relative_url(repository.user_url,
2413
 
                    remote_repo_url)
2414
 
            if url_diff != '.':
2415
 
                raise AssertionError(
2416
 
                    'repository.user_url %r does not match URL from server '
2417
 
                    'response (%r + %r)'
2418
 
                    % (repository.user_url, a_bzrdir.user_url, repo_path))
2419
 
            remote_repo = repository
 
2129
        if response[2] == '':
 
2130
            repo_bzrdir = a_bzrdir
2420
2131
        else:
2421
 
            if repo_path == '':
2422
 
                repo_bzrdir = a_bzrdir
2423
 
            else:
2424
 
                repo_bzrdir = RemoteBzrDir(
2425
 
                    a_bzrdir.root_transport.clone(repo_path), a_bzrdir._format,
2426
 
                    a_bzrdir._client)
2427
 
            remote_repo = RemoteRepository(repo_bzrdir, repo_format)
 
2132
            repo_bzrdir = RemoteBzrDir(
 
2133
                a_bzrdir.root_transport.clone(response[2]), a_bzrdir._format,
 
2134
                a_bzrdir._client)
 
2135
        remote_repo = RemoteRepository(repo_bzrdir, repo_format)
2428
2136
        remote_branch = RemoteBranch(a_bzrdir, remote_repo,
2429
2137
            format=format, setup_stacking=False, name=name)
2430
2138
        # XXX: We know this is a new branch, so it must have revno 0, revid
2451
2159
        self._ensure_real()
2452
2160
        return self._custom_format.supports_set_append_revisions_only()
2453
2161
 
2454
 
    def _use_default_local_heads_to_fetch(self):
2455
 
        # If the branch format is a metadir format *and* its heads_to_fetch
2456
 
        # implementation is not overridden vs the base class, we can use the
2457
 
        # base class logic rather than use the heads_to_fetch RPC.  This is
2458
 
        # usually cheaper in terms of net round trips, as the last-revision and
2459
 
        # tags info fetched is cached and would be fetched anyway.
2460
 
        self._ensure_real()
2461
 
        if isinstance(self._custom_format, branch.BranchFormatMetadir):
2462
 
            branch_class = self._custom_format._branch_class()
2463
 
            heads_to_fetch_impl = branch_class.heads_to_fetch.im_func
2464
 
            if heads_to_fetch_impl is branch.Branch.heads_to_fetch.im_func:
2465
 
                return True
2466
 
        return False
2467
2162
 
2468
2163
class RemoteBranch(branch.Branch, _RpcHelper, lock._RelockDebugMixin):
2469
2164
    """Branch stored on a server accessed by HPSS RPC.
2668
2363
            self._is_stacked = False
2669
2364
        else:
2670
2365
            self._is_stacked = True
2671
 
 
 
2366
        
2672
2367
    def _vfs_get_tags_bytes(self):
2673
2368
        self._ensure_real()
2674
2369
        return self._real_branch._get_tags_bytes()
2675
2370
 
2676
 
    @needs_read_lock
2677
2371
    def _get_tags_bytes(self):
2678
 
        if self._tags_bytes is None:
2679
 
            self._tags_bytes = self._get_tags_bytes_via_hpss()
2680
 
        return self._tags_bytes
2681
 
 
2682
 
    def _get_tags_bytes_via_hpss(self):
2683
2372
        medium = self._client._medium
2684
2373
        if medium._is_remote_before((1, 13)):
2685
2374
            return self._vfs_get_tags_bytes()
2695
2384
        return self._real_branch._set_tags_bytes(bytes)
2696
2385
 
2697
2386
    def _set_tags_bytes(self, bytes):
2698
 
        if self.is_locked():
2699
 
            self._tags_bytes = bytes
2700
2387
        medium = self._client._medium
2701
2388
        if medium._is_remote_before((1, 18)):
2702
2389
            self._vfs_set_tags_bytes(bytes)
2856
2543
            missing_parent = parent_map[missing_parent]
2857
2544
        raise errors.RevisionNotPresent(missing_parent, self.repository)
2858
2545
 
2859
 
    def _read_last_revision_info(self):
 
2546
    def _last_revision_info(self):
2860
2547
        response = self._call('Branch.last_revision_info', self._remote_path())
2861
2548
        if response[0] != 'ok':
2862
2549
            raise SmartProtocolError('unexpected response code %s' % (response,))
2925
2612
            raise errors.UnexpectedSmartServerResponse(response)
2926
2613
        self._run_post_change_branch_tip_hooks(old_revno, old_revid)
2927
2614
 
2928
 
    @symbol_versioning.deprecated_method(symbol_versioning.deprecated_in((2, 4, 0)))
2929
2615
    @needs_write_lock
2930
2616
    def set_revision_history(self, rev_history):
2931
 
        """See Branch.set_revision_history."""
2932
 
        self._set_revision_history(rev_history)
2933
 
 
2934
 
    @needs_write_lock
2935
 
    def _set_revision_history(self, rev_history):
2936
2617
        # Send just the tip revision of the history; the server will generate
2937
2618
        # the full history from that.  If the revision doesn't exist in this
2938
2619
        # branch, NoSuchRevision will be raised.
2996
2677
            _override_hook_target=self, **kwargs)
2997
2678
 
2998
2679
    @needs_read_lock
2999
 
    def push(self, target, overwrite=False, stop_revision=None, lossy=False):
 
2680
    def push(self, target, overwrite=False, stop_revision=None):
3000
2681
        self._ensure_real()
3001
2682
        return self._real_branch.push(
3002
 
            target, overwrite=overwrite, stop_revision=stop_revision, lossy=lossy,
 
2683
            target, overwrite=overwrite, stop_revision=stop_revision,
3003
2684
            _override_hook_source_branch=self)
3004
2685
 
3005
2686
    def is_locked(self):
3015
2696
        # XXX: These should be returned by the set_last_revision_info verb
3016
2697
        old_revno, old_revid = self.last_revision_info()
3017
2698
        self._run_pre_change_branch_tip_hooks(revno, revision_id)
3018
 
        if not revision_id or not isinstance(revision_id, basestring):
3019
 
            raise errors.InvalidRevisionId(revision_id=revision_id, branch=self)
 
2699
        revision_id = ensure_null(revision_id)
3020
2700
        try:
3021
2701
            response = self._call('Branch.set_last_revision_info',
3022
2702
                self._remote_path(), self._lock_token, self._repo_lock_token,
3051
2731
            except errors.UnknownSmartMethod:
3052
2732
                medium._remember_remote_is_before((1, 6))
3053
2733
        self._clear_cached_state_of_remote_branch_only()
3054
 
        self._set_revision_history(self._lefthand_history(revision_id,
 
2734
        self.set_revision_history(self._lefthand_history(revision_id,
3055
2735
            last_rev=last_rev,other_branch=other_branch))
3056
2736
 
3057
2737
    def set_push_location(self, location):
3058
2738
        self._ensure_real()
3059
2739
        return self._real_branch.set_push_location(location)
3060
2740
 
3061
 
    def heads_to_fetch(self):
3062
 
        if self._format._use_default_local_heads_to_fetch():
3063
 
            # We recognise this format, and its heads-to-fetch implementation
3064
 
            # is the default one (tip + tags).  In this case it's cheaper to
3065
 
            # just use the default implementation rather than a special RPC as
3066
 
            # the tip and tags data is cached.
3067
 
            return branch.Branch.heads_to_fetch(self)
3068
 
        medium = self._client._medium
3069
 
        if medium._is_remote_before((2, 4)):
3070
 
            return self._vfs_heads_to_fetch()
3071
 
        try:
3072
 
            return self._rpc_heads_to_fetch()
3073
 
        except errors.UnknownSmartMethod:
3074
 
            medium._remember_remote_is_before((2, 4))
3075
 
            return self._vfs_heads_to_fetch()
3076
 
 
3077
 
    def _rpc_heads_to_fetch(self):
3078
 
        response = self._call('Branch.heads_to_fetch', self._remote_path())
3079
 
        if len(response) != 2:
3080
 
            raise errors.UnexpectedSmartServerResponse(response)
3081
 
        must_fetch, if_present_fetch = response
3082
 
        return set(must_fetch), set(if_present_fetch)
3083
 
 
3084
 
    def _vfs_heads_to_fetch(self):
3085
 
        self._ensure_real()
3086
 
        return self._real_branch.heads_to_fetch()
3087
 
 
3088
2741
 
3089
2742
class RemoteConfig(object):
3090
2743
    """A Config that reads and writes from smart verbs.
3104
2757
        """
3105
2758
        try:
3106
2759
            configobj = self._get_configobj()
3107
 
            section_obj = None
3108
2760
            if section is None:
3109
2761
                section_obj = configobj
3110
2762
            else:
3111
2763
                try:
3112
2764
                    section_obj = configobj[section]
3113
2765
                except KeyError:
3114
 
                    pass
3115
 
            if section_obj is None:
3116
 
                value = default
3117
 
            else:
3118
 
                value = section_obj.get(name, default)
 
2766
                    return default
 
2767
            return section_obj.get(name, default)
3119
2768
        except errors.UnknownSmartMethod:
3120
 
            value = self._vfs_get_option(name, section, default)
3121
 
        for hook in config.OldConfigHooks['get']:
3122
 
            hook(self, name, value)
3123
 
        return value
 
2769
            return self._vfs_get_option(name, section, default)
3124
2770
 
3125
2771
    def _response_to_configobj(self, response):
3126
2772
        if len(response[0]) and response[0][0] != 'ok':
3127
2773
            raise errors.UnexpectedSmartServerResponse(response)
3128
2774
        lines = response[1].read_body_bytes().splitlines()
3129
 
        conf = config.ConfigObj(lines, encoding='utf-8')
3130
 
        for hook in config.OldConfigHooks['load']:
3131
 
            hook(self)
3132
 
        return conf
 
2775
        return config.ConfigObj(lines, encoding='utf-8')
3133
2776
 
3134
2777
 
3135
2778
class RemoteBranchConfig(RemoteConfig):
3287
2930
                    'Missing key %r in context %r', key_err.args[0], context)
3288
2931
                raise err
3289
2932
 
3290
 
    if err.error_verb == 'NoSuchRevision':
 
2933
    if err.error_verb == 'IncompatibleRepositories':
 
2934
        raise errors.IncompatibleRepositories(err.error_args[0],
 
2935
            err.error_args[1], err.error_args[2])
 
2936
    elif err.error_verb == 'NoSuchRevision':
3291
2937
        raise NoSuchRevision(find('branch'), err.error_args[0])
3292
2938
    elif err.error_verb == 'nosuchrevision':
3293
2939
        raise NoSuchRevision(find('repository'), err.error_args[0])
3300
2946
            detail=extra)
3301
2947
    elif err.error_verb == 'norepository':
3302
2948
        raise errors.NoRepositoryPresent(find('bzrdir'))
 
2949
    elif err.error_verb == 'LockContention':
 
2950
        raise errors.LockContention('(remote lock)')
3303
2951
    elif err.error_verb == 'UnlockableTransport':
3304
2952
        raise errors.UnlockableTransport(find('bzrdir').root_transport)
 
2953
    elif err.error_verb == 'LockFailed':
 
2954
        raise errors.LockFailed(err.error_args[0], err.error_args[1])
3305
2955
    elif err.error_verb == 'TokenMismatch':
3306
2956
        raise errors.TokenMismatch(find('token'), '(remote token)')
3307
2957
    elif err.error_verb == 'Diverged':
3308
2958
        raise errors.DivergedBranches(find('branch'), find('other_branch'))
 
2959
    elif err.error_verb == 'TipChangeRejected':
 
2960
        raise errors.TipChangeRejected(err.error_args[0].decode('utf8'))
 
2961
    elif err.error_verb == 'UnstackableBranchFormat':
 
2962
        raise errors.UnstackableBranchFormat(*err.error_args)
 
2963
    elif err.error_verb == 'UnstackableRepositoryFormat':
 
2964
        raise errors.UnstackableRepositoryFormat(*err.error_args)
3309
2965
    elif err.error_verb == 'NotStacked':
3310
2966
        raise errors.NotStacked(branch=find('branch'))
3311
2967
    elif err.error_verb == 'PermissionDenied':
3321
2977
    elif err.error_verb == 'NoSuchFile':
3322
2978
        path = get_path()
3323
2979
        raise errors.NoSuchFile(path)
3324
 
    _translate_error_without_context(err)
3325
 
 
3326
 
 
3327
 
def _translate_error_without_context(err):
3328
 
    """Translate any ErrorFromSmartServer values that don't require context"""
3329
 
    if err.error_verb == 'IncompatibleRepositories':
3330
 
        raise errors.IncompatibleRepositories(err.error_args[0],
3331
 
            err.error_args[1], err.error_args[2])
3332
 
    elif err.error_verb == 'LockContention':
3333
 
        raise errors.LockContention('(remote lock)')
3334
 
    elif err.error_verb == 'LockFailed':
3335
 
        raise errors.LockFailed(err.error_args[0], err.error_args[1])
3336
 
    elif err.error_verb == 'TipChangeRejected':
3337
 
        raise errors.TipChangeRejected(err.error_args[0].decode('utf8'))
3338
 
    elif err.error_verb == 'UnstackableBranchFormat':
3339
 
        raise errors.UnstackableBranchFormat(*err.error_args)
3340
 
    elif err.error_verb == 'UnstackableRepositoryFormat':
3341
 
        raise errors.UnstackableRepositoryFormat(*err.error_args)
3342
2980
    elif err.error_verb == 'FileExists':
3343
2981
        raise errors.FileExists(err.error_args[0])
3344
2982
    elif err.error_verb == 'DirectoryNotEmpty':
3363
3001
            raise UnicodeEncodeError(encoding, val, start, end, reason)
3364
3002
    elif err.error_verb == 'ReadOnlyError':
3365
3003
        raise errors.TransportNotPossible('readonly transport')
3366
 
    elif err.error_verb == 'MemoryError':
3367
 
        raise errors.BzrError("remote server out of memory\n"
3368
 
            "Retry non-remotely, or contact the server admin for details.")
3369
3004
    raise errors.UnknownErrorFromSmartServer(err)