14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17
"""builtin bzr commands"""
19
# DO NOT change this to cStringIO - it results in control files
21
# FIXIT! (Only deal with byte streams OR unicode at any one layer.)
24
from StringIO import StringIO
23
from bzrlib.trace import mutter, note, log_error, warning
24
from bzrlib.errors import BzrError, BzrCheckError, BzrCommandError, NotBranchError
25
from bzrlib.branch import Branch
29
26
from bzrlib import BZRDIR
30
from bzrlib.commands import Command, display_command
31
from bzrlib.branch import Branch
32
from bzrlib.revision import common_ancestor
33
import bzrlib.errors as errors
34
from bzrlib.errors import (BzrError, BzrCheckError, BzrCommandError,
35
NotBranchError, DivergedBranches, NotConflicted,
36
NoSuchFile, NoWorkingTree, FileInWrongBranch)
37
from bzrlib.option import Option
38
from bzrlib.revisionspec import RevisionSpec
40
from bzrlib.trace import mutter, note, log_error, warning, is_quiet
41
from bzrlib.workingtree import WorkingTree
42
from bzrlib.log import show_one_log
45
def tree_files(file_list, default_branch=u'.'):
47
return internal_tree_files(file_list, default_branch)
48
except FileInWrongBranch, e:
49
raise BzrCommandError("%s is not in the same branch as %s" %
50
(e.path, file_list[0]))
52
def internal_tree_files(file_list, default_branch=u'.'):
54
Return a branch and list of branch-relative paths.
55
If supplied file_list is empty or None, the branch default will be used,
56
and returned file_list will match the original.
58
if file_list is None or len(file_list) == 0:
59
return WorkingTree.open_containing(default_branch)[0], file_list
60
tree = WorkingTree.open_containing(file_list[0])[0]
62
for filename in file_list:
64
new_list.append(tree.relpath(filename))
65
except errors.PathNotChild:
66
raise FileInWrongBranch(tree.branch, filename)
70
# TODO: Make sure no commands unconditionally use the working directory as a
71
# branch. If a filename argument is used, the first of them should be used to
72
# specify the branch. (Perhaps this can be factored out into some kind of
73
# Argument class, representing a file in a branch, where the first occurrence
27
from bzrlib.commands import Command
76
30
class cmd_status(Command):
77
31
"""Display status summary.
139
100
takes_args = ['revision_id?']
140
101
takes_options = ['revision']
143
103
def run(self, revision_id=None, revision=None):
104
from bzrlib.revisionspec import RevisionSpec
145
106
if revision_id is not None and revision is not None:
146
107
raise BzrCommandError('You can only supply one of revision_id or --revision')
147
108
if revision_id is None and revision is None:
148
109
raise BzrCommandError('You must supply either --revision or a revision_id')
149
b = WorkingTree.open_containing(u'.')[0].branch
110
b = Branch.open_containing('.')
150
111
if revision_id is not None:
151
sys.stdout.write(b.get_revision_xml(revision_id))
112
sys.stdout.write(b.get_revision_xml_file(revision_id).read())
152
113
elif revision is not None:
153
114
for rev in revision:
155
116
raise BzrCommandError('You cannot specify a NULL revision.')
156
117
revno, rev_id = rev.in_history(b)
157
sys.stdout.write(b.get_revision_xml(rev_id))
118
sys.stdout.write(b.get_revision_xml_file(rev_id).read())
160
121
class cmd_revno(Command):
161
122
"""Show current revision number.
163
124
This is equal to the number of revisions on this branch."""
164
takes_args = ['location?']
166
def run(self, location=u'.'):
167
print Branch.open_containing(location)[0].revno()
126
print Branch.open_containing('.').revno()
170
129
class cmd_revision_info(Command):
217
176
implicitly add the parent, and so on up to the root. This means
218
177
you should never need to explictly add a directory, they'll just
219
178
get added when you add a file in the directory.
221
--dry-run will show which files would be added, but not actually
224
180
takes_args = ['file*']
225
takes_options = ['no-recurse', 'dry-run', 'verbose']
227
def run(self, file_list, no_recurse=False, dry_run=False, verbose=False):
232
# This is pointless, but I'd rather not raise an error
233
action = bzrlib.add.add_action_null
235
action = bzrlib.add.add_action_print
237
action = bzrlib.add.add_action_add
239
action = bzrlib.add.add_action_add_and_print
241
added, ignored = bzrlib.add.smart_add(file_list, not no_recurse,
244
for glob in sorted(ignored.keys()):
245
match_len = len(ignored[glob])
247
for path in ignored[glob]:
248
print "ignored %s matching \"%s\"" % (path, glob)
250
print "ignored %d file(s) matching \"%s\"" % (match_len,
252
print "If you wish to add some of these files, please add them"\
181
takes_options = ['verbose', 'no-recurse']
183
def run(self, file_list, verbose=False, no_recurse=False):
184
# verbose currently has no effect
185
from bzrlib.add import smart_add, add_reporter_print
186
smart_add(file_list, not no_recurse, add_reporter_print)
256
190
class cmd_mkdir(Command):
273
210
takes_args = ['filename']
277
213
def run(self, filename):
278
tree, relpath = WorkingTree.open_containing(filename)
214
print Branch.open_containing(filename).relpath(filename)
282
218
class cmd_inventory(Command):
283
"""Show inventory of the current working copy or a revision.
285
It is possible to limit the output to a particular entry
286
type using the --kind option. For example; --kind file.
288
takes_options = ['revision', 'show-ids', 'kind']
219
"""Show inventory of the current working copy or a revision."""
220
takes_options = ['revision', 'show-ids']
291
def run(self, revision=None, show_ids=False, kind=None):
292
if kind and kind not in ['file', 'directory', 'symlink']:
293
raise BzrCommandError('invalid kind specified')
294
tree = WorkingTree.open_containing(u'.')[0]
222
def run(self, revision=None, show_ids=False):
223
b = Branch.open_containing('.')
295
224
if revision is None:
296
inv = tree.read_working_inventory()
225
inv = b.read_working_inventory()
298
227
if len(revision) > 1:
299
228
raise BzrCommandError('bzr inventory --revision takes'
300
229
' exactly one revision identifier')
301
inv = tree.branch.get_revision_inventory(
302
revision[0].in_history(tree.branch).rev_id)
230
inv = b.get_revision_inventory(revision[0].in_history(b).rev_id)
304
232
for path, entry in inv.entries():
305
if kind and kind != entry.kind:
308
234
print '%-50s %s' % (path, entry.file_id)
363
291
def run(self, names_list):
364
292
if len(names_list) < 2:
365
293
raise BzrCommandError("missing file argument")
366
tree, rel_names = tree_files(names_list)
294
b = Branch.open_containing(names_list[0])
296
rel_names = [b.relpath(x) for x in names_list]
368
298
if os.path.isdir(names_list[-1]):
369
299
# move into existing directory
370
for pair in tree.move(rel_names[:-1], rel_names[-1]):
300
for pair in b.move(rel_names[:-1], rel_names[-1]):
371
301
print "%s => %s" % pair
373
303
if len(names_list) != 2:
374
304
raise BzrCommandError('to mv multiple files the destination '
375
305
'must be a versioned directory')
376
tree.rename_one(rel_names[0], rel_names[1])
306
b.rename_one(rel_names[0], rel_names[1])
377
307
print "%s => %s" % (rel_names[0], rel_names[1])
380
312
class cmd_pull(Command):
381
313
"""Pull any changes from another branch into the current one.
383
If there is no default location set, the first pull will set it. After
384
that, you can omit the location to use the default. To change the
385
default, use --remember.
315
If the location is omitted, the last-used location will be used.
316
Both the revision history and the working directory will be
387
319
This command only works on branches that have not diverged. Branches are
388
320
considered diverged if both branches have had commits without first
389
321
pulling from the other.
391
323
If branches have diverged, you can use 'bzr merge' to pull the text changes
392
from one into the other. Once one branch has merged, the other should
393
be able to pull it again.
395
If you want to forget your local changes and just update your branch to
396
match the remote one, use --overwrite.
324
from one into the other.
398
takes_options = ['remember', 'overwrite', 'verbose']
399
326
takes_args = ['location?']
401
def run(self, location=None, remember=False, overwrite=False, verbose=False):
328
def run(self, location=None):
402
329
from bzrlib.merge import merge
403
331
from shutil import rmtree
405
# FIXME: too much stuff is in the command class
406
tree_to = WorkingTree.open_containing(u'.')[0]
407
stored_loc = tree_to.branch.get_parent()
334
br_to = Branch.open_containing('.')
335
stored_loc = br_to.get_parent()
408
336
if location is None:
409
337
if stored_loc is None:
410
338
raise BzrCommandError("No pull location known or specified.")
412
print "Using saved location: %s" % stored_loc
413
location = stored_loc
415
br_from = Branch.open(location)
416
br_to = tree_to.branch
418
old_rh = br_to.revision_history()
419
count = tree_to.pull(br_from, overwrite)
421
if br_to.get_parent() is None or remember:
422
br_to.set_parent(location)
423
note('%d revision(s) pulled.' % (count,))
426
new_rh = tree_to.branch.revision_history()
429
from bzrlib.log import show_changed_revisions
430
show_changed_revisions(tree_to.branch, old_rh, new_rh)
433
class cmd_push(Command):
434
"""Push this branch into another branch.
436
The remote branch will not have its working tree populated because this
437
is both expensive, and may not be supported on the remote file system.
439
Some smart servers or protocols *may* put the working tree in place.
441
If there is no default push location set, the first push will set it.
442
After that, you can omit the location to use the default. To change the
443
default, use --remember.
445
This command only works on branches that have not diverged. Branches are
446
considered diverged if the branch being pushed to is not an older version
449
If branches have diverged, you can use 'bzr push --overwrite' to replace
450
the other branch completely.
452
If you want to ensure you have the different changes in the other branch,
453
do a merge (see bzr help merge) from the other branch, and commit that
454
before doing a 'push --overwrite'.
456
takes_options = ['remember', 'overwrite',
457
Option('create-prefix',
458
help='Create the path leading up to the branch '
459
'if it does not already exist')]
460
takes_args = ['location?']
462
def run(self, location=None, remember=False, overwrite=False,
463
create_prefix=False, verbose=False):
464
# FIXME: Way too big! Put this into a function called from the
467
from shutil import rmtree
468
from bzrlib.transport import get_transport
470
tree_from = WorkingTree.open_containing(u'.')[0]
471
br_from = tree_from.branch
472
stored_loc = tree_from.branch.get_push_location()
474
if stored_loc is None:
475
raise BzrCommandError("No push location known or specified.")
477
print "Using saved location: %s" % stored_loc
478
location = stored_loc
480
br_to = Branch.open(location)
481
except NotBranchError:
483
transport = get_transport(location).clone('..')
484
if not create_prefix:
486
transport.mkdir(transport.relpath(location))
488
raise BzrCommandError("Parent directory of %s "
489
"does not exist." % location)
491
current = transport.base
492
needed = [(transport, transport.relpath(location))]
495
transport, relpath = needed[-1]
496
transport.mkdir(relpath)
499
new_transport = transport.clone('..')
500
needed.append((new_transport,
501
new_transport.relpath(transport.base)))
502
if new_transport.base == transport.base:
503
raise BzrCommandError("Could not creeate "
505
br_to = Branch.initialize(location)
506
old_rh = br_to.revision_history()
340
print "Using last location: %s" % stored_loc
341
location = stored_loc
342
cache_root = tempfile.mkdtemp()
343
from bzrlib.errors import DivergedBranches
344
br_from = Branch.open_containing(location)
345
location = br_from.base
346
old_revno = br_to.revno()
348
from bzrlib.errors import DivergedBranches
349
br_from = Branch.open(location)
350
br_from.setup_caching(cache_root)
351
location = br_from.base
352
old_revno = br_to.revno()
509
tree_to = br_to.working_tree()
510
except NoWorkingTree:
511
# TODO: This should be updated for branches which don't have a
512
# working tree, as opposed to ones where we just couldn't
514
warning('Unable to update the working tree of: %s' % (br_to.base,))
515
count = br_to.pull(br_from, overwrite)
517
count = tree_to.pull(br_from, overwrite)
518
except DivergedBranches:
519
raise BzrCommandError("These branches have diverged."
520
" Try a merge then push with overwrite.")
521
if br_from.get_push_location() is None or remember:
522
br_from.set_push_location(location)
523
note('%d revision(s) pushed.' % (count,))
354
br_to.update_revisions(br_from)
355
except DivergedBranches:
356
raise BzrCommandError("These branches have diverged."
359
merge(('.', -1), ('.', old_revno), check_clean=False)
360
if location != stored_loc:
361
br_to.set_parent(location)
526
new_rh = br_to.revision_history()
529
from bzrlib.log import show_changed_revisions
530
show_changed_revisions(br_to, old_rh, new_rh)
533
367
class cmd_branch(Command):
594
427
copy_branch(br_from, to_location, revision_id, basis_branch)
595
428
except bzrlib.errors.NoSuchRevision:
596
429
rmtree(to_location)
597
msg = "The branch %s has no revision %s." % (from_location, revision[0])
430
msg = "The branch %s has no revision %d." % (from_location, revision[0])
598
431
raise BzrCommandError(msg)
599
432
except bzrlib.errors.UnlistableBranch:
601
433
msg = "The branch %s cannot be used as a --basis"
602
raise BzrCommandError(msg)
603
branch = Branch.open(to_location)
605
name = StringIO(name)
606
branch.put_controlfile('branch-name', name)
607
note('Branched %d revision(s).' % branch.revno())
612
438
class cmd_renames(Command):
613
439
"""Show list of renamed files.
441
TODO: Option to show renames between two historical versions.
443
TODO: Only show renames under dir, rather than in the whole branch.
615
# TODO: Option to show renames between two historical versions.
617
# TODO: Only show renames under dir, rather than in the whole branch.
618
445
takes_args = ['dir?']
621
def run(self, dir=u'.'):
622
tree = WorkingTree.open_containing(dir)[0]
623
old_inv = tree.branch.basis_tree().inventory
624
new_inv = tree.read_working_inventory()
447
def run(self, dir='.'):
448
b = Branch.open_containing(dir)
449
old_inv = b.basis_tree().inventory
450
new_inv = b.read_working_inventory()
626
452
renames = list(bzrlib.tree.find_renames(old_inv, new_inv))
749
566
If files are listed, only the changes in those files are listed.
750
567
Otherwise, all changes for the tree are listed.
569
TODO: Allow diff across branches.
571
TODO: Option to use external diff command; could be GNU diff, wdiff,
574
TODO: Python difflib is not exactly the same as unidiff; should
575
either fix it up or prefer to use an external diff.
577
TODO: If a directory is given, diff everything under that.
579
TODO: Selected-file diff is inefficient and doesn't show you
582
TODO: This probably handles non-Unix newlines poorly.
757
# TODO: Allow diff across branches.
758
# TODO: Option to use external diff command; could be GNU diff, wdiff,
759
# or a graphical diff.
761
# TODO: Python difflib is not exactly the same as unidiff; should
762
# either fix it up or prefer to use an external diff.
764
# TODO: If a directory is given, diff everything under that.
766
# TODO: Selected-file diff is inefficient and doesn't show you
769
# TODO: This probably handles non-Unix newlines poorly.
771
590
takes_args = ['file*']
772
591
takes_options = ['revision', 'diff-options']
773
592
aliases = ['di', 'dif']
776
594
def run(self, revision=None, file_list=None, diff_options=None):
777
595
from bzrlib.diff import show_diff
779
tree, file_list = internal_tree_files(file_list)
782
except FileInWrongBranch:
783
if len(file_list) != 2:
784
raise BzrCommandError("Files are in different branches")
786
b, file1 = Branch.open_containing(file_list[0])
787
b2, file2 = Branch.open_containing(file_list[1])
788
if file1 != "" or file2 != "":
789
# FIXME diff those two files. rbc 20051123
790
raise BzrCommandError("Files are in different branches")
598
b = Branch.open_containing(file_list[0])
599
file_list = [b.relpath(f) for f in file_list]
600
if file_list == ['']:
601
# just pointing to top-of-tree
604
b = Branch.open_containing('.')
792
606
if revision is not None:
794
raise BzrCommandError("Can't specify -r with two branches")
795
607
if len(revision) == 1:
796
return show_diff(tree.branch, revision[0], specific_files=file_list,
797
external_diff_options=diff_options)
608
show_diff(b, revision[0], specific_files=file_list,
609
external_diff_options=diff_options)
798
610
elif len(revision) == 2:
799
return show_diff(tree.branch, revision[0], specific_files=file_list,
800
external_diff_options=diff_options,
801
revision2=revision[1])
611
show_diff(b, revision[0], specific_files=file_list,
612
external_diff_options=diff_options,
613
revision2=revision[1])
803
615
raise BzrCommandError('bzr diff --revision takes exactly one or two revision identifiers')
806
return show_diff(b, None, specific_files=file_list,
807
external_diff_options=diff_options, b2=b2)
809
return show_diff(tree.branch, None, specific_files=file_list,
810
external_diff_options=diff_options)
617
show_diff(b, None, specific_files=file_list,
618
external_diff_options=diff_options)
813
623
class cmd_deleted(Command):
814
624
"""List files deleted in the working tree.
626
TODO: Show files deleted since a previous revision, or between two revisions.
816
# TODO: Show files deleted since a previous revision, or
817
# between two revisions.
818
# TODO: Much more efficient way to do this: read in new
819
# directories with readdir, rather than stating each one. Same
820
# level of effort but possibly much less IO. (Or possibly not,
821
# if the directories are very large...)
823
628
def run(self, show_ids=False):
824
tree = WorkingTree.open_containing(u'.')[0]
825
old = tree.branch.basis_tree()
629
b = Branch.open_containing('.')
631
new = b.working_tree()
633
## TODO: Much more efficient way to do this: read in new
634
## directories with readdir, rather than stating each one. Same
635
## level of effort but possibly much less IO. (Or possibly not,
636
## if the directories are very large...)
826
638
for path, ie in old.inventory.iter_entries():
827
if not tree.has_id(ie.file_id):
639
if not new.has_id(ie.file_id):
829
641
print '%-50s %s' % (path, ie.file_id)
870
681
The root is the nearest enclosing directory with a .bzr control
872
683
takes_args = ['filename?']
874
684
def run(self, filename=None):
875
685
"""Print the branch root."""
876
tree = WorkingTree.open_containing(filename)[0]
686
b = Branch.open_containing(filename)
880
690
class cmd_log(Command):
881
691
"""Show log of this branch.
883
To request a range of logs, you can use the command -r begin..end
884
-r revision requests a specific revision, -r ..end or -r begin.. are
693
To request a range of logs, you can use the command -r begin:end
694
-r revision requests a specific revision, -r :end or -r begin: are
697
--message allows you to give a regular expression, which will be evaluated
698
so that only matching entries will be displayed.
700
TODO: Make --revision support uuid: and hash: [future tag:] notation.
888
# TODO: Make --revision support uuid: and hash: [future tag:] notation.
890
704
takes_args = ['filename?']
891
takes_options = [Option('forward',
892
help='show from oldest to newest'),
893
'timezone', 'verbose',
894
'show-ids', 'revision',
897
help='show revisions whose message matches this regexp',
705
takes_options = ['forward', 'timezone', 'verbose', 'show-ids', 'revision',
706
'long', 'message', 'short',]
902
708
def run(self, filename=None, timezone='original',
992
777
A more user-friendly interface is "bzr log FILE"."""
994
779
takes_args = ["filename"]
996
780
def run(self, filename):
997
tree, relpath = WorkingTree.open_containing(filename)
999
inv = tree.read_working_inventory()
1000
file_id = inv.path2id(relpath)
781
b = Branch.open_containing(filename)
782
inv = b.read_working_inventory()
783
file_id = inv.path2id(b.relpath(filename))
1001
784
for revno, revision_id, what in bzrlib.log.find_touching_revisions(b, file_id):
1002
785
print "%6d %s" % (revno, what)
1005
788
class cmd_ls(Command):
1006
789
"""List files in a tree.
791
TODO: Take a revision or remote path and list that tree instead.
1008
# TODO: Take a revision or remote path and list that tree instead.
1010
takes_options = ['verbose', 'revision',
1011
Option('non-recursive',
1012
help='don\'t recurse into sub-directories'),
1014
help='Print all paths from the root of the branch.'),
1015
Option('unknown', help='Print unknown files'),
1016
Option('versioned', help='Print versioned files'),
1017
Option('ignored', help='Print ignored files'),
1019
Option('null', help='Null separate the files'),
1022
def run(self, revision=None, verbose=False,
1023
non_recursive=False, from_root=False,
1024
unknown=False, versioned=False, ignored=False,
1027
if verbose and null:
1028
raise BzrCommandError('Cannot set both --verbose and --null')
1029
all = not (unknown or versioned or ignored)
1031
selection = {'I':ignored, '?':unknown, 'V':versioned}
1033
tree, relpath = WorkingTree.open_containing(u'.')
1038
if revision is not None:
1039
tree = tree.branch.revision_tree(
1040
revision[0].in_history(tree.branch).rev_id)
1041
for fp, fc, kind, fid, entry in tree.list_files():
1042
if fp.startswith(relpath):
1043
fp = fp[len(relpath):]
1044
if non_recursive and '/' in fp:
1046
if not all and not selection[fc]:
1049
kindch = entry.kind_character()
1050
print '%-8s %s%s' % (fc, fp, kindch)
1052
sys.stdout.write(fp)
1053
sys.stdout.write('\0')
794
def run(self, revision=None, verbose=False):
795
b = Branch.open_containing('.')
797
tree = b.working_tree()
799
tree = b.revision_tree(revision.in_history(b).rev_id)
801
for fp, fc, kind, fid in tree.list_files():
803
if kind == 'directory':
810
print '%-8s %s%s' % (fc, fp, kindch)
1059
816
class cmd_unknowns(Command):
1060
817
"""List unknown files."""
1063
819
from bzrlib.osutils import quotefn
1064
for f in WorkingTree.open_containing(u'.')[0].unknowns():
820
for f in Branch.open_containing('.').unknowns():
1065
821
print quotefn(f)
1068
825
class cmd_ignore(Command):
1069
826
"""Ignore a command or pattern.
1071
828
To remove patterns from the ignore list, edit the .bzrignore file.
1073
830
If the pattern contains a slash, it is compared to the whole path
1074
from the branch root. Otherwise, it is compared to only the last
1075
component of the path. To match a file only in the root directory,
831
from the branch root. Otherwise, it is comapred to only the last
832
component of the path.
1078
834
Ignore patterns are case-insensitive on case-insensitive systems.
1168
922
is found exports to a directory (equivalent to --format=dir).
1170
924
Root may be the top directory for tar, tgz and tbz2 formats. If none
1171
is given, the top directory will be the root name of the file.
1173
Note: export of tree with non-ascii filenames to zip is not supported.
1175
Supported formats Autodetected by extension
1176
----------------- -------------------------
1179
tbz2 .tar.bz2, .tbz2
925
is given, the top directory will be the root name of the file."""
926
# TODO: list known exporters
1183
927
takes_args = ['dest']
1184
928
takes_options = ['revision', 'format', 'root']
1185
929
def run(self, dest, revision=None, format=None, root=None):
1187
from bzrlib.export import export
1188
tree = WorkingTree.open_containing(u'.')[0]
931
b = Branch.open_containing('.')
1190
932
if revision is None:
1191
# should be tree.last_revision FIXME
1192
933
rev_id = b.last_revision()
1194
935
if len(revision) != 1:
1195
936
raise BzrError('bzr export --revision takes exactly 1 argument')
1196
937
rev_id = revision[0].in_history(b).rev_id
1197
938
t = b.revision_tree(rev_id)
1199
export(t, dest, format, root)
1200
except errors.NoSuchExportFormat, e:
1201
raise BzrCommandError('Unsupported export format: %s' % e.format)
939
root, ext = os.path.splitext(dest)
943
elif ext in (".gz", ".tgz"):
945
elif ext in (".bz2", ".tbz2"):
949
t.export(dest, format, root)
1204
952
class cmd_cat(Command):
1248
984
A selected-file commit may fail in some cases where the committed
1249
985
tree would be invalid, such as trying to commit a file in a
1250
986
newly-added directory that is not itself committed.
988
TODO: Run hooks on tree to-be-committed, and after commit.
990
TODO: Strict commit that fails if there are unknown or deleted files.
1252
# TODO: Run hooks on tree to-be-committed, and after commit.
1254
# TODO: Strict commit that fails if there are deleted files.
1255
# (what does "deleted files" mean ??)
992
takes_args = ['selected*']
993
takes_options = ['message', 'file', 'verbose', 'unchanged']
994
aliases = ['ci', 'checkin']
1257
996
# TODO: Give better message for -s, --summary, used by tla people
1259
998
# XXX: verbose currently does nothing
1261
takes_args = ['selected*']
1262
takes_options = ['message', 'verbose',
1264
help='commit even if nothing has changed'),
1265
Option('file', type=str,
1267
help='file containing commit message'),
1269
help="refuse to commit if there are unknown "
1270
"files in the working tree."),
1272
aliases = ['ci', 'checkin']
1274
1000
def run(self, message=None, file=None, verbose=True, selected_list=None,
1275
unchanged=False, strict=False):
1276
from bzrlib.errors import (PointlessCommit, ConflictsInTree,
1278
from bzrlib.msgeditor import edit_commit_message, \
1279
make_commit_message_template
1002
from bzrlib.errors import PointlessCommit
1003
from bzrlib.msgeditor import edit_commit_message
1280
1004
from bzrlib.status import show_status
1281
from tempfile import TemporaryFile
1284
# TODO: Need a blackbox test for invoking the external editor; may be
1285
# slightly problematic to run this cross-platform.
1287
# TODO: do more checks that the commit will succeed before
1288
# spending the user's valuable time typing a commit message.
1290
# TODO: if the commit *does* happen to fail, then save the commit
1291
# message to a temporary file where it can be recovered
1292
tree, selected_list = tree_files(selected_list)
1293
if message is None and not file:
1294
template = make_commit_message_template(tree, selected_list)
1295
message = edit_commit_message(template)
1005
from cStringIO import StringIO
1007
b = Branch.open_containing('.')
1009
selected_list = [b.relpath(s) for s in selected_list]
1011
if not message and not file:
1012
catcher = StringIO()
1013
show_status(b, specific_files=selected_list,
1015
message = edit_commit_message(catcher.getvalue())
1296
1017
if message is None:
1297
1018
raise BzrCommandError("please specify a commit message"
1298
1019
" with either --message or --file")
1382
1089
"""Show bzr user id."""
1383
1090
takes_options = ['email']
1386
1092
def run(self, email=False):
1388
b = WorkingTree.open_containing(u'.')[0].branch
1389
config = bzrlib.config.BranchConfig(b)
1094
b = bzrlib.branch.Branch.open_containing('.')
1390
1095
except NotBranchError:
1391
config = bzrlib.config.GlobalConfig()
1394
print config.user_email()
1396
print config.username()
1398
class cmd_nick(Command):
1400
Print or set the branch nickname.
1401
If unset, the tree root directory name is used as the nickname
1402
To print the current nickname, execute with no argument.
1404
takes_args = ['nickname?']
1405
def run(self, nickname=None):
1406
branch = Branch.open_containing(u'.')[0]
1407
if nickname is None:
1408
self.printme(branch)
1410
branch.nick = nickname
1413
def printme(self, branch):
1099
print bzrlib.osutils.user_email(b)
1101
print bzrlib.osutils.username(b)
1416
1104
class cmd_selftest(Command):
1417
"""Run internal test suite.
1419
This creates temporary test directories in the working directory,
1420
but not existing data is affected. These directories are deleted
1421
if the tests pass, or left behind to help in debugging if they
1422
fail and --keep-output is specified.
1424
If arguments are given, they are regular expressions that say
1425
which tests should run.
1427
# TODO: --list should give a list of all available tests
1105
"""Run internal test suite"""
1429
takes_args = ['testspecs*']
1430
takes_options = ['verbose',
1431
Option('one', help='stop when one test fails'),
1432
Option('keep-output',
1433
help='keep output directories when tests fail')
1436
def run(self, testspecs_list=None, verbose=False, one=False,
1107
takes_options = ['verbose', 'pattern']
1108
def run(self, verbose=False, pattern=".*"):
1438
1109
import bzrlib.ui
1439
from bzrlib.tests import selftest
1110
from bzrlib.selftest import selftest
1440
1111
# we don't want progress meters from the tests to go to the
1441
1112
# real output; and we don't want log messages cluttering up
1442
1113
# the real logs.
1576
1219
--force is given.
1578
1221
takes_args = ['branch?']
1579
takes_options = ['revision', 'force', 'merge-type', 'reprocess',
1580
Option('show-base', help="Show base revision text in "
1222
takes_options = ['revision', 'force', 'merge-type']
1583
def run(self, branch=None, revision=None, force=False, merge_type=None,
1584
show_base=False, reprocess=False):
1224
def run(self, branch='.', revision=None, force=False,
1585
1226
from bzrlib.merge import merge
1586
1227
from bzrlib.merge_core import ApplyMerge3
1587
1228
if merge_type is None:
1588
1229
merge_type = ApplyMerge3
1590
branch = WorkingTree.open_containing(u'.')[0].branch.get_parent()
1592
raise BzrCommandError("No merge location known or specified.")
1594
print "Using saved location: %s" % branch
1595
1231
if revision is None or len(revision) < 1:
1596
1232
base = [None, None]
1597
1233
other = [branch, -1]
1599
1235
if len(revision) == 1:
1600
1236
base = [None, None]
1601
other_branch = Branch.open_containing(branch)[0]
1602
revno = revision[0].in_history(other_branch).revno
1603
other = [branch, revno]
1237
other = [branch, revision[0].in_history(branch).revno]
1605
1239
assert len(revision) == 2
1606
1240
if None in revision:
1607
1241
raise BzrCommandError(
1608
1242
"Merge doesn't permit that revision specifier.")
1609
b = Branch.open_containing(branch)[0]
1243
from bzrlib.branch import Branch
1244
b = Branch.open(branch)
1611
1246
base = [branch, revision[0].in_history(b).revno]
1612
1247
other = [branch, revision[1].in_history(b).revno]
1615
conflict_count = merge(other, base, check_clean=(not force),
1616
merge_type=merge_type, reprocess=reprocess,
1617
show_base=show_base)
1618
if conflict_count != 0:
1250
merge(other, base, check_clean=(not force), merge_type=merge_type)
1622
1251
except bzrlib.errors.AmbiguousBase, e:
1623
1252
m = ("sorry, bzr can't determine the right merge base yet\n"
1624
1253
"candidates are:\n "
1632
class cmd_remerge(Command):
1635
takes_args = ['file*']
1636
takes_options = ['merge-type', 'reprocess',
1637
Option('show-base', help="Show base revision text in "
1640
def run(self, file_list=None, merge_type=None, show_base=False,
1642
from bzrlib.merge import merge_inner, transform_tree
1643
from bzrlib.merge_core import ApplyMerge3
1644
if merge_type is None:
1645
merge_type = ApplyMerge3
1646
tree, file_list = tree_files(file_list)
1649
pending_merges = tree.pending_merges()
1650
if len(pending_merges) != 1:
1651
raise BzrCommandError("Sorry, remerge only works after normal"
1652
+ " merges. Not cherrypicking or"
1654
base_revision = common_ancestor(tree.branch.last_revision(),
1655
pending_merges[0], tree.branch)
1656
base_tree = tree.branch.revision_tree(base_revision)
1657
other_tree = tree.branch.revision_tree(pending_merges[0])
1658
interesting_ids = None
1659
if file_list is not None:
1660
interesting_ids = set()
1661
for filename in file_list:
1662
file_id = tree.path2id(filename)
1663
interesting_ids.add(file_id)
1664
if tree.kind(file_id) != "directory":
1667
for name, ie in tree.inventory.iter_entries(file_id):
1668
interesting_ids.add(ie.file_id)
1669
transform_tree(tree, tree.branch.basis_tree(), interesting_ids)
1670
if file_list is None:
1671
restore_files = list(tree.iter_conflicts())
1673
restore_files = file_list
1674
for filename in restore_files:
1676
restore(tree.abspath(filename))
1677
except NotConflicted:
1679
conflicts = merge_inner(tree.branch, other_tree, base_tree,
1680
interesting_ids = interesting_ids,
1681
other_rev_id=pending_merges[0],
1682
merge_type=merge_type,
1683
show_base=show_base,
1684
reprocess=reprocess)
1692
1261
class cmd_revert(Command):
1693
1262
"""Reverse all changes since the last commit.
1701
1270
aliases = ['merge-revert']
1703
1272
def run(self, revision=None, no_backup=False, file_list=None):
1704
from bzrlib.merge import merge_inner
1273
from bzrlib.merge import merge
1274
from bzrlib.branch import Branch
1705
1275
from bzrlib.commands import parse_spec
1706
1277
if file_list is not None:
1707
1278
if len(file_list) == 0:
1708
1279
raise BzrCommandError("No files specified")
1711
1280
if revision is None:
1713
tree = WorkingTree.open_containing(u'.')[0]
1714
# FIXME should be tree.last_revision
1715
rev_id = tree.branch.last_revision()
1716
1282
elif len(revision) != 1:
1717
1283
raise BzrCommandError('bzr revert --revision takes exactly 1 argument')
1719
tree, file_list = tree_files(file_list)
1720
rev_id = revision[0].in_history(tree.branch).rev_id
1721
tree.revert(file_list, tree.branch.revision_tree(rev_id),
1285
b = Branch.open_containing('.')
1286
revno = revision[0].in_history(b).revno
1287
merge(('.', revno), parse_spec('.'),
1290
backup_files=not no_backup,
1291
file_list=file_list)
1293
Branch.open_containing('.').set_pending_merges([])
1725
1296
class cmd_assert_fail(Command):
1768
1337
def run(self, from_branch, to_branch):
1769
1338
from bzrlib.fetch import Fetcher
1770
1339
from bzrlib.branch import Branch
1771
from_b = Branch.open(from_branch)
1772
to_b = Branch.open(to_branch)
1777
Fetcher(to_b, from_b)
1340
from_b = Branch(from_branch)
1341
to_b = Branch(to_branch)
1342
Fetcher(to_b, from_b)
1784
1346
class cmd_missing(Command):
1785
"""Show unmerged/unpulled revisions between two branches.
1787
OTHER_BRANCH may be local or remote."""
1788
takes_args = ['other_branch?']
1789
takes_options = [Option('reverse', 'Reverse the order of revisions'),
1791
'Display changes in the local branch only'),
1792
Option('theirs-only',
1793
'Display changes in the remote branch only'),
1801
def run(self, other_branch=None, reverse=False, mine_only=False,
1802
theirs_only=False, long=True, short=False, line=False,
1803
show_ids=False, verbose=False):
1804
from bzrlib.missing import find_unmerged, iter_log_data
1805
from bzrlib.log import log_formatter
1806
local_branch = bzrlib.branch.Branch.open_containing(u".")[0]
1807
parent = local_branch.get_parent()
1808
if other_branch is None:
1809
other_branch = parent
1810
if other_branch is None:
1347
"""What is missing in this branch relative to other branch.
1349
# TODO: rewrite this in terms of ancestry so that it shows only
1352
takes_args = ['remote?']
1353
aliases = ['mis', 'miss']
1354
# We don't have to add quiet to the list, because
1355
# unknown options are parsed as booleans
1356
takes_options = ['verbose', 'quiet']
1358
def run(self, remote=None, verbose=False, quiet=False):
1359
from bzrlib.errors import BzrCommandError
1360
from bzrlib.missing import show_missing
1362
if verbose and quiet:
1363
raise BzrCommandError('Cannot pass both quiet and verbose')
1365
b = Branch.open_containing('.')
1366
parent = b.get_parent()
1811
1369
raise BzrCommandError("No missing location known or specified.")
1812
print "Using last location: " + local_branch.get_parent()
1813
remote_branch = bzrlib.branch.Branch.open(other_branch)
1814
local_extra, remote_extra = find_unmerged(local_branch, remote_branch)
1815
log_format = get_log_format(long=long, short=short, line=line)
1816
lf = log_formatter(log_format, sys.stdout,
1818
show_timezone='original')
1819
if reverse is False:
1820
local_extra.reverse()
1821
remote_extra.reverse()
1822
if local_extra and not theirs_only:
1823
print "You have %d extra revision(s):" % len(local_extra)
1824
for data in iter_log_data(local_extra, local_branch, verbose):
1826
printed_local = True
1828
printed_local = False
1829
if remote_extra and not mine_only:
1830
if printed_local is True:
1832
print "You are missing %d revision(s):" % len(remote_extra)
1833
for data in iter_log_data(remote_extra, remote_branch, verbose):
1835
if not remote_extra and not local_extra:
1837
print "Branches are up to date."
1840
if parent is None and other_branch is not None:
1841
local_branch.set_parent(other_branch)
1372
print "Using last location: %s" % parent
1374
elif parent is None:
1375
# We only update parent if it did not exist, missing
1376
# should not change the parent
1377
b.set_parent(remote)
1378
br_remote = Branch.open_containing(remote)
1380
return show_missing(b, br_remote, verbose=verbose, quiet=quiet)
1845
1384
class cmd_plugins(Command):
1846
1385
"""List plugins"""
1850
1388
import bzrlib.plugin
1851
1389
from inspect import getdoc
1852
for name, plugin in bzrlib.plugin.all_plugins().items():
1390
for plugin in bzrlib.plugin.all_plugins:
1853
1391
if hasattr(plugin, '__path__'):
1854
1392
print plugin.__path__[0]
1855
1393
elif hasattr(plugin, '__file__'):
1862
1400
print '\t', d.split('\n')[0]
1865
class cmd_testament(Command):
1866
"""Show testament (signing-form) of a revision."""
1867
takes_options = ['revision', 'long']
1868
takes_args = ['branch?']
1870
def run(self, branch=u'.', revision=None, long=False):
1871
from bzrlib.testament import Testament
1872
b = WorkingTree.open_containing(branch)[0].branch
1875
if revision is None:
1876
rev_id = b.last_revision()
1878
rev_id = revision[0].in_history(b).rev_id
1879
t = Testament.from_revision(b, rev_id)
1881
sys.stdout.writelines(t.as_text_lines())
1883
sys.stdout.write(t.as_short_text())
1888
class cmd_annotate(Command):
1889
"""Show the origin of each line in a file.
1891
This prints out the given file with an annotation on the left side
1892
indicating which revision, author and date introduced the change.
1894
If the origin is the same for a run of consecutive lines, it is
1895
shown only at the top, unless the --all option is given.
1897
# TODO: annotate directories; showing when each file was last changed
1898
# TODO: annotate a previous version of a file
1899
# TODO: if the working copy is modified, show annotations on that
1900
# with new uncommitted lines marked
1901
aliases = ['blame', 'praise']
1902
takes_args = ['filename']
1903
takes_options = [Option('all', help='show annotations on all lines'),
1904
Option('long', help='show date in annotations'),
1908
def run(self, filename, all=False, long=False):
1909
from bzrlib.annotate import annotate_file
1910
tree, relpath = WorkingTree.open_containing(filename)
1911
branch = tree.branch
1914
file_id = tree.inventory.path2id(relpath)
1915
tree = branch.revision_tree(branch.last_revision())
1916
file_version = tree.inventory[file_id].revision
1917
annotate_file(branch, file_version, file_id, long, all, sys.stdout)
1922
class cmd_re_sign(Command):
1923
"""Create a digital signature for an existing revision."""
1924
# TODO be able to replace existing ones.
1926
hidden = True # is this right ?
1927
takes_args = ['revision_id?']
1928
takes_options = ['revision']
1930
def run(self, revision_id=None, revision=None):
1931
import bzrlib.config as config
1932
import bzrlib.gpg as gpg
1933
if revision_id is not None and revision is not None:
1934
raise BzrCommandError('You can only supply one of revision_id or --revision')
1935
if revision_id is None and revision is None:
1936
raise BzrCommandError('You must supply either --revision or a revision_id')
1937
b = WorkingTree.open_containing(u'.')[0].branch
1938
gpg_strategy = gpg.GPGStrategy(config.BranchConfig(b))
1939
if revision_id is not None:
1940
b.sign_revision(revision_id, gpg_strategy)
1941
elif revision is not None:
1942
if len(revision) == 1:
1943
revno, rev_id = revision[0].in_history(b)
1944
b.sign_revision(rev_id, gpg_strategy)
1945
elif len(revision) == 2:
1946
# are they both on rh- if so we can walk between them
1947
# might be nice to have a range helper for arbitrary
1948
# revision paths. hmm.
1949
from_revno, from_revid = revision[0].in_history(b)
1950
to_revno, to_revid = revision[1].in_history(b)
1951
if to_revid is None:
1952
to_revno = b.revno()
1953
if from_revno is None or to_revno is None:
1954
raise BzrCommandError('Cannot sign a range of non-revision-history revisions')
1955
for revno in range(from_revno, to_revno + 1):
1956
b.sign_revision(b.get_rev_id(revno), gpg_strategy)
1958
raise BzrCommandError('Please supply either one revision, or a range.')
1961
class cmd_uncommit(bzrlib.commands.Command):
1962
"""Remove the last committed revision.
1964
By supplying the --all flag, it will not only remove the entry
1965
from revision_history, but also remove all of the entries in the
1968
--verbose will print out what is being removed.
1969
--dry-run will go through all the motions, but not actually
1972
In the future, uncommit will create a changeset, which can then
1975
takes_options = ['all', 'verbose', 'revision',
1976
Option('dry-run', help='Don\'t actually make changes'),
1977
Option('force', help='Say yes to all questions.')]
1978
takes_args = ['location?']
1981
def run(self, location=None, all=False,
1982
dry_run=False, verbose=False,
1983
revision=None, force=False):
1984
from bzrlib.branch import Branch
1985
from bzrlib.log import log_formatter
1987
from bzrlib.uncommit import uncommit
1989
if location is None:
1991
b, relpath = Branch.open_containing(location)
1993
if revision is None:
1995
rev_id = b.last_revision()
1997
revno, rev_id = revision[0].in_history(b)
1999
print 'No revisions to uncommit.'
2001
for r in range(revno, b.revno()+1):
2002
rev_id = b.get_rev_id(r)
2003
lf = log_formatter('short', to_file=sys.stdout,show_timezone='original')
2004
lf.show(r, b.get_revision(rev_id), None)
2007
print 'Dry-run, pretending to remove the above revisions.'
2009
val = raw_input('Press <enter> to continue')
2011
print 'The above revision(s) will be removed.'
2013
val = raw_input('Are you sure [y/N]? ')
2014
if val.lower() not in ('y', 'yes'):
2018
uncommit(b, remove_files=all,
2019
dry_run=dry_run, verbose=verbose,
2023
# these get imported and then picked up by the scan for cmd_*
2024
# TODO: Some more consistent way to split command definitions across files;
2025
# we do need to load at least some information about them to know of
2027
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore