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
29
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
22
39
import bzrlib.trace
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
26
from bzrlib import BZRDIR
27
from bzrlib.commands import Command
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
30
76
class cmd_status(Command):
31
77
"""Display status summary.
63
109
files or directories is reported. If a directory is given, status
64
110
is reported for everything inside that directory.
66
If a revision is specified, the changes since that revision are shown.
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
68
118
takes_args = ['file*']
69
119
takes_options = ['all', 'show-ids', 'revision']
70
120
aliases = ['st', 'stat']
72
def run(self, all=False, show_ids=False, file_list=None):
74
b = find_branch(file_list[0])
75
file_list = [b.relpath(x) for x in file_list]
76
# special case: only one path was given and it's the root
123
def run(self, all=False, show_ids=False, file_list=None, revision=None):
124
tree, file_list = tree_files(file_list)
83
126
from bzrlib.status import show_status
84
show_status(b, show_unchanged=all, show_ids=show_ids,
85
specific_files=file_list)
127
show_status(tree.branch, show_unchanged=all, show_ids=show_ids,
128
specific_files=file_list, revision=revision)
88
131
class cmd_cat_revision(Command):
89
"""Write out metadata for a revision."""
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.
92
takes_args = ['revision_id']
139
takes_args = ['revision_id?']
140
takes_options = ['revision']
94
def run(self, revision_id):
95
from bzrlib.xml import pack_xml
96
pack_xml(find_branch('.').get_revision(revision_id), sys.stdout)
143
def run(self, revision_id=None, revision=None):
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.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.get_revision_xml(rev_id))
99
160
class cmd_revno(Command):
100
161
"""Show current revision number.
102
163
This is equal to the number of revisions on this branch."""
104
print find_branch('.').revno()
164
takes_args = ['location?']
166
def run(self, location=u'.'):
167
print Branch.open_containing(location)[0].revno()
106
170
class cmd_revision_info(Command):
107
171
"""Show revision number and revision id for a given revision identifier.
144
213
Therefore simply saying 'bzr add' will version all files that
145
214
are currently unknown.
147
TODO: Perhaps adding a file whose directly is not versioned should
148
recursively add that parent, rather than giving an error?
216
Adding a file whose parent directory is not versioned will
217
implicitly add the parent, and so on up to the root. This means
218
you should never need to explictly add a directory, they'll just
219
get added when you add a file in the directory.
221
--dry-run will show which files would be added, but not actually
150
224
takes_args = ['file*']
151
takes_options = ['verbose', 'no-recurse']
153
def run(self, file_list, verbose=False, no_recurse=False):
154
# verbose currently has no effect
155
from bzrlib.add import smart_add, add_reporter_print
156
smart_add(file_list, not no_recurse, add_reporter_print)
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"\
160
256
class cmd_mkdir(Command):
180
273
takes_args = ['filename']
183
277
def run(self, filename):
184
print find_branch(filename).relpath(filename)
278
tree, relpath = WorkingTree.open_containing(filename)
188
282
class cmd_inventory(Command):
189
"""Show inventory of the current working copy or a revision."""
190
takes_options = ['revision', 'show-ids']
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']
192
def run(self, revision=None, show_ids=False):
195
inv = b.read_working_inventory()
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()
197
298
if len(revision) > 1:
198
299
raise BzrCommandError('bzr inventory --revision takes'
199
300
' exactly one revision identifier')
200
inv = b.get_revision_inventory(b.lookup_revision(revision[0]))
301
inv = tree.branch.get_revision_inventory(
302
revision[0].in_history(tree.branch).rev_id)
202
304
for path, entry in inv.entries():
305
if kind and kind != entry.kind:
204
308
print '%-50s %s' % (path, entry.file_id)
261
363
def run(self, names_list):
262
364
if len(names_list) < 2:
263
365
raise BzrCommandError("missing file argument")
264
b = find_branch(names_list[0])
266
rel_names = [b.relpath(x) for x in names_list]
366
tree, rel_names = tree_files(names_list)
268
368
if os.path.isdir(names_list[-1]):
269
369
# move into existing directory
270
for pair in b.move(rel_names[:-1], rel_names[-1]):
370
for pair in tree.move(rel_names[:-1], rel_names[-1]):
271
371
print "%s => %s" % pair
273
373
if len(names_list) != 2:
274
374
raise BzrCommandError('to mv multiple files the destination '
275
375
'must be a versioned directory')
276
for pair in b.move(rel_names[0], rel_names[1]):
277
print "%s => %s" % pair
376
tree.rename_one(rel_names[0], rel_names[1])
377
print "%s => %s" % (rel_names[0], rel_names[1])
282
380
class cmd_pull(Command):
283
381
"""Pull any changes from another branch into the current one.
285
If the location is omitted, the last-used location will be used.
286
Both the revision history and the working directory will be
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
387
This command only works on branches that have not diverged. Branches are
290
388
considered diverged if both branches have had commits without first
291
389
pulling from the other.
293
391
If branches have diverged, you can use 'bzr merge' to pull the text changes
294
from one into the other.
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.
398
takes_options = ['remember', 'overwrite', 'verbose']
296
399
takes_args = ['location?']
298
def run(self, location=None):
401
def run(self, location=None, remember=False, overwrite=False, verbose=False):
299
402
from bzrlib.merge import merge
301
403
from shutil import rmtree
303
from bzrlib.branch import pull_loc
305
br_to = find_branch('.')
308
stored_loc = br_to.controlfile("x-pull", "rb").read().rstrip('\n')
310
if e.errno != errno.ENOENT:
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()
312
408
if location is None:
313
409
if stored_loc is None:
314
410
raise BzrCommandError("No pull location known or specified.")
316
print "Using last location: %s" % stored_loc
317
location = stored_loc
318
cache_root = tempfile.mkdtemp()
319
from bzrlib.branch import DivergedBranches
320
br_from = find_branch(location)
321
location = pull_loc(br_from)
322
old_revno = br_to.revno()
324
from branch import find_cached_branch, DivergedBranches
325
br_from = find_cached_branch(location, cache_root)
326
location = pull_loc(br_from)
327
old_revno = br_to.revno()
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()
329
br_to.update_revisions(br_from)
330
except DivergedBranches:
331
raise BzrCommandError("These branches have diverged."
334
merge(('.', -1), ('.', old_revno), check_clean=False)
335
if location != stored_loc:
336
br_to.controlfile("x-pull", "wb").write(location + "\n")
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,))
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)
342
533
class cmd_branch(Command):
348
539
To retrieve the branch as of a particular revision, supply the --revision
349
540
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.
351
546
takes_args = ['from_location', 'to_location?']
352
takes_options = ['revision']
547
takes_options = ['revision', 'basis']
353
548
aliases = ['get', 'clone']
355
def run(self, from_location, to_location=None, revision=None):
356
from bzrlib.branch import copy_branch, find_cached_branch
550
def run(self, from_location, to_location=None, revision=None, basis=None):
551
from bzrlib.clone import copy_branch
359
553
from shutil import rmtree
360
cache_root = tempfile.mkdtemp()
364
elif len(revision) > 1:
365
raise BzrCommandError(
366
'bzr branch --revision takes exactly 1 revision value')
368
br_from = find_cached_branch(from_location, cache_root)
370
if e.errno == errno.ENOENT:
371
raise BzrCommandError('Source location "%s" does not'
372
' exist.' % to_location)
556
elif len(revision) > 1:
557
raise BzrCommandError(
558
'bzr branch --revision takes exactly 1 revision value')
560
br_from = Branch.open(from_location)
562
if e.errno == errno.ENOENT:
563
raise BzrCommandError('Source location "%s" does not'
564
' exist.' % to_location)
569
if basis is not None:
570
basis_branch = WorkingTree.open_containing(basis)[0].branch
573
if len(revision) == 1 and revision[0] is not None:
574
revision_id = revision[0].in_history(br_from)[1]
375
577
if to_location is None:
376
578
to_location = os.path.basename(from_location.rstrip("/\\"))
581
name = os.path.basename(to_location) + '\n'
378
583
os.mkdir(to_location)
379
584
except OSError, e:
389
copy_branch(br_from, to_location, revision[0])
594
copy_branch(br_from, to_location, revision_id, basis_branch)
390
595
except bzrlib.errors.NoSuchRevision:
391
596
rmtree(to_location)
392
msg = "The branch %s has no revision %d." % (from_location, revision[0])
393
raise BzrCommandError(msg)
597
msg = "The branch %s has no revision %s." % (from_location, revision[0])
598
raise BzrCommandError(msg)
599
except bzrlib.errors.UnlistableBranch:
601
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())
398
612
class cmd_renames(Command):
399
613
"""Show list of renamed files.
401
TODO: Option to show renames between two historical versions.
403
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.
405
618
takes_args = ['dir?']
407
def run(self, dir='.'):
409
old_inv = b.basis_tree().inventory
410
new_inv = b.read_working_inventory()
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()
412
626
renames = list(bzrlib.tree.find_renames(old_inv, new_inv))
517
749
If files are listed, only the changes in those files are listed.
518
750
Otherwise, all changes for the tree are listed.
520
TODO: Allow diff across branches.
522
TODO: Option to use external diff command; could be GNU diff, wdiff,
525
TODO: Python difflib is not exactly the same as unidiff; should
526
either fix it up or prefer to use an external diff.
528
TODO: If a directory is given, diff everything under that.
530
TODO: Selected-file diff is inefficient and doesn't show you
533
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.
541
771
takes_args = ['file*']
542
772
takes_options = ['revision', 'diff-options']
543
773
aliases = ['di', 'dif']
545
776
def run(self, revision=None, file_list=None, diff_options=None):
546
777
from bzrlib.diff import show_diff
549
b = find_branch(file_list[0])
550
file_list = [b.relpath(f) for f in file_list]
551
if file_list == ['']:
552
# just pointing to top-of-tree
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")
557
792
if revision is not None:
794
raise BzrCommandError("Can't specify -r with two branches")
558
795
if len(revision) == 1:
559
show_diff(b, revision[0], specific_files=file_list,
560
external_diff_options=diff_options)
796
return show_diff(tree.branch, revision[0], specific_files=file_list,
797
external_diff_options=diff_options)
561
798
elif len(revision) == 2:
562
show_diff(b, revision[0], specific_files=file_list,
563
external_diff_options=diff_options,
564
revision2=revision[1])
799
return show_diff(tree.branch, revision[0], specific_files=file_list,
800
external_diff_options=diff_options,
801
revision2=revision[1])
566
803
raise BzrCommandError('bzr diff --revision takes exactly one or two revision identifiers')
568
show_diff(b, None, specific_files=file_list,
569
external_diff_options=diff_options)
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)
574
813
class cmd_deleted(Command):
575
814
"""List files deleted in the working tree.
577
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...)
579
823
def run(self, show_ids=False):
582
new = b.working_tree()
584
## TODO: Much more efficient way to do this: read in new
585
## directories with readdir, rather than stating each one. Same
586
## level of effort but possibly much less IO. (Or possibly not,
587
## if the directories are very large...)
824
tree = WorkingTree.open_containing(u'.')[0]
825
old = tree.branch.basis_tree()
589
826
for path, ie in old.inventory.iter_entries():
590
if not new.has_id(ie.file_id):
827
if not tree.has_id(ie.file_id):
592
829
print '%-50s %s' % (path, ie.file_id)
632
870
The root is the nearest enclosing directory with a .bzr control
634
872
takes_args = ['filename?']
635
874
def run(self, filename=None):
636
875
"""Print the branch root."""
637
b = find_branch(filename)
638
print getattr(b, 'base', None) or getattr(b, 'baseurl')
876
tree = WorkingTree.open_containing(filename)[0]
641
880
class cmd_log(Command):
642
881
"""Show log of this branch.
644
To request a range of logs, you can use the command -r begin:end
645
-r revision requests a specific revision, -r :end or -r begin: are
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
648
--message allows you to give a regular expression, which will be evaluated
649
so that only matching entries will be displayed.
651
TODO: Make --revision support uuid: and hash: [future tag:] notation.
888
# TODO: Make --revision support uuid: and hash: [future tag:] notation.
655
890
takes_args = ['filename?']
656
takes_options = ['forward', 'timezone', 'verbose', 'show-ids', 'revision',
657
'long', 'message', 'short',]
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',
659
902
def run(self, filename=None, timezone='original',
667
911
from bzrlib.log import log_formatter, show_log
913
assert message is None or isinstance(message, basestring), \
914
"invalid message argument %r" % message
670
915
direction = (forward and 'forward') or 'reverse'
673
b = find_branch(filename)
674
fp = b.relpath(filename)
676
file_id = b.read_working_inventory().path2id(fp)
921
tree, fp = WorkingTree.open_containing(filename)
924
inv = tree.read_working_inventory()
925
except NotBranchError:
928
b, fp = Branch.open_containing(filename)
930
inv = b.get_inventory(b.last_revision())
932
file_id = inv.path2id(fp)
678
934
file_id = None # points to branch root
936
tree, relpath = WorkingTree.open_containing(u'.')
683
940
if revision is None:
686
943
elif len(revision) == 1:
687
rev1 = rev2 = b.get_revision_info(revision[0])[0]
944
rev1 = rev2 = revision[0].in_history(b).revno
688
945
elif len(revision) == 2:
689
rev1 = b.get_revision_info(revision[0])[0]
690
rev2 = b.get_revision_info(revision[1])[0]
946
rev1 = revision[0].in_history(b).revno
947
rev2 = revision[1].in_history(b).revno
692
949
raise BzrCommandError('bzr log --revision takes one or two values.')
951
# By this point, the revision numbers are converted to the +ve
952
# form if they were supplied in the -ve form, so we can do
953
# this comparison in relative safety
955
(rev2, rev1) = (rev1, rev2)
699
mutter('encoding log as %r' % bzrlib.user_encoding)
957
mutter('encoding log as %r', bzrlib.user_encoding)
701
959
# use 'replace' so that we don't abort if trying to write out
702
960
# in e.g. the default C locale.
703
961
outf = codecs.getwriter(bzrlib.user_encoding)(sys.stdout, errors='replace')
963
log_format = get_log_format(long=long, short=short, line=line)
709
964
lf = log_formatter(log_format,
710
965
show_ids=show_ids,
728
992
A more user-friendly interface is "bzr log FILE"."""
730
994
takes_args = ["filename"]
731
996
def run(self, filename):
732
b = find_branch(filename)
733
inv = b.read_working_inventory()
734
file_id = inv.path2id(b.relpath(filename))
997
tree, relpath = WorkingTree.open_containing(filename)
999
inv = tree.read_working_inventory()
1000
file_id = inv.path2id(relpath)
735
1001
for revno, revision_id, what in bzrlib.log.find_touching_revisions(b, file_id):
736
1002
print "%6d %s" % (revno, what)
739
1005
class cmd_ls(Command):
740
1006
"""List files in a tree.
742
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.
745
def run(self, revision=None, verbose=False):
748
tree = b.working_tree()
750
tree = b.revision_tree(b.lookup_revision(revision))
752
for fp, fc, kind, fid in tree.list_files():
754
if kind == 'directory':
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')
761
print '%-8s %s%s' % (fc, fp, kindch)
767
1059
class cmd_unknowns(Command):
768
1060
"""List unknown files."""
770
1063
from bzrlib.osutils import quotefn
771
for f in find_branch('.').unknowns():
1064
for f in WorkingTree.open_containing(u'.')[0].unknowns():
772
1065
print quotefn(f)
776
1068
class cmd_ignore(Command):
777
1069
"""Ignore a command or pattern.
779
1071
To remove patterns from the ignore list, edit the .bzrignore file.
781
1073
If the pattern contains a slash, it is compared to the whole path
782
from the branch root. Otherwise, it is comapred to only the last
783
component of the 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,
785
1078
Ignore patterns are case-insensitive on case-insensitive systems.
873
1168
is found exports to a directory (equivalent to --format=dir).
875
1170
Root may be the top directory for tar, tgz and tbz2 formats. If none
876
is given, the top directory will be the root name of the file."""
877
# TODO: list known exporters
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
878
1183
takes_args = ['dest']
879
1184
takes_options = ['revision', 'format', 'root']
880
1185
def run(self, dest, revision=None, format=None, root=None):
1187
from bzrlib.export import export
1188
tree = WorkingTree.open_containing(u'.')[0]
883
1190
if revision is None:
884
rev_id = b.last_patch()
1191
# should be tree.last_revision FIXME
1192
rev_id = b.last_revision()
886
1194
if len(revision) != 1:
887
1195
raise BzrError('bzr export --revision takes exactly 1 argument')
888
revno, rev_id = b.get_revision_info(revision[0])
1196
rev_id = revision[0].in_history(b).rev_id
889
1197
t = b.revision_tree(rev_id)
890
root, ext = os.path.splitext(dest)
894
elif ext in (".gz", ".tgz"):
896
elif ext in (".bz2", ".tbz2"):
900
t.export(dest, format, root)
1199
export(t, dest, format, root)
1200
except errors.NoSuchExportFormat, e:
1201
raise BzrCommandError('Unsupported export format: %s' % e.format)
903
1204
class cmd_cat(Command):
935
1248
A selected-file commit may fail in some cases where the committed
936
1249
tree would be invalid, such as trying to commit a file in a
937
1250
newly-added directory that is not itself committed.
939
TODO: Run hooks on tree to-be-committed, and after commit.
941
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 ??)
1257
# TODO: Give better message for -s, --summary, used by tla people
1259
# XXX: verbose currently does nothing
943
1261
takes_args = ['selected*']
944
takes_options = ['message', 'file', 'verbose', 'unchanged']
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."),
945
1272
aliases = ['ci', 'checkin']
947
# TODO: Give better message for -s, --summary, used by tla people
949
1274
def run(self, message=None, file=None, verbose=True, selected_list=None,
951
from bzrlib.errors import PointlessCommit
952
from bzrlib.msgeditor import edit_commit_message
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
953
1280
from bzrlib.status import show_status
954
from cStringIO import StringIO
958
selected_list = [b.relpath(s) for s in selected_list]
960
if not message and not file:
962
show_status(b, specific_files=selected_list,
964
message = edit_commit_message(catcher.getvalue())
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)
966
1296
if message is None:
967
1297
raise BzrCommandError("please specify a commit message"
968
1298
" with either --message or --file")
1027
1368
The check command or bzr developers may sometimes advise you to run
1371
This version of this command upgrades from the full-text storage
1372
used by bzr 0.0.8 and earlier to the weave format (v5).
1030
1374
takes_args = ['dir?']
1032
def run(self, dir='.'):
1376
def run(self, dir=u'.'):
1033
1377
from bzrlib.upgrade import upgrade
1034
upgrade(find_branch(dir))
1038
1381
class cmd_whoami(Command):
1039
1382
"""Show bzr user id."""
1040
1383
takes_options = ['email']
1042
1386
def run(self, email=False):
1044
b = bzrlib.branch.find_branch('.')
1388
b = WorkingTree.open_containing(u'.')[0].branch
1389
config = bzrlib.config.BranchConfig(b)
1390
except NotBranchError:
1391
config = bzrlib.config.GlobalConfig()
1049
print bzrlib.osutils.user_email(b)
1051
print bzrlib.osutils.username(b)
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):
1054
1416
class cmd_selftest(Command):
1055
"""Run internal test suite"""
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
1057
takes_options = ['verbose', 'pattern']
1058
def run(self, verbose=False, pattern=".*"):
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,
1059
1438
import bzrlib.ui
1060
from bzrlib.selftest import selftest
1439
from bzrlib.tests import selftest
1061
1440
# we don't want progress meters from the tests to go to the
1062
1441
# real output; and we don't want log messages cluttering up
1063
1442
# the real logs.
1092
1478
class cmd_version(Command):
1093
1479
"""Show version of bzr."""
1097
1484
class cmd_rocks(Command):
1098
1485
"""Statement of optimism."""
1101
1489
print "it sure does!"
1104
1492
class cmd_find_merge_base(Command):
1105
1493
"""Find and print a base revision for merging two branches.
1107
TODO: Options to specify revisions on either side, as if
1108
merging only part of the history.
1495
# TODO: Options to specify revisions on either side, as if
1496
# merging only part of the history.
1110
1497
takes_args = ['branch', 'other']
1113
1501
def run(self, branch, other):
1114
1502
from bzrlib.revision import common_ancestor, MultipleRevisionSources
1116
branch1 = find_branch(branch)
1117
branch2 = find_branch(other)
1504
branch1 = Branch.open_containing(branch)[0]
1505
branch2 = Branch.open_containing(other)[0]
1119
1507
history_1 = branch1.revision_history()
1120
1508
history_2 = branch2.revision_history()
1122
last1 = branch1.last_patch()
1123
last2 = branch2.last_patch()
1510
last1 = branch1.last_revision()
1511
last2 = branch2.last_revision()
1125
1513
source = MultipleRevisionSources(branch1, branch2)
1169
1557
--force is given.
1171
1559
takes_args = ['branch?']
1172
takes_options = ['revision', 'force', 'merge-type']
1560
takes_options = ['revision', 'force', 'merge-type', 'reprocess',
1561
Option('show-base', help="Show base revision text in "
1174
def run(self, branch='.', revision=None, force=False,
1564
def run(self, branch=None, revision=None, force=False, merge_type=None,
1565
show_base=False, reprocess=False):
1176
1566
from bzrlib.merge import merge
1177
1567
from bzrlib.merge_core import ApplyMerge3
1178
1568
if merge_type is None:
1179
1569
merge_type = ApplyMerge3
1571
branch = WorkingTree.open_containing(u'.')[0].branch.get_parent()
1573
raise BzrCommandError("No merge location known or specified.")
1575
print "Using saved location: %s" % branch
1181
1576
if revision is None or len(revision) < 1:
1182
1577
base = [None, None]
1183
1578
other = [branch, -1]
1185
1580
if len(revision) == 1:
1186
other = [branch, revision[0]]
1187
1581
base = [None, None]
1582
other_branch = Branch.open_containing(branch)[0]
1583
revno = revision[0].in_history(other_branch).revno
1584
other = [branch, revno]
1189
1586
assert len(revision) == 2
1190
1587
if None in revision:
1191
1588
raise BzrCommandError(
1192
1589
"Merge doesn't permit that revision specifier.")
1193
base = [branch, revision[0]]
1194
other = [branch, revision[1]]
1590
b = Branch.open_containing(branch)[0]
1592
base = [branch, revision[0].in_history(b).revno]
1593
other = [branch, revision[1].in_history(b).revno]
1197
merge(other, base, check_clean=(not force), merge_type=merge_type)
1596
conflict_count = merge(other, base, check_clean=(not force),
1597
merge_type=merge_type, reprocess=reprocess,
1598
show_base=show_base)
1599
if conflict_count != 0:
1198
1603
except bzrlib.errors.AmbiguousBase, e:
1199
1604
m = ("sorry, bzr can't determine the right merge base yet\n"
1200
1605
"candidates are:\n "
1613
class cmd_remerge(Command):
1616
takes_args = ['file*']
1617
takes_options = ['merge-type', 'reprocess',
1618
Option('show-base', help="Show base revision text in "
1621
def run(self, file_list=None, merge_type=None, show_base=False,
1623
from bzrlib.merge import merge_inner, transform_tree
1624
from bzrlib.merge_core import ApplyMerge3
1625
if merge_type is None:
1626
merge_type = ApplyMerge3
1627
tree, file_list = tree_files(file_list)
1630
pending_merges = tree.pending_merges()
1631
if len(pending_merges) != 1:
1632
raise BzrCommandError("Sorry, remerge only works after normal"
1633
+ " merges. Not cherrypicking or"
1635
base_revision = common_ancestor(tree.branch.last_revision(),
1636
pending_merges[0], tree.branch)
1637
base_tree = tree.branch.revision_tree(base_revision)
1638
other_tree = tree.branch.revision_tree(pending_merges[0])
1639
interesting_ids = None
1640
if file_list is not None:
1641
interesting_ids = set()
1642
for filename in file_list:
1643
file_id = tree.path2id(filename)
1644
interesting_ids.add(file_id)
1645
if tree.kind(file_id) != "directory":
1648
for name, ie in tree.inventory.iter_entries(file_id):
1649
interesting_ids.add(ie.file_id)
1650
transform_tree(tree, tree.branch.basis_tree(), interesting_ids)
1651
if file_list is None:
1652
restore_files = list(tree.iter_conflicts())
1654
restore_files = file_list
1655
for filename in restore_files:
1657
restore(tree.abspath(filename))
1658
except NotConflicted:
1660
conflicts = merge_inner(tree.branch, other_tree, base_tree,
1661
interesting_ids = interesting_ids,
1662
other_rev_id=pending_merges[0],
1663
merge_type=merge_type,
1664
show_base=show_base,
1665
reprocess=reprocess)
1208
1673
class cmd_revert(Command):
1209
1674
"""Reverse all changes since the last commit.
1267
1734
aliases = ['s-c']
1270
1738
def run(self, context=None):
1271
1739
import shellcomplete
1272
1740
shellcomplete.shellcomplete(context)
1743
class cmd_fetch(Command):
1744
"""Copy in history from another branch but don't merge it.
1746
This is an internal method used for pull and merge."""
1748
takes_args = ['from_branch', 'to_branch']
1749
def run(self, from_branch, to_branch):
1750
from bzrlib.fetch import Fetcher
1751
from bzrlib.branch import Branch
1752
from_b = Branch.open(from_branch)
1753
to_b = Branch.open(to_branch)
1758
Fetcher(to_b, from_b)
1275
1765
class cmd_missing(Command):
1276
"""What is missing in this branch relative to other branch.
1278
takes_args = ['remote?']
1279
aliases = ['mis', 'miss']
1280
# We don't have to add quiet to the list, because
1281
# unknown options are parsed as booleans
1282
takes_options = ['verbose', 'quiet']
1284
def run(self, remote=None, verbose=False, quiet=False):
1285
from bzrlib.errors import BzrCommandError
1286
from bzrlib.missing import show_missing
1288
if verbose and quiet:
1289
raise BzrCommandError('Cannot pass both quiet and verbose')
1291
b = find_branch('.')
1292
parent = b.get_parent()
1766
"""Show unmerged/unpulled revisions between two branches.
1768
OTHER_BRANCH may be local or remote."""
1769
takes_args = ['other_branch?']
1770
takes_options = [Option('reverse', 'Reverse the order of revisions'),
1772
'Display changes in the local branch only'),
1773
Option('theirs-only',
1774
'Display changes in the remote branch only'),
1782
def run(self, other_branch=None, reverse=False, mine_only=False,
1783
theirs_only=False, long=True, short=False, line=False,
1784
show_ids=False, verbose=False):
1785
from bzrlib.missing import find_unmerged, iter_log_data
1786
from bzrlib.log import log_formatter
1787
local_branch = bzrlib.branch.Branch.open_containing(u".")[0]
1788
parent = local_branch.get_parent()
1789
if other_branch is None:
1790
other_branch = parent
1791
if other_branch is None:
1295
1792
raise BzrCommandError("No missing location known or specified.")
1298
print "Using last location: %s" % parent
1300
elif parent is None:
1301
# We only update x-pull if it did not exist, missing should not change the parent
1302
b.controlfile('x-pull', 'wb').write(remote + '\n')
1303
br_remote = find_branch(remote)
1305
return show_missing(b, br_remote, verbose=verbose, quiet=quiet)
1793
print "Using last location: " + local_branch.get_parent()
1794
remote_branch = bzrlib.branch.Branch.open(other_branch)
1795
local_extra, remote_extra = find_unmerged(local_branch, remote_branch)
1796
log_format = get_log_format(long=long, short=short, line=line)
1797
lf = log_formatter(log_format, sys.stdout,
1799
show_timezone='original')
1800
if reverse is False:
1801
local_extra.reverse()
1802
remote_extra.reverse()
1803
if local_extra and not theirs_only:
1804
print "You have %d extra revision(s):" % len(local_extra)
1805
for data in iter_log_data(local_extra, local_branch, verbose):
1807
printed_local = True
1809
printed_local = False
1810
if remote_extra and not mine_only:
1811
if printed_local is True:
1813
print "You are missing %d revision(s):" % len(remote_extra)
1814
for data in iter_log_data(remote_extra, remote_branch, verbose):
1816
if not remote_extra and not local_extra:
1818
print "Branches are up to date."
1821
if parent is None and other_branch is not None:
1822
local_branch.set_parent(other_branch)
1309
1826
class cmd_plugins(Command):
1310
1827
"""List plugins"""
1313
1831
import bzrlib.plugin
1314
1832
from inspect import getdoc
1315
for plugin in bzrlib.plugin.all_plugins:
1833
for name, plugin in bzrlib.plugin.all_plugins().items():
1316
1834
if hasattr(plugin, '__path__'):
1317
1835
print plugin.__path__[0]
1318
1836
elif hasattr(plugin, '__file__'):
1325
1843
print '\t', d.split('\n')[0]
1846
class cmd_testament(Command):
1847
"""Show testament (signing-form) of a revision."""
1848
takes_options = ['revision', 'long']
1849
takes_args = ['branch?']
1851
def run(self, branch=u'.', revision=None, long=False):
1852
from bzrlib.testament import Testament
1853
b = WorkingTree.open_containing(branch)[0].branch
1856
if revision is None:
1857
rev_id = b.last_revision()
1859
rev_id = revision[0].in_history(b).rev_id
1860
t = Testament.from_revision(b, rev_id)
1862
sys.stdout.writelines(t.as_text_lines())
1864
sys.stdout.write(t.as_short_text())
1869
class cmd_annotate(Command):
1870
"""Show the origin of each line in a file.
1872
This prints out the given file with an annotation on the left side
1873
indicating which revision, author and date introduced the change.
1875
If the origin is the same for a run of consecutive lines, it is
1876
shown only at the top, unless the --all option is given.
1878
# TODO: annotate directories; showing when each file was last changed
1879
# TODO: annotate a previous version of a file
1880
# TODO: if the working copy is modified, show annotations on that
1881
# with new uncommitted lines marked
1882
aliases = ['blame', 'praise']
1883
takes_args = ['filename']
1884
takes_options = [Option('all', help='show annotations on all lines'),
1885
Option('long', help='show date in annotations'),
1889
def run(self, filename, all=False, long=False):
1890
from bzrlib.annotate import annotate_file
1891
tree, relpath = WorkingTree.open_containing(filename)
1892
branch = tree.branch
1895
file_id = tree.inventory.path2id(relpath)
1896
tree = branch.revision_tree(branch.last_revision())
1897
file_version = tree.inventory[file_id].revision
1898
annotate_file(branch, file_version, file_id, long, all, sys.stdout)
1903
class cmd_re_sign(Command):
1904
"""Create a digital signature for an existing revision."""
1905
# TODO be able to replace existing ones.
1907
hidden = True # is this right ?
1908
takes_args = ['revision_id?']
1909
takes_options = ['revision']
1911
def run(self, revision_id=None, revision=None):
1912
import bzrlib.config as config
1913
import bzrlib.gpg as gpg
1914
if revision_id is not None and revision is not None:
1915
raise BzrCommandError('You can only supply one of revision_id or --revision')
1916
if revision_id is None and revision is None:
1917
raise BzrCommandError('You must supply either --revision or a revision_id')
1918
b = WorkingTree.open_containing(u'.')[0].branch
1919
gpg_strategy = gpg.GPGStrategy(config.BranchConfig(b))
1920
if revision_id is not None:
1921
b.sign_revision(revision_id, gpg_strategy)
1922
elif revision is not None:
1923
if len(revision) == 1:
1924
revno, rev_id = revision[0].in_history(b)
1925
b.sign_revision(rev_id, gpg_strategy)
1926
elif len(revision) == 2:
1927
# are they both on rh- if so we can walk between them
1928
# might be nice to have a range helper for arbitrary
1929
# revision paths. hmm.
1930
from_revno, from_revid = revision[0].in_history(b)
1931
to_revno, to_revid = revision[1].in_history(b)
1932
if to_revid is None:
1933
to_revno = b.revno()
1934
if from_revno is None or to_revno is None:
1935
raise BzrCommandError('Cannot sign a range of non-revision-history revisions')
1936
for revno in range(from_revno, to_revno + 1):
1937
b.sign_revision(b.get_rev_id(revno), gpg_strategy)
1939
raise BzrCommandError('Please supply either one revision, or a range.')
1942
class cmd_uncommit(bzrlib.commands.Command):
1943
"""Remove the last committed revision.
1945
By supplying the --all flag, it will not only remove the entry
1946
from revision_history, but also remove all of the entries in the
1949
--verbose will print out what is being removed.
1950
--dry-run will go through all the motions, but not actually
1953
In the future, uncommit will create a changeset, which can then
1956
takes_options = ['all', 'verbose', 'revision',
1957
Option('dry-run', help='Don\'t actually make changes'),
1958
Option('force', help='Say yes to all questions.')]
1959
takes_args = ['location?']
1962
def run(self, location=None, all=False,
1963
dry_run=False, verbose=False,
1964
revision=None, force=False):
1965
from bzrlib.branch import Branch
1966
from bzrlib.log import log_formatter
1968
from bzrlib.uncommit import uncommit
1970
if location is None:
1972
b, relpath = Branch.open_containing(location)
1974
if revision is None:
1976
rev_id = b.last_revision()
1978
revno, rev_id = revision[0].in_history(b)
1980
print 'No revisions to uncommit.'
1982
for r in range(revno, b.revno()+1):
1983
rev_id = b.get_rev_id(r)
1984
lf = log_formatter('short', to_file=sys.stdout,show_timezone='original')
1985
lf.show(r, b.get_revision(rev_id), None)
1988
print 'Dry-run, pretending to remove the above revisions.'
1990
val = raw_input('Press <enter> to continue')
1992
print 'The above revision(s) will be removed.'
1994
val = raw_input('Are you sure [y/N]? ')
1995
if val.lower() not in ('y', 'yes'):
1999
uncommit(b, remove_files=all,
2000
dry_run=dry_run, verbose=verbose,
2004
# these get imported and then picked up by the scan for cmd_*
2005
# TODO: Some more consistent way to split command definitions across files;
2006
# we do need to load at least some information about them to know of
2008
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore