60
60
from bzrlib.workingtree import WorkingTree
63
from bzrlib.commands import (
65
builtin_command_registry,
63
from bzrlib.commands import Command, display_command
68
64
from bzrlib.option import (
334
330
class cmd_cat_revision(Command):
335
__doc__ = """Write out metadata for a revision.
331
"""Write out metadata for a revision.
337
333
The revision to print can either be specified by a specific
338
334
revision identifier, or you can use --revision.
392
388
class cmd_dump_btree(Command):
393
__doc__ = """Dump the contents of a btree index file to stdout.
389
"""Dump the contents of a btree index file to stdout.
395
391
PATH is a btree index file, it can be any URL. This includes things like
396
392
.bzr/repository/pack-names, or .bzr/repository/indices/a34b3a...ca4a4.iix
460
456
for node in bt.iter_all_entries():
461
457
# Node is made up of:
462
458
# (index, key, value, [references])
466
refs_as_tuples = None
468
refs_as_tuples = static_tuple.as_tuples(refs)
459
refs_as_tuples = static_tuple.as_tuples(node[3])
469
460
as_tuple = (tuple(node[1]), node[2], refs_as_tuples)
470
461
self.outf.write('%s\n' % (as_tuple,))
473
464
class cmd_remove_tree(Command):
474
__doc__ = """Remove the working tree from a given branch/checkout.
465
"""Remove the working tree from a given branch/checkout.
476
467
Since a lightweight checkout is little more than a working tree
477
468
this will refuse to run against one.
504
495
if (working.has_changes()):
505
496
raise errors.UncommittedChanges(working)
507
if working.user_url != working.branch.user_url:
498
working_path = working.bzrdir.root_transport.base
499
branch_path = working.branch.bzrdir.root_transport.base
500
if working_path != branch_path:
508
501
raise errors.BzrCommandError("You cannot remove the working tree"
509
502
" from a lightweight checkout")
530
523
wt = WorkingTree.open_containing(location)[0]
531
self.add_cleanup(wt.lock_read().unlock)
532
525
except (errors.NoWorkingTree, errors.NotLocalUrl):
533
526
raise errors.NoWorkingTree(location)
527
self.add_cleanup(wt.unlock)
534
528
revid = wt.last_revision()
536
530
revno_t = wt.branch.revision_id_to_dotted_revno(revid)
539
533
revno = ".".join(str(n) for n in revno_t)
541
535
b = Branch.open_containing(location)[0]
542
self.add_cleanup(b.lock_read().unlock)
537
self.add_cleanup(b.unlock)
543
538
revno = b.revno()
544
539
self.cleanup_now()
545
540
self.outf.write(str(revno) + '\n')
548
543
class cmd_revision_info(Command):
549
__doc__ = """Show revision number and revision id for a given revision identifier.
544
"""Show revision number and revision id for a given revision identifier.
552
547
takes_args = ['revision_info*']
569
564
wt = WorkingTree.open_containing(directory)[0]
571
self.add_cleanup(wt.lock_read().unlock)
567
self.add_cleanup(wt.unlock)
572
568
except (errors.NoWorkingTree, errors.NotLocalUrl):
574
570
b = Branch.open_containing(directory)[0]
575
self.add_cleanup(b.lock_read().unlock)
572
self.add_cleanup(b.unlock)
576
573
revision_ids = []
577
574
if revision is not None:
578
575
revision_ids.extend(rev.as_revision_id(b) for rev in revision)
677
674
should_print=(not is_quiet()))
680
self.add_cleanup(base_tree.lock_read().unlock)
677
base_tree.lock_read()
678
self.add_cleanup(base_tree.unlock)
681
679
tree, file_list = tree_files_for_add(file_list)
682
680
added, ignored = tree.smart_add(file_list, not
683
681
no_recurse, action=action, save=not dry_run)
702
700
def run(self, dir_list):
703
701
for d in dir_list:
704
703
wt, dd = WorkingTree.open_containing(d)
705
base = os.path.dirname(dd)
706
id = wt.path2id(base)
710
self.outf.write('added %s\n' % d)
712
raise errors.NotVersionedError(path=base)
705
self.outf.write('added %s\n' % d)
715
708
class cmd_relpath(Command):
716
__doc__ = """Show path of a file relative to root"""
709
"""Show path of a file relative to root"""
718
711
takes_args = ['filename']
756
749
revision = _get_one_revision('inventory', revision)
757
750
work_tree, file_list = tree_files(file_list)
758
self.add_cleanup(work_tree.lock_read().unlock)
751
work_tree.lock_read()
752
self.add_cleanup(work_tree.unlock)
759
753
if revision is not None:
760
754
tree = revision.as_tree(work_tree.branch)
762
756
extra_trees = [work_tree]
763
self.add_cleanup(tree.lock_read().unlock)
758
self.add_cleanup(tree.unlock)
826
821
if len(names_list) < 2:
827
822
raise errors.BzrCommandError("missing file argument")
828
823
tree, rel_names = tree_files(names_list, canonicalize=False)
829
self.add_cleanup(tree.lock_tree_write().unlock)
824
tree.lock_tree_write()
825
self.add_cleanup(tree.unlock)
830
826
self._run(tree, names_list, rel_names, after)
832
828
def run_auto(self, names_list, after, dry_run):
837
833
raise errors.BzrCommandError('--after cannot be specified with'
839
835
work_tree, file_list = tree_files(names_list, default_branch='.')
840
self.add_cleanup(work_tree.lock_tree_write().unlock)
836
work_tree.lock_tree_write()
837
self.add_cleanup(work_tree.unlock)
841
838
rename_map.RenameMap.guess_renames(work_tree, dry_run)
843
840
def _run(self, tree, names_list, rel_names, after):
978
975
tree_to = WorkingTree.open_containing(directory)[0]
979
976
branch_to = tree_to.branch
980
self.add_cleanup(tree_to.lock_write().unlock)
981
977
except errors.NoWorkingTree:
983
979
branch_to = Branch.open_containing(directory)[0]
984
self.add_cleanup(branch_to.lock_write().unlock)
986
981
if local and not branch_to.get_bound_location():
987
982
raise errors.LocalRequiresBoundBranch()
1019
1014
branch_from = Branch.open(location,
1020
1015
possible_transports=possible_transports)
1021
self.add_cleanup(branch_from.lock_read().unlock)
1023
1017
if branch_to.get_parent() is None or remember:
1024
1018
branch_to.set_parent(branch_from.base)
1020
if branch_from is not branch_to:
1021
branch_from.lock_read()
1022
self.add_cleanup(branch_from.unlock)
1026
1023
if revision is not None:
1027
1024
revision_id = revision.as_revision_id(branch_from)
1026
branch_to.lock_write()
1027
self.add_cleanup(branch_to.unlock)
1029
1028
if tree_to is not None:
1030
1029
view_info = _get_view_info_for_change_reporter(tree_to)
1031
1030
change_reporter = delta._ChangeReporter(
1113
1112
# Get the source branch
1114
1113
(tree, br_from,
1115
1114
_unused) = bzrdir.BzrDir.open_containing_tree_or_branch(directory)
1116
strict = br_from.get_config().get_user_option_as_bool('push_strict')
1117
if strict is None: strict = True # default value
1116
1118
# Get the tip's revision_id
1117
1119
revision = _get_one_revision('push', revision)
1118
1120
if revision is not None:
1119
1121
revision_id = revision.in_history(br_from).rev_id
1121
1123
revision_id = None
1122
if tree is not None and revision_id is None:
1123
tree.check_changed_or_out_of_date(
1124
strict, 'push_strict',
1125
more_error='Use --no-strict to force the push.',
1126
more_warning='Uncommitted changes will not be pushed.')
1124
if strict and tree is not None and revision_id is None:
1125
if (tree.has_changes()):
1126
raise errors.UncommittedChanges(
1127
tree, more='Use --no-strict to force the push.')
1128
if tree.last_revision() != tree.branch.last_revision():
1129
# The tree has lost sync with its branch, there is little
1130
# chance that the user is aware of it but he can still force
1131
# the push with --no-strict
1132
raise errors.OutOfDateTree(
1133
tree, more='Use --no-strict to force the push.')
1127
1135
# Get the stacked_on branch, if any
1128
1136
if stacked_on is not None:
1129
1137
stacked_on = urlutils.normalize_url(stacked_on)
1163
1171
class cmd_branch(Command):
1164
__doc__ = """Create a new branch that is a copy of an existing branch.
1172
"""Create a new branch that is a copy of an existing branch.
1166
1174
If the TO_LOCATION is omitted, the last component of the FROM_LOCATION will
1167
1175
be used. In other words, "branch ../foo/bar" will attempt to create ./bar.
1207
1215
accelerator_tree, br_from = bzrdir.BzrDir.open_tree_or_branch(
1209
1217
revision = _get_one_revision('branch', revision)
1210
self.add_cleanup(br_from.lock_read().unlock)
1219
self.add_cleanup(br_from.unlock)
1211
1220
if revision is not None:
1212
1221
revision_id = revision.as_revision_id(br_from)
1275
1284
class cmd_checkout(Command):
1276
__doc__ = """Create a new checkout of an existing branch.
1285
"""Create a new checkout of an existing branch.
1278
1287
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
1279
1288
the branch found in '.'. This is useful if you have removed the working tree
1353
1362
@display_command
1354
1363
def run(self, dir=u'.'):
1355
1364
tree = WorkingTree.open_containing(dir)[0]
1356
self.add_cleanup(tree.lock_read().unlock)
1366
self.add_cleanup(tree.unlock)
1357
1367
new_inv = tree.inventory
1358
1368
old_tree = tree.basis_tree()
1359
self.add_cleanup(old_tree.lock_read().unlock)
1369
old_tree.lock_read()
1370
self.add_cleanup(old_tree.unlock)
1360
1371
old_inv = old_tree.inventory
1362
1373
iterator = tree.iter_changes(old_tree, include_unchanged=True)
1374
1385
class cmd_update(Command):
1375
__doc__ = """Update a tree to have the latest code committed to its branch.
1386
"""Update a tree to have the latest code committed to its branch.
1377
1388
This will perform a merge into the working tree, and may generate
1378
1389
conflicts. If you have any local changes, you will still
1400
1411
master = branch.get_master_branch(
1401
1412
possible_transports=possible_transports)
1402
1413
if master is not None:
1403
1415
branch_location = master.base
1417
tree.lock_tree_write()
1406
1418
branch_location = tree.branch.base
1407
tree.lock_tree_write()
1408
1419
self.add_cleanup(tree.unlock)
1409
1420
# get rid of the final '/' and be ready for display
1410
branch_location = urlutils.unescape_for_display(
1411
branch_location.rstrip('/'),
1421
branch_location = urlutils.unescape_for_display(branch_location[:-1],
1413
1423
existing_pending_merges = tree.get_parent_ids()[1:]
1414
1424
if master is None:
1424
1434
revision_id = branch.last_revision()
1425
1435
if revision_id == _mod_revision.ensure_null(tree.last_revision()):
1426
revno = branch.revision_id_to_dotted_revno(revision_id)
1427
note("Tree is up to date at revision %s of branch %s" %
1428
('.'.join(map(str, revno)), branch_location))
1436
revno = branch.revision_id_to_revno(revision_id)
1437
note("Tree is up to date at revision %d of branch %s" %
1438
(revno, branch_location))
1430
1440
view_info = _get_view_info_for_change_reporter(tree)
1431
1441
change_reporter = delta._ChangeReporter(
1443
1453
"bzr update --revision only works"
1444
1454
" for a revision in the branch history"
1445
1455
% (e.revision))
1446
revno = tree.branch.revision_id_to_dotted_revno(
1456
revno = tree.branch.revision_id_to_revno(
1447
1457
_mod_revision.ensure_null(tree.last_revision()))
1448
note('Updated to revision %s of branch %s' %
1449
('.'.join(map(str, revno)), branch_location))
1450
parent_ids = tree.get_parent_ids()
1451
if parent_ids[1:] and parent_ids[1:] != existing_pending_merges:
1458
note('Updated to revision %d of branch %s' %
1459
(revno, branch_location))
1460
if tree.get_parent_ids()[1:] != existing_pending_merges:
1452
1461
note('Your local commits will now show as pending merges with '
1453
1462
"'bzr status', and can be committed with 'bzr commit'.")
1454
1463
if conflicts != 0:
1460
1469
class cmd_info(Command):
1461
__doc__ = """Show information about a working tree, branch or repository.
1470
"""Show information about a working tree, branch or repository.
1463
1472
This command will show all known locations and formats associated to the
1464
1473
tree, branch or repository.
1557
1567
class cmd_file_id(Command):
1558
__doc__ = """Print file_id of a particular file or directory.
1568
"""Print file_id of a particular file or directory.
1560
1570
The file_id is assigned when the file is first added and remains the
1561
1571
same through all revisions where the file exists, even when it is
1579
1589
class cmd_file_path(Command):
1580
__doc__ = """Print path of file_ids to a file or directory.
1590
"""Print path of file_ids to a file or directory.
1582
1592
This prints one line for each directory down to the target,
1583
1593
starting at the branch root.
1645
1655
class cmd_ancestry(Command):
1646
__doc__ = """List all revisions merged into this branch."""
1656
"""List all revisions merged into this branch."""
1648
1658
_see_also = ['log', 'revision-history']
1649
1659
takes_args = ['location?']
1779
1789
class cmd_init_repository(Command):
1780
__doc__ = """Create a shared repository for branches to share storage space.
1790
"""Create a shared repository for branches to share storage space.
1782
1792
New branches created under the repository directory will store their
1783
1793
revisions in the repository, not in the branch directory. For branches
1839
1849
class cmd_diff(Command):
1840
__doc__ = """Show differences in the working tree, between revisions or branches.
1850
"""Show differences in the working tree, between revisions or branches.
1842
1852
If no arguments are given, all changes for the current tree are listed.
1843
1853
If files are given, only the changes in those files are listed.
1929
1939
help='Use this command to compare files.',
1932
RegistryOption('format',
1933
help='Diff format to use.',
1934
lazy_registry=('bzrlib.diff', 'format_registry'),
1935
value_switches=False, title='Diff format'),
1937
1943
aliases = ['di', 'dif']
1938
1944
encoding_type = 'exact'
1940
1946
@display_command
1941
1947
def run(self, revision=None, file_list=None, diff_options=None,
1942
prefix=None, old=None, new=None, using=None, format=None):
1943
from bzrlib.diff import (get_trees_and_branches_to_diff_locked,
1948
prefix=None, old=None, new=None, using=None):
1949
from bzrlib.diff import get_trees_and_branches_to_diff, show_diff_trees
1946
1951
if (prefix is None) or (prefix == '0'):
1947
1952
# diff -p0 format
1961
1966
raise errors.BzrCommandError('bzr diff --revision takes exactly'
1962
1967
' one or two revision specifiers')
1964
if using is not None and format is not None:
1965
raise errors.BzrCommandError('--using and --format are mutually '
1968
1969
(old_tree, new_tree,
1969
1970
old_branch, new_branch,
1970
specific_files, extra_trees) = get_trees_and_branches_to_diff_locked(
1971
file_list, revision, old, new, self.add_cleanup, apply_view=True)
1971
specific_files, extra_trees) = get_trees_and_branches_to_diff(
1972
file_list, revision, old, new, apply_view=True)
1972
1973
return show_diff_trees(old_tree, new_tree, sys.stdout,
1973
1974
specific_files=specific_files,
1974
1975
external_diff_options=diff_options,
1975
1976
old_label=old_label, new_label=new_label,
1976
extra_trees=extra_trees, using=using,
1977
extra_trees=extra_trees, using=using)
1980
1980
class cmd_deleted(Command):
1981
__doc__ = """List files deleted in the working tree.
1981
"""List files deleted in the working tree.
1983
1983
# TODO: Show files deleted since a previous revision, or
1984
1984
# between two revisions.
1992
1992
@display_command
1993
1993
def run(self, show_ids=False):
1994
1994
tree = WorkingTree.open_containing(u'.')[0]
1995
self.add_cleanup(tree.lock_read().unlock)
1996
self.add_cleanup(tree.unlock)
1996
1997
old = tree.basis_tree()
1997
self.add_cleanup(old.lock_read().unlock)
1999
self.add_cleanup(old.unlock)
1998
2000
for path, ie in old.inventory.iter_entries():
1999
2001
if not tree.has_id(ie.file_id):
2000
2002
self.outf.write(path)
2042
2044
@display_command
2043
2045
def run(self, null=False):
2044
2046
wt = WorkingTree.open_containing(u'.')[0]
2045
self.add_cleanup(wt.lock_read().unlock)
2048
self.add_cleanup(wt.unlock)
2046
2049
basis = wt.basis_tree()
2047
self.add_cleanup(basis.lock_read().unlock)
2051
self.add_cleanup(basis.unlock)
2048
2052
basis_inv = basis.inventory
2049
2053
inv = wt.inventory
2050
2054
for file_id in inv:
2279
2283
help='Show changes made in each revision as a patch.'),
2280
2284
Option('include-merges',
2281
2285
help='Show merged revisions like --levels 0 does.'),
2282
Option('exclude-common-ancestry',
2283
help='Display only the revisions that are not part'
2284
' of both ancestries (require -rX..Y)'
2287
2287
encoding_type = 'replace'
2300
2300
show_diff=False,
2301
include_merges=False,
2302
exclude_common_ancestry=False,
2301
include_merges=False):
2304
2302
from bzrlib.log import (
2306
2304
make_log_request_dict,
2307
2305
_get_info_for_log_files,
2309
2307
direction = (forward and 'forward') or 'reverse'
2310
if (exclude_common_ancestry
2311
and (revision is None or len(revision) != 2)):
2312
raise errors.BzrCommandError(
2313
'--exclude-common-ancestry requires -r with two revisions')
2314
2308
if include_merges:
2315
2309
if levels is None:
2333
2327
# find the file ids to log and check for directory filtering
2334
2328
b, file_info_list, rev1, rev2 = _get_info_for_log_files(
2335
revision, file_list, self.add_cleanup)
2329
revision, file_list)
2330
self.add_cleanup(b.unlock)
2336
2331
for relpath, file_id, kind in file_info_list:
2337
2332
if file_id is None:
2338
2333
raise errors.BzrCommandError(
2357
2352
dir, relpath = bzrdir.BzrDir.open_containing(location)
2358
2353
b = dir.open_branch()
2359
self.add_cleanup(b.lock_read().unlock)
2355
self.add_cleanup(b.unlock)
2360
2356
rev1, rev2 = _get_revision_range(revision, b, self.name())
2362
2358
# Decide on the type of delta & diff filtering to use
2407
2403
direction=direction, specific_fileids=file_ids,
2408
2404
start_revision=rev1, end_revision=rev2, limit=limit,
2409
2405
message_search=message, delta_type=delta_type,
2410
diff_type=diff_type, _match_using_deltas=match_using_deltas,
2411
exclude_common_ancestry=exclude_common_ancestry,
2406
diff_type=diff_type, _match_using_deltas=match_using_deltas)
2413
2407
Logger(b, rqst).show(lf)
2434
2428
raise errors.BzrCommandError(
2435
2429
"bzr %s doesn't accept two revisions in different"
2436
2430
" branches." % command_name)
2437
if start_spec.spec is None:
2438
# Avoid loading all the history.
2439
rev1 = RevisionInfo(branch, None, None)
2441
rev1 = start_spec.in_history(branch)
2431
rev1 = start_spec.in_history(branch)
2442
2432
# Avoid loading all of history when we know a missing
2443
2433
# end of range means the last revision ...
2444
2434
if end_spec.spec is None:
2486
2476
tree, relpath = WorkingTree.open_containing(filename)
2487
2477
file_id = tree.path2id(relpath)
2488
2478
b = tree.branch
2489
self.add_cleanup(b.lock_read().unlock)
2480
self.add_cleanup(b.unlock)
2490
2481
touching_revs = log.find_touching_revisions(b, file_id)
2491
2482
for revno, revision_id, what in touching_revs:
2492
2483
self.outf.write("%6d %s\n" % (revno, what))
2495
2486
class cmd_ls(Command):
2496
__doc__ = """List files in a tree.
2487
"""List files in a tree.
2499
2490
_see_also = ['status', 'cat']
2561
2552
view_str = views.view_display_str(view_files)
2562
2553
note("Ignoring files outside view. View is %s" % view_str)
2564
self.add_cleanup(tree.lock_read().unlock)
2556
self.add_cleanup(tree.unlock)
2565
2557
for fp, fc, fkind, fid, entry in tree.list_files(include_root=False,
2566
2558
from_dir=relpath, recursive=recursive):
2567
2559
# Apply additional masking
2637
2629
using this command or directly by using an editor, be sure to commit
2640
Bazaar also supports a global ignore file ~/.bazaar/ignore. On Windows
2641
the global ignore file can be found in the application data directory as
2642
C:\\Documents and Settings\\<user>\\Application Data\\Bazaar\\2.0\\ignore.
2643
Global ignores are not touched by this command. The global ignore file
2644
can be edited directly using an editor.
2646
2632
Patterns prefixed with '!' are exceptions to ignore patterns and take
2647
2633
precedence over regular ignores. Such exceptions are used to specify
2648
2634
files that should be versioned which would otherwise be ignored.
2689
2675
_see_also = ['status', 'ignored', 'patterns']
2690
2676
takes_args = ['name_pattern*']
2691
2677
takes_options = [
2692
Option('default-rules',
2693
help='Display the default ignore rules that bzr uses.')
2678
Option('old-default-rules',
2679
help='Write out the ignore rules bzr < 0.9 always used.')
2696
def run(self, name_pattern_list=None, default_rules=None):
2682
def run(self, name_pattern_list=None, old_default_rules=None):
2697
2683
from bzrlib import ignores
2698
if default_rules is not None:
2699
# dump the default rules and exit
2700
for pattern in ignores.USER_DEFAULTS:
2684
if old_default_rules is not None:
2685
# dump the rules and exit
2686
for pattern in ignores.OLD_DEFAULTS:
2701
2687
self.outf.write("%s\n" % pattern)
2703
2689
if not name_pattern_list:
2704
2690
raise errors.BzrCommandError("ignore requires at least one "
2705
"NAME_PATTERN or --default-rules.")
2691
"NAME_PATTERN or --old-default-rules")
2706
2692
name_pattern_list = [globbing.normalize_pattern(p)
2707
2693
for p in name_pattern_list]
2708
2694
for name_pattern in name_pattern_list:
2746
2732
@display_command
2748
2734
tree = WorkingTree.open_containing(u'.')[0]
2749
self.add_cleanup(tree.lock_read().unlock)
2736
self.add_cleanup(tree.unlock)
2750
2737
for path, file_class, kind, file_id, entry in tree.list_files():
2751
2738
if file_class != 'I':
2816
2803
help="Name of the root directory inside the exported file."),
2817
Option('per-file-timestamps',
2818
help='Set modification time of files to that of the last '
2819
'revision in which it was changed.'),
2821
2805
def run(self, dest, branch_or_subdir=None, revision=None, format=None,
2822
root=None, filters=False, per_file_timestamps=False):
2806
root=None, filters=False):
2823
2807
from bzrlib.export import export
2825
2809
if branch_or_subdir is None:
2833
2817
rev_tree = _get_one_revision_tree('export', revision, branch=b, tree=tree)
2835
export(rev_tree, dest, format, root, subdir, filtered=filters,
2836
per_file_timestamps=per_file_timestamps)
2819
export(rev_tree, dest, format, root, subdir, filtered=filters)
2837
2820
except errors.NoSuchExportFormat, e:
2838
2821
raise errors.BzrCommandError('Unsupported export format: %s' % e.format)
2841
2824
class cmd_cat(Command):
2842
__doc__ = """Write the contents of a file as of a given revision to standard output.
2825
"""Write the contents of a file as of a given revision to standard output.
2844
2827
If no revision is nominated, the last revision is used.
2865
2848
" one revision specifier")
2866
2849
tree, branch, relpath = \
2867
2850
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
2868
self.add_cleanup(branch.lock_read().unlock)
2852
self.add_cleanup(branch.unlock)
2869
2853
return self._run(tree, branch, relpath, filename, revision,
2870
2854
name_from_revision, filters)
3046
3031
"the master branch until a normal commit "
3047
3032
"is performed."
3049
Option('show-diff', short_name='p',
3050
3035
help='When no message is supplied, show the diff along'
3051
3036
' with the status summary in the message editor.'),
3132
3117
'(use --file "%(f)s" to take commit message from that file)'
3133
3118
% { 'f': message })
3134
3119
ui.ui_factory.show_warning(warning_msg)
3136
message = message.replace('\r\n', '\n')
3137
message = message.replace('\r', '\n')
3139
raise errors.BzrCommandError(
3140
"please specify either --message or --file")
3142
3121
def get_message(commit_obj):
3143
3122
"""Callback to get commit message"""
3145
my_message = codecs.open(
3146
file, 'rt', osutils.get_user_encoding()).read()
3147
elif message is not None:
3148
my_message = message
3150
# No message supplied: make one up.
3151
# text is the status of the tree
3152
text = make_commit_message_template_encoded(tree,
3123
my_message = message
3124
if my_message is not None and '\r' in my_message:
3125
my_message = my_message.replace('\r\n', '\n')
3126
my_message = my_message.replace('\r', '\n')
3127
if my_message is None and not file:
3128
t = make_commit_message_template_encoded(tree,
3153
3129
selected_list, diff=show_diff,
3154
3130
output_encoding=osutils.get_user_encoding())
3155
# start_message is the template generated from hooks
3156
# XXX: Warning - looks like hooks return unicode,
3157
# make_commit_message_template_encoded returns user encoding.
3158
# We probably want to be using edit_commit_message instead to
3160
3131
start_message = generate_commit_message_template(commit_obj)
3161
my_message = edit_commit_message_encoded(text,
3132
my_message = edit_commit_message_encoded(t,
3162
3133
start_message=start_message)
3163
3134
if my_message is None:
3164
3135
raise errors.BzrCommandError("please specify a commit"
3165
3136
" message with either --message or --file")
3137
elif my_message and file:
3138
raise errors.BzrCommandError(
3139
"please specify either --message or --file")
3141
my_message = codecs.open(file, 'rt',
3142
osutils.get_user_encoding()).read()
3166
3143
if my_message == "":
3167
3144
raise errors.BzrCommandError("empty commit message specified")
3168
3145
return my_message
3180
3157
timezone=offset,
3181
3158
exclude=safe_relpath_files(tree, exclude))
3182
3159
except PointlessCommit:
3160
# FIXME: This should really happen before the file is read in;
3161
# perhaps prepare the commit; get the message; then actually commit
3183
3162
raise errors.BzrCommandError("No changes to commit."
3184
3163
" Use --unchanged to commit anyhow.")
3185
3164
except ConflictsInTree:
3190
3169
raise errors.BzrCommandError("Commit refused because there are"
3191
3170
" unknown files in the working tree.")
3192
3171
except errors.BoundBranchOutOfDate, e:
3193
e.extra_help = ("\n"
3194
'To commit to master branch, run update and then commit.\n'
3195
'You can also pass --local to commit to continue working '
3172
raise errors.BzrCommandError(str(e) + "\n"
3173
'To commit to master branch, run update and then commit.\n'
3174
'You can also pass --local to commit to continue working '
3200
3178
class cmd_check(Command):
3201
__doc__ = """Validate working tree structure, branch consistency and repository history.
3179
"""Validate working tree structure, branch consistency and repository history.
3203
3181
This command checks various invariants about branch and repository storage
3204
3182
to detect data corruption or bzr bugs.
3438
3416
class cmd_selftest(Command):
3439
__doc__ = """Run internal test suite.
3417
"""Run internal test suite.
3441
3419
If arguments are given, they are regular expressions that say which tests
3442
3420
should run. Tests matching any expression are run, and other tests are
3583
3561
raise errors.BzrCommandError("subunit not available. subunit "
3584
3562
"needs to be installed to use --subunit.")
3585
3563
self.additional_selftest_args['runner_class'] = SubUnitBzrRunner
3586
# On Windows, disable automatic conversion of '\n' to '\r\n' in
3587
# stdout, which would corrupt the subunit stream.
3588
if sys.platform == "win32" and sys.stdout.fileno() >= 0:
3590
msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
3592
3565
self.additional_selftest_args.setdefault(
3593
3566
'suite_decorators', []).append(parallel)
3653
3626
class cmd_find_merge_base(Command):
3654
__doc__ = """Find and print a base revision for merging two branches."""
3627
"""Find and print a base revision for merging two branches."""
3655
3628
# TODO: Options to specify revisions on either side, as if
3656
3629
# merging only part of the history.
3657
3630
takes_args = ['branch', 'other']
3664
3637
branch1 = Branch.open_containing(branch)[0]
3665
3638
branch2 = Branch.open_containing(other)[0]
3666
self.add_cleanup(branch1.lock_read().unlock)
3667
self.add_cleanup(branch2.lock_read().unlock)
3640
self.add_cleanup(branch1.unlock)
3642
self.add_cleanup(branch2.unlock)
3668
3643
last1 = ensure_null(branch1.last_revision())
3669
3644
last2 = ensure_null(branch2.last_revision())
3677
3652
class cmd_merge(Command):
3678
__doc__ = """Perform a three-way merge.
3653
"""Perform a three-way merge.
3680
3655
The source of the merge can be specified either in the form of a branch,
3681
3656
or in the form of a path to a file containing a merge directive generated
3808
3783
unversioned_filter=tree.is_ignored, view_info=view_info)
3809
3784
pb = ui.ui_factory.nested_progress_bar()
3810
3785
self.add_cleanup(pb.finished)
3811
self.add_cleanup(tree.lock_write().unlock)
3787
self.add_cleanup(tree.unlock)
3812
3788
if location is not None:
3814
3790
mergeable = bundle.read_mergeable_from_url(location,
4067
4043
def run(self, file_list=None, merge_type=None, show_base=False,
4068
4044
reprocess=False):
4069
from bzrlib.conflicts import restore
4070
4045
if merge_type is None:
4071
4046
merge_type = _mod_merge.Merge3Merger
4072
4047
tree, file_list = tree_files(file_list)
4073
self.add_cleanup(tree.lock_write().unlock)
4049
self.add_cleanup(tree.unlock)
4074
4050
parents = tree.get_parent_ids()
4075
4051
if len(parents) != 2:
4076
4052
raise errors.BzrCommandError("Sorry, remerge only works after normal"
4131
4107
class cmd_revert(Command):
4132
__doc__ = """Revert files to a previous revision.
4108
"""Revert files to a previous revision.
4134
4110
Giving a list of files will revert only those files. Otherwise, all files
4135
4111
will be reverted. If the revision is not specified with '--revision', the
4186
4162
def run(self, revision=None, no_backup=False, file_list=None,
4187
4163
forget_merges=None):
4188
4164
tree, file_list = tree_files(file_list)
4189
self.add_cleanup(tree.lock_tree_write().unlock)
4166
self.add_cleanup(tree.unlock)
4190
4167
if forget_merges:
4191
4168
tree.set_parent_ids(tree.get_parent_ids()[:1])
4344
4319
remote_branch = Branch.open(other_branch)
4345
4320
if remote_branch.base == local_branch.base:
4346
4321
remote_branch = local_branch
4348
self.add_cleanup(remote_branch.lock_read().unlock)
4323
local_branch.lock_read()
4324
self.add_cleanup(local_branch.unlock)
4350
4325
local_revid_range = _revision_range_to_revid_range(
4351
4326
_get_revision_range(my_revision, local_branch,
4329
remote_branch.lock_read()
4330
self.add_cleanup(remote_branch.unlock)
4354
4331
remote_revid_range = _revision_range_to_revid_range(
4355
4332
_get_revision_range(revision,
4356
4333
remote_branch, self.name()))
4406
4383
message("Branches are up to date.\n")
4407
4384
self.cleanup_now()
4408
4385
if not status_code and parent is None and other_branch is not None:
4409
self.add_cleanup(local_branch.lock_write().unlock)
4386
local_branch.lock_write()
4387
self.add_cleanup(local_branch.unlock)
4410
4388
# handle race conditions - a parent might be set while we run.
4411
4389
if local_branch.get_parent() is None:
4412
4390
local_branch.set_parent(remote_branch.base)
4416
4394
class cmd_pack(Command):
4417
__doc__ = """Compress the data within a repository.
4419
This operation compresses the data within a bazaar repository. As
4420
bazaar supports automatic packing of repository, this operation is
4421
normally not required to be done manually.
4423
During the pack operation, bazaar takes a backup of existing repository
4424
data, i.e. pack files. This backup is eventually removed by bazaar
4425
automatically when it is safe to do so. To save disk space by removing
4426
the backed up pack files, the --clean-obsolete-packs option may be
4429
Warning: If you use --clean-obsolete-packs and your machine crashes
4430
during or immediately after repacking, you may be left with a state
4431
where the deletion has been written to disk but the new packs have not
4432
been. In this case the repository may be unusable.
4395
"""Compress the data within a repository."""
4435
4397
_see_also = ['repositories']
4436
4398
takes_args = ['branch_or_repo?']
4438
Option('clean-obsolete-packs', 'Delete obsolete packs to save disk space.'),
4441
def run(self, branch_or_repo='.', clean_obsolete_packs=False):
4400
def run(self, branch_or_repo='.'):
4442
4401
dir = bzrdir.BzrDir.open_containing(branch_or_repo)[0]
4444
4403
branch = dir.open_branch()
4445
4404
repository = branch.repository
4446
4405
except errors.NotBranchError:
4447
4406
repository = dir.open_repository()
4448
repository.pack(clean_obsolete_packs=clean_obsolete_packs)
4451
4410
class cmd_plugins(Command):
4452
__doc__ = """List the installed plugins.
4411
"""List the installed plugins.
4454
4413
This command displays the list of installed plugins including
4455
4414
version of plugin and a short description of each.
4527
4487
class cmd_annotate(Command):
4528
__doc__ = """Show the origin of each line in a file.
4488
"""Show the origin of each line in a file.
4530
4490
This prints out the given file with an annotation on the left side
4531
4491
indicating which revision, author and date introduced the change.
4552
4512
wt, branch, relpath = \
4553
4513
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
4554
4514
if wt is not None:
4555
self.add_cleanup(wt.lock_read().unlock)
4516
self.add_cleanup(wt.unlock)
4557
self.add_cleanup(branch.lock_read().unlock)
4519
self.add_cleanup(branch.unlock)
4558
4520
tree = _get_one_revision_tree('annotate', revision, branch=branch)
4559
self.add_cleanup(tree.lock_read().unlock)
4522
self.add_cleanup(tree.unlock)
4560
4523
if wt is not None:
4561
4524
file_id = wt.path2id(relpath)
4588
4551
if revision_id_list is None and revision is None:
4589
4552
raise errors.BzrCommandError('You must supply either --revision or a revision_id')
4590
4553
b = WorkingTree.open_containing(u'.')[0].branch
4591
self.add_cleanup(b.lock_write().unlock)
4555
self.add_cleanup(b.unlock)
4592
4556
return self._run(b, revision_id_list, revision)
4594
4558
def _run(self, b, revision_id_list, revision):
4642
4606
class cmd_bind(Command):
4643
__doc__ = """Convert the current branch into a checkout of the supplied branch.
4644
If no branch is supplied, rebind to the last bound location.
4607
"""Convert the current branch into a checkout of the supplied branch.
4646
4609
Once converted into a checkout, commits must succeed on the master branch
4647
4610
before they will be applied to the local branch.
4683
4646
class cmd_unbind(Command):
4684
__doc__ = """Convert the current checkout into a regular branch.
4647
"""Convert the current checkout into a regular branch.
4686
4649
After unbinding, the local branch is considered independent and subsequent
4687
4650
commits will be local only.
4700
4663
class cmd_uncommit(Command):
4701
__doc__ = """Remove the last committed revision.
4664
"""Remove the last committed revision.
4703
4666
--verbose will print out what is being removed.
4704
4667
--dry-run will go through all the motions, but not actually
4744
4707
b = control.open_branch()
4746
4709
if tree is not None:
4747
self.add_cleanup(tree.lock_write().unlock)
4711
self.add_cleanup(tree.unlock)
4749
self.add_cleanup(b.lock_write().unlock)
4714
self.add_cleanup(b.unlock)
4750
4715
return self._run(b, tree, dry_run, verbose, revision, force, local=local)
4752
4717
def _run(self, b, tree, dry_run, verbose, revision, force, local=False):
4806
4771
class cmd_break_lock(Command):
4807
__doc__ = """Break a dead lock on a repository, branch or working directory.
4772
"""Break a dead lock on a repository, branch or working directory.
4809
4774
CAUTION: Locks should only be broken when you are sure that the process
4810
4775
holding the lock has been stopped.
4957
4922
class cmd_split(Command):
4958
__doc__ = """Split a subdirectory of a tree into a separate tree.
4923
"""Split a subdirectory of a tree into a separate tree.
4960
4925
This command will produce a target tree in a format that supports
4961
4926
rich roots, like 'rich-root' or 'rich-root-pack'. These formats cannot be
4983
4948
class cmd_merge_directive(Command):
4984
__doc__ = """Generate a merge directive for auto-merge tools.
4949
"""Generate a merge directive for auto-merge tools.
4986
4951
A directive requests a merge to be performed, and also provides all the
4987
4952
information necessary to do so. This means it must either include a
5272
5237
class cmd_tag(Command):
5273
__doc__ = """Create, remove or modify a tag naming a revision.
5238
"""Create, remove or modify a tag naming a revision.
5275
5240
Tags give human-meaningful names to revisions. Commands that take a -r
5276
5241
(--revision) option can be given -rtag:X, where X is any previously
5285
5250
To rename a tag (change the name but keep it on the same revsion), run ``bzr
5286
5251
tag new-name -r tag:old-name`` and then ``bzr tag --delete oldname``.
5288
If no tag name is specified it will be determined through the
5289
'automatic_tag_name' hook. This can e.g. be used to automatically tag
5290
upstream releases by reading configure.ac. See ``bzr help hooks`` for
5294
5254
_see_also = ['commit', 'tags']
5295
takes_args = ['tag_name?']
5255
takes_args = ['tag_name']
5296
5256
takes_options = [
5297
5257
Option('delete',
5298
5258
help='Delete this tag rather than placing it.',
5311
def run(self, tag_name=None,
5271
def run(self, tag_name,
5317
5277
branch, relpath = Branch.open_containing(directory)
5318
self.add_cleanup(branch.lock_write().unlock)
5279
self.add_cleanup(branch.unlock)
5320
if tag_name is None:
5321
raise errors.BzrCommandError("No tag specified to delete.")
5322
5281
branch.tags.delete_tag(tag_name)
5323
5282
self.outf.write('Deleted tag %s.\n' % tag_name)
5330
5289
revision_id = revision[0].as_revision_id(branch)
5332
5291
revision_id = branch.last_revision()
5333
if tag_name is None:
5334
tag_name = branch.automatic_tag_name(revision_id)
5335
if tag_name is None:
5336
raise errors.BzrCommandError(
5337
"Please specify a tag name.")
5338
5292
if (not force) and branch.tags.has_tag(tag_name):
5339
5293
raise errors.TagAlreadyExists(tag_name)
5340
5294
branch.tags.set_tag(tag_name, revision_id)
5508
5463
class cmd_switch(Command):
5509
__doc__ = """Set the branch of a checkout and update.
5464
"""Set the branch of a checkout and update.
5511
5466
For lightweight checkouts, this changes the branch being referenced.
5512
5467
For heavyweight checkouts, this checks that there are no local commits
5775
5730
self.outf.write(" <no hooks installed>\n")
5778
class cmd_remove_branch(Command):
5779
__doc__ = """Remove a branch.
5781
This will remove the branch from the specified location but
5782
will keep any working tree or repository in place.
5786
Remove the branch at repo/trunk::
5788
bzr remove-branch repo/trunk
5792
takes_args = ["location?"]
5794
aliases = ["rmbranch"]
5796
def run(self, location=None):
5797
if location is None:
5799
branch = Branch.open_containing(location)[0]
5800
branch.bzrdir.destroy_branch()
5803
5733
class cmd_shelve(Command):
5804
__doc__ = """Temporarily set aside some changes from the current tree.
5734
"""Temporarily set aside some changes from the current tree.
5806
5736
Shelve allows you to temporarily put changes you've made "on the shelf",
5807
5737
ie. out of the way, until a later time when you can bring them back from
5877
5808
class cmd_unshelve(Command):
5878
__doc__ = """Restore shelved changes.
5809
"""Restore shelved changes.
5880
5811
By default, the most recently shelved changes are restored. However if you
5881
5812
specify a shelf by id those changes will be restored instead. This works
5909
5840
class cmd_clean_tree(Command):
5910
__doc__ = """Remove unwanted files from working tree.
5841
"""Remove unwanted files from working tree.
5912
5843
By default, only unknown files, not ignored files, are deleted. Versioned
5913
5844
files are never deleted.
5943
5874
class cmd_reference(Command):
5944
__doc__ = """list, view and set branch locations for nested trees.
5875
"""list, view and set branch locations for nested trees.
5946
5877
If no arguments are provided, lists the branch locations for nested trees.
5947
5878
If one argument is provided, display the branch location for that tree.
5987
5918
self.outf.write('%s %s\n' % (path, location))
5990
def _register_lazy_builtins():
5991
# register lazy builtins from other modules; called at startup and should
5992
# be only called once.
5993
for (name, aliases, module_name) in [
5994
('cmd_bundle_info', [], 'bzrlib.bundle.commands'),
5995
('cmd_dpush', [], 'bzrlib.foreign'),
5996
('cmd_version_info', [], 'bzrlib.cmd_version_info'),
5997
('cmd_resolve', ['resolved'], 'bzrlib.conflicts'),
5998
('cmd_conflicts', [], 'bzrlib.conflicts'),
5999
('cmd_sign_my_commits', [], 'bzrlib.sign_my_commits'),
6001
builtin_command_registry.register_lazy(name, aliases, module_name)
5921
# these get imported and then picked up by the scan for cmd_*
5922
# TODO: Some more consistent way to split command definitions across files;
5923
# we do need to load at least some information about them to know of
5924
# aliases. ideally we would avoid loading the implementation until the
5925
# details were needed.
5926
from bzrlib.cmd_version_info import cmd_version_info
5927
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore
5928
from bzrlib.bundle.commands import (
5931
from bzrlib.foreign import cmd_dpush
5932
from bzrlib.sign_my_commits import cmd_sign_my_commits