65
80
method, args, body_bytes)
66
81
except errors.ErrorFromSmartServer, err:
67
82
self._translate_error(err, **err_context)
69
# Note: RemoteBzrDirFormat is in bzrdir.py
71
class RemoteBzrDir(BzrDir, _RpcHelper):
85
def response_tuple_to_repo_format(response):
86
"""Convert a response tuple describing a repository format to a format."""
87
format = RemoteRepositoryFormat()
88
format._rich_root_data = (response[0] == 'yes')
89
format._supports_tree_reference = (response[1] == 'yes')
90
format._supports_external_lookups = (response[2] == 'yes')
91
format._network_name = response[3]
95
# Note that RemoteBzrDirProber lives in bzrlib.bzrdir so bzrlib.remote
96
# does not have to be imported unless a remote format is involved.
98
class RemoteBzrDirFormat(_mod_bzrdir.BzrDirMetaFormat1):
99
"""Format representing bzrdirs accessed via a smart server"""
101
supports_workingtrees = False
104
_mod_bzrdir.BzrDirMetaFormat1.__init__(self)
105
# XXX: It's a bit ugly that the network name is here, because we'd
106
# like to believe that format objects are stateless or at least
107
# immutable, However, we do at least avoid mutating the name after
108
# it's returned. See <https://bugs.launchpad.net/bzr/+bug/504102>
109
self._network_name = None
112
return "%s(_network_name=%r)" % (self.__class__.__name__,
115
def get_format_description(self):
116
if self._network_name:
117
real_format = controldir.network_format_registry.get(self._network_name)
118
return 'Remote: ' + real_format.get_format_description()
119
return 'bzr remote bzrdir'
121
def get_format_string(self):
122
raise NotImplementedError(self.get_format_string)
124
def network_name(self):
125
if self._network_name:
126
return self._network_name
128
raise AssertionError("No network name set.")
130
def initialize_on_transport(self, transport):
132
# hand off the request to the smart server
133
client_medium = transport.get_smart_medium()
134
except errors.NoSmartMedium:
135
# TODO: lookup the local format from a server hint.
136
local_dir_format = _mod_bzrdir.BzrDirMetaFormat1()
137
return local_dir_format.initialize_on_transport(transport)
138
client = _SmartClient(client_medium)
139
path = client.remote_path_from_transport(transport)
141
response = client.call('BzrDirFormat.initialize', path)
142
except errors.ErrorFromSmartServer, err:
143
_translate_error(err, path=path)
144
if response[0] != 'ok':
145
raise errors.SmartProtocolError('unexpected response code %s' % (response,))
146
format = RemoteBzrDirFormat()
147
self._supply_sub_formats_to(format)
148
return RemoteBzrDir(transport, format)
150
def parse_NoneTrueFalse(self, arg):
157
raise AssertionError("invalid arg %r" % arg)
159
def _serialize_NoneTrueFalse(self, arg):
166
def _serialize_NoneString(self, arg):
169
def initialize_on_transport_ex(self, transport, use_existing_dir=False,
170
create_prefix=False, force_new_repo=False, stacked_on=None,
171
stack_on_pwd=None, repo_format_name=None, make_working_trees=None,
174
# hand off the request to the smart server
175
client_medium = transport.get_smart_medium()
176
except errors.NoSmartMedium:
179
# Decline to open it if the server doesn't support our required
180
# version (3) so that the VFS-based transport will do it.
181
if client_medium.should_probe():
183
server_version = client_medium.protocol_version()
184
if server_version != '2':
188
except errors.SmartProtocolError:
189
# Apparently there's no usable smart server there, even though
190
# the medium supports the smart protocol.
195
client = _SmartClient(client_medium)
196
path = client.remote_path_from_transport(transport)
197
if client_medium._is_remote_before((1, 16)):
200
# TODO: lookup the local format from a server hint.
201
local_dir_format = _mod_bzrdir.BzrDirMetaFormat1()
202
self._supply_sub_formats_to(local_dir_format)
203
return local_dir_format.initialize_on_transport_ex(transport,
204
use_existing_dir=use_existing_dir, create_prefix=create_prefix,
205
force_new_repo=force_new_repo, stacked_on=stacked_on,
206
stack_on_pwd=stack_on_pwd, repo_format_name=repo_format_name,
207
make_working_trees=make_working_trees, shared_repo=shared_repo,
209
return self._initialize_on_transport_ex_rpc(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)
213
def _initialize_on_transport_ex_rpc(self, client, path, transport,
214
use_existing_dir, create_prefix, force_new_repo, stacked_on,
215
stack_on_pwd, repo_format_name, make_working_trees, shared_repo):
217
args.append(self._serialize_NoneTrueFalse(use_existing_dir))
218
args.append(self._serialize_NoneTrueFalse(create_prefix))
219
args.append(self._serialize_NoneTrueFalse(force_new_repo))
220
args.append(self._serialize_NoneString(stacked_on))
221
# stack_on_pwd is often/usually our transport
224
stack_on_pwd = transport.relpath(stack_on_pwd)
227
except errors.PathNotChild:
229
args.append(self._serialize_NoneString(stack_on_pwd))
230
args.append(self._serialize_NoneString(repo_format_name))
231
args.append(self._serialize_NoneTrueFalse(make_working_trees))
232
args.append(self._serialize_NoneTrueFalse(shared_repo))
233
request_network_name = self._network_name or \
234
_mod_bzrdir.BzrDirFormat.get_default_format().network_name()
236
response = client.call('BzrDirFormat.initialize_ex_1.16',
237
request_network_name, path, *args)
238
except errors.UnknownSmartMethod:
239
client._medium._remember_remote_is_before((1,16))
240
local_dir_format = _mod_bzrdir.BzrDirMetaFormat1()
241
self._supply_sub_formats_to(local_dir_format)
242
return local_dir_format.initialize_on_transport_ex(transport,
243
use_existing_dir=use_existing_dir, create_prefix=create_prefix,
244
force_new_repo=force_new_repo, stacked_on=stacked_on,
245
stack_on_pwd=stack_on_pwd, repo_format_name=repo_format_name,
246
make_working_trees=make_working_trees, shared_repo=shared_repo,
248
except errors.ErrorFromSmartServer, err:
249
_translate_error(err, path=path)
250
repo_path = response[0]
251
bzrdir_name = response[6]
252
require_stacking = response[7]
253
require_stacking = self.parse_NoneTrueFalse(require_stacking)
254
format = RemoteBzrDirFormat()
255
format._network_name = bzrdir_name
256
self._supply_sub_formats_to(format)
257
bzrdir = RemoteBzrDir(transport, format, _client=client)
259
repo_format = response_tuple_to_repo_format(response[1:])
263
repo_bzrdir_format = RemoteBzrDirFormat()
264
repo_bzrdir_format._network_name = response[5]
265
repo_bzr = RemoteBzrDir(transport.clone(repo_path),
269
final_stack = response[8] or None
270
final_stack_pwd = response[9] or None
272
final_stack_pwd = urlutils.join(
273
transport.base, final_stack_pwd)
274
remote_repo = RemoteRepository(repo_bzr, repo_format)
275
if len(response) > 10:
276
# Updated server verb that locks remotely.
277
repo_lock_token = response[10] or None
278
remote_repo.lock_write(repo_lock_token, _skip_rpc=True)
280
remote_repo.dont_leave_lock_in_place()
282
remote_repo.lock_write()
283
policy = _mod_bzrdir.UseExistingRepository(remote_repo, final_stack,
284
final_stack_pwd, require_stacking)
285
policy.acquire_repository()
289
bzrdir._format.set_branch_format(self.get_branch_format())
291
# The repo has already been created, but we need to make sure that
292
# we'll make a stackable branch.
293
bzrdir._format.require_stacking(_skip_repo=True)
294
return remote_repo, bzrdir, require_stacking, policy
296
def _open(self, transport):
297
return RemoteBzrDir(transport, self)
299
def __eq__(self, other):
300
if not isinstance(other, RemoteBzrDirFormat):
302
return self.get_format_description() == other.get_format_description()
304
def __return_repository_format(self):
305
# Always return a RemoteRepositoryFormat object, but if a specific bzr
306
# repository format has been asked for, tell the RemoteRepositoryFormat
307
# that it should use that for init() etc.
308
result = RemoteRepositoryFormat()
309
custom_format = getattr(self, '_repository_format', None)
311
if isinstance(custom_format, RemoteRepositoryFormat):
314
# We will use the custom format to create repositories over the
315
# wire; expose its details like rich_root_data for code to
317
result._custom_format = custom_format
320
def get_branch_format(self):
321
result = _mod_bzrdir.BzrDirMetaFormat1.get_branch_format(self)
322
if not isinstance(result, RemoteBranchFormat):
323
new_result = RemoteBranchFormat()
324
new_result._custom_format = result
326
self.set_branch_format(new_result)
330
repository_format = property(__return_repository_format,
331
_mod_bzrdir.BzrDirMetaFormat1._set_repository_format) #.im_func)
334
class RemoteBzrDir(_mod_bzrdir.BzrDir, _RpcHelper):
72
335
"""Control directory on a remote server, accessed via bzr:// or similar."""
74
def __init__(self, transport, _client=None):
337
def __init__(self, transport, format, _client=None, _force_probe=False):
75
338
"""Construct a RemoteBzrDir.
77
340
:param _client: Private parameter for testing. Disables probing and the
78
341
use of a real bzrdir.
80
BzrDir.__init__(self, transport, RemoteBzrDirFormat())
343
_mod_bzrdir.BzrDir.__init__(self, transport, format)
81
344
# this object holds a delegated bzrdir that uses file-level operations
82
345
# to talk to the other side
83
346
self._real_bzrdir = None
347
self._has_working_tree = None
348
# 1-shot cache for the call pattern 'create_branch; open_branch' - see
349
# create_branch for details.
350
self._next_open_branch_result = None
85
352
if _client is None:
86
353
medium = transport.get_smart_medium()
87
354
self._client = client._SmartClient(medium)
89
356
self._client = _client
363
return '%s(%r)' % (self.__class__.__name__, self._client)
365
def _probe_bzrdir(self):
366
medium = self._client._medium
92
367
path = self._path_for_remote_call(self._client)
368
if medium._is_remote_before((2, 1)):
372
self._rpc_open_2_1(path)
374
except errors.UnknownSmartMethod:
375
medium._remember_remote_is_before((2, 1))
378
def _rpc_open_2_1(self, path):
379
response = self._call('BzrDir.open_2.1', path)
380
if response == ('no',):
381
raise errors.NotBranchError(path=self.root_transport.base)
382
elif response[0] == 'yes':
383
if response[1] == 'yes':
384
self._has_working_tree = True
385
elif response[1] == 'no':
386
self._has_working_tree = False
388
raise errors.UnexpectedSmartServerResponse(response)
390
raise errors.UnexpectedSmartServerResponse(response)
392
def _rpc_open(self, path):
93
393
response = self._call('BzrDir.open', path)
94
394
if response not in [('yes',), ('no',)]:
95
395
raise errors.UnexpectedSmartServerResponse(response)
96
396
if response == ('no',):
97
raise errors.NotBranchError(path=transport.base)
397
raise errors.NotBranchError(path=self.root_transport.base)
99
399
def _ensure_real(self):
100
400
"""Ensure that there is a _real_bzrdir set.
102
402
Used before calls to self._real_bzrdir.
104
404
if not self._real_bzrdir:
105
self._real_bzrdir = BzrDir.open_from_transport(
405
if 'hpssvfs' in debug.debug_flags:
407
warning('VFS BzrDir access triggered\n%s',
408
''.join(traceback.format_stack()))
409
self._real_bzrdir = _mod_bzrdir.BzrDir.open_from_transport(
106
410
self.root_transport, _server_formats=False)
411
self._format._network_name = \
412
self._real_bzrdir._format.network_name()
108
414
def _translate_error(self, err, **context):
109
415
_translate_error(err, bzrdir=self, **context)
111
def cloning_metadir(self, stacked=False):
417
def break_lock(self):
418
# Prevent aliasing problems in the next_open_branch_result cache.
419
# See create_branch for rationale.
420
self._next_open_branch_result = None
421
return _mod_bzrdir.BzrDir.break_lock(self)
423
def _vfs_cloning_metadir(self, require_stacking=False):
112
424
self._ensure_real()
113
return self._real_bzrdir.cloning_metadir(stacked)
425
return self._real_bzrdir.cloning_metadir(
426
require_stacking=require_stacking)
428
def cloning_metadir(self, require_stacking=False):
429
medium = self._client._medium
430
if medium._is_remote_before((1, 13)):
431
return self._vfs_cloning_metadir(require_stacking=require_stacking)
432
verb = 'BzrDir.cloning_metadir'
437
path = self._path_for_remote_call(self._client)
439
response = self._call(verb, path, stacking)
440
except errors.UnknownSmartMethod:
441
medium._remember_remote_is_before((1, 13))
442
return self._vfs_cloning_metadir(require_stacking=require_stacking)
443
except errors.UnknownErrorFromSmartServer, err:
444
if err.error_tuple != ('BranchReference',):
446
# We need to resolve the branch reference to determine the
447
# cloning_metadir. This causes unnecessary RPCs to open the
448
# referenced branch (and bzrdir, etc) but only when the caller
449
# didn't already resolve the branch reference.
450
referenced_branch = self.open_branch()
451
return referenced_branch.bzrdir.cloning_metadir()
452
if len(response) != 3:
453
raise errors.UnexpectedSmartServerResponse(response)
454
control_name, repo_name, branch_info = response
455
if len(branch_info) != 2:
456
raise errors.UnexpectedSmartServerResponse(response)
457
branch_ref, branch_name = branch_info
458
format = controldir.network_format_registry.get(control_name)
460
format.repository_format = _mod_repository.network_format_registry.get(
462
if branch_ref == 'ref':
463
# XXX: we need possible_transports here to avoid reopening the
464
# connection to the referenced location
465
ref_bzrdir = _mod_bzrdir.BzrDir.open(branch_name)
466
branch_format = ref_bzrdir.cloning_metadir().get_branch_format()
467
format.set_branch_format(branch_format)
468
elif branch_ref == 'branch':
470
format.set_branch_format(
471
branch.network_format_registry.get(branch_name))
473
raise errors.UnexpectedSmartServerResponse(response)
115
476
def create_repository(self, shared=False):
117
self._real_bzrdir.create_repository(shared=shared)
118
return self.open_repository()
477
# as per meta1 formats - just delegate to the format object which may
479
result = self._format.repository_format.initialize(self, shared)
480
if not isinstance(result, RemoteRepository):
481
return self.open_repository()
120
485
def destroy_repository(self):
121
486
"""See BzrDir.destroy_repository"""
122
487
self._ensure_real()
123
488
self._real_bzrdir.destroy_repository()
125
def create_branch(self):
127
real_branch = self._real_bzrdir.create_branch()
128
return RemoteBranch(self, self.find_repository(), real_branch)
490
def create_branch(self, name=None, repository=None,
491
append_revisions_only=None):
492
# as per meta1 formats - just delegate to the format object which may
494
real_branch = self._format.get_branch_format().initialize(self,
495
name=name, repository=repository,
496
append_revisions_only=append_revisions_only)
497
if not isinstance(real_branch, RemoteBranch):
498
if not isinstance(repository, RemoteRepository):
499
raise AssertionError(
500
'need a RemoteRepository to use with RemoteBranch, got %r'
502
result = RemoteBranch(self, repository, real_branch, name=name)
505
# BzrDir.clone_on_transport() uses the result of create_branch but does
506
# not return it to its callers; we save approximately 8% of our round
507
# trips by handing the branch we created back to the first caller to
508
# open_branch rather than probing anew. Long term we need a API in
509
# bzrdir that doesn't discard result objects (like result_branch).
511
self._next_open_branch_result = result
130
def destroy_branch(self):
514
def destroy_branch(self, name=None):
131
515
"""See BzrDir.destroy_branch"""
132
516
self._ensure_real()
133
self._real_bzrdir.destroy_branch()
517
self._real_bzrdir.destroy_branch(name=name)
518
self._next_open_branch_result = None
135
def create_workingtree(self, revision_id=None, from_branch=None):
520
def create_workingtree(self, revision_id=None, from_branch=None,
521
accelerator_tree=None, hardlink=False):
136
522
raise errors.NotLocalUrl(self.transport.base)
138
def find_branch_format(self):
524
def find_branch_format(self, name=None):
139
525
"""Find the branch 'format' for this bzrdir.
141
527
This might be a synthetic object for e.g. RemoteBranch and SVN.
143
b = self.open_branch()
529
b = self.open_branch(name=name)
146
def get_branch_reference(self):
532
def get_branch_reference(self, name=None):
147
533
"""See BzrDir.get_branch_reference()."""
535
# XXX JRV20100304: Support opening colocated branches
536
raise errors.NoColocatedBranchSupport(self)
537
response = self._get_branch_reference()
538
if response[0] == 'ref':
543
def _get_branch_reference(self):
148
544
path = self._path_for_remote_call(self._client)
149
response = self._call('BzrDir.open_branch', path)
150
if response[0] == 'ok':
151
if response[1] == '':
152
# branch at this location.
155
# a branch reference, use the existing BranchReference logic.
545
medium = self._client._medium
547
('BzrDir.open_branchV3', (2, 1)),
548
('BzrDir.open_branchV2', (1, 13)),
549
('BzrDir.open_branch', None),
551
for verb, required_version in candidate_calls:
552
if required_version and medium._is_remote_before(required_version):
555
response = self._call(verb, path)
556
except errors.UnknownSmartMethod:
557
if required_version is None:
559
medium._remember_remote_is_before(required_version)
562
if verb == 'BzrDir.open_branch':
563
if response[0] != 'ok':
564
raise errors.UnexpectedSmartServerResponse(response)
565
if response[1] != '':
566
return ('ref', response[1])
568
return ('branch', '')
569
if response[0] not in ('ref', 'branch'):
158
570
raise errors.UnexpectedSmartServerResponse(response)
160
def _get_tree_branch(self):
573
def _get_tree_branch(self, name=None):
161
574
"""See BzrDir._get_tree_branch()."""
162
return None, self.open_branch()
575
return None, self.open_branch(name=name)
164
def open_branch(self, _unsupported=False):
577
def open_branch(self, name=None, unsupported=False,
578
ignore_fallbacks=False):
166
580
raise NotImplementedError('unsupported flag support not implemented yet.')
167
reference_url = self.get_branch_reference()
168
if reference_url is None:
169
# branch at this location.
170
return RemoteBranch(self, self.find_repository())
581
if self._next_open_branch_result is not None:
582
# See create_branch for details.
583
result = self._next_open_branch_result
584
self._next_open_branch_result = None
586
response = self._get_branch_reference()
587
if response[0] == 'ref':
172
588
# a branch reference, use the existing BranchReference logic.
173
589
format = BranchReferenceFormat()
174
return format.open(self, _found=True, location=reference_url)
590
return format.open(self, name=name, _found=True,
591
location=response[1], ignore_fallbacks=ignore_fallbacks)
592
branch_format_name = response[1]
593
if not branch_format_name:
594
branch_format_name = None
595
format = RemoteBranchFormat(network_name=branch_format_name)
596
return RemoteBranch(self, self.find_repository(), format=format,
597
setup_stacking=not ignore_fallbacks, name=name)
599
def _open_repo_v1(self, path):
600
verb = 'BzrDir.find_repository'
601
response = self._call(verb, path)
602
if response[0] != 'ok':
603
raise errors.UnexpectedSmartServerResponse(response)
604
# servers that only support the v1 method don't support external
607
repo = self._real_bzrdir.open_repository()
608
response = response + ('no', repo._format.network_name())
609
return response, repo
611
def _open_repo_v2(self, path):
612
verb = 'BzrDir.find_repositoryV2'
613
response = self._call(verb, path)
614
if response[0] != 'ok':
615
raise errors.UnexpectedSmartServerResponse(response)
617
repo = self._real_bzrdir.open_repository()
618
response = response + (repo._format.network_name(),)
619
return response, repo
621
def _open_repo_v3(self, path):
622
verb = 'BzrDir.find_repositoryV3'
623
medium = self._client._medium
624
if medium._is_remote_before((1, 13)):
625
raise errors.UnknownSmartMethod(verb)
627
response = self._call(verb, path)
628
except errors.UnknownSmartMethod:
629
medium._remember_remote_is_before((1, 13))
631
if response[0] != 'ok':
632
raise errors.UnexpectedSmartServerResponse(response)
633
return response, None
176
635
def open_repository(self):
177
636
path = self._path_for_remote_call(self._client)
178
verb = 'BzrDir.find_repositoryV2'
180
response = self._call(verb, path)
181
except errors.UnknownSmartMethod:
182
verb = 'BzrDir.find_repository'
183
response = self._call(verb, path)
638
for probe in [self._open_repo_v3, self._open_repo_v2,
641
response, real_repo = probe(path)
643
except errors.UnknownSmartMethod:
646
raise errors.UnknownSmartMethod('BzrDir.find_repository{3,2,}')
184
647
if response[0] != 'ok':
185
648
raise errors.UnexpectedSmartServerResponse(response)
186
if verb == 'BzrDir.find_repository':
187
# servers that don't support the V2 method don't support external
189
response = response + ('no', )
190
if not (len(response) == 5):
649
if len(response) != 6:
191
650
raise SmartProtocolError('incorrect response length %s' % (response,))
192
651
if response[1] == '':
193
format = RemoteRepositoryFormat()
194
format.rich_root_data = (response[2] == 'yes')
195
format.supports_tree_reference = (response[3] == 'yes')
196
# No wire format to check this yet.
197
format.supports_external_lookups = (response[4] == 'yes')
652
# repo is at this dir.
653
format = response_tuple_to_repo_format(response[2:])
198
654
# Used to support creating a real format instance when needed.
199
655
format._creating_bzrdir = self
200
return RemoteRepository(self, format)
656
remote_repo = RemoteRepository(self, format)
657
format._creating_repo = remote_repo
658
if real_repo is not None:
659
remote_repo._set_real_repository(real_repo)
202
662
raise errors.NoRepositoryPresent(self)
664
def has_workingtree(self):
665
if self._has_working_tree is None:
667
self._has_working_tree = self._real_bzrdir.has_workingtree()
668
return self._has_working_tree
204
670
def open_workingtree(self, recommend_upgrade=True):
206
if self._real_bzrdir.has_workingtree():
671
if self.has_workingtree():
207
672
raise errors.NotLocalUrl(self.root_transport)
209
674
raise errors.NoWorkingTree(self.root_transport.base)
211
676
def _path_for_remote_call(self, client):
212
677
"""Return the path to be used for this bzrdir in a remote call."""
213
return client.remote_path_from_transport(self.root_transport)
678
return urlutils.split_segment_parameters_raw(
679
client.remote_path_from_transport(self.root_transport))[0]
215
def get_branch_transport(self, branch_format):
681
def get_branch_transport(self, branch_format, name=None):
216
682
self._ensure_real()
217
return self._real_bzrdir.get_branch_transport(branch_format)
683
return self._real_bzrdir.get_branch_transport(branch_format, name=name)
219
685
def get_repository_transport(self, repository_format):
220
686
self._ensure_real()
257
719
the attributes rich_root_data and supports_tree_reference are set
258
720
on a per instance basis, and are not set (and should not be) at
723
:ivar _custom_format: If set, a specific concrete repository format that
724
will be used when initializing a repository with this
725
RemoteRepositoryFormat.
726
:ivar _creating_repo: If set, the repository object that this
727
RemoteRepositoryFormat was created for: it can be called into
728
to obtain data like the network name.
262
731
_matchingbzrdir = RemoteBzrDirFormat()
264
def initialize(self, a_bzrdir, shared=False):
265
if not isinstance(a_bzrdir, RemoteBzrDir):
732
supports_full_versioned_files = True
733
supports_leaving_lock = True
736
_mod_repository.RepositoryFormat.__init__(self)
737
self._custom_format = None
738
self._network_name = None
739
self._creating_bzrdir = None
740
self._revision_graph_can_have_wrong_parents = None
741
self._supports_chks = None
742
self._supports_external_lookups = None
743
self._supports_tree_reference = None
744
self._supports_funky_characters = None
745
self._supports_nesting_repositories = None
746
self._rich_root_data = None
749
return "%s(_network_name=%r)" % (self.__class__.__name__,
753
def fast_deltas(self):
755
return self._custom_format.fast_deltas
758
def rich_root_data(self):
759
if self._rich_root_data is None:
761
self._rich_root_data = self._custom_format.rich_root_data
762
return self._rich_root_data
765
def supports_chks(self):
766
if self._supports_chks is None:
768
self._supports_chks = self._custom_format.supports_chks
769
return self._supports_chks
772
def supports_external_lookups(self):
773
if self._supports_external_lookups is None:
775
self._supports_external_lookups = \
776
self._custom_format.supports_external_lookups
777
return self._supports_external_lookups
780
def supports_funky_characters(self):
781
if self._supports_funky_characters is None:
783
self._supports_funky_characters = \
784
self._custom_format.supports_funky_characters
785
return self._supports_funky_characters
788
def supports_nesting_repositories(self):
789
if self._supports_nesting_repositories is None:
791
self._supports_nesting_repositories = \
792
self._custom_format.supports_nesting_repositories
793
return self._supports_nesting_repositories
796
def supports_tree_reference(self):
797
if self._supports_tree_reference is None:
799
self._supports_tree_reference = \
800
self._custom_format.supports_tree_reference
801
return self._supports_tree_reference
804
def revision_graph_can_have_wrong_parents(self):
805
if self._revision_graph_can_have_wrong_parents is None:
807
self._revision_graph_can_have_wrong_parents = \
808
self._custom_format.revision_graph_can_have_wrong_parents
809
return self._revision_graph_can_have_wrong_parents
811
def _vfs_initialize(self, a_bzrdir, shared):
812
"""Helper for common code in initialize."""
813
if self._custom_format:
814
# Custom format requested
815
result = self._custom_format.initialize(a_bzrdir, shared=shared)
816
elif self._creating_bzrdir is not None:
817
# Use the format that the repository we were created to back
266
819
prior_repo = self._creating_bzrdir.open_repository()
267
820
prior_repo._ensure_real()
268
return prior_repo._real_repository._format.initialize(
821
result = prior_repo._real_repository._format.initialize(
269
822
a_bzrdir, shared=shared)
270
return a_bzrdir.create_repository(shared=shared)
824
# assume that a_bzr is a RemoteBzrDir but the smart server didn't
825
# support remote initialization.
826
# We delegate to a real object at this point (as RemoteBzrDir
827
# delegate to the repository format which would lead to infinite
828
# recursion if we just called a_bzrdir.create_repository.
829
a_bzrdir._ensure_real()
830
result = a_bzrdir._real_bzrdir.create_repository(shared=shared)
831
if not isinstance(result, RemoteRepository):
832
return self.open(a_bzrdir)
836
def initialize(self, a_bzrdir, shared=False):
837
# Being asked to create on a non RemoteBzrDir:
838
if not isinstance(a_bzrdir, RemoteBzrDir):
839
return self._vfs_initialize(a_bzrdir, shared)
840
medium = a_bzrdir._client._medium
841
if medium._is_remote_before((1, 13)):
842
return self._vfs_initialize(a_bzrdir, shared)
843
# Creating on a remote bzr dir.
844
# 1) get the network name to use.
845
if self._custom_format:
846
network_name = self._custom_format.network_name()
847
elif self._network_name:
848
network_name = self._network_name
850
# Select the current bzrlib default and ask for that.
851
reference_bzrdir_format = _mod_bzrdir.format_registry.get('default')()
852
reference_format = reference_bzrdir_format.repository_format
853
network_name = reference_format.network_name()
854
# 2) try direct creation via RPC
855
path = a_bzrdir._path_for_remote_call(a_bzrdir._client)
856
verb = 'BzrDir.create_repository'
862
response = a_bzrdir._call(verb, path, network_name, shared_str)
863
except errors.UnknownSmartMethod:
864
# Fallback - use vfs methods
865
medium._remember_remote_is_before((1, 13))
866
return self._vfs_initialize(a_bzrdir, shared)
868
# Turn the response into a RemoteRepository object.
869
format = response_tuple_to_repo_format(response[1:])
870
# Used to support creating a real format instance when needed.
871
format._creating_bzrdir = a_bzrdir
872
remote_repo = RemoteRepository(a_bzrdir, format)
873
format._creating_repo = remote_repo
272
876
def open(self, a_bzrdir):
273
877
if not isinstance(a_bzrdir, RemoteBzrDir):
274
878
raise AssertionError('%r is not a RemoteBzrDir' % (a_bzrdir,))
275
879
return a_bzrdir.open_repository()
881
def _ensure_real(self):
882
if self._custom_format is None:
883
self._custom_format = _mod_repository.network_format_registry.get(
887
def _fetch_order(self):
889
return self._custom_format._fetch_order
892
def _fetch_uses_deltas(self):
894
return self._custom_format._fetch_uses_deltas
897
def _fetch_reconcile(self):
899
return self._custom_format._fetch_reconcile
277
901
def get_format_description(self):
278
return 'bzr remote repository'
903
return 'Remote: ' + self._custom_format.get_format_description()
280
905
def __eq__(self, other):
281
return self.__class__ == other.__class__
283
def check_conversion_target(self, target_format):
284
if self.rich_root_data and not target_format.rich_root_data:
285
raise errors.BadConversionTarget(
286
'Does not support rich root data.', target_format)
287
if (self.supports_tree_reference and
288
not getattr(target_format, 'supports_tree_reference', False)):
289
raise errors.BadConversionTarget(
290
'Does not support nested trees', target_format)
293
class RemoteRepository(_RpcHelper):
906
return self.__class__ is other.__class__
908
def network_name(self):
909
if self._network_name:
910
return self._network_name
911
self._creating_repo._ensure_real()
912
return self._creating_repo._real_repository._format.network_name()
915
def pack_compresses(self):
917
return self._custom_format.pack_compresses
920
def _serializer(self):
922
return self._custom_format._serializer
925
class RemoteRepository(_RpcHelper, lock._RelockDebugMixin,
926
controldir.ControlComponent):
294
927
"""Repository accessed over rpc.
296
929
For the moment most operations are performed using local transport-backed
367
1023
self._ensure_real()
368
1024
return self._real_repository.commit_write_group()
1026
def resume_write_group(self, tokens):
1028
return self._real_repository.resume_write_group(tokens)
1030
def suspend_write_group(self):
1032
return self._real_repository.suspend_write_group()
1034
def get_missing_parent_inventories(self, check_for_missing_texts=True):
1036
return self._real_repository.get_missing_parent_inventories(
1037
check_for_missing_texts=check_for_missing_texts)
1039
def _get_rev_id_for_revno_vfs(self, revno, known_pair):
1041
return self._real_repository.get_rev_id_for_revno(
1044
def get_rev_id_for_revno(self, revno, known_pair):
1045
"""See Repository.get_rev_id_for_revno."""
1046
path = self.bzrdir._path_for_remote_call(self._client)
1048
if self._client._medium._is_remote_before((1, 17)):
1049
return self._get_rev_id_for_revno_vfs(revno, known_pair)
1050
response = self._call(
1051
'Repository.get_rev_id_for_revno', path, revno, known_pair)
1052
except errors.UnknownSmartMethod:
1053
self._client._medium._remember_remote_is_before((1, 17))
1054
return self._get_rev_id_for_revno_vfs(revno, known_pair)
1055
if response[0] == 'ok':
1056
return True, response[1]
1057
elif response[0] == 'history-incomplete':
1058
known_pair = response[1:3]
1059
for fallback in self._fallback_repositories:
1060
found, result = fallback.get_rev_id_for_revno(revno, known_pair)
1065
# Not found in any fallbacks
1066
return False, known_pair
1068
raise errors.UnexpectedSmartServerResponse(response)
370
1070
def _ensure_real(self):
371
1071
"""Ensure that there is a _real_repository set.
373
1073
Used before calls to self._real_repository.
1075
Note that _ensure_real causes many roundtrips to the server which are
1076
not desirable, and prevents the use of smart one-roundtrip RPC's to
1077
perform complex operations (such as accessing parent data, streaming
1078
revisions etc). Adding calls to _ensure_real should only be done when
1079
bringing up new functionality, adding fallbacks for smart methods that
1080
require a fallback path, and never to replace an existing smart method
1081
invocation. If in doubt chat to the bzr network team.
375
1083
if self._real_repository is None:
1084
if 'hpssvfs' in debug.debug_flags:
1086
warning('VFS Repository access triggered\n%s',
1087
''.join(traceback.format_stack()))
1088
self._unstacked_provider.missing_keys.clear()
376
1089
self.bzrdir._ensure_real()
377
1090
self._set_real_repository(
378
1091
self.bzrdir._real_bzrdir.open_repository())
432
1137
for line in lines:
433
1138
d = tuple(line.split())
434
1139
revision_graph[d[0]] = d[1:]
436
1141
return revision_graph
1143
def _get_sink(self):
1144
"""See Repository._get_sink()."""
1145
return RemoteStreamSink(self)
1147
def _get_source(self, to_format):
1148
"""Return a source for streaming from this repository."""
1149
return RemoteStreamSource(self, to_format)
1152
def get_file_graph(self):
1153
return graph.Graph(self.texts)
438
1156
def has_revision(self, revision_id):
439
"""See Repository.has_revision()."""
440
if revision_id == NULL_REVISION:
441
# The null revision is always present.
443
path = self.bzrdir._path_for_remote_call(self._client)
444
response = self._call('Repository.has_revision', path, revision_id)
445
if response[0] not in ('yes', 'no'):
446
raise errors.UnexpectedSmartServerResponse(response)
447
if response[0] == 'yes':
449
for fallback_repo in self._fallback_repositories:
450
if fallback_repo.has_revision(revision_id):
1157
"""True if this repository has a copy of the revision."""
1158
# Copy of bzrlib.repository.Repository.has_revision
1159
return revision_id in self.has_revisions((revision_id,))
454
1162
def has_revisions(self, revision_ids):
455
"""See Repository.has_revisions()."""
456
# FIXME: This does many roundtrips, particularly when there are
457
# fallback repositories. -- mbp 20080905
459
for revision_id in revision_ids:
460
if self.has_revision(revision_id):
461
result.add(revision_id)
1163
"""Probe to find out the presence of multiple revisions.
1165
:param revision_ids: An iterable of revision_ids.
1166
:return: A set of the revision_ids that were present.
1168
# Copy of bzrlib.repository.Repository.has_revisions
1169
parent_map = self.get_parent_map(revision_ids)
1170
result = set(parent_map)
1171
if _mod_revision.NULL_REVISION in revision_ids:
1172
result.add(_mod_revision.NULL_REVISION)
1175
def _has_same_fallbacks(self, other_repo):
1176
"""Returns true if the repositories have the same fallbacks."""
1177
# XXX: copied from Repository; it should be unified into a base class
1178
# <https://bugs.launchpad.net/bzr/+bug/401622>
1179
my_fb = self._fallback_repositories
1180
other_fb = other_repo._fallback_repositories
1181
if len(my_fb) != len(other_fb):
1183
for f, g in zip(my_fb, other_fb):
1184
if not f.has_same_location(g):
464
1188
def has_same_location(self, other):
465
return (self.__class__ == other.__class__ and
1189
# TODO: Move to RepositoryBase and unify with the regular Repository
1190
# one; unfortunately the tests rely on slightly different behaviour at
1191
# present -- mbp 20090710
1192
return (self.__class__ is other.__class__ and
466
1193
self.bzrdir.transport.base == other.bzrdir.transport.base)
468
1195
def get_graph(self, other_repository=None):
715
1500
def get_commit_builder(self, branch, parents, config, timestamp=None,
716
1501
timezone=None, committer=None, revprops=None,
1502
revision_id=None, lossy=False):
718
1503
# FIXME: It ought to be possible to call this without immediately
719
1504
# triggering _ensure_real. For now it's the easiest thing to do.
720
1505
self._ensure_real()
721
1506
real_repo = self._real_repository
722
1507
builder = real_repo.get_commit_builder(branch, parents,
723
1508
config, timestamp=timestamp, timezone=timezone,
724
committer=committer, revprops=revprops, revision_id=revision_id)
1509
committer=committer, revprops=revprops,
1510
revision_id=revision_id, lossy=lossy)
727
1513
def add_fallback_repository(self, repository):
728
1514
"""Add a repository to use for looking up data not held locally.
730
1516
:param repository: A repository.
732
# XXX: At the moment the RemoteRepository will allow fallbacks
733
# unconditionally - however, a _real_repository will usually exist,
734
# and may raise an error if it's not accommodated by the underlying
735
# format. Eventually we should check when opening the repository
736
# whether it's willing to allow them or not.
1518
if not self._format.supports_external_lookups:
1519
raise errors.UnstackableRepositoryFormat(
1520
self._format.network_name(), self.base)
738
1521
# We need to accumulate additional repositories here, to pass them in
739
1522
# on various RPC's.
1524
# Make the check before we lock: this raises an exception.
1525
self._check_fallback_repository(repository)
1526
if self.is_locked():
1527
# We will call fallback.unlock() when we transition to the unlocked
1528
# state, so always add a lock here. If a caller passes us a locked
1529
# repository, they are responsible for unlocking it later.
1530
repository.lock_read()
740
1531
self._fallback_repositories.append(repository)
741
# They are also seen by the fallback repository. If it doesn't exist
742
# yet they'll be added then. This implicitly copies them.
1532
# If self._real_repository was parameterised already (e.g. because a
1533
# _real_branch had its get_stacked_on_url method called), then the
1534
# repository to be added may already be in the _real_repositories list.
1535
if self._real_repository is not None:
1536
fallback_locations = [repo.user_url for repo in
1537
self._real_repository._fallback_repositories]
1538
if repository.user_url not in fallback_locations:
1539
self._real_repository.add_fallback_repository(repository)
1541
def _check_fallback_repository(self, repository):
1542
"""Check that this repository can fallback to repository safely.
1544
Raise an error if not.
1546
:param repository: A repository to fallback to.
1548
return _mod_repository.InterRepository._assert_same_model(
745
1551
def add_inventory(self, revid, inv, parents):
746
1552
self._ensure_real()
747
1553
return self._real_repository.add_inventory(revid, inv, parents)
749
1555
def add_inventory_by_delta(self, basis_revision_id, delta, new_revision_id,
1556
parents, basis_inv=None, propagate_caches=False):
751
1557
self._ensure_real()
752
1558
return self._real_repository.add_inventory_by_delta(basis_revision_id,
753
delta, new_revision_id, parents)
1559
delta, new_revision_id, parents, basis_inv=basis_inv,
1560
propagate_caches=propagate_caches)
755
1562
def add_revision(self, rev_id, rev, inv=None, config=None):
756
1563
self._ensure_real()
801
1622
@needs_read_lock
802
def search_missing_revision_ids(self, other, revision_id=None, find_ghosts=True):
1623
def search_missing_revision_ids(self, other,
1624
revision_id=symbol_versioning.DEPRECATED_PARAMETER,
1625
find_ghosts=True, revision_ids=None, if_present_ids=None,
803
1627
"""Return the revision ids that other has that this does not.
805
1629
These are returned in topological order.
807
1631
revision_id: only return revision ids included by revision_id.
809
return repository.InterRepository.get(
810
other, self).search_missing_revision_ids(revision_id, find_ghosts)
1633
if symbol_versioning.deprecated_passed(revision_id):
1634
symbol_versioning.warn(
1635
'search_missing_revision_ids(revision_id=...) was '
1636
'deprecated in 2.4. Use revision_ids=[...] instead.',
1637
DeprecationWarning, stacklevel=2)
1638
if revision_ids is not None:
1639
raise AssertionError(
1640
'revision_ids is mutually exclusive with revision_id')
1641
if revision_id is not None:
1642
revision_ids = [revision_id]
1643
inter_repo = _mod_repository.InterRepository.get(other, self)
1644
return inter_repo.search_missing_revision_ids(
1645
find_ghosts=find_ghosts, revision_ids=revision_ids,
1646
if_present_ids=if_present_ids, limit=limit)
812
def fetch(self, source, revision_id=None, pb=None, find_ghosts=False):
813
# Not delegated to _real_repository so that InterRepository.get has a
814
# chance to find an InterRepository specialised for RemoteRepository.
815
if self.has_same_location(source):
1648
def fetch(self, source, revision_id=None, find_ghosts=False,
1650
# No base implementation to use as RemoteRepository is not a subclass
1651
# of Repository; so this is a copy of Repository.fetch().
1652
if fetch_spec is not None and revision_id is not None:
1653
raise AssertionError(
1654
"fetch_spec and revision_id are mutually exclusive.")
1655
if self.is_in_write_group():
1656
raise errors.InternalBzrError(
1657
"May not fetch while in a write group.")
1658
# fast path same-url fetch operations
1659
if (self.has_same_location(source)
1660
and fetch_spec is None
1661
and self._has_same_fallbacks(source)):
816
1662
# check that last_revision is in 'from' and then return a
818
1664
if (revision_id is not None and
819
not revision.is_null(revision_id)):
1665
not _mod_revision.is_null(revision_id)):
820
1666
self.get_revision(revision_id)
822
inter = repository.InterRepository.get(source, self)
824
return inter.fetch(revision_id=revision_id, pb=pb, find_ghosts=find_ghosts)
825
except NotImplementedError:
826
raise errors.IncompatibleRepositories(source, self)
1668
# if there is no specific appropriate InterRepository, this will get
1669
# the InterRepository base class, which raises an
1670
# IncompatibleRepositories when asked to fetch.
1671
inter = _mod_repository.InterRepository.get(source, self)
1672
return inter.fetch(revision_id=revision_id,
1673
find_ghosts=find_ghosts, fetch_spec=fetch_spec)
828
1675
def create_bundle(self, target, base, fileobj, format=None):
829
1676
self._ensure_real()
830
1677
self._real_repository.create_bundle(target, base, fileobj, format)
832
1679
@needs_read_lock
1680
@symbol_versioning.deprecated_method(
1681
symbol_versioning.deprecated_in((2, 4, 0)))
833
1682
def get_ancestry(self, revision_id, topo_sorted=True):
834
1683
self._ensure_real()
835
1684
return self._real_repository.get_ancestry(revision_id, topo_sorted)
1210
2051
self._ensure_real()
1211
2052
self._real_repository._pack_collection.autopack()
1213
if self._real_repository is not None:
1214
# Reset the real repository's cache of pack names.
1215
# XXX: At some point we may be able to skip this and just rely on
1216
# the automatic retry logic to do the right thing, but for now we
1217
# err on the side of being correct rather than being optimal.
1218
self._real_repository._pack_collection.reload_pack_names()
1219
2055
if response[0] != 'ok':
1220
2056
raise errors.UnexpectedSmartServerResponse(response)
2059
class RemoteStreamSink(vf_repository.StreamSink):
2061
def _insert_real(self, stream, src_format, resume_tokens):
2062
self.target_repo._ensure_real()
2063
sink = self.target_repo._real_repository._get_sink()
2064
result = sink.insert_stream(stream, src_format, resume_tokens)
2066
self.target_repo.autopack()
2069
def insert_stream(self, stream, src_format, resume_tokens):
2070
target = self.target_repo
2071
target._unstacked_provider.missing_keys.clear()
2072
candidate_calls = [('Repository.insert_stream_1.19', (1, 19))]
2073
if target._lock_token:
2074
candidate_calls.append(('Repository.insert_stream_locked', (1, 14)))
2075
lock_args = (target._lock_token or '',)
2077
candidate_calls.append(('Repository.insert_stream', (1, 13)))
2079
client = target._client
2080
medium = client._medium
2081
path = target.bzrdir._path_for_remote_call(client)
2082
# Probe for the verb to use with an empty stream before sending the
2083
# real stream to it. We do this both to avoid the risk of sending a
2084
# large request that is then rejected, and because we don't want to
2085
# implement a way to buffer, rewind, or restart the stream.
2087
for verb, required_version in candidate_calls:
2088
if medium._is_remote_before(required_version):
2091
# We've already done the probing (and set _is_remote_before) on
2092
# a previous insert.
2095
byte_stream = smart_repo._stream_to_byte_stream([], src_format)
2097
response = client.call_with_body_stream(
2098
(verb, path, '') + lock_args, byte_stream)
2099
except errors.UnknownSmartMethod:
2100
medium._remember_remote_is_before(required_version)
2106
return self._insert_real(stream, src_format, resume_tokens)
2107
self._last_inv_record = None
2108
self._last_substream = None
2109
if required_version < (1, 19):
2110
# Remote side doesn't support inventory deltas. Wrap the stream to
2111
# make sure we don't send any. If the stream contains inventory
2112
# deltas we'll interrupt the smart insert_stream request and
2114
stream = self._stop_stream_if_inventory_delta(stream)
2115
byte_stream = smart_repo._stream_to_byte_stream(
2117
resume_tokens = ' '.join(resume_tokens)
2118
response = client.call_with_body_stream(
2119
(verb, path, resume_tokens) + lock_args, byte_stream)
2120
if response[0][0] not in ('ok', 'missing-basis'):
2121
raise errors.UnexpectedSmartServerResponse(response)
2122
if self._last_substream is not None:
2123
# The stream included an inventory-delta record, but the remote
2124
# side isn't new enough to support them. So we need to send the
2125
# rest of the stream via VFS.
2126
self.target_repo.refresh_data()
2127
return self._resume_stream_with_vfs(response, src_format)
2128
if response[0][0] == 'missing-basis':
2129
tokens, missing_keys = bencode.bdecode_as_tuple(response[0][1])
2130
resume_tokens = tokens
2131
return resume_tokens, set(missing_keys)
2133
self.target_repo.refresh_data()
2136
def _resume_stream_with_vfs(self, response, src_format):
2137
"""Resume sending a stream via VFS, first resending the record and
2138
substream that couldn't be sent via an insert_stream verb.
2140
if response[0][0] == 'missing-basis':
2141
tokens, missing_keys = bencode.bdecode_as_tuple(response[0][1])
2142
# Ignore missing_keys, we haven't finished inserting yet
2145
def resume_substream():
2146
# Yield the substream that was interrupted.
2147
for record in self._last_substream:
2149
self._last_substream = None
2150
def resume_stream():
2151
# Finish sending the interrupted substream
2152
yield ('inventory-deltas', resume_substream())
2153
# Then simply continue sending the rest of the stream.
2154
for substream_kind, substream in self._last_stream:
2155
yield substream_kind, substream
2156
return self._insert_real(resume_stream(), src_format, tokens)
2158
def _stop_stream_if_inventory_delta(self, stream):
2159
"""Normally this just lets the original stream pass-through unchanged.
2161
However if any 'inventory-deltas' substream occurs it will stop
2162
streaming, and store the interrupted substream and stream in
2163
self._last_substream and self._last_stream so that the stream can be
2164
resumed by _resume_stream_with_vfs.
2167
stream_iter = iter(stream)
2168
for substream_kind, substream in stream_iter:
2169
if substream_kind == 'inventory-deltas':
2170
self._last_substream = substream
2171
self._last_stream = stream_iter
2174
yield substream_kind, substream
2177
class RemoteStreamSource(vf_repository.StreamSource):
2178
"""Stream data from a remote server."""
2180
def get_stream(self, search):
2181
if (self.from_repository._fallback_repositories and
2182
self.to_format._fetch_order == 'topological'):
2183
return self._real_stream(self.from_repository, search)
2186
repos = [self.from_repository]
2192
repos.extend(repo._fallback_repositories)
2193
sources.append(repo)
2194
return self.missing_parents_chain(search, sources)
2196
def get_stream_for_missing_keys(self, missing_keys):
2197
self.from_repository._ensure_real()
2198
real_repo = self.from_repository._real_repository
2199
real_source = real_repo._get_source(self.to_format)
2200
return real_source.get_stream_for_missing_keys(missing_keys)
2202
def _real_stream(self, repo, search):
2203
"""Get a stream for search from repo.
2205
This never called RemoteStreamSource.get_stream, and is a heler
2206
for RemoteStreamSource._get_stream to allow getting a stream
2207
reliably whether fallback back because of old servers or trying
2208
to stream from a non-RemoteRepository (which the stacked support
2211
source = repo._get_source(self.to_format)
2212
if isinstance(source, RemoteStreamSource):
2214
source = repo._real_repository._get_source(self.to_format)
2215
return source.get_stream(search)
2217
def _get_stream(self, repo, search):
2218
"""Core worker to get a stream from repo for search.
2220
This is used by both get_stream and the stacking support logic. It
2221
deliberately gets a stream for repo which does not need to be
2222
self.from_repository. In the event that repo is not Remote, or
2223
cannot do a smart stream, a fallback is made to the generic
2224
repository._get_stream() interface, via self._real_stream.
2226
In the event of stacking, streams from _get_stream will not
2227
contain all the data for search - this is normal (see get_stream).
2229
:param repo: A repository.
2230
:param search: A search.
2232
# Fallbacks may be non-smart
2233
if not isinstance(repo, RemoteRepository):
2234
return self._real_stream(repo, search)
2235
client = repo._client
2236
medium = client._medium
2237
path = repo.bzrdir._path_for_remote_call(client)
2238
search_bytes = repo._serialise_search_result(search)
2239
args = (path, self.to_format.network_name())
2241
('Repository.get_stream_1.19', (1, 19)),
2242
('Repository.get_stream', (1, 13))]
2245
for verb, version in candidate_verbs:
2246
if medium._is_remote_before(version):
2249
response = repo._call_with_body_bytes_expecting_body(
2250
verb, args, search_bytes)
2251
except errors.UnknownSmartMethod:
2252
medium._remember_remote_is_before(version)
2253
except errors.UnknownErrorFromSmartServer, e:
2254
if isinstance(search, graph.EverythingResult):
2255
error_verb = e.error_from_smart_server.error_verb
2256
if error_verb == 'BadSearch':
2257
# Pre-2.4 servers don't support this sort of search.
2258
# XXX: perhaps falling back to VFS on BadSearch is a
2259
# good idea in general? It might provide a little bit
2260
# of protection against client-side bugs.
2261
medium._remember_remote_is_before((2, 4))
2265
response_tuple, response_handler = response
2269
return self._real_stream(repo, search)
2270
if response_tuple[0] != 'ok':
2271
raise errors.UnexpectedSmartServerResponse(response_tuple)
2272
byte_stream = response_handler.read_streamed_body()
2273
src_format, stream = smart_repo._byte_stream_to_stream(byte_stream,
2274
self._record_counter)
2275
if src_format.network_name() != repo._format.network_name():
2276
raise AssertionError(
2277
"Mismatched RemoteRepository and stream src %r, %r" % (
2278
src_format.network_name(), repo._format.network_name()))
2281
def missing_parents_chain(self, search, sources):
2282
"""Chain multiple streams together to handle stacking.
2284
:param search: The overall search to satisfy with streams.
2285
:param sources: A list of Repository objects to query.
2287
self.from_serialiser = self.from_repository._format._serializer
2288
self.seen_revs = set()
2289
self.referenced_revs = set()
2290
# If there are heads in the search, or the key count is > 0, we are not
2292
while not search.is_empty() and len(sources) > 1:
2293
source = sources.pop(0)
2294
stream = self._get_stream(source, search)
2295
for kind, substream in stream:
2296
if kind != 'revisions':
2297
yield kind, substream
2299
yield kind, self.missing_parents_rev_handler(substream)
2300
search = search.refine(self.seen_revs, self.referenced_revs)
2301
self.seen_revs = set()
2302
self.referenced_revs = set()
2303
if not search.is_empty():
2304
for kind, stream in self._get_stream(sources[0], search):
2307
def missing_parents_rev_handler(self, substream):
2308
for content in substream:
2309
revision_bytes = content.get_bytes_as('fulltext')
2310
revision = self.from_serialiser.read_revision_from_string(
2312
self.seen_revs.add(content.key[-1])
2313
self.referenced_revs.update(revision.parent_ids)
1223
2317
class RemoteBranchLockableFiles(LockableFiles):
1224
2318
"""A 'LockableFiles' implementation that talks to a smart server.
1226
2320
This is not a public interface class.
1243
2337
class RemoteBranchFormat(branch.BranchFormat):
2339
def __init__(self, network_name=None):
1246
2340
super(RemoteBranchFormat, self).__init__()
1247
2341
self._matchingbzrdir = RemoteBzrDirFormat()
1248
2342
self._matchingbzrdir.set_branch_format(self)
2343
self._custom_format = None
2344
self._network_name = network_name
1250
2346
def __eq__(self, other):
1251
return (isinstance(other, RemoteBranchFormat) and
2347
return (isinstance(other, RemoteBranchFormat) and
1252
2348
self.__dict__ == other.__dict__)
2350
def _ensure_real(self):
2351
if self._custom_format is None:
2352
self._custom_format = branch.network_format_registry.get(
1254
2355
def get_format_description(self):
1255
return 'Remote BZR Branch'
1257
def get_format_string(self):
1258
return 'Remote BZR Branch'
1260
def open(self, a_bzrdir):
1261
return a_bzrdir.open_branch()
1263
def initialize(self, a_bzrdir):
1264
return a_bzrdir.create_branch()
2357
return 'Remote: ' + self._custom_format.get_format_description()
2359
def network_name(self):
2360
return self._network_name
2362
def open(self, a_bzrdir, name=None, ignore_fallbacks=False):
2363
return a_bzrdir.open_branch(name=name,
2364
ignore_fallbacks=ignore_fallbacks)
2366
def _vfs_initialize(self, a_bzrdir, name, append_revisions_only):
2367
# Initialisation when using a local bzrdir object, or a non-vfs init
2368
# method is not available on the server.
2369
# self._custom_format is always set - the start of initialize ensures
2371
if isinstance(a_bzrdir, RemoteBzrDir):
2372
a_bzrdir._ensure_real()
2373
result = self._custom_format.initialize(a_bzrdir._real_bzrdir,
2374
name, append_revisions_only=append_revisions_only)
2376
# We assume the bzrdir is parameterised; it may not be.
2377
result = self._custom_format.initialize(a_bzrdir, name,
2378
append_revisions_only=append_revisions_only)
2379
if (isinstance(a_bzrdir, RemoteBzrDir) and
2380
not isinstance(result, RemoteBranch)):
2381
result = RemoteBranch(a_bzrdir, a_bzrdir.find_repository(), result,
2385
def initialize(self, a_bzrdir, name=None, repository=None,
2386
append_revisions_only=None):
2387
# 1) get the network name to use.
2388
if self._custom_format:
2389
network_name = self._custom_format.network_name()
2391
# Select the current bzrlib default and ask for that.
2392
reference_bzrdir_format = _mod_bzrdir.format_registry.get('default')()
2393
reference_format = reference_bzrdir_format.get_branch_format()
2394
self._custom_format = reference_format
2395
network_name = reference_format.network_name()
2396
# Being asked to create on a non RemoteBzrDir:
2397
if not isinstance(a_bzrdir, RemoteBzrDir):
2398
return self._vfs_initialize(a_bzrdir, name=name,
2399
append_revisions_only=append_revisions_only)
2400
medium = a_bzrdir._client._medium
2401
if medium._is_remote_before((1, 13)):
2402
return self._vfs_initialize(a_bzrdir, name=name,
2403
append_revisions_only=append_revisions_only)
2404
# Creating on a remote bzr dir.
2405
# 2) try direct creation via RPC
2406
path = a_bzrdir._path_for_remote_call(a_bzrdir._client)
2407
if name is not None:
2408
# XXX JRV20100304: Support creating colocated branches
2409
raise errors.NoColocatedBranchSupport(self)
2410
verb = 'BzrDir.create_branch'
2412
response = a_bzrdir._call(verb, path, network_name)
2413
except errors.UnknownSmartMethod:
2414
# Fallback - use vfs methods
2415
medium._remember_remote_is_before((1, 13))
2416
return self._vfs_initialize(a_bzrdir, name=name,
2417
append_revisions_only=append_revisions_only)
2418
if response[0] != 'ok':
2419
raise errors.UnexpectedSmartServerResponse(response)
2420
# Turn the response into a RemoteRepository object.
2421
format = RemoteBranchFormat(network_name=response[1])
2422
repo_format = response_tuple_to_repo_format(response[3:])
2423
repo_path = response[2]
2424
if repository is not None:
2425
remote_repo_url = urlutils.join(a_bzrdir.user_url, repo_path)
2426
url_diff = urlutils.relative_url(repository.user_url,
2429
raise AssertionError(
2430
'repository.user_url %r does not match URL from server '
2431
'response (%r + %r)'
2432
% (repository.user_url, a_bzrdir.user_url, repo_path))
2433
remote_repo = repository
2436
repo_bzrdir = a_bzrdir
2438
repo_bzrdir = RemoteBzrDir(
2439
a_bzrdir.root_transport.clone(repo_path), a_bzrdir._format,
2441
remote_repo = RemoteRepository(repo_bzrdir, repo_format)
2442
remote_branch = RemoteBranch(a_bzrdir, remote_repo,
2443
format=format, setup_stacking=False, name=name)
2444
if append_revisions_only:
2445
remote_branch.set_append_revisions_only(append_revisions_only)
2446
# XXX: We know this is a new branch, so it must have revno 0, revid
2447
# NULL_REVISION. Creating the branch locked would make this be unable
2448
# to be wrong; here its simply very unlikely to be wrong. RBC 20090225
2449
remote_branch._last_revision_info_cache = 0, NULL_REVISION
2450
return remote_branch
2452
def make_tags(self, branch):
2454
return self._custom_format.make_tags(branch)
1266
2456
def supports_tags(self):
1267
2457
# Remote branches might support tags, but we won't know until we
1268
2458
# access the real remote branch.
1272
class RemoteBranch(branch.Branch, _RpcHelper):
2460
return self._custom_format.supports_tags()
2462
def supports_stacking(self):
2464
return self._custom_format.supports_stacking()
2466
def supports_set_append_revisions_only(self):
2468
return self._custom_format.supports_set_append_revisions_only()
2470
def _use_default_local_heads_to_fetch(self):
2471
# If the branch format is a metadir format *and* its heads_to_fetch
2472
# implementation is not overridden vs the base class, we can use the
2473
# base class logic rather than use the heads_to_fetch RPC. This is
2474
# usually cheaper in terms of net round trips, as the last-revision and
2475
# tags info fetched is cached and would be fetched anyway.
2477
if isinstance(self._custom_format, branch.BranchFormatMetadir):
2478
branch_class = self._custom_format._branch_class()
2479
heads_to_fetch_impl = branch_class.heads_to_fetch.im_func
2480
if heads_to_fetch_impl is branch.Branch.heads_to_fetch.im_func:
2484
class RemoteBranch(branch.Branch, _RpcHelper, lock._RelockDebugMixin):
1273
2485
"""Branch stored on a server accessed by HPSS RPC.
1275
2487
At the moment most operations are mapped down to simple file operations.
1278
2490
def __init__(self, remote_bzrdir, remote_repository, real_branch=None,
2491
_client=None, format=None, setup_stacking=True, name=None):
1280
2492
"""Create a RemoteBranch instance.
1282
2494
:param real_branch: An optional local implementation of the branch
1283
2495
format, usually accessing the data via the VFS.
1284
2496
:param _client: Private parameter for testing.
2497
:param format: A RemoteBranchFormat object, None to create one
2498
automatically. If supplied it should have a network_name already
2500
:param setup_stacking: If True make an RPC call to determine the
2501
stacked (or not) status of the branch. If False assume the branch
2503
:param name: Colocated branch name
1286
2505
# We intentionally don't call the parent class's __init__, because it
1287
2506
# will try to assign to self.tags, which is a property in this subclass.
1288
2507
# And the parent's __init__ doesn't do much anyway.
1289
self._revision_id_to_revno_cache = None
1290
self._partial_revision_id_to_revno_cache = {}
1291
self._revision_history_cache = None
1292
self._last_revision_info_cache = None
1293
self._merge_sorted_revisions_cache = None
1294
2508
self.bzrdir = remote_bzrdir
1295
2509
if _client is not None:
1296
2510
self._client = _client
1443
2685
raise errors.UnexpectedSmartServerResponse(response)
1444
2686
return response[1]
2688
def set_stacked_on_url(self, url):
2689
branch.Branch.set_stacked_on_url(self, url)
2691
self._is_stacked = False
2693
self._is_stacked = True
2695
def _vfs_get_tags_bytes(self):
2697
return self._real_branch._get_tags_bytes()
2700
def _get_tags_bytes(self):
2701
if self._tags_bytes is None:
2702
self._tags_bytes = self._get_tags_bytes_via_hpss()
2703
return self._tags_bytes
2705
def _get_tags_bytes_via_hpss(self):
2706
medium = self._client._medium
2707
if medium._is_remote_before((1, 13)):
2708
return self._vfs_get_tags_bytes()
2710
response = self._call('Branch.get_tags_bytes', self._remote_path())
2711
except errors.UnknownSmartMethod:
2712
medium._remember_remote_is_before((1, 13))
2713
return self._vfs_get_tags_bytes()
2716
def _vfs_set_tags_bytes(self, bytes):
2718
return self._real_branch._set_tags_bytes(bytes)
2720
def _set_tags_bytes(self, bytes):
2721
if self.is_locked():
2722
self._tags_bytes = bytes
2723
medium = self._client._medium
2724
if medium._is_remote_before((1, 18)):
2725
self._vfs_set_tags_bytes(bytes)
2729
self._remote_path(), self._lock_token, self._repo_lock_token)
2730
response = self._call_with_body_bytes(
2731
'Branch.set_tags_bytes', args, bytes)
2732
except errors.UnknownSmartMethod:
2733
medium._remember_remote_is_before((1, 18))
2734
self._vfs_set_tags_bytes(bytes)
1446
2736
def lock_read(self):
2737
"""Lock the branch for read operations.
2739
:return: A bzrlib.lock.LogicalLockResult.
1447
2741
self.repository.lock_read()
1448
2742
if not self._lock_mode:
2743
self._note_lock('r')
1449
2744
self._lock_mode = 'r'
1450
2745
self._lock_count = 1
1451
2746
if self._real_branch is not None:
1452
2747
self._real_branch.lock_read()
1454
2749
self._lock_count += 1
2750
return lock.LogicalLockResult(self.unlock)
1456
2752
def _remote_lock_write(self, token):
1457
2753
if token is None:
1458
2754
branch_token = repo_token = ''
1460
2756
branch_token = token
1461
repo_token = self.repository.lock_write()
2757
repo_token = self.repository.lock_write().repository_token
1462
2758
self.repository.unlock()
1463
2759
err_context = {'token': token}
1464
response = self._call(
1465
'Branch.lock_write', self._remote_path(), branch_token,
1466
repo_token or '', **err_context)
2761
response = self._call(
2762
'Branch.lock_write', self._remote_path(), branch_token,
2763
repo_token or '', **err_context)
2764
except errors.LockContention, e:
2765
# The LockContention from the server doesn't have any
2766
# information about the lock_url. We re-raise LockContention
2767
# with valid lock_url.
2768
raise errors.LockContention('(remote lock)',
2769
self.repository.base.split('.bzr/')[0])
1467
2770
if response[0] != 'ok':
1468
2771
raise errors.UnexpectedSmartServerResponse(response)
1469
2772
ok, branch_token, repo_token = response
1470
2773
return branch_token, repo_token
1472
2775
def lock_write(self, token=None):
1473
2776
if not self._lock_mode:
2777
self._note_lock('w')
1474
2778
# Lock the branch and repo in one remote call.
1475
2779
remote_tokens = self._remote_lock_write(token)
1476
2780
self._lock_token, self._repo_lock_token = remote_tokens
1613
2965
rev_id = rev_history[-1]
1614
2966
self._set_last_revision(rev_id)
2967
for hook in branch.Branch.hooks['set_rh']:
2968
hook(self, rev_history)
1615
2969
self._cache_revision_history(rev_history)
1617
def get_parent(self):
1619
return self._real_branch.get_parent()
1621
def set_parent(self, url):
1623
return self._real_branch.set_parent(url)
1625
def set_stacked_on_url(self, stacked_location):
1626
"""Set the URL this branch is stacked against.
1628
:raises UnstackableBranchFormat: If the branch does not support
1630
:raises UnstackableRepositoryFormat: If the repository does not support
1634
return self._real_branch.set_stacked_on_url(stacked_location)
1636
def sprout(self, to_bzrdir, revision_id=None):
1637
branch_format = to_bzrdir._format._branch_format
1638
if (branch_format is None or
1639
isinstance(branch_format, RemoteBranchFormat)):
1640
# The to_bzrdir specifies RemoteBranchFormat (or no format, which
1641
# implies the same thing), but RemoteBranches can't be created at
1642
# arbitrary URLs. So create a branch in the same format as
1643
# _real_branch instead.
1644
# XXX: if to_bzrdir is a RemoteBzrDir, this should perhaps do
1645
# to_bzrdir.create_branch to create a RemoteBranch after all...
1647
result = self._real_branch._format.initialize(to_bzrdir)
1648
self.copy_content_into(result, revision_id=revision_id)
1649
result.set_parent(self.bzrdir.root_transport.base)
1651
result = branch.Branch.sprout(
1652
self, to_bzrdir, revision_id=revision_id)
2971
def _get_parent_location(self):
2972
medium = self._client._medium
2973
if medium._is_remote_before((1, 13)):
2974
return self._vfs_get_parent_location()
2976
response = self._call('Branch.get_parent', self._remote_path())
2977
except errors.UnknownSmartMethod:
2978
medium._remember_remote_is_before((1, 13))
2979
return self._vfs_get_parent_location()
2980
if len(response) != 1:
2981
raise errors.UnexpectedSmartServerResponse(response)
2982
parent_location = response[0]
2983
if parent_location == '':
2985
return parent_location
2987
def _vfs_get_parent_location(self):
2989
return self._real_branch._get_parent_location()
2991
def _set_parent_location(self, url):
2992
medium = self._client._medium
2993
if medium._is_remote_before((1, 15)):
2994
return self._vfs_set_parent_location(url)
2996
call_url = url or ''
2997
if type(call_url) is not str:
2998
raise AssertionError('url must be a str or None (%s)' % url)
2999
response = self._call('Branch.set_parent_location',
3000
self._remote_path(), self._lock_token, self._repo_lock_token,
3002
except errors.UnknownSmartMethod:
3003
medium._remember_remote_is_before((1, 15))
3004
return self._vfs_set_parent_location(url)
3006
raise errors.UnexpectedSmartServerResponse(response)
3008
def _vfs_set_parent_location(self, url):
3010
return self._real_branch._set_parent_location(url)
1655
3012
@needs_write_lock
1656
3013
def pull(self, source, overwrite=False, stop_revision=None,
1711
3074
except errors.UnknownSmartMethod:
1712
3075
medium._remember_remote_is_before((1, 6))
1713
3076
self._clear_cached_state_of_remote_branch_only()
1715
self._real_branch.generate_revision_history(
1716
revision_id, last_rev=last_rev, other_branch=other_branch)
1721
return self._real_branch.tags
3077
self._set_revision_history(self._lefthand_history(revision_id,
3078
last_rev=last_rev,other_branch=other_branch))
1723
3080
def set_push_location(self, location):
1724
3081
self._ensure_real()
1725
3082
return self._real_branch.set_push_location(location)
1728
def update_revisions(self, other, stop_revision=None, overwrite=False,
1730
"""See Branch.update_revisions."""
1733
if stop_revision is None:
1734
stop_revision = other.last_revision()
1735
if revision.is_null(stop_revision):
1736
# if there are no commits, we're done.
1738
self.fetch(other, stop_revision)
1741
# Just unconditionally set the new revision. We don't care if
1742
# the branches have diverged.
1743
self._set_last_revision(stop_revision)
1745
medium = self._client._medium
1746
if not medium._is_remote_before((1, 6)):
1748
self._set_last_revision_descendant(stop_revision, other)
1750
except errors.UnknownSmartMethod:
1751
medium._remember_remote_is_before((1, 6))
1752
# Fallback for pre-1.6 servers: check for divergence
1753
# client-side, then do _set_last_revision.
1754
last_rev = revision.ensure_null(self.last_revision())
1756
graph = self.repository.get_graph()
1757
if self._check_if_descendant_or_diverged(
1758
stop_revision, last_rev, graph, other):
1759
# stop_revision is a descendant of last_rev, but we aren't
1760
# overwriting, so we're done.
1762
self._set_last_revision(stop_revision)
3084
def heads_to_fetch(self):
3085
if self._format._use_default_local_heads_to_fetch():
3086
# We recognise this format, and its heads-to-fetch implementation
3087
# is the default one (tip + tags). In this case it's cheaper to
3088
# just use the default implementation rather than a special RPC as
3089
# the tip and tags data is cached.
3090
return branch.Branch.heads_to_fetch(self)
3091
medium = self._client._medium
3092
if medium._is_remote_before((2, 4)):
3093
return self._vfs_heads_to_fetch()
3095
return self._rpc_heads_to_fetch()
3096
except errors.UnknownSmartMethod:
3097
medium._remember_remote_is_before((2, 4))
3098
return self._vfs_heads_to_fetch()
3100
def _rpc_heads_to_fetch(self):
3101
response = self._call('Branch.heads_to_fetch', self._remote_path())
3102
if len(response) != 2:
3103
raise errors.UnexpectedSmartServerResponse(response)
3104
must_fetch, if_present_fetch = response
3105
return set(must_fetch), set(if_present_fetch)
3107
def _vfs_heads_to_fetch(self):
3109
return self._real_branch.heads_to_fetch()
3112
class RemoteConfig(object):
3113
"""A Config that reads and writes from smart verbs.
3115
It is a low-level object that considers config data to be name/value pairs
3116
that may be associated with a section. Assigning meaning to the these
3117
values is done at higher levels like bzrlib.config.TreeConfig.
3120
def get_option(self, name, section=None, default=None):
3121
"""Return the value associated with a named option.
3123
:param name: The name of the value
3124
:param section: The section the option is in (if any)
3125
:param default: The value to return if the value is not set
3126
:return: The value or default value
3129
configobj = self._get_configobj()
3132
section_obj = configobj
3135
section_obj = configobj[section]
3138
if section_obj is None:
3141
value = section_obj.get(name, default)
3142
except errors.UnknownSmartMethod:
3143
value = self._vfs_get_option(name, section, default)
3144
for hook in config.OldConfigHooks['get']:
3145
hook(self, name, value)
3148
def _response_to_configobj(self, response):
3149
if len(response[0]) and response[0][0] != 'ok':
3150
raise errors.UnexpectedSmartServerResponse(response)
3151
lines = response[1].read_body_bytes().splitlines()
3152
conf = config.ConfigObj(lines, encoding='utf-8')
3153
for hook in config.OldConfigHooks['load']:
3158
class RemoteBranchConfig(RemoteConfig):
3159
"""A RemoteConfig for Branches."""
3161
def __init__(self, branch):
3162
self._branch = branch
3164
def _get_configobj(self):
3165
path = self._branch._remote_path()
3166
response = self._branch._client.call_expecting_body(
3167
'Branch.get_config_file', path)
3168
return self._response_to_configobj(response)
3170
def set_option(self, value, name, section=None):
3171
"""Set the value associated with a named option.
3173
:param value: The value to set
3174
:param name: The name of the value to set
3175
:param section: The section the option is in (if any)
3177
medium = self._branch._client._medium
3178
if medium._is_remote_before((1, 14)):
3179
return self._vfs_set_option(value, name, section)
3180
if isinstance(value, dict):
3181
if medium._is_remote_before((2, 2)):
3182
return self._vfs_set_option(value, name, section)
3183
return self._set_config_option_dict(value, name, section)
3185
return self._set_config_option(value, name, section)
3187
def _set_config_option(self, value, name, section):
3189
path = self._branch._remote_path()
3190
response = self._branch._client.call('Branch.set_config_option',
3191
path, self._branch._lock_token, self._branch._repo_lock_token,
3192
value.encode('utf8'), name, section or '')
3193
except errors.UnknownSmartMethod:
3194
medium = self._branch._client._medium
3195
medium._remember_remote_is_before((1, 14))
3196
return self._vfs_set_option(value, name, section)
3198
raise errors.UnexpectedSmartServerResponse(response)
3200
def _serialize_option_dict(self, option_dict):
3202
for key, value in option_dict.items():
3203
if isinstance(key, unicode):
3204
key = key.encode('utf8')
3205
if isinstance(value, unicode):
3206
value = value.encode('utf8')
3207
utf8_dict[key] = value
3208
return bencode.bencode(utf8_dict)
3210
def _set_config_option_dict(self, value, name, section):
3212
path = self._branch._remote_path()
3213
serialised_dict = self._serialize_option_dict(value)
3214
response = self._branch._client.call(
3215
'Branch.set_config_option_dict',
3216
path, self._branch._lock_token, self._branch._repo_lock_token,
3217
serialised_dict, name, section or '')
3218
except errors.UnknownSmartMethod:
3219
medium = self._branch._client._medium
3220
medium._remember_remote_is_before((2, 2))
3221
return self._vfs_set_option(value, name, section)
3223
raise errors.UnexpectedSmartServerResponse(response)
3225
def _real_object(self):
3226
self._branch._ensure_real()
3227
return self._branch._real_branch
3229
def _vfs_set_option(self, value, name, section=None):
3230
return self._real_object()._get_config().set_option(
3231
value, name, section)
3234
class RemoteBzrDirConfig(RemoteConfig):
3235
"""A RemoteConfig for BzrDirs."""
3237
def __init__(self, bzrdir):
3238
self._bzrdir = bzrdir
3240
def _get_configobj(self):
3241
medium = self._bzrdir._client._medium
3242
verb = 'BzrDir.get_config_file'
3243
if medium._is_remote_before((1, 15)):
3244
raise errors.UnknownSmartMethod(verb)
3245
path = self._bzrdir._path_for_remote_call(self._bzrdir._client)
3246
response = self._bzrdir._call_expecting_body(
3248
return self._response_to_configobj(response)
3250
def _vfs_get_option(self, name, section, default):
3251
return self._real_object()._get_config().get_option(
3252
name, section, default)
3254
def set_option(self, value, name, section=None):
3255
"""Set the value associated with a named option.
3257
:param value: The value to set
3258
:param name: The name of the value to set
3259
:param section: The section the option is in (if any)
3261
return self._real_object()._get_config().set_option(
3262
value, name, section)
3264
def _real_object(self):
3265
self._bzrdir._ensure_real()
3266
return self._bzrdir._real_bzrdir
1767
3270
def _extract_tar(tar, to_dir):