~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/builtins.py

  • Committer: Martin Pool
  • Date: 2010-01-29 14:09:05 UTC
  • mto: This revision was merged to the branch mainline in revision 4992.
  • Revision ID: mbp@sourcefrog.net-20100129140905-2uiarb6p8di1ywsr
Correction to url

from review: https://code.edge.launchpad.net/~mbp/bzr/doc/+merge/18250

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005-2010 Canonical Ltd
 
1
# Copyright (C) 2004-2010 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
54
54
    )
55
55
from bzrlib.branch import Branch
56
56
from bzrlib.conflicts import ConflictList
57
 
from bzrlib.transport import memory
58
57
from bzrlib.revisionspec import RevisionSpec, RevisionInfo
59
58
from bzrlib.smtp_connection import SMTPConnection
60
59
from bzrlib.workingtree import WorkingTree
61
60
""")
62
61
 
63
 
from bzrlib.commands import (
64
 
    Command,
65
 
    builtin_command_registry,
66
 
    display_command,
67
 
    )
 
62
from bzrlib.commands import Command, display_command
68
63
from bzrlib.option import (
69
64
    ListOption,
70
65
    Option,
180
175
                view_str = views.view_display_str(view_files)
181
176
                note("Ignoring files outside view. View is %s" % view_str)
182
177
        return tree, file_list
183
 
    tree = WorkingTree.open_containing(file_list[0])[0]
 
178
    tree = WorkingTree.open_containing(osutils.realpath(file_list[0]))[0]
184
179
    return tree, safe_relpath_files(tree, file_list, canonicalize,
185
180
        apply_view=apply_view)
186
181
 
232
227
    return view_info
233
228
 
234
229
 
235
 
def _open_directory_or_containing_tree_or_branch(filename, directory):
236
 
    """Open the tree or branch containing the specified file, unless
237
 
    the --directory option is used to specify a different branch."""
238
 
    if directory is not None:
239
 
        return (None, Branch.open(directory), filename)
240
 
    return bzrdir.BzrDir.open_containing_tree_or_branch(filename)
241
 
 
242
 
 
243
230
# TODO: Make sure no commands unconditionally use the working directory as a
244
231
# branch.  If a filename argument is used, the first of them should be used to
245
232
# specify the branch.  (Perhaps this can be factored out into some kind of
247
234
# opens the branch?)
248
235
 
249
236
class cmd_status(Command):
250
 
    __doc__ = """Display status summary.
 
237
    """Display status summary.
251
238
 
252
239
    This reports on versioned and unknown files, reporting them
253
240
    grouped by state.  Possible states are:
340
327
 
341
328
 
342
329
class cmd_cat_revision(Command):
343
 
    __doc__ = """Write out metadata for a revision.
 
330
    """Write out metadata for a revision.
344
331
 
345
332
    The revision to print can either be specified by a specific
346
333
    revision identifier, or you can use --revision.
348
335
 
349
336
    hidden = True
350
337
    takes_args = ['revision_id?']
351
 
    takes_options = ['directory', 'revision']
 
338
    takes_options = ['revision']
352
339
    # cat-revision is more for frontends so should be exact
353
340
    encoding = 'strict'
354
341
 
355
 
    def print_revision(self, revisions, revid):
356
 
        stream = revisions.get_record_stream([(revid,)], 'unordered', True)
357
 
        record = stream.next()
358
 
        if record.storage_kind == 'absent':
359
 
            raise errors.NoSuchRevision(revisions, revid)
360
 
        revtext = record.get_bytes_as('fulltext')
361
 
        self.outf.write(revtext.decode('utf-8'))
362
 
 
363
342
    @display_command
364
 
    def run(self, revision_id=None, revision=None, directory=u'.'):
 
343
    def run(self, revision_id=None, revision=None):
365
344
        if revision_id is not None and revision is not None:
366
345
            raise errors.BzrCommandError('You can only supply one of'
367
346
                                         ' revision_id or --revision')
368
347
        if revision_id is None and revision is None:
369
348
            raise errors.BzrCommandError('You must supply either'
370
349
                                         ' --revision or a revision_id')
371
 
        b = WorkingTree.open_containing(directory)[0].branch
372
 
 
373
 
        revisions = b.repository.revisions
374
 
        if revisions is None:
375
 
            raise errors.BzrCommandError('Repository %r does not support '
376
 
                'access to raw revision texts')
377
 
 
378
 
        b.repository.lock_read()
379
 
        try:
380
 
            # TODO: jam 20060112 should cat-revision always output utf-8?
381
 
            if revision_id is not None:
382
 
                revision_id = osutils.safe_revision_id(revision_id, warn=False)
383
 
                try:
384
 
                    self.print_revision(revisions, revision_id)
385
 
                except errors.NoSuchRevision:
386
 
                    msg = "The repository %s contains no revision %s." % (
387
 
                        b.repository.base, revision_id)
388
 
                    raise errors.BzrCommandError(msg)
389
 
            elif revision is not None:
390
 
                for rev in revision:
391
 
                    if rev is None:
392
 
                        raise errors.BzrCommandError(
393
 
                            'You cannot specify a NULL revision.')
394
 
                    rev_id = rev.as_revision_id(b)
395
 
                    self.print_revision(revisions, rev_id)
396
 
        finally:
397
 
            b.repository.unlock()
398
 
        
 
350
        b = WorkingTree.open_containing(u'.')[0].branch
 
351
 
 
352
        # TODO: jam 20060112 should cat-revision always output utf-8?
 
353
        if revision_id is not None:
 
354
            revision_id = osutils.safe_revision_id(revision_id, warn=False)
 
355
            try:
 
356
                self.outf.write(b.repository.get_revision_xml(revision_id).decode('utf-8'))
 
357
            except errors.NoSuchRevision:
 
358
                msg = "The repository %s contains no revision %s." % (b.repository.base,
 
359
                    revision_id)
 
360
                raise errors.BzrCommandError(msg)
 
361
        elif revision is not None:
 
362
            for rev in revision:
 
363
                if rev is None:
 
364
                    raise errors.BzrCommandError('You cannot specify a NULL'
 
365
                                                 ' revision.')
 
366
                rev_id = rev.as_revision_id(b)
 
367
                self.outf.write(b.repository.get_revision_xml(rev_id).decode('utf-8'))
 
368
 
399
369
 
400
370
class cmd_dump_btree(Command):
401
 
    __doc__ = """Dump the contents of a btree index file to stdout.
 
371
    """Dump the contents of a btree index file to stdout.
402
372
 
403
373
    PATH is a btree index file, it can be any URL. This includes things like
404
374
    .bzr/repository/pack-names, or .bzr/repository/indices/a34b3a...ca4a4.iix
468
438
        for node in bt.iter_all_entries():
469
439
            # Node is made up of:
470
440
            # (index, key, value, [references])
471
 
            try:
472
 
                refs = node[3]
473
 
            except IndexError:
474
 
                refs_as_tuples = None
475
 
            else:
476
 
                refs_as_tuples = static_tuple.as_tuples(refs)
 
441
            refs_as_tuples = static_tuple.as_tuples(node[3])
477
442
            as_tuple = (tuple(node[1]), node[2], refs_as_tuples)
478
443
            self.outf.write('%s\n' % (as_tuple,))
479
444
 
480
445
 
481
446
class cmd_remove_tree(Command):
482
 
    __doc__ = """Remove the working tree from a given branch/checkout.
 
447
    """Remove the working tree from a given branch/checkout.
483
448
 
484
449
    Since a lightweight checkout is little more than a working tree
485
450
    this will refuse to run against one.
487
452
    To re-create the working tree, use "bzr checkout".
488
453
    """
489
454
    _see_also = ['checkout', 'working-trees']
490
 
    takes_args = ['location*']
 
455
    takes_args = ['location?']
491
456
    takes_options = [
492
457
        Option('force',
493
458
               help='Remove the working tree even if it has '
494
 
                    'uncommitted or shelved changes.'),
 
459
                    'uncommitted changes.'),
495
460
        ]
496
461
 
497
 
    def run(self, location_list, force=False):
498
 
        if not location_list:
499
 
            location_list=['.']
500
 
 
501
 
        for location in location_list:
502
 
            d = bzrdir.BzrDir.open(location)
503
 
            
504
 
            try:
505
 
                working = d.open_workingtree()
506
 
            except errors.NoWorkingTree:
507
 
                raise errors.BzrCommandError("No working tree to remove")
508
 
            except errors.NotLocalUrl:
509
 
                raise errors.BzrCommandError("You cannot remove the working tree"
510
 
                                             " of a remote path")
511
 
            if not force:
512
 
                if (working.has_changes()):
513
 
                    raise errors.UncommittedChanges(working)
514
 
                if working.get_shelf_manager().last_shelf() is not None:
515
 
                    raise errors.ShelvedChanges(working)
516
 
 
517
 
            if working.user_url != working.branch.user_url:
518
 
                raise errors.BzrCommandError("You cannot remove the working tree"
519
 
                                             " from a lightweight checkout")
520
 
 
521
 
            d.destroy_workingtree()
 
462
    def run(self, location='.', force=False):
 
463
        d = bzrdir.BzrDir.open(location)
 
464
 
 
465
        try:
 
466
            working = d.open_workingtree()
 
467
        except errors.NoWorkingTree:
 
468
            raise errors.BzrCommandError("No working tree to remove")
 
469
        except errors.NotLocalUrl:
 
470
            raise errors.BzrCommandError("You cannot remove the working tree"
 
471
                                         " of a remote path")
 
472
        if not force:
 
473
            if (working.has_changes()):
 
474
                raise errors.UncommittedChanges(working)
 
475
 
 
476
        working_path = working.bzrdir.root_transport.base
 
477
        branch_path = working.branch.bzrdir.root_transport.base
 
478
        if working_path != branch_path:
 
479
            raise errors.BzrCommandError("You cannot remove the working tree"
 
480
                                         " from a lightweight checkout")
 
481
 
 
482
        d.destroy_workingtree()
522
483
 
523
484
 
524
485
class cmd_revno(Command):
525
 
    __doc__ = """Show current revision number.
 
486
    """Show current revision number.
526
487
 
527
488
    This is equal to the number of revisions on this branch.
528
489
    """
538
499
        if tree:
539
500
            try:
540
501
                wt = WorkingTree.open_containing(location)[0]
541
 
                self.add_cleanup(wt.lock_read().unlock)
 
502
                wt.lock_read()
542
503
            except (errors.NoWorkingTree, errors.NotLocalUrl):
543
504
                raise errors.NoWorkingTree(location)
 
505
            self.add_cleanup(wt.unlock)
544
506
            revid = wt.last_revision()
545
507
            try:
546
508
                revno_t = wt.branch.revision_id_to_dotted_revno(revid)
549
511
            revno = ".".join(str(n) for n in revno_t)
550
512
        else:
551
513
            b = Branch.open_containing(location)[0]
552
 
            self.add_cleanup(b.lock_read().unlock)
 
514
            b.lock_read()
 
515
            self.add_cleanup(b.unlock)
553
516
            revno = b.revno()
554
517
        self.cleanup_now()
555
518
        self.outf.write(str(revno) + '\n')
556
519
 
557
520
 
558
521
class cmd_revision_info(Command):
559
 
    __doc__ = """Show revision number and revision id for a given revision identifier.
 
522
    """Show revision number and revision id for a given revision identifier.
560
523
    """
561
524
    hidden = True
562
525
    takes_args = ['revision_info*']
563
526
    takes_options = [
564
527
        'revision',
565
 
        custom_help('directory',
 
528
        Option('directory',
566
529
            help='Branch to examine, '
567
 
                 'rather than the one containing the working directory.'),
 
530
                 'rather than the one containing the working directory.',
 
531
            short_name='d',
 
532
            type=unicode,
 
533
            ),
568
534
        Option('tree', help='Show revno of working tree'),
569
535
        ]
570
536
 
575
541
        try:
576
542
            wt = WorkingTree.open_containing(directory)[0]
577
543
            b = wt.branch
578
 
            self.add_cleanup(wt.lock_read().unlock)
 
544
            wt.lock_read()
 
545
            self.add_cleanup(wt.unlock)
579
546
        except (errors.NoWorkingTree, errors.NotLocalUrl):
580
547
            wt = None
581
548
            b = Branch.open_containing(directory)[0]
582
 
            self.add_cleanup(b.lock_read().unlock)
 
549
            b.lock_read()
 
550
            self.add_cleanup(b.unlock)
583
551
        revision_ids = []
584
552
        if revision is not None:
585
553
            revision_ids.extend(rev.as_revision_id(b) for rev in revision)
613
581
 
614
582
 
615
583
class cmd_add(Command):
616
 
    __doc__ = """Add specified files or directories.
 
584
    """Add specified files or directories.
617
585
 
618
586
    In non-recursive mode, all the named items are added, regardless
619
587
    of whether they were previously ignored.  A warning is given if
684
652
                should_print=(not is_quiet()))
685
653
 
686
654
        if base_tree:
687
 
            self.add_cleanup(base_tree.lock_read().unlock)
 
655
            base_tree.lock_read()
 
656
            self.add_cleanup(base_tree.unlock)
688
657
        tree, file_list = tree_files_for_add(file_list)
689
658
        added, ignored = tree.smart_add(file_list, not
690
659
            no_recurse, action=action, save=not dry_run)
698
667
 
699
668
 
700
669
class cmd_mkdir(Command):
701
 
    __doc__ = """Create a new versioned directory.
 
670
    """Create a new versioned directory.
702
671
 
703
672
    This is equivalent to creating the directory and then adding it.
704
673
    """
708
677
 
709
678
    def run(self, dir_list):
710
679
        for d in dir_list:
 
680
            os.mkdir(d)
711
681
            wt, dd = WorkingTree.open_containing(d)
712
 
            base = os.path.dirname(dd)
713
 
            id = wt.path2id(base)
714
 
            if id != None:
715
 
                os.mkdir(d)
716
 
                wt.add([dd])
717
 
                self.outf.write('added %s\n' % d)
718
 
            else:
719
 
                raise errors.NotVersionedError(path=base)
 
682
            wt.add([dd])
 
683
            self.outf.write('added %s\n' % d)
720
684
 
721
685
 
722
686
class cmd_relpath(Command):
723
 
    __doc__ = """Show path of a file relative to root"""
 
687
    """Show path of a file relative to root"""
724
688
 
725
689
    takes_args = ['filename']
726
690
    hidden = True
735
699
 
736
700
 
737
701
class cmd_inventory(Command):
738
 
    __doc__ = """Show inventory of the current working copy or a revision.
 
702
    """Show inventory of the current working copy or a revision.
739
703
 
740
704
    It is possible to limit the output to a particular entry
741
705
    type using the --kind option.  For example: --kind file.
762
726
 
763
727
        revision = _get_one_revision('inventory', revision)
764
728
        work_tree, file_list = tree_files(file_list)
765
 
        self.add_cleanup(work_tree.lock_read().unlock)
 
729
        work_tree.lock_read()
 
730
        self.add_cleanup(work_tree.unlock)
766
731
        if revision is not None:
767
732
            tree = revision.as_tree(work_tree.branch)
768
733
 
769
734
            extra_trees = [work_tree]
770
 
            self.add_cleanup(tree.lock_read().unlock)
 
735
            tree.lock_read()
 
736
            self.add_cleanup(tree.unlock)
771
737
        else:
772
738
            tree = work_tree
773
739
            extra_trees = []
794
760
 
795
761
 
796
762
class cmd_mv(Command):
797
 
    __doc__ = """Move or rename a file.
 
763
    """Move or rename a file.
798
764
 
799
765
    :Usage:
800
766
        bzr mv OLDNAME NEWNAME
833
799
        if len(names_list) < 2:
834
800
            raise errors.BzrCommandError("missing file argument")
835
801
        tree, rel_names = tree_files(names_list, canonicalize=False)
836
 
        self.add_cleanup(tree.lock_tree_write().unlock)
 
802
        tree.lock_tree_write()
 
803
        self.add_cleanup(tree.unlock)
837
804
        self._run(tree, names_list, rel_names, after)
838
805
 
839
806
    def run_auto(self, names_list, after, dry_run):
844
811
            raise errors.BzrCommandError('--after cannot be specified with'
845
812
                                         ' --auto.')
846
813
        work_tree, file_list = tree_files(names_list, default_branch='.')
847
 
        self.add_cleanup(work_tree.lock_tree_write().unlock)
 
814
        work_tree.lock_tree_write()
 
815
        self.add_cleanup(work_tree.unlock)
848
816
        rename_map.RenameMap.guess_renames(work_tree, dry_run)
849
817
 
850
818
    def _run(self, tree, names_list, rel_names, after):
929
897
 
930
898
 
931
899
class cmd_pull(Command):
932
 
    __doc__ = """Turn this branch into a mirror of another branch.
 
900
    """Turn this branch into a mirror of another branch.
933
901
 
934
902
    By default, this command only works on branches that have not diverged.
935
903
    Branches are considered diverged if the destination branch's most recent 
958
926
    takes_options = ['remember', 'overwrite', 'revision',
959
927
        custom_help('verbose',
960
928
            help='Show logs of pulled revisions.'),
961
 
        custom_help('directory',
 
929
        Option('directory',
962
930
            help='Branch to pull into, '
963
 
                 'rather than the one containing the working directory.'),
 
931
                 'rather than the one containing the working directory.',
 
932
            short_name='d',
 
933
            type=unicode,
 
934
            ),
964
935
        Option('local',
965
936
            help="Perform a local pull in a bound "
966
937
                 "branch.  Local pulls are not applied to "
981
952
        try:
982
953
            tree_to = WorkingTree.open_containing(directory)[0]
983
954
            branch_to = tree_to.branch
984
 
            self.add_cleanup(tree_to.lock_write().unlock)
985
955
        except errors.NoWorkingTree:
986
956
            tree_to = None
987
957
            branch_to = Branch.open_containing(directory)[0]
988
 
            self.add_cleanup(branch_to.lock_write().unlock)
989
 
 
 
958
        
990
959
        if local and not branch_to.get_bound_location():
991
960
            raise errors.LocalRequiresBoundBranch()
992
961
 
1022
991
        else:
1023
992
            branch_from = Branch.open(location,
1024
993
                possible_transports=possible_transports)
1025
 
            self.add_cleanup(branch_from.lock_read().unlock)
1026
994
 
1027
995
            if branch_to.get_parent() is None or remember:
1028
996
                branch_to.set_parent(branch_from.base)
1029
997
 
 
998
        if branch_from is not branch_to:
 
999
            branch_from.lock_read()
 
1000
            self.add_cleanup(branch_from.unlock)
1030
1001
        if revision is not None:
1031
1002
            revision_id = revision.as_revision_id(branch_from)
1032
1003
 
 
1004
        branch_to.lock_write()
 
1005
        self.add_cleanup(branch_to.unlock)
1033
1006
        if tree_to is not None:
1034
1007
            view_info = _get_view_info_for_change_reporter(tree_to)
1035
1008
            change_reporter = delta._ChangeReporter(
1050
1023
 
1051
1024
 
1052
1025
class cmd_push(Command):
1053
 
    __doc__ = """Update a mirror of this branch.
 
1026
    """Update a mirror of this branch.
1054
1027
 
1055
1028
    The target branch will not have its working tree populated because this
1056
1029
    is both expensive, and is not supported on remote file systems.
1080
1053
        Option('create-prefix',
1081
1054
               help='Create the path leading up to the branch '
1082
1055
                    'if it does not already exist.'),
1083
 
        custom_help('directory',
 
1056
        Option('directory',
1084
1057
            help='Branch to push from, '
1085
 
                 'rather than the one containing the working directory.'),
 
1058
                 'rather than the one containing the working directory.',
 
1059
            short_name='d',
 
1060
            type=unicode,
 
1061
            ),
1086
1062
        Option('use-existing-dir',
1087
1063
               help='By default push will fail if the target'
1088
1064
                    ' directory exists, but does not already'
1114
1090
        # Get the source branch
1115
1091
        (tree, br_from,
1116
1092
         _unused) = bzrdir.BzrDir.open_containing_tree_or_branch(directory)
 
1093
        if strict is None:
 
1094
            strict = br_from.get_config().get_user_option_as_bool('push_strict')
 
1095
        if strict is None: strict = True # default value
1117
1096
        # Get the tip's revision_id
1118
1097
        revision = _get_one_revision('push', revision)
1119
1098
        if revision is not None:
1120
1099
            revision_id = revision.in_history(br_from).rev_id
1121
1100
        else:
1122
1101
            revision_id = None
1123
 
        if tree is not None and revision_id is None:
1124
 
            tree.check_changed_or_out_of_date(
1125
 
                strict, 'push_strict',
1126
 
                more_error='Use --no-strict to force the push.',
1127
 
                more_warning='Uncommitted changes will not be pushed.')
 
1102
        if strict and tree is not None and revision_id is None:
 
1103
            if (tree.has_changes()):
 
1104
                raise errors.UncommittedChanges(
 
1105
                    tree, more='Use --no-strict to force the push.')
 
1106
            if tree.last_revision() != tree.branch.last_revision():
 
1107
                # The tree has lost sync with its branch, there is little
 
1108
                # chance that the user is aware of it but he can still force
 
1109
                # the push with --no-strict
 
1110
                raise errors.OutOfDateTree(
 
1111
                    tree, more='Use --no-strict to force the push.')
 
1112
 
1128
1113
        # Get the stacked_on branch, if any
1129
1114
        if stacked_on is not None:
1130
1115
            stacked_on = urlutils.normalize_url(stacked_on)
1162
1147
 
1163
1148
 
1164
1149
class cmd_branch(Command):
1165
 
    __doc__ = """Create a new branch that is a copy of an existing branch.
 
1150
    """Create a new branch that is a copy of an existing branch.
1166
1151
 
1167
1152
    If the TO_LOCATION is omitted, the last component of the FROM_LOCATION will
1168
1153
    be used.  In other words, "branch ../foo/bar" will attempt to create ./bar.
1208
1193
        accelerator_tree, br_from = bzrdir.BzrDir.open_tree_or_branch(
1209
1194
            from_location)
1210
1195
        revision = _get_one_revision('branch', revision)
1211
 
        self.add_cleanup(br_from.lock_read().unlock)
 
1196
        br_from.lock_read()
 
1197
        self.add_cleanup(br_from.unlock)
1212
1198
        if revision is not None:
1213
1199
            revision_id = revision.as_revision_id(br_from)
1214
1200
        else:
1274
1260
 
1275
1261
 
1276
1262
class cmd_checkout(Command):
1277
 
    __doc__ = """Create a new checkout of an existing branch.
 
1263
    """Create a new checkout of an existing branch.
1278
1264
 
1279
1265
    If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
1280
1266
    the branch found in '.'. This is useful if you have removed the working tree
1343
1329
 
1344
1330
 
1345
1331
class cmd_renames(Command):
1346
 
    __doc__ = """Show list of renamed files.
 
1332
    """Show list of renamed files.
1347
1333
    """
1348
1334
    # TODO: Option to show renames between two historical versions.
1349
1335
 
1354
1340
    @display_command
1355
1341
    def run(self, dir=u'.'):
1356
1342
        tree = WorkingTree.open_containing(dir)[0]
1357
 
        self.add_cleanup(tree.lock_read().unlock)
 
1343
        tree.lock_read()
 
1344
        self.add_cleanup(tree.unlock)
1358
1345
        new_inv = tree.inventory
1359
1346
        old_tree = tree.basis_tree()
1360
 
        self.add_cleanup(old_tree.lock_read().unlock)
 
1347
        old_tree.lock_read()
 
1348
        self.add_cleanup(old_tree.unlock)
1361
1349
        old_inv = old_tree.inventory
1362
1350
        renames = []
1363
1351
        iterator = tree.iter_changes(old_tree, include_unchanged=True)
1373
1361
 
1374
1362
 
1375
1363
class cmd_update(Command):
1376
 
    __doc__ = """Update a tree to have the latest code committed to its branch.
 
1364
    """Update a tree to have the latest code committed to its branch.
1377
1365
 
1378
1366
    This will perform a merge into the working tree, and may generate
1379
1367
    conflicts. If you have any local changes, you will still
1401
1389
        master = branch.get_master_branch(
1402
1390
            possible_transports=possible_transports)
1403
1391
        if master is not None:
 
1392
            tree.lock_write()
1404
1393
            branch_location = master.base
1405
 
            tree.lock_write()
1406
1394
        else:
 
1395
            tree.lock_tree_write()
1407
1396
            branch_location = tree.branch.base
1408
 
            tree.lock_tree_write()
1409
1397
        self.add_cleanup(tree.unlock)
1410
1398
        # get rid of the final '/' and be ready for display
1411
 
        branch_location = urlutils.unescape_for_display(
1412
 
            branch_location.rstrip('/'),
1413
 
            self.outf.encoding)
 
1399
        branch_location = urlutils.unescape_for_display(branch_location[:-1],
 
1400
                                                        self.outf.encoding)
1414
1401
        existing_pending_merges = tree.get_parent_ids()[1:]
1415
1402
        if master is None:
1416
1403
            old_tip = None
1424
1411
        else:
1425
1412
            revision_id = branch.last_revision()
1426
1413
        if revision_id == _mod_revision.ensure_null(tree.last_revision()):
1427
 
            revno = branch.revision_id_to_dotted_revno(revision_id)
1428
 
            note("Tree is up to date at revision %s of branch %s" %
1429
 
                ('.'.join(map(str, revno)), branch_location))
 
1414
            revno = branch.revision_id_to_revno(revision_id)
 
1415
            note("Tree is up to date at revision %d of branch %s" %
 
1416
                (revno, branch_location))
1430
1417
            return 0
1431
1418
        view_info = _get_view_info_for_change_reporter(tree)
1432
1419
        change_reporter = delta._ChangeReporter(
1444
1431
                                  "bzr update --revision only works"
1445
1432
                                  " for a revision in the branch history"
1446
1433
                                  % (e.revision))
1447
 
        revno = tree.branch.revision_id_to_dotted_revno(
 
1434
        revno = tree.branch.revision_id_to_revno(
1448
1435
            _mod_revision.ensure_null(tree.last_revision()))
1449
 
        note('Updated to revision %s of branch %s' %
1450
 
             ('.'.join(map(str, revno)), branch_location))
1451
 
        parent_ids = tree.get_parent_ids()
1452
 
        if parent_ids[1:] and parent_ids[1:] != existing_pending_merges:
 
1436
        note('Updated to revision %d of branch %s' %
 
1437
             (revno, branch_location))
 
1438
        if tree.get_parent_ids()[1:] != existing_pending_merges:
1453
1439
            note('Your local commits will now show as pending merges with '
1454
1440
                 "'bzr status', and can be committed with 'bzr commit'.")
1455
1441
        if conflicts != 0:
1459
1445
 
1460
1446
 
1461
1447
class cmd_info(Command):
1462
 
    __doc__ = """Show information about a working tree, branch or repository.
 
1448
    """Show information about a working tree, branch or repository.
1463
1449
 
1464
1450
    This command will show all known locations and formats associated to the
1465
1451
    tree, branch or repository.
1503
1489
 
1504
1490
 
1505
1491
class cmd_remove(Command):
1506
 
    __doc__ = """Remove files or directories.
 
1492
    """Remove files or directories.
1507
1493
 
1508
1494
    This makes bzr stop tracking changes to the specified files. bzr will delete
1509
1495
    them if they can easily be recovered using revert. If no options or
1531
1517
        if file_list is not None:
1532
1518
            file_list = [f for f in file_list]
1533
1519
 
1534
 
        self.add_cleanup(tree.lock_write().unlock)
 
1520
        tree.lock_write()
 
1521
        self.add_cleanup(tree.unlock)
1535
1522
        # Heuristics should probably all move into tree.remove_smart or
1536
1523
        # some such?
1537
1524
        if new:
1556
1543
 
1557
1544
 
1558
1545
class cmd_file_id(Command):
1559
 
    __doc__ = """Print file_id of a particular file or directory.
 
1546
    """Print file_id of a particular file or directory.
1560
1547
 
1561
1548
    The file_id is assigned when the file is first added and remains the
1562
1549
    same through all revisions where the file exists, even when it is
1578
1565
 
1579
1566
 
1580
1567
class cmd_file_path(Command):
1581
 
    __doc__ = """Print path of file_ids to a file or directory.
 
1568
    """Print path of file_ids to a file or directory.
1582
1569
 
1583
1570
    This prints one line for each directory down to the target,
1584
1571
    starting at the branch root.
1600
1587
 
1601
1588
 
1602
1589
class cmd_reconcile(Command):
1603
 
    __doc__ = """Reconcile bzr metadata in a branch.
 
1590
    """Reconcile bzr metadata in a branch.
1604
1591
 
1605
1592
    This can correct data mismatches that may have been caused by
1606
1593
    previous ghost operations or bzr upgrades. You should only
1628
1615
 
1629
1616
 
1630
1617
class cmd_revision_history(Command):
1631
 
    __doc__ = """Display the list of revision ids on a branch."""
 
1618
    """Display the list of revision ids on a branch."""
1632
1619
 
1633
1620
    _see_also = ['log']
1634
1621
    takes_args = ['location?']
1644
1631
 
1645
1632
 
1646
1633
class cmd_ancestry(Command):
1647
 
    __doc__ = """List all revisions merged into this branch."""
 
1634
    """List all revisions merged into this branch."""
1648
1635
 
1649
1636
    _see_also = ['log', 'revision-history']
1650
1637
    takes_args = ['location?']
1669
1656
 
1670
1657
 
1671
1658
class cmd_init(Command):
1672
 
    __doc__ = """Make a directory into a versioned branch.
 
1659
    """Make a directory into a versioned branch.
1673
1660
 
1674
1661
    Use this to create an empty branch, or before importing an
1675
1662
    existing project.
1778
1765
 
1779
1766
 
1780
1767
class cmd_init_repository(Command):
1781
 
    __doc__ = """Create a shared repository for branches to share storage space.
 
1768
    """Create a shared repository for branches to share storage space.
1782
1769
 
1783
1770
    New branches created under the repository directory will store their
1784
1771
    revisions in the repository, not in the branch directory.  For branches
1838
1825
 
1839
1826
 
1840
1827
class cmd_diff(Command):
1841
 
    __doc__ = """Show differences in the working tree, between revisions or branches.
 
1828
    """Show differences in the working tree, between revisions or branches.
1842
1829
 
1843
1830
    If no arguments are given, all changes for the current tree are listed.
1844
1831
    If files are given, only the changes in those files are listed.
1930
1917
            help='Use this command to compare files.',
1931
1918
            type=unicode,
1932
1919
            ),
1933
 
        RegistryOption('format',
1934
 
            help='Diff format to use.',
1935
 
            lazy_registry=('bzrlib.diff', 'format_registry'),
1936
 
            value_switches=False, title='Diff format'),
1937
1920
        ]
1938
1921
    aliases = ['di', 'dif']
1939
1922
    encoding_type = 'exact'
1940
1923
 
1941
1924
    @display_command
1942
1925
    def run(self, revision=None, file_list=None, diff_options=None,
1943
 
            prefix=None, old=None, new=None, using=None, format=None):
1944
 
        from bzrlib.diff import (get_trees_and_branches_to_diff_locked,
1945
 
            show_diff_trees)
 
1926
            prefix=None, old=None, new=None, using=None):
 
1927
        from bzrlib.diff import get_trees_and_branches_to_diff, show_diff_trees
1946
1928
 
1947
1929
        if (prefix is None) or (prefix == '0'):
1948
1930
            # diff -p0 format
1962
1944
            raise errors.BzrCommandError('bzr diff --revision takes exactly'
1963
1945
                                         ' one or two revision specifiers')
1964
1946
 
1965
 
        if using is not None and format is not None:
1966
 
            raise errors.BzrCommandError('--using and --format are mutually '
1967
 
                'exclusive.')
1968
 
 
1969
1947
        (old_tree, new_tree,
1970
1948
         old_branch, new_branch,
1971
 
         specific_files, extra_trees) = get_trees_and_branches_to_diff_locked(
1972
 
            file_list, revision, old, new, self.add_cleanup, apply_view=True)
1973
 
        # GNU diff on Windows uses ANSI encoding for filenames
1974
 
        path_encoding = osutils.get_diff_header_encoding()
 
1949
         specific_files, extra_trees) = get_trees_and_branches_to_diff(
 
1950
            file_list, revision, old, new, apply_view=True)
1975
1951
        return show_diff_trees(old_tree, new_tree, sys.stdout,
1976
1952
                               specific_files=specific_files,
1977
1953
                               external_diff_options=diff_options,
1978
1954
                               old_label=old_label, new_label=new_label,
1979
 
                               extra_trees=extra_trees,
1980
 
                               path_encoding=path_encoding,
1981
 
                               using=using,
1982
 
                               format_cls=format)
 
1955
                               extra_trees=extra_trees, using=using)
1983
1956
 
1984
1957
 
1985
1958
class cmd_deleted(Command):
1986
 
    __doc__ = """List files deleted in the working tree.
 
1959
    """List files deleted in the working tree.
1987
1960
    """
1988
1961
    # TODO: Show files deleted since a previous revision, or
1989
1962
    # between two revisions.
1992
1965
    # level of effort but possibly much less IO.  (Or possibly not,
1993
1966
    # if the directories are very large...)
1994
1967
    _see_also = ['status', 'ls']
1995
 
    takes_options = ['directory', 'show-ids']
 
1968
    takes_options = ['show-ids']
1996
1969
 
1997
1970
    @display_command
1998
 
    def run(self, show_ids=False, directory=u'.'):
1999
 
        tree = WorkingTree.open_containing(directory)[0]
2000
 
        self.add_cleanup(tree.lock_read().unlock)
 
1971
    def run(self, show_ids=False):
 
1972
        tree = WorkingTree.open_containing(u'.')[0]
 
1973
        tree.lock_read()
 
1974
        self.add_cleanup(tree.unlock)
2001
1975
        old = tree.basis_tree()
2002
 
        self.add_cleanup(old.lock_read().unlock)
 
1976
        old.lock_read()
 
1977
        self.add_cleanup(old.unlock)
2003
1978
        for path, ie in old.inventory.iter_entries():
2004
1979
            if not tree.has_id(ie.file_id):
2005
1980
                self.outf.write(path)
2010
1985
 
2011
1986
 
2012
1987
class cmd_modified(Command):
2013
 
    __doc__ = """List files modified in working tree.
 
1988
    """List files modified in working tree.
2014
1989
    """
2015
1990
 
2016
1991
    hidden = True
2017
1992
    _see_also = ['status', 'ls']
2018
 
    takes_options = ['directory', 'null']
 
1993
    takes_options = [
 
1994
            Option('null',
 
1995
                   help='Write an ascii NUL (\\0) separator '
 
1996
                   'between files rather than a newline.')
 
1997
            ]
2019
1998
 
2020
1999
    @display_command
2021
 
    def run(self, null=False, directory=u'.'):
2022
 
        tree = WorkingTree.open_containing(directory)[0]
 
2000
    def run(self, null=False):
 
2001
        tree = WorkingTree.open_containing(u'.')[0]
2023
2002
        td = tree.changes_from(tree.basis_tree())
2024
2003
        for path, id, kind, text_modified, meta_modified in td.modified:
2025
2004
            if null:
2029
2008
 
2030
2009
 
2031
2010
class cmd_added(Command):
2032
 
    __doc__ = """List files added in working tree.
 
2011
    """List files added in working tree.
2033
2012
    """
2034
2013
 
2035
2014
    hidden = True
2036
2015
    _see_also = ['status', 'ls']
2037
 
    takes_options = ['directory', 'null']
 
2016
    takes_options = [
 
2017
            Option('null',
 
2018
                   help='Write an ascii NUL (\\0) separator '
 
2019
                   'between files rather than a newline.')
 
2020
            ]
2038
2021
 
2039
2022
    @display_command
2040
 
    def run(self, null=False, directory=u'.'):
2041
 
        wt = WorkingTree.open_containing(directory)[0]
2042
 
        self.add_cleanup(wt.lock_read().unlock)
 
2023
    def run(self, null=False):
 
2024
        wt = WorkingTree.open_containing(u'.')[0]
 
2025
        wt.lock_read()
 
2026
        self.add_cleanup(wt.unlock)
2043
2027
        basis = wt.basis_tree()
2044
 
        self.add_cleanup(basis.lock_read().unlock)
 
2028
        basis.lock_read()
 
2029
        self.add_cleanup(basis.unlock)
2045
2030
        basis_inv = basis.inventory
2046
2031
        inv = wt.inventory
2047
2032
        for file_id in inv:
2050
2035
            if inv.is_root(file_id) and len(basis_inv) == 0:
2051
2036
                continue
2052
2037
            path = inv.id2path(file_id)
2053
 
            if not os.access(osutils.pathjoin(wt.basedir, path), os.F_OK):
 
2038
            if not os.access(osutils.abspath(path), os.F_OK):
2054
2039
                continue
2055
2040
            if null:
2056
2041
                self.outf.write(path + '\0')
2059
2044
 
2060
2045
 
2061
2046
class cmd_root(Command):
2062
 
    __doc__ = """Show the tree root directory.
 
2047
    """Show the tree root directory.
2063
2048
 
2064
2049
    The root is the nearest enclosing directory with a .bzr control
2065
2050
    directory."""
2089
2074
 
2090
2075
 
2091
2076
class cmd_log(Command):
2092
 
    __doc__ = """Show historical log for a branch or subset of a branch.
 
2077
    """Show historical log for a branch or subset of a branch.
2093
2078
 
2094
2079
    log is bzr's default tool for exploring the history of a branch.
2095
2080
    The branch to use is taken from the first parameter. If no parameters
2256
2241
                   help='Show just the specified revision.'
2257
2242
                   ' See also "help revisionspec".'),
2258
2243
            'log-format',
2259
 
            RegistryOption('authors',
2260
 
                'What names to list as authors - first, all or committer.',
2261
 
                title='Authors',
2262
 
                lazy_registry=('bzrlib.log', 'author_list_registry'),
2263
 
            ),
2264
2244
            Option('levels',
2265
2245
                   short_name='n',
2266
2246
                   help='Number of levels to display - 0 for all, 1 for flat.',
2281
2261
                   help='Show changes made in each revision as a patch.'),
2282
2262
            Option('include-merges',
2283
2263
                   help='Show merged revisions like --levels 0 does.'),
2284
 
            Option('exclude-common-ancestry',
2285
 
                   help='Display only the revisions that are not part'
2286
 
                   ' of both ancestries (require -rX..Y)'
2287
 
                   )
2288
2264
            ]
2289
2265
    encoding_type = 'replace'
2290
2266
 
2300
2276
            message=None,
2301
2277
            limit=None,
2302
2278
            show_diff=False,
2303
 
            include_merges=False,
2304
 
            authors=None,
2305
 
            exclude_common_ancestry=False,
2306
 
            ):
 
2279
            include_merges=False):
2307
2280
        from bzrlib.log import (
2308
2281
            Logger,
2309
2282
            make_log_request_dict,
2310
2283
            _get_info_for_log_files,
2311
2284
            )
2312
2285
        direction = (forward and 'forward') or 'reverse'
2313
 
        if (exclude_common_ancestry
2314
 
            and (revision is None or len(revision) != 2)):
2315
 
            raise errors.BzrCommandError(
2316
 
                '--exclude-common-ancestry requires -r with two revisions')
2317
2286
        if include_merges:
2318
2287
            if levels is None:
2319
2288
                levels = 0
2335
2304
        if file_list:
2336
2305
            # find the file ids to log and check for directory filtering
2337
2306
            b, file_info_list, rev1, rev2 = _get_info_for_log_files(
2338
 
                revision, file_list, self.add_cleanup)
 
2307
                revision, file_list)
 
2308
            self.add_cleanup(b.unlock)
2339
2309
            for relpath, file_id, kind in file_info_list:
2340
2310
                if file_id is None:
2341
2311
                    raise errors.BzrCommandError(
2359
2329
                location = '.'
2360
2330
            dir, relpath = bzrdir.BzrDir.open_containing(location)
2361
2331
            b = dir.open_branch()
2362
 
            self.add_cleanup(b.lock_read().unlock)
 
2332
            b.lock_read()
 
2333
            self.add_cleanup(b.unlock)
2363
2334
            rev1, rev2 = _get_revision_range(revision, b, self.name())
2364
2335
 
2365
2336
        # Decide on the type of delta & diff filtering to use
2385
2356
                        show_timezone=timezone,
2386
2357
                        delta_format=get_verbosity_level(),
2387
2358
                        levels=levels,
2388
 
                        show_advice=levels is None,
2389
 
                        author_list_handler=authors)
 
2359
                        show_advice=levels is None)
2390
2360
 
2391
2361
        # Choose the algorithm for doing the logging. It's annoying
2392
2362
        # having multiple code paths like this but necessary until
2411
2381
            direction=direction, specific_fileids=file_ids,
2412
2382
            start_revision=rev1, end_revision=rev2, limit=limit,
2413
2383
            message_search=message, delta_type=delta_type,
2414
 
            diff_type=diff_type, _match_using_deltas=match_using_deltas,
2415
 
            exclude_common_ancestry=exclude_common_ancestry,
2416
 
            )
 
2384
            diff_type=diff_type, _match_using_deltas=match_using_deltas)
2417
2385
        Logger(b, rqst).show(lf)
2418
2386
 
2419
2387
 
2438
2406
            raise errors.BzrCommandError(
2439
2407
                "bzr %s doesn't accept two revisions in different"
2440
2408
                " branches." % command_name)
2441
 
        if start_spec.spec is None:
2442
 
            # Avoid loading all the history.
2443
 
            rev1 = RevisionInfo(branch, None, None)
2444
 
        else:
2445
 
            rev1 = start_spec.in_history(branch)
 
2409
        rev1 = start_spec.in_history(branch)
2446
2410
        # Avoid loading all of history when we know a missing
2447
2411
        # end of range means the last revision ...
2448
2412
        if end_spec.spec is None:
2477
2441
 
2478
2442
 
2479
2443
class cmd_touching_revisions(Command):
2480
 
    __doc__ = """Return revision-ids which affected a particular file.
 
2444
    """Return revision-ids which affected a particular file.
2481
2445
 
2482
2446
    A more user-friendly interface is "bzr log FILE".
2483
2447
    """
2490
2454
        tree, relpath = WorkingTree.open_containing(filename)
2491
2455
        file_id = tree.path2id(relpath)
2492
2456
        b = tree.branch
2493
 
        self.add_cleanup(b.lock_read().unlock)
 
2457
        b.lock_read()
 
2458
        self.add_cleanup(b.unlock)
2494
2459
        touching_revs = log.find_touching_revisions(b, file_id)
2495
2460
        for revno, revision_id, what in touching_revs:
2496
2461
            self.outf.write("%6d %s\n" % (revno, what))
2497
2462
 
2498
2463
 
2499
2464
class cmd_ls(Command):
2500
 
    __doc__ = """List files in a tree.
 
2465
    """List files in a tree.
2501
2466
    """
2502
2467
 
2503
2468
    _see_also = ['status', 'cat']
2509
2474
                   help='Recurse into subdirectories.'),
2510
2475
            Option('from-root',
2511
2476
                   help='Print paths relative to the root of the branch.'),
2512
 
            Option('unknown', short_name='u',
2513
 
                help='Print unknown files.'),
 
2477
            Option('unknown', help='Print unknown files.'),
2514
2478
            Option('versioned', help='Print versioned files.',
2515
2479
                   short_name='V'),
2516
 
            Option('ignored', short_name='i',
2517
 
                help='Print ignored files.'),
2518
 
            Option('kind', short_name='k',
 
2480
            Option('ignored', help='Print ignored files.'),
 
2481
            Option('null',
 
2482
                   help='Write an ascii NUL (\\0) separator '
 
2483
                   'between files rather than a newline.'),
 
2484
            Option('kind',
2519
2485
                   help='List entries of a particular kind: file, directory, symlink.',
2520
2486
                   type=unicode),
2521
 
            'null',
2522
2487
            'show-ids',
2523
 
            'directory',
2524
2488
            ]
2525
2489
    @display_command
2526
2490
    def run(self, revision=None, verbose=False,
2527
2491
            recursive=False, from_root=False,
2528
2492
            unknown=False, versioned=False, ignored=False,
2529
 
            null=False, kind=None, show_ids=False, path=None, directory=None):
 
2493
            null=False, kind=None, show_ids=False, path=None):
2530
2494
 
2531
2495
        if kind and kind not in ('file', 'directory', 'symlink'):
2532
2496
            raise errors.BzrCommandError('invalid kind specified')
2544
2508
                raise errors.BzrCommandError('cannot specify both --from-root'
2545
2509
                                             ' and PATH')
2546
2510
            fs_path = path
2547
 
        tree, branch, relpath = \
2548
 
            _open_directory_or_containing_tree_or_branch(fs_path, directory)
 
2511
        tree, branch, relpath = bzrdir.BzrDir.open_containing_tree_or_branch(
 
2512
            fs_path)
2549
2513
 
2550
2514
        # Calculate the prefix to use
2551
2515
        prefix = None
2566
2530
                view_str = views.view_display_str(view_files)
2567
2531
                note("Ignoring files outside view. View is %s" % view_str)
2568
2532
 
2569
 
        self.add_cleanup(tree.lock_read().unlock)
 
2533
        tree.lock_read()
 
2534
        self.add_cleanup(tree.unlock)
2570
2535
        for fp, fc, fkind, fid, entry in tree.list_files(include_root=False,
2571
2536
            from_dir=relpath, recursive=recursive):
2572
2537
            # Apply additional masking
2614
2579
 
2615
2580
 
2616
2581
class cmd_unknowns(Command):
2617
 
    __doc__ = """List unknown files.
 
2582
    """List unknown files.
2618
2583
    """
2619
2584
 
2620
2585
    hidden = True
2621
2586
    _see_also = ['ls']
2622
 
    takes_options = ['directory']
2623
2587
 
2624
2588
    @display_command
2625
 
    def run(self, directory=u'.'):
2626
 
        for f in WorkingTree.open_containing(directory)[0].unknowns():
 
2589
    def run(self):
 
2590
        for f in WorkingTree.open_containing(u'.')[0].unknowns():
2627
2591
            self.outf.write(osutils.quotefn(f) + '\n')
2628
2592
 
2629
2593
 
2630
2594
class cmd_ignore(Command):
2631
 
    __doc__ = """Ignore specified files or patterns.
 
2595
    """Ignore specified files or patterns.
2632
2596
 
2633
2597
    See ``bzr help patterns`` for details on the syntax of patterns.
2634
2598
 
2643
2607
    using this command or directly by using an editor, be sure to commit
2644
2608
    it.
2645
2609
    
2646
 
    Bazaar also supports a global ignore file ~/.bazaar/ignore. On Windows
2647
 
    the global ignore file can be found in the application data directory as
2648
 
    C:\\Documents and Settings\\<user>\\Application Data\\Bazaar\\2.0\\ignore.
2649
 
    Global ignores are not touched by this command. The global ignore file
2650
 
    can be edited directly using an editor.
2651
 
 
2652
2610
    Patterns prefixed with '!' are exceptions to ignore patterns and take
2653
2611
    precedence over regular ignores.  Such exceptions are used to specify
2654
2612
    files that should be versioned which would otherwise be ignored.
2694
2652
 
2695
2653
    _see_also = ['status', 'ignored', 'patterns']
2696
2654
    takes_args = ['name_pattern*']
2697
 
    takes_options = ['directory',
2698
 
        Option('default-rules',
2699
 
               help='Display the default ignore rules that bzr uses.')
 
2655
    takes_options = [
 
2656
        Option('old-default-rules',
 
2657
               help='Write out the ignore rules bzr < 0.9 always used.')
2700
2658
        ]
2701
2659
 
2702
 
    def run(self, name_pattern_list=None, default_rules=None,
2703
 
            directory=u'.'):
 
2660
    def run(self, name_pattern_list=None, old_default_rules=None):
2704
2661
        from bzrlib import ignores
2705
 
        if default_rules is not None:
2706
 
            # dump the default rules and exit
2707
 
            for pattern in ignores.USER_DEFAULTS:
2708
 
                self.outf.write("%s\n" % pattern)
 
2662
        if old_default_rules is not None:
 
2663
            # dump the rules and exit
 
2664
            for pattern in ignores.OLD_DEFAULTS:
 
2665
                print pattern
2709
2666
            return
2710
2667
        if not name_pattern_list:
2711
2668
            raise errors.BzrCommandError("ignore requires at least one "
2712
 
                "NAME_PATTERN or --default-rules.")
 
2669
                                  "NAME_PATTERN or --old-default-rules")
2713
2670
        name_pattern_list = [globbing.normalize_pattern(p)
2714
2671
                             for p in name_pattern_list]
2715
 
        bad_patterns = ''
2716
 
        for p in name_pattern_list:
2717
 
            if not globbing.Globster.is_pattern_valid(p):
2718
 
                bad_patterns += ('\n  %s' % p)
2719
 
        if bad_patterns:
2720
 
            msg = ('Invalid ignore pattern(s) found. %s' % bad_patterns)
2721
 
            ui.ui_factory.show_error(msg)
2722
 
            raise errors.InvalidPattern('')
2723
2672
        for name_pattern in name_pattern_list:
2724
2673
            if (name_pattern[0] == '/' or
2725
2674
                (len(name_pattern) > 1 and name_pattern[1] == ':')):
2726
2675
                raise errors.BzrCommandError(
2727
2676
                    "NAME_PATTERN should not be an absolute path")
2728
 
        tree, relpath = WorkingTree.open_containing(directory)
 
2677
        tree, relpath = WorkingTree.open_containing(u'.')
2729
2678
        ignores.tree_ignores_add_patterns(tree, name_pattern_list)
2730
2679
        ignored = globbing.Globster(name_pattern_list)
2731
2680
        matches = []
2732
 
        self.add_cleanup(tree.lock_read().unlock)
 
2681
        tree.lock_read()
2733
2682
        for entry in tree.list_files():
2734
2683
            id = entry[3]
2735
2684
            if id is not None:
2736
2685
                filename = entry[0]
2737
2686
                if ignored.match(filename):
2738
 
                    matches.append(filename)
 
2687
                    matches.append(filename.encode('utf-8'))
 
2688
        tree.unlock()
2739
2689
        if len(matches) > 0:
2740
 
            self.outf.write("Warning: the following files are version controlled and"
2741
 
                  " match your ignore pattern:\n%s"
2742
 
                  "\nThese files will continue to be version controlled"
2743
 
                  " unless you 'bzr remove' them.\n" % ("\n".join(matches),))
 
2690
            print "Warning: the following files are version controlled and" \
 
2691
                  " match your ignore pattern:\n%s" \
 
2692
                  "\nThese files will continue to be version controlled" \
 
2693
                  " unless you 'bzr remove' them." % ("\n".join(matches),)
2744
2694
 
2745
2695
 
2746
2696
class cmd_ignored(Command):
2747
 
    __doc__ = """List ignored files and the patterns that matched them.
 
2697
    """List ignored files and the patterns that matched them.
2748
2698
 
2749
2699
    List all the ignored files and the ignore pattern that caused the file to
2750
2700
    be ignored.
2756
2706
 
2757
2707
    encoding_type = 'replace'
2758
2708
    _see_also = ['ignore', 'ls']
2759
 
    takes_options = ['directory']
2760
2709
 
2761
2710
    @display_command
2762
 
    def run(self, directory=u'.'):
2763
 
        tree = WorkingTree.open_containing(directory)[0]
2764
 
        self.add_cleanup(tree.lock_read().unlock)
 
2711
    def run(self):
 
2712
        tree = WorkingTree.open_containing(u'.')[0]
 
2713
        tree.lock_read()
 
2714
        self.add_cleanup(tree.unlock)
2765
2715
        for path, file_class, kind, file_id, entry in tree.list_files():
2766
2716
            if file_class != 'I':
2767
2717
                continue
2771
2721
 
2772
2722
 
2773
2723
class cmd_lookup_revision(Command):
2774
 
    __doc__ = """Lookup the revision-id from a revision-number
 
2724
    """Lookup the revision-id from a revision-number
2775
2725
 
2776
2726
    :Examples:
2777
2727
        bzr lookup-revision 33
2778
2728
    """
2779
2729
    hidden = True
2780
2730
    takes_args = ['revno']
2781
 
    takes_options = ['directory']
2782
2731
 
2783
2732
    @display_command
2784
 
    def run(self, revno, directory=u'.'):
 
2733
    def run(self, revno):
2785
2734
        try:
2786
2735
            revno = int(revno)
2787
2736
        except ValueError:
2788
 
            raise errors.BzrCommandError("not a valid revision-number: %r"
2789
 
                                         % revno)
2790
 
        revid = WorkingTree.open_containing(directory)[0].branch.get_rev_id(revno)
2791
 
        self.outf.write("%s\n" % revid)
 
2737
            raise errors.BzrCommandError("not a valid revision-number: %r" % revno)
 
2738
 
 
2739
        print WorkingTree.open_containing(u'.')[0].branch.get_rev_id(revno)
2792
2740
 
2793
2741
 
2794
2742
class cmd_export(Command):
2795
 
    __doc__ = """Export current or past revision to a destination directory or archive.
 
2743
    """Export current or past revision to a destination directory or archive.
2796
2744
 
2797
2745
    If no revision is specified this exports the last committed revision.
2798
2746
 
2820
2768
      =================       =========================
2821
2769
    """
2822
2770
    takes_args = ['dest', 'branch_or_subdir?']
2823
 
    takes_options = ['directory',
 
2771
    takes_options = [
2824
2772
        Option('format',
2825
2773
               help="Type of file to export to.",
2826
2774
               type=unicode),
2830
2778
        Option('root',
2831
2779
               type=str,
2832
2780
               help="Name of the root directory inside the exported file."),
2833
 
        Option('per-file-timestamps',
2834
 
               help='Set modification time of files to that of the last '
2835
 
                    'revision in which it was changed.'),
2836
2781
        ]
2837
2782
    def run(self, dest, branch_or_subdir=None, revision=None, format=None,
2838
 
        root=None, filters=False, per_file_timestamps=False, directory=u'.'):
 
2783
        root=None, filters=False):
2839
2784
        from bzrlib.export import export
2840
2785
 
2841
2786
        if branch_or_subdir is None:
2842
 
            tree = WorkingTree.open_containing(directory)[0]
 
2787
            tree = WorkingTree.open_containing(u'.')[0]
2843
2788
            b = tree.branch
2844
2789
            subdir = None
2845
2790
        else:
2848
2793
 
2849
2794
        rev_tree = _get_one_revision_tree('export', revision, branch=b, tree=tree)
2850
2795
        try:
2851
 
            export(rev_tree, dest, format, root, subdir, filtered=filters,
2852
 
                   per_file_timestamps=per_file_timestamps)
 
2796
            export(rev_tree, dest, format, root, subdir, filtered=filters)
2853
2797
        except errors.NoSuchExportFormat, e:
2854
2798
            raise errors.BzrCommandError('Unsupported export format: %s' % e.format)
2855
2799
 
2856
2800
 
2857
2801
class cmd_cat(Command):
2858
 
    __doc__ = """Write the contents of a file as of a given revision to standard output.
 
2802
    """Write the contents of a file as of a given revision to standard output.
2859
2803
 
2860
2804
    If no revision is nominated, the last revision is used.
2861
2805
 
2864
2808
    """
2865
2809
 
2866
2810
    _see_also = ['ls']
2867
 
    takes_options = ['directory',
 
2811
    takes_options = [
2868
2812
        Option('name-from-revision', help='The path name in the old tree.'),
2869
2813
        Option('filters', help='Apply content filters to display the '
2870
2814
                'convenience form.'),
2875
2819
 
2876
2820
    @display_command
2877
2821
    def run(self, filename, revision=None, name_from_revision=False,
2878
 
            filters=False, directory=None):
 
2822
            filters=False):
2879
2823
        if revision is not None and len(revision) != 1:
2880
2824
            raise errors.BzrCommandError("bzr cat --revision takes exactly"
2881
2825
                                         " one revision specifier")
2882
2826
        tree, branch, relpath = \
2883
 
            _open_directory_or_containing_tree_or_branch(filename, directory)
2884
 
        self.add_cleanup(branch.lock_read().unlock)
 
2827
            bzrdir.BzrDir.open_containing_tree_or_branch(filename)
 
2828
        branch.lock_read()
 
2829
        self.add_cleanup(branch.unlock)
2885
2830
        return self._run(tree, branch, relpath, filename, revision,
2886
2831
                         name_from_revision, filters)
2887
2832
 
2890
2835
        if tree is None:
2891
2836
            tree = b.basis_tree()
2892
2837
        rev_tree = _get_one_revision_tree('cat', revision, branch=b)
2893
 
        self.add_cleanup(rev_tree.lock_read().unlock)
 
2838
        rev_tree.lock_read()
 
2839
        self.add_cleanup(rev_tree.unlock)
2894
2840
 
2895
2841
        old_file_id = rev_tree.path2id(relpath)
2896
2842
 
2939
2885
 
2940
2886
 
2941
2887
class cmd_local_time_offset(Command):
2942
 
    __doc__ = """Show the offset in seconds from GMT to local time."""
 
2888
    """Show the offset in seconds from GMT to local time."""
2943
2889
    hidden = True
2944
2890
    @display_command
2945
2891
    def run(self):
2946
 
        self.outf.write("%s\n" % osutils.local_time_offset())
 
2892
        print osutils.local_time_offset()
2947
2893
 
2948
2894
 
2949
2895
 
2950
2896
class cmd_commit(Command):
2951
 
    __doc__ = """Commit changes into a new revision.
 
2897
    """Commit changes into a new revision.
2952
2898
 
2953
2899
    An explanatory message needs to be given for each commit. This is
2954
2900
    often done by using the --message option (getting the message from the
3062
3008
                         "the master branch until a normal commit "
3063
3009
                         "is performed."
3064
3010
                    ),
3065
 
             Option('show-diff', short_name='p',
 
3011
             Option('show-diff',
3066
3012
                    help='When no message is supplied, show the diff along'
3067
3013
                    ' with the status summary in the message editor.'),
3068
3014
             ]
3148
3094
                    '(use --file "%(f)s" to take commit message from that file)'
3149
3095
                    % { 'f': message })
