~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/builtins.py

  • Committer: Robert Collins
  • Date: 2010-05-06 07:48:22 UTC
  • mto: This revision was merged to the branch mainline in revision 5223.
  • Revision ID: robertc@robertcollins.net-20100506074822-0bsgf2j4h8jx0xkk
Added ``bzrlib.tests.matchers`` as a place to put matchers, along with
our first in-tree matcher. See the module docstring for details.
(Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005-2011 Canonical Ltd
 
1
# Copyright (C) 2005-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
20
20
 
21
21
from bzrlib.lazy_import import lazy_import
22
22
lazy_import(globals(), """
 
23
import codecs
23
24
import cStringIO
24
25
import sys
25
26
import time
32
33
    bzrdir,
33
34
    directory_service,
34
35
    delta,
35
 
    config as _mod_config,
 
36
    config,
36
37
    errors,
37
38
    globbing,
38
39
    hooks,
74
75
from bzrlib.trace import mutter, note, warning, is_quiet, get_verbosity_level
75
76
 
76
77
 
77
 
@symbol_versioning.deprecated_function(symbol_versioning.deprecated_in((2, 3, 0)))
78
78
def tree_files(file_list, default_branch=u'.', canonicalize=True,
79
79
    apply_view=True):
80
 
    return internal_tree_files(file_list, default_branch, canonicalize,
81
 
        apply_view)
 
80
    try:
 
81
        return internal_tree_files(file_list, default_branch, canonicalize,
 
82
            apply_view)
 
83
    except errors.FileInWrongBranch, e:
 
84
        raise errors.BzrCommandError("%s is not in the same branch as %s" %
 
85
                                     (e.path, file_list[0]))
82
86
 
83
87
 
84
88
def tree_files_for_add(file_list):
148
152
 
149
153
# XXX: Bad function name; should possibly also be a class method of
150
154
# WorkingTree rather than a function.
151
 
@symbol_versioning.deprecated_function(symbol_versioning.deprecated_in((2, 3, 0)))
152
155
def internal_tree_files(file_list, default_branch=u'.', canonicalize=True,
153
156
    apply_view=True):
154
157
    """Convert command-line paths to a WorkingTree and relative paths.
155
158
 
156
 
    Deprecated: use WorkingTree.open_containing_paths instead.
157
 
 
158
159
    This is typically used for command-line processors that take one or
159
160
    more filenames, and infer the workingtree that contains them.
160
161
 
170
171
 
171
172
    :return: workingtree, [relative_paths]
172
173
    """
173
 
    return WorkingTree.open_containing_paths(
174
 
        file_list, default_directory='.',
175
 
        canonicalize=True,
176
 
        apply_view=True)
 
174
    if file_list is None or len(file_list) == 0:
 
175
        tree = WorkingTree.open_containing(default_branch)[0]
 
176
        if tree.supports_views() and apply_view:
 
177
            view_files = tree.views.lookup_view()
 
178
            if view_files:
 
179
                file_list = view_files
 
180
                view_str = views.view_display_str(view_files)
 
181
                note("Ignoring files outside view. View is %s" % view_str)
 
182
        return tree, file_list
 
183
    tree = WorkingTree.open_containing(osutils.realpath(file_list[0]))[0]
 
184
    return tree, safe_relpath_files(tree, file_list, canonicalize,
 
185
        apply_view=apply_view)
 
186
 
 
187
 
 
188
def safe_relpath_files(tree, file_list, canonicalize=True, apply_view=True):
 
189
    """Convert file_list into a list of relpaths in tree.
 
190
 
 
191
    :param tree: A tree to operate on.
 
192
    :param file_list: A list of user provided paths or None.
 
193
    :param apply_view: if True and a view is set, apply it or check that
 
194
        specified files are within it
 
195
    :return: A list of relative paths.
 
196
    :raises errors.PathNotChild: When a provided path is in a different tree
 
197
        than tree.
 
198
    """
 
199
    if file_list is None:
 
200
        return None
 
201
    if tree.supports_views() and apply_view:
 
202
        view_files = tree.views.lookup_view()
 
203
    else:
 
204
        view_files = []
 
205
    new_list = []
 
206
    # tree.relpath exists as a "thunk" to osutils, but canonical_relpath
 
207
    # doesn't - fix that up here before we enter the loop.
 
208
    if canonicalize:
 
209
        fixer = lambda p: osutils.canonical_relpath(tree.basedir, p)
 
210
    else:
 
211
        fixer = tree.relpath
 
212
    for filename in file_list:
 
213
        try:
 
214
            relpath = fixer(osutils.dereference_path(filename))
 
215
            if  view_files and not osutils.is_inside_any(view_files, relpath):
 
216
                raise errors.FileOutsideView(filename, view_files)
 
217
            new_list.append(relpath)
 
218
        except errors.PathNotChild:
 
219
            raise errors.FileInWrongBranch(tree.branch, filename)
 
220
    return new_list
177
221
 
178
222
 
179
223
def _get_view_info_for_change_reporter(tree):
188
232
    return view_info
189
233
 
190
234
 
191
 
def _open_directory_or_containing_tree_or_branch(filename, directory):
192
 
    """Open the tree or branch containing the specified file, unless
193
 
    the --directory option is used to specify a different branch."""
194
 
    if directory is not None:
195
 
        return (None, Branch.open(directory), filename)
196
 
    return bzrdir.BzrDir.open_containing_tree_or_branch(filename)
197
 
 
198
 
 
199
235
# TODO: Make sure no commands unconditionally use the working directory as a
200
236
# branch.  If a filename argument is used, the first of them should be used to
201
237
# specify the branch.  (Perhaps this can be factored out into some kind of
250
286
    To skip the display of pending merge information altogether, use
251
287
    the no-pending option or specify a file/directory.
252
288
 
253
 
    To compare the working directory to a specific revision, pass a
254
 
    single revision to the revision argument.
255
 
 
256
 
    To see which files have changed in a specific revision, or between
257
 
    two revisions, pass a revision range to the revision argument.
258
 
    This will produce the same results as calling 'bzr diff --summarize'.
 
289
    If a revision argument is given, the status is calculated against
 
290
    that revision, or between two revisions if two are provided.
259
291
    """
260
292
 
261
293
    # TODO: --no-recurse, --recurse options
283
315
            raise errors.BzrCommandError('bzr status --revision takes exactly'
284
316
                                         ' one or two revision specifiers')
285
317
 
286
 
        tree, relfile_list = WorkingTree.open_containing_paths(file_list)
 
318
        tree, relfile_list = tree_files(file_list)
287
319
        # Avoid asking for specific files when that is not needed.
288
320
        if relfile_list == ['']:
289
321
            relfile_list = None
308
340
 
309
341
    hidden = True
310
342
    takes_args = ['revision_id?']
311
 
    takes_options = ['directory', 'revision']
 
343
    takes_options = ['revision']
312
344
    # cat-revision is more for frontends so should be exact
313
345
    encoding = 'strict'
314
346
 
321
353
        self.outf.write(revtext.decode('utf-8'))
322
354
 
323
355
    @display_command
324
 
    def run(self, revision_id=None, revision=None, directory=u'.'):
 
356
    def run(self, revision_id=None, revision=None):
325
357
        if revision_id is not None and revision is not None:
326
358
            raise errors.BzrCommandError('You can only supply one of'
327
359
                                         ' revision_id or --revision')
328
360
        if revision_id is None and revision is None:
329
361
            raise errors.BzrCommandError('You must supply either'
330
362
                                         ' --revision or a revision_id')
331
 
 
332
 
        b = bzrdir.BzrDir.open_containing_tree_or_branch(directory)[1]
 
363
        b = WorkingTree.open_containing(u'.')[0].branch
333
364
 
334
365
        revisions = b.repository.revisions
335
366
        if revisions is None:
413
444
                self.outf.write(page_bytes[:header_end])
414
445
                page_bytes = data
415
446
            self.outf.write('\nPage %d\n' % (page_idx,))
416
 
            if len(page_bytes) == 0:
417
 
                self.outf.write('(empty)\n');
418
 
            else:
419
 
                decomp_bytes = zlib.decompress(page_bytes)
420
 
                self.outf.write(decomp_bytes)
421
 
                self.outf.write('\n')
 
447
            decomp_bytes = zlib.decompress(page_bytes)
 
448
            self.outf.write(decomp_bytes)
 
449
            self.outf.write('\n')
422
450
 
423
451
    def _dump_entries(self, trans, basename):
424
452
        try:
455
483
    takes_options = [
456
484
        Option('force',
457
485
               help='Remove the working tree even if it has '
458
 
                    'uncommitted or shelved changes.'),
 
486
                    'uncommitted changes.'),
459
487
        ]
460
488
 
461
489
    def run(self, location_list, force=False):
475
503
            if not force:
476
504
                if (working.has_changes()):
477
505
                    raise errors.UncommittedChanges(working)
478
 
                if working.get_shelf_manager().last_shelf() is not None:
479
 
                    raise errors.ShelvedChanges(working)
480
506
 
481
507
            if working.user_url != working.branch.user_url:
482
508
                raise errors.BzrCommandError("You cannot remove the working tree"
485
511
            d.destroy_workingtree()
486
512
 
487
513
 
488
 
class cmd_repair_workingtree(Command):
489
 
    __doc__ = """Reset the working tree state file.
490
 
 
491
 
    This is not meant to be used normally, but more as a way to recover from
492
 
    filesystem corruption, etc. This rebuilds the working inventory back to a
493
 
    'known good' state. Any new modifications (adding a file, renaming, etc)
494
 
    will be lost, though modified files will still be detected as such.
495
 
 
496
 
    Most users will want something more like "bzr revert" or "bzr update"
497
 
    unless the state file has become corrupted.
498
 
 
499
 
    By default this attempts to recover the current state by looking at the
500
 
    headers of the state file. If the state file is too corrupted to even do
501
 
    that, you can supply --revision to force the state of the tree.
502
 
    """
503
 
 
504
 
    takes_options = ['revision', 'directory',
505
 
        Option('force',
506
 
               help='Reset the tree even if it doesn\'t appear to be'
507
 
                    ' corrupted.'),
508
 
    ]
509
 
    hidden = True
510
 
 
511
 
    def run(self, revision=None, directory='.', force=False):
512
 
        tree, _ = WorkingTree.open_containing(directory)
513
 
        self.add_cleanup(tree.lock_tree_write().unlock)
514
 
        if not force:
515
 
            try:
516
 
                tree.check_state()
517
 
            except errors.BzrError:
518
 
                pass # There seems to be a real error here, so we'll reset
519
 
            else:
520
 
                # Refuse
521
 
                raise errors.BzrCommandError(
522
 
                    'The tree does not appear to be corrupt. You probably'
523
 
                    ' want "bzr revert" instead. Use "--force" if you are'
524
 
                    ' sure you want to reset the working tree.')
525
 
        if revision is None:
526
 
            revision_ids = None
527
 
        else:
528
 
            revision_ids = [r.as_revision_id(tree.branch) for r in revision]
529
 
        try:
530
 
            tree.reset_state(revision_ids)
531
 
        except errors.BzrError, e:
532
 
            if revision_ids is None:
533
 
                extra = (', the header appears corrupt, try passing -r -1'
534
 
                         ' to set the state to the last commit')
535
 
            else:
536
 
                extra = ''
537
 
            raise errors.BzrCommandError('failed to reset the tree state'
538
 
                                         + extra)
539
 
 
540
 
 
541
514
class cmd_revno(Command):
542
515
    __doc__ = """Show current revision number.
543
516
 
555
528
        if tree:
556
529
            try:
557
530
                wt = WorkingTree.open_containing(location)[0]
558
 
                self.add_cleanup(wt.lock_read().unlock)
 
531
                wt.lock_read()
559
532
            except (errors.NoWorkingTree, errors.NotLocalUrl):
560
533
                raise errors.NoWorkingTree(location)
 
534
            self.add_cleanup(wt.unlock)
561
535
            revid = wt.last_revision()
562
536
            try:
563
537
                revno_t = wt.branch.revision_id_to_dotted_revno(revid)
566
540
            revno = ".".join(str(n) for n in revno_t)
567
541
        else:
568
542
            b = Branch.open_containing(location)[0]
569
 
            self.add_cleanup(b.lock_read().unlock)
 
543
            b.lock_read()
 
544
            self.add_cleanup(b.unlock)
570
545
            revno = b.revno()
571
546
        self.cleanup_now()
572
547
        self.outf.write(str(revno) + '\n')
579
554
    takes_args = ['revision_info*']
580
555
    takes_options = [
581
556
        'revision',
582
 
        custom_help('directory',
 
557
        Option('directory',
583
558
            help='Branch to examine, '
584
 
                 'rather than the one containing the working directory.'),
 
559
                 'rather than the one containing the working directory.',
 
560
            short_name='d',
 
561
            type=unicode,
 
562
            ),
585
563
        Option('tree', help='Show revno of working tree'),
586
564
        ]
587
565
 
592
570
        try:
593
571
            wt = WorkingTree.open_containing(directory)[0]
594
572
            b = wt.branch
595
 
            self.add_cleanup(wt.lock_read().unlock)
 
573
            wt.lock_read()
 
574
            self.add_cleanup(wt.unlock)
596
575
        except (errors.NoWorkingTree, errors.NotLocalUrl):
597
576
            wt = None
598
577
            b = Branch.open_containing(directory)[0]
599
 
            self.add_cleanup(b.lock_read().unlock)
 
578
            b.lock_read()
 
579
            self.add_cleanup(b.unlock)
600
580
        revision_ids = []
601
581
        if revision is not None:
602
582
            revision_ids.extend(rev.as_revision_id(b) for rev in revision)
701
681
                should_print=(not is_quiet()))
702
682
 
703
683
        if base_tree:
704
 
            self.add_cleanup(base_tree.lock_read().unlock)
 
684
            base_tree.lock_read()
 
685
            self.add_cleanup(base_tree.unlock)
705
686
        tree, file_list = tree_files_for_add(file_list)
706
687
        added, ignored = tree.smart_add(file_list, not
707
688
            no_recurse, action=action, save=not dry_run)
778
759
            raise errors.BzrCommandError('invalid kind %r specified' % (kind,))
779
760
 
780
761
        revision = _get_one_revision('inventory', revision)
781
 
        work_tree, file_list = WorkingTree.open_containing_paths(file_list)
782
 
        self.add_cleanup(work_tree.lock_read().unlock)
 
762
        work_tree, file_list = tree_files(file_list)
 
763
        work_tree.lock_read()
 
764
        self.add_cleanup(work_tree.unlock)
783
765
        if revision is not None:
784
766
            tree = revision.as_tree(work_tree.branch)
785
767
 
786
768
            extra_trees = [work_tree]
787
 
            self.add_cleanup(tree.lock_read().unlock)
 
769
            tree.lock_read()
 
770
            self.add_cleanup(tree.unlock)
788
771
        else:
789
772
            tree = work_tree
790
773
            extra_trees = []
849
832
            names_list = []
850
833
        if len(names_list) < 2:
851
834
            raise errors.BzrCommandError("missing file argument")
852
 
        tree, rel_names = WorkingTree.open_containing_paths(names_list, canonicalize=False)
853
 
        self.add_cleanup(tree.lock_tree_write().unlock)
 
835
        tree, rel_names = tree_files(names_list, canonicalize=False)
 
836
        tree.lock_tree_write()
 
837
        self.add_cleanup(tree.unlock)
854
838
        self._run(tree, names_list, rel_names, after)
855
839
 
856
840
    def run_auto(self, names_list, after, dry_run):
860
844
        if after:
861
845
            raise errors.BzrCommandError('--after cannot be specified with'
862
846
                                         ' --auto.')
863
 
        work_tree, file_list = WorkingTree.open_containing_paths(
864
 
            names_list, default_directory='.')
865
 
        self.add_cleanup(work_tree.lock_tree_write().unlock)
 
847
        work_tree, file_list = tree_files(names_list, default_branch='.')
 
848
        work_tree.lock_tree_write()
 
849
        self.add_cleanup(work_tree.unlock)
866
850
        rename_map.RenameMap.guess_renames(work_tree, dry_run)
867
851
 
868
852
    def _run(self, tree, names_list, rel_names, after):
976
960
    takes_options = ['remember', 'overwrite', 'revision',
977
961
        custom_help('verbose',
978
962
            help='Show logs of pulled revisions.'),
979
 
        custom_help('directory',
 
963
        Option('directory',
980
964
            help='Branch to pull into, '
981
 
                 'rather than the one containing the working directory.'),
 
965
                 'rather than the one containing the working directory.',
 
966
            short_name='d',
 
967
            type=unicode,
 
968
            ),
982
969
        Option('local',
983
970
            help="Perform a local pull in a bound "
984
971
                 "branch.  Local pulls are not applied to "
985
972
                 "the master branch."
986
973
            ),
987
 
        Option('show-base',
988
 
            help="Show base revision text in conflicts.")
989
974
        ]
990
975
    takes_args = ['location?']
991
976
    encoding_type = 'replace'
992
977
 
993
978
    def run(self, location=None, remember=False, overwrite=False,
994
979
            revision=None, verbose=False,
995
 
            directory=None, local=False,
996
 
            show_base=False):
 
980
            directory=None, local=False):
997
981
        # FIXME: too much stuff is in the command class
998
982
        revision_id = None
999
983
        mergeable = None
1002
986
        try:
1003
987
            tree_to = WorkingTree.open_containing(directory)[0]
1004
988
            branch_to = tree_to.branch
1005
 
            self.add_cleanup(tree_to.lock_write().unlock)
 
989
            tree_to.lock_write()
 
990
            self.add_cleanup(tree_to.unlock)
1006
991
        except errors.NoWorkingTree:
1007
992
            tree_to = None
1008
993
            branch_to = Branch.open_containing(directory)[0]
1009
 
            self.add_cleanup(branch_to.lock_write().unlock)
1010
 
 
1011
 
        if tree_to is None and show_base:
1012
 
            raise errors.BzrCommandError("Need working tree for --show-base.")
 
994
            branch_to.lock_write()
 
995
            self.add_cleanup(branch_to.unlock)
1013
996
 
1014
997
        if local and not branch_to.get_bound_location():
1015
998
            raise errors.LocalRequiresBoundBranch()
1046
1029
        else:
1047
1030
            branch_from = Branch.open(location,
1048
1031
                possible_transports=possible_transports)
1049
 
            self.add_cleanup(branch_from.lock_read().unlock)
 
1032
            branch_from.lock_read()
 
1033
            self.add_cleanup(branch_from.unlock)
1050
1034
 
1051
1035
            if branch_to.get_parent() is None or remember:
1052
1036
                branch_to.set_parent(branch_from.base)
1061
1045
                view_info=view_info)
1062
1046
            result = tree_to.pull(
1063
1047
                branch_from, overwrite, revision_id, change_reporter,
1064
 
                possible_transports=possible_transports, local=local,
1065
 
                show_base=show_base)
 
1048
                possible_transports=possible_transports, local=local)
1066
1049
        else:
1067
1050
            result = branch_to.pull(
1068
1051
                branch_from, overwrite, revision_id, local=local)
1072
1055
            log.show_branch_change(
1073
1056
                branch_to, self.outf, result.old_revno,
1074
1057
                result.old_revid)
1075
 
        if getattr(result, 'tag_conflicts', None):
1076
 
            return 1
1077
 
        else:
1078
 
            return 0
1079
1058
 
1080
1059
 
1081
1060
class cmd_push(Command):
1109
1088
        Option('create-prefix',
1110
1089
               help='Create the path leading up to the branch '
1111
1090
                    'if it does not already exist.'),
1112
 
        custom_help('directory',
 
1091
        Option('directory',
1113
1092
            help='Branch to push from, '
1114
 
                 'rather than the one containing the working directory.'),
 
1093
                 'rather than the one containing the working directory.',
 
1094
            short_name='d',
 
1095
            type=unicode,
 
1096
            ),
1115
1097
        Option('use-existing-dir',
1116
1098
               help='By default push will fail if the target'
1117
1099
                    ' directory exists, but does not already'
1128
1110
        Option('strict',
1129
1111
               help='Refuse to push if there are uncommitted changes in'
1130
1112
               ' the working tree, --no-strict disables the check.'),
1131
 
        Option('no-tree',
1132
 
               help="Don't populate the working tree, even for protocols"
1133
 
               " that support it."),
1134
1113
        ]
1135
1114
    takes_args = ['location?']
1136
1115
    encoding_type = 'replace'
1138
1117
    def run(self, location=None, remember=False, overwrite=False,
1139
1118
        create_prefix=False, verbose=False, revision=None,
1140
1119
        use_existing_dir=False, directory=None, stacked_on=None,
1141
 
        stacked=False, strict=None, no_tree=False):
 
1120
        stacked=False, strict=None):
1142
1121
        from bzrlib.push import _show_push_branch
1143
1122
 
1144
1123
        if directory is None:
1190
1169
        _show_push_branch(br_from, revision_id, location, self.outf,
1191
1170
            verbose=verbose, overwrite=overwrite, remember=remember,
1192
1171
            stacked_on=stacked_on, create_prefix=create_prefix,
1193
 
            use_existing_dir=use_existing_dir, no_tree=no_tree)
 
1172
            use_existing_dir=use_existing_dir)
1194
1173
 
1195
1174
 
1196
1175
class cmd_branch(Command):
1209
1188
 
1210
1189
    _see_also = ['checkout']
1211
1190
    takes_args = ['from_location', 'to_location?']
1212
 
    takes_options = ['revision',
1213
 
        Option('hardlink', help='Hard-link working tree files where possible.'),
1214
 
        Option('files-from', type=str,
1215
 
               help="Get file contents from this tree."),
 
1191
    takes_options = ['revision', Option('hardlink',
 
1192
        help='Hard-link working tree files where possible.'),
1216
1193
        Option('no-tree',
1217
1194
            help="Create a branch without a working-tree."),
1218
1195
        Option('switch',
1236
1213
 
1237
1214
    def run(self, from_location, to_location=None, revision=None,
1238
1215
            hardlink=False, stacked=False, standalone=False, no_tree=False,
1239
 
            use_existing_dir=False, switch=False, bind=False,
1240
 
            files_from=None):
 
1216
            use_existing_dir=False, switch=False, bind=False):
1241
1217
        from bzrlib import switch as _mod_switch
1242
1218
        from bzrlib.tag import _merge_tags_if_possible
1243
1219
        accelerator_tree, br_from = bzrdir.BzrDir.open_tree_or_branch(
1244
1220
            from_location)
1245
 
        if not (hardlink or files_from):
1246
 
            # accelerator_tree is usually slower because you have to read N
1247
 
            # files (no readahead, lots of seeks, etc), but allow the user to
1248
 
            # explicitly request it
1249
 
            accelerator_tree = None
1250
 
        if files_from is not None and files_from != from_location:
1251
 
            accelerator_tree = WorkingTree.open(files_from)
1252
1221
        revision = _get_one_revision('branch', revision)
1253
 
        self.add_cleanup(br_from.lock_read().unlock)
 
1222
        br_from.lock_read()
 
1223
        self.add_cleanup(br_from.unlock)
1254
1224
        if revision is not None:
1255
1225
            revision_id = revision.as_revision_id(br_from)
1256
1226
        else:
1361
1331
            to_location = branch_location
1362
1332
        accelerator_tree, source = bzrdir.BzrDir.open_tree_or_branch(
1363
1333
            branch_location)
1364
 
        if not (hardlink or files_from):
1365
 
            # accelerator_tree is usually slower because you have to read N
1366
 
            # files (no readahead, lots of seeks, etc), but allow the user to
1367
 
            # explicitly request it
1368
 
            accelerator_tree = None
1369
1334
        revision = _get_one_revision('checkout', revision)
1370
 
        if files_from is not None and files_from != branch_location:
 
1335
        if files_from is not None:
1371
1336
            accelerator_tree = WorkingTree.open(files_from)
1372
1337
        if revision is not None:
1373
1338
            revision_id = revision.as_revision_id(source)
1401
1366
    @display_command
1402
1367
    def run(self, dir=u'.'):
1403
1368
        tree = WorkingTree.open_containing(dir)[0]
1404
 
        self.add_cleanup(tree.lock_read().unlock)
 
1369
        tree.lock_read()
 
1370
        self.add_cleanup(tree.unlock)
1405
1371
        new_inv = tree.inventory
1406
1372
        old_tree = tree.basis_tree()
1407
 
        self.add_cleanup(old_tree.lock_read().unlock)
 
1373
        old_tree.lock_read()
 
1374
        self.add_cleanup(old_tree.unlock)
1408
1375
        old_inv = old_tree.inventory
1409
1376
        renames = []
1410
1377
        iterator = tree.iter_changes(old_tree, include_unchanged=True)
1429
1396
    If you want to discard your local changes, you can just do a
1430
1397
    'bzr revert' instead of 'bzr commit' after the update.
1431
1398
 
1432
 
    If you want to restore a file that has been removed locally, use
1433
 
    'bzr revert' instead of 'bzr update'.
1434
 
 
1435
1399
    If the tree's branch is bound to a master branch, it will also update
1436
1400
    the branch from the master.
1437
1401
    """
1438
1402
 
1439
1403
    _see_also = ['pull', 'working-trees', 'status-flags']
1440
1404
    takes_args = ['dir?']
1441
 
    takes_options = ['revision',
1442
 
                     Option('show-base',
1443
 
                            help="Show base revision text in conflicts."),
1444
 
                     ]
 
1405
    takes_options = ['revision']
1445
1406
    aliases = ['up']
1446
1407
 
1447
 
    def run(self, dir='.', revision=None, show_base=None):
 
1408
    def run(self, dir='.', revision=None):
1448
1409
        if revision is not None and len(revision) != 1:
1449
1410
            raise errors.BzrCommandError(
1450
1411
                        "bzr update --revision takes exactly one revision")
1454
1415
        master = branch.get_master_branch(
1455
1416
            possible_transports=possible_transports)
1456
1417
        if master is not None:
 
1418
            tree.lock_write()
1457
1419
            branch_location = master.base
1458
 
            tree.lock_write()
1459
1420
        else:
 
1421
            tree.lock_tree_write()
1460
1422
            branch_location = tree.branch.base
1461
 
            tree.lock_tree_write()
1462
1423
        self.add_cleanup(tree.unlock)
1463
1424
        # get rid of the final '/' and be ready for display
1464
1425
        branch_location = urlutils.unescape_for_display(
1490
1451
                change_reporter,
1491
1452
                possible_transports=possible_transports,
1492
1453
                revision=revision_id,
1493
 
                old_tip=old_tip,
1494
 
                show_base=show_base)
 
1454
                old_tip=old_tip)
1495
1455
        except errors.NoSuchRevision, e:
1496
1456
            raise errors.BzrCommandError(
1497
1457
                                  "branch has no revision %s\n"
1559
1519
class cmd_remove(Command):
1560
1520
    __doc__ = """Remove files or directories.
1561
1521
 
1562
 
    This makes Bazaar stop tracking changes to the specified files. Bazaar will
1563
 
    delete them if they can easily be recovered using revert otherwise they
1564
 
    will be backed up (adding an extention of the form .~#~). If no options or
1565
 
    parameters are given Bazaar will scan for files that are being tracked by
1566
 
    Bazaar but missing in your tree and stop tracking them for you.
 
1522
    This makes bzr stop tracking changes to the specified files. bzr will delete
 
1523
    them if they can easily be recovered using revert. If no options or
 
1524
    parameters are given bzr will scan for files that are being tracked by bzr
 
1525
    but missing in your tree and stop tracking them for you.
1567
1526
    """
1568
1527
    takes_args = ['file*']
1569
1528
    takes_options = ['verbose',
1571
1530
        RegistryOption.from_kwargs('file-deletion-strategy',
1572
1531
            'The file deletion mode to be used.',
1573
1532
            title='Deletion Strategy', value_switches=True, enum_switch=False,
1574
 
            safe='Backup changed files (default).',
 
1533
            safe='Only delete files if they can be'
 
1534
                 ' safely recovered (default).',
1575
1535
            keep='Delete from bzr but leave the working copy.',
1576
 
            no_backup='Don\'t backup changed files.',
1577
1536
            force='Delete all the specified files, even if they can not be '
1578
 
                'recovered and even if they are non-empty directories. '
1579
 
                '(deprecated, use no-backup)')]
 
1537
                'recovered and even if they are non-empty directories.')]
