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
25
from bzrlib.branch import find_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.
108
62
directory is shown. Otherwise, only the status of the specified
109
63
files or directories is reported. If a directory is given, status
110
64
is reported for everything inside that directory.
66
# XXX: FIXME: bzr status should accept a -r option to show changes
67
# relative to a revision, or between revisions
112
If a revision argument is given, the status is calculated against
113
that revision, or between two revisions if two are provided.
116
# TODO: --no-recurse, --recurse options
118
69
takes_args = ['file*']
119
takes_options = ['all', 'show-ids', 'revision']
70
takes_options = ['all', 'show-ids']
120
71
aliases = ['st', 'stat']
123
def run(self, all=False, show_ids=False, file_list=None, revision=None):
124
tree, file_list = tree_files(file_list)
73
def run(self, all=False, show_ids=False, file_list=None):
75
b = find_branch(file_list[0])
76
file_list = [b.relpath(x) for x in file_list]
77
# special case: only one path was given and it's the root
126
84
from bzrlib.status import show_status
127
show_status(tree.branch, show_unchanged=all, show_ids=show_ids,
128
specific_files=file_list, revision=revision)
85
show_status(b, show_unchanged=all, show_ids=show_ids,
86
specific_files=file_list)
131
89
class cmd_cat_revision(Command):
132
"""Write out metadata for a revision.
134
The revision to print can either be specified by a specific
135
revision identifier, or you can use --revision.
90
"""Write out metadata for a revision."""
139
takes_args = ['revision_id?']
140
takes_options = ['revision']
93
takes_args = ['revision_id']
143
def run(self, revision_id=None, revision=None):
95
def run(self, revision_id):
97
sys.stdout.write(b.get_revision_xml_file(revision_id).read())
145
if revision_id is not None and revision is not None:
146
raise BzrCommandError('You can only supply one of revision_id or --revision')
147
if revision_id is None and revision is None:
148
raise BzrCommandError('You must supply either --revision or a revision_id')
149
b = WorkingTree.open_containing(u'.')[0].branch
150
if revision_id is not None:
151
sys.stdout.write(b.repository.get_revision_xml(revision_id))
152
elif revision is not None:
155
raise BzrCommandError('You cannot specify a NULL revision.')
156
revno, rev_id = rev.in_history(b)
157
sys.stdout.write(b.repository.get_revision_xml(rev_id))
160
100
class cmd_revno(Command):
161
101
"""Show current revision number.
163
103
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()
105
print find_branch('.').revno()
170
108
class cmd_revision_info(Command):
217
150
implicitly add the parent, and so on up to the root. This means
218
151
you should never need to explictly add a directory, they'll just
219
152
get added when you add a file in the directory.
221
--dry-run will show which files would be added, but not actually
224
154
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"\
155
takes_options = ['verbose', 'no-recurse']
157
def run(self, file_list, verbose=False, no_recurse=False):
158
# verbose currently has no effect
159
from bzrlib.add import smart_add, add_reporter_print
160
smart_add(file_list, not no_recurse, add_reporter_print)
256
164
class cmd_mkdir(Command):
273
184
takes_args = ['filename']
277
187
def run(self, filename):
278
tree, relpath = WorkingTree.open_containing(filename)
188
print find_branch(filename).relpath(filename)
282
192
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']
193
"""Show inventory of the current working copy or a revision."""
194
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]
296
inv = tree.read_working_inventory()
196
def run(self, revision=None, show_ids=False):
199
inv = b.read_working_inventory()
298
201
if len(revision) > 1:
299
202
raise BzrCommandError('bzr inventory --revision takes'
300
203
' exactly one revision identifier')
301
inv = tree.branch.repository.get_revision_inventory(
302
revision[0].in_history(tree.branch).rev_id)
204
inv = b.get_revision_inventory(b.lookup_revision(revision[0]))
304
206
for path, entry in inv.entries():
305
if kind and kind != entry.kind:
308
208
print '%-50s %s' % (path, entry.file_id)
363
265
def run(self, names_list):
364
266
if len(names_list) < 2:
365
267
raise BzrCommandError("missing file argument")
366
tree, rel_names = tree_files(names_list)
268
b = find_branch(names_list[0])
270
rel_names = [b.relpath(x) for x in names_list]
368
272
if os.path.isdir(names_list[-1]):
369
273
# move into existing directory
370
for pair in tree.move(rel_names[:-1], rel_names[-1]):
274
for pair in b.move(rel_names[:-1], rel_names[-1]):
371
275
print "%s => %s" % pair
373
277
if len(names_list) != 2:
374
278
raise BzrCommandError('to mv multiple files the destination '
375
279
'must be a versioned directory')
376
tree.rename_one(rel_names[0], rel_names[1])
280
b.rename_one(rel_names[0], rel_names[1])
377
281
print "%s => %s" % (rel_names[0], rel_names[1])
380
286
class cmd_pull(Command):
381
287
"""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.
289
If the location is omitted, the last-used location will be used.
290
Both the revision history and the working directory will be
387
293
This command only works on branches that have not diverged. Branches are
388
294
considered diverged if both branches have had commits without first
389
295
pulling from the other.
391
297
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.
298
from one into the other.
398
takes_options = ['remember', 'overwrite', 'verbose']
399
300
takes_args = ['location?']
401
def run(self, location=None, remember=False, overwrite=False, verbose=False):
302
def run(self, location=None):
402
303
from bzrlib.merge import merge
403
305
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()
308
br_to = find_branch('.')
309
stored_loc = br_to.get_parent()
408
310
if location is None:
409
311
if stored_loc is None:
410
312
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()
314
print "Using last location: %s" % stored_loc
315
location = stored_loc
316
cache_root = tempfile.mkdtemp()
317
from bzrlib.branch import DivergedBranches
318
br_from = find_branch(location)
319
location = br_from.base
320
old_revno = br_to.revno()
322
from branch import find_cached_branch, DivergedBranches
323
br_from = find_cached_branch(location, cache_root)
324
location = br_from.base
325
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,))
327
br_to.update_revisions(br_from)
328
except DivergedBranches:
329
raise BzrCommandError("These branches have diverged."
332
merge(('.', -1), ('.', old_revno), check_clean=False)
333
if location != stored_loc:
334
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
340
class cmd_branch(Command):
539
346
To retrieve the branch as of a particular revision, supply the --revision
540
347
parameter, as in "branch foo/bar -r 5".
542
--basis is to speed up branching from remote branches. When specified, it
543
copies all the file-contents, inventory and revision data from the basis
544
branch before copying anything from the remote branch.
546
349
takes_args = ['from_location', 'to_location?']
547
takes_options = ['revision', 'basis']
350
takes_options = ['revision']
548
351
aliases = ['get', 'clone']
550
def run(self, from_location, to_location=None, revision=None, basis=None):
353
def run(self, from_location, to_location=None, revision=None):
354
from bzrlib.branch import copy_branch, find_cached_branch
552
357
from shutil import rmtree
555
elif len(revision) > 1:
556
raise BzrCommandError(
557
'bzr branch --revision takes exactly 1 revision value')
559
br_from = Branch.open(from_location)
561
if e.errno == errno.ENOENT:
562
raise BzrCommandError('Source location "%s" does not'
563
' exist.' % to_location)
568
if basis is not None:
569
basis_branch = WorkingTree.open_containing(basis)[0].branch
572
if len(revision) == 1 and revision[0] is not None:
573
revision_id = revision[0].in_history(br_from)[1]
358
cache_root = tempfile.mkdtemp()
362
elif len(revision) > 1:
363
raise BzrCommandError(
364
'bzr branch --revision takes exactly 1 revision value')
366
br_from = find_cached_branch(from_location, cache_root)
368
if e.errno == errno.ENOENT:
369
raise BzrCommandError('Source location "%s" does not'
370
' exist.' % to_location)
576
373
if to_location is None:
577
374
to_location = os.path.basename(from_location.rstrip("/\\"))
580
name = os.path.basename(to_location) + '\n'
582
376
os.mkdir(to_location)
583
377
except OSError, e:
593
br_from.clone(to_location, revision_id, basis_branch)
387
copy_branch(br_from, to_location, revision[0])
594
388
except bzrlib.errors.NoSuchRevision:
595
389
rmtree(to_location)
596
msg = "The branch %s has no revision %s." % (from_location, revision[0])
597
raise BzrCommandError(msg)
598
except bzrlib.errors.UnlistableBranch:
600
msg = "The branch %s cannot be used as a --basis"
601
raise BzrCommandError(msg)
602
branch = Branch.open(to_location)
604
name = StringIO(name)
607
branch.control_files.put_utf8('branch-name', name)
611
note('Branched %d revision(s).' % branch.revno())
390
msg = "The branch %s has no revision %d." % (from_location, revision[0])
391
raise BzrCommandError(msg)
616
396
class cmd_renames(Command):
617
397
"""Show list of renamed files.
399
TODO: Option to show renames between two historical versions.
401
TODO: Only show renames under dir, rather than in the whole branch.
619
# TODO: Option to show renames between two historical versions.
621
# TODO: Only show renames under dir, rather than in the whole branch.
622
403
takes_args = ['dir?']
625
def run(self, dir=u'.'):
626
tree = WorkingTree.open_containing(dir)[0]
627
old_inv = tree.branch.basis_tree().inventory
628
new_inv = tree.read_working_inventory()
405
def run(self, dir='.'):
407
old_inv = b.basis_tree().inventory
408
new_inv = b.read_working_inventory()
630
410
renames = list(bzrlib.tree.find_renames(old_inv, new_inv))
753
515
If files are listed, only the changes in those files are listed.
754
516
Otherwise, all changes for the tree are listed.
518
TODO: Allow diff across branches.
520
TODO: Option to use external diff command; could be GNU diff, wdiff,
523
TODO: Python difflib is not exactly the same as unidiff; should
524
either fix it up or prefer to use an external diff.
526
TODO: If a directory is given, diff everything under that.
528
TODO: Selected-file diff is inefficient and doesn't show you
531
TODO: This probably handles non-Unix newlines poorly.
761
# TODO: Allow diff across branches.
762
# TODO: Option to use external diff command; could be GNU diff, wdiff,
763
# or a graphical diff.
765
# TODO: Python difflib is not exactly the same as unidiff; should
766
# either fix it up or prefer to use an external diff.
768
# TODO: If a directory is given, diff everything under that.
770
# TODO: Selected-file diff is inefficient and doesn't show you
773
# TODO: This probably handles non-Unix newlines poorly.
775
539
takes_args = ['file*']
776
540
takes_options = ['revision', 'diff-options']
777
541
aliases = ['di', 'dif']
780
543
def run(self, revision=None, file_list=None, diff_options=None):
781
544
from bzrlib.diff import show_diff
783
tree, file_list = internal_tree_files(file_list)
786
except FileInWrongBranch:
787
if len(file_list) != 2:
788
raise BzrCommandError("Files are in different branches")
790
b, file1 = Branch.open_containing(file_list[0])
791
b2, file2 = Branch.open_containing(file_list[1])
792
if file1 != "" or file2 != "":
793
# FIXME diff those two files. rbc 20051123
794
raise BzrCommandError("Files are in different branches")
547
b = find_branch(file_list[0])
548
file_list = [b.relpath(f) for f in file_list]
549
if file_list == ['']:
550
# just pointing to top-of-tree
796
555
if revision is not None:
798
raise BzrCommandError("Can't specify -r with two branches")
799
556
if len(revision) == 1:
800
return show_diff(tree.branch, revision[0], specific_files=file_list,
801
external_diff_options=diff_options)
557
show_diff(b, revision[0], specific_files=file_list,
558
external_diff_options=diff_options)
802
559
elif len(revision) == 2:
803
return show_diff(tree.branch, revision[0], specific_files=file_list,
804
external_diff_options=diff_options,
805
revision2=revision[1])
560
show_diff(b, revision[0], specific_files=file_list,
561
external_diff_options=diff_options,
562
revision2=revision[1])
807
564
raise BzrCommandError('bzr diff --revision takes exactly one or two revision identifiers')
810
return show_diff(b, None, specific_files=file_list,
811
external_diff_options=diff_options, b2=b2)
813
return show_diff(tree.branch, None, specific_files=file_list,
814
external_diff_options=diff_options)
566
show_diff(b, None, specific_files=file_list,
567
external_diff_options=diff_options)
817
572
class cmd_deleted(Command):
818
573
"""List files deleted in the working tree.
575
TODO: Show files deleted since a previous revision, or between two revisions.
820
# TODO: Show files deleted since a previous revision, or
821
# between two revisions.
822
# TODO: Much more efficient way to do this: read in new
823
# directories with readdir, rather than stating each one. Same
824
# level of effort but possibly much less IO. (Or possibly not,
825
# if the directories are very large...)
827
577
def run(self, show_ids=False):
828
tree = WorkingTree.open_containing(u'.')[0]
829
old = tree.branch.basis_tree()
580
new = b.working_tree()
582
## TODO: Much more efficient way to do this: read in new
583
## directories with readdir, rather than stating each one. Same
584
## level of effort but possibly much less IO. (Or possibly not,
585
## if the directories are very large...)
830
587
for path, ie in old.inventory.iter_entries():
831
if not tree.has_id(ie.file_id):
588
if not new.has_id(ie.file_id):
833
590
print '%-50s %s' % (path, ie.file_id)
874
630
The root is the nearest enclosing directory with a .bzr control
876
632
takes_args = ['filename?']
878
633
def run(self, filename=None):
879
634
"""Print the branch root."""
880
tree = WorkingTree.open_containing(filename)[0]
635
b = find_branch(filename)
884
639
class cmd_log(Command):
885
640
"""Show log of this branch.
887
To request a range of logs, you can use the command -r begin..end
888
-r revision requests a specific revision, -r ..end or -r begin.. are
642
To request a range of logs, you can use the command -r begin:end
643
-r revision requests a specific revision, -r :end or -r begin: are
646
--message allows you to give a regular expression, which will be evaluated
647
so that only matching entries will be displayed.
649
TODO: Make --revision support uuid: and hash: [future tag:] notation.
892
# TODO: Make --revision support uuid: and hash: [future tag:] notation.
894
653
takes_args = ['filename?']
895
takes_options = [Option('forward',
896
help='show from oldest to newest'),
897
'timezone', 'verbose',
898
'show-ids', 'revision',
901
help='show revisions whose message matches this regexp',
654
takes_options = ['forward', 'timezone', 'verbose', 'show-ids', 'revision',
655
'long', 'message', 'short',]
906
657
def run(self, filename=None, timezone='original',
915
665
from bzrlib.log import log_formatter, show_log
917
assert message is None or isinstance(message, basestring), \
918
"invalid message argument %r" % message
919
668
direction = (forward and 'forward') or 'reverse'
925
tree, fp = WorkingTree.open_containing(filename)
928
inv = tree.read_working_inventory()
929
except NotBranchError:
932
b, fp = Branch.open_containing(filename)
934
inv = b.repository.get_inventory(b.last_revision())
936
file_id = inv.path2id(fp)
671
b = find_branch(filename)
672
fp = b.relpath(filename)
674
file_id = b.read_working_inventory().path2id(fp)
938
676
file_id = None # points to branch root
940
tree, relpath = WorkingTree.open_containing(u'.')
944
681
if revision is None:
947
684
elif len(revision) == 1:
948
rev1 = rev2 = revision[0].in_history(b).revno
685
rev1 = rev2 = b.get_revision_info(revision[0])[0]
949
686
elif len(revision) == 2:
950
rev1 = revision[0].in_history(b).revno
951
rev2 = revision[1].in_history(b).revno
687
rev1 = b.get_revision_info(revision[0])[0]
688
rev2 = b.get_revision_info(revision[1])[0]
953
690
raise BzrCommandError('bzr log --revision takes one or two values.')
955
# By this point, the revision numbers are converted to the +ve
956
# form if they were supplied in the -ve form, so we can do
957
# this comparison in relative safety
959
(rev2, rev1) = (rev1, rev2)
961
mutter('encoding log as %r', bzrlib.user_encoding)
697
mutter('encoding log as %r' % bzrlib.user_encoding)
963
699
# use 'replace' so that we don't abort if trying to write out
964
700
# in e.g. the default C locale.
965
701
outf = codecs.getwriter(bzrlib.user_encoding)(sys.stdout, errors='replace')
967
log_format = get_log_format(long=long, short=short, line=line)
968
707
lf = log_formatter(log_format,
969
708
show_ids=show_ids,
996
726
A more user-friendly interface is "bzr log FILE"."""
998
728
takes_args = ["filename"]
1000
729
def run(self, filename):
1001
tree, relpath = WorkingTree.open_containing(filename)
1003
inv = tree.read_working_inventory()
1004
file_id = inv.path2id(relpath)
730
b = find_branch(filename)
731
inv = b.read_working_inventory()
732
file_id = inv.path2id(b.relpath(filename))
1005
733
for revno, revision_id, what in bzrlib.log.find_touching_revisions(b, file_id):
1006
734
print "%6d %s" % (revno, what)
1009
737
class cmd_ls(Command):
1010
738
"""List files in a tree.
740
TODO: Take a revision or remote path and list that tree instead.
1012
# TODO: Take a revision or remote path and list that tree instead.
1014
takes_options = ['verbose', 'revision',
1015
Option('non-recursive',
1016
help='don\'t recurse into sub-directories'),
1018
help='Print all paths from the root of the branch.'),
1019
Option('unknown', help='Print unknown files'),
1020
Option('versioned', help='Print versioned files'),
1021
Option('ignored', help='Print ignored files'),
1023
Option('null', help='Null separate the files'),
1026
def run(self, revision=None, verbose=False,
1027
non_recursive=False, from_root=False,
1028
unknown=False, versioned=False, ignored=False,
1031
if verbose and null:
1032
raise BzrCommandError('Cannot set both --verbose and --null')
1033
all = not (unknown or versioned or ignored)
1035
selection = {'I':ignored, '?':unknown, 'V':versioned}
1037
tree, relpath = WorkingTree.open_containing(u'.')
1042
if revision is not None:
1043
tree = tree.branch.repository.revision_tree(
1044
revision[0].in_history(tree.branch).rev_id)
1045
for fp, fc, kind, fid, entry in tree.list_files():
1046
if fp.startswith(relpath):
1047
fp = fp[len(relpath):]
1048
if non_recursive and '/' in fp:
1050
if not all and not selection[fc]:
1053
kindch = entry.kind_character()
1054
print '%-8s %s%s' % (fc, fp, kindch)
1056
sys.stdout.write(fp)
1057
sys.stdout.write('\0')
743
def run(self, revision=None, verbose=False):
746
tree = b.working_tree()
748
tree = b.revision_tree(b.lookup_revision(revision))
750
for fp, fc, kind, fid in tree.list_files():
752
if kind == 'directory':
759
print '%-8s %s%s' % (fc, fp, kindch)
1063
765
class cmd_unknowns(Command):
1064
766
"""List unknown files."""
1067
768
from bzrlib.osutils import quotefn
1068
for f in WorkingTree.open_containing(u'.')[0].unknowns():
769
for f in find_branch('.').unknowns():
1069
770
print quotefn(f)
1072
774
class cmd_ignore(Command):
1073
775
"""Ignore a command or pattern.
1075
777
To remove patterns from the ignore list, edit the .bzrignore file.
1077
779
If the pattern contains a slash, it is compared to the whole path
1078
from the branch root. Otherwise, it is compared to only the last
1079
component of the path. To match a file only in the root directory,
780
from the branch root. Otherwise, it is comapred to only the last
781
component of the path.
1082
783
Ignore patterns are case-insensitive on case-insensitive systems.
1172
871
is found exports to a directory (equivalent to --format=dir).
1174
873
Root may be the top directory for tar, tgz and tbz2 formats. If none
1175
is given, the top directory will be the root name of the file.
1177
Note: export of tree with non-ascii filenames to zip is not supported.
1179
Supported formats Autodetected by extension
1180
----------------- -------------------------
1183
tbz2 .tar.bz2, .tbz2
874
is given, the top directory will be the root name of the file."""
875
# TODO: list known exporters
1187
876
takes_args = ['dest']
1188
877
takes_options = ['revision', 'format', 'root']
1189
878
def run(self, dest, revision=None, format=None, root=None):
1191
from bzrlib.export import export
1192
tree = WorkingTree.open_containing(u'.')[0]
1194
881
if revision is None:
1195
# should be tree.last_revision FIXME
1196
rev_id = b.last_revision()
882
rev_id = b.last_patch()
1198
884
if len(revision) != 1:
1199
885
raise BzrError('bzr export --revision takes exactly 1 argument')
1200
rev_id = revision[0].in_history(b).rev_id
1201
t = b.repository.revision_tree(rev_id)
1203
export(t, dest, format, root)
1204
except errors.NoSuchExportFormat, e:
1205
raise BzrCommandError('Unsupported export format: %s' % e.format)
886
revno, rev_id = b.get_revision_info(revision[0])
887
t = b.revision_tree(rev_id)
888
root, ext = os.path.splitext(dest)
892
elif ext in (".gz", ".tgz"):
894
elif ext in (".bz2", ".tbz2"):
898
t.export(dest, format, root)
1208
901
class cmd_cat(Command):
1252
933
A selected-file commit may fail in some cases where the committed
1253
934
tree would be invalid, such as trying to commit a file in a
1254
935
newly-added directory that is not itself committed.
937
TODO: Run hooks on tree to-be-committed, and after commit.
939
TODO: Strict commit that fails if there are unknown or deleted files.
1256
# TODO: Run hooks on tree to-be-committed, and after commit.
1258
# TODO: Strict commit that fails if there are deleted files.
1259
# (what does "deleted files" mean ??)
1261
# TODO: Give better message for -s, --summary, used by tla people
1263
# XXX: verbose currently does nothing
1265
941
takes_args = ['selected*']
1266
takes_options = ['message', 'verbose',
1268
help='commit even if nothing has changed'),
1269
Option('file', type=str,
1271
help='file containing commit message'),
1273
help="refuse to commit if there are unknown "
1274
"files in the working tree."),
942
takes_options = ['message', 'file', 'verbose', 'unchanged']
1276
943
aliases = ['ci', 'checkin']
945
# TODO: Give better message for -s, --summary, used by tla people
1278
947
def run(self, message=None, file=None, verbose=True, selected_list=None,
1279
unchanged=False, strict=False):
1280
from bzrlib.errors import (PointlessCommit, ConflictsInTree,
1282
from bzrlib.msgeditor import edit_commit_message, \
1283
make_commit_message_template
949
from bzrlib.errors import PointlessCommit
950
from bzrlib.msgeditor import edit_commit_message
1284
951
from bzrlib.status import show_status
1285
from tempfile import TemporaryFile
1288
# TODO: Need a blackbox test for invoking the external editor; may be
1289
# slightly problematic to run this cross-platform.
1291
# TODO: do more checks that the commit will succeed before
1292
# spending the user's valuable time typing a commit message.
1294
# TODO: if the commit *does* happen to fail, then save the commit
1295
# message to a temporary file where it can be recovered
1296
tree, selected_list = tree_files(selected_list)
1297
if message is None and not file:
1298
template = make_commit_message_template(tree, selected_list)
1299
message = edit_commit_message(template)
952
from cStringIO import StringIO
956
selected_list = [b.relpath(s) for s in selected_list]
958
if not message and not file:
960
show_status(b, specific_files=selected_list,
962
message = edit_commit_message(catcher.getvalue())
1300
964
if message is None:
1301
965
raise BzrCommandError("please specify a commit message"
1302
966
" with either --message or --file")
1372
1022
The check command or bzr developers may sometimes advise you to run
1375
This version of this command upgrades from the full-text storage
1376
used by bzr 0.0.8 and earlier to the weave format (v5).
1378
1025
takes_args = ['dir?']
1380
def run(self, dir=u'.'):
1027
def run(self, dir='.'):
1381
1028
from bzrlib.upgrade import upgrade
1029
upgrade(find_branch(dir))
1385
1033
class cmd_whoami(Command):
1386
1034
"""Show bzr user id."""
1387
1035
takes_options = ['email']
1390
1037
def run(self, email=False):
1392
b = WorkingTree.open_containing(u'.')[0].branch
1393
config = bzrlib.config.BranchConfig(b)
1394
except NotBranchError:
1395
config = bzrlib.config.GlobalConfig()
1039
b = bzrlib.branch.find_branch('.')
1398
print config.user_email()
1400
print config.username()
1402
class cmd_nick(Command):
1404
Print or set the branch nickname.
1405
If unset, the tree root directory name is used as the nickname
1406
To print the current nickname, execute with no argument.
1408
takes_args = ['nickname?']
1409
def run(self, nickname=None):
1410
branch = Branch.open_containing(u'.')[0]
1411
if nickname is None:
1412
self.printme(branch)
1414
branch.nick = nickname
1417
def printme(self, branch):
1044
print bzrlib.osutils.user_email(b)
1046
print bzrlib.osutils.username(b)
1420
1049
class cmd_selftest(Command):
1421
"""Run internal test suite.
1423
This creates temporary test directories in the working directory,
1424
but not existing data is affected. These directories are deleted
1425
if the tests pass, or left behind to help in debugging if they
1426
fail and --keep-output is specified.
1428
If arguments are given, they are regular expressions that say
1429
which tests should run.
1431
# TODO: --list should give a list of all available tests
1050
"""Run internal test suite"""
1433
takes_args = ['testspecs*']
1434
takes_options = ['verbose',
1435
Option('one', help='stop when one test fails'),
1436
Option('keep-output',
1437
help='keep output directories when tests fail')
1440
def run(self, testspecs_list=None, verbose=False, one=False,
1052
takes_options = ['verbose', 'pattern']
1053
def run(self, verbose=False, pattern=".*"):
1442
1054
import bzrlib.ui
1443
from bzrlib.tests import selftest
1055
from bzrlib.selftest import selftest
1444
1056
# we don't want progress meters from the tests to go to the
1445
1057
# real output; and we don't want log messages cluttering up
1446
1058
# the real logs.
1501
1087
class cmd_version(Command):
1502
1088
"""Show version of bzr."""
1507
1092
class cmd_rocks(Command):
1508
1093
"""Statement of optimism."""
1512
1096
print "it sure does!"
1515
1099
class cmd_find_merge_base(Command):
1516
1100
"""Find and print a base revision for merging two branches.
1102
TODO: Options to specify revisions on either side, as if
1103
merging only part of the history.
1518
# TODO: Options to specify revisions on either side, as if
1519
# merging only part of the history.
1520
1105
takes_args = ['branch', 'other']
1524
1108
def run(self, branch, other):
1525
1109
from bzrlib.revision import common_ancestor, MultipleRevisionSources
1527
branch1 = Branch.open_containing(branch)[0]
1528
branch2 = Branch.open_containing(other)[0]
1111
branch1 = find_branch(branch)
1112
branch2 = find_branch(other)
1530
1114
history_1 = branch1.revision_history()
1531
1115
history_2 = branch2.revision_history()
1533
last1 = branch1.last_revision()
1534
last2 = branch2.last_revision()
1117
last1 = branch1.last_patch()
1118
last2 = branch2.last_patch()
1536
1120
source = MultipleRevisionSources(branch1, branch2)
1580
1164
--force is given.
1582
1166
takes_args = ['branch?']
1583
takes_options = ['revision', 'force', 'merge-type', 'reprocess',
1584
Option('show-base', help="Show base revision text in "
1167
takes_options = ['revision', 'force', 'merge-type']
1587
def run(self, branch=None, revision=None, force=False, merge_type=None,
1588
show_base=False, reprocess=False):
1169
def run(self, branch='.', revision=None, force=False,
1589
1171
from bzrlib.merge import merge
1590
1172
from bzrlib.merge_core import ApplyMerge3
1591
1173
if merge_type is None:
1592
1174
merge_type = ApplyMerge3
1594
branch = WorkingTree.open_containing(u'.')[0].branch.get_parent()
1596
raise BzrCommandError("No merge location known or specified.")
1598
print "Using saved location: %s" % branch
1599
1176
if revision is None or len(revision) < 1:
1600
1177
base = [None, None]
1601
1178
other = [branch, -1]
1603
1180
if len(revision) == 1:
1181
other = [branch, revision[0]]
1604
1182
base = [None, None]
1605
other_branch = Branch.open_containing(branch)[0]
1606
revno = revision[0].in_history(other_branch).revno
1607
other = [branch, revno]
1609
1184
assert len(revision) == 2
1610
1185
if None in revision:
1611
1186
raise BzrCommandError(
1612
1187
"Merge doesn't permit that revision specifier.")
1613
b = Branch.open_containing(branch)[0]
1615
base = [branch, revision[0].in_history(b).revno]
1616
other = [branch, revision[1].in_history(b).revno]
1188
base = [branch, revision[0]]
1189
other = [branch, revision[1]]
1619
conflict_count = merge(other, base, check_clean=(not force),
1620
merge_type=merge_type, reprocess=reprocess,
1621
show_base=show_base)
1622
if conflict_count != 0:
1192
merge(other, base, check_clean=(not force), merge_type=merge_type)
1626
1193
except bzrlib.errors.AmbiguousBase, e:
1627
1194
m = ("sorry, bzr can't determine the right merge base yet\n"
1628
1195
"candidates are:\n "
1636
class cmd_remerge(Command):
1639
takes_args = ['file*']
1640
takes_options = ['merge-type', 'reprocess',
1641
Option('show-base', help="Show base revision text in "
1644
def run(self, file_list=None, merge_type=None, show_base=False,
1646
from bzrlib.merge import merge_inner, transform_tree
1647
from bzrlib.merge_core import ApplyMerge3
1648
if merge_type is None:
1649
merge_type = ApplyMerge3
1650
tree, file_list = tree_files(file_list)
1653
pending_merges = tree.pending_merges()
1654
if len(pending_merges) != 1:
1655
raise BzrCommandError("Sorry, remerge only works after normal"
1656
+ " merges. Not cherrypicking or"
1658
repository = tree.branch.repository
1659
base_revision = common_ancestor(tree.branch.last_revision(),
1660
pending_merges[0], repository)
1661
base_tree = repository.revision_tree(base_revision)
1662
other_tree = repository.revision_tree(pending_merges[0])
1663
interesting_ids = None
1664
if file_list is not None:
1665
interesting_ids = set()
1666
for filename in file_list:
1667
file_id = tree.path2id(filename)
1668
interesting_ids.add(file_id)
1669
if tree.kind(file_id) != "directory":
1672
for name, ie in tree.inventory.iter_entries(file_id):
1673
interesting_ids.add(ie.file_id)
1674
transform_tree(tree, tree.branch.basis_tree(), interesting_ids)
1675
if file_list is None:
1676
restore_files = list(tree.iter_conflicts())
1678
restore_files = file_list
1679
for filename in restore_files:
1681
restore(tree.abspath(filename))
1682
except NotConflicted:
1684
conflicts = merge_inner(tree.branch, other_tree, base_tree,
1685
interesting_ids = interesting_ids,
1686
other_rev_id=pending_merges[0],
1687
merge_type=merge_type,
1688
show_base=show_base,
1689
reprocess=reprocess)
1697
1203
class cmd_revert(Command):
1698
1204
"""Reverse all changes since the last commit.
1758
1262
aliases = ['s-c']
1762
1265
def run(self, context=None):
1763
1266
import shellcomplete
1764
1267
shellcomplete.shellcomplete(context)
1767
class cmd_fetch(Command):
1768
"""Copy in history from another branch but don't merge it.
1770
This is an internal method used for pull and merge."""
1772
takes_args = ['from_branch', 'to_branch']
1773
def run(self, from_branch, to_branch):
1774
from bzrlib.fetch import Fetcher
1775
from bzrlib.branch import Branch
1776
from_b = Branch.open(from_branch)
1777
to_b = Branch.open(to_branch)
1782
Fetcher(to_b, from_b)
1789
1270
class cmd_missing(Command):
1790
"""Show unmerged/unpulled revisions between two branches.
1792
OTHER_BRANCH may be local or remote."""
1793
takes_args = ['other_branch?']
1794
takes_options = [Option('reverse', 'Reverse the order of revisions'),
1796
'Display changes in the local branch only'),
1797
Option('theirs-only',
1798
'Display changes in the remote branch only'),
1806
def run(self, other_branch=None, reverse=False, mine_only=False,
1807
theirs_only=False, long=True, short=False, line=False,
1808
show_ids=False, verbose=False):
1809
from bzrlib.missing import find_unmerged, iter_log_data
1810
from bzrlib.log import log_formatter
1811
local_branch = bzrlib.branch.Branch.open_containing(u".")[0]
1812
parent = local_branch.get_parent()
1813
if other_branch is None:
1814
other_branch = parent
1815
if other_branch is None:
1271
"""What is missing in this branch relative to other branch.
1273
takes_args = ['remote?']
1274
aliases = ['mis', 'miss']
1275
# We don't have to add quiet to the list, because
1276
# unknown options are parsed as booleans
1277
takes_options = ['verbose', 'quiet']
1279
def run(self, remote=None, verbose=False, quiet=False):
1280
from bzrlib.errors import BzrCommandError
1281
from bzrlib.missing import show_missing
1283
if verbose and quiet:
1284
raise BzrCommandError('Cannot pass both quiet and verbose')
1286
b = find_branch('.')
1287
parent = b.get_parent()
1816
1290
raise BzrCommandError("No missing location known or specified.")
1817
print "Using last location: " + local_branch.get_parent()
1818
remote_branch = bzrlib.branch.Branch.open(other_branch)
1819
local_extra, remote_extra = find_unmerged(local_branch, remote_branch)
1820
log_format = get_log_format(long=long, short=short, line=line)
1821
lf = log_formatter(log_format, sys.stdout,
1823
show_timezone='original')
1824
if reverse is False:
1825
local_extra.reverse()
1826
remote_extra.reverse()
1827
if local_extra and not theirs_only:
1828
print "You have %d extra revision(s):" % len(local_extra)
1829
for data in iter_log_data(local_extra, local_branch.repository,
1832
printed_local = True
1834
printed_local = False
1835
if remote_extra and not mine_only:
1836
if printed_local is True:
1838
print "You are missing %d revision(s):" % len(remote_extra)
1839
for data in iter_log_data(remote_extra, remote_branch.repository,
1842
if not remote_extra and not local_extra:
1844
print "Branches are up to date."
1847
if parent is None and other_branch is not None:
1848
local_branch.set_parent(other_branch)
1293
print "Using last location: %s" % parent
1295
elif parent is None:
1296
# We only update parent if it did not exist, missing should not change the parent
1297
b.set_parent(remote)
1298
br_remote = find_branch(remote)
1300
return show_missing(b, br_remote, verbose=verbose, quiet=quiet)
1852
1304
class cmd_plugins(Command):
1853
1305
"""List plugins"""
1857
1308
import bzrlib.plugin
1858
1309
from inspect import getdoc
1859
for name, plugin in bzrlib.plugin.all_plugins().items():
1310
for plugin in bzrlib.plugin.all_plugins:
1860
1311
if hasattr(plugin, '__path__'):
1861
1312
print plugin.__path__[0]
1862
1313
elif hasattr(plugin, '__file__'):
1869
1320
print '\t', d.split('\n')[0]
1872
class cmd_testament(Command):
1873
"""Show testament (signing-form) of a revision."""
1874
takes_options = ['revision', 'long']
1875
takes_args = ['branch?']
1877
def run(self, branch=u'.', revision=None, long=False):
1878
from bzrlib.testament import Testament
1879
b = WorkingTree.open_containing(branch)[0].branch
1882
if revision is None:
1883
rev_id = b.last_revision()
1885
rev_id = revision[0].in_history(b).rev_id
1886
t = Testament.from_revision(b.repository, rev_id)
1888
sys.stdout.writelines(t.as_text_lines())
1890
sys.stdout.write(t.as_short_text())
1895
class cmd_annotate(Command):
1896
"""Show the origin of each line in a file.
1898
This prints out the given file with an annotation on the left side
1899
indicating which revision, author and date introduced the change.
1901
If the origin is the same for a run of consecutive lines, it is
1902
shown only at the top, unless the --all option is given.
1904
# TODO: annotate directories; showing when each file was last changed
1905
# TODO: annotate a previous version of a file
1906
# TODO: if the working copy is modified, show annotations on that
1907
# with new uncommitted lines marked
1908
aliases = ['blame', 'praise']
1909
takes_args = ['filename']
1910
takes_options = [Option('all', help='show annotations on all lines'),
1911
Option('long', help='show date in annotations'),
1915
def run(self, filename, all=False, long=False):
1916
from bzrlib.annotate import annotate_file
1917
tree, relpath = WorkingTree.open_containing(filename)
1918
branch = tree.branch
1921
file_id = tree.inventory.path2id(relpath)
1922
tree = branch.repository.revision_tree(branch.last_revision())
1923
file_version = tree.inventory[file_id].revision
1924
annotate_file(branch, file_version, file_id, long, all, sys.stdout)
1929
class cmd_re_sign(Command):
1930
"""Create a digital signature for an existing revision."""
1931
# TODO be able to replace existing ones.
1933
hidden = True # is this right ?
1934
takes_args = ['revision_id?']
1935
takes_options = ['revision']
1937
def run(self, revision_id=None, revision=None):
1938
import bzrlib.config as config
1939
import bzrlib.gpg as gpg
1940
if revision_id is not None and revision is not None:
1941
raise BzrCommandError('You can only supply one of revision_id or --revision')
1942
if revision_id is None and revision is None:
1943
raise BzrCommandError('You must supply either --revision or a revision_id')
1944
b = WorkingTree.open_containing(u'.')[0].branch
1945
gpg_strategy = gpg.GPGStrategy(config.BranchConfig(b))
1946
if revision_id is not None:
1947
b.repository.sign_revision(revision_id, gpg_strategy)
1948
elif revision is not None:
1949
if len(revision) == 1:
1950
revno, rev_id = revision[0].in_history(b)
1951
b.repository.sign_revision(rev_id, gpg_strategy)
1952
elif len(revision) == 2:
1953
# are they both on rh- if so we can walk between them
1954
# might be nice to have a range helper for arbitrary
1955
# revision paths. hmm.
1956
from_revno, from_revid = revision[0].in_history(b)
1957
to_revno, to_revid = revision[1].in_history(b)
1958
if to_revid is None:
1959
to_revno = b.revno()
1960
if from_revno is None or to_revno is None:
1961
raise BzrCommandError('Cannot sign a range of non-revision-history revisions')
1962
for revno in range(from_revno, to_revno + 1):
1963
b.repository.sign_revision(b.get_rev_id(revno),
1966
raise BzrCommandError('Please supply either one revision, or a range.')
1969
class cmd_uncommit(bzrlib.commands.Command):
1970
"""Remove the last committed revision.
1972
By supplying the --all flag, it will not only remove the entry
1973
from revision_history, but also remove all of the entries in the
1976
--verbose will print out what is being removed.
1977
--dry-run will go through all the motions, but not actually
1980
In the future, uncommit will create a changeset, which can then
1983
takes_options = ['all', 'verbose', 'revision',
1984
Option('dry-run', help='Don\'t actually make changes'),
1985
Option('force', help='Say yes to all questions.')]
1986
takes_args = ['location?']
1989
def run(self, location=None, all=False,
1990
dry_run=False, verbose=False,
1991
revision=None, force=False):
1992
from bzrlib.branch import Branch
1993
from bzrlib.log import log_formatter
1995
from bzrlib.uncommit import uncommit
1997
if location is None:
1999
b, relpath = Branch.open_containing(location)
2001
if revision is None:
2003
rev_id = b.last_revision()
2005
revno, rev_id = revision[0].in_history(b)
2007
print 'No revisions to uncommit.'
2009
for r in range(revno, b.revno()+1):
2010
rev_id = b.get_rev_id(r)
2011
lf = log_formatter('short', to_file=sys.stdout,show_timezone='original')
2012
lf.show(r, b.repository.get_revision(rev_id), None)
2015
print 'Dry-run, pretending to remove the above revisions.'
2017
val = raw_input('Press <enter> to continue')
2019
print 'The above revision(s) will be removed.'
2021
val = raw_input('Are you sure [y/N]? ')
2022
if val.lower() not in ('y', 'yes'):
2026
uncommit(b, remove_files=all,
2027
dry_run=dry_run, verbose=verbose,
2031
# these get imported and then picked up by the scan for cmd_*
2032
# TODO: Some more consistent way to split command definitions across files;
2033
# we do need to load at least some information about them to know of
2035
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore