/brz/remove-bazaar

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

« back to all changes in this revision

Viewing changes to bzrlib/builtins.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2010-02-11 04:02:41 UTC
  • mfrom: (5017.2.2 tariff)
  • Revision ID: pqm@pqm.ubuntu.com-20100211040241-w6n021dz0uus341n
(mbp) add import-tariff tests

Show diffs side-by-side

added added

removed removed

Lines of Context:
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,
239
234
# opens the branch?)
240
235
 
241
236
class cmd_status(Command):
242
 
    __doc__ = """Display status summary.
 
237
    """Display status summary.
243
238
 
244
239
    This reports on versioned and unknown files, reporting them
245
240
    grouped by state.  Possible states are:
332
327
 
333
328
 
334
329
class cmd_cat_revision(Command):
335
 
    __doc__ = """Write out metadata for a revision.
 
330
    """Write out metadata for a revision.
336
331
 
337
332
    The revision to print can either be specified by a specific
338
333
    revision identifier, or you can use --revision.
344
339
    # cat-revision is more for frontends so should be exact
345
340
    encoding = 'strict'
346
341
 
347
 
    def print_revision(self, revisions, revid):
348
 
        stream = revisions.get_record_stream([(revid,)], 'unordered', True)
349
 
        record = stream.next()
350
 
        if record.storage_kind == 'absent':
351
 
            raise errors.NoSuchRevision(revisions, revid)
352
 
        revtext = record.get_bytes_as('fulltext')
353
 
        self.outf.write(revtext.decode('utf-8'))
354
 
 
355
342
    @display_command
356
343
    def run(self, revision_id=None, revision=None):
357
344
        if revision_id is not None and revision is not None:
362
349
                                         ' --revision or a revision_id')
363
350
        b = WorkingTree.open_containing(u'.')[0].branch
364
351
 
365
 
        revisions = b.repository.revisions
366
 
        if revisions is None:
367
 
            raise errors.BzrCommandError('Repository %r does not support '
368
 
                'access to raw revision texts')
 
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'))
369
368
 
370
 
        b.repository.lock_read()
371
 
        try:
372
 
            # TODO: jam 20060112 should cat-revision always output utf-8?
373
 
            if revision_id is not None:
374
 
                revision_id = osutils.safe_revision_id(revision_id, warn=False)
375
 
                try:
376
 
                    self.print_revision(revisions, revision_id)
377
 
                except errors.NoSuchRevision:
378
 
                    msg = "The repository %s contains no revision %s." % (
379
 
                        b.repository.base, revision_id)
380
 
                    raise errors.BzrCommandError(msg)
381
 
            elif revision is not None:
382
 
                for rev in revision:
383
 
                    if rev is None:
384
 
                        raise errors.BzrCommandError(
385
 
                            'You cannot specify a NULL revision.')
386
 
                    rev_id = rev.as_revision_id(b)
387
 
                    self.print_revision(revisions, rev_id)
388
 
        finally:
389
 
            b.repository.unlock()
390
 
        
391
369
 
392
370
class cmd_dump_btree(Command):
393
 
    __doc__ = """Dump the contents of a btree index file to stdout.
 
371
    """Dump the contents of a btree index file to stdout.
394
372
 
395
373
    PATH is a btree index file, it can be any URL. This includes things like
396
374
    .bzr/repository/pack-names, or .bzr/repository/indices/a34b3a...ca4a4.iix
460
438
        for node in bt.iter_all_entries():
461
439
            # Node is made up of:
462
440
            # (index, key, value, [references])
463
 
            try:
464
 
                refs = node[3]
465
 
            except IndexError:
466
 
                refs_as_tuples = None
467
 
            else:
468
 
                refs_as_tuples = static_tuple.as_tuples(refs)
 
441
            refs_as_tuples = static_tuple.as_tuples(node[3])
469
442
            as_tuple = (tuple(node[1]), node[2], refs_as_tuples)
470
443
            self.outf.write('%s\n' % (as_tuple,))
471
444
 
472
445
 
473
446
class cmd_remove_tree(Command):
474
 
    __doc__ = """Remove the working tree from a given branch/checkout.
 
447
    """Remove the working tree from a given branch/checkout.
475
448
 
476
449
    Since a lightweight checkout is little more than a working tree
477
450
    this will refuse to run against one.
479
452
    To re-create the working tree, use "bzr checkout".
480
453
    """
481
454
    _see_also = ['checkout', 'working-trees']
482
 
    takes_args = ['location*']
 
455
    takes_args = ['location?']
483
456
    takes_options = [
484
457
        Option('force',
485
458
               help='Remove the working tree even if it has '
486
459
                    'uncommitted changes.'),
487
460
        ]
488
461
 
489
 
    def run(self, location_list, force=False):
490
 
        if not location_list:
491
 
            location_list=['.']
492
 
 
493
 
        for location in location_list:
494
 
            d = bzrdir.BzrDir.open(location)
495
 
            
496
 
            try:
497
 
                working = d.open_workingtree()
498
 
            except errors.NoWorkingTree:
499
 
                raise errors.BzrCommandError("No working tree to remove")
500
 
            except errors.NotLocalUrl:
501
 
                raise errors.BzrCommandError("You cannot remove the working tree"
502
 
                                             " of a remote path")
503
 
            if not force:
504
 
                if (working.has_changes()):
505
 
                    raise errors.UncommittedChanges(working)
506
 
 
507
 
            if working.user_url != working.branch.user_url:
508
 
                raise errors.BzrCommandError("You cannot remove the working tree"
509
 
                                             " from a lightweight checkout")
510
 
 
511
 
            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()
512
483
 
513
484
 
514
485
class cmd_revno(Command):
515
 
    __doc__ = """Show current revision number.
 
486
    """Show current revision number.
516
487
 
517
488
    This is equal to the number of revisions on this branch.
518
489
    """
528
499
        if tree:
529
500
            try:
530
501
                wt = WorkingTree.open_containing(location)[0]
531
 
                self.add_cleanup(wt.lock_read().unlock)
 
502
                wt.lock_read()
532
503
            except (errors.NoWorkingTree, errors.NotLocalUrl):
533
504
                raise errors.NoWorkingTree(location)
 
505
            self.add_cleanup(wt.unlock)
534
506
            revid = wt.last_revision()
535
507
            try:
536
508
                revno_t = wt.branch.revision_id_to_dotted_revno(revid)
539
511
            revno = ".".join(str(n) for n in revno_t)
540
512
        else:
541
513
            b = Branch.open_containing(location)[0]
542
 
            self.add_cleanup(b.lock_read().unlock)
 
514
            b.lock_read()
 
515
            self.add_cleanup(b.unlock)
543
516
            revno = b.revno()
544
517
        self.cleanup_now()
545
518
        self.outf.write(str(revno) + '\n')
546
519
 
547
520
 
548
521
class cmd_revision_info(Command):
549
 
    __doc__ = """Show revision number and revision id for a given revision identifier.
 
522
    """Show revision number and revision id for a given revision identifier.
550
523
    """
551
524
    hidden = True
552
525
    takes_args = ['revision_info*']
568
541
        try:
569
542
            wt = WorkingTree.open_containing(directory)[0]
570
543
            b = wt.branch
571
 
            self.add_cleanup(wt.lock_read().unlock)
 
544
            wt.lock_read()
 
545
            self.add_cleanup(wt.unlock)
572
546
        except (errors.NoWorkingTree, errors.NotLocalUrl):
573
547
            wt = None
574
548
            b = Branch.open_containing(directory)[0]
575
 
            self.add_cleanup(b.lock_read().unlock)
 
549
            b.lock_read()
 
550
            self.add_cleanup(b.unlock)
576
551
        revision_ids = []
577
552
        if revision is not None:
578
553
            revision_ids.extend(rev.as_revision_id(b) for rev in revision)
606
581
 
607
582
 
608
583
class cmd_add(Command):
609
 
    __doc__ = """Add specified files or directories.
 
584
    """Add specified files or directories.
610
585
 
611
586
    In non-recursive mode, all the named items are added, regardless
612
587
    of whether they were previously ignored.  A warning is given if
677
652
                should_print=(not is_quiet()))
678
653
 
679
654
        if base_tree:
680
 
            self.add_cleanup(base_tree.lock_read().unlock)
 
655
            base_tree.lock_read()
 
656
            self.add_cleanup(base_tree.unlock)
681
657
        tree, file_list = tree_files_for_add(file_list)
682
658
        added, ignored = tree.smart_add(file_list, not
683
659
            no_recurse, action=action, save=not dry_run)
691
667
 
692
668
 
693
669
class cmd_mkdir(Command):
694
 
    __doc__ = """Create a new versioned directory.
 
670
    """Create a new versioned directory.
695
671
 
696
672
    This is equivalent to creating the directory and then adding it.
697
673
    """
701
677
 
702
678
    def run(self, dir_list):
703
679
        for d in dir_list:
 
680
            os.mkdir(d)
704
681
            wt, dd = WorkingTree.open_containing(d)
705
 
            base = os.path.dirname(dd)
706
 
            id = wt.path2id(base)
707
 
            if id != None:
708
 
                os.mkdir(d)
709
 
                wt.add([dd])
710
 
                self.outf.write('added %s\n' % d)
711
 
            else:
712
 
                raise errors.NotVersionedError(path=base)
 
682
            wt.add([dd])
 
683
            self.outf.write('added %s\n' % d)
713
684
 
714
685
 
715
686
class cmd_relpath(Command):
716
 
    __doc__ = """Show path of a file relative to root"""
 
687
    """Show path of a file relative to root"""
717
688
 
718
689
    takes_args = ['filename']
719
690
    hidden = True
728
699
 
729
700
 
730
701
class cmd_inventory(Command):
731
 
    __doc__ = """Show inventory of the current working copy or a revision.
 
702
    """Show inventory of the current working copy or a revision.
732
703
 
733
704
    It is possible to limit the output to a particular entry
734
705
    type using the --kind option.  For example: --kind file.
755
726
 
756
727
        revision = _get_one_revision('inventory', revision)
757
728
        work_tree, file_list = tree_files(file_list)
758
 
        self.add_cleanup(work_tree.lock_read().unlock)
 
729
        work_tree.lock_read()
 
730
        self.add_cleanup(work_tree.unlock)
759
731
        if revision is not None:
760
732
            tree = revision.as_tree(work_tree.branch)
761
733
 
762
734
            extra_trees = [work_tree]
763
 
            self.add_cleanup(tree.lock_read().unlock)
 
735
            tree.lock_read()
 
736
            self.add_cleanup(tree.unlock)
764
737
        else:
765
738
            tree = work_tree
766
739
            extra_trees = []
787
760
 
788
761
 
789
762
class cmd_mv(Command):
790
 
    __doc__ = """Move or rename a file.
 
763
    """Move or rename a file.
791
764
 
792
765
    :Usage:
793
766
        bzr mv OLDNAME NEWNAME
826
799
        if len(names_list) < 2:
827
800
            raise errors.BzrCommandError("missing file argument")
828
801
        tree, rel_names = tree_files(names_list, canonicalize=False)
829
 
        self.add_cleanup(tree.lock_tree_write().unlock)
 
802
        tree.lock_tree_write()
 
803
        self.add_cleanup(tree.unlock)
830
804
        self._run(tree, names_list, rel_names, after)
831
805
 
832
806
    def run_auto(self, names_list, after, dry_run):
837
811
            raise errors.BzrCommandError('--after cannot be specified with'
838
812
                                         ' --auto.')
839
813
        work_tree, file_list = tree_files(names_list, default_branch='.')
840
 
        self.add_cleanup(work_tree.lock_tree_write().unlock)
 
814
        work_tree.lock_tree_write()
 
815
        self.add_cleanup(work_tree.unlock)
841
816
        rename_map.RenameMap.guess_renames(work_tree, dry_run)
842
817
 
843
818
    def _run(self, tree, names_list, rel_names, after):
922
897
 
923
898
 
924
899
class cmd_pull(Command):
925
 
    __doc__ = """Turn this branch into a mirror of another branch.
 
900
    """Turn this branch into a mirror of another branch.
926
901
 
927
902
    By default, this command only works on branches that have not diverged.
928
903
    Branches are considered diverged if the destination branch's most recent 
977
952
        try:
978
953
            tree_to = WorkingTree.open_containing(directory)[0]
979
954
            branch_to = tree_to.branch
980
 
            self.add_cleanup(tree_to.lock_write().unlock)
981
955
        except errors.NoWorkingTree:
982
956
            tree_to = None
983
957
            branch_to = Branch.open_containing(directory)[0]
984
 
            self.add_cleanup(branch_to.lock_write().unlock)
985
 
 
 
958
        
986
959
        if local and not branch_to.get_bound_location():
987
960
            raise errors.LocalRequiresBoundBranch()
988
961
 
1018
991
        else:
1019
992
            branch_from = Branch.open(location,
1020
993
                possible_transports=possible_transports)
1021
 
            self.add_cleanup(branch_from.lock_read().unlock)
1022
994
 
1023
995
            if branch_to.get_parent() is None or remember:
1024
996
                branch_to.set_parent(branch_from.base)
1025
997
 
 
998
        if branch_from is not branch_to:
 
999
            branch_from.lock_read()
 
1000
            self.add_cleanup(branch_from.unlock)
1026
1001
        if revision is not None:
1027
1002
            revision_id = revision.as_revision_id(branch_from)
1028
1003
 
 
1004
        branch_to.lock_write()
 
1005
        self.add_cleanup(branch_to.unlock)
1029
1006
        if tree_to is not None:
1030
1007
            view_info = _get_view_info_for_change_reporter(tree_to)
