~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/bzrdir.py

  • Committer: INADA Naoki
  • Date: 2011-05-05 09:15:34 UTC
  • mto: (5830.3.3 i18n-msgfmt)
  • mto: This revision was merged to the branch mainline in revision 5873.
  • Revision ID: songofacandy@gmail.com-20110505091534-7sv835xpofwrmpt4
Add update-pot command to Makefile and tools/bzrgettext script that
extracts help text from bzr commands.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2006-2010 Canonical Ltd
 
1
# Copyright (C) 2006-2011 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
25
25
objects returned.
26
26
"""
27
27
 
28
 
# TODO: Move old formats into a plugin to make this file smaller.
29
 
 
30
 
import os
31
28
import sys
32
 
import warnings
33
29
 
34
30
from bzrlib.lazy_import import lazy_import
35
31
lazy_import(globals(), """
36
 
from stat import S_ISDIR
37
 
import textwrap
38
 
 
39
32
import bzrlib
40
33
from bzrlib import (
41
 
    branch,
 
34
    branch as _mod_branch,
 
35
    cleanup,
42
36
    config,
 
37
    controldir,
43
38
    errors,
 
39
    fetch,
44
40
    graph,
45
41
    lockable_files,
46
42
    lockdir,
47
43
    osutils,
 
44
    pyutils,
48
45
    remote,
49
46
    repository,
50
47
    revision as _mod_revision,
 
48
    transport as _mod_transport,
51
49
    ui,
52
50
    urlutils,
53
 
    versionedfile,
54
51
    win32utils,
55
 
    workingtree,
 
52
    workingtree_3,
56
53
    workingtree_4,
57
 
    xml4,
58
 
    xml5,
59
 
    )
60
 
from bzrlib.osutils import (
61
 
    sha_string,
62
 
    )
63
 
from bzrlib.push import (
64
 
    PushResult,
65
 
    )
66
 
from bzrlib.repofmt import pack_repo
67
 
from bzrlib.smart.client import _SmartClient
68
 
from bzrlib.store.versioned import WeaveStore
69
 
from bzrlib.transactions import WriteTransaction
 
54
    )
 
55
from bzrlib.repofmt import knitpack_repo
70
56
from bzrlib.transport import (
71
57
    do_catching_redirections,
72
 
    get_transport,
73
58
    local,
74
59
    )
75
 
from bzrlib.weave import Weave
76
60
""")
77
61
 
78
62
from bzrlib.trace import (
79
63
    mutter,
80
64
    note,
81
 
    warning,
82
65
    )
83
66
 
84
67
from bzrlib import (
85
68
    hooks,
86
69
    registry,
87
 
    symbol_versioning,
88
 
    )
89
 
 
90
 
 
91
 
class BzrDir(object):
 
70
    )
 
71
from bzrlib.symbol_versioning import (
 
72
    deprecated_in,
 
73
    deprecated_method,
 
74
    )
 
75
 
 
76
 
 
77
class BzrDir(controldir.ControlDir):
92
78
    """A .bzr control diretory.
93
79
 
94
80
    BzrDir instances let you create or open any of the things that can be
125
111
                    return
126
112
        thing_to_unlock.break_lock()
127
113
 
128
 
    def can_convert_format(self):
129
 
        """Return true if this bzrdir is one whose format we can convert from."""
130
 
        return True
131
 
 
132
114
    def check_conversion_target(self, target_format):
133
115
        """Check that a bzrdir as a whole can be converted to a new format."""
134
116
        # The only current restriction is that the repository content can be 
141
123
            # No repo, no problem.
142
124
            pass
143
125
 
144
 
    @staticmethod
145
 
    def _check_supported(format, allow_unsupported,
146
 
        recommend_upgrade=True,
147
 
        basedir=None):
148
 
        """Give an error or warning on old formats.
149
 
 
150
 
        :param format: may be any kind of format - workingtree, branch,
151
 
        or repository.
152
 
 
153
 
        :param allow_unsupported: If true, allow opening
154
 
        formats that are strongly deprecated, and which may
155
 
        have limited functionality.
156
 
 
157
 
        :param recommend_upgrade: If true (default), warn
158
 
        the user through the ui object that they may wish
159
 
        to upgrade the object.
160
 
        """
161
 
        # TODO: perhaps move this into a base Format class; it's not BzrDir
162
 
        # specific. mbp 20070323
163
 
        if not allow_unsupported and not format.is_supported():
164
 
            # see open_downlevel to open legacy branches.
165
 
            raise errors.UnsupportedFormatError(format=format)
166
 
        if recommend_upgrade \
167
 
            and getattr(format, 'upgrade_recommended', False):
168
 
            ui.ui_factory.recommend_upgrade(
169
 
                format.get_format_description(),
170
 
                basedir)
171
 
 
172
 
    def clone(self, url, revision_id=None, force_new_repo=False,
173
 
              preserve_stacking=False):
174
 
        """Clone this bzrdir and its contents to url verbatim.
175
 
 
176
 
        :param url: The url create the clone at.  If url's last component does
177
 
            not exist, it will be created.
178
 
        :param revision_id: The tip revision-id to use for any branch or
179
 
            working tree.  If not None, then the clone operation may tune
180
 
            itself to download less data.
181
 
        :param force_new_repo: Do not use a shared repository for the target
182
 
                               even if one is available.
183
 
        :param preserve_stacking: When cloning a stacked branch, stack the
184
 
            new branch on top of the other branch's stacked-on branch.
185
 
        """
186
 
        return self.clone_on_transport(get_transport(url),
187
 
                                       revision_id=revision_id,
188
 
                                       force_new_repo=force_new_repo,
189
 
                                       preserve_stacking=preserve_stacking)
190
 
 
191
126
    def clone_on_transport(self, transport, revision_id=None,
192
127
        force_new_repo=False, preserve_stacking=False, stacked_on=None,
193
 
        create_prefix=False, use_existing_dir=True):
 
128
        create_prefix=False, use_existing_dir=True, no_tree=False):
194
129
        """Clone this bzrdir and its contents to transport verbatim.
195
130
 
196
131
        :param transport: The transport for the location to produce the clone
205
140
        :param create_prefix: Create any missing directories leading up to
206
141
            to_transport.
207
142
        :param use_existing_dir: Use an existing directory if one exists.
 
143
        :param no_tree: If set to true prevents creation of a working tree.
208
144
        """
209
145
        # Overview: put together a broad description of what we want to end up
210
146
        # with; then make as few api calls as possible to do it.
211
 
        
 
147
 
212
148
        # We may want to create a repo/branch/tree, if we do so what format
213
149
        # would we want for each:
214
150
        require_stacking = (stacked_on is not None)
215
151
        format = self.cloning_metadir(require_stacking)
216
 
        
 
152
 
217
153
        # Figure out what objects we want:
218
154
        try:
219
155
            local_repo = self.find_repository()
238
174
        # we should look up the policy needs first, or just use it as a hint,
239
175
        # or something.
240
176
        if local_repo:
241
 
            make_working_trees = local_repo.make_working_trees()
 
177
            make_working_trees = local_repo.make_working_trees() and not no_tree
242
178
            want_shared = local_repo.is_shared()
243
179
            repo_format_name = format.repository_format.network_name()
244
180
        else:
261
197
                # copied, and finally if we are copying up to a specific
262
198
                # revision_id then we can use the pending-ancestry-result which
263
199
                # does not require traversing all of history to describe it.
264
 
                if (result_repo.bzrdir.root_transport.base ==
265
 
                    result.root_transport.base and not require_stacking and
 
200
                if (result_repo.user_url == result.user_url
 
201
                    and not require_stacking and
266
202
                    revision_id is not None):
267
203
                    fetch_spec = graph.PendingAncestryResult(
268
204
                        [revision_id], local_repo)
293
229
    # TODO: This should be given a Transport, and should chdir up; otherwise
294
230
    # this will open a new connection.
295
231
    def _make_tail(self, url):
296
 
        t = get_transport(url)
297
 
        t.ensure_base()
298
 
 
299
 
    @classmethod
300
 
    def create(cls, base, format=None, possible_transports=None):
301
 
        """Create a new BzrDir at the url 'base'.
302
 
 
303
 
        :param format: If supplied, the format of branch to create.  If not
304
 
            supplied, the default is used.
305
 
        :param possible_transports: If supplied, a list of transports that
306
 
            can be reused to share a remote connection.
307
 
        """
308
 
        if cls is not BzrDir:
309
 
            raise AssertionError("BzrDir.create always creates the default"
310
 
                " format, not one of %r" % cls)
311
 
        t = get_transport(base, possible_transports)
312
 
        t.ensure_base()
313
 
        if format is None:
314
 
            format = BzrDirFormat.get_default_format()
315
 
        return format.initialize_on_transport(t)
 
232
        t = _mod_transport.get_transport(url)
 
233
        t.ensure_base()
316
234
 
317
235
    @staticmethod
318
236
    def find_bzrdirs(transport, evaluate=None, list_current=None):
342
260
            recurse = True
343
261
            try:
344
262
                bzrdir = BzrDir.open_from_transport(current_transport)
345
 
            except errors.NotBranchError:
 
263
            except (errors.NotBranchError, errors.PermissionDenied):
346
264
                pass
347
265
            else:
348
266
                recurse, value = evaluate(bzrdir)
349
267
                yield value
350
268
            try:
351
269
                subdirs = list_current(current_transport)
352
 
            except errors.NoSuchFile:
 
270
            except (errors.NoSuchFile, errors.PermissionDenied):
353
271
                continue
354
272
            if recurse:
355
273
                for subdir in sorted(subdirs, reverse=True):
356
274
                    pending.append(current_transport.clone(subdir))
357
275
 
358
 
    def list_branches(self):
359
 
        """Return a sequence of all branches local to this control directory.
360
 
 
361
 
        """
362
 
        try:
363
 
            return [self.open_branch()]
364
 
        except errors.NotBranchError:
365
 
            return []
366
 
 
367
276
    @staticmethod
368
277
    def find_branches(transport):
369
278
        """Find all branches under a transport.
392
301
                ret.extend(branches)
393
302
        return ret
394
303
 
395
 
    def destroy_repository(self):
396
 
        """Destroy the repository in this BzrDir"""
397
 
        raise NotImplementedError(self.destroy_repository)
398
 
 
399
 
    def create_branch(self):
400
 
        """Create a branch in this BzrDir.
401
 
 
402
 
        The bzrdir's format will control what branch format is created.
403
 
        For more control see BranchFormatXX.create(a_bzrdir).
404
 
        """
405
 
        raise NotImplementedError(self.create_branch)
406
 
 
407
 
    def destroy_branch(self):
408
 
        """Destroy the branch in this BzrDir"""
409
 
        raise NotImplementedError(self.destroy_branch)
410
 
 
411
304
    @staticmethod
412
305
    def create_branch_and_repo(base, force_new_repo=False, format=None):
413
306
        """Create a new BzrDir, Branch and Repository at the url 'base'.
451
344
            stop = False
452
345
            stack_on = config.get_default_stack_on()
453
346
            if stack_on is not None:
454
 
                stack_on_pwd = found_bzrdir.root_transport.base
 
347
                stack_on_pwd = found_bzrdir.user_url
455
348
                stop = True
456
349
            # does it have a repository ?
457
350
            try:
459
352
            except errors.NoRepositoryPresent:
460
353
                repository = None
461
354
            else:
462
 
                if ((found_bzrdir.root_transport.base !=
463
 
                     self.root_transport.base) and not repository.is_shared()):
 
355
                if (found_bzrdir.user_url != self.user_url 
 
356
                    and not repository.is_shared()):
464
357
                    # Don't look higher, can't use a higher shared repo.
465
358
                    repository = None
466
359
                    stop = True
495
388
        policy = self.determine_repository_policy(force_new_repo)
496
389
        return policy.acquire_repository()[0]
497
390
 
 
391
    def _find_source_repo(self, add_cleanup, source_branch):
 
392
        """Find the source branch and repo for a sprout operation.
 
393
        
 
394
        This is helper intended for use by _sprout.
 
395
 
 
396
        :returns: (source_branch, source_repository).  Either or both may be
 
397
            None.  If not None, they will be read-locked (and their unlock(s)
 
398
            scheduled via the add_cleanup param).
 
399
        """
 
400
        if source_branch is not None:
 
401
            add_cleanup(source_branch.lock_read().unlock)
 
402
            return source_branch, source_branch.repository
 
403
        try:
 
404
            source_branch = self.open_branch()
 
405
            source_repository = source_branch.repository
 
406
        except errors.NotBranchError:
 
407
            source_branch = None
 
408
            try:
 
409
                source_repository = self.open_repository()
 
410
            except errors.NoRepositoryPresent:
 
411
                source_repository = None
 
412
            else:
 
413
                add_cleanup(source_repository.lock_read().unlock)
 
414
        else:
 
415
            add_cleanup(source_branch.lock_read().unlock)
 
416
        return source_branch, source_repository
 
417
 
 
418
    def sprout(self, url, revision_id=None, force_new_repo=False,
 
419
               recurse='down', possible_transports=None,
 
420
               accelerator_tree=None, hardlink=False, stacked=False,
 
421
               source_branch=None, create_tree_if_local=True):
 
422
        """Create a copy of this controldir prepared for use as a new line of
 
423
        development.
 
424
 
 
425
        If url's last component does not exist, it will be created.
 
426
 
 
427
        Attributes related to the identity of the source branch like
 
428
        branch nickname will be cleaned, a working tree is created
 
429
        whether one existed before or not; and a local branch is always
 
430
        created.
 
431
 
 
432
        if revision_id is not None, then the clone operation may tune
 
433
            itself to download less data.
 
434
        :param accelerator_tree: A tree which can be used for retrieving file
 
435
            contents more quickly than the revision tree, i.e. a workingtree.
 
436
            The revision tree will be used for cases where accelerator_tree's
 
437
            content is different.
 
438
        :param hardlink: If true, hard-link files from accelerator_tree,
 
439
            where possible.
 
440
        :param stacked: If true, create a stacked branch referring to the
 
441
            location of this control directory.
 
442
        :param create_tree_if_local: If true, a working-tree will be created
 
443
            when working locally.
 
444
        """
 
445
        operation = cleanup.OperationWithCleanups(self._sprout)
 
446
        return operation.run(url, revision_id=revision_id,
 
447
            force_new_repo=force_new_repo, recurse=recurse,
 
448
            possible_transports=possible_transports,
 
449
            accelerator_tree=accelerator_tree, hardlink=hardlink,
 
450
            stacked=stacked, source_branch=source_branch,
 
451
            create_tree_if_local=create_tree_if_local)
 
452
 
 
453
    def _sprout(self, op, url, revision_id=None, force_new_repo=False,
 
454
               recurse='down', possible_transports=None,
 
455
               accelerator_tree=None, hardlink=False, stacked=False,
 
456
               source_branch=None, create_tree_if_local=True):
 
457
        add_cleanup = op.add_cleanup
 
458
        fetch_spec_factory = fetch.FetchSpecFactory()
 
459
        if revision_id is not None:
 
460
            fetch_spec_factory.add_revision_ids([revision_id])
 
461
            fetch_spec_factory.source_branch_stop_revision_id = revision_id
 
462
        target_transport = _mod_transport.get_transport(url,
 
463
            possible_transports)
 
464
        target_transport.ensure_base()
 
465
        cloning_format = self.cloning_metadir(stacked)
 
466
        # Create/update the result branch
 
467
        result = cloning_format.initialize_on_transport(target_transport)
 
468
        source_branch, source_repository = self._find_source_repo(
 
469
            add_cleanup, source_branch)
 
470
        fetch_spec_factory.source_branch = source_branch
 
471
        # if a stacked branch wasn't requested, we don't create one
 
472
        # even if the origin was stacked
 
473
        if stacked and source_branch is not None:
 
474
            stacked_branch_url = self.root_transport.base
 
475
        else:
 
476
            stacked_branch_url = None
 
477
        repository_policy = result.determine_repository_policy(
 
478
            force_new_repo, stacked_branch_url, require_stacking=stacked)
 
479
        result_repo, is_new_repo = repository_policy.acquire_repository()
 
480
        add_cleanup(result_repo.lock_write().unlock)
 
481
        fetch_spec_factory.source_repo = source_repository
 
482
        fetch_spec_factory.target_repo = result_repo
 
483
        if stacked or (len(result_repo._fallback_repositories) != 0):
 
484
            target_repo_kind = fetch.TargetRepoKinds.STACKED
 
485
        elif is_new_repo:
 
486
            target_repo_kind = fetch.TargetRepoKinds.EMPTY
 
487
        else:
 
488
            target_repo_kind = fetch.TargetRepoKinds.PREEXISTING
 
489
        fetch_spec_factory.target_repo_kind = target_repo_kind
 
490
        if source_repository is not None:
 
491
            fetch_spec = fetch_spec_factory.make_fetch_spec()
 
492
            result_repo.fetch(source_repository, fetch_spec=fetch_spec)
 
493
 
 
494
        if source_branch is None:
 
495
            # this is for sprouting a controldir without a branch; is that
 
496
            # actually useful?
 
497
            # Not especially, but it's part of the contract.
 
498
            result_branch = result.create_branch()
 
499
        else:
 
500
            result_branch = source_branch.sprout(result,
 
501
                revision_id=revision_id, repository_policy=repository_policy,
 
502
                repository=result_repo)
 
503
        mutter("created new branch %r" % (result_branch,))
 
504
 
 
505
        # Create/update the result working tree
 
506
        if (create_tree_if_local and
 
507
            isinstance(target_transport, local.LocalTransport) and
 
508
            (result_repo is None or result_repo.make_working_trees())):
 
509
            wt = result.create_workingtree(accelerator_tree=accelerator_tree,
 
510
                hardlink=hardlink, from_branch=result_branch)
 
511
            wt.lock_write()
 
512
            try:
 
513
                if wt.path2id('') is None:
 
514
                    try:
 
515
                        wt.set_root_id(self.open_workingtree.get_root_id())
 
516
                    except errors.NoWorkingTree:
 
517
                        pass
 
518
            finally:
 
519
                wt.unlock()
 
520
        else:
 
521
            wt = None
 
522
        if recurse == 'down':
 
523
            basis = None
 
524
            if wt is not None:
 
525
                basis = wt.basis_tree()
 
526
            elif result_branch is not None:
 
527
                basis = result_branch.basis_tree()
 
528
            elif source_branch is not None:
 
529
                basis = source_branch.basis_tree()
 
530
            if basis is not None:
 
531
                add_cleanup(basis.lock_read().unlock)
 
532
                subtrees = basis.iter_references()
 
533
            else:
 
534
                subtrees = []
 
535
            for path, file_id in subtrees:
 
536
                target = urlutils.join(url, urlutils.escape(path))
 
537
                sublocation = source_branch.reference_parent(file_id, path)
 
538
                sublocation.bzrdir.sprout(target,
 
539
                    basis.get_reference_revision(file_id, path),
 
540
                    force_new_repo=force_new_repo, recurse=recurse,
 
541
                    stacked=stacked)
 
542
        return result
 
543
 
 
544
 
 
545
 
498
546
    @staticmethod
499
547
    def create_branch_convenience(base, force_new_repo=False,
500
548
                                  force_new_tree=None, format=None,
526
574
        """
527
575
        if force_new_tree:
528
576
            # check for non local urls
529
 
            t = get_transport(base, possible_transports)
 
577
            t = _mod_transport.get_transport(base, possible_transports)
530
578
            if not isinstance(t, local.LocalTransport):
531
579
                raise errors.NotLocalUrl(base)
532
580
        bzrdir = BzrDir.create(base, format, possible_transports)
554
602
        :param format: Override for the bzrdir format to create.
555
603
        :return: The WorkingTree object.
556
604
        """
557
 
        t = get_transport(base)
 
605
        t = _mod_transport.get_transport(base)
558
606
        if not isinstance(t, local.LocalTransport):
559
607
            raise errors.NotLocalUrl(base)
560
608
        bzrdir = BzrDir.create_branch_and_repo(base,
562
610
                                               format=format).bzrdir
563
611
        return bzrdir.create_workingtree()
564
612
 
565
 
    def create_workingtree(self, revision_id=None, from_branch=None,
566
 
        accelerator_tree=None, hardlink=False):
567
 
        """Create a working tree at this BzrDir.
568
 
 
569
 
        :param revision_id: create it as of this revision id.
570
 
        :param from_branch: override bzrdir branch (for lightweight checkouts)
571
 
        :param accelerator_tree: A tree which can be used for retrieving file
572
 
            contents more quickly than the revision tree, i.e. a workingtree.
573
 
            The revision tree will be used for cases where accelerator_tree's
574
 
            content is different.
 
613
    @deprecated_method(deprecated_in((2, 3, 0)))
 
614
    def generate_backup_name(self, base):
 
615
        return self._available_backup_name(base)
 
616
 
 
617
    def _available_backup_name(self, base):
 
618
        """Find a non-existing backup file name based on base.
 
619
 
 
620
        See bzrlib.osutils.available_backup_name about race conditions.
575
621
        """
576
 
        raise NotImplementedError(self.create_workingtree)
 
622
        return osutils.available_backup_name(base, self.root_transport.has)
577
623
 
578
624
    def backup_bzrdir(self):
579
625
        """Backup this bzr control directory.
580
626
 
581
627
        :return: Tuple with old path name and new path name
582
628
        """
 
629
 
583
630
        pb = ui.ui_factory.nested_progress_bar()
584
631
        try:
585
 
            # FIXME: bug 300001 -- the backup fails if the backup directory
586
 
            # already exists, but it should instead either remove it or make
587
 
            # a new backup directory.
588
 
            #
589
 
            # FIXME: bug 262450 -- the backup directory should have the same
590
 
            # permissions as the .bzr directory (probably a bug in copy_tree)
591
632
            old_path = self.root_transport.abspath('.bzr')
592
 
            new_path = self.root_transport.abspath('backup.bzr')
593
 
            ui.ui_factory.note('making backup of %s\n  to %s' % (old_path, new_path,))
594
 
            self.root_transport.copy_tree('.bzr', 'backup.bzr')
 
633
            backup_dir = self._available_backup_name('backup.bzr')
 
634
            new_path = self.root_transport.abspath(backup_dir)
 
635
            ui.ui_factory.note('making backup of %s\n  to %s'
 
636
                               % (old_path, new_path,))
 
637
            self.root_transport.copy_tree('.bzr', backup_dir)
595
638
            return (old_path, new_path)
596
639
        finally:
597
640
            pb.finished()
621
664
                else:
622
665
                    pass
623
666
 
624
 
    def destroy_workingtree(self):
625
 
        """Destroy the working tree at this BzrDir.
626
 
 
627
 
        Formats that do not support this may raise UnsupportedOperation.
628
 
        """
629
 
        raise NotImplementedError(self.destroy_workingtree)
630
 
 
631
 
    def destroy_workingtree_metadata(self):
632
 
        """Destroy the control files for the working tree at this BzrDir.
633
 
 
634
 
        The contents of working tree files are not affected.
635
 
        Formats that do not support this may raise UnsupportedOperation.
636
 
        """
637
 
        raise NotImplementedError(self.destroy_workingtree_metadata)
638
 
 
639
667
    def _find_containing(self, evaluate):
640
668
        """Find something in a containing control directory.
641
669
 
655
683
            if stop:
656
684
                return result
657
685
            next_transport = found_bzrdir.root_transport.clone('..')
658
 
            if (found_bzrdir.root_transport.base == next_transport.base):
 
686
            if (found_bzrdir.user_url == next_transport.base):
659
687
                # top of the file system
660
688
                return None
661
689
            # find the next containing bzrdir
678
706
                repository = found_bzrdir.open_repository()
679
707
            except errors.NoRepositoryPresent:
680
708
                return None, False
681
 
            if found_bzrdir.root_transport.base == self.root_transport.base:
 
709
            if found_bzrdir.user_url == self.user_url:
682
710
                return repository, True
683
711
            elif repository.is_shared():
684
712
                return repository, True
690
718
            raise errors.NoRepositoryPresent(self)
691
719
        return found_repo
692
720
 
693
 
    def get_branch_reference(self):
694
 
        """Return the referenced URL for the branch in this bzrdir.
695
 
 
696
 
        :raises NotBranchError: If there is no Branch.
697
 
        :return: The URL the branch in this bzrdir references if it is a
698
 
            reference branch, or None for regular branches.
699
 
        """
700
 
        return None
701
 
 
702
 
    def get_branch_transport(self, branch_format):
703
 
        """Get the transport for use by branch format in this BzrDir.
704
 
 
705
 
        Note that bzr dirs that do not support format strings will raise
706
 
        IncompatibleFormat if the branch format they are given has
707
 
        a format string, and vice versa.
708
 
 
709
 
        If branch_format is None, the transport is returned with no
710
 
        checking. If it is not None, then the returned transport is
711
 
        guaranteed to point to an existing directory ready for use.
712
 
        """
713
 
        raise NotImplementedError(self.get_branch_transport)
714
 
 
715
721
    def _find_creation_modes(self):
716
722
        """Determine the appropriate modes for files and directories.
717
723
 
756
762
            self._find_creation_modes()
757
763
        return self._dir_mode
758
764
 
759
 
    def get_repository_transport(self, repository_format):
760
 
        """Get the transport for use by repository format in this BzrDir.
761
 
 
762
 
        Note that bzr dirs that do not support format strings will raise
763
 
        IncompatibleFormat if the repository format they are given has
764
 
        a format string, and vice versa.
765
 
 
766
 
        If repository_format is None, the transport is returned with no
767
 
        checking. If it is not None, then the returned transport is
768
 
        guaranteed to point to an existing directory ready for use.
769
 
        """
770
 
        raise NotImplementedError(self.get_repository_transport)
771
 
 
772
 
    def get_workingtree_transport(self, tree_format):
773
 
        """Get the transport for use by workingtree format in this BzrDir.
774
 
 
775
 
        Note that bzr dirs that do not support format strings will raise
776
 
        IncompatibleFormat if the workingtree format they are given has a
777
 
        format string, and vice versa.
778
 
 
779
 
        If workingtree_format is None, the transport is returned with no
780
 
        checking. If it is not None, then the returned transport is
781
 
        guaranteed to point to an existing directory ready for use.
782
 
        """
783
 
        raise NotImplementedError(self.get_workingtree_transport)
784
 
 
785
765
    def get_config(self):
786
766
        """Get configuration for this BzrDir."""
787
767
        return config.BzrDirConfig(self)
800
780
        :param _transport: the transport this dir is based at.
801
781
        """
802
782
        self._format = _format
 
783
        # these are also under the more standard names of 
 
784
        # control_transport and user_transport
803
785
        self.transport = _transport.clone('.bzr')
804
786
        self.root_transport = _transport
805
787
        self._mode_check_done = False
806
788
 
 
789
    @property 
 
790
    def user_transport(self):
 
791
        return self.root_transport
 
792
 
 
793
    @property
 
794
    def control_transport(self):
 
795
        return self.transport
 
796
 
807
797
    def is_control_filename(self, filename):
808
798
        """True if filename is the name of a path which is reserved for bzrdir's.
809
799
 
811
801
 
812
802
        This is true IF and ONLY IF the filename is part of the namespace reserved
813
803
        for bzr control dirs. Currently this is the '.bzr' directory in the root
814
 
        of the root_transport. it is expected that plugins will need to extend
815
 
        this in the future - for instance to make bzr talk with svn working
816
 
        trees.
 
804
        of the root_transport. 
817
805
        """
818
806
        # this might be better on the BzrDirFormat class because it refers to
819
807
        # all the possible bzrdir disk formats.
823
811
        # add new tests for it to the appropriate place.
824
812
        return filename == '.bzr' or filename.startswith('.bzr/')
825
813
 
826
 
    def needs_format_conversion(self, format=None):
827
 
        """Return true if this bzrdir needs convert_format run on it.
828
 
 
829
 
        For instance, if the repository format is out of date but the
830
 
        branch and working tree are not, this should return True.
831
 
 
832
 
        :param format: Optional parameter indicating a specific desired
833
 
                       format we plan to arrive at.
834
 
        """
835
 
        raise NotImplementedError(self.needs_format_conversion)
836
 
 
837
814
    @staticmethod
838
815
    def open_unsupported(base):
839
816
        """Open a branch which is not supported."""
845
822
 
846
823
        :param _unsupported: a private parameter to the BzrDir class.
847
824
        """
848
 
        t = get_transport(base, possible_transports=possible_transports)
 
825
        t = _mod_transport.get_transport(base, possible_transports)
849
826
        return BzrDir.open_from_transport(t, _unsupported=_unsupported)
850
827
 
851
828
    @staticmethod
862
839
        # the redirections.
863
840
        base = transport.base
864
841
        def find_format(transport):
865
 
            return transport, BzrDirFormat.find_format(
 
842
            return transport, controldir.ControlDirFormat.find_format(
866
843
                transport, _server_formats=_server_formats)
867
844
 
868
845
        def redirected(transport, e, redirection_notice):
880
857
        except errors.TooManyRedirections:
881
858
            raise errors.NotBranchError(base)
882
859
 
883
 
        BzrDir._check_supported(format, _unsupported)
 
860
        format.check_support_status(_unsupported)
884
861
        return format.open(transport, _found=True)
885
862
 
886
 
    def open_branch(self, unsupported=False, ignore_fallbacks=False):
887
 
        """Open the branch object at this BzrDir if one is present.
888
 
 
889
 
        If unsupported is True, then no longer supported branch formats can
890
 
        still be opened.
891
 
 
892
 
        TODO: static convenience version of this?
893
 
        """
894
 
        raise NotImplementedError(self.open_branch)
895
 
 
896
863
    @staticmethod
897
864
    def open_containing(url, possible_transports=None):
898
865
        """Open an existing branch which contains url.
900
867
        :param url: url to search from.
901
868
        See open_containing_from_transport for more detail.
902
869
        """
903
 
        transport = get_transport(url, possible_transports)
 
870
        transport = _mod_transport.get_transport(url, possible_transports)
904
871
        return BzrDir.open_containing_from_transport(transport)
905
872
 
906
873
    @staticmethod
936
903
                raise errors.NotBranchError(path=url)
937
904
            a_transport = new_t
938
905
 
939
 
    def _get_tree_branch(self):
940
 
        """Return the branch and tree, if any, for this bzrdir.
941
 
 
942
 
        Return None for tree if not present or inaccessible.
943
 
        Raise NotBranchError if no branch is present.
944
 
        :return: (tree, branch)
945
 
        """
946
 
        try:
947
 
            tree = self.open_workingtree()
948
 
        except (errors.NoWorkingTree, errors.NotLocalUrl):
949
 
            tree = None
950
 
            branch = self.open_branch()
951
 
        else:
952
 
            branch = tree.branch
953
 
        return tree, branch
954
 
 
955
906
    @classmethod
956
907
    def open_tree_or_branch(klass, location):
957
908
        """Return the branch and working tree at a location.
1003
954
                raise errors.NotBranchError(location)
1004
955
        return tree, branch, branch.repository, relpath
1005
956
 
1006
 
    def open_repository(self, _unsupported=False):
1007
 
        """Open the repository object at this BzrDir if one is present.
1008
 
 
1009
 
        This will not follow the Branch object pointer - it's strictly a direct
1010
 
        open facility. Most client code should use open_branch().repository to
1011
 
        get at a repository.
1012
 
 
1013
 
        :param _unsupported: a private parameter, not part of the api.
1014
 
        TODO: static convenience version of this?
1015
 
        """
1016
 
        raise NotImplementedError(self.open_repository)
1017
 
 
1018
 
    def open_workingtree(self, _unsupported=False,
1019
 
                         recommend_upgrade=True, from_branch=None):
1020
 
        """Open the workingtree object at this BzrDir if one is present.
1021
 
 
1022
 
        :param recommend_upgrade: Optional keyword parameter, when True (the
1023
 
            default), emit through the ui module a recommendation that the user
1024
 
            upgrade the working tree when the workingtree being opened is old
1025
 
            (but still fully supported).
1026
 
        :param from_branch: override bzrdir branch (for lightweight checkouts)
1027
 
        """
1028
 
        raise NotImplementedError(self.open_workingtree)
1029
 
 
1030
 
    def has_branch(self):
1031
 
        """Tell if this bzrdir contains a branch.
1032
 
 
1033
 
        Note: if you're going to open the branch, you should just go ahead
1034
 
        and try, and not ask permission first.  (This method just opens the
1035
 
        branch and discards it, and that's somewhat expensive.)
1036
 
        """
1037
 
        try:
1038
 
            self.open_branch()
1039
 
            return True
1040
 
        except errors.NotBranchError:
1041
 
            return False
1042
 
 
1043
 
    def has_workingtree(self):
1044
 
        """Tell if this bzrdir contains a working tree.
1045
 
 
1046
 
        This will still raise an exception if the bzrdir has a workingtree that
1047
 
        is remote & inaccessible.
1048
 
 
1049
 
        Note: if you're going to open the working tree, you should just go ahead
1050
 
        and try, and not ask permission first.  (This method just opens the
1051
 
        workingtree and discards it, and that's somewhat expensive.)
1052
 
        """
1053
 
        try:
1054
 
            self.open_workingtree(recommend_upgrade=False)
1055
 
            return True
1056
 
        except errors.NoWorkingTree:
1057
 
            return False
1058
 
 
1059
957
    def _cloning_metadir(self):
1060
958
        """Produce a metadir suitable for cloning with.
1061
959
 
1119
1017
            format.require_stacking()
1120
1018
        return format
1121
1019
 
1122
 
    def checkout_metadir(self):
1123
 
        return self.cloning_metadir()
1124
 
 
1125
 
    def sprout(self, url, revision_id=None, force_new_repo=False,
1126
 
               recurse='down', possible_transports=None,
1127
 
               accelerator_tree=None, hardlink=False, stacked=False,
1128
 
               source_branch=None, create_tree_if_local=True):
1129
 
        """Create a copy of this bzrdir prepared for use as a new line of
1130
 
        development.
1131
 
 
1132
 
        If url's last component does not exist, it will be created.
1133
 
 
1134
 
        Attributes related to the identity of the source branch like
1135
 
        branch nickname will be cleaned, a working tree is created
1136
 
        whether one existed before or not; and a local branch is always
1137
 
        created.
1138
 
 
1139
 
        if revision_id is not None, then the clone operation may tune
1140
 
            itself to download less data.
1141
 
        :param accelerator_tree: A tree which can be used for retrieving file
1142
 
            contents more quickly than the revision tree, i.e. a workingtree.
1143
 
            The revision tree will be used for cases where accelerator_tree's
1144
 
            content is different.
1145
 
        :param hardlink: If true, hard-link files from accelerator_tree,
1146
 
            where possible.
1147
 
        :param stacked: If true, create a stacked branch referring to the
1148
 
            location of this control directory.
1149
 
        :param create_tree_if_local: If true, a working-tree will be created
1150
 
            when working locally.
1151
 
        """
1152
 
        target_transport = get_transport(url, possible_transports)
1153
 
        target_transport.ensure_base()
1154
 
        cloning_format = self.cloning_metadir(stacked)
1155
 
        # Create/update the result branch
1156
 
        result = cloning_format.initialize_on_transport(target_transport)
1157
 
        # if a stacked branch wasn't requested, we don't create one
1158
 
        # even if the origin was stacked
1159
 
        stacked_branch_url = None
1160
 
        if source_branch is not None:
1161
 
            if stacked:
1162
 
                stacked_branch_url = self.root_transport.base
1163
 
            source_repository = source_branch.repository
1164
 
        else:
1165
 
            try:
1166
 
                source_branch = self.open_branch()
1167
 
                source_repository = source_branch.repository
1168
 
                if stacked:
1169
 
                    stacked_branch_url = self.root_transport.base
1170
 
            except errors.NotBranchError:
1171
 
                source_branch = None
1172
 
                try:
1173
 
                    source_repository = self.open_repository()
1174
 
                except errors.NoRepositoryPresent:
1175
 
                    source_repository = None
1176
 
        repository_policy = result.determine_repository_policy(
1177
 
            force_new_repo, stacked_branch_url, require_stacking=stacked)
1178
 
        result_repo, is_new_repo = repository_policy.acquire_repository()
1179
 
        if is_new_repo and revision_id is not None and not stacked:
1180
 
            fetch_spec = graph.PendingAncestryResult(
1181
 
                [revision_id], source_repository)
1182
 
        else:
1183
 
            fetch_spec = None
1184
 
        if source_repository is not None:
1185
 
            # Fetch while stacked to prevent unstacked fetch from
1186
 
            # Branch.sprout.
1187
 
            if fetch_spec is None:
1188
 
                result_repo.fetch(source_repository, revision_id=revision_id)
1189
 
            else:
1190
 
                result_repo.fetch(source_repository, fetch_spec=fetch_spec)
1191
 
 
1192
 
        if source_branch is None:
1193
 
            # this is for sprouting a bzrdir without a branch; is that
1194
 
            # actually useful?
1195
 
            # Not especially, but it's part of the contract.
1196
 
            result_branch = result.create_branch()
1197
 
        else:
1198
 
            result_branch = source_branch.sprout(result,
1199
 
                revision_id=revision_id, repository_policy=repository_policy)
1200
 
        mutter("created new branch %r" % (result_branch,))
1201
 
 
1202
 
        # Create/update the result working tree
1203
 
        if (create_tree_if_local and
1204
 
            isinstance(target_transport, local.LocalTransport) and
1205
 
            (result_repo is None or result_repo.make_working_trees())):
1206
 
            wt = result.create_workingtree(accelerator_tree=accelerator_tree,
1207
 
                hardlink=hardlink)
1208
 
            wt.lock_write()
1209
 
            try:
1210
 
                if wt.path2id('') is None:
1211
 
                    try:
1212
 
                        wt.set_root_id(self.open_workingtree.get_root_id())
1213
 
                    except errors.NoWorkingTree:
1214
 
                        pass
1215
 
            finally:
1216
 
                wt.unlock()
1217
 
        else:
1218
 
            wt = None
1219
 
        if recurse == 'down':
1220
 
            if wt is not None:
1221
 
                basis = wt.basis_tree()
1222
 
                basis.lock_read()
1223
 
                subtrees = basis.iter_references()
1224
 
            elif result_branch is not None:
1225
 
                basis = result_branch.basis_tree()
1226
 
                basis.lock_read()
1227
 
                subtrees = basis.iter_references()
1228
 
            elif source_branch is not None:
1229
 
                basis = source_branch.basis_tree()
1230
 
                basis.lock_read()
1231
 
                subtrees = basis.iter_references()
1232
 
            else:
1233
 
                subtrees = []
1234
 
                basis = None
1235
 
            try:
1236
 
                for path, file_id in subtrees:
1237
 
                    target = urlutils.join(url, urlutils.escape(path))
1238
 
                    sublocation = source_branch.reference_parent(file_id, path)
1239
 
                    sublocation.bzrdir.sprout(target,
1240
 
                        basis.get_reference_revision(file_id, path),
1241
 
                        force_new_repo=force_new_repo, recurse=recurse,
1242
 
                        stacked=stacked)
1243
 
            finally:
1244
 
                if basis is not None:
1245
 
                    basis.unlock()
1246
 
        return result
1247
 
 
1248
 
    def push_branch(self, source, revision_id=None, overwrite=False, 
1249
 
        remember=False, create_prefix=False):
1250
 
        """Push the source branch into this BzrDir."""
1251
 
        br_to = None
1252
 
        # If we can open a branch, use its direct repository, otherwise see
1253
 
        # if there is a repository without a branch.
1254
 
        try:
1255
 
            br_to = self.open_branch()
1256
 
        except errors.NotBranchError:
1257
 
            # Didn't find a branch, can we find a repository?
1258
 
            repository_to = self.find_repository()
1259
 
        else:
1260
 
            # Found a branch, so we must have found a repository
1261
 
            repository_to = br_to.repository
1262
 
 
1263
 
        push_result = PushResult()
1264
 
        push_result.source_branch = source
1265
 
        if br_to is None:
1266
 
            # We have a repository but no branch, copy the revisions, and then
1267
 
            # create a branch.
1268
 
            repository_to.fetch(source.repository, revision_id=revision_id)
1269
 
            br_to = source.clone(self, revision_id=revision_id)
1270
 
            if source.get_push_location() is None or remember:
1271
 
                source.set_push_location(br_to.base)
1272
 
            push_result.stacked_on = None
1273
 
            push_result.branch_push_result = None
1274
 
            push_result.old_revno = None
1275
 
            push_result.old_revid = _mod_revision.NULL_REVISION
1276
 
            push_result.target_branch = br_to
1277
 
            push_result.master_branch = None
1278
 
            push_result.workingtree_updated = False
1279
 
        else:
1280
 
            # We have successfully opened the branch, remember if necessary:
1281
 
            if source.get_push_location() is None or remember:
1282
 
                source.set_push_location(br_to.base)
1283
 
            try:
1284
 
                tree_to = self.open_workingtree()
1285
 
            except errors.NotLocalUrl:
1286
 
                push_result.branch_push_result = source.push(br_to, 
1287
 
                    overwrite, stop_revision=revision_id)
1288
 
                push_result.workingtree_updated = False
1289
 
            except errors.NoWorkingTree:
1290
 
                push_result.branch_push_result = source.push(br_to,
1291
 
                    overwrite, stop_revision=revision_id)
1292
 
                push_result.workingtree_updated = None # Not applicable
1293
 
            else:
1294
 
                tree_to.lock_write()
1295
 
                try:
1296
 
                    push_result.branch_push_result = source.push(
1297
 
                        tree_to.branch, overwrite, stop_revision=revision_id)
1298
 
                    tree_to.update()
1299
 
                finally:
1300
 
                    tree_to.unlock()
1301
 
                push_result.workingtree_updated = True
1302
 
            push_result.old_revno = push_result.branch_push_result.old_revno
1303
 
            push_result.old_revid = push_result.branch_push_result.old_revid
1304
 
            push_result.target_branch = \
1305
 
                push_result.branch_push_result.target_branch
1306
 
        return push_result
 
1020
    @classmethod
 
1021
    def create(cls, base, format=None, possible_transports=None):
 
1022
        """Create a new BzrDir at the url 'base'.
 
1023
 
 
1024
        :param format: If supplied, the format of branch to create.  If not
 
1025
            supplied, the default is used.
 
1026
        :param possible_transports: If supplied, a list of transports that
 
1027
            can be reused to share a remote connection.
 
1028
        """
 
1029
        if cls is not BzrDir:
 
1030
            raise AssertionError("BzrDir.create always creates the"
 
1031
                "default format, not one of %r" % cls)
 
1032
        t = _mod_transport.get_transport(base, possible_transports)
 
1033
        t.ensure_base()
 
1034
        if format is None:
 
1035
            format = controldir.ControlDirFormat.get_default_format()
 
1036
        return format.initialize_on_transport(t)
 
1037
 
 
1038
    def get_branch_transport(self, branch_format, name=None):
 
1039
        """Get the transport for use by branch format in this BzrDir.
 
1040
 
 
1041
        Note that bzr dirs that do not support format strings will raise
 
1042
        IncompatibleFormat if the branch format they are given has
 
1043
        a format string, and vice versa.
 
1044
 
 
1045
        If branch_format is None, the transport is returned with no
 
1046
        checking. If it is not None, then the returned transport is
 
1047
        guaranteed to point to an existing directory ready for use.
 
1048
        """
 
1049
        raise NotImplementedError(self.get_branch_transport)
 
1050
 
 
1051
    def get_repository_transport(self, repository_format):
 
1052
        """Get the transport for use by repository format in this BzrDir.
 
1053
 
 
1054
        Note that bzr dirs that do not support format strings will raise
 
1055
        IncompatibleFormat if the repository format they are given has
 
1056
        a format string, and vice versa.
 
1057
 
 
1058
        If repository_format is None, the transport is returned with no
 
1059
        checking. If it is not None, then the returned transport is
 
1060
        guaranteed to point to an existing directory ready for use.
 
1061
        """
 
1062
        raise NotImplementedError(self.get_repository_transport)
 
1063
 
 
1064
    def get_workingtree_transport(self, tree_format):
 
1065
        """Get the transport for use by workingtree format in this BzrDir.
 
1066
 
 
1067
        Note that bzr dirs that do not support format strings will raise
 
1068
        IncompatibleFormat if the workingtree format they are given has a
 
1069
        format string, and vice versa.
 
1070
 
 
1071
        If workingtree_format is None, the transport is returned with no
 
1072
        checking. If it is not None, then the returned transport is
 
1073
        guaranteed to point to an existing directory ready for use.
 
1074
        """
 
1075
        raise NotImplementedError(self.get_workingtree_transport)
1307
1076
 
1308
1077
 
1309
1078
class BzrDirHooks(hooks.Hooks):
1311
1080
 
1312
1081
    def __init__(self):
1313
1082
        """Create the default hooks."""
1314
 
        hooks.Hooks.__init__(self)
1315
 
        self.create_hook(hooks.HookPoint('pre_open',
 
1083
        hooks.Hooks.__init__(self, "bzrlib.bzrdir", "BzrDir.hooks")
 
1084
        self.add_hook('pre_open',
1316
1085
            "Invoked before attempting to open a BzrDir with the transport "
1317
 
            "that the open will use.", (1, 14), None))
 
1086
            "that the open will use.", (1, 14))
 
1087
        self.add_hook('post_repo_init',
 
1088
            "Invoked after a repository has been initialized. "
 
1089
            "post_repo_init is called with a "
 
1090
            "bzrlib.bzrdir.RepoInitHookParams.",
 
1091
            (2, 2))
1318
1092
 
1319
1093
# install the default hooks
1320
1094
BzrDir.hooks = BzrDirHooks()
1321
1095
 
1322
1096
 
1323
 
class BzrDirPreSplitOut(BzrDir):
1324
 
    """A common class for the all-in-one formats."""
1325
 
 
1326
 
    def __init__(self, _transport, _format):
1327
 
        """See BzrDir.__init__."""
1328
 
        super(BzrDirPreSplitOut, self).__init__(_transport, _format)
1329
 
        self._control_files = lockable_files.LockableFiles(
1330
 
                                            self.get_branch_transport(None),
1331
 
                                            self._format._lock_file_name,
1332
 
                                            self._format._lock_class)
1333
 
 
1334
 
    def break_lock(self):
1335
 
        """Pre-splitout bzrdirs do not suffer from stale locks."""
1336
 
        raise NotImplementedError(self.break_lock)
1337
 
 
1338
 
    def cloning_metadir(self, require_stacking=False):
1339
 
        """Produce a metadir suitable for cloning with."""
1340
 
        if require_stacking:
1341
 
            return format_registry.make_bzrdir('1.6')
1342
 
        return self._format.__class__()
1343
 
 
1344
 
    def clone(self, url, revision_id=None, force_new_repo=False,
1345
 
              preserve_stacking=False):
1346
 
        """See BzrDir.clone().
1347
 
 
1348
 
        force_new_repo has no effect, since this family of formats always
1349
 
        require a new repository.
1350
 
        preserve_stacking has no effect, since no source branch using this
1351
 
        family of formats can be stacked, so there is no stacking to preserve.
 
1097
class RepoInitHookParams(object):
 
1098
    """Object holding parameters passed to *_repo_init hooks.
 
1099
 
 
1100
    There are 4 fields that hooks may wish to access:
 
1101
 
 
1102
    :ivar repository: Repository created
 
1103
    :ivar format: Repository format
 
1104
    :ivar bzrdir: The bzrdir for the repository
 
1105
    :ivar shared: The repository is shared
 
1106
    """
 
1107
 
 
1108
    def __init__(self, repository, format, a_bzrdir, shared):
 
1109
        """Create a group of RepoInitHook parameters.
 
1110
 
 
1111
        :param repository: Repository created
 
1112
        :param format: Repository format
 
1113
        :param bzrdir: The bzrdir for the repository
 
1114
        :param shared: The repository is shared
1352
1115
        """
1353
 
        self._make_tail(url)
1354
 
        result = self._format._initialize_for_clone(url)
1355
 
        self.open_repository().clone(result, revision_id=revision_id)
1356
 
        from_branch = self.open_branch()
1357
 
        from_branch.clone(result, revision_id=revision_id)
1358
 
        try:
1359
 
            tree = self.open_workingtree()
1360
 
        except errors.NotLocalUrl:
1361
 
            # make a new one, this format always has to have one.
1362
 
            result._init_workingtree()
 
1116
        self.repository = repository
 
1117
        self.format = format
 
1118
        self.bzrdir = a_bzrdir
 
1119
        self.shared = shared
 
1120
 
 
1121
    def __eq__(self, other):
 
1122
        return self.__dict__ == other.__dict__
 
1123
 
 
1124
    def __repr__(self):
 
1125
        if self.repository:
 
1126
            return "<%s for %s>" % (self.__class__.__name__,
 
1127
                self.repository)
1363
1128
        else:
1364
 
            tree.clone(result)
1365
 
        return result
1366
 
 
1367
 
    def create_branch(self):
1368
 
        """See BzrDir.create_branch."""
1369
 
        return self._format.get_branch_format().initialize(self)
1370
 
 
1371
 
    def destroy_branch(self):
1372
 
        """See BzrDir.destroy_branch."""
1373
 
        raise errors.UnsupportedOperation(self.destroy_branch, self)
1374
 
 
1375
 
    def create_repository(self, shared=False):
1376
 
        """See BzrDir.create_repository."""
1377
 
        if shared:
1378
 
            raise errors.IncompatibleFormat('shared repository', self._format)
1379
 
        return self.open_repository()
1380
 
 
1381
 
    def destroy_repository(self):
1382
 
        """See BzrDir.destroy_repository."""
1383
 
        raise errors.UnsupportedOperation(self.destroy_repository, self)
1384
 
 
1385
 
    def create_workingtree(self, revision_id=None, from_branch=None,
1386
 
                           accelerator_tree=None, hardlink=False):
1387
 
        """See BzrDir.create_workingtree."""
1388
 
        # The workingtree is sometimes created when the bzrdir is created,
1389
 
        # but not when cloning.
1390
 
 
1391
 
        # this looks buggy but is not -really-
1392
 
        # because this format creates the workingtree when the bzrdir is
1393
 
        # created
1394
 
        # clone and sprout will have set the revision_id
1395
 
        # and that will have set it for us, its only
1396
 
        # specific uses of create_workingtree in isolation
1397
 
        # that can do wonky stuff here, and that only
1398
 
        # happens for creating checkouts, which cannot be
1399
 
        # done on this format anyway. So - acceptable wart.
1400
 
        if hardlink:
1401
 
            warning("can't support hardlinked working trees in %r"
1402
 
                % (self,))
1403
 
        try:
1404
 
            result = self.open_workingtree(recommend_upgrade=False)
1405
 
        except errors.NoSuchFile:
1406
 
            result = self._init_workingtree()
1407
 
        if revision_id is not None:
1408
 
            if revision_id == _mod_revision.NULL_REVISION:
1409
 
                result.set_parent_ids([])
1410
 
            else:
1411
 
                result.set_parent_ids([revision_id])
1412
 
        return result
1413
 
 
1414
 
    def _init_workingtree(self):
1415
 
        from bzrlib.workingtree import WorkingTreeFormat2
1416
 
        try:
1417
 
            return WorkingTreeFormat2().initialize(self)
1418
 
        except errors.NotLocalUrl:
1419
 
            # Even though we can't access the working tree, we need to
1420
 
            # create its control files.
1421
 
            return WorkingTreeFormat2()._stub_initialize_on_transport(
1422
 
                self.transport, self._control_files._file_mode)
1423
 
 
1424
 
    def destroy_workingtree(self):
1425
 
        """See BzrDir.destroy_workingtree."""
1426
 
        raise errors.UnsupportedOperation(self.destroy_workingtree, self)
1427
 
 
1428
 
    def destroy_workingtree_metadata(self):
1429
 
        """See BzrDir.destroy_workingtree_metadata."""
1430
 
        raise errors.UnsupportedOperation(self.destroy_workingtree_metadata,
1431
 
                                          self)
1432
 
 
1433
 
    def get_branch_transport(self, branch_format):
1434
 
        """See BzrDir.get_branch_transport()."""
1435
 
        if branch_format is None:
1436
 
            return self.transport
1437
 
        try:
1438
 
            branch_format.get_format_string()
1439
 
        except NotImplementedError:
1440
 
            return self.transport
1441
 
        raise errors.IncompatibleFormat(branch_format, self._format)
1442
 
 
1443
 
    def get_repository_transport(self, repository_format):
1444
 
        """See BzrDir.get_repository_transport()."""
1445
 
        if repository_format is None:
1446
 
            return self.transport
1447
 
        try:
1448
 
            repository_format.get_format_string()
1449
 
        except NotImplementedError:
1450
 
            return self.transport
1451
 
        raise errors.IncompatibleFormat(repository_format, self._format)
1452
 
 
1453
 
    def get_workingtree_transport(self, workingtree_format):
1454
 
        """See BzrDir.get_workingtree_transport()."""
1455
 
        if workingtree_format is None:
1456
 
            return self.transport
1457
 
        try:
1458
 
            workingtree_format.get_format_string()
1459
 
        except NotImplementedError:
1460
 
            return self.transport
1461
 
        raise errors.IncompatibleFormat(workingtree_format, self._format)
1462
 
 
1463
 
    def needs_format_conversion(self, format=None):
1464
 
        """See BzrDir.needs_format_conversion()."""
1465
 
        # if the format is not the same as the system default,
1466
 
        # an upgrade is needed.
1467
 
        if format is None:
1468
 
            symbol_versioning.warn(symbol_versioning.deprecated_in((1, 13, 0))
1469
 
                % 'needs_format_conversion(format=None)')
1470
 
            format = BzrDirFormat.get_default_format()
1471
 
        return not isinstance(self._format, format.__class__)
1472
 
 
1473
 
    def open_branch(self, unsupported=False, ignore_fallbacks=False):
1474
 
        """See BzrDir.open_branch."""
1475
 
        from bzrlib.branch import BzrBranchFormat4
1476
 
        format = BzrBranchFormat4()
1477
 
        self._check_supported(format, unsupported)
1478
 
        return format.open(self, _found=True)
1479
 
 
1480
 
    def sprout(self, url, revision_id=None, force_new_repo=False,
1481
 
               possible_transports=None, accelerator_tree=None,
1482
 
               hardlink=False, stacked=False, create_tree_if_local=True,
1483
 
               source_branch=None):
1484
 
        """See BzrDir.sprout()."""
1485
 
        if source_branch is not None:
1486
 
            my_branch = self.open_branch()
1487
 
            if source_branch.base != my_branch.base:
1488
 
                raise AssertionError(
1489
 
                    "source branch %r is not within %r with branch %r" %
1490
 
                    (source_branch, self, my_branch))
1491
 
        if stacked:
1492
 
            raise errors.UnstackableBranchFormat(
1493
 
                self._format, self.root_transport.base)
1494
 
        if not create_tree_if_local:
1495
 
            raise errors.MustHaveWorkingTree(
1496
 
                self._format, self.root_transport.base)
1497
 
        from bzrlib.workingtree import WorkingTreeFormat2
1498
 
        self._make_tail(url)
1499
 
        result = self._format._initialize_for_clone(url)
1500
 
        try:
1501
 
            self.open_repository().clone(result, revision_id=revision_id)
1502
 
        except errors.NoRepositoryPresent:
1503
 
            pass
1504
 
        try:
1505
 
            self.open_branch().sprout(result, revision_id=revision_id)
1506
 
        except errors.NotBranchError:
1507
 
            pass
1508
 
 
1509
 
        # we always want a working tree
1510
 
        WorkingTreeFormat2().initialize(result,
1511
 
                                        accelerator_tree=accelerator_tree,
1512
 
                                        hardlink=hardlink)
1513
 
        return result
1514
 
 
1515
 
 
1516
 
class BzrDir4(BzrDirPreSplitOut):
1517
 
    """A .bzr version 4 control object.
1518
 
 
1519
 
    This is a deprecated format and may be removed after sept 2006.
1520
 
    """
1521
 
 
1522
 
    def create_repository(self, shared=False):
1523
 
        """See BzrDir.create_repository."""
1524
 
        return self._format.repository_format.initialize(self, shared)
1525
 
 
1526
 
    def needs_format_conversion(self, format=None):
1527
 
        """Format 4 dirs are always in need of conversion."""
1528
 
        if format is None:
1529
 
            symbol_versioning.warn(symbol_versioning.deprecated_in((1, 13, 0))
1530
 
                % 'needs_format_conversion(format=None)')
1531
 
        return True
1532
 
 
1533
 
    def open_repository(self):
1534
 
        """See BzrDir.open_repository."""
1535
 
        from bzrlib.repofmt.weaverepo import RepositoryFormat4
1536
 
        return RepositoryFormat4().open(self, _found=True)
1537
 
 
1538
 
 
1539
 
class BzrDir5(BzrDirPreSplitOut):
1540
 
    """A .bzr version 5 control object.
1541
 
 
1542
 
    This is a deprecated format and may be removed after sept 2006.
1543
 
    """
1544
 
 
1545
 
    def has_workingtree(self):
1546
 
        """See BzrDir.has_workingtree."""
1547
 
        return True
1548
 
    
1549
 
    def open_repository(self):
1550
 
        """See BzrDir.open_repository."""
1551
 
        from bzrlib.repofmt.weaverepo import RepositoryFormat5
1552
 
        return RepositoryFormat5().open(self, _found=True)
1553
 
 
1554
 
    def open_workingtree(self, _unsupported=False,
1555
 
            recommend_upgrade=True):
1556
 
        """See BzrDir.create_workingtree."""
1557
 
        from bzrlib.workingtree import WorkingTreeFormat2
1558
 
        wt_format = WorkingTreeFormat2()
1559
 
        # we don't warn here about upgrades; that ought to be handled for the
1560
 
        # bzrdir as a whole
1561
 
        return wt_format.open(self, _found=True)
1562
 
 
1563
 
 
1564
 
class BzrDir6(BzrDirPreSplitOut):
1565
 
    """A .bzr version 6 control object.
1566
 
 
1567
 
    This is a deprecated format and may be removed after sept 2006.
1568
 
    """
1569
 
 
1570
 
    def has_workingtree(self):
1571
 
        """See BzrDir.has_workingtree."""
1572
 
        return True
1573
 
    
1574
 
    def open_repository(self):
1575
 
        """See BzrDir.open_repository."""
1576
 
        from bzrlib.repofmt.weaverepo import RepositoryFormat6
1577
 
        return RepositoryFormat6().open(self, _found=True)
1578
 
 
1579
 
    def open_workingtree(self, _unsupported=False,
1580
 
        recommend_upgrade=True):
1581
 
        """See BzrDir.create_workingtree."""
1582
 
        # we don't warn here about upgrades; that ought to be handled for the
1583
 
        # bzrdir as a whole
1584
 
        from bzrlib.workingtree import WorkingTreeFormat2
1585
 
        return WorkingTreeFormat2().open(self, _found=True)
 
1129
            return "<%s for %s>" % (self.__class__.__name__,
 
1130
                self.bzrdir)
1586
1131
 
1587
1132
 
1588
1133
class BzrDirMeta1(BzrDir):
1598
1143
        """See BzrDir.can_convert_format()."""
1599
1144
        return True
1600
1145
 
1601
 
    def create_branch(self):
 
1146
    def create_branch(self, name=None, repository=None):
1602
1147
        """See BzrDir.create_branch."""
1603
 
        return self._format.get_branch_format().initialize(self)
 
1148
        return self._format.get_branch_format().initialize(self, name=name,
 
1149
                repository=repository)
1604
1150
 
1605
 
    def destroy_branch(self):
 
1151
    def destroy_branch(self, name=None):
1606
1152
        """See BzrDir.create_branch."""
 
1153
        if name is not None:
 
1154
            raise errors.NoColocatedBranchSupport(self)
1607
1155
        self.transport.delete_tree('branch')
1608
1156
 
1609
1157
    def create_repository(self, shared=False):
1626
1174
        wt = self.open_workingtree(recommend_upgrade=False)
1627
1175
        repository = wt.branch.repository
1628
1176
        empty = repository.revision_tree(_mod_revision.NULL_REVISION)
1629
 
        wt.revert(old_tree=empty)
 
1177
        # We ignore the conflicts returned by wt.revert since we're about to
 
1178
        # delete the wt metadata anyway, all that should be left here are
 
1179
        # detritus. But see bug #634470 about subtree .bzr dirs.
 
1180
        conflicts = wt.revert(old_tree=empty)
1630
1181
        self.destroy_workingtree_metadata()
1631
1182
 
1632
1183
    def destroy_workingtree_metadata(self):
1633
1184
        self.transport.delete_tree('checkout')
1634
1185
 
1635
 
    def find_branch_format(self):
 
1186
    def find_branch_format(self, name=None):
1636
1187
        """Find the branch 'format' for this bzrdir.
1637
1188
 
1638
1189
        This might be a synthetic object for e.g. RemoteBranch and SVN.
1639
1190
        """
1640
1191
        from bzrlib.branch import BranchFormat
1641
 
        return BranchFormat.find_format(self)
 
1192
        return BranchFormat.find_format(self, name=name)
1642
1193
 
1643
1194
    def _get_mkdir_mode(self):
1644
1195
        """Figure out the mode to use when creating a bzrdir subdir."""
1646
1197
                                     lockable_files.TransportLock)
1647
1198
        return temp_control._dir_mode
1648
1199
 
1649
 
    def get_branch_reference(self):
 
1200
    def get_branch_reference(self, name=None):
1650
1201
        """See BzrDir.get_branch_reference()."""
1651
1202
        from bzrlib.branch import BranchFormat
1652
 
        format = BranchFormat.find_format(self)
1653
 
        return format.get_reference(self)
 
1203
        format = BranchFormat.find_format(self, name=name)
 
1204
        return format.get_reference(self, name=name)
1654
1205
 
1655
 
    def get_branch_transport(self, branch_format):
 
1206
    def get_branch_transport(self, branch_format, name=None):
1656
1207
        """See BzrDir.get_branch_transport()."""
 
1208
        if name is not None:
 
1209
            raise errors.NoColocatedBranchSupport(self)
1657
1210
        # XXX: this shouldn't implicitly create the directory if it's just
1658
1211
        # promising to get a transport -- mbp 20090727
1659
1212
        if branch_format is None:
1699
1252
    def has_workingtree(self):
1700
1253
        """Tell if this bzrdir contains a working tree.
1701
1254
 
1702
 
        This will still raise an exception if the bzrdir has a workingtree that
1703
 
        is remote & inaccessible.
1704
 
 
1705
1255
        Note: if you're going to open the working tree, you should just go
1706
1256
        ahead and try, and not ask permission first.
1707
1257
        """
1708
1258
        from bzrlib.workingtree import WorkingTreeFormat
1709
1259
        try:
1710
 
            WorkingTreeFormat.find_format(self)
 
1260
            WorkingTreeFormat.find_format_string(self)
1711
1261
        except errors.NoWorkingTree:
1712
1262
            return False
1713
1263
        return True
1714
1264
 
1715
 
    def needs_format_conversion(self, format=None):
 
1265
    def needs_format_conversion(self, format):
1716
1266
        """See BzrDir.needs_format_conversion()."""
1717
 
        if format is None:
1718
 
            symbol_versioning.warn(symbol_versioning.deprecated_in((1, 13, 0))
1719
 
                % 'needs_format_conversion(format=None)')
1720
 
        if format is None:
1721
 
            format = BzrDirFormat.get_default_format()
1722
1267
        if not isinstance(self._format, format.__class__):
1723
1268
            # it is not a meta dir format, conversion is needed.
1724
1269
            return True
1730
1275
                return True
1731
1276
        except errors.NoRepositoryPresent:
1732
1277
            pass
1733
 
        try:
1734
 
            if not isinstance(self.open_branch()._format,
 
1278
        for branch in self.list_branches():
 
1279
            if not isinstance(branch._format,
1735
1280
                              format.get_branch_format().__class__):
1736
1281
                # the branch needs an upgrade.
1737
1282
                return True
1738
 
        except errors.NotBranchError:
1739
 
            pass
1740
1283
        try:
1741
1284
            my_wt = self.open_workingtree(recommend_upgrade=False)
1742
1285
            if not isinstance(my_wt._format,
1747
1290
            pass
1748
1291
        return False
1749
1292
 
1750
 
    def open_branch(self, unsupported=False, ignore_fallbacks=False):
 
1293
    def open_branch(self, name=None, unsupported=False,
 
1294
                    ignore_fallbacks=False):
1751
1295
        """See BzrDir.open_branch."""
1752
 
        format = self.find_branch_format()
1753
 
        self._check_supported(format, unsupported)
1754
 
        return format.open(self, _found=True, ignore_fallbacks=ignore_fallbacks)
 
1296
        format = self.find_branch_format(name=name)
 
1297
        format.check_support_status(unsupported)
 
1298
        return format.open(self, name=name,
 
1299
            _found=True, ignore_fallbacks=ignore_fallbacks)
1755
1300
 
1756
1301
    def open_repository(self, unsupported=False):
1757
1302
        """See BzrDir.open_repository."""
1758
1303
        from bzrlib.repository import RepositoryFormat
1759
1304
        format = RepositoryFormat.find_format(self)
1760
 
        self._check_supported(format, unsupported)
 
1305
        format.check_support_status(unsupported)
1761
1306
        return format.open(self, _found=True)
1762
1307
 
1763
1308
    def open_workingtree(self, unsupported=False,
1765
1310
        """See BzrDir.open_workingtree."""
1766
1311
        from bzrlib.workingtree import WorkingTreeFormat
1767
1312
        format = WorkingTreeFormat.find_format(self)
1768
 
        self._check_supported(format, unsupported,
1769
 
            recommend_upgrade,
 
1313
        format.check_support_status(unsupported, recommend_upgrade,
1770
1314
            basedir=self.root_transport.base)
1771
1315
        return format.open(self, _found=True)
1772
1316
 
1774
1318
        return config.TransportConfig(self.transport, 'control.conf')
1775
1319
 
1776
1320
 
1777
 
class BzrDirFormat(object):
1778
 
    """An encapsulation of the initialization and open routines for a format.
1779
 
 
1780
 
    Formats provide three things:
1781
 
     * An initialization routine,
1782
 
     * a format string,
1783
 
     * an open routine.
 
1321
class BzrProber(controldir.Prober):
 
1322
    """Prober for formats that use a .bzr/ control directory."""
 
1323
 
 
1324
    formats = registry.FormatRegistry(controldir.network_format_registry)
 
1325
    """The known .bzr formats."""
 
1326
 
 
1327
    @classmethod
 
1328
    @deprecated_method(deprecated_in((2, 4, 0)))
 
1329
    def register_bzrdir_format(klass, format):
 
1330
        klass.formats.register(format.get_format_string(), format)
 
1331
 
 
1332
    @classmethod
 
1333
    @deprecated_method(deprecated_in((2, 4, 0)))
 
1334
    def unregister_bzrdir_format(klass, format):
 
1335
        klass.formats.remove(format.get_format_string())
 
1336
 
 
1337
    @classmethod
 
1338
    def probe_transport(klass, transport):
 
1339
        """Return the .bzrdir style format present in a directory."""
 
1340
        try:
 
1341
            format_string = transport.get_bytes(".bzr/branch-format")
 
1342
        except errors.NoSuchFile:
 
1343
            raise errors.NotBranchError(path=transport.base)
 
1344
        try:
 
1345
            return klass.formats.get(format_string)
 
1346
        except KeyError:
 
1347
            raise errors.UnknownFormatError(format=format_string, kind='bzrdir')
 
1348
 
 
1349
    @classmethod
 
1350
    def known_formats(cls):
 
1351
        result = set()
 
1352
        for name, format in cls.formats.iteritems():
 
1353
            if callable(format):
 
1354
                format = format()
 
1355
            result.add(format)
 
1356
        return result
 
1357
 
 
1358
 
 
1359
controldir.ControlDirFormat.register_prober(BzrProber)
 
1360
 
 
1361
 
 
1362
class RemoteBzrProber(controldir.Prober):
 
1363
    """Prober for remote servers that provide a Bazaar smart server."""
 
1364
 
 
1365
    @classmethod
 
1366
    def probe_transport(klass, transport):
 
1367
        """Return a RemoteBzrDirFormat object if it looks possible."""
 
1368
        try:
 
1369
            medium = transport.get_smart_medium()
 
1370
        except (NotImplementedError, AttributeError,
 
1371
                errors.TransportNotPossible, errors.NoSmartMedium,
 
1372
                errors.SmartProtocolError):
 
1373
            # no smart server, so not a branch for this format type.
 
1374
            raise errors.NotBranchError(path=transport.base)
 
1375
        else:
 
1376
            # Decline to open it if the server doesn't support our required
 
1377
            # version (3) so that the VFS-based transport will do it.
 
1378
            if medium.should_probe():
 
1379
                try:
 
1380
                    server_version = medium.protocol_version()
 
1381
                except errors.SmartProtocolError:
 
1382
                    # Apparently there's no usable smart server there, even though
 
1383
                    # the medium supports the smart protocol.
 
1384
                    raise errors.NotBranchError(path=transport.base)
 
1385
                if server_version != '2':
 
1386
                    raise errors.NotBranchError(path=transport.base)
 
1387
            from bzrlib.remote import RemoteBzrDirFormat
 
1388
            return RemoteBzrDirFormat()
 
1389
 
 
1390
    @classmethod
 
1391
    def known_formats(cls):
 
1392
        from bzrlib.remote import RemoteBzrDirFormat
 
1393
        return set([RemoteBzrDirFormat()])
 
1394
 
 
1395
 
 
1396
class BzrDirFormat(controldir.ControlDirFormat):
 
1397
    """ControlDirFormat base class for .bzr/ directories.
1784
1398
 
1785
1399
    Formats are placed in a dict by their format string for reference
1786
1400
    during bzrdir opening. These should be subclasses of BzrDirFormat
1791
1405
    object will be created every system load.
1792
1406
    """
1793
1407
 
1794
 
    _default_format = None
1795
 
    """The default format used for new .bzr dirs."""
1796
 
 
1797
 
    _formats = {}
1798
 
    """The known formats."""
1799
 
 
1800
 
    _control_formats = []
1801
 
    """The registered control formats - .bzr, ....
1802
 
 
1803
 
    This is a list of BzrDirFormat objects.
1804
 
    """
1805
 
 
1806
 
    _control_server_formats = []
1807
 
    """The registered control server formats, e.g. RemoteBzrDirs.
1808
 
 
1809
 
    This is a list of BzrDirFormat objects.
1810
 
    """
1811
 
 
1812
1408
    _lock_file_name = 'branch-lock'
1813
1409
 
1814
1410
    # _lock_class must be set in subclasses to the lock type, typ.
1815
1411
    # TransportLock or LockDir
1816
1412
 
1817
1413
    @classmethod
1818
 
    def find_format(klass, transport, _server_formats=True):
1819
 
        """Return the format present at transport."""
1820
 
        if _server_formats:
1821
 
            formats = klass._control_server_formats + klass._control_formats
1822
 
        else:
1823
 
            formats = klass._control_formats
1824
 
        for format in formats:
1825
 
            try:
1826
 
                return format.probe_transport(transport)
1827
 
            except errors.NotBranchError:
1828
 
                # this format does not find a control dir here.
1829
 
                pass
1830
 
        raise errors.NotBranchError(path=transport.base)
1831
 
 
1832
 
    @classmethod
1833
 
    def probe_transport(klass, transport):
1834
 
        """Return the .bzrdir style format present in a directory."""
1835
 
        try:
1836
 
            format_string = transport.get_bytes(".bzr/branch-format")
1837
 
        except errors.NoSuchFile:
1838
 
            raise errors.NotBranchError(path=transport.base)
1839
 
 
1840
 
        try:
1841
 
            return klass._formats[format_string]
1842
 
        except KeyError:
1843
 
            raise errors.UnknownFormatError(format=format_string, kind='bzrdir')
1844
 
 
1845
 
    @classmethod
1846
 
    def get_default_format(klass):
1847
 
        """Return the current default format."""
1848
 
        return klass._default_format
1849
 
 
1850
 
    def get_format_string(self):
 
1414
    def get_format_string(cls):
1851
1415
        """Return the ASCII format string that identifies this format."""
1852
1416
        raise NotImplementedError(self.get_format_string)
1853
1417
 
1854
 
    def get_format_description(self):
1855
 
        """Return the short description for this format."""
1856
 
        raise NotImplementedError(self.get_format_description)
1857
 
 
1858
 
    def get_converter(self, format=None):
1859
 
        """Return the converter to use to convert bzrdirs needing converts.
1860
 
 
1861
 
        This returns a bzrlib.bzrdir.Converter object.
1862
 
 
1863
 
        This should return the best upgrader to step this format towards the
1864
 
        current default format. In the case of plugins we can/should provide
1865
 
        some means for them to extend the range of returnable converters.
1866
 
 
1867
 
        :param format: Optional format to override the default format of the
1868
 
                       library.
1869
 
        """
1870
 
        raise NotImplementedError(self.get_converter)
1871
 
 
1872
 
    def initialize(self, url, possible_transports=None):
1873
 
        """Create a bzr control dir at this url and return an opened copy.
1874
 
 
1875
 
        While not deprecated, this method is very specific and its use will
1876
 
        lead to many round trips to setup a working environment. See
1877
 
        initialize_on_transport_ex for a [nearly] all-in-one method.
1878
 
 
1879
 
        Subclasses should typically override initialize_on_transport
1880
 
        instead of this method.
1881
 
        """
1882
 
        return self.initialize_on_transport(get_transport(url,
1883
 
                                                          possible_transports))
1884
 
 
1885
1418
    def initialize_on_transport(self, transport):
1886
1419
        """Initialize a new bzrdir in the base directory of a Transport."""
1887
1420
        try:
1896
1429
            # metadir1
1897
1430
            if type(self) != BzrDirMetaFormat1:
1898
1431
                return self._initialize_on_transport_vfs(transport)
 
1432
            from bzrlib.remote import RemoteBzrDirFormat
1899
1433
            remote_format = RemoteBzrDirFormat()
1900
1434
            self._supply_sub_formats_to(remote_format)
1901
1435
            return remote_format.initialize_on_transport(transport)
1939
1473
            except errors.NoSmartMedium:
1940
1474
                pass
1941
1475
            else:
 
1476
                from bzrlib.remote import RemoteBzrDirFormat
1942
1477
                # TODO: lookup the local format from a server hint.
1943
1478
                remote_dir_format = RemoteBzrDirFormat()
1944
1479
                remote_dir_format._network_name = self.network_name()
2019
1554
        utf8_files = [('README',
2020
1555
                       "This is a Bazaar control directory.\n"
2021
1556
                       "Do not change any files in this directory.\n"
2022
 
                       "See http://bazaar-vcs.org/ for more information about Bazaar.\n"),
 
1557
                       "See http://bazaar.canonical.com/ for more information about Bazaar.\n"),
2023
1558
                      ('branch-format', self.get_format_string()),
2024
1559
                      ]
2025
1560
        # NB: no need to escape relative paths that are url safe.
2035
1570
            control_files.unlock()
2036
1571
        return self.open(transport, _found=True)
2037
1572
 
2038
 
    def is_supported(self):
2039
 
        """Is this format supported?
2040
 
 
2041
 
        Supported formats must be initializable and openable.
2042
 
        Unsupported formats may not support initialization or committing or
2043
 
        some other features depending on the reason for not being supported.
2044
 
        """
2045
 
        return True
2046
 
 
2047
 
    def network_name(self):
2048
 
        """A simple byte string uniquely identifying this format for RPC calls.
2049
 
 
2050
 
        Bzr control formats use thir disk format string to identify the format
2051
 
        over the wire. Its possible that other control formats have more
2052
 
        complex detection requirements, so we permit them to use any unique and
2053
 
        immutable string they desire.
2054
 
        """
2055
 
        raise NotImplementedError(self.network_name)
2056
 
 
2057
 
    def same_model(self, target_format):
2058
 
        return (self.repository_format.rich_root_data ==
2059
 
            target_format.rich_root_data)
2060
 
 
2061
 
    @classmethod
2062
 
    def known_formats(klass):
2063
 
        """Return all the known formats.
2064
 
 
2065
 
        Concrete formats should override _known_formats.
2066
 
        """
2067
 
        # There is double indirection here to make sure that control
2068
 
        # formats used by more than one dir format will only be probed
2069
 
        # once. This can otherwise be quite expensive for remote connections.
2070
 
        result = set()
2071
 
        for format in klass._control_formats:
2072
 
            result.update(format._known_formats())
2073
 
        return result
2074
 
 
2075
 
    @classmethod
2076
 
    def _known_formats(klass):
2077
 
        """Return the known format instances for this control format."""
2078
 
        return set(klass._formats.values())
2079
 
 
2080
1573
    def open(self, transport, _found=False):
2081
1574
        """Return an instance of this format for the dir transport points at.
2082
1575
 
2083
1576
        _found is a private parameter, do not use it.
2084
1577
        """
2085
1578
        if not _found:
2086
 
            found_format = BzrDirFormat.find_format(transport)
 
1579
            found_format = controldir.ControlDirFormat.find_format(transport)
2087
1580
            if not isinstance(found_format, self.__class__):
2088
1581
                raise AssertionError("%s was asked to open %s, but it seems to need "
2089
1582
                        "format %s"
2101
1594
        """
2102
1595
        raise NotImplementedError(self._open)
2103
1596
 
2104
 
    @classmethod
2105
 
    def register_format(klass, format):
2106
 
        klass._formats[format.get_format_string()] = format
2107
 
        # bzr native formats have a network name of their format string.
2108
 
        network_format_registry.register(format.get_format_string(), format.__class__)
2109
 
 
2110
 
    @classmethod
2111
 
    def register_control_format(klass, format):
2112
 
        """Register a format that does not use '.bzr' for its control dir.
2113
 
 
2114
 
        TODO: This should be pulled up into a 'ControlDirFormat' base class
2115
 
        which BzrDirFormat can inherit from, and renamed to register_format
2116
 
        there. It has been done without that for now for simplicity of
2117
 
        implementation.
2118
 
        """
2119
 
        klass._control_formats.append(format)
2120
 
 
2121
 
    @classmethod
2122
 
    def register_control_server_format(klass, format):
2123
 
        """Register a control format for client-server environments.
2124
 
 
2125
 
        These formats will be tried before ones registered with
2126
 
        register_control_format.  This gives implementations that decide to the
2127
 
        chance to grab it before anything looks at the contents of the format
2128
 
        file.
2129
 
        """
2130
 
        klass._control_server_formats.append(format)
2131
 
 
2132
 
    @classmethod
2133
 
    def _set_default_format(klass, format):
2134
 
        """Set default format (for testing behavior of defaults only)"""
2135
 
        klass._default_format = format
2136
 
 
2137
 
    def __str__(self):
2138
 
        # Trim the newline
2139
 
        return self.get_format_description().rstrip()
2140
 
 
2141
1597
    def _supply_sub_formats_to(self, other_format):
2142
1598
        """Give other_format the same values for sub formats as this has.
2143
1599
 
2150
1606
        :return: None.
2151
1607
        """
2152
1608
 
2153
 
    @classmethod
2154
 
    def unregister_format(klass, format):
2155
 
        del klass._formats[format.get_format_string()]
2156
 
 
2157
 
    @classmethod
2158
 
    def unregister_control_format(klass, format):
2159
 
        klass._control_formats.remove(format)
2160
 
 
2161
 
 
2162
 
class BzrDirFormat4(BzrDirFormat):
2163
 
    """Bzr dir format 4.
2164
 
 
2165
 
    This format is a combined format for working tree, branch and repository.
2166
 
    It has:
2167
 
     - Format 1 working trees [always]
2168
 
     - Format 4 branches [always]
2169
 
     - Format 4 repositories [always]
2170
 
 
2171
 
    This format is deprecated: it indexes texts using a text it which is
2172
 
    removed in format 5; write support for this format has been removed.
2173
 
    """
2174
 
 
2175
 
    _lock_class = lockable_files.TransportLock
2176
 
 
2177
 
    def get_format_string(self):
2178
 
        """See BzrDirFormat.get_format_string()."""
2179
 
        return "Bazaar-NG branch, format 0.0.4\n"
2180
 
 
2181
 
    def get_format_description(self):
2182
 
        """See BzrDirFormat.get_format_description()."""
2183
 
        return "All-in-one format 4"
2184
 
 
2185
 
    def get_converter(self, format=None):
2186
 
        """See BzrDirFormat.get_converter()."""
2187
 
        # there is one and only one upgrade path here.
2188
 
        return ConvertBzrDir4To5()
2189
 
 
2190
 
    def initialize_on_transport(self, transport):
2191
 
        """Format 4 branches cannot be created."""
2192
 
        raise errors.UninitializableFormat(self)
2193
 
 
2194
 
    def is_supported(self):
2195
 
        """Format 4 is not supported.
2196
 
 
2197
 
        It is not supported because the model changed from 4 to 5 and the
2198
 
        conversion logic is expensive - so doing it on the fly was not
2199
 
        feasible.
2200
 
        """
2201
 
        return False
2202
 
 
2203
 
    def network_name(self):
2204
 
        return self.get_format_string()
2205
 
 
2206
 
    def _open(self, transport):
2207
 
        """See BzrDirFormat._open."""
2208
 
        return BzrDir4(transport, self)
2209
 
 
2210
 
    def __return_repository_format(self):
2211
 
        """Circular import protection."""
2212
 
        from bzrlib.repofmt.weaverepo import RepositoryFormat4
2213
 
        return RepositoryFormat4()
2214
 
    repository_format = property(__return_repository_format)
2215
 
 
2216
 
 
2217
 
class BzrDirFormatAllInOne(BzrDirFormat):
2218
 
    """Common class for formats before meta-dirs."""
2219
 
 
2220
 
    def initialize_on_transport_ex(self, transport, use_existing_dir=False,
2221
 
        create_prefix=False, force_new_repo=False, stacked_on=None,
2222
 
        stack_on_pwd=None, repo_format_name=None, make_working_trees=None,
2223
 
        shared_repo=False):
2224
 
        """See BzrDirFormat.initialize_on_transport_ex."""
2225
 
        require_stacking = (stacked_on is not None)
2226
 
        # Format 5 cannot stack, but we've been asked to - actually init
2227
 
        # a Meta1Dir
2228
 
        if require_stacking:
2229
 
            format = BzrDirMetaFormat1()
2230
 
            return format.initialize_on_transport_ex(transport,
2231
 
                use_existing_dir=use_existing_dir, create_prefix=create_prefix,
2232
 
                force_new_repo=force_new_repo, stacked_on=stacked_on,
2233
 
                stack_on_pwd=stack_on_pwd, repo_format_name=repo_format_name,
2234
 
                make_working_trees=make_working_trees, shared_repo=shared_repo)
2235
 
        return BzrDirFormat.initialize_on_transport_ex(self, transport,
2236
 
            use_existing_dir=use_existing_dir, create_prefix=create_prefix,
2237
 
            force_new_repo=force_new_repo, stacked_on=stacked_on,
2238
 
            stack_on_pwd=stack_on_pwd, repo_format_name=repo_format_name,
2239
 
            make_working_trees=make_working_trees, shared_repo=shared_repo)
2240
 
 
2241
 
 
2242
 
class BzrDirFormat5(BzrDirFormatAllInOne):
2243
 
    """Bzr control format 5.
2244
 
 
2245
 
    This format is a combined format for working tree, branch and repository.
2246
 
    It has:
2247
 
     - Format 2 working trees [always]
2248
 
     - Format 4 branches [always]
2249
 
     - Format 5 repositories [always]
2250
 
       Unhashed stores in the repository.
2251
 
    """
2252
 
 
2253
 
    _lock_class = lockable_files.TransportLock
2254
 
 
2255
 
    def get_format_string(self):
2256
 
        """See BzrDirFormat.get_format_string()."""
2257
 
        return "Bazaar-NG branch, format 5\n"
2258
 
 
2259
 
    def get_branch_format(self):
2260
 
        from bzrlib import branch
2261
 
        return branch.BzrBranchFormat4()
2262
 
 
2263
 
    def get_format_description(self):
2264
 
        """See BzrDirFormat.get_format_description()."""
2265
 
        return "All-in-one format 5"
2266
 
 
2267
 
    def get_converter(self, format=None):
2268
 
        """See BzrDirFormat.get_converter()."""
2269
 
        # there is one and only one upgrade path here.
2270
 
        return ConvertBzrDir5To6()
2271
 
 
2272
 
    def _initialize_for_clone(self, url):
2273
 
        return self.initialize_on_transport(get_transport(url), _cloning=True)
2274
 
 
2275
 
    def initialize_on_transport(self, transport, _cloning=False):
2276
 
        """Format 5 dirs always have working tree, branch and repository.
2277
 
 
2278
 
        Except when they are being cloned.
2279
 
        """
2280
 
        from bzrlib.branch import BzrBranchFormat4
2281
 
        from bzrlib.repofmt.weaverepo import RepositoryFormat5
2282
 
        result = (super(BzrDirFormat5, self).initialize_on_transport(transport))
2283
 
        RepositoryFormat5().initialize(result, _internal=True)
2284
 
        if not _cloning:
2285
 
            branch = BzrBranchFormat4().initialize(result)
2286
 
            result._init_workingtree()
2287
 
        return result
2288
 
 
2289
 
    def network_name(self):
2290
 
        return self.get_format_string()
2291
 
 
2292
 
    def _open(self, transport):
2293
 
        """See BzrDirFormat._open."""
2294
 
        return BzrDir5(transport, self)
2295
 
 
2296
 
    def __return_repository_format(self):
2297
 
        """Circular import protection."""
2298
 
        from bzrlib.repofmt.weaverepo import RepositoryFormat5
2299
 
        return RepositoryFormat5()
2300
 
    repository_format = property(__return_repository_format)
2301
 
 
2302
 
 
2303
 
class BzrDirFormat6(BzrDirFormatAllInOne):
2304
 
    """Bzr control format 6.
2305
 
 
2306
 
    This format is a combined format for working tree, branch and repository.
2307
 
    It has:
2308
 
     - Format 2 working trees [always]
2309
 
     - Format 4 branches [always]
2310
 
     - Format 6 repositories [always]
2311
 
    """
2312
 
 
2313
 
    _lock_class = lockable_files.TransportLock
2314
 
 
2315
 
    def get_format_string(self):
2316
 
        """See BzrDirFormat.get_format_string()."""
2317
 
        return "Bazaar-NG branch, format 6\n"
2318
 
 
2319
 
    def get_format_description(self):
2320
 
        """See BzrDirFormat.get_format_description()."""
2321
 
        return "All-in-one format 6"
2322
 
 
2323
 
    def get_branch_format(self):
2324
 
        from bzrlib import branch
2325
 
        return branch.BzrBranchFormat4()
2326
 
 
2327
 
    def get_converter(self, format=None):
2328
 
        """See BzrDirFormat.get_converter()."""
2329
 
        # there is one and only one upgrade path here.
2330
 
        return ConvertBzrDir6ToMeta()
2331
 
 
2332
 
    def _initialize_for_clone(self, url):
2333
 
        return self.initialize_on_transport(get_transport(url), _cloning=True)
2334
 
 
2335
 
    def initialize_on_transport(self, transport, _cloning=False):
2336
 
        """Format 6 dirs always have working tree, branch and repository.
2337
 
 
2338
 
        Except when they are being cloned.
2339
 
        """
2340
 
        from bzrlib.branch import BzrBranchFormat4
2341
 
        from bzrlib.repofmt.weaverepo import RepositoryFormat6
2342
 
        result = super(BzrDirFormat6, self).initialize_on_transport(transport)
2343
 
        RepositoryFormat6().initialize(result, _internal=True)
2344
 
        if not _cloning:
2345
 
            branch = BzrBranchFormat4().initialize(result)
2346
 
            result._init_workingtree()
2347
 
        return result
2348
 
 
2349
 
    def network_name(self):
2350
 
        return self.get_format_string()
2351
 
 
2352
 
    def _open(self, transport):
2353
 
        """See BzrDirFormat._open."""
2354
 
        return BzrDir6(transport, self)
2355
 
 
2356
 
    def __return_repository_format(self):
2357
 
        """Circular import protection."""
2358
 
        from bzrlib.repofmt.weaverepo import RepositoryFormat6
2359
 
        return RepositoryFormat6()
2360
 
    repository_format = property(__return_repository_format)
2361
 
 
2362
1609
 
2363
1610
class BzrDirMetaFormat1(BzrDirFormat):
2364
1611
    """Bzr meta control format 1
2373
1620
 
2374
1621
    _lock_class = lockdir.LockDir
2375
1622
 
 
1623
    fixed_components = False
 
1624
 
2376
1625
    def __init__(self):
2377
1626
        self._workingtree_format = None
2378
1627
        self._branch_format = None
2392
1641
 
2393
1642
    def get_branch_format(self):
2394
1643
        if self._branch_format is None:
2395
 
            from bzrlib.branch import BranchFormat
2396
 
            self._branch_format = BranchFormat.get_default_format()
 
1644
            from bzrlib.branch import format_registry as branch_format_registry
 
1645
            self._branch_format = branch_format_registry.get_default()
2397
1646
        return self._branch_format
2398
1647
 
2399
1648
    def set_branch_format(self, format):
2454
1703
                    # stack_on is inaccessible, JFDI.
2455
1704
                    # TODO: bad monkey, hard-coded formats...
2456
1705
                    if self.repository_format.rich_root_data:
2457
 
                        new_repo_format = pack_repo.RepositoryFormatKnitPack5RichRoot()
 
1706
                        new_repo_format = knitpack_repo.RepositoryFormatKnitPack5RichRoot()
2458
1707
                    else:
2459
 
                        new_repo_format = pack_repo.RepositoryFormatKnitPack5()
 
1708
                        new_repo_format = knitpack_repo.RepositoryFormatKnitPack5()
2460
1709
            else:
2461
1710
                # If the target already supports stacking, then we know the
2462
1711
                # project is already able to use stacking, so auto-upgrade
2479
1728
            if target_branch is None:
2480
1729
                if do_upgrade:
2481
1730
                    # TODO: bad monkey, hard-coded formats...
2482
 
                    new_branch_format = branch.BzrBranchFormat7()
 
1731
                    from bzrlib.branch import BzrBranchFormat7
 
1732
                    new_branch_format = BzrBranchFormat7()
2483
1733
            else:
2484
1734
                new_branch_format = target_branch._format
2485
1735
                if not new_branch_format.supports_stacking():
2500
1750
            raise NotImplementedError(self.get_converter)
2501
1751
        return ConvertMetaToMeta(format)
2502
1752
 
2503
 
    def get_format_string(self):
 
1753
    @classmethod
 
1754
    def get_format_string(cls):
2504
1755
        """See BzrDirFormat.get_format_string()."""
2505
1756
        return "Bazaar-NG meta directory, format 1\n"
2506
1757
 
2524
1775
        """Circular import protection."""
2525
1776
        if self._repository_format:
2526
1777
            return self._repository_format
2527
 
        from bzrlib.repository import RepositoryFormat
2528
 
        return RepositoryFormat.get_default_format()
 
1778
        from bzrlib.repository import format_registry
 
1779
        return format_registry.get_default()
2529
1780
 
2530
1781
    def _set_repository_format(self, value):
2531
1782
        """Allow changing the repository format for metadir formats."""
2554
1805
 
2555
1806
    def __get_workingtree_format(self):
2556
1807
        if self._workingtree_format is None:
2557
 
            from bzrlib.workingtree import WorkingTreeFormat
2558
 
            self._workingtree_format = WorkingTreeFormat.get_default_format()
 
1808
            from bzrlib.workingtree import (
 
1809
                format_registry as wt_format_registry,
 
1810
                )
 
1811
            self._workingtree_format = wt_format_registry.get_default()
2559
1812
        return self._workingtree_format
2560
1813
 
2561
1814
    def __set_workingtree_format(self, wt_format):
2565
1818
                                  __set_workingtree_format)
2566
1819
 
2567
1820
 
2568
 
network_format_registry = registry.FormatRegistry()
2569
 
"""Registry of formats indexed by their network name.
2570
 
 
2571
 
The network name for a BzrDirFormat is an identifier that can be used when
2572
 
referring to formats with smart server operations. See
2573
 
BzrDirFormat.network_name() for more detail.
2574
 
"""
2575
 
 
2576
 
 
2577
 
# Register bzr control format
2578
 
BzrDirFormat.register_control_format(BzrDirFormat)
2579
 
 
2580
1821
# Register bzr formats
2581
 
BzrDirFormat.register_format(BzrDirFormat4())
2582
 
BzrDirFormat.register_format(BzrDirFormat5())
2583
 
BzrDirFormat.register_format(BzrDirFormat6())
2584
 
__default_format = BzrDirMetaFormat1()
2585
 
BzrDirFormat.register_format(__default_format)
2586
 
BzrDirFormat._default_format = __default_format
2587
 
 
2588
 
 
2589
 
class Converter(object):
2590
 
    """Converts a disk format object from one format to another."""
2591
 
 
2592
 
    def convert(self, to_convert, pb):
2593
 
        """Perform the conversion of to_convert, giving feedback via pb.
2594
 
 
2595
 
        :param to_convert: The disk object to convert.
2596
 
        :param pb: a progress bar to use for progress information.
2597
 
        """
2598
 
 
2599
 
    def step(self, message):
2600
 
        """Update the pb by a step."""
2601
 
        self.count +=1
2602
 
        self.pb.update(message, self.count, self.total)
2603
 
 
2604
 
 
2605
 
class ConvertBzrDir4To5(Converter):
2606
 
    """Converts format 4 bzr dirs to format 5."""
2607
 
 
2608
 
    def __init__(self):
2609
 
        super(ConvertBzrDir4To5, self).__init__()
2610
 
        self.converted_revs = set()
2611
 
        self.absent_revisions = set()
2612
 
        self.text_count = 0
2613
 
        self.revisions = {}
2614
 
 
2615
 
    def convert(self, to_convert, pb):
2616
 
        """See Converter.convert()."""
2617
 
        self.bzrdir = to_convert
2618
 
        if pb is not None:
2619
 
            warnings.warn("pb parameter to convert() is deprecated")
2620
 
        self.pb = ui.ui_factory.nested_progress_bar()
2621
 
        try:
2622
 
            ui.ui_factory.note('starting upgrade from format 4 to 5')
2623
 
            if isinstance(self.bzrdir.transport, local.LocalTransport):
2624
 
                self.bzrdir.get_workingtree_transport(None).delete('stat-cache')
2625
 
            self._convert_to_weaves()
2626
 
            return BzrDir.open(self.bzrdir.root_transport.base)
2627
 
        finally:
2628
 
            self.pb.finished()
2629
 
 
2630
 
    def _convert_to_weaves(self):
2631
 
        ui.ui_factory.note('note: upgrade may be faster if all store files are ungzipped first')
2632
 
        try:
2633
 
            # TODO permissions
2634
 
            stat = self.bzrdir.transport.stat('weaves')
2635
 
            if not S_ISDIR(stat.st_mode):
2636
 
                self.bzrdir.transport.delete('weaves')
2637
 
                self.bzrdir.transport.mkdir('weaves')
2638
 
        except errors.NoSuchFile:
2639
 
            self.bzrdir.transport.mkdir('weaves')
2640
 
        # deliberately not a WeaveFile as we want to build it up slowly.
2641
 
        self.inv_weave = Weave('inventory')
2642
 
        # holds in-memory weaves for all files
2643
 
        self.text_weaves = {}
2644
 
        self.bzrdir.transport.delete('branch-format')
2645
 
        self.branch = self.bzrdir.open_branch()
2646
 
        self._convert_working_inv()
2647
 
        rev_history = self.branch.revision_history()
2648
 
        # to_read is a stack holding the revisions we still need to process;
2649
 
        # appending to it adds new highest-priority revisions
2650
 
        self.known_revisions = set(rev_history)
2651
 
        self.to_read = rev_history[-1:]
2652
 
        while self.to_read:
2653
 
            rev_id = self.to_read.pop()
2654
 
            if (rev_id not in self.revisions
2655
 
                and rev_id not in self.absent_revisions):
2656
 
                self._load_one_rev(rev_id)
2657
 
        self.pb.clear()
2658
 
        to_import = self._make_order()
2659
 
        for i, rev_id in enumerate(to_import):
2660
 
            self.pb.update('converting revision', i, len(to_import))
2661
 
            self._convert_one_rev(rev_id)
2662
 
        self.pb.clear()
2663
 
        self._write_all_weaves()
2664
 
        self._write_all_revs()
2665
 
        ui.ui_factory.note('upgraded to weaves:')
2666
 
        ui.ui_factory.note('  %6d revisions and inventories' % len(self.revisions))
2667
 
        ui.ui_factory.note('  %6d revisions not present' % len(self.absent_revisions))
2668
 
        ui.ui_factory.note('  %6d texts' % self.text_count)
2669
 
        self._cleanup_spare_files_after_format4()
2670
 
        self.branch._transport.put_bytes(
2671
 
            'branch-format',
2672
 
            BzrDirFormat5().get_format_string(),
2673
 
            mode=self.bzrdir._get_file_mode())
2674
 
 
2675
 
    def _cleanup_spare_files_after_format4(self):
2676
 
        # FIXME working tree upgrade foo.
2677
 
        for n in 'merged-patches', 'pending-merged-patches':
2678
 
            try:
2679
 
                ## assert os.path.getsize(p) == 0
2680
 
                self.bzrdir.transport.delete(n)
2681
 
            except errors.NoSuchFile:
2682
 
                pass
2683
 
        self.bzrdir.transport.delete_tree('inventory-store')
2684
 
        self.bzrdir.transport.delete_tree('text-store')
2685
 
 
2686
 
    def _convert_working_inv(self):
2687
 
        inv = xml4.serializer_v4.read_inventory(
2688
 
                self.branch._transport.get('inventory'))
2689
 
        new_inv_xml = xml5.serializer_v5.write_inventory_to_string(inv, working=True)
2690
 
        self.branch._transport.put_bytes('inventory', new_inv_xml,
2691
 
            mode=self.bzrdir._get_file_mode())
2692
 
 
2693
 
    def _write_all_weaves(self):
2694
 
        controlweaves = WeaveStore(self.bzrdir.transport, prefixed=False)
2695
 
        weave_transport = self.bzrdir.transport.clone('weaves')
2696
 
        weaves = WeaveStore(weave_transport, prefixed=False)
2697
 
        transaction = WriteTransaction()
2698
 
 
2699
 
        try:
2700
 
            i = 0
2701
 
            for file_id, file_weave in self.text_weaves.items():
2702
 
                self.pb.update('writing weave', i, len(self.text_weaves))
2703
 
                weaves._put_weave(file_id, file_weave, transaction)
2704
 
                i += 1
2705
 
            self.pb.update('inventory', 0, 1)
2706
 
            controlweaves._put_weave('inventory', self.inv_weave, transaction)
2707
 
            self.pb.update('inventory', 1, 1)
2708
 
        finally:
2709
 
            self.pb.clear()
2710
 
 
2711
 
    def _write_all_revs(self):
2712
 
        """Write all revisions out in new form."""
2713
 
        self.bzrdir.transport.delete_tree('revision-store')
2714
 
        self.bzrdir.transport.mkdir('revision-store')
2715
 
        revision_transport = self.bzrdir.transport.clone('revision-store')
2716
 
        # TODO permissions
2717
 
        from bzrlib.xml5 import serializer_v5
2718
 
        from bzrlib.repofmt.weaverepo import RevisionTextStore
2719
 
        revision_store = RevisionTextStore(revision_transport,
2720
 
            serializer_v5, False, versionedfile.PrefixMapper(),
2721
 
            lambda:True, lambda:True)
2722
 
        try:
2723
 
            for i, rev_id in enumerate(self.converted_revs):
2724
 
                self.pb.update('write revision', i, len(self.converted_revs))
2725
 
                text = serializer_v5.write_revision_to_string(
2726
 
                    self.revisions[rev_id])
2727
 
                key = (rev_id,)
2728
 
                revision_store.add_lines(key, None, osutils.split_lines(text))
2729
 
        finally:
2730
 
            self.pb.clear()
2731
 
 
2732
 
    def _load_one_rev(self, rev_id):
2733
 
        """Load a revision object into memory.
2734
 
 
2735
 
        Any parents not either loaded or abandoned get queued to be
2736
 
        loaded."""
2737
 
        self.pb.update('loading revision',
2738
 
                       len(self.revisions),
2739
 
                       len(self.known_revisions))
2740
 
        if not self.branch.repository.has_revision(rev_id):
2741
 
            self.pb.clear()
2742
 
            ui.ui_factory.note('revision {%s} not present in branch; '
2743
 
                         'will be converted as a ghost' %
2744
 
                         rev_id)
2745
 
            self.absent_revisions.add(rev_id)
2746
 
        else:
2747
 
            rev = self.branch.repository.get_revision(rev_id)
2748
 
            for parent_id in rev.parent_ids:
2749
 
                self.known_revisions.add(parent_id)
2750
 
                self.to_read.append(parent_id)
2751
 
            self.revisions[rev_id] = rev
2752
 
 
2753
 
    def _load_old_inventory(self, rev_id):
2754
 
        old_inv_xml = self.branch.repository.inventory_store.get(rev_id).read()
2755
 
        inv = xml4.serializer_v4.read_inventory_from_string(old_inv_xml)
2756
 
        inv.revision_id = rev_id
2757
 
        rev = self.revisions[rev_id]
2758
 
        return inv
2759
 
 
2760
 
    def _load_updated_inventory(self, rev_id):
2761
 
        inv_xml = self.inv_weave.get_text(rev_id)
2762
 
        inv = xml5.serializer_v5.read_inventory_from_string(inv_xml, rev_id)
2763
 
        return inv
2764
 
 
2765
 
    def _convert_one_rev(self, rev_id):
2766
 
        """Convert revision and all referenced objects to new format."""
2767
 
        rev = self.revisions[rev_id]
2768
 
        inv = self._load_old_inventory(rev_id)
2769
 
        present_parents = [p for p in rev.parent_ids
2770
 
                           if p not in self.absent_revisions]
2771
 
        self._convert_revision_contents(rev, inv, present_parents)
2772
 
        self._store_new_inv(rev, inv, present_parents)
2773
 
        self.converted_revs.add(rev_id)
2774
 
 
2775
 
    def _store_new_inv(self, rev, inv, present_parents):
2776
 
        new_inv_xml = xml5.serializer_v5.write_inventory_to_string(inv)
2777
 
        new_inv_sha1 = sha_string(new_inv_xml)
2778
 
        self.inv_weave.add_lines(rev.revision_id,
2779
 
                                 present_parents,
2780
 
                                 new_inv_xml.splitlines(True))
2781
 
        rev.inventory_sha1 = new_inv_sha1
2782
 
 
2783
 
    def _convert_revision_contents(self, rev, inv, present_parents):
2784
 
        """Convert all the files within a revision.
2785
 
 
2786
 
        Also upgrade the inventory to refer to the text revision ids."""
2787
 
        rev_id = rev.revision_id
2788
 
        mutter('converting texts of revision {%s}',
2789
 
               rev_id)
2790
 
        parent_invs = map(self._load_updated_inventory, present_parents)
2791
 
        entries = inv.iter_entries()
2792
 
        entries.next()
2793
 
        for path, ie in entries:
2794
 
            self._convert_file_version(rev, ie, parent_invs)
2795
 
 
2796
 
    def _convert_file_version(self, rev, ie, parent_invs):
2797
 
        """Convert one version of one file.
2798
 
 
2799
 
        The file needs to be added into the weave if it is a merge
2800
 
        of >=2 parents or if it's changed from its parent.
2801
 
        """
2802
 
        file_id = ie.file_id
2803
 
        rev_id = rev.revision_id
2804
 
        w = self.text_weaves.get(file_id)
2805
 
        if w is None:
2806
 
            w = Weave(file_id)
2807
 
            self.text_weaves[file_id] = w
2808
 
        text_changed = False
2809
 
        parent_candiate_entries = ie.parent_candidates(parent_invs)
2810
 
        heads = graph.Graph(self).heads(parent_candiate_entries.keys())
2811
 
        # XXX: Note that this is unordered - and this is tolerable because
2812
 
        # the previous code was also unordered.
2813
 
        previous_entries = dict((head, parent_candiate_entries[head]) for head
2814
 
            in heads)
2815
 
        self.snapshot_ie(previous_entries, ie, w, rev_id)
2816
 
        del ie.text_id
2817
 
 
2818
 
    def get_parent_map(self, revision_ids):
2819
 
        """See graph.StackedParentsProvider.get_parent_map"""
2820
 
        return dict((revision_id, self.revisions[revision_id])
2821
 
                    for revision_id in revision_ids
2822
 
                     if revision_id in self.revisions)
2823
 
 
2824
 
    def snapshot_ie(self, previous_revisions, ie, w, rev_id):
2825
 
        # TODO: convert this logic, which is ~= snapshot to
2826
 
        # a call to:. This needs the path figured out. rather than a work_tree
2827
 
        # a v4 revision_tree can be given, or something that looks enough like
2828
 
        # one to give the file content to the entry if it needs it.
2829
 
        # and we need something that looks like a weave store for snapshot to
2830
 
        # save against.
2831
 
        #ie.snapshot(rev, PATH, previous_revisions, REVISION_TREE, InMemoryWeaveStore(self.text_weaves))
2832
 
        if len(previous_revisions) == 1:
2833
 
            previous_ie = previous_revisions.values()[0]
2834
 
            if ie._unchanged(previous_ie):
2835
 
                ie.revision = previous_ie.revision
2836
 
                return
2837
 
        if ie.has_text():
2838
 
            text = self.branch.repository._text_store.get(ie.text_id)
2839
 
            file_lines = text.readlines()
2840
 
            w.add_lines(rev_id, previous_revisions, file_lines)
2841
 
            self.text_count += 1
2842
 
        else:
2843
 
            w.add_lines(rev_id, previous_revisions, [])
2844
 
        ie.revision = rev_id
2845
 
 
2846
 
    def _make_order(self):
2847
 
        """Return a suitable order for importing revisions.
2848
 
 
2849
 
        The order must be such that an revision is imported after all
2850
 
        its (present) parents.
2851
 
        """
2852
 
        todo = set(self.revisions.keys())
2853
 
        done = self.absent_revisions.copy()
2854
 
        order = []
2855
 
        while todo:
2856
 
            # scan through looking for a revision whose parents
2857
 
            # are all done
2858
 
            for rev_id in sorted(list(todo)):
2859
 
                rev = self.revisions[rev_id]
2860
 
                parent_ids = set(rev.parent_ids)
2861
 
                if parent_ids.issubset(done):
2862
 
                    # can take this one now
2863
 
                    order.append(rev_id)
2864
 
                    todo.remove(rev_id)
2865
 
                    done.add(rev_id)
2866
 
        return order
2867
 
 
2868
 
 
2869
 
class ConvertBzrDir5To6(Converter):
2870
 
    """Converts format 5 bzr dirs to format 6."""
2871
 
 
2872
 
    def convert(self, to_convert, pb):
2873
 
        """See Converter.convert()."""
2874
 
        self.bzrdir = to_convert
2875
 
        pb = ui.ui_factory.nested_progress_bar()
2876
 
        try:
2877
 
            ui.ui_factory.note('starting upgrade from format 5 to 6')
2878
 
            self._convert_to_prefixed()
2879
 
            return BzrDir.open(self.bzrdir.root_transport.base)
2880
 
        finally:
2881
 
            pb.finished()
2882
 
 
2883
 
    def _convert_to_prefixed(self):
2884
 
        from bzrlib.store import TransportStore
2885
 
        self.bzrdir.transport.delete('branch-format')
2886
 
        for store_name in ["weaves", "revision-store"]:
2887
 
            ui.ui_factory.note("adding prefixes to %s" % store_name)
2888
 
            store_transport = self.bzrdir.transport.clone(store_name)
2889
 
            store = TransportStore(store_transport, prefixed=True)
2890
 
            for urlfilename in store_transport.list_dir('.'):
2891
 
                filename = urlutils.unescape(urlfilename)
2892
 
                if (filename.endswith(".weave") or
2893
 
                    filename.endswith(".gz") or
2894
 
                    filename.endswith(".sig")):
2895
 
                    file_id, suffix = os.path.splitext(filename)
2896
 
                else:
2897
 
                    file_id = filename
2898
 
                    suffix = ''
2899
 
                new_name = store._mapper.map((file_id,)) + suffix
2900
 
                # FIXME keep track of the dirs made RBC 20060121
2901
 
                try:
2902
 
                    store_transport.move(filename, new_name)
2903
 
                except errors.NoSuchFile: # catches missing dirs strangely enough
2904
 
                    store_transport.mkdir(osutils.dirname(new_name))
2905
 
                    store_transport.move(filename, new_name)
2906
 
        self.bzrdir.transport.put_bytes(
2907
 
            'branch-format',
2908
 
            BzrDirFormat6().get_format_string(),
2909
 
            mode=self.bzrdir._get_file_mode())
2910
 
 
2911
 
 
2912
 
class ConvertBzrDir6ToMeta(Converter):
2913
 
    """Converts format 6 bzr dirs to metadirs."""
2914
 
 
2915
 
    def convert(self, to_convert, pb):
2916
 
        """See Converter.convert()."""
2917
 
        from bzrlib.repofmt.weaverepo import RepositoryFormat7
2918
 
        from bzrlib.branch import BzrBranchFormat5
2919
 
        self.bzrdir = to_convert
2920
 
        self.pb = ui.ui_factory.nested_progress_bar()
2921
 
        self.count = 0
2922
 
        self.total = 20 # the steps we know about
2923
 
        self.garbage_inventories = []
2924
 
        self.dir_mode = self.bzrdir._get_dir_mode()
2925
 
        self.file_mode = self.bzrdir._get_file_mode()
2926
 
 
2927
 
        ui.ui_factory.note('starting upgrade from format 6 to metadir')
2928
 
        self.bzrdir.transport.put_bytes(
2929
 
                'branch-format',
2930
 
                "Converting to format 6",
2931
 
                mode=self.file_mode)
2932
 
        # its faster to move specific files around than to open and use the apis...
2933
 
        # first off, nuke ancestry.weave, it was never used.
2934
 
        try:
2935
 
            self.step('Removing ancestry.weave')
2936
 
            self.bzrdir.transport.delete('ancestry.weave')
2937
 
        except errors.NoSuchFile:
2938
 
            pass
2939
 
        # find out whats there
2940
 
        self.step('Finding branch files')
2941
 
        last_revision = self.bzrdir.open_branch().last_revision()
2942
 
        bzrcontents = self.bzrdir.transport.list_dir('.')
2943
 
        for name in bzrcontents:
2944
 
            if name.startswith('basis-inventory.'):
2945
 
                self.garbage_inventories.append(name)
2946
 
        # create new directories for repository, working tree and branch
2947
 
        repository_names = [('inventory.weave', True),
2948
 
                            ('revision-store', True),
2949
 
                            ('weaves', True)]
2950
 
        self.step('Upgrading repository  ')
2951
 
        self.bzrdir.transport.mkdir('repository', mode=self.dir_mode)
2952
 
        self.make_lock('repository')
2953
 
        # we hard code the formats here because we are converting into
2954
 
        # the meta format. The meta format upgrader can take this to a
2955
 
        # future format within each component.
2956
 
        self.put_format('repository', RepositoryFormat7())
2957
 
        for entry in repository_names:
2958
 
            self.move_entry('repository', entry)
2959
 
 
2960
 
        self.step('Upgrading branch      ')
2961
 
        self.bzrdir.transport.mkdir('branch', mode=self.dir_mode)
2962
 
        self.make_lock('branch')
2963
 
        self.put_format('branch', BzrBranchFormat5())
2964
 
        branch_files = [('revision-history', True),
2965
 
                        ('branch-name', True),
2966
 
                        ('parent', False)]
2967
 
        for entry in branch_files:
2968
 
            self.move_entry('branch', entry)
2969
 
 
2970
 
        checkout_files = [('pending-merges', True),
2971
 
                          ('inventory', True),
2972
 
                          ('stat-cache', False)]
2973
 
        # If a mandatory checkout file is not present, the branch does not have
2974
 
        # a functional checkout. Do not create a checkout in the converted
2975
 
        # branch.
2976
 
        for name, mandatory in checkout_files:
2977
 
            if mandatory and name not in bzrcontents:
2978
 
                has_checkout = False
2979
 
                break
2980
 
        else:
2981
 
            has_checkout = True
2982
 
        if not has_checkout:
2983
 
            ui.ui_factory.note('No working tree.')
2984
 
            # If some checkout files are there, we may as well get rid of them.
2985
 
            for name, mandatory in checkout_files:
2986
 
                if name in bzrcontents:
2987
 
                    self.bzrdir.transport.delete(name)
2988
 
        else:
2989
 
            from bzrlib.workingtree import WorkingTreeFormat3
2990
 
            self.step('Upgrading working tree')
2991
 
            self.bzrdir.transport.mkdir('checkout', mode=self.dir_mode)
2992
 
            self.make_lock('checkout')
2993
 
            self.put_format(
2994
 
                'checkout', WorkingTreeFormat3())
2995
 
            self.bzrdir.transport.delete_multi(
2996
 
                self.garbage_inventories, self.pb)
2997
 
            for entry in checkout_files:
2998
 
                self.move_entry('checkout', entry)
2999
 
            if last_revision is not None:
3000
 
                self.bzrdir.transport.put_bytes(
3001
 
                    'checkout/last-revision', last_revision)
3002
 
        self.bzrdir.transport.put_bytes(
3003
 
            'branch-format',
3004
 
            BzrDirMetaFormat1().get_format_string(),
3005
 
            mode=self.file_mode)
3006
 
        self.pb.finished()
3007
 
        return BzrDir.open(self.bzrdir.root_transport.base)
3008
 
 
3009
 
    def make_lock(self, name):
3010
 
        """Make a lock for the new control dir name."""
3011
 
        self.step('Make %s lock' % name)
3012
 
        ld = lockdir.LockDir(self.bzrdir.transport,
3013
 
                             '%s/lock' % name,
3014
 
                             file_modebits=self.file_mode,
3015
 
                             dir_modebits=self.dir_mode)
3016
 
        ld.create()
3017
 
 
3018
 
    def move_entry(self, new_dir, entry):
3019
 
        """Move then entry name into new_dir."""
3020
 
        name = entry[0]
3021
 
        mandatory = entry[1]
3022
 
        self.step('Moving %s' % name)
3023
 
        try:
3024
 
            self.bzrdir.transport.move(name, '%s/%s' % (new_dir, name))
3025
 
        except errors.NoSuchFile:
3026
 
            if mandatory:
3027
 
                raise
3028
 
 
3029
 
    def put_format(self, dirname, format):
3030
 
        self.bzrdir.transport.put_bytes('%s/format' % dirname,
3031
 
            format.get_format_string(),
3032
 
            self.file_mode)
3033
 
 
3034
 
 
3035
 
class ConvertMetaToMeta(Converter):
 
1822
BzrProber.formats.register(BzrDirMetaFormat1.get_format_string(),
 
1823
    BzrDirMetaFormat1)
 
1824
controldir.ControlDirFormat._default_format = BzrDirMetaFormat1()
 
1825
 
 
1826
 
 
1827
class ConvertMetaToMeta(controldir.Converter):
3036
1828
    """Converts the components of metadirs."""
3037
1829
 
3038
1830
    def __init__(self, target_format):
3063
1855
            # TODO: conversions of Branch and Tree should be done by
3064
1856
            # InterXFormat lookups/some sort of registry.
3065
1857
            # Avoid circular imports
3066
 
            from bzrlib import branch as _mod_branch
3067
1858
            old = branch._format.__class__
3068
1859
            new = self.target_format.get_branch_format().__class__
3069
1860
            while old != new:
3092
1883
        else:
3093
1884
            # TODO: conversions of Branch and Tree should be done by
3094
1885
            # InterXFormat lookups
3095
 
            if (isinstance(tree, workingtree.WorkingTree3) and
 
1886
            if (isinstance(tree, workingtree_3.WorkingTree3) and
3096
1887
                not isinstance(tree, workingtree_4.DirStateWorkingTree) and
3097
1888
                isinstance(self.target_format.workingtree_format,
3098
1889
                    workingtree_4.DirStateWorkingTreeFormat)):
3111
1902
        return to_convert
3112
1903
 
3113
1904
 
3114
 
# This is not in remote.py because it's relatively small, and needs to be
3115
 
# registered. Putting it in remote.py creates a circular import problem.
3116
 
# we can make it a lazy object if the control formats is turned into something
3117
 
# like a registry.
3118
 
class RemoteBzrDirFormat(BzrDirMetaFormat1):
3119
 
    """Format representing bzrdirs accessed via a smart server"""
3120
 
 
3121
 
    def __init__(self):
3122
 
        BzrDirMetaFormat1.__init__(self)
3123
 
        # XXX: It's a bit ugly that the network name is here, because we'd
3124
 
        # like to believe that format objects are stateless or at least
3125
 
        # immutable,  However, we do at least avoid mutating the name after
3126
 
        # it's returned.  See <https://bugs.edge.launchpad.net/bzr/+bug/504102>
3127
 
        self._network_name = None
3128
 
 
3129
 
    def __repr__(self):
3130
 
        return "%s(_network_name=%r)" % (self.__class__.__name__,
3131
 
            self._network_name)
3132
 
 
3133
 
    def get_format_description(self):
3134
 
        if self._network_name:
3135
 
            real_format = network_format_registry.get(self._network_name)
3136
 
            return 'Remote: ' + real_format.get_format_description()
3137
 
        return 'bzr remote bzrdir'
3138
 
 
3139
 
    def get_format_string(self):
3140
 
        raise NotImplementedError(self.get_format_string)
3141
 
 
3142
 
    def network_name(self):
3143
 
        if self._network_name:
3144
 
            return self._network_name
3145
 
        else:
3146
 
            raise AssertionError("No network name set.")
3147
 
 
3148
 
    @classmethod
3149
 
    def probe_transport(klass, transport):
3150
 
        """Return a RemoteBzrDirFormat object if it looks possible."""
3151
 
        try:
3152
 
            medium = transport.get_smart_medium()
3153
 
        except (NotImplementedError, AttributeError,
3154
 
                errors.TransportNotPossible, errors.NoSmartMedium,
3155
 
                errors.SmartProtocolError):
3156
 
            # no smart server, so not a branch for this format type.
3157
 
            raise errors.NotBranchError(path=transport.base)
3158
 
        else:
3159
 
            # Decline to open it if the server doesn't support our required
3160
 
            # version (3) so that the VFS-based transport will do it.
3161
 
            if medium.should_probe():
3162
 
                try:
3163
 
                    server_version = medium.protocol_version()
3164
 
                except errors.SmartProtocolError:
3165
 
                    # Apparently there's no usable smart server there, even though
3166
 
                    # the medium supports the smart protocol.
3167
 
                    raise errors.NotBranchError(path=transport.base)
3168
 
                if server_version != '2':
3169
 
                    raise errors.NotBranchError(path=transport.base)
3170
 
            return klass()
3171
 
 
3172
 
    def initialize_on_transport(self, transport):
3173
 
        try:
3174
 
            # hand off the request to the smart server
3175
 
            client_medium = transport.get_smart_medium()
3176
 
        except errors.NoSmartMedium:
3177
 
            # TODO: lookup the local format from a server hint.
3178
 
            local_dir_format = BzrDirMetaFormat1()
3179
 
            return local_dir_format.initialize_on_transport(transport)
3180
 
        client = _SmartClient(client_medium)
3181
 
        path = client.remote_path_from_transport(transport)
3182
 
        try:
3183
 
            response = client.call('BzrDirFormat.initialize', path)
3184
 
        except errors.ErrorFromSmartServer, err:
3185
 
            remote._translate_error(err, path=path)
3186
 
        if response[0] != 'ok':
3187
 
            raise errors.SmartProtocolError('unexpected response code %s' % (response,))
3188
 
        format = RemoteBzrDirFormat()
3189
 
        self._supply_sub_formats_to(format)
3190
 
        return remote.RemoteBzrDir(transport, format)
3191
 
 
3192
 
    def parse_NoneTrueFalse(self, arg):
3193
 
        if not arg:
3194
 
            return None
3195
 
        if arg == 'False':
3196
 
            return False
3197
 
        if arg == 'True':
3198
 
            return True
3199
 
        raise AssertionError("invalid arg %r" % arg)
3200
 
 
3201
 
    def _serialize_NoneTrueFalse(self, arg):
3202
 
        if arg is False:
3203
 
            return 'False'
3204
 
        if arg:
3205
 
            return 'True'
3206
 
        return ''
3207
 
 
3208
 
    def _serialize_NoneString(self, arg):
3209
 
        return arg or ''
3210
 
 
3211
 
    def initialize_on_transport_ex(self, transport, use_existing_dir=False,
3212
 
        create_prefix=False, force_new_repo=False, stacked_on=None,
3213
 
        stack_on_pwd=None, repo_format_name=None, make_working_trees=None,
3214
 
        shared_repo=False):
3215
 
        try:
3216
 
            # hand off the request to the smart server
3217
 
            client_medium = transport.get_smart_medium()
3218
 
        except errors.NoSmartMedium:
3219
 
            do_vfs = True
3220
 
        else:
3221
 
            # Decline to open it if the server doesn't support our required
3222
 
            # version (3) so that the VFS-based transport will do it.
3223
 
            if client_medium.should_probe():
3224
 
                try:
3225
 
                    server_version = client_medium.protocol_version()
3226
 
                    if server_version != '2':
3227
 
                        do_vfs = True
3228
 
                    else:
3229
 
                        do_vfs = False
3230
 
                except errors.SmartProtocolError:
3231
 
                    # Apparently there's no usable smart server there, even though
3232
 
                    # the medium supports the smart protocol.
3233
 
                    do_vfs = True
3234
 
            else:
3235
 
                do_vfs = False
3236
 
        if not do_vfs:
3237
 
            client = _SmartClient(client_medium)
3238
 
            path = client.remote_path_from_transport(transport)
3239
 
            if client_medium._is_remote_before((1, 16)):
3240
 
                do_vfs = True
3241
 
        if do_vfs:
3242
 
            # TODO: lookup the local format from a server hint.
3243
 
            local_dir_format = BzrDirMetaFormat1()
3244
 
            self._supply_sub_formats_to(local_dir_format)
3245
 
            return local_dir_format.initialize_on_transport_ex(transport,
3246
 
                use_existing_dir=use_existing_dir, create_prefix=create_prefix,
3247
 
                force_new_repo=force_new_repo, stacked_on=stacked_on,
3248
 
                stack_on_pwd=stack_on_pwd, repo_format_name=repo_format_name,
3249
 
                make_working_trees=make_working_trees, shared_repo=shared_repo,
3250
 
                vfs_only=True)
3251
 
        return self._initialize_on_transport_ex_rpc(client, path, transport,
3252
 
            use_existing_dir, create_prefix, force_new_repo, stacked_on,
3253
 
            stack_on_pwd, repo_format_name, make_working_trees, shared_repo)
3254
 
 
3255
 
    def _initialize_on_transport_ex_rpc(self, client, path, transport,
3256
 
        use_existing_dir, create_prefix, force_new_repo, stacked_on,
3257
 
        stack_on_pwd, repo_format_name, make_working_trees, shared_repo):
3258
 
        args = []
3259
 
        args.append(self._serialize_NoneTrueFalse(use_existing_dir))
3260
 
        args.append(self._serialize_NoneTrueFalse(create_prefix))
3261
 
        args.append(self._serialize_NoneTrueFalse(force_new_repo))
3262
 
        args.append(self._serialize_NoneString(stacked_on))
3263
 
        # stack_on_pwd is often/usually our transport
3264
 
        if stack_on_pwd:
3265
 
            try:
3266
 
                stack_on_pwd = transport.relpath(stack_on_pwd)
3267
 
                if not stack_on_pwd:
3268
 
                    stack_on_pwd = '.'
3269
 
            except errors.PathNotChild:
3270
 
                pass
3271
 
        args.append(self._serialize_NoneString(stack_on_pwd))
3272
 
        args.append(self._serialize_NoneString(repo_format_name))
3273
 
        args.append(self._serialize_NoneTrueFalse(make_working_trees))
3274
 
        args.append(self._serialize_NoneTrueFalse(shared_repo))
3275
 
        request_network_name = self._network_name or \
3276
 
            BzrDirFormat.get_default_format().network_name()
3277
 
        try:
3278
 
            response = client.call('BzrDirFormat.initialize_ex_1.16',
3279
 
                request_network_name, path, *args)
3280
 
        except errors.UnknownSmartMethod:
3281
 
            client._medium._remember_remote_is_before((1,16))
3282
 
            local_dir_format = BzrDirMetaFormat1()
3283
 
            self._supply_sub_formats_to(local_dir_format)
3284
 
            return local_dir_format.initialize_on_transport_ex(transport,
3285
 
                use_existing_dir=use_existing_dir, create_prefix=create_prefix,
3286
 
                force_new_repo=force_new_repo, stacked_on=stacked_on,
3287
 
                stack_on_pwd=stack_on_pwd, repo_format_name=repo_format_name,
3288
 
                make_working_trees=make_working_trees, shared_repo=shared_repo,
3289
 
                vfs_only=True)
3290
 
        except errors.ErrorFromSmartServer, err:
3291
 
            remote._translate_error(err, path=path)
3292
 
        repo_path = response[0]
3293
 
        bzrdir_name = response[6]
3294
 
        require_stacking = response[7]
3295
 
        require_stacking = self.parse_NoneTrueFalse(require_stacking)
3296
 
        format = RemoteBzrDirFormat()
3297
 
        format._network_name = bzrdir_name
3298
 
        self._supply_sub_formats_to(format)
3299
 
        bzrdir = remote.RemoteBzrDir(transport, format, _client=client)
3300
 
        if repo_path:
3301
 
            repo_format = remote.response_tuple_to_repo_format(response[1:])
3302
 
            if repo_path == '.':
3303
 
                repo_path = ''
3304
 
            if repo_path:
3305
 
                repo_bzrdir_format = RemoteBzrDirFormat()
3306
 
                repo_bzrdir_format._network_name = response[5]
3307
 
                repo_bzr = remote.RemoteBzrDir(transport.clone(repo_path),
3308
 
                    repo_bzrdir_format)
3309
 
            else:
3310
 
                repo_bzr = bzrdir
3311
 
            final_stack = response[8] or None
3312
 
            final_stack_pwd = response[9] or None
3313
 
            if final_stack_pwd:
3314
 
                final_stack_pwd = urlutils.join(
3315
 
                    transport.base, final_stack_pwd)
3316
 
            remote_repo = remote.RemoteRepository(repo_bzr, repo_format)
3317
 
            if len(response) > 10:
3318
 
                # Updated server verb that locks remotely.
3319
 
                repo_lock_token = response[10] or None
3320
 
                remote_repo.lock_write(repo_lock_token, _skip_rpc=True)
3321
 
                if repo_lock_token:
3322
 
                    remote_repo.dont_leave_lock_in_place()
3323
 
            else:
3324
 
                remote_repo.lock_write()
3325
 
            policy = UseExistingRepository(remote_repo, final_stack,
3326
 
                final_stack_pwd, require_stacking)
3327
 
            policy.acquire_repository()
3328
 
        else:
3329
 
            remote_repo = None
3330
 
            policy = None
3331
 
        bzrdir._format.set_branch_format(self.get_branch_format())
3332
 
        if require_stacking:
3333
 
            # The repo has already been created, but we need to make sure that
3334
 
            # we'll make a stackable branch.
3335
 
            bzrdir._format.require_stacking(_skip_repo=True)
3336
 
        return remote_repo, bzrdir, require_stacking, policy
3337
 
 
3338
 
    def _open(self, transport):
3339
 
        return remote.RemoteBzrDir(transport, self)
3340
 
 
3341
 
    def __eq__(self, other):
3342
 
        if not isinstance(other, RemoteBzrDirFormat):
3343
 
            return False
3344
 
        return self.get_format_description() == other.get_format_description()
3345
 
 
3346
 
    def __return_repository_format(self):
3347
 
        # Always return a RemoteRepositoryFormat object, but if a specific bzr
3348
 
        # repository format has been asked for, tell the RemoteRepositoryFormat
3349
 
        # that it should use that for init() etc.
3350
 
        result = remote.RemoteRepositoryFormat()
3351
 
        custom_format = getattr(self, '_repository_format', None)
3352
 
        if custom_format:
3353
 
            if isinstance(custom_format, remote.RemoteRepositoryFormat):
3354
 
                return custom_format
3355
 
            else:
3356
 
                # We will use the custom format to create repositories over the
3357
 
                # wire; expose its details like rich_root_data for code to
3358
 
                # query
3359
 
                result._custom_format = custom_format
3360
 
        return result
3361
 
 
3362
 
    def get_branch_format(self):
3363
 
        result = BzrDirMetaFormat1.get_branch_format(self)
3364
 
        if not isinstance(result, remote.RemoteBranchFormat):
3365
 
            new_result = remote.RemoteBranchFormat()
3366
 
            new_result._custom_format = result
3367
 
            # cache the result
3368
 
            self.set_branch_format(new_result)
3369
 
            result = new_result
3370
 
        return result
3371
 
 
3372
 
    repository_format = property(__return_repository_format,
3373
 
        BzrDirMetaFormat1._set_repository_format) #.im_func)
3374
 
 
3375
 
 
3376
 
BzrDirFormat.register_control_server_format(RemoteBzrDirFormat)
3377
 
 
3378
 
 
3379
 
class BzrDirFormatInfo(object):
3380
 
 
3381
 
    def __init__(self, native, deprecated, hidden, experimental):
3382
 
        self.deprecated = deprecated
3383
 
        self.native = native
3384
 
        self.hidden = hidden
3385
 
        self.experimental = experimental
3386
 
 
3387
 
 
3388
 
class BzrDirFormatRegistry(registry.Registry):
3389
 
    """Registry of user-selectable BzrDir subformats.
3390
 
 
3391
 
    Differs from BzrDirFormat._control_formats in that it provides sub-formats,
3392
 
    e.g. BzrDirMeta1 with weave repository.  Also, it's more user-oriented.
3393
 
    """
3394
 
 
3395
 
    def __init__(self):
3396
 
        """Create a BzrDirFormatRegistry."""
3397
 
        self._aliases = set()
3398
 
        self._registration_order = list()
3399
 
        super(BzrDirFormatRegistry, self).__init__()
3400
 
 
3401
 
    def aliases(self):
3402
 
        """Return a set of the format names which are aliases."""
3403
 
        return frozenset(self._aliases)
3404
 
 
3405
 
    def register_metadir(self, key,
3406
 
             repository_format, help, native=True, deprecated=False,
3407
 
             branch_format=None,
3408
 
             tree_format=None,
3409
 
             hidden=False,
3410
 
             experimental=False,
3411
 
             alias=False):
3412
 
        """Register a metadir subformat.
3413
 
 
3414
 
        These all use a BzrDirMetaFormat1 bzrdir, but can be parameterized
3415
 
        by the Repository/Branch/WorkingTreeformats.
3416
 
 
3417
 
        :param repository_format: The fully-qualified repository format class
3418
 
            name as a string.
3419
 
        :param branch_format: Fully-qualified branch format class name as
3420
 
            a string.
3421
 
        :param tree_format: Fully-qualified tree format class name as
3422
 
            a string.
3423
 
        """
3424
 
        # This should be expanded to support setting WorkingTree and Branch
3425
 
        # formats, once BzrDirMetaFormat1 supports that.
3426
 
        def _load(full_name):
3427
 
            mod_name, factory_name = full_name.rsplit('.', 1)
3428
 
            try:
3429
 
                mod = __import__(mod_name, globals(), locals(),
3430
 
                        [factory_name])
3431
 
            except ImportError, e:
3432
 
                raise ImportError('failed to load %s: %s' % (full_name, e))
3433
 
            try:
3434
 
                factory = getattr(mod, factory_name)
3435
 
            except AttributeError:
3436
 
                raise AttributeError('no factory %s in module %r'
3437
 
                    % (full_name, mod))
3438
 
            return factory()
3439
 
 
3440
 
        def helper():
3441
 
            bd = BzrDirMetaFormat1()
3442
 
            if branch_format is not None:
3443
 
                bd.set_branch_format(_load(branch_format))
3444
 
            if tree_format is not None:
3445
 
                bd.workingtree_format = _load(tree_format)
3446
 
            if repository_format is not None:
3447
 
                bd.repository_format = _load(repository_format)
3448
 
            return bd
3449
 
        self.register(key, helper, help, native, deprecated, hidden,
3450
 
            experimental, alias)
3451
 
 
3452
 
    def register(self, key, factory, help, native=True, deprecated=False,
3453
 
                 hidden=False, experimental=False, alias=False):
3454
 
        """Register a BzrDirFormat factory.
3455
 
 
3456
 
        The factory must be a callable that takes one parameter: the key.
3457
 
        It must produce an instance of the BzrDirFormat when called.
3458
 
 
3459
 
        This function mainly exists to prevent the info object from being
3460
 
        supplied directly.
3461
 
        """
3462
 
        registry.Registry.register(self, key, factory, help,
3463
 
            BzrDirFormatInfo(native, deprecated, hidden, experimental))
3464
 
        if alias:
3465
 
            self._aliases.add(key)
3466
 
        self._registration_order.append(key)
3467
 
 
3468
 
    def register_lazy(self, key, module_name, member_name, help, native=True,
3469
 
        deprecated=False, hidden=False, experimental=False, alias=False):
3470
 
        registry.Registry.register_lazy(self, key, module_name, member_name,
3471
 
            help, BzrDirFormatInfo(native, deprecated, hidden, experimental))
3472
 
        if alias:
3473
 
            self._aliases.add(key)
3474
 
        self._registration_order.append(key)
3475
 
 
3476
 
    def set_default(self, key):
3477
 
        """Set the 'default' key to be a clone of the supplied key.
3478
 
 
3479
 
        This method must be called once and only once.
3480
 
        """
3481
 
        registry.Registry.register(self, 'default', self.get(key),
3482
 
            self.get_help(key), info=self.get_info(key))
3483
 
        self._aliases.add('default')
3484
 
 
3485
 
    def set_default_repository(self, key):
3486
 
        """Set the FormatRegistry default and Repository default.
3487
 
 
3488
 
        This is a transitional method while Repository.set_default_format
3489
 
        is deprecated.
3490
 
        """
3491
 
        if 'default' in self:
3492
 
            self.remove('default')
3493
 
        self.set_default(key)
3494
 
        format = self.get('default')()
3495
 
 
3496
 
    def make_bzrdir(self, key):
3497
 
        return self.get(key)()
3498
 
 
3499
 
    def help_topic(self, topic):
3500
 
        output = ""
3501
 
        default_realkey = None
3502
 
        default_help = self.get_help('default')
3503
 
        help_pairs = []
3504
 
        for key in self._registration_order:
3505
 
            if key == 'default':
3506
 
                continue
3507
 
            help = self.get_help(key)
3508
 
            if help == default_help:
3509
 
                default_realkey = key
3510
 
            else:
3511
 
                help_pairs.append((key, help))
3512
 
 
3513
 
        def wrapped(key, help, info):
3514
 
            if info.native:
3515
 
                help = '(native) ' + help
3516
 
            return ':%s:\n%s\n\n' % (key,
3517
 
                textwrap.fill(help, initial_indent='    ',
3518
 
                    subsequent_indent='    ',
3519
 
                    break_long_words=False))
3520
 
        if default_realkey is not None:
3521
 
            output += wrapped(default_realkey, '(default) %s' % default_help,
3522
 
                              self.get_info('default'))
3523
 
        deprecated_pairs = []
3524
 
        experimental_pairs = []
3525
 
        for key, help in help_pairs:
3526
 
            info = self.get_info(key)
3527
 
            if info.hidden:
3528
 
                continue
3529
 
            elif info.deprecated:
3530
 
                deprecated_pairs.append((key, help))
3531
 
            elif info.experimental:
3532
 
                experimental_pairs.append((key, help))
3533
 
            else:
3534
 
                output += wrapped(key, help, info)
3535
 
        output += "\nSee :doc:`formats-help` for more about storage formats."
3536
 
        other_output = ""
3537
 
        if len(experimental_pairs) > 0:
3538
 
            other_output += "Experimental formats are shown below.\n\n"
3539
 
            for key, help in experimental_pairs:
3540
 
                info = self.get_info(key)
3541
 
                other_output += wrapped(key, help, info)
3542
 
        else:
3543
 
            other_output += \
3544
 
                "No experimental formats are available.\n\n"
3545
 
        if len(deprecated_pairs) > 0:
3546
 
            other_output += "\nDeprecated formats are shown below.\n\n"
3547
 
            for key, help in deprecated_pairs:
3548
 
                info = self.get_info(key)
3549
 
                other_output += wrapped(key, help, info)
3550
 
        else:
3551
 
            other_output += \
3552
 
                "\nNo deprecated formats are available.\n\n"
3553
 
        other_output += \
3554
 
                "\nSee :doc:`formats-help` for more about storage formats."
3555
 
 
3556
 
        if topic == 'other-formats':
3557
 
            return other_output
3558
 
        else:
3559
 
            return output
 
1905
controldir.ControlDirFormat.register_server_prober(RemoteBzrProber)
3560
1906
 
3561
1907
 
3562
1908
class RepositoryAcquisitionPolicy(object):
3591
1937
            try:
3592
1938
                stack_on = urlutils.rebase_url(self._stack_on,
3593
1939
                    self._stack_on_pwd,
3594
 
                    branch.bzrdir.root_transport.base)
 
1940
                    branch.user_url)
3595
1941
            except errors.InvalidRebaseURLs:
3596
1942
                stack_on = self._get_full_stack_on()
3597
1943
        try:
3716
2062
        return self._repository, False
3717
2063
 
3718
2064
 
3719
 
# Please register new formats after old formats so that formats
3720
 
# appear in chronological order and format descriptions can build
3721
 
# on previous ones.
3722
 
format_registry = BzrDirFormatRegistry()
3723
 
# The pre-0.8 formats have their repository format network name registered in
3724
 
# repository.py. MetaDir formats have their repository format network name
3725
 
# inferred from their disk format string.
3726
 
format_registry.register('weave', BzrDirFormat6,
3727
 
    'Pre-0.8 format.  Slower than knit and does not'
3728
 
    ' support checkouts or shared repositories.',
3729
 
    hidden=True,
3730
 
    deprecated=True)
3731
 
format_registry.register_metadir('metaweave',
3732
 
    'bzrlib.repofmt.weaverepo.RepositoryFormat7',
3733
 
    'Transitional format in 0.8.  Slower than knit.',
3734
 
    branch_format='bzrlib.branch.BzrBranchFormat5',
3735
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat3',
3736
 
    hidden=True,
3737
 
    deprecated=True)
3738
 
format_registry.register_metadir('knit',
 
2065
def register_metadir(registry, key,
 
2066
         repository_format, help, native=True, deprecated=False,
 
2067
         branch_format=None,
 
2068
         tree_format=None,
 
2069
         hidden=False,
 
2070
         experimental=False,
 
2071
         alias=False):
 
2072
    """Register a metadir subformat.
 
2073
 
 
2074
    These all use a BzrDirMetaFormat1 bzrdir, but can be parameterized
 
2075
    by the Repository/Branch/WorkingTreeformats.
 
2076
 
 
2077
    :param repository_format: The fully-qualified repository format class
 
2078
        name as a string.
 
2079
    :param branch_format: Fully-qualified branch format class name as
 
2080
        a string.
 
2081
    :param tree_format: Fully-qualified tree format class name as
 
2082
        a string.
 
2083
    """
 
2084
    # This should be expanded to support setting WorkingTree and Branch
 
2085
    # formats, once BzrDirMetaFormat1 supports that.
 
2086
    def _load(full_name):
 
2087
        mod_name, factory_name = full_name.rsplit('.', 1)
 
2088
        try:
 
2089
            factory = pyutils.get_named_object(mod_name, factory_name)
 
2090
        except ImportError, e:
 
2091
            raise ImportError('failed to load %s: %s' % (full_name, e))
 
2092
        except AttributeError:
 
2093
            raise AttributeError('no factory %s in module %r'
 
2094
                % (full_name, sys.modules[mod_name]))
 
2095
        return factory()
 
2096
 
 
2097
    def helper():
 
2098
        bd = BzrDirMetaFormat1()
 
2099
        if branch_format is not None:
 
2100
            bd.set_branch_format(_load(branch_format))
 
2101
        if tree_format is not None:
 
2102
            bd.workingtree_format = _load(tree_format)
 
2103
        if repository_format is not None:
 
2104
            bd.repository_format = _load(repository_format)
 
2105
        return bd
 
2106
    registry.register(key, helper, help, native, deprecated, hidden,
 
2107
        experimental, alias)
 
2108
 
 
2109
register_metadir(controldir.format_registry, 'knit',
3739
2110
    'bzrlib.repofmt.knitrepo.RepositoryFormatKnit1',
3740
2111
    'Format using knits.  Recommended for interoperation with bzr <= 0.14.',
3741
2112
    branch_format='bzrlib.branch.BzrBranchFormat5',
3742
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat3',
 
2113
    tree_format='bzrlib.workingtree_3.WorkingTreeFormat3',
3743
2114
    hidden=True,
3744
2115
    deprecated=True)
3745
 
format_registry.register_metadir('dirstate',
 
2116
register_metadir(controldir.format_registry, 'dirstate',
3746
2117
    'bzrlib.repofmt.knitrepo.RepositoryFormatKnit1',
3747
2118
    help='New in 0.15: Fast local operations. Compatible with bzr 0.8 and '
3748
2119
        'above when accessed over the network.',
3749
2120
    branch_format='bzrlib.branch.BzrBranchFormat5',
3750
 
    # this uses bzrlib.workingtree.WorkingTreeFormat4 because importing
3751
 
    # directly from workingtree_4 triggers a circular import.
3752
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
2121
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat4',
3753
2122
    hidden=True,
3754
2123
    deprecated=True)
3755
 
format_registry.register_metadir('dirstate-tags',
 
2124
register_metadir(controldir.format_registry, 'dirstate-tags',
3756
2125
    'bzrlib.repofmt.knitrepo.RepositoryFormatKnit1',
3757
2126
    help='New in 0.15: Fast local operations and improved scaling for '
3758
2127
        'network operations. Additionally adds support for tags.'
3759
2128
        ' Incompatible with bzr < 0.15.',
3760
2129
    branch_format='bzrlib.branch.BzrBranchFormat6',
3761
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
2130
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat4',
3762
2131
    hidden=True,
3763
2132
    deprecated=True)
3764
 
format_registry.register_metadir('rich-root',
 
2133
register_metadir(controldir.format_registry, 'rich-root',
3765
2134
    'bzrlib.repofmt.knitrepo.RepositoryFormatKnit4',
3766
2135
    help='New in 1.0.  Better handling of tree roots.  Incompatible with'
3767
2136
        ' bzr < 1.0.',
3768
2137
    branch_format='bzrlib.branch.BzrBranchFormat6',
3769
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
2138
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat4',
3770
2139
    hidden=True,
3771
2140
    deprecated=True)
3772
 
format_registry.register_metadir('dirstate-with-subtree',
 
2141
register_metadir(controldir.format_registry, 'dirstate-with-subtree',
3773
2142
    'bzrlib.repofmt.knitrepo.RepositoryFormatKnit3',
3774
2143
    help='New in 0.15: Fast local operations and improved scaling for '
3775
2144
        'network operations. Additionally adds support for versioning nested '
3776
2145
        'bzr branches. Incompatible with bzr < 0.15.',
3777
2146
    branch_format='bzrlib.branch.BzrBranchFormat6',
3778
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
2147
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat4',
3779
2148
    experimental=True,
3780
2149
    hidden=True,
3781
2150
    )
3782
 
format_registry.register_metadir('pack-0.92',
3783
 
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack1',
 
2151
register_metadir(controldir.format_registry, 'pack-0.92',
 
2152
    'bzrlib.repofmt.knitpack_repo.RepositoryFormatKnitPack1',
3784
2153
    help='New in 0.92: Pack-based format with data compatible with '
3785
2154
        'dirstate-tags format repositories. Interoperates with '
3786
2155
        'bzr repositories before 0.92 but cannot be read by bzr < 0.92. '
3787
2156
        ,
3788
2157
    branch_format='bzrlib.branch.BzrBranchFormat6',
3789
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
2158
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat4',
3790
2159
    )
3791
 
format_registry.register_metadir('pack-0.92-subtree',
3792
 
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack3',
 
2160
register_metadir(controldir.format_registry, 'pack-0.92-subtree',
 
2161
    'bzrlib.repofmt.knitpack_repo.RepositoryFormatKnitPack3',
3793
2162
    help='New in 0.92: Pack-based format with data compatible with '
3794
2163
        'dirstate-with-subtree format repositories. Interoperates with '
3795
2164
        'bzr repositories before 0.92 but cannot be read by bzr < 0.92. '
3796
2165
        ,
3797
2166
    branch_format='bzrlib.branch.BzrBranchFormat6',
3798
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
2167
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat4',
3799
2168
    hidden=True,
3800
2169
    experimental=True,
3801
2170
    )
3802
 
format_registry.register_metadir('rich-root-pack',
3803
 
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack4',
 
2171
register_metadir(controldir.format_registry, 'rich-root-pack',
 
2172
    'bzrlib.repofmt.knitpack_repo.RepositoryFormatKnitPack4',
3804
2173
    help='New in 1.0: A variant of pack-0.92 that supports rich-root data '
3805
2174
         '(needed for bzr-svn and bzr-git).',
3806
2175
    branch_format='bzrlib.branch.BzrBranchFormat6',
3807
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
2176
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat4',
3808
2177
    hidden=True,
3809
2178
    )
3810
 
format_registry.register_metadir('1.6',
3811
 
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack5',
 
2179
register_metadir(controldir.format_registry, '1.6',
 
2180
    'bzrlib.repofmt.knitpack_repo.RepositoryFormatKnitPack5',
3812
2181
    help='A format that allows a branch to indicate that there is another '
3813
2182
         '(stacked) repository that should be used to access data that is '
3814
2183
         'not present locally.',
3815
2184
    branch_format='bzrlib.branch.BzrBranchFormat7',
3816
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
2185
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat4',
3817
2186
    hidden=True,
3818
2187
    )
3819
 
format_registry.register_metadir('1.6.1-rich-root',
3820
 
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack5RichRoot',
 
2188
register_metadir(controldir.format_registry, '1.6.1-rich-root',
 
2189
    'bzrlib.repofmt.knitpack_repo.RepositoryFormatKnitPack5RichRoot',
3821
2190
    help='A variant of 1.6 that supports rich-root data '
3822
2191
         '(needed for bzr-svn and bzr-git).',
3823
2192
    branch_format='bzrlib.branch.BzrBranchFormat7',
3824
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
2193
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat4',
3825
2194
    hidden=True,
3826
2195
    )
3827
 
format_registry.register_metadir('1.9',
3828
 
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack6',
 
2196
register_metadir(controldir.format_registry, '1.9',
 
2197
    'bzrlib.repofmt.knitpack_repo.RepositoryFormatKnitPack6',
3829
2198
    help='A repository format using B+tree indexes. These indexes '
3830
2199
         'are smaller in size, have smarter caching and provide faster '
3831
2200
         'performance for most operations.',
3832
2201
    branch_format='bzrlib.branch.BzrBranchFormat7',
3833
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
2202
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat4',
3834
2203
    hidden=True,
3835
2204
    )
3836
 
format_registry.register_metadir('1.9-rich-root',
3837
 
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack6RichRoot',
 
2205
register_metadir(controldir.format_registry, '1.9-rich-root',
 
2206
    'bzrlib.repofmt.knitpack_repo.RepositoryFormatKnitPack6RichRoot',
3838
2207
    help='A variant of 1.9 that supports rich-root data '
3839
2208
         '(needed for bzr-svn and bzr-git).',
3840
2209
    branch_format='bzrlib.branch.BzrBranchFormat7',
3841
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat4',
 
2210
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat4',
3842
2211
    hidden=True,
3843
2212
    )
3844
 
format_registry.register_metadir('1.14',
3845
 
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack6',
 
2213
register_metadir(controldir.format_registry, '1.14',
 
2214
    'bzrlib.repofmt.knitpack_repo.RepositoryFormatKnitPack6',
3846
2215
    help='A working-tree format that supports content filtering.',
3847
2216
    branch_format='bzrlib.branch.BzrBranchFormat7',
3848
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat5',
 
2217
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat5',
3849
2218
    )
3850
 
format_registry.register_metadir('1.14-rich-root',
3851
 
    'bzrlib.repofmt.pack_repo.RepositoryFormatKnitPack6RichRoot',
 
2219
register_metadir(controldir.format_registry, '1.14-rich-root',
 
2220
    'bzrlib.repofmt.knitpack_repo.RepositoryFormatKnitPack6RichRoot',
3852
2221
    help='A variant of 1.14 that supports rich-root data '
3853
2222
         '(needed for bzr-svn and bzr-git).',
3854
2223
    branch_format='bzrlib.branch.BzrBranchFormat7',
3855
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat5',
 
2224
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat5',
3856
2225
    )
3857
2226
# The following un-numbered 'development' formats should always just be aliases.
3858
 
format_registry.register_metadir('development-rich-root',
3859
 
    'bzrlib.repofmt.groupcompress_repo.RepositoryFormatCHK1',
3860
 
    help='Current development format. Supports rich roots. Can convert data '
3861
 
        'to and from rich-root-pack (and anything compatible with '
3862
 
        'rich-root-pack) format repositories. Repositories and branches in '
3863
 
        'this format can only be read by bzr.dev. Please read '
3864
 
        'http://doc.bazaar.canonical.com/latest/developers/development-repo.html '
3865
 
        'before use.',
3866
 
    branch_format='bzrlib.branch.BzrBranchFormat7',
3867
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat6',
3868
 
    experimental=True,
3869
 
    alias=True,
3870
 
    hidden=True,
3871
 
    )
3872
 
format_registry.register_metadir('development-subtree',
3873
 
    'bzrlib.repofmt.pack_repo.RepositoryFormatPackDevelopment2Subtree',
 
2227
register_metadir(controldir.format_registry, 'development-subtree',
 
2228
    'bzrlib.repofmt.groupcompress_repo.RepositoryFormat2aSubtree',
3874
2229
    help='Current development format, subtree variant. Can convert data to and '
3875
2230
        'from pack-0.92-subtree (and anything compatible with '
3876
2231
        'pack-0.92-subtree) format repositories. Repositories and branches in '
3878
2233
        'http://doc.bazaar.canonical.com/latest/developers/development-repo.html '
3879
2234
        'before use.',
3880
2235
    branch_format='bzrlib.branch.BzrBranchFormat7',
3881
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat6',
 
2236
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat6',
3882
2237
    experimental=True,
3883
2238
    hidden=True,
3884
2239
    alias=False, # Restore to being an alias when an actual development subtree format is added
3885
2240
                 # This current non-alias status is simply because we did not introduce a
3886
2241
                 # chk based subtree format.
3887
2242
    )
 
2243
register_metadir(controldir.format_registry, 'development5-subtree',
 
2244
    'bzrlib.repofmt.knitpack_repo.RepositoryFormatPackDevelopment2Subtree',
 
2245
    help='Development format, subtree variant. Can convert data to and '
 
2246
        'from pack-0.92-subtree (and anything compatible with '
 
2247
        'pack-0.92-subtree) format repositories. Repositories and branches in '
 
2248
        'this format can only be read by bzr.dev. Please read '
 
2249
        'http://doc.bazaar.canonical.com/latest/developers/development-repo.html '
 
2250
        'before use.',
 
2251
    branch_format='bzrlib.branch.BzrBranchFormat7',
 
2252
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat6',
 
2253
    experimental=True,
 
2254
    hidden=True,
 
2255
    alias=False,
 
2256
    )
3888
2257
 
3889
2258
# And the development formats above will have aliased one of the following:
3890
 
format_registry.register_metadir('development6-rich-root',
3891
 
    'bzrlib.repofmt.groupcompress_repo.RepositoryFormatCHK1',
3892
 
    help='pack-1.9 with 255-way hashed CHK inv, group compress, rich roots '
3893
 
        'Please read '
3894
 
        'http://doc.bazaar.canonical.com/latest/developers/development-repo.html '
3895
 
        'before use.',
3896
 
    branch_format='bzrlib.branch.BzrBranchFormat7',
3897
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat6',
3898
 
    hidden=True,
3899
 
    experimental=True,
3900
 
    )
3901
 
 
3902
 
format_registry.register_metadir('development7-rich-root',
3903
 
    'bzrlib.repofmt.groupcompress_repo.RepositoryFormatCHK2',
3904
 
    help='pack-1.9 with 255-way hashed CHK inv, bencode revision, group compress, '
3905
 
        'rich roots. Please read '
3906
 
        'http://doc.bazaar.canonical.com/latest/developers/development-repo.html '
3907
 
        'before use.',
3908
 
    branch_format='bzrlib.branch.BzrBranchFormat7',
3909
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat6',
3910
 
    hidden=True,
3911
 
    experimental=True,
3912
 
    )
3913
 
 
3914
 
format_registry.register_metadir('2a',
 
2259
 
 
2260
# Finally, the current format.
 
2261
register_metadir(controldir.format_registry, '2a',
3915
2262
    'bzrlib.repofmt.groupcompress_repo.RepositoryFormat2a',
3916
2263
    help='First format for bzr 2.0 series.\n'
3917
2264
        'Uses group-compress storage.\n'
3919
2266
        # 'storage in packs, 255-way hashed CHK inventory, bencode revision, group compress, '
3920
2267
        # 'rich roots. Supported by bzr 1.16 and later.',
3921
2268
    branch_format='bzrlib.branch.BzrBranchFormat7',
3922
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat6',
3923
 
    experimental=True,
 
2269
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat6',
 
2270
    experimental=False,
3924
2271
    )
3925
2272
 
3926
2273
# The following format should be an alias for the rich root equivalent 
3927
2274
# of the default format
3928
 
format_registry.register_metadir('default-rich-root',
 
2275
register_metadir(controldir.format_registry, 'default-rich-root',
3929
2276
    'bzrlib.repofmt.groupcompress_repo.RepositoryFormat2a',
3930
2277
    branch_format='bzrlib.branch.BzrBranchFormat7',
3931
 
    tree_format='bzrlib.workingtree.WorkingTreeFormat6',
 
2278
    tree_format='bzrlib.workingtree_4.WorkingTreeFormat6',
3932
2279
    alias=True,
3933
2280
    hidden=True,
3934
2281
    help='Same as 2a.')
3935
2282
 
3936
2283
# The current format that is made on 'bzr init'.
3937
 
format_registry.set_default('2a')
 
2284
format_name = config.GlobalConfig().get_user_option('default_format')
 
2285
if format_name is None:
 
2286
    controldir.format_registry.set_default('2a')
 
2287
else:
 
2288
    controldir.format_registry.set_default(format_name)
 
2289
 
 
2290
# XXX 2010-08-20 JRV: There is still a lot of code relying on
 
2291
# bzrlib.bzrdir.format_registry existing. When BzrDir.create/BzrDir.open/etc
 
2292
# get changed to ControlDir.create/ControlDir.open/etc this should be removed.
 
2293
format_registry = controldir.format_registry