3150
3096
                ui.ui_factory.show_warning(warning_msg)
3151
 
            if '\r' in message:
3152
 
                message = message.replace('\r\n', '\n')
3153
 
                message = message.replace('\r', '\n')
3154
 
            if file:
3155
 
                raise errors.BzrCommandError(
3156
 
                    "please specify either --message or --file")
3157
3097
 
3158
3098
        def get_message(commit_obj):
3159
3099
            """Callback to get commit message"""
3160
 
            if file:
3161
 
                f = codecs.open(file, 'rt', osutils.get_user_encoding())
3162
 
                try:
3163
 
                    my_message = f.read()
3164
 
                finally:
3165
 
                    f.close()
3166
 
            elif message is not None:
3167
 
                my_message = message
3168
 
            else:
3169
 
                # No message supplied: make one up.
3170
 
                # text is the status of the tree
3171
 
                text = make_commit_message_template_encoded(tree,
 
3100
            my_message = message
 
3101
            if my_message is not None and '\r' in my_message:
 
3102
                my_message = my_message.replace('\r\n', '\n')
 
3103
                my_message = my_message.replace('\r', '\n')
 
3104
            if my_message is None and not file:
 
3105
                t = make_commit_message_template_encoded(tree,
3172
3106
                        selected_list, diff=show_diff,
3173
3107
                        output_encoding=osutils.get_user_encoding())
3174
 
                # start_message is the template generated from hooks
3175
 
                # XXX: Warning - looks like hooks return unicode,
3176
 
                # make_commit_message_template_encoded returns user encoding.
3177
 
                # We probably want to be using edit_commit_message instead to
3178
 
                # avoid this.
3179
3108
                start_message = generate_commit_message_template(commit_obj)
3180
 
                my_message = edit_commit_message_encoded(text,
 
3109
                my_message = edit_commit_message_encoded(t,
3181
3110
                    start_message=start_message)
3182
3111
                if my_message is None:
3183
3112
                    raise errors.BzrCommandError("please specify a commit"
3184
3113
                        " message with either --message or --file")
 
3114
            elif my_message and file:
 
3115
                raise errors.BzrCommandError(
 
3116
                    "please specify either --message or --file")
 
3117
            if file:
 
3118
                my_message = codecs.open(file, 'rt',
 
3119
                                         osutils.get_user_encoding()).read()
3185
3120
            if my_message == "":
3186
3121
                raise errors.BzrCommandError("empty commit message specified")
3187
3122
            return my_message
3199
3134
                        timezone=offset,
3200
3135
                        exclude=safe_relpath_files(tree, exclude))
3201
3136
        except PointlessCommit:
 
3137
            # FIXME: This should really happen before the file is read in;
 
3138
            # perhaps prepare the commit; get the message; then actually commit
3202
3139
            raise errors.BzrCommandError("No changes to commit."
3203
3140
                              " Use --unchanged to commit anyhow.")
3204
3141
        except ConflictsInTree:
3209
3146
            raise errors.BzrCommandError("Commit refused because there are"
3210
3147
                              " unknown files in the working tree.")
3211
3148
        except errors.BoundBranchOutOfDate, e:
3212
 
            e.extra_help = ("\n"
3213
 
                'To commit to master branch, run update and then commit.\n'
3214
 
                'You can also pass --local to commit to continue working '
3215
 
                'disconnected.')
3216
 
            raise
 
3149
            raise errors.BzrCommandError(str(e) + "\n"
 
3150
            'To commit to master branch, run update and then commit.\n'
 
3151
            'You can also pass --local to commit to continue working '
 
3152
            'disconnected.')
3217
3153
 
3218
3154
 
3219
3155
class cmd_check(Command):
3220
 
    __doc__ = """Validate working tree structure, branch consistency and repository history.
 
3156
    """Validate working tree structure, branch consistency and repository history.
3221
3157
 
3222
3158
    This command checks various invariants about branch and repository storage
3223
3159
    to detect data corruption or bzr bugs.
3287
3223
 
3288
3224
 
3289
3225
class cmd_upgrade(Command):
3290
 
    __doc__ = """Upgrade branch storage to current format.
 
3226
    """Upgrade branch storage to current format.
3291
3227
 
3292
3228
    The check command or bzr developers may sometimes advise you to run
3293
3229
    this command. When the default format has changed you may also be warned
3311
3247
 
3312
3248
 
3313
3249
class cmd_whoami(Command):
3314
 
    __doc__ = """Show or set bzr user id.
 
3250
    """Show or set bzr user id.
3315
3251
 
3316
3252
    :Examples:
3317
3253
        Show the email of the current user::
3322
3258
 
3323
3259
            bzr whoami "Frank Chu <fchu@example.com>"
3324
3260
    """
3325
 
    takes_options = [ 'directory',
3326
 
                      Option('email',
 
3261
    takes_options = [ Option('email',
3327
3262
                             help='Display email address only.'),
3328
3263
                      Option('branch',
3329
3264
                             help='Set identity for the current branch instead of '
3333
3268
    encoding_type = 'replace'
3334
3269
 
3335
3270
    @display_command
3336
 
    def run(self, email=False, branch=False, name=None, directory=None):
 
3271
    def run(self, email=False, branch=False, name=None):
3337
3272
        if name is None:
3338
 
            if directory is None:
3339
 
                # use branch if we're inside one; otherwise global config
3340
 
                try:
3341
 
                    c = Branch.open_containing(u'.')[0].get_config()
3342
 
                except errors.NotBranchError:
3343
 
                    c = config.GlobalConfig()
3344
 
            else:
3345
 
                c = Branch.open(directory).get_config()
 
3273
            # use branch if we're inside one; otherwise global config
 
3274
            try:
 
3275
                c = Branch.open_containing('.')[0].get_config()
 
3276
            except errors.NotBranchError:
 
3277
                c = config.GlobalConfig()
3346
3278
            if email:
3347
3279
                self.outf.write(c.user_email() + '\n')
3348
3280
            else:
3358
3290
 
3359
3291
        # use global config unless --branch given
3360
3292
        if branch:
3361
 
            if directory is None:
3362
 
                c = Branch.open_containing(u'.')[0].get_config()
3363
 
            else:
3364
 
                c = Branch.open(directory).get_config()
 
3293
            c = Branch.open_containing('.')[0].get_config()
3365
3294
        else:
3366
3295
            c = config.GlobalConfig()
3367
3296
        c.set_user_option('email', name)
3368
3297
 
3369
3298
 
3370
3299
class cmd_nick(Command):
3371
 
    __doc__ = """Print or set the branch nickname.
 
3300
    """Print or set the branch nickname.
3372
3301
 
3373
3302
    If unset, the tree root directory name is used as the nickname.
3374
3303
    To print the current nickname, execute with no argument.
3379
3308
 
3380
3309
    _see_also = ['info']
3381
3310
    takes_args = ['nickname?']
3382
 
    takes_options = ['directory']
3383
 
    def run(self, nickname=None, directory=u'.'):
3384
 
        branch = Branch.open_containing(directory)[0]
 
3311
    def run(self, nickname=None):
 
3312
        branch = Branch.open_containing(u'.')[0]
3385
3313
        if nickname is None:
3386
3314
            self.printme(branch)
3387
3315
        else:
3389
3317
 
3390
3318
    @display_command
3391
3319
    def printme(self, branch):
3392
 
        self.outf.write('%s\n' % branch.nick)
 
3320
        print branch.nick
3393
3321
 
3394
3322
 
3395
3323
class cmd_alias(Command):
3396
 
    __doc__ = """Set/unset and display aliases.
 
3324
    """Set/unset and display aliases.
3397
3325
 
3398
3326
    :Examples:
3399
3327
        Show the current aliases::
3463
3391
 
3464
3392
 
3465
3393
class cmd_selftest(Command):
3466
 
    __doc__ = """Run internal test suite.
 
3394
    """Run internal test suite.
3467
3395
 
3468
3396
    If arguments are given, they are regular expressions that say which tests
3469
3397
    should run.  Tests matching any expression are run, and other tests are
3513
3441
    def get_transport_type(typestring):
3514
3442
        """Parse and return a transport specifier."""
3515
3443
        if typestring == "sftp":
3516
 
            from bzrlib.tests import stub_sftp
3517
 
            return stub_sftp.SFTPAbsoluteServer
 
3444
            from bzrlib.transport.sftp import SFTPAbsoluteServer
 
3445
            return SFTPAbsoluteServer
3518
3446
        if typestring == "memory":
3519
 
            from bzrlib.tests import test_server
3520
 
            return memory.MemoryServer
 
3447
            from bzrlib.transport.memory import MemoryServer
 
3448
            return MemoryServer
3521
3449
        if typestring == "fakenfs":
3522
 
            from bzrlib.tests import test_server
3523
 
            return test_server.FakeNFSServer
 
3450
            from bzrlib.transport.fakenfs import FakeNFSServer
 
3451
            return FakeNFSServer
3524
3452
        msg = "No known transport type %s. Supported types are: sftp\n" %\
3525
3453
            (typestring)
3526
3454
        raise errors.BzrCommandError(msg)
3537
3465
                                 'throughout the test suite.',
3538
3466
                            type=get_transport_type),
3539
3467
                     Option('benchmark',
3540
 
                            help='Run the benchmarks rather than selftests.',
3541
 
                            hidden=True),
 
3468
                            help='Run the benchmarks rather than selftests.'),
3542
3469
                     Option('lsprof-timed',
3543
3470
                            help='Generate lsprof output for benchmarked'
3544
3471
                                 ' sections of code.'),
3545
3472
                     Option('lsprof-tests',
3546
3473
                            help='Generate lsprof output for each test.'),
 
3474
                     Option('cache-dir', type=str,
 
3475
                            help='Cache intermediate benchmark output in this '
 
3476
                                 'directory.'),
3547
3477
                     Option('first',
3548
3478
                            help='Run all tests, but run specified tests first.',
3549
3479
                            short_name='f',
3583
3513
 
3584
3514
    def run(self, testspecs_list=None, verbose=False, one=False,
3585
3515
            transport=None, benchmark=None,
3586
 
            lsprof_timed=None,
 
3516
            lsprof_timed=None, cache_dir=None,
3587
3517
            first=False, list_only=False,
3588
3518
            randomize=None, exclude=None, strict=False,
3589
3519
            load_list=None, debugflag=None, starting_with=None, subunit=False,
3590
3520
            parallel=None, lsprof_tests=False):
3591
3521
        from bzrlib.tests import selftest
 
3522
        import bzrlib.benchmarks as benchmarks
 
3523
        from bzrlib.benchmarks import tree_creator
3592
3524
 
3593
3525
        # Make deprecation warnings visible, unless -Werror is set
3594
3526
        symbol_versioning.activate_deprecation_warnings(override=False)
3595
3527
 
 
3528
        if cache_dir is not None:
 
3529
            tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
3596
3530
        if testspecs_list is not None:
3597
3531
            pattern = '|'.join(testspecs_list)
3598
3532
        else:
3604
3538
                raise errors.BzrCommandError("subunit not available. subunit "
3605
3539
                    "needs to be installed to use --subunit.")
3606
3540
            self.additional_selftest_args['runner_class'] = SubUnitBzrRunner
3607
 
            # On Windows, disable automatic conversion of '\n' to '\r\n' in
3608
 
            # stdout, which would corrupt the subunit stream. 
3609
 
            # FIXME: This has been fixed in subunit trunk (>0.0.5) so the
3610
 
            # following code can be deleted when it's sufficiently deployed
3611
 
            # -- vila/mgz 20100514
3612
 
            if (sys.platform == "win32"
3613
 
                and getattr(sys.stdout, 'fileno', None) is not None):
3614
 
                import msvcrt
3615
 
                msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
3616
3541
        if parallel:
3617
3542
            self.additional_selftest_args.setdefault(
3618
3543
                'suite_decorators', []).append(parallel)
3619
3544
        if benchmark:
3620
 
            raise errors.BzrCommandError(
3621
 
                "--benchmark is no longer supported from bzr 2.2; "
3622
 
                "use bzr-usertest instead")
3623
 
        test_suite_factory = None
 
3545
            test_suite_factory = benchmarks.test_suite
 
3546
            # Unless user explicitly asks for quiet, be verbose in benchmarks
 
3547
            verbose = not is_quiet()
 
3548
            # TODO: should possibly lock the history file...
 
3549
            benchfile = open(".perf_history", "at", buffering=1)
 
3550
            self.add_cleanup(benchfile.close)
 
3551
        else:
 
3552
            test_suite_factory = None
 
3553
            benchfile = None
3624
3554
        selftest_kwargs = {"verbose": verbose,
3625
3555
                          "pattern": pattern,
3626
3556
                          "stop_on_failure": one,
3628
3558
                          "test_suite_factory": test_suite_factory,
3629
3559
                          "lsprof_timed": lsprof_timed,
3630
3560
                          "lsprof_tests": lsprof_tests,
 
3561
                          "bench_history": benchfile,
3631
3562
                          "matching_tests_first": first,
3632
3563
                          "list_only": list_only,
3633
3564
                          "random_seed": randomize,
3643
3574
 
3644
3575
 
3645
3576
class cmd_version(Command):
3646
 
    __doc__ = """Show version of bzr."""
 
3577
    """Show version of bzr."""
3647
3578
 
3648
3579
    encoding_type = 'replace'
3649
3580
    takes_options = [
3660
3591
 
3661
3592
 
3662
3593
class cmd_rocks(Command):
3663
 
    __doc__ = """Statement of optimism."""
 
3594
    """Statement of optimism."""
3664
3595
 
3665
3596
    hidden = True
3666
3597
 
3667
3598
    @display_command
3668
3599
    def run(self):
3669
 
        self.outf.write("It sure does!\n")
 
3600
        print "It sure does!"
3670
3601
 
3671
3602
 
3672
3603
class cmd_find_merge_base(Command):
3673
 
    __doc__ = """Find and print a base revision for merging two branches."""
 
3604
    """Find and print a base revision for merging two branches."""
3674
3605
    # TODO: Options to specify revisions on either side, as if
3675
3606
    #       merging only part of the history.
3676
3607
    takes_args = ['branch', 'other']
3682
3613
 
3683
3614
        branch1 = Branch.open_containing(branch)[0]
3684
3615
        branch2 = Branch.open_containing(other)[0]
3685
 
        self.add_cleanup(branch1.lock_read().unlock)
3686
 
        self.add_cleanup(branch2.lock_read().unlock)
 
3616
        branch1.lock_read()
 
3617
        self.add_cleanup(branch1.unlock)
 
3618
        branch2.lock_read()
 
3619
        self.add_cleanup(branch2.unlock)
3687
3620
        last1 = ensure_null(branch1.last_revision())
3688
3621
        last2 = ensure_null(branch2.last_revision())
3689
3622
 
3690
3623
        graph = branch1.repository.get_graph(branch2.repository)
3691
3624
        base_rev_id = graph.find_unique_lca(last1, last2)
3692
3625
 
3693
 
        self.outf.write('merge base is revision %s\n' % base_rev_id)
 
3626
        print 'merge base is revision %s' % base_rev_id
3694
3627
 
3695
3628
 
3696
3629
class cmd_merge(Command):
3697
 
    __doc__ = """Perform a three-way merge.
 
3630
    """Perform a three-way merge.
3698
3631
 
3699
3632
    The source of the merge can be specified either in the form of a branch,
3700
3633
    or in the form of a path to a file containing a merge directive generated
3783
3716
                ' completely merged into the source, pull from the'
3784
3717
                ' source rather than merging.  When this happens,'
3785
3718
                ' you do not need to commit the result.'),
3786
 
        custom_help('directory',
 
3719
        Option('directory',
3787
3720
               help='Branch to merge into, '
3788
 
                    'rather than the one containing the working directory.'),
 
3721
                    'rather than the one containing the working directory.',
 
3722
               short_name='d',
 
3723
               type=unicode,
 
3724
               ),
3789
3725
        Option('preview', help='Instead of merging, show a diff of the'
3790
3726
               ' merge.'),
3791
3727
        Option('interactive', help='Select changes interactively.',
3824
3760
            unversioned_filter=tree.is_ignored, view_info=view_info)
3825
3761
        pb = ui.ui_factory.nested_progress_bar()
3826
3762
        self.add_cleanup(pb.finished)
3827
 
        self.add_cleanup(tree.lock_write().unlock)
 
3763
        tree.lock_write()
 
3764
        self.add_cleanup(tree.unlock)
3828
3765
        if location is not None:
3829
3766
            try:
3830
3767
                mergeable = bundle.read_mergeable_from_url(location,
3840
3777
                    raise errors.BzrCommandError(
3841
3778
                        'Cannot use -r with merge directives or bundles')
3842
3779
                merger, verified = _mod_merge.Merger.from_mergeable(tree,
3843
 
                   mergeable, None)
 
3780
                   mergeable, pb)
3844
3781
 
3845
3782
        if merger is None and uncommitted:
3846
3783
            if revision is not None and len(revision) > 0:
3847
3784
                raise errors.BzrCommandError('Cannot use --uncommitted and'
3848
3785
                    ' --revision at the same time.')
3849
 
            merger = self.get_merger_from_uncommitted(tree, location, None)
 
3786
            merger = self.get_merger_from_uncommitted(tree, location, pb)
3850
3787
            allow_pending = False
3851
3788
 
3852
3789
        if merger is None:
3853
3790
            merger, allow_pending = self._get_merger_from_branch(tree,
3854
 
                location, revision, remember, possible_transports, None)
 
3791
                location, revision, remember, possible_transports, pb)
3855
3792
 
3856
3793
        merger.merge_type = merge_type
3857
3794
        merger.reprocess = reprocess
3891
3828
    def _do_preview(self, merger):
3892
3829
        from bzrlib.diff import show_diff_trees
3893
3830
        result_tree = self._get_preview(merger)
3894
 
        path_encoding = osutils.get_diff_header_encoding()
3895
3831
        show_diff_trees(merger.this_tree, result_tree, self.outf,
3896
 
                        old_label='', new_label='',
3897
 
                        path_encoding=path_encoding)
 
3832
                        old_label='', new_label='')
3898
3833
 
3899
3834
    def _do_merge(self, merger, change_reporter, allow_pending, verified):
3900
3835
        merger.change_reporter = change_reporter
4053
3988
 
4054
3989
 
4055
3990
class cmd_remerge(Command):
4056
 
    __doc__ = """Redo a merge.
 
3991
    """Redo a merge.
4057
3992
 
4058
3993
    Use this if you want to try a different merge technique while resolving
4059
3994
    conflicts.  Some merge techniques are better than others, and remerge
4084
4019
 
4085
4020
    def run(self, file_list=None, merge_type=None, show_base=False,
4086
4021
            reprocess=False):
4087
 
        from bzrlib.conflicts import restore
4088
4022
        if merge_type is None:
4089
4023
            merge_type = _mod_merge.Merge3Merger
4090
4024
        tree, file_list = tree_files(file_list)
4091
 
        self.add_cleanup(tree.lock_write().unlock)
 
4025
        tree.lock_write()
 
4026
        self.add_cleanup(tree.unlock)
4092
4027
        parents = tree.get_parent_ids()
4093
4028
        if len(parents) != 2:
4094
4029
            raise errors.BzrCommandError("Sorry, remerge only works after normal"
4130
4065
        # list, we imply that the working tree text has seen and rejected
4131
4066
        # all the changes from the other tree, when in fact those changes
4132
4067
        # have not yet been seen.
 
4068
        pb = ui.ui_factory.nested_progress_bar()
4133
4069
        tree.set_parent_ids(parents[:1])
4134
4070
        try:
4135
 
            merger = _mod_merge.Merger.from_revision_ids(None, tree, parents[1])
 
4071
            merger = _mod_merge.Merger.from_revision_ids(pb,
 
4072
                                                         tree, parents[1])
4136
4073
            merger.interesting_ids = interesting_ids
4137
4074
            merger.merge_type = merge_type
4138
4075
            merger.show_base = show_base
4140
4077
            conflicts = merger.do_merge()
4141
4078
        finally:
4142
4079
            tree.set_parent_ids(parents)
 
4080
            pb.finished()
4143
4081
        if conflicts > 0:
4144
4082
            return 1
4145
4083
        else:
4147
4085
 
4148
4086
 
4149
4087
class cmd_revert(Command):
4150
 
    __doc__ = """Revert files to a previous revision.
 
4088
    """Revert files to a previous revision.
4151
4089
 
4152
4090
    Giving a list of files will revert only those files.  Otherwise, all files
4153
4091
    will be reverted.  If the revision is not specified with '--revision', the
4204
4142
    def run(self, revision=None, no_backup=False, file_list=None,
4205
4143
            forget_merges=None):
4206
4144
        tree, file_list = tree_files(file_list)
4207
 
        self.add_cleanup(tree.lock_tree_write().unlock)
 
4145
        tree.lock_write()
 
4146
        self.add_cleanup(tree.unlock)
4208
4147
        if forget_merges:
4209
4148
            tree.set_parent_ids(tree.get_parent_ids()[:1])
4210
4149
        else:
4213
4152
    @staticmethod
4214
4153
    def _revert_tree_to_revision(tree, revision, file_list, no_backup):
4215
4154
        rev_tree = _get_one_revision_tree('revert', revision, tree=tree)
4216
 
        tree.revert(file_list, rev_tree, not no_backup, None,
4217
 
            report_changes=True)
 
4155
        pb = ui.ui_factory.nested_progress_bar()
 
4156
        try:
 
4157
            tree.revert(file_list, rev_tree, not no_backup, pb,
 
4158
                report_changes=True)
 
4159
        finally:
 
4160
            pb.finished()
4218
4161
 
4219
4162
 
4220
4163
class cmd_assert_fail(Command):
4221
 
    __doc__ = """Test reporting of assertion failures"""
 
4164
    """Test reporting of assertion failures"""
4222
4165
    # intended just for use in testing
4223
4166
 
4224
4167
    hidden = True
4228
4171
 
4229
4172
 
4230
4173
class cmd_help(Command):
4231
 
    __doc__ = """Show help on a command or other topic.
 
4174
    """Show help on a command or other topic.
4232
4175
    """
4233
4176
 
4234
4177
    _see_also = ['topics']
4247
4190
 
4248
4191
 
4249
4192
class cmd_shell_complete(Command):
4250
 
    __doc__ = """Show appropriate completions for context.
 
4193
    """Show appropriate completions for context.
4251
4194
 
4252
4195
    For a list of all available commands, say 'bzr shell-complete'.
4253
4196
    """
4262
4205
 
4263
4206
 
4264
4207
class cmd_missing(Command):
4265
 
    __doc__ = """Show unmerged/unpulled revisions between two branches.
 
4208
    """Show unmerged/unpulled revisions between two branches.
4266
4209
 
4267
4210
    OTHER_BRANCH may be local or remote.
4268
4211
 
4299
4242
    _see_also = ['merge', 'pull']
4300
4243
    takes_args = ['other_branch?']
4301
4244
    takes_options = [
4302
 
        'directory',
4303
4245
        Option('reverse', 'Reverse the order of revisions.'),
4304
4246
        Option('mine-only',
4305
4247
               'Display changes in the local branch only.'),
4327
4269
            theirs_only=False,
4328
4270
            log_format=None, long=False, short=False, line=False,
4329
4271
            show_ids=False, verbose=False, this=False, other=False,
4330
 
            include_merges=False, revision=None, my_revision=None,
4331
 
            directory=u'.'):
 
4272
            include_merges=False, revision=None, my_revision=None):
4332
4273
        from bzrlib.missing import find_unmerged, iter_log_revisions
4333
4274
        def message(s):
4334
4275
            if not is_quiet():
4347
4288
        elif theirs_only:
4348
4289
            restrict = 'remote'
4349
4290
 
4350
 
        local_branch = Branch.open_containing(directory)[0]
4351
 
        self.add_cleanup(local_branch.lock_read().unlock)
4352
 
 
 
4291
        local_branch = Branch.open_containing(u".")[0]
4353
4292
        parent = local_branch.get_parent()
4354
4293
        if other_branch is None:
4355
4294
            other_branch = parent
4364
4303
        remote_branch = Branch.open(other_branch)
4365
4304
        if remote_branch.base == local_branch.base:
4366
4305
            remote_branch = local_branch
4367
 
        else:
4368
 
            self.add_cleanup(remote_branch.lock_read().unlock)
4369
4306
 
 
4307
        local_branch.lock_read()
 
4308
        self.add_cleanup(local_branch.unlock)
4370
4309
        local_revid_range = _revision_range_to_revid_range(
4371
4310
            _get_revision_range(my_revision, local_branch,
4372
4311
                self.name()))
4373
4312
 
 
4313
        remote_branch.lock_read()
 
4314
        self.add_cleanup(remote_branch.unlock)
4374
4315
        remote_revid_range = _revision_range_to_revid_range(
4375
4316
            _get_revision_range(revision,
4376
4317
                remote_branch, self.name()))
4426
4367
            message("Branches are up to date.\n")
4427
4368
        self.cleanup_now()
4428
4369
        if not status_code and parent is None and other_branch is not None:
4429
 
            self.add_cleanup(local_branch.lock_write().unlock)
 
4370
            local_branch.lock_write()
 
4371
            self.add_cleanup(local_branch.unlock)
4430
4372
            # handle race conditions - a parent might be set while we run.
4431
4373
            if local_branch.get_parent() is None:
4432
4374
                local_branch.set_parent(remote_branch.base)
4434
4376
 
4435
4377
 
4436
4378
class cmd_pack(Command):
4437
 
    __doc__ = """Compress the data within a repository.
4438
 
 
4439
 
    This operation compresses the data within a bazaar repository. As
4440
 
    bazaar supports automatic packing of repository, this operation is
4441
 
    normally not required to be done manually.
4442
 
 
4443
 
    During the pack operation, bazaar takes a backup of existing repository
4444
 
    data, i.e. pack files. This backup is eventually removed by bazaar
4445
 
    automatically when it is safe to do so. To save disk space by removing
4446
 
    the backed up pack files, the --clean-obsolete-packs option may be
4447
 
    used.
4448
 
 
4449
 
    Warning: If you use --clean-obsolete-packs and your machine crashes
4450
 
    during or immediately after repacking, you may be left with a state
4451
 
    where the deletion has been written to disk but the new packs have not
4452
 
    been. In this case the repository may be unusable.
4453
 
    """
 
4379
    """Compress the data within a repository."""
4454
4380
 
4455
4381
    _see_also = ['repositories']
4456
4382
    takes_args = ['branch_or_repo?']
4457
 
    takes_options = [
4458
 
        Option('clean-obsolete-packs', 'Delete obsolete packs to save disk space.'),
4459
 
        ]
4460
4383
 
4461
 
    def run(self, branch_or_repo='.', clean_obsolete_packs=False):
 
4384
    def run(self, branch_or_repo='.'):
4462
4385
        dir = bzrdir.BzrDir.open_containing(branch_or_repo)[0]
4463
4386
        try:
4464
4387
            branch = dir.open_branch()
4465
4388
            repository = branch.repository
4466
4389
        except errors.NotBranchError:
4467
4390
            repository = dir.open_repository()
4468
 
        repository.pack(clean_obsolete_packs=clean_obsolete_packs)
 
4391
        repository.pack()
4469
4392
 
4470
4393
 
4471
4394
class cmd_plugins(Command):
4472
 
    __doc__ = """List the installed plugins.
 
4395
    """List the installed plugins.
4473
4396
 
4474
4397
    This command displays the list of installed plugins including
4475
4398
    version of plugin and a short description of each.
4506
4429
                doc = '(no description)'
4507
4430
            result.append((name_ver, doc, plugin.path()))
4508
4431
        for name_ver, doc, path in sorted(result):
4509
 
            self.outf.write("%s\n" % name_ver)
4510
 
            self.outf.write("   %s\n" % doc)
 
4432
            print name_ver
 
4433
            print '   ', doc
4511
4434
            if verbose:
4512
 
                self.outf.write("   %s\n" % path)
4513
 
            self.outf.write("\n")
 
4435
                print '   ', path
 
4436
            print
4514
4437
 
4515
4438
 
4516
4439
class cmd_testament(Command):
4517
 
    __doc__ = """Show testament (signing-form) of a revision."""
 
4440
    """Show testament (signing-form) of a revision."""
4518
4441
    takes_options = [
4519
4442
            'revision',
4520
4443
            Option('long', help='Produce long-format testament.'),
4532
4455
            b = Branch.open_containing(branch)[0]
4533
4456
        else:
4534
4457
            b = Branch.open(branch)
4535
 
        self.add_cleanup(b.lock_read().unlock)
 
4458
        b.lock_read()
 
4459
        self.add_cleanup(b.unlock)
4536
4460
        if revision is None:
4537
4461
            rev_id = b.last_revision()
4538
4462
        else:
4545
4469
 
4546
4470
 
4547
4471
class cmd_annotate(Command):
4548
 
    __doc__ = """Show the origin of each line in a file.
 
4472
    """Show the origin of each line in a file.
4549
4473
 
4550
4474
    This prints out the given file with an annotation on the left side
4551
4475
    indicating which revision, author and date introduced the change.
4562
4486
                     Option('long', help='Show commit date in annotations.'),
4563
4487
                     'revision',
4564
4488
                     'show-ids',
4565
 
                     'directory',
4566
4489
                     ]
4567
4490
    encoding_type = 'exact'
4568
4491
 
4569
4492
    @display_command
4570
4493
    def run(self, filename, all=False, long=False, revision=None,
4571
 
            show_ids=False, directory=None):
 
4494
            show_ids=False):
4572
4495
        from bzrlib.annotate import annotate_file, annotate_file_tree
4573
4496
        wt, branch, relpath = \
4574
 
            _open_directory_or_containing_tree_or_branch(filename, directory)
 
4497
            bzrdir.BzrDir.open_containing_tree_or_branch(filename)
4575
4498
        if wt is not None:
4576
 
            self.add_cleanup(wt.lock_read().unlock)
 
4499
            wt.lock_read()
 
4500
            self.add_cleanup(wt.unlock)
4577
4501
        else:
4578
 
            self.add_cleanup(branch.lock_read().unlock)
 
4502
            branch.lock_read()
 
4503
            self.add_cleanup(branch.unlock)
4579
4504
        tree = _get_one_revision_tree('annotate', revision, branch=branch)
4580
 
        self.add_cleanup(tree.lock_read().unlock)
 
4505
        tree.lock_read()
 
4506
        self.add_cleanup(tree.unlock)
4581
4507
        if wt is not None:
4582
4508
            file_id = wt.path2id(relpath)
4583
4509
        else:
4596
4522
 
4597
4523
 
4598
4524
class cmd_re_sign(Command):
4599
 
    __doc__ = """Create a digital signature for an existing revision."""
 
4525
    """Create a digital signature for an existing revision."""
4600
4526
    # TODO be able to replace existing ones.
4601
4527
 
4602
4528
    hidden = True # is this right ?
4603
4529
    takes_args = ['revision_id*']
4604
 
    takes_options = ['directory', 'revision']
 
4530
    takes_options = ['revision']
4605
4531
 
4606
 
    def run(self, revision_id_list=None, revision=None, directory=u'.'):
 
4532
    def run(self, revision_id_list=None, revision=None):
4607
4533
        if revision_id_list is not None and revision is not None:
4608
4534
            raise errors.BzrCommandError('You can only supply one of revision_id or --revision')
4609
4535
        if revision_id_list is None and revision is None:
4610
4536
            raise errors.BzrCommandError('You must supply either --revision or a revision_id')
4611
 
        b = WorkingTree.open_containing(directory)[0].branch
4612
 
        self.add_cleanup(b.lock_write().unlock)
 
4537
        b = WorkingTree.open_containing(u'.')[0].branch
 
4538
        b.lock_write()
 
4539
        self.add_cleanup(b.unlock)
4613
4540
        return self._run(b, revision_id_list, revision)
4614
4541
 
4615
4542
    def _run(self, b, revision_id_list, revision):
4661
4588
 
4662
4589
 
4663
4590
class cmd_bind(Command):
4664
 
    __doc__ = """Convert the current branch into a checkout of the supplied branch.
4665
 
    If no branch is supplied, rebind to the last bound location.
 
4591
    """Convert the current branch into a checkout of the supplied branch.
4666
4592
 
4667
4593
    Once converted into a checkout, commits must succeed on the master branch
4668
4594
    before they will be applied to the local branch.
4674
4600
 
4675
4601
    _see_also = ['checkouts', 'unbind']
4676
4602
    takes_args = ['location?']
4677
 
    takes_options = ['directory']
 
4603
    takes_options = []
4678
4604
 
4679
 
    def run(self, location=None, directory=u'.'):
4680
 
        b, relpath = Branch.open_containing(directory)
 
4605
    def run(self, location=None):
 
4606
        b, relpath = Branch.open_containing(u'.')
4681
4607
        if location is None:
4682
4608
            try:
4683
4609
                location = b.get_old_bound_location()
4686
4612
                    'This format does not remember old locations.')
4687
4613
            else:
4688
4614
                if location is None:
4689
 
                    if b.get_bound_location() is not None:
4690
 
                        raise errors.BzrCommandError('Branch is already bound')
4691
 
                    else:
4692
 
                        raise errors.BzrCommandError('No location supplied '
4693
 
                            'and no previous location known')
 
4615
                    raise errors.BzrCommandError('No location supplied and no '
 
4616
                        'previous location known')
4694
4617
        b_other = Branch.open(location)
4695
4618
        try:
4696
4619
            b.bind(b_other)
4702
4625
 
4703
4626
 
4704
4627
class cmd_unbind(Command):
4705
 
    __doc__ = """Convert the current checkout into a regular branch.
 
4628
    """Convert the current checkout into a regular branch.
4706
4629
 
4707
4630
    After unbinding, the local branch is considered independent and subsequent
4708
4631
    commits will be local only.
4710
4633
 
4711
4634
    _see_also = ['checkouts', 'bind']
4712
4635
    takes_args = []
4713
 
    takes_options = ['directory']
 
4636
    takes_options = []
4714
4637
 
4715
 
    def run(self, directory=u'.'):
4716
 
        b, relpath = Branch.open_containing(directory)
 
4638
    def run(self):
 
4639
        b, relpath = Branch.open_containing(u'.')
4717
4640
        if not b.unbind():
4718
4641
            raise errors.BzrCommandError('Local branch is not bound')
4719
4642
 
4720
4643
 
4721
4644
class cmd_uncommit(Command):
4722
 
    __doc__ = """Remove the last committed revision.
 
4645
    """Remove the last committed revision.
4723
4646
 
4724
4647
    --verbose will print out what is being removed.
4725
4648
    --dry-run will go through all the motions, but not actually
4765
4688
            b = control.open_branch()
4766
4689
 
4767
4690
        if tree is not None:
4768
 
            self.add_cleanup(tree.lock_write().unlock)
 
4691
            tree.lock_write()
 
4692
            self.add_cleanup(tree.unlock)
4769
4693
        else:
4770
 
            self.add_cleanup(b.lock_write().unlock)
 
4694
            b.lock_write()
 
4695
            self.add_cleanup(b.unlock)
4771
4696
        return self._run(b, tree, dry_run, verbose, revision, force, local=local)
4772
4697
 
4773
4698
    def _run(self, b, tree, dry_run, verbose, revision, force, local=False):
4806
4731
                 end_revision=last_revno)
4807
4732
 
4808
4733
        if dry_run:
4809
 
            self.outf.write('Dry-run, pretending to remove'
4810
 
                            ' the above revisions.\n')
 
4734
            print 'Dry-run, pretending to remove the above revisions.'
 
4735
            if not force:
 
4736
                val = raw_input('Press <enter> to continue')
4811
4737
        else:
4812
 
            self.outf.write('The above revision(s) will be removed.\n')
4813
 
 
4814
 
        if not force:
4815
 
            if not ui.ui_factory.get_boolean('Are you sure'):
4816
 
                self.outf.write('Canceled')
4817
 
                return 0
 
4738
            print 'The above revision(s) will be removed.'
 
4739
            if not force:
 
4740
                val = raw_input('Are you sure [y/N]? ')
 
4741
                if val.lower() not in ('y', 'yes'):
 
4742
                    print 'Canceled'
 
4743
                    return 0
4818
4744
 
4819
4745
        mutter('Uncommitting from {%s} to {%s}',
4820
4746
               last_rev_id, rev_id)
4821
4747
        uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
4822
4748
                 revno=revno, local=local)
4823
 
        self.outf.write('You can restore the old tip by running:\n'
4824
 
             '  bzr pull . -r revid:%s\n' % last_rev_id)
 
4749
        note('You can restore the old tip by running:\n'
 
4750
             '  bzr pull . -r revid:%s', last_rev_id)
4825
4751
 
4826
4752
 
4827
4753
class cmd_break_lock(Command):
4828
 
    __doc__ = """Break a dead lock on a repository, branch or working directory.
 
4754
    """Break a dead lock on a repository, branch or working directory.
4829
4755
 
4830
4756
    CAUTION: Locks should only be broken when you are sure that the process
4831
4757
    holding the lock has been stopped.
4850
4776
 
4851
4777
 
4852
4778
class cmd_wait_until_signalled(Command):
4853
 
    __doc__ = """Test helper for test_start_and_stop_bzr_subprocess_send_signal.
 
4779
    """Test helper for test_start_and_stop_bzr_subprocess_send_signal.
4854
4780
 
4855
4781
    This just prints a line to signal when it is ready, then blocks on stdin.
4856
4782
    """
4864
4790
 
4865
4791
 
4866
4792
class cmd_serve(Command):
4867
 
    __doc__ = """Run the bzr server."""
 
4793
    """Run the bzr server."""
4868
4794
 
4869
4795
    aliases = ['server']
4870
4796
 
4881
4807
                    'result in a dynamically allocated port.  The default port '
4882
4808
                    'depends on the protocol.',
4883
4809
               type=str),