1031
1008
            change_reporter = delta._ChangeReporter(
1046
1023
 
1047
1024
 
1048
1025
class cmd_push(Command):
1049
 
    __doc__ = """Update a mirror of this branch.
 
1026
    """Update a mirror of this branch.
1050
1027
 
1051
1028
    The target branch will not have its working tree populated because this
1052
1029
    is both expensive, and is not supported on remote file systems.
1113
1090
        # Get the source branch
1114
1091
        (tree, br_from,
1115
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
1116
1096
        # Get the tip's revision_id
1117
1097
        revision = _get_one_revision('push', revision)
1118
1098
        if revision is not None:
1119
1099
            revision_id = revision.in_history(br_from).rev_id
1120
1100
        else:
1121
1101
            revision_id = None
1122
 
        if tree is not None and revision_id is None:
1123
 
            tree.check_changed_or_out_of_date(
1124
 
                strict, 'push_strict',
1125
 
                more_error='Use --no-strict to force the push.',
1126
 
                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
 
1127
1113
        # Get the stacked_on branch, if any
1128
1114
        if stacked_on is not None:
1129
1115
            stacked_on = urlutils.normalize_url(stacked_on)
1161
1147
 
1162
1148
 
1163
1149
class cmd_branch(Command):
1164
 
    __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.
1165
1151
 
1166
1152
    If the TO_LOCATION is omitted, the last component of the FROM_LOCATION will
1167
1153
    be used.  In other words, "branch ../foo/bar" will attempt to create ./bar.
1207
1193
        accelerator_tree, br_from = bzrdir.BzrDir.open_tree_or_branch(
1208
1194
            from_location)
1209
1195
        revision = _get_one_revision('branch', revision)
1210
 
        self.add_cleanup(br_from.lock_read().unlock)
 
1196
        br_from.lock_read()
 
1197
        self.add_cleanup(br_from.unlock)
1211
1198
        if revision is not None:
1212
1199
            revision_id = revision.as_revision_id(br_from)
1213
1200
        else:
1273
1260
 
1274
1261
 
1275
1262
class cmd_checkout(Command):
1276
 
    __doc__ = """Create a new checkout of an existing branch.
 
1263
    """Create a new checkout of an existing branch.
1277
1264
 
1278
1265
    If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
1279
1266
    the branch found in '.'. This is useful if you have removed the working tree
1342
1329
 
1343
1330
 
1344
1331
class cmd_renames(Command):
1345
 
    __doc__ = """Show list of renamed files.
 
1332
    """Show list of renamed files.
1346
1333
    """
1347
1334
    # TODO: Option to show renames between two historical versions.
1348
1335
 
1353
1340
    @display_command
1354
1341
    def run(self, dir=u'.'):
1355
1342
        tree = WorkingTree.open_containing(dir)[0]
1356
 
        self.add_cleanup(tree.lock_read().unlock)
 
1343
        tree.lock_read()
 
1344
        self.add_cleanup(tree.unlock)
1357
1345
        new_inv = tree.inventory
1358
1346
        old_tree = tree.basis_tree()
1359
 
        self.add_cleanup(old_tree.lock_read().unlock)
 
1347
        old_tree.lock_read()
 
1348
        self.add_cleanup(old_tree.unlock)
1360
1349
        old_inv = old_tree.inventory
1361
1350
        renames = []
1362
1351
        iterator = tree.iter_changes(old_tree, include_unchanged=True)
1372
1361
 
1373
1362
 
1374
1363
class cmd_update(Command):
1375
 
    __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.
1376
1365
 
1377
1366
    This will perform a merge into the working tree, and may generate
1378
1367
    conflicts. If you have any local changes, you will still
1400
1389
        master = branch.get_master_branch(
1401
1390
            possible_transports=possible_transports)
1402
1391
        if master is not None:
 
1392
            tree.lock_write()
1403
1393
            branch_location = master.base
1404
 
            tree.lock_write()
1405
1394
        else:
 
1395
            tree.lock_tree_write()
1406
1396
            branch_location = tree.branch.base
1407
 
            tree.lock_tree_write()
1408
1397
        self.add_cleanup(tree.unlock)
1409
1398
        # get rid of the final '/' and be ready for display
1410
 
        branch_location = urlutils.unescape_for_display(
1411
 
            branch_location.rstrip('/'),
1412
 
            self.outf.encoding)
 
1399
        branch_location = urlutils.unescape_for_display(branch_location[:-1],
 
1400
                                                        self.outf.encoding)
1413
1401
        existing_pending_merges = tree.get_parent_ids()[1:]
1414
1402
        if master is None:
1415
1403
            old_tip = None
1423
1411
        else:
1424
1412
            revision_id = branch.last_revision()
1425
1413
        if revision_id == _mod_revision.ensure_null(tree.last_revision()):
1426
 
            revno = branch.revision_id_to_dotted_revno(revision_id)
1427
 
            note("Tree is up to date at revision %s of branch %s" %
1428
 
                ('.'.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))
1429
1417
            return 0
1430
1418
        view_info = _get_view_info_for_change_reporter(tree)
1431
1419
        change_reporter = delta._ChangeReporter(
1443
1431
                                  "bzr update --revision only works"
1444
1432
                                  " for a revision in the branch history"
1445
1433
                                  % (e.revision))
1446
 
        revno = tree.branch.revision_id_to_dotted_revno(
 
1434
        revno = tree.branch.revision_id_to_revno(
1447
1435
            _mod_revision.ensure_null(tree.last_revision()))
1448
 
        note('Updated to revision %s of branch %s' %
1449
 
             ('.'.join(map(str, revno)), branch_location))
1450
 
        parent_ids = tree.get_parent_ids()
1451
 
        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:
1452
1439
            note('Your local commits will now show as pending merges with '
1453
1440
                 "'bzr status', and can be committed with 'bzr commit'.")
1454
1441
        if conflicts != 0:
1458
1445
 
1459
1446
 
1460
1447
class cmd_info(Command):
1461
 
    __doc__ = """Show information about a working tree, branch or repository.
 
1448
    """Show information about a working tree, branch or repository.
1462
1449
 
1463
1450
    This command will show all known locations and formats associated to the
1464
1451
    tree, branch or repository.
1502
1489
 
1503
1490
 
1504
1491
class cmd_remove(Command):
1505
 
    __doc__ = """Remove files or directories.
 
1492
    """Remove files or directories.
1506
1493
 
1507
1494
    This makes bzr stop tracking changes to the specified files. bzr will delete
1508
1495
    them if they can easily be recovered using revert. If no options or
1530
1517
        if file_list is not None:
1531
1518
            file_list = [f for f in file_list]
1532
1519
 
1533
 
        self.add_cleanup(tree.lock_write().unlock)
 
1520
        tree.lock_write()
 
1521
        self.add_cleanup(tree.unlock)
1534
1522
        # Heuristics should probably all move into tree.remove_smart or
1535
1523
        # some such?
1536
1524
        if new:
1555
1543
 
1556
1544
 
1557
1545
class cmd_file_id(Command):
1558
 
    __doc__ = """Print file_id of a particular file or directory.
 
1546
    """Print file_id of a particular file or directory.
1559
1547
 
1560
1548
    The file_id is assigned when the file is first added and remains the
1561
1549
    same through all revisions where the file exists, even when it is
1577
1565
 
1578
1566
 
1579
1567
class cmd_file_path(Command):
1580
 
    __doc__ = """Print path of file_ids to a file or directory.
 
1568
    """Print path of file_ids to a file or directory.
1581
1569
 
1582
1570
    This prints one line for each directory down to the target,
1583
1571
    starting at the branch root.
1599
1587
 
1600
1588
 
1601
1589
class cmd_reconcile(Command):
1602
 
    __doc__ = """Reconcile bzr metadata in a branch.
 
1590
    """Reconcile bzr metadata in a branch.
1603
1591
 
1604
1592
    This can correct data mismatches that may have been caused by
1605
1593
    previous ghost operations or bzr upgrades. You should only
1627
1615
 
1628
1616
 
1629
1617
class cmd_revision_history(Command):
1630
 
    __doc__ = """Display the list of revision ids on a branch."""
 
1618
    """Display the list of revision ids on a branch."""
1631
1619
 
1632
1620
    _see_also = ['log']
1633
1621
    takes_args = ['location?']
1643
1631
 
1644
1632
 
1645
1633
class cmd_ancestry(Command):
1646
 
    __doc__ = """List all revisions merged into this branch."""
 
1634
    """List all revisions merged into this branch."""
1647
1635
 
1648
1636
    _see_also = ['log', 'revision-history']
1649
1637
    takes_args = ['location?']
1668
1656
 
1669
1657
 
1670
1658
class cmd_init(Command):
1671
 
    __doc__ = """Make a directory into a versioned branch.
 
1659
    """Make a directory into a versioned branch.
1672
1660
 
1673
1661
    Use this to create an empty branch, or before importing an
1674
1662
    existing project.
1777
1765
 
1778
1766
 
1779
1767
class cmd_init_repository(Command):
1780
 
    __doc__ = """Create a shared repository for branches to share storage space.
 
1768
    """Create a shared repository for branches to share storage space.
1781
1769
 
1782
1770
    New branches created under the repository directory will store their
1783
1771
    revisions in the repository, not in the branch directory.  For branches
1837
1825
 
1838
1826
 
1839
1827
class cmd_diff(Command):
1840
 
    __doc__ = """Show differences in the working tree, between revisions or branches.
 
1828
    """Show differences in the working tree, between revisions or branches.
1841
1829
 
1842
1830
    If no arguments are given, all changes for the current tree are listed.
1843
1831
    If files are given, only the changes in those files are listed.
1929
1917
            help='Use this command to compare files.',
1930
1918
            type=unicode,
1931
1919
            ),
1932
 
        RegistryOption('format',
1933
 
            help='Diff format to use.',
1934
 
            lazy_registry=('bzrlib.diff', 'format_registry'),
1935
 
            value_switches=False, title='Diff format'),
1936
1920
        ]
1937
1921
    aliases = ['di', 'dif']
1938
1922
    encoding_type = 'exact'
1939
1923
 
1940
1924
    @display_command
1941
1925
    def run(self, revision=None, file_list=None, diff_options=None,
1942
 
            prefix=None, old=None, new=None, using=None, format=None):
1943
 
        from bzrlib.diff import (get_trees_and_branches_to_diff_locked,
1944
 
            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
1945
1928
 
1946
1929
        if (prefix is None) or (prefix == '0'):
1947
1930
            # diff -p0 format
1961
1944
            raise errors.BzrCommandError('bzr diff --revision takes exactly'
1962
1945
                                         ' one or two revision specifiers')
1963
1946
 
1964
 
        if using is not None and format is not None:
1965
 
            raise errors.BzrCommandError('--using and --format are mutually '
1966
 
                'exclusive.')
1967
 
 
1968
1947
        (old_tree, new_tree,
1969
1948
         old_branch, new_branch,
1970
 
         specific_files, extra_trees) = get_trees_and_branches_to_diff_locked(
1971
 
            file_list, revision, old, new, self.add_cleanup, apply_view=True)
 
1949
         specific_files, extra_trees) = get_trees_and_branches_to_diff(
 
1950
            file_list, revision, old, new, apply_view=True)
1972
1951
        return show_diff_trees(old_tree, new_tree, sys.stdout,
1973
1952
                               specific_files=specific_files,
1974
1953
                               external_diff_options=diff_options,
1975
1954
                               old_label=old_label, new_label=new_label,
1976
 
                               extra_trees=extra_trees, using=using,
1977
 
                               format_cls=format)
 
1955
                               extra_trees=extra_trees, using=using)
1978
1956
 
1979
1957
 
1980
1958
class cmd_deleted(Command):
1981
 
    __doc__ = """List files deleted in the working tree.
 
1959
    """List files deleted in the working tree.
1982
1960
    """
1983
1961
    # TODO: Show files deleted since a previous revision, or
1984
1962
    # between two revisions.
1992
1970
    @display_command
1993
1971
    def run(self, show_ids=False):
1994
1972
        tree = WorkingTree.open_containing(u'.')[0]
1995
 
        self.add_cleanup(tree.lock_read().unlock)
 
1973
        tree.lock_read()
 
1974
        self.add_cleanup(tree.unlock)
1996
1975
        old = tree.basis_tree()
1997
 
        self.add_cleanup(old.lock_read().unlock)
 
1976
        old.lock_read()
 
1977
        self.add_cleanup(old.unlock)
1998
1978
        for path, ie in old.inventory.iter_entries():
1999
1979
            if not tree.has_id(ie.file_id):
2000
1980
                self.outf.write(path)
2005
1985
 
2006
1986
 
2007
1987
class cmd_modified(Command):
2008
 
    __doc__ = """List files modified in working tree.
 
1988
    """List files modified in working tree.
2009
1989
    """
2010
1990
 
2011
1991
    hidden = True
2028
2008
 
2029
2009
 
2030
2010
class cmd_added(Command):
2031
 
    __doc__ = """List files added in working tree.
 
2011
    """List files added in working tree.
2032
2012
    """
2033
2013
 
2034
2014
    hidden = True
2042
2022
    @display_command
2043
2023
    def run(self, null=False):
2044
2024
        wt = WorkingTree.open_containing(u'.')[0]
2045
 
        self.add_cleanup(wt.lock_read().unlock)
 
2025
        wt.lock_read()
 
2026
        self.add_cleanup(wt.unlock)
2046
2027
        basis = wt.basis_tree()
2047
 
        self.add_cleanup(basis.lock_read().unlock)
 
2028
        basis.lock_read()
 
2029
        self.add_cleanup(basis.unlock)
2048
2030
        basis_inv = basis.inventory
2049
2031
        inv = wt.inventory
2050
2032
        for file_id in inv:
2062
2044
 
2063
2045
 
2064
2046
class cmd_root(Command):
2065
 
    __doc__ = """Show the tree root directory.
 
2047
    """Show the tree root directory.
2066
2048
 
2067
2049
    The root is the nearest enclosing directory with a .bzr control
2068
2050
    directory."""
2092
2074
 
2093
2075
 
2094
2076
class cmd_log(Command):
2095
 
    __doc__ = """Show historical log for a branch or subset of a branch.
 
2077
    """Show historical log for a branch or subset of a branch.
2096
2078
 
2097
2079
    log is bzr's default tool for exploring the history of a branch.
2098
2080
    The branch to use is taken from the first parameter. If no parameters
2279
2261
                   help='Show changes made in each revision as a patch.'),
2280
2262
            Option('include-merges',
2281
2263
                   help='Show merged revisions like --levels 0 does.'),
2282
 
            Option('exclude-common-ancestry',
2283
 
                   help='Display only the revisions that are not part'
2284
 
                   ' of both ancestries (require -rX..Y)'
2285
 
                   )
2286
2264
            ]
2287
2265
    encoding_type = 'replace'
2288
2266
 
2298
2276
            message=None,
2299
2277
            limit=None,
2300
2278
            show_diff=False,
2301
 
            include_merges=False,
2302
 
            exclude_common_ancestry=False,
2303
 
            ):
 
2279
            include_merges=False):
2304
2280
        from bzrlib.log import (
2305
2281
            Logger,
2306
2282
            make_log_request_dict,
2307
2283
            _get_info_for_log_files,
2308
2284
            )
2309
2285
        direction = (forward and 'forward') or 'reverse'
2310
 
        if (exclude_common_ancestry
2311
 
            and (revision is None or len(revision) != 2)):
2312
 
            raise errors.BzrCommandError(
2313
 
                '--exclude-common-ancestry requires -r with two revisions')
2314
2286
        if include_merges:
2315
2287
            if levels is None:
2316
2288
                levels = 0
2332
2304
        if file_list:
2333
2305
            # find the file ids to log and check for directory filtering
2334
2306
            b, file_info_list, rev1, rev2 = _get_info_for_log_files(
2335
 
                revision, file_list, self.add_cleanup)
 
2307
                revision, file_list)
 
2308
            self.add_cleanup(b.unlock)
2336
2309
            for relpath, file_id, kind in file_info_list:
2337
2310
                if file_id is None:
2338
2311
                    raise errors.BzrCommandError(
2356
2329
                location = '.'
2357
2330
            dir, relpath = bzrdir.BzrDir.open_containing(location)
2358
2331
            b = dir.open_branch()
2359
 
            self.add_cleanup(b.lock_read().unlock)
 
2332
            b.lock_read()
 
2333
            self.add_cleanup(b.unlock)
2360
2334
            rev1, rev2 = _get_revision_range(revision, b, self.name())
2361
2335
 
2362
2336
        # Decide on the type of delta & diff filtering to use
2407
2381
            direction=direction, specific_fileids=file_ids,
2408
2382
            start_revision=rev1, end_revision=rev2, limit=limit,
2409
2383
            message_search=message, delta_type=delta_type,
2410
 
            diff_type=diff_type, _match_using_deltas=match_using_deltas,
2411
 
            exclude_common_ancestry=exclude_common_ancestry,
2412
 
            )
 
2384
            diff_type=diff_type, _match_using_deltas=match_using_deltas)
2413
2385
        Logger(b, rqst).show(lf)
2414
2386
 
2415
2387
 
2434
2406
            raise errors.BzrCommandError(
2435
2407
                "bzr %s doesn't accept two revisions in different"
2436
2408
                " branches." % command_name)
2437
 
        if start_spec.spec is None:
2438
 
            # Avoid loading all the history.
2439
 
            rev1 = RevisionInfo(branch, None, None)
2440
 
        else:
2441
 
            rev1 = start_spec.in_history(branch)
 
2409
        rev1 = start_spec.in_history(branch)
2442
2410
        # Avoid loading all of history when we know a missing
2443
2411
        # end of range means the last revision ...
2444
2412
        if end_spec.spec is None:
2473
2441
 
2474
2442
 
2475
2443
class cmd_touching_revisions(Command):
2476
 
    __doc__ = """Return revision-ids which affected a particular file.
 
2444
    """Return revision-ids which affected a particular file.
2477
2445
 
2478
2446
    A more user-friendly interface is "bzr log FILE".
2479
2447
    """
2486
2454
        tree, relpath = WorkingTree.open_containing(filename)
2487
2455
        file_id = tree.path2id(relpath)
2488
2456
        b = tree.branch
2489
 
        self.add_cleanup(b.lock_read().unlock)
 
2457
        b.lock_read()
 
2458
        self.add_cleanup(b.unlock)
2490
2459
        touching_revs = log.find_touching_revisions(b, file_id)
2491
2460
        for revno, revision_id, what in touching_revs:
2492
2461
            self.outf.write("%6d %s\n" % (revno, what))
2493
2462
 
2494
2463
 
2495
2464
class cmd_ls(Command):
2496
 
    __doc__ = """List files in a tree.
 
2465
    """List files in a tree.
2497
2466
    """
2498
2467
 
2499
2468
    _see_also = ['status', 'cat']
2561
2530
                view_str = views.view_display_str(view_files)
2562
2531
                note("Ignoring files outside view. View is %s" % view_str)
2563
2532
 
2564
 
        self.add_cleanup(tree.lock_read().unlock)
 
2533
        tree.lock_read()
 
2534
        self.add_cleanup(tree.unlock)
2565
2535
        for fp, fc, fkind, fid, entry in tree.list_files(include_root=False,
2566
2536
            from_dir=relpath, recursive=recursive):
2567
2537
            # Apply additional masking
2609
2579
 
2610
2580
 
2611
2581
class cmd_unknowns(Command):
2612
 
    __doc__ = """List unknown files.
 
2582
    """List unknown files.
2613
2583
    """
2614
2584
 
2615
2585
    hidden = True
2622
2592
 
2623
2593
 
2624
2594
class cmd_ignore(Command):
2625
 
    __doc__ = """Ignore specified files or patterns.
 
2595
    """Ignore specified files or patterns.
2626
2596
 
2627
2597
    See ``bzr help patterns`` for details on the syntax of patterns.
2628
2598
 
2637
2607
    using this command or directly by using an editor, be sure to commit
2638
2608
    it.
2639
2609
    
2640
 
    Bazaar also supports a global ignore file ~/.bazaar/ignore. On Windows
2641
 
    the global ignore file can be found in the application data directory as
2642
 
    C:\\Documents and Settings\\<user>\\Application Data\\Bazaar\\2.0\\ignore.
2643
 
    Global ignores are not touched by this command. The global ignore file
2644
 
    can be edited directly using an editor.
2645
 
 
2646
2610
    Patterns prefixed with '!' are exceptions to ignore patterns and take
2647
2611
    precedence over regular ignores.  Such exceptions are used to specify
2648
2612
    files that should be versioned which would otherwise be ignored.
2689
2653
    _see_also = ['status', 'ignored', 'patterns']
2690
2654
    takes_args = ['name_pattern*']
2691
2655
    takes_options = [
2692
 
        Option('default-rules',
2693
 
               help='Display the default ignore rules that bzr uses.')
 
2656
        Option('old-default-rules',
 
2657
               help='Write out the ignore rules bzr < 0.9 always used.')
2694
2658
        ]
2695
2659
 
2696
 
    def run(self, name_pattern_list=None, default_rules=None):
 
2660
    def run(self, name_pattern_list=None, old_default_rules=None):
2697
2661
        from bzrlib import ignores
2698
 
        if default_rules is not None:
2699
 
            # dump the default rules and exit
2700
 
            for pattern in ignores.USER_DEFAULTS:
2701
 
                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
2702
2666
            return
2703
2667
        if not name_pattern_list:
2704
2668
            raise errors.BzrCommandError("ignore requires at least one "
2705
 
                "NAME_PATTERN or --default-rules.")
 
2669
                                  "NAME_PATTERN or --old-default-rules")
2706
2670
        name_pattern_list = [globbing.normalize_pattern(p)
2707
2671
                             for p in name_pattern_list]
2708
2672
        for name_pattern in name_pattern_list:
2720
2684
            if id is not None:
2721
2685
                filename = entry[0]
2722
2686
                if ignored.match(filename):
2723
 
                    matches.append(filename)
 
2687
                    matches.append(filename.encode('utf-8'))
2724
2688
        tree.unlock()
2725
2689
        if len(matches) > 0:
2726
 
            self.outf.write("Warning: the following files are version controlled and"
2727
 
                  " match your ignore pattern:\n%s"
2728
 
                  "\nThese files will continue to be version controlled"
2729
 
                  " 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),)
2730
2694
 
2731
2695
 
2732
2696
class cmd_ignored(Command):
2733
 
    __doc__ = """List ignored files and the patterns that matched them.
 
2697
    """List ignored files and the patterns that matched them.
2734
2698
 
2735
2699
    List all the ignored files and the ignore pattern that caused the file to
2736
2700
    be ignored.
2746
2710
    @display_command
2747
2711
    def run(self):
2748
2712
        tree = WorkingTree.open_containing(u'.')[0]
2749
 
        self.add_cleanup(tree.lock_read().unlock)
 
2713
        tree.lock_read()
 
2714
        self.add_cleanup(tree.unlock)
2750
2715
        for path, file_class, kind, file_id, entry in tree.list_files():
2751
2716
            if file_class != 'I':
2752
2717
                continue
2756
2721
 
2757
2722
 
2758
2723
class cmd_lookup_revision(Command):
2759
 
    __doc__ = """Lookup the revision-id from a revision-number
 
2724
    """Lookup the revision-id from a revision-number
2760
2725
 
2761
2726
    :Examples:
2762
2727
        bzr lookup-revision 33
2769
2734
        try:
2770
2735
            revno = int(revno)
2771
2736
        except ValueError:
2772
 
            raise errors.BzrCommandError("not a valid revision-number: %r"
2773
 
                                         % revno)
2774
 
        revid = WorkingTree.open_containing(u'.')[0].branch.get_rev_id(revno)
2775
 
        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)
2776
2740
 
2777
2741
 
2778
2742
class cmd_export(Command):
2779
 
    __doc__ = """Export current or past revision to a destination directory or archive.
 
2743
    """Export current or past revision to a destination directory or archive.
2780
2744
 
2781
2745
    If no revision is specified this exports the last committed revision.
2782
2746
 
2814
2778
        Option('root',
2815
2779
               type=str,
2816
2780
               help="Name of the root directory inside the exported file."),
2817
 
        Option('per-file-timestamps',
2818
 
               help='Set modification time of files to that of the last '
2819
 
                    'revision in which it was changed.'),
2820
2781
        ]
2821
2782
    def run(self, dest, branch_or_subdir=None, revision=None, format=None,
2822
 
        root=None, filters=False, per_file_timestamps=False):
 
2783
        root=None, filters=False):