1580
1538
    aliases = ['rm', 'del']
1581
1539
    encoding_type = 'replace'
1582
1540
 
1583
1541
    def run(self, file_list, verbose=False, new=False,
1584
1542
        file_deletion_strategy='safe'):
1585
 
        if file_deletion_strategy == 'force':
1586
 
            note("(The --force option is deprecated, rather use --no-backup "
1587
 
                "in future.)")
1588
 
            file_deletion_strategy = 'no-backup'
1589
 
 
1590
 
        tree, file_list = WorkingTree.open_containing_paths(file_list)
 
1543
        tree, file_list = tree_files(file_list)
1591
1544
 
1592
1545
        if file_list is not None:
1593
1546
            file_list = [f for f in file_list]
1594
1547
 
1595
 
        self.add_cleanup(tree.lock_write().unlock)
 
1548
        tree.lock_write()
 
1549
        self.add_cleanup(tree.unlock)
1596
1550
        # Heuristics should probably all move into tree.remove_smart or
1597
1551
        # some such?
1598
1552
        if new:
1613
1567
            file_deletion_strategy = 'keep'
1614
1568
        tree.remove(file_list, verbose=verbose, to_file=self.outf,
1615
1569
            keep_files=file_deletion_strategy=='keep',
1616
 
            force=(file_deletion_strategy=='no-backup'))
 
1570
            force=file_deletion_strategy=='force')
1617
1571
 
1618
1572
 
1619
1573
class cmd_file_id(Command):
1681
1635
 
1682
1636
    _see_also = ['check']
1683
1637
    takes_args = ['branch?']
1684
 
    takes_options = [
1685
 
        Option('canonicalize-chks',
1686
 
               help='Make sure CHKs are in canonical form (repairs '
1687
 
                    'bug 522637).',
1688
 
               hidden=True),
1689
 
        ]
1690
1638
 
1691
 
    def run(self, branch=".", canonicalize_chks=False):
 
1639
    def run(self, branch="."):
1692
1640
        from bzrlib.reconcile import reconcile
1693
1641
        dir = bzrdir.BzrDir.open(branch)
1694
 
        reconcile(dir, canonicalize_chks=canonicalize_chks)
 
1642
        reconcile(dir)
1695
1643
 
1696
1644
 
1697
1645
class cmd_revision_history(Command):
1774
1722
                ),
1775
1723
         Option('append-revisions-only',
1776
1724
                help='Never change revnos or the existing log.'
1777
 
                '  Append revisions to it only.'),
1778
 
         Option('no-tree',
1779
 
                'Create a branch without a working tree.')
 
1725
                '  Append revisions to it only.')
1780
1726
         ]
1781
1727
    def run(self, location=None, format=None, append_revisions_only=False,
1782
 
            create_prefix=False, no_tree=False):
 
1728
            create_prefix=False):
1783
1729
        if format is None:
1784
1730
            format = bzrdir.format_registry.make_bzrdir('default')
1785
1731
        if location is None:
1808
1754
        except errors.NotBranchError:
1809
1755
            # really a NotBzrDir error...
1810
1756
            create_branch = bzrdir.BzrDir.create_branch_convenience
1811
 
            if no_tree:
1812
 
                force_new_tree = False
1813
 
            else:
1814
 
                force_new_tree = None
1815
1757
            branch = create_branch(to_transport.base, format=format,
1816
 
                                   possible_transports=[to_transport],
1817
 
                                   force_new_tree=force_new_tree)
 
1758
                                   possible_transports=[to_transport])
1818
1759
            a_bzrdir = branch.bzrdir
1819
1760
        else:
1820
1761
            from bzrlib.transport.local import LocalTransport
1824
1765
                        raise errors.BranchExistsWithoutWorkingTree(location)
1825
1766
                raise errors.AlreadyBranchError(location)
1826
1767
            branch = a_bzrdir.create_branch()
1827
 
            if not no_tree:
1828
 
                a_bzrdir.create_workingtree()
 
1768
            a_bzrdir.create_workingtree()
1829
1769
        if append_revisions_only:
1830
1770
            try:
1831
1771
                branch.set_append_revisions_only(True)
1925
1865
    "bzr diff -p1" is equivalent to "bzr diff --prefix old/:new/", and
1926
1866
    produces patches suitable for "patch -p1".
1927
1867
 
1928
 
    Note that when using the -r argument with a range of revisions, the
1929
 
    differences are computed between the two specified revisions.  That
1930
 
    is, the command does not show the changes introduced by the first 
1931
 
    revision in the range.  This differs from the interpretation of 
1932
 
    revision ranges used by "bzr log" which includes the first revision
1933
 
    in the range.
1934
 
 
1935
1868
    :Exit values:
1936
1869
        1 - changed
1937
1870
        2 - unrepresentable changes
1955
1888
 
1956
1889
            bzr diff -r1..3 xxx
1957
1890
 
1958
 
        The changes introduced by revision 2 (equivalent to -r1..2)::
1959
 
 
1960
 
            bzr diff -c2
1961
 
 
1962
 
        To see the changes introduced by revision X::
 
1891
        To see the changes introduced in revision X::
1963
1892
        
1964
1893
            bzr diff -cX
1965
1894
 
1969
1898
 
1970
1899
            bzr diff -r<chosen_parent>..X
1971
1900
 
1972
 
        The changes between the current revision and the previous revision
1973
 
        (equivalent to -c-1 and -r-2..-1)
 
1901
        The changes introduced by revision 2 (equivalent to -r1..2)::
1974
1902
 
1975
 
            bzr diff -r-2..
 
1903
            bzr diff -c2
1976
1904
 
1977
1905
        Show just the differences for file NEWS::
1978
1906
 
1993
1921
        Same as 'bzr diff' but prefix paths with old/ and new/::
1994
1922
 
1995
1923
            bzr diff --prefix old/:new/
1996
 
            
1997
 
        Show the differences using a custom diff program with options::
1998
 
        
1999
 
            bzr diff --using /usr/bin/diff --diff-options -wu
2000
1924
    """
2001
1925
    _see_also = ['status']
2002
1926
    takes_args = ['file*']
2022
1946
            type=unicode,
2023
1947
            ),
2024
1948
        RegistryOption('format',
2025
 
            short_name='F',
2026
1949
            help='Diff format to use.',
2027
1950
            lazy_registry=('bzrlib.diff', 'format_registry'),
2028
 
            title='Diff format'),
 
1951
            value_switches=False, title='Diff format'),
2029
1952
        ]
2030
1953
    aliases = ['di', 'dif']
2031
1954
    encoding_type = 'exact'
2062
1985
         old_branch, new_branch,
2063
1986
         specific_files, extra_trees) = get_trees_and_branches_to_diff_locked(
2064
1987
            file_list, revision, old, new, self.add_cleanup, apply_view=True)
2065
 
        # GNU diff on Windows uses ANSI encoding for filenames
2066
 
        path_encoding = osutils.get_diff_header_encoding()
2067
1988
        return show_diff_trees(old_tree, new_tree, sys.stdout,
2068
1989
                               specific_files=specific_files,
2069
1990
                               external_diff_options=diff_options,
2070
1991
                               old_label=old_label, new_label=new_label,
2071
 
                               extra_trees=extra_trees,
2072
 
                               path_encoding=path_encoding,
2073
 
                               using=using,
 
1992
                               extra_trees=extra_trees, using=using,
2074
1993
                               format_cls=format)
2075
1994
 
2076
1995
 
2084
2003
    # level of effort but possibly much less IO.  (Or possibly not,
2085
2004
    # if the directories are very large...)
2086
2005
    _see_also = ['status', 'ls']
2087
 
    takes_options = ['directory', 'show-ids']
 
2006
    takes_options = ['show-ids']
2088
2007
 
2089
2008
    @display_command
2090
 
    def run(self, show_ids=False, directory=u'.'):
2091
 
        tree = WorkingTree.open_containing(directory)[0]
2092
 
        self.add_cleanup(tree.lock_read().unlock)
 
2009
    def run(self, show_ids=False):
 
2010
        tree = WorkingTree.open_containing(u'.')[0]
 
2011
        tree.lock_read()
 
2012
        self.add_cleanup(tree.unlock)
2093
2013
        old = tree.basis_tree()
2094
 
        self.add_cleanup(old.lock_read().unlock)
 
2014
        old.lock_read()
 
2015
        self.add_cleanup(old.unlock)
2095
2016
        for path, ie in old.inventory.iter_entries():
2096
2017
            if not tree.has_id(ie.file_id):
2097
2018
                self.outf.write(path)
2107
2028
 
2108
2029
    hidden = True
2109
2030
    _see_also = ['status', 'ls']
2110
 
    takes_options = ['directory', 'null']
 
2031
    takes_options = [
 
2032
            Option('null',
 
2033
                   help='Write an ascii NUL (\\0) separator '
 
2034
                   'between files rather than a newline.')
 
2035
            ]
2111
2036
 
2112
2037
    @display_command
2113
 
    def run(self, null=False, directory=u'.'):
2114
 
        tree = WorkingTree.open_containing(directory)[0]
2115
 
        self.add_cleanup(tree.lock_read().unlock)
 
2038
    def run(self, null=False):
 
2039
        tree = WorkingTree.open_containing(u'.')[0]
2116
2040
        td = tree.changes_from(tree.basis_tree())
2117
 
        self.cleanup_now()
2118
2041
        for path, id, kind, text_modified, meta_modified in td.modified:
2119
2042
            if null:
2120
2043
                self.outf.write(path + '\0')
2128
2051
 
2129
2052
    hidden = True
2130
2053
    _see_also = ['status', 'ls']
2131
 
    takes_options = ['directory', 'null']
 
2054
    takes_options = [
 
2055
            Option('null',
 
2056
                   help='Write an ascii NUL (\\0) separator '
 
2057
                   'between files rather than a newline.')
 
2058
            ]
2132
2059
 
2133
2060
    @display_command
2134
 
    def run(self, null=False, directory=u'.'):
2135
 
        wt = WorkingTree.open_containing(directory)[0]
2136
 
        self.add_cleanup(wt.lock_read().unlock)
 
2061
    def run(self, null=False):
 
2062
        wt = WorkingTree.open_containing(u'.')[0]
 
2063
        wt.lock_read()
 
2064
        self.add_cleanup(wt.unlock)
2137
2065
        basis = wt.basis_tree()
2138
 
        self.add_cleanup(basis.lock_read().unlock)
 
2066
        basis.lock_read()
 
2067
        self.add_cleanup(basis.unlock)
2139
2068
        basis_inv = basis.inventory
2140
2069
        inv = wt.inventory
2141
2070
        for file_id in inv:
2144
2073
            if inv.is_root(file_id) and len(basis_inv) == 0:
2145
2074
                continue
2146
2075
            path = inv.id2path(file_id)
2147
 
            if not os.access(osutils.pathjoin(wt.basedir, path), os.F_OK):
 
2076
            if not os.access(osutils.abspath(path), os.F_OK):
2148
2077
                continue
2149
2078
            if null:
2150
2079
                self.outf.write(path + '\0')
2350
2279
                   help='Show just the specified revision.'
2351
2280
                   ' See also "help revisionspec".'),
2352
2281
            'log-format',
2353
 
            RegistryOption('authors',
2354
 
                'What names to list as authors - first, all or committer.',
2355
 
                title='Authors',
2356
 
                lazy_registry=('bzrlib.log', 'author_list_registry'),
2357
 
            ),
2358
2282
            Option('levels',
2359
2283
                   short_name='n',
2360
2284
                   help='Number of levels to display - 0 for all, 1 for flat.',
2395
2319
            limit=None,
2396
2320
            show_diff=False,
2397
2321
            include_merges=False,
2398
 
            authors=None,
2399
2322
            exclude_common_ancestry=False,
2400
2323
            ):
2401
2324
        from bzrlib.log import (
2429
2352
        if file_list:
2430
2353
            # find the file ids to log and check for directory filtering
2431
2354
            b, file_info_list, rev1, rev2 = _get_info_for_log_files(
2432
 
                revision, file_list, self.add_cleanup)
 
2355
                revision, file_list)
 
2356
            self.add_cleanup(b.unlock)
2433
2357
            for relpath, file_id, kind in file_info_list:
2434
2358
                if file_id is None:
2435
2359
                    raise errors.BzrCommandError(
2453
2377
                location = '.'
2454
2378
            dir, relpath = bzrdir.BzrDir.open_containing(location)
2455
2379
            b = dir.open_branch()
2456
 
            self.add_cleanup(b.lock_read().unlock)
 
2380
            b.lock_read()
 
2381
            self.add_cleanup(b.unlock)
2457
2382
            rev1, rev2 = _get_revision_range(revision, b, self.name())
2458
2383
 
2459
2384
        # Decide on the type of delta & diff filtering to use
2479
2404
                        show_timezone=timezone,
2480
2405
                        delta_format=get_verbosity_level(),
2481
2406
                        levels=levels,
2482
 
                        show_advice=levels is None,
2483
 
                        author_list_handler=authors)
 
2407
                        show_advice=levels is None)
2484
2408
 
2485
2409
        # Choose the algorithm for doing the logging. It's annoying
2486
2410
        # having multiple code paths like this but necessary until
2584
2508
        tree, relpath = WorkingTree.open_containing(filename)
2585
2509
        file_id = tree.path2id(relpath)
2586
2510
        b = tree.branch
2587
 
        self.add_cleanup(b.lock_read().unlock)
 
2511
        b.lock_read()
 
2512
        self.add_cleanup(b.unlock)
2588
2513
        touching_revs = log.find_touching_revisions(b, file_id)
2589
2514
        for revno, revision_id, what in touching_revs:
2590
2515
            self.outf.write("%6d %s\n" % (revno, what))
2603
2528
                   help='Recurse into subdirectories.'),
2604
2529
            Option('from-root',
2605
2530
                   help='Print paths relative to the root of the branch.'),
2606
 
            Option('unknown', short_name='u',
2607
 
                help='Print unknown files.'),
 
2531
            Option('unknown', help='Print unknown files.'),
2608
2532
            Option('versioned', help='Print versioned files.',
2609
2533
                   short_name='V'),
2610
 
            Option('ignored', short_name='i',
2611
 
                help='Print ignored files.'),
2612
 
            Option('kind', short_name='k',
 
2534
            Option('ignored', help='Print ignored files.'),
 
2535
            Option('null',
 
2536
                   help='Write an ascii NUL (\\0) separator '
 
2537
                   'between files rather than a newline.'),
 
2538
            Option('kind',
2613
2539
                   help='List entries of a particular kind: file, directory, symlink.',
2614
2540
                   type=unicode),
2615
 
            'null',
2616
2541
            'show-ids',
2617
 
            'directory',
2618
2542
            ]
2619
2543
    @display_command
2620
2544
    def run(self, revision=None, verbose=False,
2621
2545
            recursive=False, from_root=False,
2622
2546
            unknown=False, versioned=False, ignored=False,
2623
 
            null=False, kind=None, show_ids=False, path=None, directory=None):
 
2547
            null=False, kind=None, show_ids=False, path=None):
2624
2548
 
2625
2549
        if kind and kind not in ('file', 'directory', 'symlink'):
2626
2550
            raise errors.BzrCommandError('invalid kind specified')
2638
2562
                raise errors.BzrCommandError('cannot specify both --from-root'
2639
2563
                                             ' and PATH')
2640
2564
            fs_path = path
2641
 
        tree, branch, relpath = \
2642
 
            _open_directory_or_containing_tree_or_branch(fs_path, directory)
 
2565
        tree, branch, relpath = bzrdir.BzrDir.open_containing_tree_or_branch(
 
2566
            fs_path)
2643
2567
 
2644
2568
        # Calculate the prefix to use
2645
2569
        prefix = None
2660
2584
                view_str = views.view_display_str(view_files)
2661
2585
                note("Ignoring files outside view. View is %s" % view_str)
2662
2586
 
2663
 
        self.add_cleanup(tree.lock_read().unlock)
 
2587
        tree.lock_read()
 
2588
        self.add_cleanup(tree.unlock)
2664
2589
        for fp, fc, fkind, fid, entry in tree.list_files(include_root=False,
2665
2590
            from_dir=relpath, recursive=recursive):
2666
2591
            # Apply additional masking
2713
2638
 
2714
2639
    hidden = True
2715
2640
    _see_also = ['ls']
2716
 
    takes_options = ['directory']
2717
2641
 
2718
2642
    @display_command
2719
 
    def run(self, directory=u'.'):
2720
 
        for f in WorkingTree.open_containing(directory)[0].unknowns():
 
2643
    def run(self):
 
2644
        for f in WorkingTree.open_containing(u'.')[0].unknowns():
2721
2645
            self.outf.write(osutils.quotefn(f) + '\n')
2722
2646
 
2723
2647
 
2750
2674
    Patterns prefixed with '!!' act as regular ignore patterns, but have
2751
2675
    precedence over the '!' exception patterns.
2752
2676
 
2753
 
    :Notes: 
2754
 
        
2755
 
    * Ignore patterns containing shell wildcards must be quoted from
2756
 
      the shell on Unix.
2757
 
 
2758
 
    * Ignore patterns starting with "#" act as comments in the ignore file.
2759
 
      To ignore patterns that begin with that character, use the "RE:" prefix.
 
2677
    Note: ignore patterns containing shell wildcards must be quoted from
 
2678
    the shell on Unix.
2760
2679
 
2761
2680
    :Examples:
2762
2681
        Ignore the top level Makefile::
2771
2690
 
2772
2691
            bzr ignore "!special.class"
2773
2692
 
2774
 
        Ignore files whose name begins with the "#" character::
2775
 
 
2776
 
            bzr ignore "RE:^#"
2777
 
 
2778
2693
        Ignore .o files under the lib directory::
2779
2694
 
2780
2695
            bzr ignore "lib/**/*.o"
2797
2712
 
2798
2713
    _see_also = ['status', 'ignored', 'patterns']
2799
2714
    takes_args = ['name_pattern*']
2800
 
    takes_options = ['directory',
 
2715
    takes_options = [
2801
2716
        Option('default-rules',
2802
2717
               help='Display the default ignore rules that bzr uses.')
2803
2718
        ]
2804
2719
 
2805
 
    def run(self, name_pattern_list=None, default_rules=None,
2806
 
            directory=u'.'):
 
2720
    def run(self, name_pattern_list=None, default_rules=None):
2807
2721
        from bzrlib import ignores
2808
2722
        if default_rules is not None:
2809
2723
            # dump the default rules and exit
2815
2729
                "NAME_PATTERN or --default-rules.")
2816
2730
        name_pattern_list = [globbing.normalize_pattern(p)
2817
2731
                             for p in name_pattern_list]
2818
 
        bad_patterns = ''
2819
 
        for p in name_pattern_list:
2820
 
            if not globbing.Globster.is_pattern_valid(p):
2821
 
                bad_patterns += ('\n  %s' % p)
2822
 
        if bad_patterns:
2823
 
            msg = ('Invalid ignore pattern(s) found. %s' % bad_patterns)
2824
 
            ui.ui_factory.show_error(msg)
2825
 
            raise errors.InvalidPattern('')
2826
2732
        for name_pattern in name_pattern_list:
2827
2733
            if (name_pattern[0] == '/' or
2828
2734
                (len(name_pattern) > 1 and name_pattern[1] == ':')):
2829
2735
                raise errors.BzrCommandError(
2830
2736
                    "NAME_PATTERN should not be an absolute path")
2831
 
        tree, relpath = WorkingTree.open_containing(directory)
 
2737
        tree, relpath = WorkingTree.open_containing(u'.')
2832
2738
        ignores.tree_ignores_add_patterns(tree, name_pattern_list)
2833
2739
        ignored = globbing.Globster(name_pattern_list)
2834
2740
        matches = []
2835
 
        self.add_cleanup(tree.lock_read().unlock)
 
2741
        tree.lock_read()
2836
2742
        for entry in tree.list_files():
2837
2743
            id = entry[3]
2838
2744
            if id is not None:
2839
2745
                filename = entry[0]
2840
2746
                if ignored.match(filename):
2841
2747
                    matches.append(filename)
 
2748
        tree.unlock()
2842
2749
        if len(matches) > 0:
2843
2750
            self.outf.write("Warning: the following files are version controlled and"
2844
2751
                  " match your ignore pattern:\n%s"
2859
2766
 
2860
2767
    encoding_type = 'replace'
2861
2768
    _see_also = ['ignore', 'ls']
2862
 
    takes_options = ['directory']
2863
2769
 
2864
2770
    @display_command
2865
 
    def run(self, directory=u'.'):
2866
 
        tree = WorkingTree.open_containing(directory)[0]
2867
 
        self.add_cleanup(tree.lock_read().unlock)
 
2771
    def run(self):
 
2772
        tree = WorkingTree.open_containing(u'.')[0]
 
2773
        tree.lock_read()
 
2774
        self.add_cleanup(tree.unlock)
2868
2775
        for path, file_class, kind, file_id, entry in tree.list_files():
2869
2776
            if file_class != 'I':
2870
2777
                continue
2881
2788
    """
2882
2789
    hidden = True
2883
2790
    takes_args = ['revno']
2884
 
    takes_options = ['directory']
2885
2791
 
2886
2792
    @display_command
2887
 
    def run(self, revno, directory=u'.'):
 
2793
    def run(self, revno):
2888
2794
        try:
2889
2795
            revno = int(revno)
2890
2796
        except ValueError:
2891
2797
            raise errors.BzrCommandError("not a valid revision-number: %r"
2892
2798
                                         % revno)
2893
 
        revid = WorkingTree.open_containing(directory)[0].branch.get_rev_id(revno)
 
2799
        revid = WorkingTree.open_containing(u'.')[0].branch.get_rev_id(revno)
2894
2800
        self.outf.write("%s\n" % revid)
2895
2801
 
2896
2802
 
2923
2829
      =================       =========================
2924
2830
    """
2925
2831
    takes_args = ['dest', 'branch_or_subdir?']
2926
 
    takes_options = ['directory',
 
2832
    takes_options = [
2927
2833
        Option('format',
2928
2834
               help="Type of file to export to.",
2929
2835
               type=unicode),
2938
2844
                    'revision in which it was changed.'),
2939
2845
        ]
2940
2846
    def run(self, dest, branch_or_subdir=None, revision=None, format=None,
2941
 
        root=None, filters=False, per_file_timestamps=False, directory=u'.'):
 
2847
        root=None, filters=False, per_file_timestamps=False):
2942
2848
        from bzrlib.export import export
2943
2849
 
2944
2850
        if branch_or_subdir is None:
2945
 
            tree = WorkingTree.open_containing(directory)[0]
 
2851
            tree = WorkingTree.open_containing(u'.')[0]
2946
2852
            b = tree.branch
2947
2853
            subdir = None
2948
2854
        else:
2967
2873
    """
2968
2874
 
2969
2875
    _see_also = ['ls']
2970
 
    takes_options = ['directory',
 
2876
    takes_options = [
2971
2877
        Option('name-from-revision', help='The path name in the old tree.'),
2972
2878
        Option('filters', help='Apply content filters to display the '
2973
2879
                'convenience form.'),
2978
2884
 
2979
2885
    @display_command
2980
2886
    def run(self, filename, revision=None, name_from_revision=False,
2981
 
            filters=False, directory=None):
 
2887
            filters=False):
2982
2888
        if revision is not None and len(revision) != 1:
2983
2889
            raise errors.BzrCommandError("bzr cat --revision takes exactly"
2984
2890
                                         " one revision specifier")
2985
2891
        tree, branch, relpath = \
2986
 
            _open_directory_or_containing_tree_or_branch(filename, directory)
2987
 
        self.add_cleanup(branch.lock_read().unlock)
 
2892
            bzrdir.BzrDir.open_containing_tree_or_branch(filename)
 
2893
        branch.lock_read()
 
2894
        self.add_cleanup(branch.unlock)
2988
2895
        return self._run(tree, branch, relpath, filename, revision,
2989
2896
                         name_from_revision, filters)
2990
2897
 
2993
2900
        if tree is None:
2994
2901
            tree = b.basis_tree()
2995
2902
        rev_tree = _get_one_revision_tree('cat', revision, branch=b)
2996
 
        self.add_cleanup(rev_tree.lock_read().unlock)
 
2903
        rev_tree.lock_read()
 
2904
        self.add_cleanup(rev_tree.unlock)
2997
2905
 
2998
2906
        old_file_id = rev_tree.path2id(relpath)
2999
2907
 
3220
3128
 
3221
3129
        properties = {}
3222
3130
 
3223
 
        tree, selected_list = WorkingTree.open_containing_paths(selected_list)
 
3131
        tree, selected_list = tree_files(selected_list)
3224
3132
        if selected_list == ['']:
3225
3133
            # workaround - commit of root of tree should be exactly the same
3226
3134
            # as just default commit in that tree, and succeed even though
3261
3169
        def get_message(commit_obj):
3262
3170
            """Callback to get commit message"""
3263
3171
            if file:
3264
 
                f = open(file)
3265
 
                try:
3266
 
                    my_message = f.read().decode(osutils.get_user_encoding())
3267
 
                finally:
3268
 
                    f.close()
 
3172
                my_message = codecs.open(
 
3173
                    file, 'rt', osutils.get_user_encoding()).read()
3269
3174
            elif message is not None:
3270
3175
                my_message = message
3271
3176
            else:
3300
3205
                        reporter=None, verbose=verbose, revprops=properties,
3301
3206
                        authors=author, timestamp=commit_stamp,
3302
3207
                        timezone=offset,
3303
 
                        exclude=tree.safe_relpath_files(exclude))
 
3208
                        exclude=safe_relpath_files(tree, exclude))
3304
3209
        except PointlessCommit:
3305
3210
            raise errors.BzrCommandError("No changes to commit."
3306
3211
                              " Use --unchanged to commit anyhow.")
3390
3295
 
3391
3296
 
3392
3297
class cmd_upgrade(Command):
3393
 
    __doc__ = """Upgrade a repository, branch or working tree to a newer format.
3394
 
 
3395
 
    When the default format has changed after a major new release of
3396
 
    Bazaar, you may be informed during certain operations that you
3397
 
    should upgrade. Upgrading to a newer format may improve performance
3398
 
    or make new features available. It may however limit interoperability
3399
 
    with older repositories or with older versions of Bazaar.
3400
 
 
3401
 
    If you wish to upgrade to a particular format rather than the
3402
 
    current default, that can be specified using the --format option.
3403
 
    As a consequence, you can use the upgrade command this way to
3404
 
    "downgrade" to an earlier format, though some conversions are
3405
 
    a one way process (e.g. changing from the 1.x default to the
3406
 
    2.x default) so downgrading is not always possible.
3407
 
 
3408
 
    A backup.bzr.~#~ directory is created at the start of the conversion
3409
 
    process (where # is a number). By default, this is left there on
3410
 
    completion. If the conversion fails, delete the new .bzr directory
3411
 
    and rename this one back in its place. Use the --clean option to ask
3412
 
    for the backup.bzr directory to be removed on successful conversion.
3413
 
    Alternatively, you can delete it by hand if everything looks good
3414
 
    afterwards.
3415
 
 
3416
 
    If the location given is a shared repository, dependent branches
3417
 
    are also converted provided the repository converts successfully.
3418
 
    If the conversion of a branch fails, remaining branches are still
3419
 
    tried.
3420
 
 
3421
 
    For more information on upgrades, see the Bazaar Upgrade Guide,
3422
 
    http://doc.bazaar.canonical.com/latest/en/upgrade-guide/.
 
3298
    __doc__ = """Upgrade branch storage to current format.
 
3299
 
 
3300
    The check command or bzr developers may sometimes advise you to run
 
3301
    this command. When the default format has changed you may also be warned
 
3302
    during other operations to upgrade.
3423
3303
    """
3424
3304
 
3425
 
    _see_also = ['check', 'reconcile', 'formats']
 
3305
    _see_also = ['check']
3426
3306
    takes_args = ['url?']
3427
3307
    takes_options = [
3428
 
        RegistryOption('format',
3429
 
            help='Upgrade to a specific format.  See "bzr help'
3430
 
                 ' formats" for details.',
3431
 
            lazy_registry=('bzrlib.bzrdir', 'format_registry'),
3432
 
            converter=lambda name: bzrdir.format_registry.make_bzrdir(name),
3433
 
            value_switches=True, title='Branch format'),
3434
 
        Option('clean',
3435
 
            help='Remove the backup.bzr directory if successful.'),
3436
 
        Option('dry-run',
3437
 
            help="Show what would be done, but don't actually do anything."),
3438
 
    ]
 
3308
                    RegistryOption('format',
 
3309
                        help='Upgrade to a specific format.  See "bzr help'
 
3310
                             ' formats" for details.',
 
3311
                        lazy_registry=('bzrlib.bzrdir', 'format_registry'),
 
3312
                        converter=lambda name: bzrdir.format_registry.make_bzrdir(name),
 
3313
                        value_switches=True, title='Branch format'),
 
3314
                    ]
3439
3315
 
3440
 
    def run(self, url='.', format=None, clean=False, dry_run=False):
 
3316
    def run(self, url='.', format=None):
3441
3317
        from bzrlib.upgrade import upgrade
3442
 
        exceptions = upgrade(url, format, clean_up=clean, dry_run=dry_run)
3443
 
        if exceptions:
3444
 
            if len(exceptions) == 1:
3445
 
                # Compatibility with historical behavior
3446
 
                raise exceptions[0]
3447
 
            else:
3448
 
                return 3
 
3318
        upgrade(url, format)
3449
3319
 
3450
3320
 
3451
3321
class cmd_whoami(Command):
3460
3330
 
3461
3331
            bzr whoami "Frank Chu <fchu@example.com>"
3462
3332
    """
3463
 
    takes_options = [ 'directory',
3464
 
                      Option('email',
 
3333
    takes_options = [ Option('email',
3465
3334
                             help='Display email address only.'),
3466
3335
                      Option('branch',
3467
3336
                             help='Set identity for the current branch instead of '
3471
3340
    encoding_type = 'replace'
3472
3341
 
3473
3342
    @display_command
3474
 
    def run(self, email=False, branch=False, name=None, directory=None):
 
3343
    def run(self, email=False, branch=False, name=None):
3475
3344
        if name is None:
3476
 
            if directory is None:
3477
 
                # use branch if we're inside one; otherwise global config
3478
 
                try:
3479
 
                    c = Branch.open_containing(u'.')[0].get_config()
3480
 
                except errors.NotBranchError:
3481
 
                    c = _mod_config.GlobalConfig()
3482
 
            else:
3483
 
                c = Branch.open(directory).get_config()
 
3345
            # use branch if we're inside one; otherwise global config
 
3346
            try:
 
3347
                c = Branch.open_containing('.')[0].get_config()
 
3348
            except errors.NotBranchError:
 
3349
                c = config.GlobalConfig()
3484
3350
            if email:
3485
3351
                self.outf.write(c.user_email() + '\n')
3486
3352
            else:
3487
3353
                self.outf.write(c.username() + '\n')
3488
3354
            return
3489
3355
 
3490
 
        if email:
3491
 
            raise errors.BzrCommandError("--email can only be used to display existing "
3492
 
                                         "identity")
3493
 
 
3494
3356
        # display a warning if an email address isn't included in the given name.
3495
3357
        try:
3496
 
            _mod_config.extract_email_address(name)
 
3358
            config.extract_email_address(name)
3497
3359
        except errors.NoEmailInUsername, e:
3498
3360
            warning('"%s" does not seem to contain an email address.  '
3499
3361
                    'This is allowed, but not recommended.', name)
3500
3362
 
3501
3363
        # use global config unless --branch given
3502
3364
        if branch:
3503
 
            if directory is None:
3504
 
                c = Branch.open_containing(u'.')[0].get_config()
3505
 
            else:
3506
 
                c = Branch.open(directory).get_config()
 
3365
            c = Branch.open_containing('.')[0].get_config()
3507
3366
        else:
3508
 
            c = _mod_config.GlobalConfig()
 
3367
            c = config.GlobalConfig()
3509
3368
        c.set_user_option('email', name)
3510
3369
 
3511
3370
 
3521
3380
 
3522
3381
    _see_also = ['info']
3523
3382
    takes_args = ['nickname?']
3524
 
    takes_options = ['directory']
3525
 
    def run(self, nickname=None, directory=u'.'):
3526
 
        branch = Branch.open_containing(directory)[0]
 
3383
    def run(self, nickname=None):
 
3384
        branch = Branch.open_containing(u'.')[0]
3527
3385
        if nickname is None:
3528
3386
            self.printme(branch)
3529
3387
        else:
3578
3436
                'bzr alias --remove expects an alias to remove.')
3579
3437
        # If alias is not found, print something like:
3580
3438
        # unalias: foo: not found
3581
 
        c = _mod_config.GlobalConfig()
 
3439
        c = config.GlobalConfig()
3582
3440
        c.unset_alias(alias_name)
3583
3441
 
3584
3442
    @display_command
3585
3443
    def print_aliases(self):
3586
3444
        """Print out the defined aliases in a similar format to bash."""
3587
 
        aliases = _mod_config.GlobalConfig().get_aliases()
 
3445
        aliases = config.GlobalConfig().get_aliases()
3588
3446
        for key, value in sorted(aliases.iteritems()):
3589
3447
            self.outf.write('bzr alias %s="%s"\n' % (key, value))
3590
3448
 
3600
3458
 
3601
3459
    def set_alias(self, alias_name, alias_command):
3602
3460
        """Save the alias in the global config."""
3603
 
        c = _mod_config.GlobalConfig()
 
3461
        c = config.GlobalConfig()
3604
3462
        c.set_alias(alias_name, alias_command)
3605
3463
 
3606
3464
 
3641
3499
    If you set BZR_TEST_PDB=1 when running selftest, failing tests will drop
3642
3500
    into a pdb postmortem session.
3643
3501
 
3644
 
    The --coverage=DIRNAME global option produces a report with covered code
3645
 
    indicated.
3646
 
 
3647
3502
    :Examples:
3648
3503
        Run only tests relating to 'ignore'::
3649
3504
 
3682
3537
                                 'throughout the test suite.',
3683
3538
                            type=get_transport_type),
3684
3539
                     Option('benchmark',
3685
 
                            help='Run the benchmarks rather than selftests.',
3686
 
                            hidden=True),
 
3540
                            help='Run the benchmarks rather than selftests.'),
3687
3541
                     Option('lsprof-timed',
3688
3542
                            help='Generate lsprof output for benchmarked'
3689
3543
                                 ' sections of code.'),
3690
3544
                     Option('lsprof-tests',
3691
3545
                            help='Generate lsprof output for each test.'),
 
3546
                     Option('cache-dir', type=str,
 
3547
                            help='Cache intermediate benchmark output in this '
 
3548
                                 'directory.'),
3692
3549
                     Option('first',
3693
3550
                            help='Run all tests, but run specified tests first.',
3694
3551
                            short_name='f',
3728
3585
 
3729
3586
    def run(self, testspecs_list=None, verbose=False, one=False,
3730
3587
            transport=None, benchmark=None,
3731
 
            lsprof_timed=None,
 
3588
            lsprof_timed=None, cache_dir=None,
3732
3589
            first=False, list_only=False,
3733
3590
            randomize=None, exclude=None, strict=False,
3734
3591
            load_list=None, debugflag=None, starting_with=None, subunit=False,
3735
3592
            parallel=None, lsprof_tests=False):
3736
 
        from bzrlib import tests
3737
 
 
 
3593
        from bzrlib.tests import selftest
 
3594
        import bzrlib.benchmarks as benchmarks
 
3595
        from bzrlib.benchmarks import tree_creator
 
3596
 
 
3597
        # Make deprecation warnings visible, unless -Werror is set
 
3598
        symbol_versioning.activate_deprecation_warnings(override=False)
 
3599
 
 
3600
        if cache_dir is not None:
 
3601
            tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
3738
3602
        if testspecs_list is not None:
3739
3603
            pattern = '|'.join(testspecs_list)
3740
3604
        else:
3748
3612
            self.additional_selftest_args['runner_class'] = SubUnitBzrRunner
3749
3613
            # On Windows, disable automatic conversion of '\n' to '\r\n' in
3750
3614
            # stdout, which would corrupt the subunit stream. 
3751
 
            # FIXME: This has been fixed in subunit trunk (>0.0.5) so the
3752
 
            # following code can be deleted when it's sufficiently deployed
3753
 
            # -- vila/mgz 20100514
3754
 
            if (sys.platform == "win32"
3755
 
                and getattr(sys.stdout, 'fileno', None) is not None):
 
3615
            if sys.platform == "win32" and sys.stdout.fileno() >= 0:
3756
3616
                import msvcrt
3757
3617
                msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
3758
3618
        if parallel:
3759
3619
            self.additional_selftest_args.setdefault(
3760
3620
                'suite_decorators', []).append(parallel)
3761
3621
        if benchmark:
3762
 
            raise errors.BzrCommandError(
3763
 
                "--benchmark is no longer supported from bzr 2.2; "
3764
 
                "use bzr-usertest instead")
3765
 
        test_suite_factory = None
 
3622
            test_suite_factory = benchmarks.test_suite
 
3623
            # Unless user explicitly asks for quiet, be verbose in benchmarks
 
3624
            verbose = not is_quiet()
 
3625
            # TODO: should possibly lock the history file...
 
3626
            benchfile = open(".perf_history", "at", buffering=1)
 
3627
            self.add_cleanup(benchfile.close)
 
3628
        else:
 
3629
            test_suite_factory = None
 
3630
            benchfile = None
3766
3631
        selftest_kwargs = {"verbose": verbose,
3767
3632
                          "pattern": pattern,
3768
3633
                          "stop_on_failure": one,
3770
3635
                          "test_suite_factory": test_suite_factory,
3771
3636
                          "lsprof_timed": lsprof_timed,
3772
3637
                          "lsprof_tests": lsprof_tests,
 
3638
                          "bench_history": benchfile,
3773
3639
                          "matching_tests_first": first,
3774
3640
                          "list_only": list_only,
3775
3641
                          "random_seed": randomize,
3780
3646
                          "starting_with": starting_with
3781
3647
                          }
3782
3648
        selftest_kwargs.update(self.additional_selftest_args)
3783
 
 
3784
 
        # Make deprecation warnings visible, unless -Werror is set
3785
 
        cleanup = symbol_versioning.activate_deprecation_warnings(
3786
 
            override=False)
3787
 
        try:
3788
 
            result = tests.selftest(**selftest_kwargs)
3789
 
        finally:
3790
 
            cleanup()
 
3649
        result = selftest(**selftest_kwargs)
3791
3650
        return int(not result)
3792
3651
 
3793
3652
 
3831
3690
 
3832
3691
        branch1 = Branch.open_containing(branch)[0]
3833
3692
        branch2 = Branch.open_containing(other)[0]
3834
 
        self.add_cleanup(branch1.lock_read().unlock)
3835
 
        self.add_cleanup(branch2.lock_read().unlock)
 
3693
        branch1.lock_read()
 
3694
        self.add_cleanup(branch1.unlock)
 
3695
        branch2.lock_read()
 
3696
        self.add_cleanup(branch2.unlock)
3836
3697
        last1 = ensure_null(branch1.last_revision())
3837
3698
        last2 = ensure_null(branch2.last_revision())
3838
3699
 
3850
3711
    with bzr send. If neither is specified, the default is the upstream branch
3851
3712
    or the branch most recently merged using --remember.
3852
3713
 
3853
 
    When merging from a branch, by default bzr will try to merge in all new
3854
 
    work from the other branch, automatically determining an appropriate base
3855
 
    revision.  If this fails, you may need to give an explicit base.
3856
 
 
3857
 
    To pick a different ending revision, pass "--revision OTHER".  bzr will
3858
 
    try to merge in all new work up to and including revision OTHER.
3859
 
 
3860
 
    If you specify two values, "--revision BASE..OTHER", only revisions BASE
3861
 
    through OTHER, excluding BASE but including OTHER, will be merged.  If this
3862
 
    causes some revisions to be skipped, i.e. if the destination branch does
3863
 
    not already contain revision BASE, such a merge is commonly referred to as
3864
 
    a "cherrypick".
3865
 
 
3866
 
    Revision numbers are always relative to the source branch.
 
3714
    When merging a branch, by default the tip will be merged. To pick a different
 
3715
    revision, pass --revision. If you specify two values, the first will be used as
 
3716
    BASE and the second one as OTHER. Merging individual revisions, or a subset of
 
3717
    available revisions, like this is commonly referred to as "cherrypicking".
 
3718
 
 
3719
    Revision numbers are always relative to the branch being merged.
 
3720
 
 
3721
    By default, bzr will try to merge in all new work from the other
 
3722
    branch, automatically determining an appropriate base.  If this
 
3723
    fails, you may need to give an explicit base.
3867
3724
 
3868
3725
    Merge will do its best to combine the changes in two branches, but there
3869
3726
    are some kinds of problems only a human can fix.  When it encounters those,
3893
3750
    you to apply each diff hunk and file change, similar to "shelve".
3894
3751
 
3895
3752
    :Examples:
3896
 
        To merge all new revisions from bzr.dev::
 
3753
        To merge the latest revision from bzr.dev::
3897
3754
 
3898
3755
            bzr merge ../bzr.dev
3899
3756
 
3936
3793
                ' completely merged into the source, pull from the'
3937
3794
                ' source rather than merging.  When this happens,'
3938
3795
                ' you do not need to commit the result.'),
3939
 
        custom_help('directory',
 
3796
        Option('directory',
3940
3797
               help='Branch to merge into, '
3941
 
                    'rather than the one containing the working directory.'),
 
3798
                    'rather than the one containing the working directory.',
 
3799
               short_name='d',
 
3800
               type=unicode,
 
3801
               ),
3942
3802
        Option('preview', help='Instead of merging, show a diff of the'
3943
3803
               ' merge.'),
3944
3804
        Option('interactive', help='Select changes interactively.',
3977
3837
            unversioned_filter=tree.is_ignored, view_info=view_info)
3978
3838
        pb = ui.ui_factory.nested_progress_bar()
3979
3839
        self.add_cleanup(pb.finished)
3980
 
        self.add_cleanup(tree.lock_write().unlock)
 
3840
        tree.lock_write()
 
3841
        self.add_cleanup(tree.unlock)
3981
3842
        if location is not None:
3982
3843
            try:
3983
3844
                mergeable = bundle.read_mergeable_from_url(location,
4044
3905
    def _do_preview(self, merger):
4045
3906
        from bzrlib.diff import show_diff_trees
4046
3907
        result_tree = self._get_preview(merger)
4047
 
        path_encoding = osutils.get_diff_header_encoding()
4048
3908
        show_diff_trees(merger.this_tree, result_tree, self.outf,
4049
 
                        old_label='', new_label='',
4050
 
                        path_encoding=path_encoding)
 
3909
                        old_label='', new_label='')
4051
3910
 
4052
3911
    def _do_merge(self, merger, change_reporter, allow_pending, verified):
4053
3912
        merger.change_reporter = change_reporter
4133
3992
        if ((remember or tree.branch.get_submit_branch() is None) and
4134
3993
             user_location is not None):
4135
3994
            tree.branch.set_submit_branch(other_branch.base)
4136
 
        # Merge tags (but don't set them in the master branch yet, the user
4137
 
        # might revert this merge).  Commit will propagate them.
4138
 
        _merge_tags_if_possible(other_branch, tree.branch, ignore_master=True)
 
3995
        _merge_tags_if_possible(other_branch, tree.branch)
4139
3996
        merger = _mod_merge.Merger.from_revision_ids(pb, tree,
4140
3997
            other_revision_id, base_revision_id, other_branch, base_branch)
4141
3998
        if other_path != '':
4242
4099
        from bzrlib.conflicts import restore
4243
4100
        if merge_type is None:
4244
4101
            merge_type = _mod_merge.Merge3Merger
4245
 
        tree, file_list = WorkingTree.open_containing_paths(file_list)
4246
 
        self.add_cleanup(tree.lock_write().unlock)
 
4102
        tree, file_list = tree_files(file_list)
 
4103
        tree.lock_write()
 
4104
        self.add_cleanup(tree.unlock)
4247
4105
        parents = tree.get_parent_ids()
4248
4106
        if len(parents) != 2:
4249
4107
            raise errors.BzrCommandError("Sorry, remerge only works after normal"
4309
4167
    last committed revision is used.
4310
4168
 
4311
4169
    To remove only some changes, without reverting to a prior version, use
4312
 
    merge instead.  For example, "merge . -r -2..-3" (don't forget the ".")
4313
 
    will remove the changes introduced by the second last commit (-2), without
4314
 
    affecting the changes introduced by the last commit (-1).  To remove
4315
 
    certain changes on a hunk-by-hunk basis, see the shelve command.
 
4170
    merge instead.  For example, "merge . --revision -2..-3" will remove the
 
4171
    changes introduced by -2, without affecting the changes introduced by -1.
 
4172
    Or to remove certain changes on a hunk-by-hunk basis, see the Shelf plugin.
4316
4173
 
4317
4174
    By default, any files that have been manually changed will be backed up
4318
4175
    first.  (Files changed only by merge are not backed up.)  Backup files have
4348
4205
    target branches.
4349
4206
    """
4350
4207
 
4351
 
    _see_also = ['cat', 'export', 'merge', 'shelve']
 
4208
    _see_also = ['cat', 'export']
4352
4209
    takes_options = [
4353
4210
        'revision',
4354
4211
        Option('no-backup', "Do not save backups of reverted files."),
4359
4216
 
4360
4217
    def run(self, revision=None, no_backup=False, file_list=None,
4361
4218
            forget_merges=None):
4362
 
        tree, file_list = WorkingTree.open_containing_paths(file_list)
4363
 
        self.add_cleanup(tree.lock_tree_write().unlock)
 
4219
        tree, file_list = tree_files(file_list)
 
4220
        tree.lock_tree_write()
 
4221
        self.add_cleanup(tree.unlock)
4364
4222
        if forget_merges:
4365
4223
            tree.set_parent_ids(tree.get_parent_ids()[:1])
4366
4224
        else:
4455
4313
    _see_also = ['merge', 'pull']
4456
4314
    takes_args = ['other_branch?']
4457
4315
    takes_options = [
4458
 
        'directory',
4459
4316
        Option('reverse', 'Reverse the order of revisions.'),
4460
4317
        Option('mine-only',
4461
4318
               'Display changes in the local branch only.'),
4483
4340
            theirs_only=False,
4484
4341
            log_format=None, long=False, short=False, line=False,
4485
4342
            show_ids=False, verbose=False, this=False, other=False,
4486
 
            include_merges=False, revision=None, my_revision=None,
4487
 
            directory=u'.'):
 
4343
            include_merges=False, revision=None, my_revision=None):
4488
4344
        from bzrlib.missing import find_unmerged, iter_log_revisions
4489
4345
        def message(s):
4490
4346
            if not is_quiet():
4503
4359
        elif theirs_only:
4504
4360
            restrict = 'remote'
4505
4361
 
4506
 
        local_branch = Branch.open_containing(directory)[0]
4507
 
        self.add_cleanup(local_branch.lock_read().unlock)
 
4362
        local_branch = Branch.open_containing(u".")[0]
 
4363
        local_branch.lock_read()
 
4364
        self.add_cleanup(local_branch.unlock)
4508
4365
 
4509
4366
        parent = local_branch.get_parent()
4510
4367
        if other_branch is None:
4521
4378
        if remote_branch.base == local_branch.base:
4522
4379
            remote_branch = local_branch
4523
4380
        else:
4524
 
            self.add_cleanup(remote_branch.lock_read().unlock)
 
4381
            remote_branch.lock_read()
 
4382
            self.add_cleanup(remote_branch.unlock)
4525
4383
 
4526
4384
        local_revid_range = _revision_range_to_revid_range(
4527
4385
            _get_revision_range(my_revision, local_branch,
4582
4440
            message("Branches are up to date.\n")
4583
4441
        self.cleanup_now()
4584
4442
        if not status_code and parent is None and other_branch is not None:
4585
 
            self.add_cleanup(local_branch.lock_write().unlock)
 
4443
            local_branch.lock_write()
 
4444
            self.add_cleanup(local_branch.unlock)
4586
4445
            # handle race conditions - a parent might be set while we run.
4587
4446
            if local_branch.get_parent() is None:
4588
4447
                local_branch.set_parent(remote_branch.base)
4647
4506
 
4648
4507
    @display_command
4649
4508
    def run(self, verbose=False):
4650
 
        from bzrlib import plugin
4651
 
        self.outf.writelines(
4652
 
            plugin.describe_plugins(show_paths=verbose))
 
4509
        import bzrlib.plugin
 
4510
        from inspect import getdoc
 
4511
        result = []
 
4512
        for name, plugin in bzrlib.plugin.plugins().items():
 
4513
            version = plugin.__version__
 
4514
            if version == 'unknown':
 
4515
                version = ''
 
4516
            name_ver = '%s %s' % (name, version)
 
4517
            d = getdoc(plugin.module)
 
4518
            if d:
 
4519
                doc = d.split('\n')[0]
 
4520
            else:
 
4521
                doc = '(no description)'
 
4522
            result.append((name_ver, doc, plugin.path()))
 
4523
        for name_ver, doc, path in sorted(result):
 
4524
            self.outf.write("%s\n" % name_ver)
 
4525
            self.outf.write("   %s\n" % doc)
 
4526
            if verbose:
 
4527
                self.outf.write("   %s\n" % path)
 
4528
            self.outf.write("\n")
4653
4529
 
4654
4530
 
4655
4531
class cmd_testament(Command):
4671
4547
            b = Branch.open_containing(branch)[0]
4672
4548
        else:
4673
4549
            b = Branch.open(branch)
4674
 
        self.add_cleanup(b.lock_read().unlock)
 
4550
        b.lock_read()
 
4551
        self.add_cleanup(b.unlock)
4675
4552
        if revision is None:
4676
4553
            rev_id = b.last_revision()
4677
4554
        else:
4701
4578
                     Option('long', help='Show commit date in annotations.'),
4702
4579
                     'revision',
4703
4580
                     'show-ids',
4704
 
                     'directory',
4705
4581
                     ]
4706
4582
    encoding_type = 'exact'
4707
4583
 
4708
4584
    @display_command
4709
4585
    def run(self, filename, all=False, long=False, revision=None,
4710
 
            show_ids=False, directory=None):
 
4586
            show_ids=False):
4711
4587
        from bzrlib.annotate import annotate_file, annotate_file_tree
4712
4588
        wt, branch, relpath = \
4713
 
            _open_directory_or_containing_tree_or_branch(filename, directory)
 
4589
            bzrdir.BzrDir.open_containing_tree_or_branch(filename)
4714
4590
        if wt is not None:
4715
 
            self.add_cleanup(wt.lock_read().unlock)
 
4591
            wt.lock_read()
 
4592
            self.add_cleanup(wt.unlock)
4716
4593
        else:
4717
 
            self.add_cleanup(branch.lock_read().unlock)
 
4594
            branch.lock_read()
 
4595
            self.add_cleanup(branch.unlock)
4718
4596
        tree = _get_one_revision_tree('annotate', revision, branch=branch)
4719
 
        self.add_cleanup(tree.lock_read().unlock)
4720
 
        if wt is not None and revision is None:
 
4597
        tree.lock_read()
 
4598
        self.add_cleanup(tree.unlock)
 
4599
        if wt is not None:
4721
4600
            file_id = wt.path2id(relpath)
4722
4601
        else:
4723
4602
            file_id = tree.path2id(relpath)
4724
4603
        if file_id is None:
4725
4604
            raise errors.NotVersionedError(filename)
 
4605
        file_version = tree.inventory[file_id].revision
4726
4606
        if wt is not None and revision is None:
4727
4607
            # If there is a tree and we're not annotating historical
4728
4608
            # versions, annotate the working tree's content.
4729
4609
            annotate_file_tree(wt, file_id, self.outf, long, all,
4730
4610
                show_ids=show_ids)
4731
4611
        else:
4732
 
            file_version = tree.inventory[file_id].revision
4733
4612
            annotate_file(branch, file_version, file_id, long, all, self.outf,
4734
4613
                          show_ids=show_ids)
4735
4614
 
4740
4619
 
4741
4620
    hidden = True # is this right ?
4742
4621
    takes_args = ['revision_id*']
4743
 
    takes_options = ['directory', 'revision']
 
4622
    takes_options = ['revision']
4744
4623
 
4745
 
    def run(self, revision_id_list=None, revision=None, directory=u'.'):
 
4624
    def run(self, revision_id_list=None, revision=None):
4746
4625
        if revision_id_list is not None and revision is not None:
4747
4626
            raise errors.BzrCommandError('You can only supply one of revision_id or --revision')
4748
4627
        if revision_id_list is None and revision is None:
4749
4628
            raise errors.BzrCommandError('You must supply either --revision or a revision_id')
4750
 
        b = WorkingTree.open_containing(directory)[0].branch
4751
 
        self.add_cleanup(b.lock_write().unlock)
 
4629
        b = WorkingTree.open_containing(u'.')[0].branch
 
4630
        b.lock_write()
 
4631
        self.add_cleanup(b.unlock)
4752
4632
        return self._run(b, revision_id_list, revision)
4753
4633
 
4754
4634
    def _run(self, b, revision_id_list, revision):
4813
4693
 
4814
4694
    _see_also = ['checkouts', 'unbind']
4815
4695
    takes_args = ['location?']
4816
 
    takes_options = ['directory']
 
4696
    takes_options = []
4817
4697
 
4818
 
    def run(self, location=None, directory=u'.'):
4819
 
        b, relpath = Branch.open_containing(directory)
 
4698
    def run(self, location=None):
 
4699
        b, relpath = Branch.open_containing(u'.')
4820
4700
        if location is None:
4821
4701
            try:
4822
4702
                location = b.get_old_bound_location()
4849
4729
 
4850
4730
    _see_also = ['checkouts', 'bind']
4851
4731
    takes_args = []
4852
 
    takes_options = ['directory']
 
4732
    takes_options = []
4853
4733
 
4854
 
    def run(self, directory=u'.'):
4855
 
        b, relpath = Branch.open_containing(directory)
 
4734
    def run(self):
 
4735
        b, relpath = Branch.open_containing(u'.')
4856
4736
        if not b.unbind():
4857
4737
            raise errors.BzrCommandError('Local branch is not bound')
4858
4738
 
4904
4784
            b = control.open_branch()
4905
4785
 
4906
4786
        if tree is not None:
4907
 
            self.add_cleanup(tree.lock_write().unlock)
 
4787
            tree.lock_write()
 
4788
            self.add_cleanup(tree.unlock)
4908
4789
        else:
4909
 
            self.add_cleanup(b.lock_write().unlock)
 
4790
            b.lock_write()
 
4791
            self.add_cleanup(b.unlock)
4910
4792
        return self._run(b, tree, dry_run, verbose, revision, force, local=local)
4911
4793
 
4912
4794
    def _run(self, b, tree, dry_run, verbose, revision, force, local=False):
4951
4833
            self.outf.write('The above revision(s) will be removed.\n')
4952
4834
 
4953
4835
        if not force:
4954
 
            if not ui.ui_factory.confirm_action(
4955
 
                    'Uncommit these revisions',
4956
 
                    'bzrlib.builtins.uncommit',
4957
 
                    {}):
4958
 
                self.outf.write('Canceled\n')
 
4836
            if not ui.ui_factory.get_boolean('Are you sure'):
 
4837
                self.outf.write('Canceled')
4959
4838
                return 0
4960
4839
 
4961
4840
        mutter('Uncommitting from {%s} to {%s}',
4967
4846
 
4968
4847
 
4969
4848
class cmd_break_lock(Command):
4970
 
    __doc__ = """Break a dead lock.
4971
 
 
4972
 
    This command breaks a lock on a repository, branch, working directory or
4973
 
    config file.
 
4849
    __doc__ = """Break a dead lock on a repository, branch or working directory.
4974
4850
 
4975
4851
    CAUTION: Locks should only be broken when you are sure that the process
4976
4852
    holding the lock has been stopped.
4981
4857
    :Examples:
4982
4858
        bzr break-lock
4983
4859
        bzr break-lock bzr+ssh://example.com/bzr/foo
4984
 
        bzr break-lock --conf ~/.bazaar
4985
4860
    """
4986
 
 
4987
4861
    takes_args = ['location?']
4988
 
    takes_options = [
4989
 
        Option('config',
4990
 
               help='LOCATION is the directory where the config lock is.'),
4991
 
        Option('force',
4992
 
            help='Do not ask for confirmation before breaking the lock.'),
4993
 
        ]
4994
4862
 
4995
 
    def run(self, location=None, config=False, force=False):
 
4863
    def run(self, location=None, show=False):
4996
4864
        if location is None:
4997
4865
            location = u'.'
4998
 
        if force:
4999
 
            ui.ui_factory = ui.ConfirmationUserInterfacePolicy(ui.ui_factory,
5000
 
                None,
5001
 
                {'bzrlib.lockdir.break': True})
5002
 
        if config:
5003
 
            conf = _mod_config.LockableConfig(file_name=location)
5004
 
            conf.break_lock()
5005
 
        else:
5006
 
            control, relpath = bzrdir.BzrDir.open_containing(location)
5007
 
            try:
5008
 
                control.break_lock()
5009
 
            except NotImplementedError:
5010
 
                pass
 
4866
        control, relpath = bzrdir.BzrDir.open_containing(location)
 
4867
        try:
 
4868
            control.break_lock()
 
4869
        except NotImplementedError:
 
4870
            pass
5011
4871
 
5012
4872
 
5013
4873
class cmd_wait_until_signalled(Command):
5042
4902
                    'result in a dynamically allocated port.  The default port '
5043
4903
                    'depends on the protocol.',
5044
4904
               type=str),
5045
 
        custom_help('directory',
5046
 
               help='Serve contents of this directory.'),
 
4905
        Option('directory',
 
4906
               help='Serve contents of this directory.',
 
4907
               type=unicode),
5047
4908
        Option('allow-writes',
5048
4909
               help='By default the server is a readonly server.  Supplying '
5049
4910
                    '--allow-writes enables write access to the contents of '
5076
4937
 
5077
4938
    def run(self, port=None, inet=False, directory=None, allow_writes=False,
5078
4939
            protocol=None):
5079
 
        from bzrlib import transport
 
4940
        from bzrlib.transport import get_transport, transport_server_registry
5080
4941
        if directory is None:
5081
4942
            directory = os.getcwd()
5082
4943
        if protocol is None:
5083
 
            protocol = transport.transport_server_registry.get()
 
4944
            protocol = transport_server_registry.get()
5084
4945
        host, port = self.get_host_and_port(port)
5085
4946
        url = urlutils.local_path_to_url(directory)
5086
4947
        if not allow_writes:
5087
4948
            url = 'readonly+' + url
5088
 
        t = transport.get_transport(url)
5089
 
        protocol(t, host, port, inet)
 
4949
        transport = get_transport(url)
 
4950
        protocol(transport, host, port, inet)
5090
4951
 
5091
4952
 
5092
4953
class cmd_join(Command):
5098
4959
    not part of it.  (Such trees can be produced by "bzr split", but also by
5099
4960
    running "bzr branch" with the target inside a tree.)
5100
4961
 
5101
 
    The result is a combined tree, with the subtree no longer an independent
 
4962
    The result is a combined tree, with the subtree no longer an independant
5102
4963
    part.  This is marked as a merge of the subtree into the containing tree,
5103
4964
    and all history is preserved.
5104
4965
    """
5185
5046
    _see_also = ['send']
5186
5047
 
5187
5048
    takes_options = [
5188
 
        'directory',
5189
5049
        RegistryOption.from_kwargs('patch-type',
5190
5050
            'The type of patch to include in the directive.',
5191
5051
            title='Patch type',
5204
5064
    encoding_type = 'exact'
5205
5065
 
5206
5066
    def run(self, submit_branch=None, public_branch=None, patch_type='bundle',
5207
 
            sign=False, revision=None, mail_to=None, message=None,
5208
 
            directory=u'.'):
 
5067
            sign=False, revision=None, mail_to=None, message=None):
5209
5068
        from bzrlib.revision import ensure_null, NULL_REVISION
5210
5069
        include_patch, include_bundle = {
5211
5070
            'plain': (False, False),
5212
5071
            'diff': (True, False),
5213
5072
            'bundle': (True, True),
5214
5073
            }[patch_type]
5215
 
        branch = Branch.open(directory)
 
5074
        branch = Branch.open('.')
5216
5075
        stored_submit_branch = branch.get_submit_branch()
5217
5076
        if submit_branch is None:
5218
5077
            submit_branch = stored_submit_branch
5303
5162
    given, in which case it is sent to a file.
5304
5163
 
5305
5164
    Mail is sent using your preferred mail program.  This should be transparent
5306
 
    on Windows (it uses MAPI).  On Unix, it requires the xdg-email utility.
 
5165
    on Windows (it uses MAPI).  On Linux, it requires the xdg-email utility.
5307
5166
    If the preferred client can't be found (or used), your editor will be used.
5308
5167
 
5309
5168
    To use a specific mail program, set the mail_client configuration option.
5480
5339
        Option('delete',
5481
5340
            help='Delete this tag rather than placing it.',
5482
5341
            ),
5483
 
        custom_help('directory',
5484
 
            help='Branch in which to place the tag.'),
 
5342
        Option('directory',
 
5343
            help='Branch in which to place the tag.',
 
5344
            short_name='d',
 
5345
            type=unicode,
 
5346
            ),
5485
5347
        Option('force',
5486
5348
            help='Replace existing tags.',
5487
5349
            ),
5495
5357
            revision=None,
5496
5358
            ):
5497
5359
        branch, relpath = Branch.open_containing(directory)
5498
 
        self.add_cleanup(branch.lock_write().unlock)
 
5360
        branch.lock_write()
 
5361
        self.add_cleanup(branch.unlock)
5499
5362
        if delete:
5500
5363
            if tag_name is None:
5501
5364
                raise errors.BzrCommandError("No tag specified to delete.")
5502
5365
            branch.tags.delete_tag(tag_name)
5503
 
            note('Deleted tag %s.' % tag_name)
 
5366
            self.outf.write('Deleted tag %s.\n' % tag_name)
5504
5367
        else:
5505
5368
            if revision:
5506
5369
                if len(revision) != 1:
5518
5381
            if (not force) and branch.tags.has_tag(tag_name):
5519
5382
                raise errors.TagAlreadyExists(tag_name)
5520
5383
            branch.tags.set_tag(tag_name, revision_id)
5521
 
            note('Created tag %s.' % tag_name)
 
5384
            self.outf.write('Created tag %s.\n' % tag_name)
5522
5385
 
5523
5386
 
5524
5387
class cmd_tags(Command):
5529
5392
 
5530
5393
    _see_also = ['tag']
5531
5394
    takes_options = [
5532
 
        custom_help('directory',
5533
 
            help='Branch whose tags should be displayed.'),
5534
 
        RegistryOption('sort',
 
5395
        Option('directory',
 
5396
            help='Branch whose tags should be displayed.',
 
5397
            short_name='d',
 
5398
            type=unicode,
 
5399
            ),
 
5400
        RegistryOption.from_kwargs('sort',
5535
5401
            'Sort tags by different criteria.', title='Sorting',
5536
 
            lazy_registry=('bzrlib.tag', 'tag_sort_methods')
 
5402
            alpha='Sort tags lexicographically (default).',
 
5403
            time='Sort tags chronologically.',
5537
5404
            ),
5538
5405
        'show-ids',
5539
5406
        'revision',
5540
5407
    ]
5541
5408
 
5542
5409
    @display_command
5543
 
    def run(self, directory='.', sort=None, show_ids=False, revision=None):
5544
 
        from bzrlib.tag import tag_sort_methods
 
5410
    def run(self,
 
5411
            directory='.',
 
5412
            sort='alpha',
 
5413
            show_ids=False,
 
5414
            revision=None,
 
5415
            ):
5545
5416
        branch, relpath = Branch.open_containing(directory)
5546
5417
 
5547
5418
        tags = branch.tags.get_tag_dict().items()
5548
5419
        if not tags:
5549
5420
            return
5550
5421
 
5551
 
        self.add_cleanup(branch.lock_read().unlock)
 
5422
        branch.lock_read()
 
5423
        self.add_cleanup(branch.unlock)
5552
5424
        if revision:
5553
5425
            graph = branch.repository.get_graph()
5554
5426
            rev1, rev2 = _get_revision_range(revision, branch, self.name())
5556
5428
            # only show revisions between revid1 and revid2 (inclusive)
5557
5429
            tags = [(tag, revid) for tag, revid in tags if
5558
5430
                graph.is_between(revid, revid1, revid2)]
5559
 
        if sort is None:
5560
 
            sort = tag_sort_methods.get()
5561
 
        sort(branch, tags)
 
5431
        if sort == 'alpha':
 
5432
            tags.sort()
 
5433
        elif sort == 'time':
 
5434
            timestamps = {}
 
5435
            for tag, revid in tags:
 
5436
                try:
 
5437
                    revobj = branch.repository.get_revision(revid)
 
5438
                except errors.NoSuchRevision:
 
5439
                    timestamp = sys.maxint # place them at the end
 
5440
                else:
 
5441
                    timestamp = revobj.timestamp
 
5442
                timestamps[revid] = timestamp
 
5443
            tags.sort(key=lambda x: timestamps[x[1]])
5562
5444
        if not show_ids:
5563
5445
            # [ (tag, revid), ... ] -> [ (tag, dotted_revno), ... ]
5564
5446
            for index, (tag, revid) in enumerate(tags):
5691
5573
    """
5692
5574
 
5693
5575
    takes_args = ['to_location?']
5694
 
    takes_options = ['directory',
5695
 
                     Option('force',
 
5576
    takes_options = [Option('force',
5696
5577
                        help='Switch even if local commits will be lost.'),
5697
5578
                     'revision',
5698
5579
                     Option('create-branch', short_name='b',
5701
5582
                    ]
5702
5583
 
5703
5584
    def run(self, to_location=None, force=False, create_branch=False,
5704
 
            revision=None, directory=u'.'):
 
5585
            revision=None):
5705
5586
        from bzrlib import switch
5706
 
        tree_location = directory
 
5587
        tree_location = '.'
5707
5588
        revision = _get_one_revision('switch', revision)
5708
5589
        control_dir = bzrdir.BzrDir.open_containing(tree_location)[0]
5709
5590
        if to_location is None:
5710
5591
            if revision is None:
5711
5592
                raise errors.BzrCommandError('You must supply either a'
5712
5593
                                             ' revision or a location')
5713
 
            to_location = tree_location
 
5594
            to_location = '.'
5714
5595
        try:
5715
5596
            branch = control_dir.open_branch()
5716
5597
            had_explicit_nick = branch.get_config().has_explicit_nickname()
5851
5732
            name=None,
5852
5733
            switch=None,
5853
5734
            ):
5854
 
        tree, file_list = WorkingTree.open_containing_paths(file_list,
5855
 
            apply_view=False)
 
5735
        tree, file_list = tree_files(file_list, apply_view=False)
5856
5736
        current_view, view_dict = tree.views.get_view_info()
5857
5737
        if name is None:
5858
5738
            name = current_view
5962
5842
            location = "."
5963
5843
        branch = Branch.open_containing(location)[0]
5964
5844
        branch.bzrdir.destroy_branch()
5965
 
 
 
5845
        
5966
5846
 
5967
5847
class cmd_shelve(Command):
5968
5848
    __doc__ = """Temporarily set aside some changes from the current tree.
5987
5867
 
5988
5868
    You can put multiple items on the shelf, and by default, 'unshelve' will
5989
5869
    restore the most recently shelved changes.
5990
 
 
5991
 
    For complicated changes, it is possible to edit the changes in a separate
5992
 
    editor program to decide what the file remaining in the working copy
5993
 
    should look like.  To do this, add the configuration option
5994
 
 
5995
 
        change_editor = PROGRAM @new_path @old_path
5996
 
 
5997
 
    where @new_path is replaced with the path of the new version of the 
5998
 
    file and @old_path is replaced with the path of the old version of 
5999
 
    the file.  The PROGRAM should save the new file with the desired 
6000
 
    contents of the file in the working tree.
6001
 
        
6002
5870
    """
6003
5871
 
6004
5872
    takes_args = ['file*']
6005
5873
 
6006
5874
    takes_options = [
6007
 
        'directory',
6008
5875
        'revision',
6009
5876
        Option('all', help='Shelve all changes.'),
6010
5877
        'message',
6016
5883
        Option('destroy',
6017
5884
               help='Destroy removed changes instead of shelving them.'),
6018
5885
    ]
6019
 
    _see_also = ['unshelve', 'configuration']
 
5886
    _see_also = ['unshelve']
6020
5887
 
6021
5888
    def run(self, revision=None, all=False, file_list=None, message=None,
6022
 
            writer=None, list=False, destroy=False, directory=None):
 
5889
            writer=None, list=False, destroy=False):
6023
5890
        if list:
6024
 
            return self.run_for_list(directory=directory)
 
5891
            return self.run_for_list()
6025
5892
        from bzrlib.shelf_ui import Shelver
6026
5893
        if writer is None:
6027
5894
            writer = bzrlib.option.diff_writer_registry.get()
6028
5895
        try:
6029
5896
            shelver = Shelver.from_args(writer(sys.stdout), revision, all,
6030
 
                file_list, message, destroy=destroy, directory=directory)
 
5897
                file_list, message, destroy=destroy)
6031
5898
            try:
6032
5899
                shelver.run()
6033
5900
            finally:
6035
5902
        except errors.UserAbort:
6036
5903
            return 0
6037
5904
 
6038
 
    def run_for_list(self, directory=None):
6039
 
        if directory is None:
6040
 
            directory = u'.'
6041
 
        tree = WorkingTree.open_containing(directory)[0]
6042
 
        self.add_cleanup(tree.lock_read().unlock)
 
5905
    def run_for_list(self):
 
5906
        tree = WorkingTree.open_containing('.')[0]
 
5907
        tree.lock_read()
 
5908
        self.add_cleanup(tree.unlock)
6043
5909
        manager = tree.get_shelf_manager()
6044
5910
        shelves = manager.active_shelves()
6045
5911
        if len(shelves) == 0:
6063
5929
 
6064
5930
    takes_args = ['shelf_id?']
6065
5931
    takes_options = [
6066
 
        'directory',
6067
5932
        RegistryOption.from_kwargs(
6068
5933
            'action', help="The action to perform.",
6069
5934
            enum_switch=False, value_switches=True,
6077
5942
    ]
6078
5943
    _see_also = ['shelve']
6079
5944
 
6080
 
    def run(self, shelf_id=None, action='apply', directory=u'.'):
 
5945
    def run(self, shelf_id=None, action='apply'):
6081
5946
        from bzrlib.shelf_ui import Unshelver
6082
 
        unshelver = Unshelver.from_args(shelf_id, action, directory=directory)
 
5947
        unshelver = Unshelver.from_args(shelf_id, action)
6083
5948
        try:
6084
5949
            unshelver.run()
6085
5950
        finally:
6101
5966
 
6102
5967
    To check what clean-tree will do, use --dry-run.
6103
5968
    """
6104
 
    takes_options = ['directory',
6105
 
                     Option('ignored', help='Delete all ignored files.'),
6106
 
                     Option('detritus', help='Delete conflict files, merge and revert'
 
5969
    takes_options = [Option('ignored', help='Delete all ignored files.'),
 
5970
                     Option('detritus', help='Delete conflict files, merge'
6107
5971
                            ' backups, and failed selftest dirs.'),
6108
5972
                     Option('unknown',
6109
5973
                            help='Delete files unknown to bzr (default).'),
6111
5975
                            ' deleting them.'),
6112
5976
                     Option('force', help='Do not prompt before deleting.')]
6113
5977
    def run(self, unknown=False, ignored=False, detritus=False, dry_run=False,
6114
 
            force=False, directory=u'.'):
 
5978
            force=False):
6115
5979
        from bzrlib.clean_tree import clean_tree
6116
5980
        if not (unknown or ignored or detritus):
6117
5981
            unknown = True
6118
5982
        if dry_run:
6119
5983
            force = True
6120
 
        clean_tree(directory, unknown=unknown, ignored=ignored,
6121
 
                   detritus=detritus, dry_run=dry_run, no_prompt=force)
 
5984
        clean_tree('.', unknown=unknown, ignored=ignored, detritus=detritus,
 
5985
                   dry_run=dry_run, no_prompt=force)
6122
5986
 
6123
5987
 
6124
5988
class cmd_reference(Command):
6173
6037
    # be only called once.
6174
6038
    for (name, aliases, module_name) in [
6175
6039
        ('cmd_bundle_info', [], 'bzrlib.bundle.commands'),
6176
 
        ('cmd_config', [], 'bzrlib.config'),
6177
6040
        ('cmd_dpush', [], 'bzrlib.foreign'),
6178
6041
        ('cmd_version_info', [], 'bzrlib.cmd_version_info'),
6179
6042
        ('cmd_resolve', ['resolved'], 'bzrlib.conflicts'),
6180
6043
        ('cmd_conflicts', [], 'bzrlib.conflicts'),
6181
6044
        ('cmd_sign_my_commits', [], 'bzrlib.sign_my_commits'),
6182
 
        ('cmd_test_script', [], 'bzrlib.cmd_test_script'),
6183
6045
        ]:
6184
6046
        builtin_command_registry.register_lazy(name, aliases, module_name)