235
def _open_directory_or_containing_tree_or_branch(filename, directory):
236
"""Open the tree or branch containing the specified file, unless
237
the --directory option is used to specify a different branch."""
238
if directory is not None:
239
return (None, Branch.open(directory), filename)
240
return bzrdir.BzrDir.open_containing_tree_or_branch(filename)
243
231
# TODO: Make sure no commands unconditionally use the working directory as a
244
232
# branch. If a filename argument is used, the first of them should be used to
245
233
# specify the branch. (Perhaps this can be factored out into some kind of
350
338
takes_args = ['revision_id?']
351
takes_options = ['directory', 'revision']
339
takes_options = ['revision']
352
340
# cat-revision is more for frontends so should be exact
353
341
encoding = 'strict'
355
def print_revision(self, revisions, revid):
356
stream = revisions.get_record_stream([(revid,)], 'unordered', True)
357
record = stream.next()
358
if record.storage_kind == 'absent':
359
raise errors.NoSuchRevision(revisions, revid)
360
revtext = record.get_bytes_as('fulltext')
361
self.outf.write(revtext.decode('utf-8'))
364
def run(self, revision_id=None, revision=None, directory=u'.'):
344
def run(self, revision_id=None, revision=None):
365
345
if revision_id is not None and revision is not None:
366
346
raise errors.BzrCommandError('You can only supply one of'
367
347
' revision_id or --revision')
368
348
if revision_id is None and revision is None:
369
349
raise errors.BzrCommandError('You must supply either'
370
350
' --revision or a revision_id')
371
b = WorkingTree.open_containing(directory)[0].branch
373
revisions = b.repository.revisions
374
if revisions is None:
375
raise errors.BzrCommandError('Repository %r does not support '
376
'access to raw revision texts')
378
b.repository.lock_read()
380
# TODO: jam 20060112 should cat-revision always output utf-8?
381
if revision_id is not None:
382
revision_id = osutils.safe_revision_id(revision_id, warn=False)
384
self.print_revision(revisions, revision_id)
385
except errors.NoSuchRevision:
386
msg = "The repository %s contains no revision %s." % (
387
b.repository.base, revision_id)
388
raise errors.BzrCommandError(msg)
389
elif revision is not None:
392
raise errors.BzrCommandError(
393
'You cannot specify a NULL revision.')
394
rev_id = rev.as_revision_id(b)
395
self.print_revision(revisions, rev_id)
397
b.repository.unlock()
351
b = WorkingTree.open_containing(u'.')[0].branch
353
# TODO: jam 20060112 should cat-revision always output utf-8?
354
if revision_id is not None:
355
revision_id = osutils.safe_revision_id(revision_id, warn=False)
357
self.outf.write(b.repository.get_revision_xml(revision_id).decode('utf-8'))
358
except errors.NoSuchRevision:
359
msg = "The repository %s contains no revision %s." % (b.repository.base,
361
raise errors.BzrCommandError(msg)
362
elif revision is not None:
365
raise errors.BzrCommandError('You cannot specify a NULL'
367
rev_id = rev.as_revision_id(b)
368
self.outf.write(b.repository.get_revision_xml(rev_id).decode('utf-8'))
400
371
class cmd_dump_btree(Command):
401
__doc__ = """Dump the contents of a btree index file to stdout.
372
"""Dump the contents of a btree index file to stdout.
403
374
PATH is a btree index file, it can be any URL. This includes things like
404
375
.bzr/repository/pack-names, or .bzr/repository/indices/a34b3a...ca4a4.iix
468
439
for node in bt.iter_all_entries():
469
440
# Node is made up of:
470
441
# (index, key, value, [references])
474
refs_as_tuples = None
476
refs_as_tuples = static_tuple.as_tuples(refs)
442
refs_as_tuples = static_tuple.as_tuples(node[3])
477
443
as_tuple = (tuple(node[1]), node[2], refs_as_tuples)
478
444
self.outf.write('%s\n' % (as_tuple,))
481
447
class cmd_remove_tree(Command):
482
__doc__ = """Remove the working tree from a given branch/checkout.
448
"""Remove the working tree from a given branch/checkout.
484
450
Since a lightweight checkout is little more than a working tree
485
451
this will refuse to run against one.
512
478
if (working.has_changes()):
513
479
raise errors.UncommittedChanges(working)
514
if working.get_shelf_manager().last_shelf() is not None:
515
raise errors.ShelvedChanges(working)
517
if working.user_url != working.branch.user_url:
481
working_path = working.bzrdir.root_transport.base
482
branch_path = working.branch.bzrdir.root_transport.base
483
if working_path != branch_path:
518
484
raise errors.BzrCommandError("You cannot remove the working tree"
519
485
" from a lightweight checkout")
549
516
revno = ".".join(str(n) for n in revno_t)
551
518
b = Branch.open_containing(location)[0]
552
self.add_cleanup(b.lock_read().unlock)
520
self.add_cleanup(b.unlock)
553
521
revno = b.revno()
554
522
self.cleanup_now()
555
523
self.outf.write(str(revno) + '\n')
558
526
class cmd_revision_info(Command):
559
__doc__ = """Show revision number and revision id for a given revision identifier.
527
"""Show revision number and revision id for a given revision identifier.
562
530
takes_args = ['revision_info*']
563
531
takes_options = [
565
custom_help('directory',
566
534
help='Branch to examine, '
567
'rather than the one containing the working directory.'),
535
'rather than the one containing the working directory.',
568
539
Option('tree', help='Show revno of working tree'),
709
683
def run(self, dir_list):
710
684
for d in dir_list:
711
686
wt, dd = WorkingTree.open_containing(d)
712
base = os.path.dirname(dd)
713
id = wt.path2id(base)
717
self.outf.write('added %s\n' % d)
719
raise errors.NotVersionedError(path=base)
688
self.outf.write('added %s\n' % d)
722
691
class cmd_relpath(Command):
723
__doc__ = """Show path of a file relative to root"""
692
"""Show path of a file relative to root"""
725
694
takes_args = ['filename']
833
804
if len(names_list) < 2:
834
805
raise errors.BzrCommandError("missing file argument")
835
806
tree, rel_names = tree_files(names_list, canonicalize=False)
836
self.add_cleanup(tree.lock_tree_write().unlock)
807
tree.lock_tree_write()
808
self.add_cleanup(tree.unlock)
837
809
self._run(tree, names_list, rel_names, after)
839
811
def run_auto(self, names_list, after, dry_run):
844
816
raise errors.BzrCommandError('--after cannot be specified with'
846
818
work_tree, file_list = tree_files(names_list, default_branch='.')
847
self.add_cleanup(work_tree.lock_tree_write().unlock)
819
work_tree.lock_tree_write()
820
self.add_cleanup(work_tree.unlock)
848
821
rename_map.RenameMap.guess_renames(work_tree, dry_run)
850
823
def _run(self, tree, names_list, rel_names, after):
958
931
takes_options = ['remember', 'overwrite', 'revision',
959
932
custom_help('verbose',
960
933
help='Show logs of pulled revisions.'),
961
custom_help('directory',
962
935
help='Branch to pull into, '
963
'rather than the one containing the working directory.'),
936
'rather than the one containing the working directory.',
965
941
help="Perform a local pull in a bound "
966
942
"branch. Local pulls are not applied to "
1023
997
branch_from = Branch.open(location,
1024
998
possible_transports=possible_transports)
1025
self.add_cleanup(branch_from.lock_read().unlock)
1027
1000
if branch_to.get_parent() is None or remember:
1028
1001
branch_to.set_parent(branch_from.base)
1003
if branch_from is not branch_to:
1004
branch_from.lock_read()
1005
self.add_cleanup(branch_from.unlock)
1030
1006
if revision is not None:
1031
1007
revision_id = revision.as_revision_id(branch_from)
1009
branch_to.lock_write()
1010
self.add_cleanup(branch_to.unlock)
1033
1011
if tree_to is not None:
1034
1012
view_info = _get_view_info_for_change_reporter(tree_to)
1035
1013
change_reporter = delta._ChangeReporter(
1080
1058
Option('create-prefix',
1081
1059
help='Create the path leading up to the branch '
1082
1060
'if it does not already exist.'),
1083
custom_help('directory',
1084
1062
help='Branch to push from, '
1085
'rather than the one containing the working directory.'),
1063
'rather than the one containing the working directory.',
1086
1067
Option('use-existing-dir',
1087
1068
help='By default push will fail if the target'
1088
1069
' directory exists, but does not already'
1114
1095
# Get the source branch
1115
1096
(tree, br_from,
1116
1097
_unused) = bzrdir.BzrDir.open_containing_tree_or_branch(directory)
1099
strict = br_from.get_config().get_user_option_as_bool('push_strict')
1100
if strict is None: strict = True # default value
1117
1101
# Get the tip's revision_id
1118
1102
revision = _get_one_revision('push', revision)
1119
1103
if revision is not None:
1120
1104
revision_id = revision.in_history(br_from).rev_id
1122
1106
revision_id = None
1123
if tree is not None and revision_id is None:
1124
tree.check_changed_or_out_of_date(
1125
strict, 'push_strict',
1126
more_error='Use --no-strict to force the push.',
1127
more_warning='Uncommitted changes will not be pushed.')
1107
if strict and tree is not None and revision_id is None:
1108
if (tree.has_changes()):
1109
raise errors.UncommittedChanges(
1110
tree, more='Use --no-strict to force the push.')
1111
if tree.last_revision() != tree.branch.last_revision():
1112
# The tree has lost sync with its branch, there is little
1113
# chance that the user is aware of it but he can still force
1114
# the push with --no-strict
1115
raise errors.OutOfDateTree(
1116
tree, more='Use --no-strict to force the push.')
1128
1118
# Get the stacked_on branch, if any
1129
1119
if stacked_on is not None:
1130
1120
stacked_on = urlutils.normalize_url(stacked_on)
1401
1394
master = branch.get_master_branch(
1402
1395
possible_transports=possible_transports)
1403
1396
if master is not None:
1404
1398
branch_location = master.base
1400
tree.lock_tree_write()
1407
1401
branch_location = tree.branch.base
1408
tree.lock_tree_write()
1409
1402
self.add_cleanup(tree.unlock)
1410
1403
# get rid of the final '/' and be ready for display
1411
branch_location = urlutils.unescape_for_display(
1412
branch_location.rstrip('/'),
1404
branch_location = urlutils.unescape_for_display(branch_location[:-1],
1414
1406
existing_pending_merges = tree.get_parent_ids()[1:]
1415
1407
if master is None:
1425
1417
revision_id = branch.last_revision()
1426
1418
if revision_id == _mod_revision.ensure_null(tree.last_revision()):
1427
revno = branch.revision_id_to_dotted_revno(revision_id)
1428
note("Tree is up to date at revision %s of branch %s" %
1429
('.'.join(map(str, revno)), branch_location))
1419
revno = branch.revision_id_to_revno(revision_id)
1420
note("Tree is up to date at revision %d of branch %s" %
1421
(revno, branch_location))
1431
1423
view_info = _get_view_info_for_change_reporter(tree)
1432
1424
change_reporter = delta._ChangeReporter(
1444
1436
"bzr update --revision only works"
1445
1437
" for a revision in the branch history"
1446
1438
% (e.revision))
1447
revno = tree.branch.revision_id_to_dotted_revno(
1439
revno = tree.branch.revision_id_to_revno(
1448
1440
_mod_revision.ensure_null(tree.last_revision()))
1449
note('Updated to revision %s of branch %s' %
1450
('.'.join(map(str, revno)), branch_location))
1451
parent_ids = tree.get_parent_ids()
1452
if parent_ids[1:] and parent_ids[1:] != existing_pending_merges:
1441
note('Updated to revision %d of branch %s' %
1442
(revno, branch_location))
1443
if tree.get_parent_ids()[1:] != existing_pending_merges:
1453
1444
note('Your local commits will now show as pending merges with '
1454
1445
"'bzr status', and can be committed with 'bzr commit'.")
1455
1446
if conflicts != 0:
1930
1922
help='Use this command to compare files.',
1933
RegistryOption('format',
1934
help='Diff format to use.',
1935
lazy_registry=('bzrlib.diff', 'format_registry'),
1936
value_switches=False, title='Diff format'),
1938
1926
aliases = ['di', 'dif']
1939
1927
encoding_type = 'exact'
1941
1929
@display_command
1942
1930
def run(self, revision=None, file_list=None, diff_options=None,
1943
prefix=None, old=None, new=None, using=None, format=None):
1944
from bzrlib.diff import (get_trees_and_branches_to_diff_locked,
1931
prefix=None, old=None, new=None, using=None):
1932
from bzrlib.diff import get_trees_and_branches_to_diff, show_diff_trees
1947
1934
if (prefix is None) or (prefix == '0'):
1948
1935
# diff -p0 format
1962
1949
raise errors.BzrCommandError('bzr diff --revision takes exactly'
1963
1950
' one or two revision specifiers')
1965
if using is not None and format is not None:
1966
raise errors.BzrCommandError('--using and --format are mutually '
1969
1952
(old_tree, new_tree,
1970
1953
old_branch, new_branch,
1971
specific_files, extra_trees) = get_trees_and_branches_to_diff_locked(
1972
file_list, revision, old, new, self.add_cleanup, apply_view=True)
1973
# GNU diff on Windows uses ANSI encoding for filenames
1974
path_encoding = osutils.get_diff_header_encoding()
1954
specific_files, extra_trees) = get_trees_and_branches_to_diff(
1955
file_list, revision, old, new, apply_view=True)
1975
1956
return show_diff_trees(old_tree, new_tree, sys.stdout,
1976
1957
specific_files=specific_files,
1977
1958
external_diff_options=diff_options,
1978
1959
old_label=old_label, new_label=new_label,
1979
extra_trees=extra_trees,
1980
path_encoding=path_encoding,
1960
extra_trees=extra_trees, using=using)
1985
1963
class cmd_deleted(Command):
1986
__doc__ = """List files deleted in the working tree.
1964
"""List files deleted in the working tree.
1988
1966
# TODO: Show files deleted since a previous revision, or
1989
1967
# between two revisions.
1992
1970
# level of effort but possibly much less IO. (Or possibly not,
1993
1971
# if the directories are very large...)
1994
1972
_see_also = ['status', 'ls']
1995
takes_options = ['directory', 'show-ids']
1973
takes_options = ['show-ids']
1997
1975
@display_command
1998
def run(self, show_ids=False, directory=u'.'):
1999
tree = WorkingTree.open_containing(directory)[0]
2000
self.add_cleanup(tree.lock_read().unlock)
1976
def run(self, show_ids=False):
1977
tree = WorkingTree.open_containing(u'.')[0]
1979
self.add_cleanup(tree.unlock)
2001
1980
old = tree.basis_tree()
2002
self.add_cleanup(old.lock_read().unlock)
1982
self.add_cleanup(old.unlock)
2003
1983
for path, ie in old.inventory.iter_entries():
2004
1984
if not tree.has_id(ie.file_id):
2005
1985
self.outf.write(path)
2012
1992
class cmd_modified(Command):
2013
__doc__ = """List files modified in working tree.
1993
"""List files modified in working tree.
2017
1997
_see_also = ['status', 'ls']
2018
takes_options = ['directory', 'null']
2000
help='Write an ascii NUL (\\0) separator '
2001
'between files rather than a newline.')
2020
2004
@display_command
2021
def run(self, null=False, directory=u'.'):
2022
tree = WorkingTree.open_containing(directory)[0]
2005
def run(self, null=False):
2006
tree = WorkingTree.open_containing(u'.')[0]
2023
2007
td = tree.changes_from(tree.basis_tree())
2024
2008
for path, id, kind, text_modified, meta_modified in td.modified:
2031
2015
class cmd_added(Command):
2032
__doc__ = """List files added in working tree.
2016
"""List files added in working tree.
2036
2020
_see_also = ['status', 'ls']
2037
takes_options = ['directory', 'null']
2023
help='Write an ascii NUL (\\0) separator '
2024
'between files rather than a newline.')
2039
2027
@display_command
2040
def run(self, null=False, directory=u'.'):
2041
wt = WorkingTree.open_containing(directory)[0]
2042
self.add_cleanup(wt.lock_read().unlock)
2028
def run(self, null=False):
2029
wt = WorkingTree.open_containing(u'.')[0]
2031
self.add_cleanup(wt.unlock)
2043
2032
basis = wt.basis_tree()
2044
self.add_cleanup(basis.lock_read().unlock)
2034
self.add_cleanup(basis.unlock)
2045
2035
basis_inv = basis.inventory
2046
2036
inv = wt.inventory
2047
2037
for file_id in inv:
2256
2246
help='Show just the specified revision.'
2257
2247
' See also "help revisionspec".'),
2259
RegistryOption('authors',
2260
'What names to list as authors - first, all or committer.',
2262
lazy_registry=('bzrlib.log', 'author_list_registry'),
2264
2249
Option('levels',
2265
2250
short_name='n',
2266
2251
help='Number of levels to display - 0 for all, 1 for flat.',
2336
2310
# find the file ids to log and check for directory filtering
2337
2311
b, file_info_list, rev1, rev2 = _get_info_for_log_files(
2338
revision, file_list, self.add_cleanup)
2312
revision, file_list)
2313
self.add_cleanup(b.unlock)
2339
2314
for relpath, file_id, kind in file_info_list:
2340
2315
if file_id is None:
2341
2316
raise errors.BzrCommandError(
2411
2386
direction=direction, specific_fileids=file_ids,
2412
2387
start_revision=rev1, end_revision=rev2, limit=limit,
2413
2388
message_search=message, delta_type=delta_type,
2414
diff_type=diff_type, _match_using_deltas=match_using_deltas,
2415
exclude_common_ancestry=exclude_common_ancestry,
2389
diff_type=diff_type, _match_using_deltas=match_using_deltas)
2417
2390
Logger(b, rqst).show(lf)
2438
2411
raise errors.BzrCommandError(
2439
2412
"bzr %s doesn't accept two revisions in different"
2440
2413
" branches." % command_name)
2441
if start_spec.spec is None:
2442
# Avoid loading all the history.
2443
rev1 = RevisionInfo(branch, None, None)
2445
rev1 = start_spec.in_history(branch)
2414
rev1 = start_spec.in_history(branch)
2446
2415
# Avoid loading all of history when we know a missing
2447
2416
# end of range means the last revision ...
2448
2417
if end_spec.spec is None:
2490
2459
tree, relpath = WorkingTree.open_containing(filename)
2491
2460
file_id = tree.path2id(relpath)
2492
2461
b = tree.branch
2493
self.add_cleanup(b.lock_read().unlock)
2463
self.add_cleanup(b.unlock)
2494
2464
touching_revs = log.find_touching_revisions(b, file_id)
2495
2465
for revno, revision_id, what in touching_revs:
2496
2466
self.outf.write("%6d %s\n" % (revno, what))
2499
2469
class cmd_ls(Command):
2500
__doc__ = """List files in a tree.
2470
"""List files in a tree.
2503
2473
_see_also = ['status', 'cat']
2509
2479
help='Recurse into subdirectories.'),
2510
2480
Option('from-root',
2511
2481
help='Print paths relative to the root of the branch.'),
2512
Option('unknown', short_name='u',
2513
help='Print unknown files.'),
2482
Option('unknown', help='Print unknown files.'),
2514
2483
Option('versioned', help='Print versioned files.',
2515
2484
short_name='V'),
2516
Option('ignored', short_name='i',
2517
help='Print ignored files.'),
2518
Option('kind', short_name='k',
2485
Option('ignored', help='Print ignored files.'),
2487
help='Write an ascii NUL (\\0) separator '
2488
'between files rather than a newline.'),
2519
2490
help='List entries of a particular kind: file, directory, symlink.',
2525
2494
@display_command
2526
2495
def run(self, revision=None, verbose=False,
2527
2496
recursive=False, from_root=False,
2528
2497
unknown=False, versioned=False, ignored=False,
2529
null=False, kind=None, show_ids=False, path=None, directory=None):
2498
null=False, kind=None, show_ids=False, path=None):
2531
2500
if kind and kind not in ('file', 'directory', 'symlink'):
2532
2501
raise errors.BzrCommandError('invalid kind specified')
2566
2535
view_str = views.view_display_str(view_files)
2567
2536
note("Ignoring files outside view. View is %s" % view_str)
2569
self.add_cleanup(tree.lock_read().unlock)
2539
self.add_cleanup(tree.unlock)
2570
2540
for fp, fc, fkind, fid, entry in tree.list_files(include_root=False,
2571
2541
from_dir=relpath, recursive=recursive):
2572
2542
# Apply additional masking
2616
2586
class cmd_unknowns(Command):
2617
__doc__ = """List unknown files.
2587
"""List unknown files.
2621
2591
_see_also = ['ls']
2622
takes_options = ['directory']
2624
2593
@display_command
2625
def run(self, directory=u'.'):
2626
for f in WorkingTree.open_containing(directory)[0].unknowns():
2595
for f in WorkingTree.open_containing(u'.')[0].unknowns():
2627
2596
self.outf.write(osutils.quotefn(f) + '\n')
2630
2599
class cmd_ignore(Command):
2631
__doc__ = """Ignore specified files or patterns.
2600
"""Ignore specified files or patterns.
2633
2602
See ``bzr help patterns`` for details on the syntax of patterns.
2643
2612
using this command or directly by using an editor, be sure to commit
2646
Bazaar also supports a global ignore file ~/.bazaar/ignore. On Windows
2647
the global ignore file can be found in the application data directory as
2648
C:\\Documents and Settings\\<user>\\Application Data\\Bazaar\\2.0\\ignore.
2649
Global ignores are not touched by this command. The global ignore file
2650
can be edited directly using an editor.
2652
2615
Patterns prefixed with '!' are exceptions to ignore patterns and take
2653
2616
precedence over regular ignores. Such exceptions are used to specify
2654
2617
files that should be versioned which would otherwise be ignored.
2695
2658
_see_also = ['status', 'ignored', 'patterns']
2696
2659
takes_args = ['name_pattern*']
2697
takes_options = ['directory',
2698
Option('default-rules',
2699
help='Display the default ignore rules that bzr uses.')
2661
Option('old-default-rules',
2662
help='Write out the ignore rules bzr < 0.9 always used.')
2702
def run(self, name_pattern_list=None, default_rules=None,
2665
def run(self, name_pattern_list=None, old_default_rules=None):
2704
2666
from bzrlib import ignores
2705
if default_rules is not None:
2706
# dump the default rules and exit
2707
for pattern in ignores.USER_DEFAULTS:
2708
self.outf.write("%s\n" % pattern)
2667
if old_default_rules is not None:
2668
# dump the rules and exit
2669
for pattern in ignores.OLD_DEFAULTS:
2710
2672
if not name_pattern_list:
2711
2673
raise errors.BzrCommandError("ignore requires at least one "
2712
"NAME_PATTERN or --default-rules.")
2674
"NAME_PATTERN or --old-default-rules")
2713
2675
name_pattern_list = [globbing.normalize_pattern(p)
2714
2676
for p in name_pattern_list]
2716
for p in name_pattern_list:
2717
if not globbing.Globster.is_pattern_valid(p):
2718
bad_patterns += ('\n %s' % p)
2720
msg = ('Invalid ignore pattern(s) found. %s' % bad_patterns)
2721
ui.ui_factory.show_error(msg)
2722
raise errors.InvalidPattern('')
2723
2677
for name_pattern in name_pattern_list:
2724
2678
if (name_pattern[0] == '/' or
2725
2679
(len(name_pattern) > 1 and name_pattern[1] == ':')):
2726
2680
raise errors.BzrCommandError(
2727
2681
"NAME_PATTERN should not be an absolute path")
2728
tree, relpath = WorkingTree.open_containing(directory)
2682
tree, relpath = WorkingTree.open_containing(u'.')
2729
2683
ignores.tree_ignores_add_patterns(tree, name_pattern_list)
2730
2684
ignored = globbing.Globster(name_pattern_list)
2732
self.add_cleanup(tree.lock_read().unlock)
2733
2687
for entry in tree.list_files():
2735
2689
if id is not None:
2736
2690
filename = entry[0]
2737
2691
if ignored.match(filename):
2738
matches.append(filename)
2692
matches.append(filename.encode('utf-8'))
2739
2694
if len(matches) > 0:
2740
self.outf.write("Warning: the following files are version controlled and"
2741
" match your ignore pattern:\n%s"
2742
"\nThese files will continue to be version controlled"
2743
" unless you 'bzr remove' them.\n" % ("\n".join(matches),))
2695
print "Warning: the following files are version controlled and" \
2696
" match your ignore pattern:\n%s" \
2697
"\nThese files will continue to be version controlled" \
2698
" unless you 'bzr remove' them." % ("\n".join(matches),)
2746
2701
class cmd_ignored(Command):
2747
__doc__ = """List ignored files and the patterns that matched them.
2702
"""List ignored files and the patterns that matched them.
2749
2704
List all the ignored files and the ignore pattern that caused the file to
2757
2712
encoding_type = 'replace'
2758
2713
_see_also = ['ignore', 'ls']
2759
takes_options = ['directory']
2761
2715
@display_command
2762
def run(self, directory=u'.'):
2763
tree = WorkingTree.open_containing(directory)[0]
2764
self.add_cleanup(tree.lock_read().unlock)
2717
tree = WorkingTree.open_containing(u'.')[0]
2719
self.add_cleanup(tree.unlock)
2765
2720
for path, file_class, kind, file_id, entry in tree.list_files():
2766
2721
if file_class != 'I':
2773
2728
class cmd_lookup_revision(Command):
2774
__doc__ = """Lookup the revision-id from a revision-number
2729
"""Lookup the revision-id from a revision-number
2777
2732
bzr lookup-revision 33
2780
2735
takes_args = ['revno']
2781
takes_options = ['directory']
2783
2737
@display_command
2784
def run(self, revno, directory=u'.'):
2738
def run(self, revno):
2786
2740
revno = int(revno)
2787
2741
except ValueError:
2788
raise errors.BzrCommandError("not a valid revision-number: %r"
2790
revid = WorkingTree.open_containing(directory)[0].branch.get_rev_id(revno)
2791
self.outf.write("%s\n" % revid)
2742
raise errors.BzrCommandError("not a valid revision-number: %r" % revno)
2744
print WorkingTree.open_containing(u'.')[0].branch.get_rev_id(revno)
2794
2747
class cmd_export(Command):
2795
__doc__ = """Export current or past revision to a destination directory or archive.
2748
"""Export current or past revision to a destination directory or archive.
2797
2750
If no revision is specified this exports the last committed revision.
2832
2785
help="Name of the root directory inside the exported file."),
2833
Option('per-file-timestamps',
2834
help='Set modification time of files to that of the last '
2835
'revision in which it was changed.'),
2837
2787
def run(self, dest, branch_or_subdir=None, revision=None, format=None,
2838
root=None, filters=False, per_file_timestamps=False, directory=u'.'):
2788
root=None, filters=False):
2839
2789
from bzrlib.export import export
2841
2791
if branch_or_subdir is None:
2842
tree = WorkingTree.open_containing(directory)[0]
2792
tree = WorkingTree.open_containing(u'.')[0]
2843
2793
b = tree.branch
2849
2799
rev_tree = _get_one_revision_tree('export', revision, branch=b, tree=tree)
2851
export(rev_tree, dest, format, root, subdir, filtered=filters,
2852
per_file_timestamps=per_file_timestamps)
2801
export(rev_tree, dest, format, root, subdir, filtered=filters)
2853
2802
except errors.NoSuchExportFormat, e:
2854
2803
raise errors.BzrCommandError('Unsupported export format: %s' % e.format)
2857
2806
class cmd_cat(Command):
2858
__doc__ = """Write the contents of a file as of a given revision to standard output.
2807
"""Write the contents of a file as of a given revision to standard output.
2860
2809
If no revision is nominated, the last revision is used.
2876
2825
@display_command
2877
2826
def run(self, filename, revision=None, name_from_revision=False,
2878
filters=False, directory=None):
2879
2828
if revision is not None and len(revision) != 1:
2880
2829
raise errors.BzrCommandError("bzr cat --revision takes exactly"
2881
2830
" one revision specifier")
2882
2831
tree, branch, relpath = \
2883
_open_directory_or_containing_tree_or_branch(filename, directory)
2884
self.add_cleanup(branch.lock_read().unlock)
2832
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
2834
self.add_cleanup(branch.unlock)
2885
2835
return self._run(tree, branch, relpath, filename, revision,
2886
2836
name_from_revision, filters)
2941
2892
class cmd_local_time_offset(Command):
2942
__doc__ = """Show the offset in seconds from GMT to local time."""
2893
"""Show the offset in seconds from GMT to local time."""
2944
2895
@display_command
2946
self.outf.write("%s\n" % osutils.local_time_offset())
2897
print osutils.local_time_offset()
2950
2901
class cmd_commit(Command):
2951
__doc__ = """Commit changes into a new revision.
2902
"""Commit changes into a new revision.
2953
2904
An explanatory message needs to be given for each commit. This is
2954
2905
often done by using the --message option (getting the message from the
3148
3099
'(use --file "%(f)s" to take commit message from that file)'
3149
3100
% { 'f': message })
3150
3101
ui.ui_factory.show_warning(warning_msg)
3152
message = message.replace('\r\n', '\n')
3153
message = message.replace('\r', '\n')
3155
raise errors.BzrCommandError(
3156
"please specify either --message or --file")
3158
3103
def get_message(commit_obj):
3159
3104
"""Callback to get commit message"""
3161
f = codecs.open(file, 'rt', osutils.get_user_encoding())
3163
my_message = f.read()
3166
elif message is not None:
3167
my_message = message
3169
# No message supplied: make one up.
3170
# text is the status of the tree
3171
text = make_commit_message_template_encoded(tree,
3105
my_message = message
3106
if my_message is not None and '\r' in my_message:
3107
my_message = my_message.replace('\r\n', '\n')
3108
my_message = my_message.replace('\r', '\n')
3109
if my_message is None and not file:
3110
t = make_commit_message_template_encoded(tree,
3172
3111
selected_list, diff=show_diff,
3173
3112
output_encoding=osutils.get_user_encoding())
3174
# start_message is the template generated from hooks
3175
# XXX: Warning - looks like hooks return unicode,
3176
# make_commit_message_template_encoded returns user encoding.
3177
# We probably want to be using edit_commit_message instead to
3179
3113
start_message = generate_commit_message_template(commit_obj)
3180
my_message = edit_commit_message_encoded(text,
3114
my_message = edit_commit_message_encoded(t,
3181
3115
start_message=start_message)
3182
3116
if my_message is None:
3183
3117
raise errors.BzrCommandError("please specify a commit"
3184
3118
" message with either --message or --file")
3119
elif my_message and file:
3120
raise errors.BzrCommandError(
3121
"please specify either --message or --file")
3123
my_message = codecs.open(file, 'rt',
3124
osutils.get_user_encoding()).read()
3185
3125
if my_message == "":
3186
3126
raise errors.BzrCommandError("empty commit message specified")
3187
3127
return my_message
3209
3151
raise errors.BzrCommandError("Commit refused because there are"
3210
3152
" unknown files in the working tree.")
3211
3153
except errors.BoundBranchOutOfDate, e:
3212
e.extra_help = ("\n"
3213
'To commit to master branch, run update and then commit.\n'
3214
'You can also pass --local to commit to continue working '
3154
raise errors.BzrCommandError(str(e) + "\n"
3155
'To commit to master branch, run update and then commit.\n'
3156
'You can also pass --local to commit to continue working '
3219
3160
class cmd_check(Command):
3220
__doc__ = """Validate working tree structure, branch consistency and repository history.
3161
"""Validate working tree structure, branch consistency and repository history.
3222
3163
This command checks various invariants about branch and repository storage
3223
3164
to detect data corruption or bzr bugs.
3333
3273
encoding_type = 'replace'
3335
3275
@display_command
3336
def run(self, email=False, branch=False, name=None, directory=None):
3276
def run(self, email=False, branch=False, name=None):
3337
3277
if name is None:
3338
if directory is None:
3339
# use branch if we're inside one; otherwise global config
3341
c = Branch.open_containing(u'.')[0].get_config()
3342
except errors.NotBranchError:
3343
c = config.GlobalConfig()
3345
c = Branch.open(directory).get_config()
3278
# use branch if we're inside one; otherwise global config
3280
c = Branch.open_containing('.')[0].get_config()
3281
except errors.NotBranchError:
3282
c = config.GlobalConfig()
3347
3284
self.outf.write(c.user_email() + '\n')
3359
3296
# use global config unless --branch given
3361
if directory is None:
3362
c = Branch.open_containing(u'.')[0].get_config()
3364
c = Branch.open(directory).get_config()
3298
c = Branch.open_containing('.')[0].get_config()
3366
3300
c = config.GlobalConfig()
3367
3301
c.set_user_option('email', name)
3370
3304
class cmd_nick(Command):
3371
__doc__ = """Print or set the branch nickname.
3305
"""Print or set the branch nickname.
3373
3307
If unset, the tree root directory name is used as the nickname.
3374
3308
To print the current nickname, execute with no argument.
3537
3470
'throughout the test suite.',
3538
3471
type=get_transport_type),
3539
3472
Option('benchmark',
3540
help='Run the benchmarks rather than selftests.',
3473
help='Run the benchmarks rather than selftests.'),
3542
3474
Option('lsprof-timed',
3543
3475
help='Generate lsprof output for benchmarked'
3544
3476
' sections of code.'),
3545
3477
Option('lsprof-tests',
3546
3478
help='Generate lsprof output for each test.'),
3479
Option('cache-dir', type=str,
3480
help='Cache intermediate benchmark output in this '
3547
3482
Option('first',
3548
3483
help='Run all tests, but run specified tests first.',
3549
3484
short_name='f',
3584
3519
def run(self, testspecs_list=None, verbose=False, one=False,
3585
3520
transport=None, benchmark=None,
3521
lsprof_timed=None, cache_dir=None,
3587
3522
first=False, list_only=False,
3588
3523
randomize=None, exclude=None, strict=False,
3589
3524
load_list=None, debugflag=None, starting_with=None, subunit=False,
3590
3525
parallel=None, lsprof_tests=False):
3591
3526
from bzrlib.tests import selftest
3527
import bzrlib.benchmarks as benchmarks
3528
from bzrlib.benchmarks import tree_creator
3593
3530
# Make deprecation warnings visible, unless -Werror is set
3594
3531
symbol_versioning.activate_deprecation_warnings(override=False)
3533
if cache_dir is not None:
3534
tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
3596
3535
if testspecs_list is not None:
3597
3536
pattern = '|'.join(testspecs_list)
3604
3543
raise errors.BzrCommandError("subunit not available. subunit "
3605
3544
"needs to be installed to use --subunit.")
3606
3545
self.additional_selftest_args['runner_class'] = SubUnitBzrRunner
3607
# On Windows, disable automatic conversion of '\n' to '\r\n' in
3608
# stdout, which would corrupt the subunit stream.
3609
# FIXME: This has been fixed in subunit trunk (>0.0.5) so the
3610
# following code can be deleted when it's sufficiently deployed
3611
# -- vila/mgz 20100514
3612
if (sys.platform == "win32"
3613
and getattr(sys.stdout, 'fileno', None) is not None):
3615
msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
3617
3547
self.additional_selftest_args.setdefault(
3618
3548
'suite_decorators', []).append(parallel)
3620
raise errors.BzrCommandError(
3621
"--benchmark is no longer supported from bzr 2.2; "
3622
"use bzr-usertest instead")
3623
test_suite_factory = None
3550
test_suite_factory = benchmarks.test_suite
3551
# Unless user explicitly asks for quiet, be verbose in benchmarks
3552
verbose = not is_quiet()
3553
# TODO: should possibly lock the history file...
3554
benchfile = open(".perf_history", "at", buffering=1)
3555
self.add_cleanup(benchfile.close)
3557
test_suite_factory = None
3624
3559
selftest_kwargs = {"verbose": verbose,
3625
3560
"pattern": pattern,
3626
3561
"stop_on_failure": one,
3662
3598
class cmd_rocks(Command):
3663
__doc__ = """Statement of optimism."""
3599
"""Statement of optimism."""
3667
3603
@display_command
3669
self.outf.write("It sure does!\n")
3605
print "It sure does!"
3672
3608
class cmd_find_merge_base(Command):
3673
__doc__ = """Find and print a base revision for merging two branches."""
3609
"""Find and print a base revision for merging two branches."""
3674
3610
# TODO: Options to specify revisions on either side, as if
3675
3611
# merging only part of the history.
3676
3612
takes_args = ['branch', 'other']
3683
3619
branch1 = Branch.open_containing(branch)[0]
3684
3620
branch2 = Branch.open_containing(other)[0]
3685
self.add_cleanup(branch1.lock_read().unlock)
3686
self.add_cleanup(branch2.lock_read().unlock)
3622
self.add_cleanup(branch1.unlock)
3624
self.add_cleanup(branch2.unlock)
3687
3625
last1 = ensure_null(branch1.last_revision())
3688
3626
last2 = ensure_null(branch2.last_revision())
3690
3628
graph = branch1.repository.get_graph(branch2.repository)
3691
3629
base_rev_id = graph.find_unique_lca(last1, last2)
3693
self.outf.write('merge base is revision %s\n' % base_rev_id)
3631
print 'merge base is revision %s' % base_rev_id
3696
3634
class cmd_merge(Command):
3697
__doc__ = """Perform a three-way merge.
3635
"""Perform a three-way merge.
3699
3637
The source of the merge can be specified either in the form of a branch,
3700
3638
or in the form of a path to a file containing a merge directive generated
3783
3721
' completely merged into the source, pull from the'
3784
3722
' source rather than merging. When this happens,'
3785
3723
' you do not need to commit the result.'),
3786
custom_help('directory',
3787
3725
help='Branch to merge into, '
3788
'rather than the one containing the working directory.'),
3726
'rather than the one containing the working directory.',
3789
3730
Option('preview', help='Instead of merging, show a diff of the'
3791
3732
Option('interactive', help='Select changes interactively.',
3891
3833
def _do_preview(self, merger):
3892
3834
from bzrlib.diff import show_diff_trees
3893
3835
result_tree = self._get_preview(merger)
3894
path_encoding = osutils.get_diff_header_encoding()
3895
3836
show_diff_trees(merger.this_tree, result_tree, self.outf,
3896
old_label='', new_label='',
3897
path_encoding=path_encoding)
3837
old_label='', new_label='')
3899
3839
def _do_merge(self, merger, change_reporter, allow_pending, verified):
3900
3840
merger.change_reporter = change_reporter
4085
4025
def run(self, file_list=None, merge_type=None, show_base=False,
4086
4026
reprocess=False):
4087
from bzrlib.conflicts import restore
4088
4027
if merge_type is None:
4089
4028
merge_type = _mod_merge.Merge3Merger
4090
4029
tree, file_list = tree_files(file_list)
4091
self.add_cleanup(tree.lock_write().unlock)
4031
self.add_cleanup(tree.unlock)
4092
4032
parents = tree.get_parent_ids()
4093
4033
if len(parents) != 2:
4094
4034
raise errors.BzrCommandError("Sorry, remerge only works after normal"
4327
4267
theirs_only=False,
4328
4268
log_format=None, long=False, short=False, line=False,
4329
4269
show_ids=False, verbose=False, this=False, other=False,
4330
include_merges=False, revision=None, my_revision=None,
4270
include_merges=False, revision=None, my_revision=None):
4332
4271
from bzrlib.missing import find_unmerged, iter_log_revisions
4333
4272
def message(s):
4334
4273
if not is_quiet():
4364
4301
remote_branch = Branch.open(other_branch)
4365
4302
if remote_branch.base == local_branch.base:
4366
4303
remote_branch = local_branch
4368
self.add_cleanup(remote_branch.lock_read().unlock)
4305
local_branch.lock_read()
4306
self.add_cleanup(local_branch.unlock)
4370
4307
local_revid_range = _revision_range_to_revid_range(
4371
4308
_get_revision_range(my_revision, local_branch,
4311
remote_branch.lock_read()
4312
self.add_cleanup(remote_branch.unlock)
4374
4313
remote_revid_range = _revision_range_to_revid_range(
4375
4314
_get_revision_range(revision,
4376
4315
remote_branch, self.name()))
4436
4376
class cmd_pack(Command):
4437
__doc__ = """Compress the data within a repository.
4439
This operation compresses the data within a bazaar repository. As
4440
bazaar supports automatic packing of repository, this operation is
4441
normally not required to be done manually.
4443
During the pack operation, bazaar takes a backup of existing repository
4444
data, i.e. pack files. This backup is eventually removed by bazaar
4445
automatically when it is safe to do so. To save disk space by removing
4446
the backed up pack files, the --clean-obsolete-packs option may be
4449
Warning: If you use --clean-obsolete-packs and your machine crashes
4450
during or immediately after repacking, you may be left with a state
4451
where the deletion has been written to disk but the new packs have not
4452
been. In this case the repository may be unusable.
4377
"""Compress the data within a repository."""
4455
4379
_see_also = ['repositories']
4456
4380
takes_args = ['branch_or_repo?']
4458
Option('clean-obsolete-packs', 'Delete obsolete packs to save disk space.'),
4461
def run(self, branch_or_repo='.', clean_obsolete_packs=False):
4382
def run(self, branch_or_repo='.'):
4462
4383
dir = bzrdir.BzrDir.open_containing(branch_or_repo)[0]
4464
4385
branch = dir.open_branch()
4465
4386
repository = branch.repository
4466
4387
except errors.NotBranchError:
4467
4388
repository = dir.open_repository()
4468
repository.pack(clean_obsolete_packs=clean_obsolete_packs)
4471
4392
class cmd_plugins(Command):
4472
__doc__ = """List the installed plugins.
4393
"""List the installed plugins.
4474
4395
This command displays the list of installed plugins including
4475
4396
version of plugin and a short description of each.
4506
4427
doc = '(no description)'
4507
4428
result.append((name_ver, doc, plugin.path()))
4508
4429
for name_ver, doc, path in sorted(result):
4509
self.outf.write("%s\n" % name_ver)
4510
self.outf.write(" %s\n" % doc)
4512
self.outf.write(" %s\n" % path)
4513
self.outf.write("\n")
4516
4437
class cmd_testament(Command):
4517
__doc__ = """Show testament (signing-form) of a revision."""
4438
"""Show testament (signing-form) of a revision."""
4518
4439
takes_options = [
4520
4441
Option('long', help='Produce long-format testament.'),
4562
4484
Option('long', help='Show commit date in annotations.'),
4567
4488
encoding_type = 'exact'
4569
4490
@display_command
4570
4491
def run(self, filename, all=False, long=False, revision=None,
4571
show_ids=False, directory=None):
4572
4493
from bzrlib.annotate import annotate_file, annotate_file_tree
4573
4494
wt, branch, relpath = \
4574
_open_directory_or_containing_tree_or_branch(filename, directory)
4495
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
4575
4496
if wt is not None:
4576
self.add_cleanup(wt.lock_read().unlock)
4498
self.add_cleanup(wt.unlock)
4578
self.add_cleanup(branch.lock_read().unlock)
4501
self.add_cleanup(branch.unlock)
4579
4502
tree = _get_one_revision_tree('annotate', revision, branch=branch)
4580
self.add_cleanup(tree.lock_read().unlock)
4504
self.add_cleanup(tree.unlock)
4581
4505
if wt is not None:
4582
4506
file_id = wt.path2id(relpath)
4598
4522
class cmd_re_sign(Command):
4599
__doc__ = """Create a digital signature for an existing revision."""
4523
"""Create a digital signature for an existing revision."""
4600
4524
# TODO be able to replace existing ones.
4602
4526
hidden = True # is this right ?
4603
4527
takes_args = ['revision_id*']
4604
takes_options = ['directory', 'revision']
4528
takes_options = ['revision']
4606
def run(self, revision_id_list=None, revision=None, directory=u'.'):
4530
def run(self, revision_id_list=None, revision=None):
4607
4531
if revision_id_list is not None and revision is not None:
4608
4532
raise errors.BzrCommandError('You can only supply one of revision_id or --revision')
4609
4533
if revision_id_list is None and revision is None:
4610
4534
raise errors.BzrCommandError('You must supply either --revision or a revision_id')
4611
b = WorkingTree.open_containing(directory)[0].branch
4612
self.add_cleanup(b.lock_write().unlock)
4535
b = WorkingTree.open_containing(u'.')[0].branch
4537
self.add_cleanup(b.unlock)
4613
4538
return self._run(b, revision_id_list, revision)
4615
4540
def _run(self, b, revision_id_list, revision):
4675
4599
_see_also = ['checkouts', 'unbind']
4676
4600
takes_args = ['location?']
4677
takes_options = ['directory']
4679
def run(self, location=None, directory=u'.'):
4680
b, relpath = Branch.open_containing(directory)
4603
def run(self, location=None):
4604
b, relpath = Branch.open_containing(u'.')
4681
4605
if location is None:
4683
4607
location = b.get_old_bound_location()
4711
4635
_see_also = ['checkouts', 'bind']
4712
4636
takes_args = []
4713
takes_options = ['directory']
4715
def run(self, directory=u'.'):
4716
b, relpath = Branch.open_containing(directory)
4640
b, relpath = Branch.open_containing(u'.')
4717
4641
if not b.unbind():
4718
4642
raise errors.BzrCommandError('Local branch is not bound')
4721
4645
class cmd_uncommit(Command):
4722
__doc__ = """Remove the last committed revision.
4646
"""Remove the last committed revision.
4724
4648
--verbose will print out what is being removed.
4725
4649
--dry-run will go through all the motions, but not actually
4765
4689
b = control.open_branch()
4767
4691
if tree is not None:
4768
self.add_cleanup(tree.lock_write().unlock)
4693
self.add_cleanup(tree.unlock)
4770
self.add_cleanup(b.lock_write().unlock)
4696
self.add_cleanup(b.unlock)
4771
4697
return self._run(b, tree, dry_run, verbose, revision, force, local=local)
4773
4699
def _run(self, b, tree, dry_run, verbose, revision, force, local=False):
4806
4733
end_revision=last_revno)
4809
self.outf.write('Dry-run, pretending to remove'
4810
' the above revisions.\n')
4736
ui.ui_factory.note('Dry-run, pretending to remove the above revisions.')
4812
self.outf.write('The above revision(s) will be removed.\n')
4738
ui.ui_factory.note('The above revision(s) will be removed.')
4815
if not ui.ui_factory.get_boolean('Are you sure'):
4816
self.outf.write('Canceled')
4741
if not ui.ui_factory.get_boolean('Are you sure [y/N]? '):
4742
ui.ui_factory.note('Canceled')
4819
4745
mutter('Uncommitting from {%s} to {%s}',
4820
4746
last_rev_id, rev_id)
4821
4747
uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
4822
4748
revno=revno, local=local)
4823
self.outf.write('You can restore the old tip by running:\n'
4824
' bzr pull . -r revid:%s\n' % last_rev_id)
4749
ui.ui_factory.note('You can restore the old tip by running:\n'
4750
' bzr pull . -r revid:%s' % last_rev_id)
4827
4753
class cmd_break_lock(Command):
4828
__doc__ = """Break a dead lock on a repository, branch or working directory.
4754
"""Break a dead lock on a repository, branch or working directory.
4830
4756
CAUTION: Locks should only be broken when you are sure that the process
4831
4757
holding the lock has been stopped.
4916
4843
def run(self, port=None, inet=False, directory=None, allow_writes=False,
4917
4844
protocol=None):
4918
from bzrlib import transport
4845
from bzrlib.transport import get_transport, transport_server_registry
4919
4846
if directory is None:
4920
4847
directory = os.getcwd()
4921
4848
if protocol is None:
4922
protocol = transport.transport_server_registry.get()
4849
protocol = transport_server_registry.get()
4923
4850
host, port = self.get_host_and_port(port)
4924
4851
url = urlutils.local_path_to_url(directory)
4925
4852
if not allow_writes:
4926
4853
url = 'readonly+' + url
4927
t = transport.get_transport(url)
4928
protocol(t, host, port, inet)
4854
transport = get_transport(url)
4855
protocol(transport, host, port, inet)
4931
4858
class cmd_join(Command):
4932
__doc__ = """Combine a tree into its containing tree.
4859
"""Combine a tree into its containing tree.
4934
4861
This command requires the target tree to be in a rich-root format.
5043
4969
encoding_type = 'exact'
5045
4971
def run(self, submit_branch=None, public_branch=None, patch_type='bundle',
5046
sign=False, revision=None, mail_to=None, message=None,
4972
sign=False, revision=None, mail_to=None, message=None):
5048
4973
from bzrlib.revision import ensure_null, NULL_REVISION
5049
4974
include_patch, include_bundle = {
5050
4975
'plain': (False, False),
5051
4976
'diff': (True, False),
5052
4977
'bundle': (True, True),
5054
branch = Branch.open(directory)
4979
branch = Branch.open('.')
5055
4980
stored_submit_branch = branch.get_submit_branch()
5056
4981
if submit_branch is None:
5057
4982
submit_branch = stored_submit_branch
5307
5232
To rename a tag (change the name but keep it on the same revsion), run ``bzr
5308
5233
tag new-name -r tag:old-name`` and then ``bzr tag --delete oldname``.
5310
If no tag name is specified it will be determined through the
5311
'automatic_tag_name' hook. This can e.g. be used to automatically tag
5312
upstream releases by reading configure.ac. See ``bzr help hooks`` for
5316
5236
_see_also = ['commit', 'tags']
5317
takes_args = ['tag_name?']
5237
takes_args = ['tag_name']
5318
5238
takes_options = [
5319
5239
Option('delete',
5320
5240
help='Delete this tag rather than placing it.',
5322
custom_help('directory',
5323
help='Branch in which to place the tag.'),
5243
help='Branch in which to place the tag.',
5324
5247
Option('force',
5325
5248
help='Replace existing tags.',
5330
def run(self, tag_name=None,
5253
def run(self, tag_name,
5336
5259
branch, relpath = Branch.open_containing(directory)
5337
self.add_cleanup(branch.lock_write().unlock)
5261
self.add_cleanup(branch.unlock)
5339
if tag_name is None:
5340
raise errors.BzrCommandError("No tag specified to delete.")
5341
5263
branch.tags.delete_tag(tag_name)
5342
5264
self.outf.write('Deleted tag %s.\n' % tag_name)
5557
5477
def run(self, to_location=None, force=False, create_branch=False,
5558
revision=None, directory=u'.'):
5559
5479
from bzrlib import switch
5560
tree_location = directory
5561
5481
revision = _get_one_revision('switch', revision)
5562
5482
control_dir = bzrdir.BzrDir.open_containing(tree_location)[0]
5563
5483
if to_location is None:
5564
5484
if revision is None:
5565
5485
raise errors.BzrCommandError('You must supply either a'
5566
5486
' revision or a location')
5567
to_location = tree_location
5569
5489
branch = control_dir.open_branch()
5570
5490
had_explicit_nick = branch.get_config().has_explicit_nickname()
5792
5712
self.outf.write(" <no hooks installed>\n")
5795
class cmd_remove_branch(Command):
5796
__doc__ = """Remove a branch.
5798
This will remove the branch from the specified location but
5799
will keep any working tree or repository in place.
5803
Remove the branch at repo/trunk::
5805
bzr remove-branch repo/trunk
5809
takes_args = ["location?"]
5811
aliases = ["rmbranch"]
5813
def run(self, location=None):
5814
if location is None:
5816
branch = Branch.open_containing(location)[0]
5817
branch.bzrdir.destroy_branch()
5820
5715
class cmd_shelve(Command):
5821
__doc__ = """Temporarily set aside some changes from the current tree.
5716
"""Temporarily set aside some changes from the current tree.
5823
5718
Shelve allows you to temporarily put changes you've made "on the shelf",
5824
5719
ie. out of the way, until a later time when you can bring them back from
5860
5754
_see_also = ['unshelve']
5862
5756
def run(self, revision=None, all=False, file_list=None, message=None,
5863
writer=None, list=False, destroy=False, directory=u'.'):
5757
writer=None, list=False, destroy=False):
5865
5759
return self.run_for_list()
5866
5760
from bzrlib.shelf_ui import Shelver
5941
5835
To check what clean-tree will do, use --dry-run.
5943
takes_options = ['directory',
5944
Option('ignored', help='Delete all ignored files.'),
5837
takes_options = [Option('ignored', help='Delete all ignored files.'),
5945
5838
Option('detritus', help='Delete conflict files, merge'
5946
5839
' backups, and failed selftest dirs.'),
5947
5840
Option('unknown',
5950
5843
' deleting them.'),
5951
5844
Option('force', help='Do not prompt before deleting.')]
5952
5845
def run(self, unknown=False, ignored=False, detritus=False, dry_run=False,
5953
force=False, directory=u'.'):
5954
5847
from bzrlib.clean_tree import clean_tree
5955
5848
if not (unknown or ignored or detritus):
5959
clean_tree(directory, unknown=unknown, ignored=ignored,
5960
detritus=detritus, dry_run=dry_run, no_prompt=force)
5852
clean_tree('.', unknown=unknown, ignored=ignored, detritus=detritus,
5853
dry_run=dry_run, no_prompt=force)
5963
5856
class cmd_reference(Command):
5964
__doc__ = """list, view and set branch locations for nested trees.
5857
"""list, view and set branch locations for nested trees.
5966
5859
If no arguments are provided, lists the branch locations for nested trees.
5967
5860
If one argument is provided, display the branch location for that tree.
6007
5900
self.outf.write('%s %s\n' % (path, location))
6010
def _register_lazy_builtins():
6011
# register lazy builtins from other modules; called at startup and should
6012
# be only called once.
6013
for (name, aliases, module_name) in [
6014
('cmd_bundle_info', [], 'bzrlib.bundle.commands'),
6015
('cmd_dpush', [], 'bzrlib.foreign'),
6016
('cmd_version_info', [], 'bzrlib.cmd_version_info'),
6017
('cmd_resolve', ['resolved'], 'bzrlib.conflicts'),
6018
('cmd_conflicts', [], 'bzrlib.conflicts'),
6019
('cmd_sign_my_commits', [], 'bzrlib.sign_my_commits'),
6021
builtin_command_registry.register_lazy(name, aliases, module_name)
5903
# these get imported and then picked up by the scan for cmd_*
5904
# TODO: Some more consistent way to split command definitions across files;
5905
# we do need to load at least some information about them to know of
5906
# aliases. ideally we would avoid loading the implementation until the
5907
# details were needed.
5908
from bzrlib.cmd_version_info import cmd_version_info
5909
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore
5910
from bzrlib.bundle.commands import (
5913
from bzrlib.foreign import cmd_dpush
5914
from bzrlib.sign_my_commits import cmd_sign_my_commits