2823
2784
        from bzrlib.export import export
2824
2785
 
2825
2786
        if branch_or_subdir is None:
2832
2793
 
2833
2794
        rev_tree = _get_one_revision_tree('export', revision, branch=b, tree=tree)
2834
2795
        try:
2835
 
            export(rev_tree, dest, format, root, subdir, filtered=filters,
2836
 
                   per_file_timestamps=per_file_timestamps)
 
2796
            export(rev_tree, dest, format, root, subdir, filtered=filters)
2837
2797
        except errors.NoSuchExportFormat, e:
2838
2798
            raise errors.BzrCommandError('Unsupported export format: %s' % e.format)
2839
2799
 
2840
2800
 
2841
2801
class cmd_cat(Command):
2842
 
    __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.
2843
2803
 
2844
2804
    If no revision is nominated, the last revision is used.
2845
2805
 
2865
2825
                                         " one revision specifier")
2866
2826
        tree, branch, relpath = \
2867
2827
            bzrdir.BzrDir.open_containing_tree_or_branch(filename)
2868
 
        self.add_cleanup(branch.lock_read().unlock)
 
2828
        branch.lock_read()
 
2829
        self.add_cleanup(branch.unlock)
2869
2830
        return self._run(tree, branch, relpath, filename, revision,
2870
2831
                         name_from_revision, filters)