4884
 
        custom_help('directory',
4885
 
               help='Serve contents of this directory.'),
 
4810
        Option('directory',
 
4811
               help='Serve contents of this directory.',
 
4812
               type=unicode),
4886
4813
        Option('allow-writes',
4887
4814
               help='By default the server is a readonly server.  Supplying '
4888
4815
                    '--allow-writes enables write access to the contents of '
4915
4842
 
4916
4843
    def run(self, port=None, inet=False, directory=None, allow_writes=False,
4917
4844
            protocol=None):
4918
 
        from bzrlib import transport
 
4845
        from bzrlib.transport import get_transport, transport_server_registry
4919
4846
        if directory is None:
4920
4847
            directory = os.getcwd()
4921
4848
        if protocol is None:
4922
 
            protocol = transport.transport_server_registry.get()
 
4849
            protocol = transport_server_registry.get()
4923
4850
        host, port = self.get_host_and_port(port)
4924
4851
        url = urlutils.local_path_to_url(directory)
4925
4852
        if not allow_writes:
4926
4853
            url = 'readonly+' + url
4927
 
        t = transport.get_transport(url)
4928
 
        protocol(t, host, port, inet)
 
4854
        transport = get_transport(url)
 
4855
        protocol(transport, host, port, inet)
4929
4856
 
4930
4857
 
4931
4858
class cmd_join(Command):
4932
 
    __doc__ = """Combine a tree into its containing tree.
 
4859
    """Combine a tree into its containing tree.
4933
4860
 
4934
4861
    This command requires the target tree to be in a rich-root format.
4935
4862
 
4975
4902
 
4976
4903
 
4977
4904
class cmd_split(Command):
4978
 
    __doc__ = """Split a subdirectory of a tree into a separate tree.
 
4905
    """Split a subdirectory of a tree into a separate tree.
4979
4906
 
4980
4907
    This command will produce a target tree in a format that supports
4981
4908
    rich roots, like 'rich-root' or 'rich-root-pack'.  These formats cannot be
5001
4928
 
5002
4929
 
5003
4930
class cmd_merge_directive(Command):
5004
 
    __doc__ = """Generate a merge directive for auto-merge tools.
 
4931
    """Generate a merge directive for auto-merge tools.
5005
4932
 
5006
4933
    A directive requests a merge to be performed, and also provides all the
5007
4934
    information necessary to do so.  This means it must either include a
5024
4951
    _see_also = ['send']
5025
4952
 
5026
4953
    takes_options = [
5027
 
        'directory',
5028
4954
        RegistryOption.from_kwargs('patch-type',
5029
4955
            'The type of patch to include in the directive.',
5030
4956
            title='Patch type',
5043
4969
    encoding_type = 'exact'
5044
4970
 
5045
4971
    def run(self, submit_branch=None, public_branch=None, patch_type='bundle',
5046
 
            sign=False, revision=None, mail_to=None, message=None,
5047
 
            directory=u'.'):
 
4972
            sign=False, revision=None, mail_to=None, message=None):
5048
4973
        from bzrlib.revision import ensure_null, NULL_REVISION
5049
4974
        include_patch, include_bundle = {
5050
4975
            'plain': (False, False),
5051
4976
            'diff': (True, False),
5052
4977
            'bundle': (True, True),
5053
4978
            }[patch_type]
5054
 
        branch = Branch.open(directory)
 
4979
        branch = Branch.open('.')
5055
4980
        stored_submit_branch = branch.get_submit_branch()
5056
4981
        if submit_branch is None:
5057
4982
            submit_branch = stored_submit_branch
5102
5027
 
5103
5028
 
5104
5029
class cmd_send(Command):
5105
 
    __doc__ = """Mail or create a merge-directive for submitting changes.
 
5030
    """Mail or create a merge-directive for submitting changes.
5106
5031
 
5107
5032
    A merge directive provides many things needed for requesting merges:
5108
5033
 
5142
5067
    given, in which case it is sent to a file.
5143
5068
 
5144
5069
    Mail is sent using your preferred mail program.  This should be transparent
5145
 
    on Windows (it uses MAPI).  On Unix, it requires the xdg-email utility.
 
5070
    on Windows (it uses MAPI).  On Linux, it requires the xdg-email utility.
5146
5071
    If the preferred client can't be found (or used), your editor will be used.
5147
5072
 
5148
5073
    To use a specific mail program, set the mail_client configuration option.
5190
5115
               short_name='f',
5191
5116
               type=unicode),
5192
5117
        Option('output', short_name='o',
5193
 
               help='Write merge directive to this file or directory; '
 
5118
               help='Write merge directive to this file; '
5194
5119
                    'use - for stdout.',
5195
5120
               type=unicode),
5196
5121
        Option('strict',
5219
5144
 
5220
5145
 
5221
5146
class cmd_bundle_revisions(cmd_send):
5222
 
    __doc__ = """Create a merge-directive for submitting changes.
 
5147
    """Create a merge-directive for submitting changes.
5223
5148
 
5224
5149
    A merge directive provides many things needed for requesting merges:
5225
5150
 
5292
5217
 
5293
5218
 
5294
5219
class cmd_tag(Command):
5295
 
    __doc__ = """Create, remove or modify a tag naming a revision.
 
5220
    """Create, remove or modify a tag naming a revision.
5296
5221
 
5297
5222
    Tags give human-meaningful names to revisions.  Commands that take a -r
5298
5223
    (--revision) option can be given -rtag:X, where X is any previously
5306
5231
 
5307
5232
    To rename a tag (change the name but keep it on the same revsion), run ``bzr
5308
5233
    tag new-name -r tag:old-name`` and then ``bzr tag --delete oldname``.
5309
 
 
5310
 
    If no tag name is specified it will be determined through the 
5311
 
    'automatic_tag_name' hook. This can e.g. be used to automatically tag
5312
 
    upstream releases by reading configure.ac. See ``bzr help hooks`` for
5313
 
    details.
5314
5234
    """
5315
5235
 
5316
5236
    _see_also = ['commit', 'tags']
5317
 
    takes_args = ['tag_name?']
 
5237
    takes_args = ['tag_name']
5318
5238
    takes_options = [
5319
5239
        Option('delete',
5320
5240
            help='Delete this tag rather than placing it.',
5321
5241
            ),
5322
 
        custom_help('directory',
5323
 
            help='Branch in which to place the tag.'),
 
5242
        Option('directory',
 
5243
            help='Branch in which to place the tag.',
 
5244
            short_name='d',
 
5245
            type=unicode,
 
5246
            ),
5324
5247
        Option('force',
5325
5248
            help='Replace existing tags.',
5326
5249
            ),
5327
5250
        'revision',
5328
5251
        ]
5329
5252
 
5330
 
    def run(self, tag_name=None,
 
5253
    def run(self, tag_name,
5331
5254
            delete=None,
5332
5255
            directory='.',
5333
5256
            force=None,
5334
5257
            revision=None,
5335
5258
            ):
5336
5259
        branch, relpath = Branch.open_containing(directory)
5337
 
        self.add_cleanup(branch.lock_write().unlock)
 
5260
        branch.lock_write()
 
5261
        self.add_cleanup(branch.unlock)
5338
5262
        if delete:
5339
 
            if tag_name is None:
5340
 
                raise errors.BzrCommandError("No tag specified to delete.")
5341
5263
            branch.tags.delete_tag(tag_name)
5342
5264
            self.outf.write('Deleted tag %s.\n' % tag_name)
5343
5265
        else:
5349
5271
                revision_id = revision[0].as_revision_id(branch)
5350
5272
            else:
5351
5273
                revision_id = branch.last_revision()
5352
 
            if tag_name is None:
5353
 
                tag_name = branch.automatic_tag_name(revision_id)
5354
 
                if tag_name is None:
5355
 
                    raise errors.BzrCommandError(
5356
 
                        "Please specify a tag name.")
5357
5274
            if (not force) and branch.tags.has_tag(tag_name):
5358
5275
                raise errors.TagAlreadyExists(tag_name)
5359
5276
            branch.tags.set_tag(tag_name, revision_id)
5361
5278
 
5362
5279
 
5363
5280
class cmd_tags(Command):
5364
 
    __doc__ = """List tags.
 
5281
    """List tags.
5365
5282
 
5366
5283
    This command shows a table of tag names and the revisions they reference.
5367
5284
    """
5368
5285
 
5369
5286
    _see_also = ['tag']
5370
5287
    takes_options = [
5371
 
        custom_help('directory',
5372
 
            help='Branch whose tags should be displayed.'),
 
5288
        Option('directory',
 
5289
            help='Branch whose tags should be displayed.',
 
5290
            short_name='d',
 
5291
            type=unicode,
 
5292
            ),
5373
5293
        RegistryOption.from_kwargs('sort',
5374
5294
            'Sort tags by different criteria.', title='Sorting',
5375
5295
            alpha='Sort tags lexicographically (default).',
5392
5312
        if not tags:
5393
5313
            return
5394
5314
 
5395
 
        self.add_cleanup(branch.lock_read().unlock)
 
5315
        branch.lock_read()
 
5316
        self.add_cleanup(branch.unlock)
5396
5317
        if revision:
5397
5318
            graph = branch.repository.get_graph()
5398
5319
            rev1, rev2 = _get_revision_range(revision, branch, self.name())
5431
5352
 
5432
5353
 
5433
5354
class cmd_reconfigure(Command):
5434
 
    __doc__ = """Reconfigure the type of a bzr directory.
 
5355
    """Reconfigure the type of a bzr directory.
5435
5356
 
5436
5357
    A target configuration must be specified.
5437
5358
 
5522
5443
 
5523
5444
 
5524
5445
class cmd_switch(Command):
5525
 
    __doc__ = """Set the branch of a checkout and update.
 
5446
    """Set the branch of a checkout and update.
5526
5447
 
5527
5448
    For lightweight checkouts, this changes the branch being referenced.
5528
5449
    For heavyweight checkouts, this checks that there are no local commits
5545
5466
    """
5546
5467
 
5547
5468
    takes_args = ['to_location?']
5548
 
    takes_options = ['directory',
5549
 
                     Option('force',
 
5469
    takes_options = [Option('force',
5550
5470
                        help='Switch even if local commits will be lost.'),
5551
5471
                     'revision',
5552
5472
                     Option('create-branch', short_name='b',
5555
5475
                    ]
5556
5476
 
5557
5477
    def run(self, to_location=None, force=False, create_branch=False,
5558
 
            revision=None, directory=u'.'):
 
5478
            revision=None):
5559
5479
        from bzrlib import switch
5560
 
        tree_location = directory
 
5480
        tree_location = '.'
5561
5481
        revision = _get_one_revision('switch', revision)
5562
5482
        control_dir = bzrdir.BzrDir.open_containing(tree_location)[0]
5563
5483
        if to_location is None:
5564
5484
            if revision is None:
5565
5485
                raise errors.BzrCommandError('You must supply either a'
5566
5486
                                             ' revision or a location')
5567
 
            to_location = tree_location
 
5487
            to_location = '.'
5568
5488
        try:
5569
5489
            branch = control_dir.open_branch()
5570
5490
            had_explicit_nick = branch.get_config().has_explicit_nickname()
5619
5539
 
5620
5540
 
5621
5541
class cmd_view(Command):
5622
 
    __doc__ = """Manage filtered views.
 
5542
    """Manage filtered views.
5623
5543
 
5624
5544
    Views provide a mask over the tree so that users can focus on
5625
5545
    a subset of a tree when doing their work. After creating a view,
5773
5693
 
5774
5694
 
5775
5695
class cmd_hooks(Command):
5776
 
    __doc__ = """Show hooks."""
 
5696
    """Show hooks."""
5777
5697
 
5778
5698
    hidden = True
5779
5699
 
5792
5712
                    self.outf.write("    <no hooks installed>\n")
5793
5713
 
5794
5714
 
5795
 
class cmd_remove_branch(Command):
5796
 
    __doc__ = """Remove a branch.
5797
 
 
5798
 
    This will remove the branch from the specified location but 
5799
 
    will keep any working tree or repository in place.
5800
 
 
5801
 
    :Examples:
5802
 
 
5803
 
      Remove the branch at repo/trunk::
5804
 
 
5805
 
        bzr remove-branch repo/trunk
5806
 
 
5807
 
    """
5808
 
 
5809
 
    takes_args = ["location?"]
5810
 
 
5811
 
    aliases = ["rmbranch"]
5812
 
 
5813
 
    def run(self, location=None):
5814
 
        if location is None:
5815
 
            location = "."
5816
 
        branch = Branch.open_containing(location)[0]
5817
 
        branch.bzrdir.destroy_branch()
5818
 
        
5819
 
 
5820
5715
class cmd_shelve(Command):
5821
 
    __doc__ = """Temporarily set aside some changes from the current tree.
 
5716
    """Temporarily set aside some changes from the current tree.
5822
5717
 
5823
5718
    Shelve allows you to temporarily put changes you've made "on the shelf",
5824
5719
    ie. out of the way, until a later time when you can bring them back from
5845
5740
    takes_args = ['file*']
5846
5741
 
5847
5742
    takes_options = [
5848
 
        'directory',
5849
5743
        'revision',
5850
5744
        Option('all', help='Shelve all changes.'),
5851
5745
        'message',
5860
5754
    _see_also = ['unshelve']
5861
5755
 
5862
5756
    def run(self, revision=None, all=False, file_list=None, message=None,
5863
 
            writer=None, list=False, destroy=False, directory=u'.'):
 
5757
            writer=None, list=False, destroy=False):
5864
5758
        if list:
5865
5759
            return self.run_for_list()
5866
5760
        from bzrlib.shelf_ui import Shelver
5868
5762
            writer = bzrlib.option.diff_writer_registry.get()
5869
5763
        try:
5870
5764
            shelver = Shelver.from_args(writer(sys.stdout), revision, all,
5871
 
                file_list, message, destroy=destroy, directory=directory)
 
5765
                file_list, message, destroy=destroy)
5872
5766
            try:
5873
5767
                shelver.run()
5874
5768
            finally:
5878
5772
 
5879
5773
    def run_for_list(self):
5880
5774
        tree = WorkingTree.open_containing('.')[0]
5881
 
        self.add_cleanup(tree.lock_read().unlock)
 
5775
        tree.lock_read()
 
5776
        self.add_cleanup(tree.unlock)
5882
5777
        manager = tree.get_shelf_manager()
5883
5778
        shelves = manager.active_shelves()
5884
5779
        if len(shelves) == 0:
5893
5788
 
5894
5789
 
5895
5790
class cmd_unshelve(Command):
5896
 
    __doc__ = """Restore shelved changes.
 
5791
    """Restore shelved changes.
5897
5792
 
5898
5793
    By default, the most recently shelved changes are restored. However if you
5899
5794
    specify a shelf by id those changes will be restored instead.  This works
5902
5797
 
5903
5798
    takes_args = ['shelf_id?']
5904
5799
    takes_options = [
5905
 
        'directory',
5906
5800
        RegistryOption.from_kwargs(
5907
5801
            'action', help="The action to perform.",
5908
5802
            enum_switch=False, value_switches=True,
5916
5810
    ]
5917
5811
    _see_also = ['shelve']
5918
5812
 
5919
 
    def run(self, shelf_id=None, action='apply', directory=u'.'):
 
5813
    def run(self, shelf_id=None, action='apply'):
5920
5814
        from bzrlib.shelf_ui import Unshelver
5921
 
        unshelver = Unshelver.from_args(shelf_id, action, directory=directory)
 
5815
        unshelver = Unshelver.from_args(shelf_id, action)
5922
5816
        try:
5923
5817
            unshelver.run()
5924
5818
        finally:
5926
5820
 
5927
5821
 
5928
5822
class cmd_clean_tree(Command):
5929
 
    __doc__ = """Remove unwanted files from working tree.
 
5823
    """Remove unwanted files from working tree.
5930
5824
 
5931
5825
    By default, only unknown files, not ignored files, are deleted.  Versioned
5932
5826
    files are never deleted.
5940
5834
 
5941
5835
    To check what clean-tree will do, use --dry-run.
5942
5836
    """
5943
 
    takes_options = ['directory',
5944
 
                     Option('ignored', help='Delete all ignored files.'),
 
5837
    takes_options = [Option('ignored', help='Delete all ignored files.'),
5945
5838
                     Option('detritus', help='Delete conflict files, merge'
5946
5839
                            ' backups, and failed selftest dirs.'),
5947
5840
                     Option('unknown',
5950
5843
                            ' deleting them.'),
5951
5844
                     Option('force', help='Do not prompt before deleting.')]
5952
5845
    def run(self, unknown=False, ignored=False, detritus=False, dry_run=False,
5953
 
            force=False, directory=u'.'):
 
5846
            force=False):
5954
5847
        from bzrlib.clean_tree import clean_tree
5955
5848
        if not (unknown or ignored or detritus):
5956
5849
            unknown = True
5957
5850
        if dry_run:
5958
5851
            force = True
5959
 
        clean_tree(directory, unknown=unknown, ignored=ignored,
5960
 
                   detritus=detritus, dry_run=dry_run, no_prompt=force)
 
5852
        clean_tree('.', unknown=unknown, ignored=ignored, detritus=detritus,
 
5853
                   dry_run=dry_run, no_prompt=force)
5961
5854
 
5962
5855
 
5963
5856
class cmd_reference(Command):
5964
 
    __doc__ = """list, view and set branch locations for nested trees.
 
5857
    """list, view and set branch locations for nested trees.
5965
5858
 
5966
5859
    If no arguments are provided, lists the branch locations for nested trees.
5967
5860
    If one argument is provided, display the branch location for that tree.
6007
5900
            self.outf.write('%s %s\n' % (path, location))
6008
5901
 
6009
5902
 
6010
 
def _register_lazy_builtins():
6011
 
    # register lazy builtins from other modules; called at startup and should
6012
 
    # be only called once.
6013
 
    for (name, aliases, module_name) in [
6014
 
        ('cmd_bundle_info', [], 'bzrlib.bundle.commands'),
6015
 
        ('cmd_dpush', [], 'bzrlib.foreign'),
6016
 
        ('cmd_version_info', [], 'bzrlib.cmd_version_info'),
6017
 
        ('cmd_resolve', ['resolved'], 'bzrlib.conflicts'),
6018
 
        ('cmd_conflicts', [], 'bzrlib.conflicts'),
6019
 
        ('cmd_sign_my_commits', [], 'bzrlib.sign_my_commits'),
6020
 
        ]:
6021
 
        builtin_command_registry.register_lazy(name, aliases, module_name)
 
5903
# these get imported and then picked up by the scan for cmd_*
 
5904
# TODO: Some more consistent way to split command definitions across files;
 
5905
# we do need to load at least some information about them to know of
 
5906
# aliases.  ideally we would avoid loading the implementation until the
 
5907
# details were needed.
 
5908
from bzrlib.cmd_version_info import cmd_version_info
 
5909
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore
 
5910
from bzrlib.bundle.commands import (
 
5911
    cmd_bundle_info,
 
5912
    )
 
5913
from bzrlib.foreign import cmd_dpush
 
5914
from bzrlib.sign_my_commits import cmd_sign_my_commits
 
5915
from bzrlib.weave_commands import cmd_versionedfile_list, \
 
5916
        cmd_weave_plan_merge, cmd_weave_merge_text