334
334
class cmd_cat_revision(Command):
335
__doc__ = """Write out metadata for a revision.
335
"""Write out metadata for a revision.
337
337
The revision to print can either be specified by a specific
338
338
revision identifier, or you can use --revision.
392
392
class cmd_dump_btree(Command):
393
__doc__ = """Dump the contents of a btree index file to stdout.
393
"""Dump the contents of a btree index file to stdout.
395
395
PATH is a btree index file, it can be any URL. This includes things like
396
396
.bzr/repository/pack-names, or .bzr/repository/indices/a34b3a...ca4a4.iix
504
504
if (working.has_changes()):
505
505
raise errors.UncommittedChanges(working)
507
if working.user_url != working.branch.user_url:
507
working_path = working.bzrdir.root_transport.base
508
branch_path = working.branch.bzrdir.root_transport.base
509
if working_path != branch_path:
508
510
raise errors.BzrCommandError("You cannot remove the working tree"
509
511
" from a lightweight checkout")
530
532
wt = WorkingTree.open_containing(location)[0]
531
self.add_cleanup(wt.lock_read().unlock)
532
534
except (errors.NoWorkingTree, errors.NotLocalUrl):
533
535
raise errors.NoWorkingTree(location)
536
self.add_cleanup(wt.unlock)
534
537
revid = wt.last_revision()
536
539
revno_t = wt.branch.revision_id_to_dotted_revno(revid)
539
542
revno = ".".join(str(n) for n in revno_t)
541
544
b = Branch.open_containing(location)[0]
542
self.add_cleanup(b.lock_read().unlock)
546
self.add_cleanup(b.unlock)
543
547
revno = b.revno()
544
548
self.cleanup_now()
545
549
self.outf.write(str(revno) + '\n')
548
552
class cmd_revision_info(Command):
549
__doc__ = """Show revision number and revision id for a given revision identifier.
553
"""Show revision number and revision id for a given revision identifier.
552
556
takes_args = ['revision_info*']
569
573
wt = WorkingTree.open_containing(directory)[0]
571
self.add_cleanup(wt.lock_read().unlock)
576
self.add_cleanup(wt.unlock)
572
577
except (errors.NoWorkingTree, errors.NotLocalUrl):
574
579
b = Branch.open_containing(directory)[0]
575
self.add_cleanup(b.lock_read().unlock)
581
self.add_cleanup(b.unlock)
576
582
revision_ids = []
577
583
if revision is not None:
578
584
revision_ids.extend(rev.as_revision_id(b) for rev in revision)
677
683
should_print=(not is_quiet()))
680
self.add_cleanup(base_tree.lock_read().unlock)
686
base_tree.lock_read()
687
self.add_cleanup(base_tree.unlock)
681
688
tree, file_list = tree_files_for_add(file_list)
682
689
added, ignored = tree.smart_add(file_list, not
683
690
no_recurse, action=action, save=not dry_run)
756
763
revision = _get_one_revision('inventory', revision)
757
764
work_tree, file_list = tree_files(file_list)
758
self.add_cleanup(work_tree.lock_read().unlock)
765
work_tree.lock_read()
766
self.add_cleanup(work_tree.unlock)
759
767
if revision is not None:
760
768
tree = revision.as_tree(work_tree.branch)
762
770
extra_trees = [work_tree]
763
self.add_cleanup(tree.lock_read().unlock)
772
self.add_cleanup(tree.unlock)
826
835
if len(names_list) < 2:
827
836
raise errors.BzrCommandError("missing file argument")
828
837
tree, rel_names = tree_files(names_list, canonicalize=False)
829
self.add_cleanup(tree.lock_tree_write().unlock)
838
tree.lock_tree_write()
839
self.add_cleanup(tree.unlock)
830
840
self._run(tree, names_list, rel_names, after)
832
842
def run_auto(self, names_list, after, dry_run):
837
847
raise errors.BzrCommandError('--after cannot be specified with'
839
849
work_tree, file_list = tree_files(names_list, default_branch='.')
840
self.add_cleanup(work_tree.lock_tree_write().unlock)
850
work_tree.lock_tree_write()
851
self.add_cleanup(work_tree.unlock)
841
852
rename_map.RenameMap.guess_renames(work_tree, dry_run)
843
854
def _run(self, tree, names_list, rel_names, after):
978
989
tree_to = WorkingTree.open_containing(directory)[0]
979
990
branch_to = tree_to.branch
980
self.add_cleanup(tree_to.lock_write().unlock)
981
991
except errors.NoWorkingTree:
983
993
branch_to = Branch.open_containing(directory)[0]
984
self.add_cleanup(branch_to.lock_write().unlock)
986
995
if local and not branch_to.get_bound_location():
987
996
raise errors.LocalRequiresBoundBranch()
1019
1028
branch_from = Branch.open(location,
1020
1029
possible_transports=possible_transports)
1021
self.add_cleanup(branch_from.lock_read().unlock)
1023
1031
if branch_to.get_parent() is None or remember:
1024
1032
branch_to.set_parent(branch_from.base)
1034
if branch_from is not branch_to:
1035
branch_from.lock_read()
1036
self.add_cleanup(branch_from.unlock)
1026
1037
if revision is not None:
1027
1038
revision_id = revision.as_revision_id(branch_from)
1040
branch_to.lock_write()
1041
self.add_cleanup(branch_to.unlock)
1029
1042
if tree_to is not None:
1030
1043
view_info = _get_view_info_for_change_reporter(tree_to)
1031
1044
change_reporter = delta._ChangeReporter(
1113
1126
# Get the source branch
1114
1127
(tree, br_from,
1115
1128
_unused) = bzrdir.BzrDir.open_containing_tree_or_branch(directory)
1130
strict = br_from.get_config().get_user_option_as_bool('push_strict')
1131
if strict is None: strict = True # default value
1116
1132
# Get the tip's revision_id
1117
1133
revision = _get_one_revision('push', revision)
1118
1134
if revision is not None:
1119
1135
revision_id = revision.in_history(br_from).rev_id
1121
1137
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.')
1138
if strict and tree is not None and revision_id is None:
1139
if (tree.has_changes()):
1140
raise errors.UncommittedChanges(
1141
tree, more='Use --no-strict to force the push.')
1142
if tree.last_revision() != tree.branch.last_revision():
1143
# The tree has lost sync with its branch, there is little
1144
# chance that the user is aware of it but he can still force
1145
# the push with --no-strict
1146
raise errors.OutOfDateTree(
1147
tree, more='Use --no-strict to force the push.')
1127
1149
# Get the stacked_on branch, if any
1128
1150
if stacked_on is not None:
1129
1151
stacked_on = urlutils.normalize_url(stacked_on)
1163
1185
class cmd_branch(Command):
1164
__doc__ = """Create a new branch that is a copy of an existing branch.
1186
"""Create a new branch that is a copy of an existing branch.
1166
1188
If the TO_LOCATION is omitted, the last component of the FROM_LOCATION will
1167
1189
be used. In other words, "branch ../foo/bar" will attempt to create ./bar.
1207
1229
accelerator_tree, br_from = bzrdir.BzrDir.open_tree_or_branch(
1209
1231
revision = _get_one_revision('branch', revision)
1210
self.add_cleanup(br_from.lock_read().unlock)
1233
self.add_cleanup(br_from.unlock)
1211
1234
if revision is not None:
1212
1235
revision_id = revision.as_revision_id(br_from)
1275
1298
class cmd_checkout(Command):
1276
__doc__ = """Create a new checkout of an existing branch.
1299
"""Create a new checkout of an existing branch.
1278
1301
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
1279
1302
the branch found in '.'. This is useful if you have removed the working tree
1353
1376
@display_command
1354
1377
def run(self, dir=u'.'):
1355
1378
tree = WorkingTree.open_containing(dir)[0]
1356
self.add_cleanup(tree.lock_read().unlock)
1380
self.add_cleanup(tree.unlock)
1357
1381
new_inv = tree.inventory
1358
1382
old_tree = tree.basis_tree()
1359
self.add_cleanup(old_tree.lock_read().unlock)
1383
old_tree.lock_read()
1384
self.add_cleanup(old_tree.unlock)
1360
1385
old_inv = old_tree.inventory
1362
1387
iterator = tree.iter_changes(old_tree, include_unchanged=True)
1374
1399
class cmd_update(Command):
1375
__doc__ = """Update a tree to have the latest code committed to its branch.
1400
"""Update a tree to have the latest code committed to its branch.
1377
1402
This will perform a merge into the working tree, and may generate
1378
1403
conflicts. If you have any local changes, you will still
1400
1425
master = branch.get_master_branch(
1401
1426
possible_transports=possible_transports)
1402
1427
if master is not None:
1403
1429
branch_location = master.base
1431
tree.lock_tree_write()
1406
1432
branch_location = tree.branch.base
1407
tree.lock_tree_write()
1408
1433
self.add_cleanup(tree.unlock)
1409
1434
# get rid of the final '/' and be ready for display
1410
1435
branch_location = urlutils.unescape_for_display(
1424
1449
revision_id = branch.last_revision()
1425
1450
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))
1451
revno = branch.revision_id_to_revno(revision_id)
1452
note("Tree is up to date at revision %d of branch %s" %
1453
(revno, branch_location))
1430
1455
view_info = _get_view_info_for_change_reporter(tree)
1431
1456
change_reporter = delta._ChangeReporter(
1443
1468
"bzr update --revision only works"
1444
1469
" for a revision in the branch history"
1445
1470
% (e.revision))
1446
revno = tree.branch.revision_id_to_dotted_revno(
1471
revno = tree.branch.revision_id_to_revno(
1447
1472
_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:
1473
note('Updated to revision %d of branch %s' %
1474
(revno, branch_location))
1475
if tree.get_parent_ids()[1:] != existing_pending_merges:
1452
1476
note('Your local commits will now show as pending merges with '
1453
1477
"'bzr status', and can be committed with 'bzr commit'.")
1454
1478
if conflicts != 0:
1460
1484
class cmd_info(Command):
1461
__doc__ = """Show information about a working tree, branch or repository.
1485
"""Show information about a working tree, branch or repository.
1463
1487
This command will show all known locations and formats associated to the
1464
1488
tree, branch or repository.
1557
1582
class cmd_file_id(Command):
1558
__doc__ = """Print file_id of a particular file or directory.
1583
"""Print file_id of a particular file or directory.
1560
1585
The file_id is assigned when the file is first added and remains the
1561
1586
same through all revisions where the file exists, even when it is
1579
1604
class cmd_file_path(Command):
1580
__doc__ = """Print path of file_ids to a file or directory.
1605
"""Print path of file_ids to a file or directory.
1582
1607
This prints one line for each directory down to the target,
1583
1608
starting at the branch root.
1645
1670
class cmd_ancestry(Command):
1646
__doc__ = """List all revisions merged into this branch."""
1671
"""List all revisions merged into this branch."""
1648
1673
_see_also = ['log', 'revision-history']
1649
1674
takes_args = ['location?']
1779
1804
class cmd_init_repository(Command):
1780
__doc__ = """Create a shared repository for branches to share storage space.
1805
"""Create a shared repository for branches to share storage space.
1782
1807
New branches created under the repository directory will store their
1783
1808
revisions in the repository, not in the branch directory. For branches
1839
1864
class cmd_diff(Command):
1840
__doc__ = """Show differences in the working tree, between revisions or branches.
1865
"""Show differences in the working tree, between revisions or branches.
1842
1867
If no arguments are given, all changes for the current tree are listed.
1843
1868
If files are given, only the changes in those files are listed.
1940
1965
@display_command
1941
1966
def run(self, revision=None, file_list=None, diff_options=None,
1942
1967
prefix=None, old=None, new=None, using=None, format=None):
1943
from bzrlib.diff import (get_trees_and_branches_to_diff_locked,
1968
from bzrlib.diff import (get_trees_and_branches_to_diff,
1944
1969
show_diff_trees)
1946
1971
if (prefix is None) or (prefix == '0'):
1968
1993
(old_tree, new_tree,
1969
1994
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)
1995
specific_files, extra_trees) = get_trees_and_branches_to_diff(
1996
file_list, revision, old, new, apply_view=True)
1972
1997
return show_diff_trees(old_tree, new_tree, sys.stdout,
1973
1998
specific_files=specific_files,
1974
1999
external_diff_options=diff_options,
1992
2017
@display_command
1993
2018
def run(self, show_ids=False):
1994
2019
tree = WorkingTree.open_containing(u'.')[0]
1995
self.add_cleanup(tree.lock_read().unlock)
2021
self.add_cleanup(tree.unlock)
1996
2022
old = tree.basis_tree()
1997
self.add_cleanup(old.lock_read().unlock)
2024
self.add_cleanup(old.unlock)
1998
2025
for path, ie in old.inventory.iter_entries():
1999
2026
if not tree.has_id(ie.file_id):
2000
2027
self.outf.write(path)
2042
2069
@display_command
2043
2070
def run(self, null=False):
2044
2071
wt = WorkingTree.open_containing(u'.')[0]
2045
self.add_cleanup(wt.lock_read().unlock)
2073
self.add_cleanup(wt.unlock)
2046
2074
basis = wt.basis_tree()
2047
self.add_cleanup(basis.lock_read().unlock)
2076
self.add_cleanup(basis.unlock)
2048
2077
basis_inv = basis.inventory
2049
2078
inv = wt.inventory
2050
2079
for file_id in inv:
2279
2308
help='Show changes made in each revision as a patch.'),
2280
2309
Option('include-merges',
2281
2310
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
2312
encoding_type = 'replace'
2300
2325
show_diff=False,
2301
include_merges=False,
2302
exclude_common_ancestry=False,
2326
include_merges=False):
2304
2327
from bzrlib.log import (
2306
2329
make_log_request_dict,
2307
2330
_get_info_for_log_files,
2309
2332
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
2333
if include_merges:
2315
2334
if levels is None:
2333
2352
# find the file ids to log and check for directory filtering
2334
2353
b, file_info_list, rev1, rev2 = _get_info_for_log_files(
2335
revision, file_list, self.add_cleanup)
2354
revision, file_list)
2355
self.add_cleanup(b.unlock)
2336
2356
for relpath, file_id, kind in file_info_list:
2337
2357
if file_id is None:
2338
2358
raise errors.BzrCommandError(
2357
2377
dir, relpath = bzrdir.BzrDir.open_containing(location)
2358
2378
b = dir.open_branch()
2359
self.add_cleanup(b.lock_read().unlock)
2380
self.add_cleanup(b.unlock)
2360
2381
rev1, rev2 = _get_revision_range(revision, b, self.name())
2362
2383
# Decide on the type of delta & diff filtering to use
2407
2428
direction=direction, specific_fileids=file_ids,
2408
2429
start_revision=rev1, end_revision=rev2, limit=limit,
2409
2430
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,
2431
diff_type=diff_type, _match_using_deltas=match_using_deltas)
2413
2432
Logger(b, rqst).show(lf)
2486
2505
tree, relpath = WorkingTree.open_containing(filename)
2487
2506
file_id = tree.path2id(relpath)
2488
2507
b = tree.branch
2489
self.add_cleanup(b.lock_read().unlock)
2509
self.add_cleanup(b.unlock)
2490
2510
touching_revs = log.find_touching_revisions(b, file_id)
2491
2511
for revno, revision_id, what in touching_revs:
2492
2512
self.outf.write("%6d %s\n" % (revno, what))
2495
2515
class cmd_ls(Command):
2496
__doc__ = """List files in a tree.
2516
"""List files in a tree.
2499
2519
_see_also = ['status', 'cat']
2561
2581
view_str = views.view_display_str(view_files)
2562
2582
note("Ignoring files outside view. View is %s" % view_str)
2564
self.add_cleanup(tree.lock_read().unlock)
2585
self.add_cleanup(tree.unlock)
2565
2586
for fp, fc, fkind, fid, entry in tree.list_files(include_root=False,
2566
2587
from_dir=relpath, recursive=recursive):
2567
2588
# Apply additional masking
2637
2658
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
2661
Patterns prefixed with '!' are exceptions to ignore patterns and take
2647
2662
precedence over regular ignores. Such exceptions are used to specify
2648
2663
files that should be versioned which would otherwise be ignored.
2689
2704
_see_also = ['status', 'ignored', 'patterns']
2690
2705
takes_args = ['name_pattern*']
2691
2706
takes_options = [
2692
Option('default-rules',
2693
help='Display the default ignore rules that bzr uses.')
2707
Option('old-default-rules',
2708
help='Write out the ignore rules bzr < 0.9 always used.')
2696
def run(self, name_pattern_list=None, default_rules=None):
2711
def run(self, name_pattern_list=None, old_default_rules=None):
2697
2712
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:
2713
if old_default_rules is not None:
2714
# dump the rules and exit
2715
for pattern in ignores.OLD_DEFAULTS:
2701
2716
self.outf.write("%s\n" % pattern)
2703
2718
if not name_pattern_list:
2704
2719
raise errors.BzrCommandError("ignore requires at least one "
2705
"NAME_PATTERN or --default-rules.")
2720
"NAME_PATTERN or --old-default-rules")
2706
2721
name_pattern_list = [globbing.normalize_pattern(p)
2707
2722
for p in name_pattern_list]
2708
2723
for name_pattern in name_pattern_list:
2746
2761
@display_command
2748
2763
tree = WorkingTree.open_containing(u'.')[0]
2749
self.add_cleanup(tree.lock_read().unlock)
2765
self.add_cleanup(tree.unlock)
2750
2766
for path, file_class, kind, file_id, entry in tree.list_files():
2751
2767
if file_class != 'I':
2865
2881
" one revision specifier")
2866
2882
tree, branch, relpath = \
2867
2883
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
2868
self.add_cleanup(branch.lock_read().unlock)
2885
self.add_cleanup(branch.unlock)
2869
2886
return self._run(tree, branch, relpath, filename, revision,
2870
2887
name_from_revision, filters)
3046
3064
"the master branch until a normal commit "
3047
3065
"is performed."
3049
Option('show-diff', short_name='p',
3050
3068
help='When no message is supplied, show the diff along'
3051
3069
' with the status summary in the message editor.'),
3132
3150
'(use --file "%(f)s" to take commit message from that file)'
3133
3151
% { 'f': message })
3134
3152
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
3154
def get_message(commit_obj):
3143
3155
"""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,
3156
my_message = message
3157
if my_message is not None and '\r' in my_message:
3158
my_message = my_message.replace('\r\n', '\n')
3159
my_message = my_message.replace('\r', '\n')
3160
if my_message is None and not file:
3161
t = make_commit_message_template_encoded(tree,
3153
3162
selected_list, diff=show_diff,
3154
3163
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
3164
start_message = generate_commit_message_template(commit_obj)
3161
my_message = edit_commit_message_encoded(text,
3165
my_message = edit_commit_message_encoded(t,
3162
3166
start_message=start_message)
3163
3167
if my_message is None:
3164
3168
raise errors.BzrCommandError("please specify a commit"
3165
3169
" message with either --message or --file")
3170
elif my_message and file:
3171
raise errors.BzrCommandError(
3172
"please specify either --message or --file")
3174
my_message = codecs.open(file, 'rt',
3175
osutils.get_user_encoding()).read()
3166
3176
if my_message == "":
3167
3177
raise errors.BzrCommandError("empty commit message specified")
3168
3178
return my_message
3180
3190
timezone=offset,
3181
3191
exclude=safe_relpath_files(tree, exclude))
3182
3192
except PointlessCommit:
3193
# FIXME: This should really happen before the file is read in;
3194
# perhaps prepare the commit; get the message; then actually commit
3183
3195
raise errors.BzrCommandError("No changes to commit."
3184
3196
" Use --unchanged to commit anyhow.")
3185
3197
except ConflictsInTree:
3200
3212
class cmd_check(Command):
3201
__doc__ = """Validate working tree structure, branch consistency and repository history.
3213
"""Validate working tree structure, branch consistency and repository history.
3203
3215
This command checks various invariants about branch and repository storage
3204
3216
to detect data corruption or bzr bugs.
3438
3450
class cmd_selftest(Command):
3439
__doc__ = """Run internal test suite.
3451
"""Run internal test suite.
3441
3453
If arguments are given, they are regular expressions that say which tests
3442
3454
should run. Tests matching any expression are run, and other tests are
3583
3595
raise errors.BzrCommandError("subunit not available. subunit "
3584
3596
"needs to be installed to use --subunit.")
3585
3597
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
3599
self.additional_selftest_args.setdefault(
3593
3600
'suite_decorators', []).append(parallel)
3653
3660
class cmd_find_merge_base(Command):
3654
__doc__ = """Find and print a base revision for merging two branches."""
3661
"""Find and print a base revision for merging two branches."""
3655
3662
# TODO: Options to specify revisions on either side, as if
3656
3663
# merging only part of the history.
3657
3664
takes_args = ['branch', 'other']
3664
3671
branch1 = Branch.open_containing(branch)[0]
3665
3672
branch2 = Branch.open_containing(other)[0]
3666
self.add_cleanup(branch1.lock_read().unlock)
3667
self.add_cleanup(branch2.lock_read().unlock)
3674
self.add_cleanup(branch1.unlock)
3676
self.add_cleanup(branch2.unlock)
3668
3677
last1 = ensure_null(branch1.last_revision())
3669
3678
last2 = ensure_null(branch2.last_revision())
3677
3686
class cmd_merge(Command):
3678
__doc__ = """Perform a three-way merge.
3687
"""Perform a three-way merge.
3680
3689
The source of the merge can be specified either in the form of a branch,
3681
3690
or in the form of a path to a file containing a merge directive generated
3808
3817
unversioned_filter=tree.is_ignored, view_info=view_info)
3809
3818
pb = ui.ui_factory.nested_progress_bar()
3810
3819
self.add_cleanup(pb.finished)
3811
self.add_cleanup(tree.lock_write().unlock)
3821
self.add_cleanup(tree.unlock)
3812
3822
if location is not None:
3814
3824
mergeable = bundle.read_mergeable_from_url(location,
4070
4080
if merge_type is None:
4071
4081
merge_type = _mod_merge.Merge3Merger
4072
4082
tree, file_list = tree_files(file_list)
4073
self.add_cleanup(tree.lock_write().unlock)
4084
self.add_cleanup(tree.unlock)
4074
4085
parents = tree.get_parent_ids()
4075
4086
if len(parents) != 2:
4076
4087
raise errors.BzrCommandError("Sorry, remerge only works after normal"
4131
4142
class cmd_revert(Command):
4132
__doc__ = """Revert files to a previous revision.
4143
"""Revert files to a previous revision.
4134
4145
Giving a list of files will revert only those files. Otherwise, all files
4135
4146
will be reverted. If the revision is not specified with '--revision', the
4186
4197
def run(self, revision=None, no_backup=False, file_list=None,
4187
4198
forget_merges=None):
4188
4199
tree, file_list = tree_files(file_list)
4189
self.add_cleanup(tree.lock_tree_write().unlock)
4201
self.add_cleanup(tree.unlock)
4190
4202
if forget_merges:
4191
4203
tree.set_parent_ids(tree.get_parent_ids()[:1])
4344
4354
remote_branch = Branch.open(other_branch)
4345
4355
if remote_branch.base == local_branch.base:
4346
4356
remote_branch = local_branch
4348
self.add_cleanup(remote_branch.lock_read().unlock)
4358
local_branch.lock_read()
4359
self.add_cleanup(local_branch.unlock)
4350
4360
local_revid_range = _revision_range_to_revid_range(
4351
4361
_get_revision_range(my_revision, local_branch,
4364
remote_branch.lock_read()
4365
self.add_cleanup(remote_branch.unlock)
4354
4366
remote_revid_range = _revision_range_to_revid_range(
4355
4367
_get_revision_range(revision,
4356
4368
remote_branch, self.name()))
4406
4418
message("Branches are up to date.\n")
4407
4419
self.cleanup_now()
4408
4420
if not status_code and parent is None and other_branch is not None:
4409
self.add_cleanup(local_branch.lock_write().unlock)
4421
local_branch.lock_write()
4422
self.add_cleanup(local_branch.unlock)
4410
4423
# handle race conditions - a parent might be set while we run.
4411
4424
if local_branch.get_parent() is None:
4412
4425
local_branch.set_parent(remote_branch.base)
4416
4429
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.
4430
"""Compress the data within a repository."""
4435
4432
_see_also = ['repositories']
4436
4433
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):
4435
def run(self, branch_or_repo='.'):
4442
4436
dir = bzrdir.BzrDir.open_containing(branch_or_repo)[0]
4444
4438
branch = dir.open_branch()
4445
4439
repository = branch.repository
4446
4440
except errors.NotBranchError:
4447
4441
repository = dir.open_repository()
4448
repository.pack(clean_obsolete_packs=clean_obsolete_packs)
4451
4445
class cmd_plugins(Command):
4452
__doc__ = """List the installed plugins.
4446
"""List the installed plugins.
4454
4448
This command displays the list of installed plugins including
4455
4449
version of plugin and a short description of each.
4527
4522
class cmd_annotate(Command):
4528
__doc__ = """Show the origin of each line in a file.
4523
"""Show the origin of each line in a file.
4530
4525
This prints out the given file with an annotation on the left side
4531
4526
indicating which revision, author and date introduced the change.
4552
4547
wt, branch, relpath = \
4553
4548
bzrdir.BzrDir.open_containing_tree_or_branch(filename)
4554
4549
if wt is not None:
4555
self.add_cleanup(wt.lock_read().unlock)
4551
self.add_cleanup(wt.unlock)
4557
self.add_cleanup(branch.lock_read().unlock)
4554
self.add_cleanup(branch.unlock)
4558
4555
tree = _get_one_revision_tree('annotate', revision, branch=branch)
4559
self.add_cleanup(tree.lock_read().unlock)
4557
self.add_cleanup(tree.unlock)
4560
4558
if wt is not None:
4561
4559
file_id = wt.path2id(relpath)
4588
4586
if revision_id_list is None and revision is None:
4589
4587
raise errors.BzrCommandError('You must supply either --revision or a revision_id')
4590
4588
b = WorkingTree.open_containing(u'.')[0].branch
4591
self.add_cleanup(b.lock_write().unlock)
4590
self.add_cleanup(b.unlock)
4592
4591
return self._run(b, revision_id_list, revision)
4594
4593
def _run(self, b, revision_id_list, revision):
4642
4641
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.
4642
"""Convert the current branch into a checkout of the supplied branch.
4646
4644
Once converted into a checkout, commits must succeed on the master branch
4647
4645
before they will be applied to the local branch.
4683
4681
class cmd_unbind(Command):
4684
__doc__ = """Convert the current checkout into a regular branch.
4682
"""Convert the current checkout into a regular branch.
4686
4684
After unbinding, the local branch is considered independent and subsequent
4687
4685
commits will be local only.
4700
4698
class cmd_uncommit(Command):
4701
__doc__ = """Remove the last committed revision.
4699
"""Remove the last committed revision.
4703
4701
--verbose will print out what is being removed.
4704
4702
--dry-run will go through all the motions, but not actually
4744
4742
b = control.open_branch()
4746
4744
if tree is not None:
4747
self.add_cleanup(tree.lock_write().unlock)
4746
self.add_cleanup(tree.unlock)
4749
self.add_cleanup(b.lock_write().unlock)
4749
self.add_cleanup(b.unlock)
4750
4750
return self._run(b, tree, dry_run, verbose, revision, force, local=local)
4752
4752
def _run(self, b, tree, dry_run, verbose, revision, force, local=False):
4806
4806
class cmd_break_lock(Command):
4807
__doc__ = """Break a dead lock on a repository, branch or working directory.
4807
"""Break a dead lock on a repository, branch or working directory.
4809
4809
CAUTION: Locks should only be broken when you are sure that the process
4810
4810
holding the lock has been stopped.
4957
4957
class cmd_split(Command):
4958
__doc__ = """Split a subdirectory of a tree into a separate tree.
4958
"""Split a subdirectory of a tree into a separate tree.
4960
4960
This command will produce a target tree in a format that supports
4961
4961
rich roots, like 'rich-root' or 'rich-root-pack'. These formats cannot be
4983
4983
class cmd_merge_directive(Command):
4984
__doc__ = """Generate a merge directive for auto-merge tools.
4984
"""Generate a merge directive for auto-merge tools.
4986
4986
A directive requests a merge to be performed, and also provides all the
4987
4987
information necessary to do so. This means it must either include a
5272
5272
class cmd_tag(Command):
5273
__doc__ = """Create, remove or modify a tag naming a revision.
5273
"""Create, remove or modify a tag naming a revision.
5275
5275
Tags give human-meaningful names to revisions. Commands that take a -r
5276
5276
(--revision) option can be given -rtag:X, where X is any previously
5508
5510
class cmd_switch(Command):
5509
__doc__ = """Set the branch of a checkout and update.
5511
"""Set the branch of a checkout and update.
5511
5513
For lightweight checkouts, this changes the branch being referenced.
5512
5514
For heavyweight checkouts, this checks that there are no local commits
5803
5805
class cmd_shelve(Command):
5804
__doc__ = """Temporarily set aside some changes from the current tree.
5806
"""Temporarily set aside some changes from the current tree.
5806
5808
Shelve allows you to temporarily put changes you've made "on the shelf",
5807
5809
ie. out of the way, until a later time when you can bring them back from
5877
5880
class cmd_unshelve(Command):
5878
__doc__ = """Restore shelved changes.
5881
"""Restore shelved changes.
5880
5883
By default, the most recently shelved changes are restored. However if you
5881
5884
specify a shelf by id those changes will be restored instead. This works
5909
5912
class cmd_clean_tree(Command):
5910
__doc__ = """Remove unwanted files from working tree.
5913
"""Remove unwanted files from working tree.
5912
5915
By default, only unknown files, not ignored files, are deleted. Versioned
5913
5916
files are never deleted.
5943
5946
class cmd_reference(Command):
5944
__doc__ = """list, view and set branch locations for nested trees.
5947
"""list, view and set branch locations for nested trees.
5946
5949
If no arguments are provided, lists the branch locations for nested trees.
5947
5950
If one argument is provided, display the branch location for that tree.