2871
2832
 
2874
2835
        if tree is None:
2875
2836
            tree = b.basis_tree()
2876
2837
        rev_tree = _get_one_revision_tree('cat', revision, branch=b)
2877
 
        self.add_cleanup(rev_tree.lock_read().unlock)
 
2838
        rev_tree.lock_read()
 
2839
        self.add_cleanup(rev_tree.unlock)
2878
2840
 
2879
2841
        old_file_id = rev_tree.path2id(relpath)
2880
2842
 
2923
2885
 
2924
2886
 
2925
2887
class cmd_local_time_offset(Command):
2926
 
    __doc__ = """Show the offset in seconds from GMT to local time."""
 
2888
    """Show the offset in seconds from GMT to local time."""
2927
2889
    hidden = True
2928
2890
    @display_command
2929
2891
    def run(self):
2930
 
        self.outf.write("%s\n" % osutils.local_time_offset())
 
2892
        print osutils.local_time_offset()
2931
2893
 
2932
2894
 
2933
2895
 
2934
2896
class cmd_commit(Command):
2935
 
    __doc__ = """Commit changes into a new revision.
 
2897
    """Commit changes into a new revision.
2936
2898
 
2937
2899
    An explanatory message needs to be given for each commit. This is
2938
2900
    often done by using the --message option (getting the message from the
3046
3008
                         "the master branch until a normal commit "
3047
3009
                         "is performed."
3048
3010
                    ),
3049
 
             Option('show-diff', short_name='p',
 
3011
             Option('show-diff',
3050
3012
                    help='When no message is supplied, show the diff along'
3051
3013
                    ' with the status summary in the message editor.'),
3052
3014
             ]
3132
3094
                    '(use --file "%(f)s" to take commit message from that file)'
3133
3095
                    % { 'f': message })
3134
3096
                ui.ui_factory.show_warning(warning_msg)
3135
 
            if '\r' in message:
3136
 
                message = message.replace('\r\n', '\n')
3137
 
                message = message.replace('\r', '\n')
3138
 
            if file:
3139
 
                raise errors.BzrCommandError(
3140
 
                    "please specify either --message or --file")
3141
3097
 
3142
3098
        def get_message(commit_obj):
3143
3099
            """Callback to get commit message"""
3144
 
            if file:
3145
 
                my_message = codecs.open(
3146
 
                    file, 'rt', osutils.get_user_encoding()).read()
3147
 
            elif message is not None:
3148
 
                my_message = message
3149
 
            else:
3150
 
                # No message supplied: make one up.
3151
 
                # text is the status of the tree
3152
 
                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,
3153
3106
                        selected_list, diff=show_diff,
3154
3107
                        output_encoding=osutils.get_user_encoding())
3155
 
                # start_message is the template generated from hooks
3156
 
                # XXX: Warning - looks like hooks return unicode,
3157
 
                # make_commit_message_template_encoded returns user encoding.
3158
 
                # We probably want to be using edit_commit_message instead to
3159
 
                # avoid this.
3160
3108
                start_message = generate_commit_message_template(commit_obj)
3161
 
                my_message = edit_commit_message_encoded(text,
 
3109
                my_message = edit_commit_message_encoded(t,
3162
3110
                    start_message=start_message)
3163
3111
                if my_message is None:
3164
3112
                    raise errors.BzrCommandError("please specify a commit"
3165
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()
3166
3120
            if my_message == "":
3167
3121
                raise errors.BzrCommandError("empty commit message specified")
3168
3122
            return my_message
3180
3134
                        timezone=offset,
3181
3135
                        exclude=safe_relpath_files(tree, exclude))
3182
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
3183
3139
            raise errors.BzrCommandError("No changes to commit."
3184
3140
                              " Use --unchanged to commit anyhow.")
3185
3141
        except ConflictsInTree:
3190
3146
            raise errors.BzrCommandError("Commit refused because there are"
3191
3147
                              " unknown files in the working tree.")
3192
3148
        except errors.BoundBranchOutOfDate, e:
3193
 
            e.extra_help = ("\n"
3194
 
                'To commit to master branch, run update and then commit.\n'
3195
 
                'You can also pass --local to commit to continue working '
3196
 
                'disconnected.')
3197
 
            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.')
3198
3153
 
3199
3154
 
3200
3155
class cmd_check(Command):
3201
 
    __doc__ = """Validate working tree structure, branch consistency and repository history.
 
3156
    """Validate working tree structure, branch consistency and repository history.
3202
3157
 
3203
3158
    This command checks various invariants about branch and repository storage
3204
3159
    to detect data corruption or bzr bugs.
3268
3223
 
3269
3224
 
3270
3225
class cmd_upgrade(Command):
3271
 
    __doc__ = """Upgrade branch storage to current format.
 
3226
    """Upgrade branch storage to current format.
3272
3227
 
3273
3228
    The check command or bzr developers may sometimes advise you to run
3274
3229
    this command. When the default format has changed you may also be warned
3292
3247
 
3293
3248
 
3294
3249
class cmd_whoami(Command):
3295
 
    __doc__ = """Show or set bzr user id.
 
3250
    """Show or set bzr user id.
3296
3251
 
3297
3252
    :Examples:
3298
3253
        Show the email of the current user::
3342
3297
 
3343
3298
 
3344
3299
class cmd_nick(Command):
3345
 
    __doc__ = """Print or set the branch nickname.
 
3300
    """Print or set the branch nickname.
3346
3301
 
3347
3302
    If unset, the tree root directory name is used as the nickname.
3348
3303
    To print the current nickname, execute with no argument.
3362
3317
 
3363
3318
    @display_command
3364
3319
    def printme(self, branch):
3365
 
        self.outf.write('%s\n' % branch.nick)
 
3320
        print branch.nick
3366
3321
 
3367
3322
 
3368
3323
class cmd_alias(Command):
3369
 
    __doc__ = """Set/unset and display aliases.
 
3324
    """Set/unset and display aliases.
3370
3325
 
3371
3326
    :Examples:
3372
3327
        Show the current aliases::
3436
3391
 
3437
3392
 
3438
3393
class cmd_selftest(Command):
3439
 
    __doc__ = """Run internal test suite.
 
3394
    """Run internal test suite.
3440
3395
 
3441
3396
    If arguments are given, they are regular expressions that say which tests
3442
3397
    should run.  Tests matching any expression are run, and other tests are
3489
3444
            from bzrlib.tests import stub_sftp
3490
3445
            return stub_sftp.SFTPAbsoluteServer
3491
3446
        if typestring == "memory":
3492
 
            from bzrlib.tests import test_server
3493
 
            return memory.MemoryServer
 
3447
            from bzrlib.transport.memory import MemoryServer
 
3448
            return MemoryServer
3494
3449
        if typestring == "fakenfs":
3495
 
            from bzrlib.tests import test_server
3496
 
            return test_server.FakeNFSServer
 
3450
            from bzrlib.transport.fakenfs import FakeNFSServer
 
3451
            return FakeNFSServer
3497
3452
        msg = "No known transport type %s. Supported types are: sftp\n" %\
3498
3453
            (typestring)
3499
3454
        raise errors.BzrCommandError(msg)
3583
3538
                raise errors.BzrCommandError("subunit not available. subunit "
3584
3539
                    "needs to be installed to use --subunit.")
3585
3540
            self.additional_selftest_args['runner_class'] = SubUnitBzrRunner
3586
 
            # On Windows, disable automatic conversion of '\n' to '\r\n' in
3587
 
            # stdout, which would corrupt the subunit stream. 
3588
 
            if sys.platform == "win32" and sys.stdout.fileno() >= 0:
3589
 
                import msvcrt
3590
 
                msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
3591
3541
        if parallel:
3592
3542
            self.additional_selftest_args.setdefault(
3593
3543
                'suite_decorators', []).append(parallel)
3624
3574
 
3625
3575
 
3626
3576
class cmd_version(Command):
3627
 
    __doc__ = """Show version of bzr."""
 
3577
    """Show version of bzr."""
3628
3578
 
3629
3579
    encoding_type = 'replace'
3630
3580
    takes_options = [
3641
3591
 
3642
3592
 
3643
3593
class cmd_rocks(Command):
3644
 
    __doc__ = """Statement of optimism."""
 
3594
    """Statement of optimism."""
3645
3595
 
3646
3596
    hidden = True
3647
3597
 
3648
3598
    @display_command
3649
3599
    def run(self):
3650
 
        self.outf.write("It sure does!\n")
 
3600
        print "It sure does!"
3651
3601
 
3652
3602
 
3653
3603
class cmd_find_merge_base(Command):
3654
 
    __doc__ = """Find and print a base revision for merging two branches."""
 
3604
    """Find and print a base revision for merging two branches."""
3655
3605
    # TODO: Options to specify revisions on either side, as if
3656
3606
    #       merging only part of the history.
3657
3607
    takes_args = ['branch', 'other']
3663
3613
 
3664
3614
        branch1 = Branch.open_containing(branch)[0]
3665
3615
        branch2 = Branch.open_containing(other)[0]
3666
 
        self.add_cleanup(branch1.lock_read().unlock)
3667
 
        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)
3668
3620
        last1 = ensure_null(branch1.last_revision())
3669
3621
        last2 = ensure_null(branch2.last_revision())
3670
3622
 
3671
3623
        graph = branch1.repository.get_graph(branch2.repository)
3672
3624
        base_rev_id = graph.find_unique_lca(last1, last2)
3673
3625
 
3674
 
        self.outf.write('merge base is revision %s\n' % base_rev_id)
 
3626
        print 'merge base is revision %s' % base_rev_id
3675
3627
 
3676
3628
 
3677
3629
class cmd_merge(Command):
3678
 
    __doc__ = """Perform a three-way merge.
 
3630
    """Perform a three-way merge.
3679
3631
 
3680
3632
    The source of the merge can be specified either in the form of a branch,
3681
3633
    or in the form of a path to a file containing a merge directive generated
3808
3760
            unversioned_filter=tree.is_ignored, view_info=view_info)
3809
3761
        pb = ui.ui_factory.nested_progress_bar()
3810
3762
        self.add_cleanup(pb.finished)
3811
 
        self.add_cleanup(tree.lock_write().unlock)
 
3763
        tree.lock_write()
 
3764
        self.add_cleanup(tree.unlock)
3812
3765
        if location is not None:
3813
3766
            try:
3814
3767
                mergeable = bundle.read_mergeable_from_url(location,
4035
3988
 
4036
3989
 
4037
3990
class cmd_remerge(Command):
4038
 
    __doc__ = """Redo a merge.
 
3991
    """Redo a merge.
4039
3992
 
4040
3993
    Use this if you want to try a different merge technique while resolving
4041
3994
    conflicts.  Some merge techniques are better than others, and remerge
4066
4019
 
4067
4020
    def run(self, file_list=None, merge_type=None, show_base=False,
4068
4021
            reprocess=False):
4069
 
        from bzrlib.conflicts import restore
4070
4022
        if merge_type is None:
4071
4023
            merge_type = _mod_merge.Merge3Merger
4072
4024
        tree, file_list = tree_files(file_list)
4073
 
        self.add_cleanup(tree.lock_write().unlock)
 
4025
        tree.lock_write()
 
4026
        self.add_cleanup(tree.unlock)
4074
4027
        parents = tree.get_parent_ids()
4075
4028
        if len(parents) != 2:
4076
4029
            raise errors.BzrCommandError("Sorry, remerge only works after normal"
4129
4082
 
4130
4083
 
4131
4084
class cmd_revert(Command):
4132
 
    __doc__ = """Revert files to a previous revision.
 
4085
    """Revert files to a previous revision.
4133
4086
 
4134
4087
    Giving a list of files will revert only those files.  Otherwise, all files
4135
4088
    will be reverted.  If the revision is not specified with '--revision', the
4186
4139
    def run(self, revision=None, no_backup=False, file_list=None,
4187
4140
            forget_merges=None):
4188
4141
        tree, file_list = tree_files(file_list)
4189
 
        self.add_cleanup(tree.lock_tree_write().unlock)
 
4142
        tree.lock_write()
 
4143
        self.add_cleanup(tree.unlock)
4190
4144
        if forget_merges:
4191
4145
            tree.set_parent_ids(tree.get_parent_ids()[:1])
4192
4146
        else:
4200
4154
 
4201
4155
 
4202
4156
class cmd_assert_fail(Command):
4203
 
    __doc__ = """Test reporting of assertion failures"""
 
4157
    """Test reporting of assertion failures"""
4204
4158
    # intended just for use in testing
4205
4159
 
4206
4160
    hidden = True
4210
4164
 
4211
4165
 
4212
4166
class cmd_help(Command):
4213
 
    __doc__ = """Show help on a command or other topic.
 
4167
    """Show help on a command or other topic.
4214
4168
    """
4215
4169
 
4216
4170
    _see_also = ['topics']
4229
4183
 
4230
4184
 
4231
4185
class cmd_shell_complete(Command):
4232
 
    __doc__ = """Show appropriate completions for context.
 
4186
    """Show appropriate completions for context.
4233
4187
 
4234
4188
    For a list of all available commands, say 'bzr shell-complete'.
4235
4189
    """
4244
4198
 
4245
4199
 
4246
4200
class cmd_missing(Command):
4247
 
    __doc__ = """Show unmerged/unpulled revisions between two branches.
 
4201
    """Show unmerged/unpulled revisions between two branches.
4248
4202
 
4249
4203
    OTHER_BRANCH may be local or remote.
4250
4204
 
4328
4282
            restrict = 'remote'
4329
4283
 
4330
4284
        local_branch = Branch.open_containing(u".")[0]
4331
 
        self.add_cleanup(local_branch.lock_read().unlock)
4332
 
 
4333
4285
        parent = local_branch.get_parent()
4334
4286
        if other_branch is None:
4335
4287
            other_branch = parent
4344
4296
        remote_branch = Branch.open(other_branch)
4345
4297
        if remote_branch.base == local_branch.base:
4346
4298
            remote_branch = local_branch
4347
 
        else:
4348
 
            self.add_cleanup(remote_branch.lock_read().unlock)
4349
4299
 
 
4300
        local_branch.lock_read()
 
4301
        self.add_cleanup(local_branch.unlock)
4350
4302
        local_revid_range = _revision_range_to_revid_range(
4351
4303
            _get_revision_range(my_revision, local_branch,
4352
4304
                self.name()))
4353
4305
 
 
4306
        remote_branch.lock_read()
 
4307
        self.add_cleanup(remote_branch.unlock)
4354
4308
        remote_revid_range = _revision_range_to_revid_range(
4355
4309
            _get_revision_range(revision,
4356
4310
                remote_branch, self.name()))
4406
4360
            message("Branches are up to date.\n")
4407
4361
        self.cleanup_now()
4408
4362
        if not status_code and parent is None and other_branch is not None:
4409
 
            self.add_cleanup(local_branch.lock_write().unlock)
 
4363
            local_branch.lock_write()
 
4364
            self.add_cleanup(local_branch.unlock)
4410
4365
            # handle race conditions - a parent might be set while we run.
4411
4366
            if local_branch.get_parent() is None:
4412
4367
                local_branch.set_parent(remote_branch.base)
4414
4369
 
4415
4370
 
4416
4371
class cmd_pack(Command):
4417
 
    __doc__ = """Compress the data within a repository.
4418
 
 
4419
 
    This operation compresses the data within a bazaar repository. As
4420
 
    bazaar supports automatic packing of repository, this operation is
4421
 
    normally not required to be done manually.
4422
 
 
4423
 
    During the pack operation, bazaar takes a backup of existing repository
4424
 
    data, i.e. pack files. This backup is eventually removed by bazaar
4425
 
    automatically when it is safe to do so. To save disk space by removing
4426
 
    the backed up pack files, the --clean-obsolete-packs option may be
4427
 
    used.
4428
 
 
4429
 
    Warning: If you use --clean-obsolete-packs and your machine crashes
4430
 
    during or immediately after repacking, you may be left with a state
4431
 
    where the deletion has been written to disk but the new packs have not
4432
 
    been. In this case the repository may be unusable.
4433
 
    """
 
4372
    """Compress the data within a repository."""
4434
4373
 
4435
4374
    _see_also = ['repositories']
4436
4375
    takes_args = ['branch_or_repo?']
4437
 
    takes_options = [
4438
 
        Option('clean-obsolete-packs', 'Delete obsolete packs to save disk space.'),
4439
 
        ]
4440
4376
 
4441
 
    def run(self, branch_or_repo='.', clean_obsolete_packs=False):
 
4377
    def run(self, branch_or_repo='.'):
4442
4378
        dir = bzrdir.BzrDir.open_containing(branch_or_repo)[0]
4443
4379
        try:
4444
4380
            branch = dir.open_branch()
4445
4381
            repository = branch.repository
4446
4382
        except errors.NotBranchError:
4447
4383
            repository = dir.open_repository()
4448
 
        repository.pack(clean_obsolete_packs=clean_obsolete_packs)
 
4384
        repository.pack()
4449
4385
 
4450
4386
 
4451
4387
class cmd_plugins(Command):
4452
 
    __doc__ = """List the installed plugins.
 
4388
    """List the installed plugins.
4453
4389
 
4454
4390
    This command displays the list of installed plugins including
4455
4391
    version of plugin and a short description of each.
4486
4422
                doc = '(no description)'
4487
4423
            result.append((name_ver, doc, plugin.path()))
4488
4424
        for name_ver, doc, path in sorted(result):
4489
 
            self.outf.write("%s\n" % name_ver)
4490
 
            self.outf.write("   %s\n" % doc)
 
4425
            print name_ver
 
4426
            print '   ', doc
4491
4427
            if verbose:
4492
 
                self.outf.write("   %s\n" % path)
4493
 
            self.outf.write("\n")
 
4428
                print '   ', path
 
4429
            print
4494
4430
 
4495
4431
 
4496
4432
class cmd_testament(Command):
4497
 
    __doc__ = """Show testament (signing-form) of a revision."""
 
4433
    """Show testament (signing-form) of a revision."""
4498
4434
    takes_options = [
4499
4435
            'revision',
4500
4436
            Option('long', help='Produce long-format testament.'),
4512
4448
            b = Branch.open_containing(branch)[0]
4513
4449
        else:
4514
4450
            b = Branch.open(branch)
4515
 
        self.add_cleanup(b.lock_read().unlock)
 
4451
        b.lock_read()
 
4452
        self.add_cleanup(b.unlock)
4516
4453
        if revision is None:
4517
4454
            rev_id = b.last_revision()
4518
4455
        else:
4525
4462
 
4526
4463
 
4527
4464
class cmd_annotate(Command):
4528
 
    __doc__ = """Show the origin of each line in a file.
 
4465
    """Show the origin of each line in a file.
4529
4466
 
4530
4467
    This prints out the given file with an annotation on the left side
4531
4468
    indicating which revision, author and date introduced the change.
4552
4489
        wt, branch, relpath = \
4553
4490
            bzrdir.BzrDir.open_containing_tree_or_branch(filename)
4554
4491
        if wt is not None:
4555
 
            self.add_cleanup(wt.lock_read().unlock)
 
4492
            wt.lock_read()
 
4493
            self.add_cleanup(wt.unlock)
4556
4494
        else:
4557
 
            self.add_cleanup(branch.lock_read().unlock)
 
4495
            branch.lock_read()
 
4496
            self.add_cleanup(branch.unlock)
4558
4497
        tree = _get_one_revision_tree('annotate', revision, branch=branch)
4559
 
        self.add_cleanup(tree.lock_read().unlock)
 
4498
        tree.lock_read()
 
4499
        self.add_cleanup(tree.unlock)
4560
4500
        if wt is not None:
4561
4501
            file_id = wt.path2id(relpath)
4562
4502
        else:
4575
4515
 
4576
4516
 
4577
4517
class cmd_re_sign(Command):
4578
 
    __doc__ = """Create a digital signature for an existing revision."""
 
4518
    """Create a digital signature for an existing revision."""
4579
4519
    # TODO be able to replace existing ones.
4580
4520
 
4581
4521
    hidden = True # is this right ?
4588
4528
        if revision_id_list is None and revision is None:
4589
4529
            raise errors.BzrCommandError('You must supply either --revision or a revision_id')
4590
4530
        b = WorkingTree.open_containing(u'.')[0].branch
4591
 
        self.add_cleanup(b.lock_write().unlock)
 
4531
        b.lock_write()
 
4532
        self.add_cleanup(b.unlock)
4592
4533
        return self._run(b, revision_id_list, revision)
4593
4534
 
4594
4535
    def _run(self, b, revision_id_list, revision):
4640
4581
 
4641
4582
 
4642
4583
class cmd_bind(Command):
4643
 
    __doc__ = """Convert the current branch into a checkout of the supplied branch.
4644
 
    If no branch is supplied, rebind to the last bound location.
 
4584
    """Convert the current branch into a checkout of the supplied branch.
4645
4585
 
4646
4586
    Once converted into a checkout, commits must succeed on the master branch
4647
4587
    before they will be applied to the local branch.
4681
4621
 
4682
4622
 
4683
4623
class cmd_unbind(Command):
4684
 
    __doc__ = """Convert the current checkout into a regular branch.
 
4624
    """Convert the current checkout into a regular branch.
4685
4625
 
4686
4626
    After unbinding, the local branch is considered independent and subsequent
4687
4627
    commits will be local only.
4698
4638
 
4699
4639
 
4700
4640
class cmd_uncommit(Command):
4701
 
    __doc__ = """Remove the last committed revision.
 
4641
    """Remove the last committed revision.
4702
4642
 
4703
4643
    --verbose will print out what is being removed.
4704
4644
    --dry-run will go through all the motions, but not actually
4744
4684
            b = control.open_branch()
4745
4685
 
4746
4686
        if tree is not None:
4747
 
            self.add_cleanup(tree.lock_write().unlock)
 
4687
            tree.lock_write()
 
4688
            self.add_cleanup(tree.unlock)
4748
4689
        else:
4749
 
            self.add_cleanup(b.lock_write().unlock)
 
4690
            b.lock_write()
 
4691
            self.add_cleanup(b.unlock)
4750
4692
        return self._run(b, tree, dry_run, verbose, revision, force, local=local)
4751
4693
 
4752
4694
    def _run(self, b, tree, dry_run, verbose, revision, force, local=False):
4770
4712
                rev_id = b.get_rev_id(revno)
4771
4713
 
4772
4714
        if rev_id is None or _mod_revision.is_null(rev_id):
4773
 
            self.outf.write('No revisions to uncommit.\n')
 
4715
            ui.ui_factory.note('No revisions to uncommit.')
4774
4716
            return 1
4775
4717
 
 
4718
        log_collector = ui.ui_factory.make_output_stream()
4776
4719
        lf = log_formatter('short',
4777
 
                           to_file=self.outf,
 
4720
                           to_file=log_collector,
4778
4721
                           show_timezone='original')
4779
4722
 
4780
4723
        show_log(b,
4785
4728
                 end_revision=last_revno)
4786
4729
 
4787
4730
        if dry_run:
4788
 
            self.outf.write('Dry-run, pretending to remove'
4789
 
                            ' the above revisions.\n')
 
4731
            ui.ui_factory.note('Dry-run, pretending to remove the above revisions.')
4790
4732
        else:
4791
 
            self.outf.write('The above revision(s) will be removed.\n')
 
4733
            ui.ui_factory.note('The above revision(s) will be removed.')
4792
4734
 
4793
4735
        if not force:
4794
 
            if not ui.ui_factory.get_boolean('Are you sure'):
4795
 
                self.outf.write('Canceled')
 
4736
            if not ui.ui_factory.get_boolean('Are you sure [y/N]? '):
 
4737
                ui.ui_factory.note('Canceled')
4796
4738
                return 0
4797
4739
 
4798
4740
        mutter('Uncommitting from {%s} to {%s}',
4799
4741
               last_rev_id, rev_id)
4800
4742
        uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
4801
4743
                 revno=revno, local=local)
4802
 
        self.outf.write('You can restore the old tip by running:\n'
4803
 
             '  bzr pull . -r revid:%s\n' % last_rev_id)
 
4744
        ui.ui_factory.note('You can restore the old tip by running:\n'
 
4745
             '  bzr pull . -r revid:%s' % last_rev_id)
4804
4746
 
4805
4747
 
4806
4748
class cmd_break_lock(Command):
4807
 
    __doc__ = """Break a dead lock on a repository, branch or working directory.
 
4749
    """Break a dead lock on a repository, branch or working directory.
4808
4750
 
4809
4751
    CAUTION: Locks should only be broken when you are sure that the process
4810
4752
    holding the lock has been stopped.
4829
4771
 
4830
4772
 
4831
4773
class cmd_wait_until_signalled(Command):
4832
 
    __doc__ = """Test helper for test_start_and_stop_bzr_subprocess_send_signal.
 
4774
    """Test helper for test_start_and_stop_bzr_subprocess_send_signal.
4833
4775
 
4834
4776
    This just prints a line to signal when it is ready, then blocks on stdin.
4835
4777
    """
4843
4785
 
4844
4786
 
4845
4787
class cmd_serve(Command):
4846
 
    __doc__ = """Run the bzr server."""
 
4788
    """Run the bzr server."""
4847
4789
 
4848
4790
    aliases = ['server']
4849
4791
 
4909
4851
 
4910
4852
 
4911
4853
class cmd_join(Command):
4912
 
    __doc__ = """Combine a tree into its containing tree.
 
4854
    """Combine a tree into its containing tree.
4913
4855
 
4914
4856
    This command requires the target tree to be in a rich-root format.
4915
4857
 
4955
4897
 
4956
4898
 
4957
4899
class cmd_split(Command):
4958
 
    __doc__ = """Split a subdirectory of a tree into a separate tree.
 
4900
    """Split a subdirectory of a tree into a separate tree.
4959
4901
 
4960
4902
    This command will produce a target tree in a format that supports
4961
4903
    rich roots, like 'rich-root' or 'rich-root-pack'.  These formats cannot be
4981
4923
 
4982
4924
 
4983
4925
class cmd_merge_directive(Command):
4984
 
    __doc__ = """Generate a merge directive for auto-merge tools.
 
4926
    """Generate a merge directive for auto-merge tools.
4985
4927
 
4986
4928
    A directive requests a merge to be performed, and also provides all the
4987
4929
    information necessary to do so.  This means it must either include a
5080
5022
 
5081
5023
 
5082
5024
class cmd_send(Command):
5083
 
    __doc__ = """Mail or create a merge-directive for submitting changes.
 
5025
    """Mail or create a merge-directive for submitting changes.
5084
5026
 
5085
5027
    A merge directive provides many things needed for requesting merges:
5086
5028
 
5168
5110
               short_name='f',
5169
5111
               type=unicode),
5170
5112
        Option('output', short_name='o',
5171
 
               help='Write merge directive to this file or directory; '
 
5113
               help='Write merge directive to this file; '
5172
5114
                    'use - for stdout.',
5173
5115
               type=unicode),
5174
5116
        Option('strict',
5197
5139
 
5198
5140
 
5199
5141
class cmd_bundle_revisions(cmd_send):
5200
 
    __doc__ = """Create a merge-directive for submitting changes.
 
5142
    """Create a merge-directive for submitting changes.
5201
5143
 
5202
5144
    A merge directive provides many things needed for requesting merges:
5203
5145
 
5270
5212
 
5271
5213
 
5272
5214
class cmd_tag(Command):
5273
 
    __doc__ = """Create, remove or modify a tag naming a revision.
 
5215
    """Create, remove or modify a tag naming a revision.
5274
5216
 
5275
5217
    Tags give human-meaningful names to revisions.  Commands that take a -r
5276
5218
    (--revision) option can be given -rtag:X, where X is any previously
5284
5226
 
5285
5227
    To rename a tag (change the name but keep it on the same revsion), run ``bzr
5286
5228
    tag new-name -r tag:old-name`` and then ``bzr tag --delete oldname``.
5287
 
 
5288
 
    If no tag name is specified it will be determined through the 
5289
 
    'automatic_tag_name' hook. This can e.g. be used to automatically tag
5290
 
    upstream releases by reading configure.ac. See ``bzr help hooks`` for
5291
 
    details.
5292
5229
    """
5293
5230
 
5294
5231
    _see_also = ['commit', 'tags']
5295
 
    takes_args = ['tag_name?']
 
5232
    takes_args = ['tag_name']
5296
5233
    takes_options = [
5297
5234
        Option('delete',
5298
5235
            help='Delete this tag rather than placing it.',
5308
5245
        'revision',
5309
5246
        ]
5310
5247
 
5311
 
    def run(self, tag_name=None,
 
5248
    def run(self, tag_name,
5312
5249
            delete=None,
5313
5250
            directory='.',
5314
5251
            force=None,
5315
5252
            revision=None,
5316
5253
            ):
5317
5254
        branch, relpath = Branch.open_containing(directory)
5318
 
        self.add_cleanup(branch.lock_write().unlock)
 
5255
        branch.lock_write()
 
5256
        self.add_cleanup(branch.unlock)
5319
5257
        if delete:
5320
 
            if tag_name is None:
5321
 
                raise errors.BzrCommandError("No tag specified to delete.")
5322
5258
            branch.tags.delete_tag(tag_name)
5323
5259
            self.outf.write('Deleted tag %s.\n' % tag_name)
5324
5260
        else:
5330
5266
                revision_id = revision[0].as_revision_id(branch)
5331
5267
            else:
5332
5268
                revision_id = branch.last_revision()
5333
 
            if tag_name is None:
5334
 
                tag_name = branch.automatic_tag_name(revision_id)
5335
 
                if tag_name is None:
5336
 
                    raise errors.BzrCommandError(
5337
 
                        "Please specify a tag name.")
5338
5269
            if (not force) and branch.tags.has_tag(tag_name):
5339
5270
                raise errors.TagAlreadyExists(tag_name)
5340
5271
            branch.tags.set_tag(tag_name, revision_id)
5342
5273
 
5343
5274
 
5344
5275
class cmd_tags(Command):
5345
 
    __doc__ = """List tags.
 
5276
    """List tags.
5346
5277
 
5347
5278
    This command shows a table of tag names and the revisions they reference.
5348
5279
    """
5376
5307
        if not tags:
5377
5308
            return
5378
5309
 
5379
 
        self.add_cleanup(branch.lock_read().unlock)
 
5310
        branch.lock_read()
 
5311
        self.add_cleanup(branch.unlock)
5380
5312
        if revision:
5381
5313
            graph = branch.repository.get_graph()
5382
5314
            rev1, rev2 = _get_revision_range(revision, branch, self.name())
5415
5347
 
5416
5348
 
5417
5349
class cmd_reconfigure(Command):
5418
 
    __doc__ = """Reconfigure the type of a bzr directory.
 
5350
    """Reconfigure the type of a bzr directory.
5419
5351
 
5420
5352
    A target configuration must be specified.
5421
5353
 
5506
5438
 
5507
5439
 
5508
5440
class cmd_switch(Command):
5509
 
    __doc__ = """Set the branch of a checkout and update.
 
5441
    """Set the branch of a checkout and update.
5510
5442
 
5511
5443
    For lightweight checkouts, this changes the branch being referenced.
5512
5444
    For heavyweight checkouts, this checks that there are no local commits
5602
5534
 
5603
5535
 
5604
5536
class cmd_view(Command):
5605
 
    __doc__ = """Manage filtered views.
 
5537
    """Manage filtered views.
5606
5538
 
5607
5539
    Views provide a mask over the tree so that users can focus on
5608
5540
    a subset of a tree when doing their work. After creating a view,
5756
5688
 
5757
5689
 
5758
5690
class cmd_hooks(Command):
5759
 
    __doc__ = """Show hooks."""
 
5691
    """Show hooks."""
5760
5692
 
5761
5693
    hidden = True
5762
5694
 
5775
5707
                    self.outf.write("    <no hooks installed>\n")
5776
5708
 
5777
5709
 
5778
 
class cmd_remove_branch(Command):
5779
 
    __doc__ = """Remove a branch.
5780
 
 
5781
 
    This will remove the branch from the specified location but 
5782
 
    will keep any working tree or repository in place.
5783
 
 
5784
 
    :Examples:
5785
 
 
5786
 
      Remove the branch at repo/trunk::
5787
 
 
5788
 
        bzr remove-branch repo/trunk
5789
 
 
5790
 
    """
5791
 
 
5792
 
    takes_args = ["location?"]
5793
 
 
5794
 
    aliases = ["rmbranch"]
5795
 
 
5796
 
    def run(self, location=None):
5797
 
        if location is None:
5798
 
            location = "."
5799
 
        branch = Branch.open_containing(location)[0]
5800
 
        branch.bzrdir.destroy_branch()
5801
 
        
5802
 
 
5803
5710
class cmd_shelve(Command):
5804
 
    __doc__ = """Temporarily set aside some changes from the current tree.
 
5711
    """Temporarily set aside some changes from the current tree.
5805
5712
 
5806
5713
    Shelve allows you to temporarily put changes you've made "on the shelf",
5807
5714
    ie. out of the way, until a later time when you can bring them back from
5860
5767
 
5861
5768
    def run_for_list(self):
5862
5769
        tree = WorkingTree.open_containing('.')[0]
5863
 
        self.add_cleanup(tree.lock_read().unlock)
 
5770
        tree.lock_read()
 
5771
        self.add_cleanup(tree.unlock)
5864
5772
        manager = tree.get_shelf_manager()
5865
5773
        shelves = manager.active_shelves()
5866
5774
        if len(shelves) == 0:
5875
5783
 
5876
5784
 
5877
5785
class cmd_unshelve(Command):
5878
 
    __doc__ = """Restore shelved changes.
 
5786
    """Restore shelved changes.
5879
5787
 
5880
5788
    By default, the most recently shelved changes are restored. However if you
5881
5789
    specify a shelf by id those changes will be restored instead.  This works
5907
5815
 
5908
5816
 
5909
5817
class cmd_clean_tree(Command):
5910
 
    __doc__ = """Remove unwanted files from working tree.
 
5818
    """Remove unwanted files from working tree.
5911
5819
 
5912
5820
    By default, only unknown files, not ignored files, are deleted.  Versioned
5913
5821
    files are never deleted.
5941
5849
 
5942
5850
 
5943
5851
class cmd_reference(Command):
5944
 
    __doc__ = """list, view and set branch locations for nested trees.
 
5852
    """list, view and set branch locations for nested trees.
5945
5853
 
5946
5854
    If no arguments are provided, lists the branch locations for nested trees.
5947
5855
    If one argument is provided, display the branch location for that tree.
5987
5895
            self.outf.write('%s %s\n' % (path, location))
5988
5896
 
5989
5897
 
5990
 
def _register_lazy_builtins():
5991
 
    # register lazy builtins from other modules; called at startup and should
5992
 
    # be only called once.
5993
 
    for (name, aliases, module_name) in [
5994
 
        ('cmd_bundle_info', [], 'bzrlib.bundle.commands'),
5995
 
        ('cmd_dpush', [], 'bzrlib.foreign'),
5996
 
        ('cmd_version_info', [], 'bzrlib.cmd_version_info'),
5997
 
        ('cmd_resolve', ['resolved'], 'bzrlib.conflicts'),
5998
 
        ('cmd_conflicts', [], 'bzrlib.conflicts'),
5999
 
        ('cmd_sign_my_commits', [], 'bzrlib.sign_my_commits'),
6000
 
        ]:
6001
 
        builtin_command_registry.register_lazy(name, aliases, module_name)
 
5898
# these get imported and then picked up by the scan for cmd_*
 
5899
# TODO: Some more consistent way to split command definitions across files;
 
5900
# we do need to load at least some information about them to know of
 
5901
# aliases.  ideally we would avoid loading the implementation until the
 
5902
# details were needed.
 
5903
from bzrlib.cmd_version_info import cmd_version_info
 
5904
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore
 
5905
from bzrlib.bundle.commands import (
 
5906
    cmd_bundle_info,
 
5907
    )
 
5908
from bzrlib.foreign import cmd_dpush
 
5909
from bzrlib.sign_my_commits import cmd_sign_my_commits
 
5910
from bzrlib.weave_commands import cmd_versionedfile_list, \
 
5911
        cmd_weave_plan_merge, cmd_weave_merge_text