1
# Copyright (C) 2004, 2005, 2006 by Canonical Ltd
1
# Copyright (C) 2004, 2005 by Canonical Ltd
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
5
5
# the Free Software Foundation; either version 2 of the License, or
6
6
# (at your option) any later version.
8
8
# This program is distributed in the hope that it will be useful,
9
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
11
# GNU General Public License for more details.
13
13
# You should have received a copy of the GNU General Public License
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"""
41
from bzrlib.branch import Branch, BranchReferenceFormat
42
from bzrlib.bundle import read_bundle_from_url
43
from bzrlib.bundle.apply_bundle import install_bundle, merge_bundle
44
from bzrlib.conflicts import ConflictList
45
from bzrlib.commands import Command, display_command
46
from bzrlib.errors import (BzrError, BzrCheckError, BzrCommandError,
47
NotBranchError, DivergedBranches, NotConflicted,
48
NoSuchFile, NoWorkingTree, FileInWrongBranch,
49
NotVersionedError, NotABundle)
50
from bzrlib.merge import Merge3Merger
51
from bzrlib.option import Option
52
from bzrlib.progress import DummyProgress, ProgressPhase
53
from bzrlib.revision import common_ancestor
54
from bzrlib.revisionspec import RevisionSpec
55
from bzrlib.trace import mutter, note, log_error, warning, is_quiet, info
56
from bzrlib.transport.local import LocalTransport
57
from bzrlib.workingtree import WorkingTree
60
def tree_files(file_list, default_branch=u'.'):
62
return internal_tree_files(file_list, default_branch)
63
except FileInWrongBranch, e:
64
raise BzrCommandError("%s is not in the same branch as %s" %
65
(e.path, file_list[0]))
68
# XXX: Bad function name; should possibly also be a class method of
69
# WorkingTree rather than a function.
70
def internal_tree_files(file_list, default_branch=u'.'):
71
"""Convert command-line paths to a WorkingTree and relative paths.
73
This is typically used for command-line processors that take one or
74
more filenames, and infer the workingtree that contains them.
76
The filenames given are not required to exist.
78
:param file_list: Filenames to convert.
80
:param default_branch: Fallback tree path to use if file_list is empty or None.
82
:return: workingtree, [relative_paths]
84
if file_list is None or len(file_list) == 0:
85
return WorkingTree.open_containing(default_branch)[0], file_list
86
tree = WorkingTree.open_containing(file_list[0])[0]
88
for filename in file_list:
90
new_list.append(tree.relpath(filename))
91
except errors.PathNotChild:
92
raise FileInWrongBranch(tree.branch, filename)
96
def get_format_type(typestring):
97
"""Parse and return a format specifier."""
98
if typestring == "weave":
99
return bzrdir.BzrDirFormat6()
100
if typestring == "default":
101
return bzrdir.BzrDirMetaFormat1()
102
if typestring == "metaweave":
103
format = bzrdir.BzrDirMetaFormat1()
104
format.repository_format = repository.RepositoryFormat7()
106
if typestring == "knit":
107
format = bzrdir.BzrDirMetaFormat1()
108
format.repository_format = repository.RepositoryFormatKnit1()
110
msg = "Unknown bzr format %s. Current formats are: default, knit,\n" \
111
"metaweave and weave" % typestring
112
raise BzrCommandError(msg)
115
# TODO: Make sure no commands unconditionally use the working directory as a
116
# branch. If a filename argument is used, the first of them should be used to
117
# specify the branch. (Perhaps this can be factored out into some kind of
118
# Argument class, representing a file in a branch, where the first occurrence
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
121
30
class cmd_status(Command):
122
31
"""Display status summary.
150
63
files or directories is reported. If a directory is given, status
151
64
is reported for everything inside that directory.
153
If a revision argument is given, the status is calculated against
154
that revision, or between two revisions if two are provided.
66
If a revision is specified, the changes since that revision are shown.
157
# TODO: --no-recurse, --recurse options
159
68
takes_args = ['file*']
160
takes_options = ['show-ids', 'revision']
69
takes_options = ['all', 'show-ids', 'revision']
161
70
aliases = ['st', 'stat']
163
encoding_type = 'replace'
166
def run(self, show_ids=False, file_list=None, revision=None):
167
from bzrlib.status import show_tree_status
169
tree, file_list = tree_files(file_list)
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
171
show_tree_status(tree, show_ids=show_ids,
172
specific_files=file_list, revision=revision,
83
from bzrlib.status import show_status
84
show_status(b, show_unchanged=all, show_ids=show_ids,
85
specific_files=file_list)
176
88
class cmd_cat_revision(Command):
177
"""Write out metadata for a revision.
179
The revision to print can either be specified by a specific
180
revision identifier, or you can use --revision.
89
"""Write out metadata for a revision."""
184
takes_args = ['revision_id?']
185
takes_options = ['revision']
186
# cat-revision is more for frontends so should be exact
190
def run(self, revision_id=None, revision=None):
192
if revision_id is not None and revision is not None:
193
raise BzrCommandError('You can only supply one of revision_id or --revision')
194
if revision_id is None and revision is None:
195
raise BzrCommandError('You must supply either --revision or a revision_id')
196
b = WorkingTree.open_containing(u'.')[0].branch
198
# TODO: jam 20060112 should cat-revision always output utf-8?
199
if revision_id is not None:
200
self.outf.write(b.repository.get_revision_xml(revision_id).decode('utf-8'))
201
elif revision is not None:
204
raise BzrCommandError('You cannot specify a NULL revision.')
205
revno, rev_id = rev.in_history(b)
206
self.outf.write(b.repository.get_revision_xml(rev_id).decode('utf-8'))
92
takes_args = ['revision_id']
94
def run(self, revision_id):
96
sys.stdout.write(b.get_revision_xml_file(revision_id).read())
209
99
class cmd_revno(Command):
210
100
"""Show current revision number.
212
This is equal to the number of revisions on this branch.
215
takes_args = ['location?']
218
def run(self, location=u'.'):
219
self.outf.write(str(Branch.open_containing(location)[0].revno()))
220
self.outf.write('\n')
102
This is equal to the number of revisions on this branch."""
104
print find_branch('.').revno()
223
107
class cmd_revision_info(Command):
308
164
This is equivalent to creating the directory and then adding it.
311
166
takes_args = ['dir+']
312
encoding_type = 'replace'
314
168
def run(self, dir_list):
315
171
for d in dir_list:
317
wt, dd = WorkingTree.open_containing(d)
319
self.outf.write('added %s\n' % d)
322
179
class cmd_relpath(Command):
323
180
"""Show path of a file relative to root"""
325
181
takes_args = ['filename']
329
184
def run(self, filename):
330
# TODO: jam 20050106 Can relpath return a munged path if
331
# sys.stdout encoding cannot represent it?
332
tree, relpath = WorkingTree.open_containing(filename)
333
self.outf.write(relpath)
334
self.outf.write('\n')
185
print find_branch(filename).relpath(filename)
337
189
class cmd_inventory(Command):
338
"""Show inventory of the current working copy or a revision.
340
It is possible to limit the output to a particular entry
341
type using the --kind option. For example; --kind file.
344
takes_options = ['revision', 'show-ids', 'kind']
190
"""Show inventory of the current working copy or a revision."""
191
takes_options = ['revision', 'show-ids']
347
def run(self, revision=None, show_ids=False, kind=None):
348
if kind and kind not in ['file', 'directory', 'symlink']:
349
raise BzrCommandError('invalid kind specified')
350
tree = WorkingTree.open_containing(u'.')[0]
352
inv = tree.read_working_inventory()
193
def run(self, revision=None, show_ids=False):
196
inv = b.read_working_inventory()
354
198
if len(revision) > 1:
355
199
raise BzrCommandError('bzr inventory --revision takes'
356
200
' exactly one revision identifier')
357
inv = tree.branch.repository.get_revision_inventory(
358
revision[0].in_history(tree.branch).rev_id)
201
inv = b.get_revision_inventory(b.lookup_revision(revision[0]))
360
203
for path, entry in inv.entries():
361
if kind and kind != entry.kind:
364
self.outf.write('%-50s %s\n' % (path, entry.file_id))
205
print '%-50s %s' % (path, entry.file_id)
366
self.outf.write(path)
367
self.outf.write('\n')
210
class cmd_move(Command):
211
"""Move files to a different directory.
216
The destination must be a versioned directory in the same branch.
218
takes_args = ['source$', 'dest']
219
def run(self, source_list, dest):
222
# TODO: glob expansion on windows?
223
b.move([b.relpath(s) for s in source_list], b.relpath(dest))
226
class cmd_rename(Command):
227
"""Change the name of an entry.
230
bzr rename frob.c frobber.c
231
bzr rename src/frob.c lib/frob.c
233
It is an error if the destination name exists.
235
See also the 'move' command, which moves files into a different
236
directory without changing their name.
238
TODO: Some way to rename multiple files without invoking bzr for each
240
takes_args = ['from_name', 'to_name']
242
def run(self, from_name, to_name):
244
b.rename_one(b.relpath(from_name), b.relpath(to_name))
370
248
class cmd_mv(Command):
381
259
Files cannot be moved between branches.
384
261
takes_args = ['names*']
385
aliases = ['move', 'rename']
386
encoding_type = 'replace'
388
262
def run(self, names_list):
389
if names_list is None:
392
263
if len(names_list) < 2:
393
264
raise BzrCommandError("missing file argument")
394
tree, rel_names = tree_files(names_list)
265
b = find_branch(names_list[0])
267
rel_names = [b.relpath(x) for x in names_list]
396
269
if os.path.isdir(names_list[-1]):
397
270
# move into existing directory
398
for pair in tree.move(rel_names[:-1], rel_names[-1]):
399
self.outf.write("%s => %s\n" % pair)
271
for pair in b.move(rel_names[:-1], rel_names[-1]):
272
print "%s => %s" % pair
401
274
if len(names_list) != 2:
402
275
raise BzrCommandError('to mv multiple files the destination '
403
276
'must be a versioned directory')
404
tree.rename_one(rel_names[0], rel_names[1])
405
self.outf.write("%s => %s\n" % (rel_names[0], rel_names[1]))
277
for pair in b.move(rel_names[0], rel_names[1]):
278
print "%s => %s" % pair
408
283
class cmd_pull(Command):
409
"""Turn this branch into a mirror of another branch.
284
"""Pull any changes from another branch into the current one.
286
If the location is omitted, the last-used location will be used.
287
Both the revision history and the working directory will be
411
290
This command only works on branches that have not diverged. Branches are
412
considered diverged if the destination branch's most recent commit is one
413
that has not been merged (directly or indirectly) into the parent.
415
If branches have diverged, you can use 'bzr merge' to integrate the changes
416
from one into the other. Once one branch has merged, the other should
417
be able to pull it again.
419
If you want to forget your local changes and just update your branch to
420
match the remote one, use pull --overwrite.
422
If there is no default location set, the first pull will set it. After
423
that, you can omit the location to use the default. To change the
424
default, use --remember. The value will only be saved if the remote
425
location can be accessed.
291
considered diverged if both branches have had commits without first
292
pulling from the other.
294
If branches have diverged, you can use 'bzr merge' to pull the text changes
295
from one into the other.
428
takes_options = ['remember', 'overwrite', 'revision', 'verbose']
429
297
takes_args = ['location?']
430
encoding_type = 'replace'
432
def run(self, location=None, remember=False, overwrite=False, revision=None, verbose=False):
433
# FIXME: too much stuff is in the command class
299
def run(self, location=None):
300
from bzrlib.merge import merge
302
from shutil import rmtree
304
from bzrlib.branch import pull_loc
306
br_to = find_branch('.')
435
tree_to = WorkingTree.open_containing(u'.')[0]
436
branch_to = tree_to.branch
437
except NoWorkingTree:
439
branch_to = Branch.open_containing(u'.')[0]
442
if location is not None:
444
reader = bundle.read_bundle_from_url(location)
446
pass # Continue on considering this url a Branch
448
stored_loc = branch_to.get_parent()
309
stored_loc = br_to.controlfile("x-pull", "rb").read().rstrip('\n')
311
if e.errno != errno.ENOENT:
449
313
if location is None:
450
314
if stored_loc is None:
451
315
raise BzrCommandError("No pull location known or specified.")
453
display_url = urlutils.unescape_for_display(stored_loc,
455
self.outf.write("Using saved location: %s\n" % display_url)
456
location = stored_loc
459
if reader is not None:
460
install_bundle(branch_to.repository, reader)
461
branch_from = branch_to
463
branch_from = Branch.open(location)
465
if branch_to.get_parent() is None or remember:
466
branch_to.set_parent(branch_from.base)
470
if reader is not None:
471
rev_id = reader.target
472
elif len(revision) == 1:
473
rev_id = revision[0].in_history(branch_from).rev_id
475
raise BzrCommandError('bzr pull --revision takes one value.')
477
old_rh = branch_to.revision_history()
478
if tree_to is not None:
479
count = tree_to.pull(branch_from, overwrite, rev_id)
481
count = branch_to.pull(branch_from, overwrite, rev_id)
482
note('%d revision(s) pulled.' % (count,))
485
new_rh = branch_to.revision_history()
488
from bzrlib.log import show_changed_revisions
489
show_changed_revisions(branch_to, old_rh, new_rh,
493
class cmd_push(Command):
494
"""Update a mirror of this branch.
496
The target branch will not have its working tree populated because this
497
is both expensive, and is not supported on remote file systems.
499
Some smart servers or protocols *may* put the working tree in place in
502
This command only works on branches that have not diverged. Branches are
503
considered diverged if the destination branch's most recent commit is one
504
that has not been merged (directly or indirectly) by the source branch.
506
If branches have diverged, you can use 'bzr push --overwrite' to replace
507
the other branch completely, discarding its unmerged changes.
509
If you want to ensure you have the different changes in the other branch,
510
do a merge (see bzr help merge) from the other branch, and commit that.
511
After that you will be able to do a push without '--overwrite'.
513
If there is no default push location set, the first push will set it.
514
After that, you can omit the location to use the default. To change the
515
default, use --remember. The value will only be saved if the remote
516
location can be accessed.
519
takes_options = ['remember', 'overwrite', 'verbose',
520
Option('create-prefix',
521
help='Create the path leading up to the branch '
522
'if it does not already exist')]
523
takes_args = ['location?']
524
encoding_type = 'replace'
526
def run(self, location=None, remember=False, overwrite=False,
527
create_prefix=False, verbose=False):
528
# FIXME: Way too big! Put this into a function called from the
531
br_from = Branch.open_containing('.')[0]
532
stored_loc = br_from.get_push_location()
534
if stored_loc is None:
535
raise BzrCommandError("No push location known or specified.")
537
display_url = urlutils.unescape_for_display(stored_loc,
539
self.outf.write("Using saved location: %s\n" % display_url)
540
location = stored_loc
542
to_transport = transport.get_transport(location)
543
location_url = to_transport.base
317
print "Using last location: %s" % stored_loc
318
location = stored_loc
319
cache_root = tempfile.mkdtemp()
320
from bzrlib.branch import DivergedBranches
321
br_from = find_branch(location)
322
location = pull_loc(br_from)
323
old_revno = br_to.revno()
547
dir_to = bzrdir.BzrDir.open(location_url)
548
br_to = dir_to.open_branch()
549
except NotBranchError:
551
to_transport = to_transport.clone('..')
552
if not create_prefix:
554
relurl = to_transport.relpath(location_url)
555
mutter('creating directory %s => %s', location_url, relurl)
556
to_transport.mkdir(relurl)
558
raise BzrCommandError("Parent directory of %s "
559
"does not exist." % location)
561
current = to_transport.base
562
needed = [(to_transport, to_transport.relpath(location_url))]
565
to_transport, relpath = needed[-1]
566
to_transport.mkdir(relpath)
569
new_transport = to_transport.clone('..')
570
needed.append((new_transport,
571
new_transport.relpath(to_transport.base)))
572
if new_transport.base == to_transport.base:
573
raise BzrCommandError("Could not create "
575
dir_to = br_from.bzrdir.clone(location_url,
576
revision_id=br_from.last_revision())
577
br_to = dir_to.open_branch()
578
count = len(br_to.revision_history())
579
# We successfully created the target, remember it
580
if br_from.get_push_location() is None or remember:
581
br_from.set_push_location(br_to.base)
583
# We were able to connect to the remote location, so remember it
584
# we don't need to successfully push because of possible divergence.
585
if br_from.get_push_location() is None or remember:
586
br_from.set_push_location(br_to.base)
587
old_rh = br_to.revision_history()
325
from branch import find_cached_branch, DivergedBranches
326
br_from = find_cached_branch(location, cache_root)
327
location = pull_loc(br_from)
328
old_revno = br_to.revno()
590
tree_to = dir_to.open_workingtree()
591
except errors.NotLocalUrl:
592
warning('This transport does not update the working '
593
'tree of: %s' % (br_to.base,))
594
count = br_to.pull(br_from, overwrite)
595
except NoWorkingTree:
596
count = br_to.pull(br_from, overwrite)
598
count = tree_to.pull(br_from, overwrite)
330
br_to.update_revisions(br_from)
599
331
except DivergedBranches:
600
332
raise BzrCommandError("These branches have diverged."
601
" Try a merge then push with overwrite.")
602
note('%d revision(s) pushed.' % (count,))
335
merge(('.', -1), ('.', old_revno), check_clean=False)
336
if location != stored_loc:
337
br_to.controlfile("x-pull", "wb").write(location + "\n")
605
new_rh = br_to.revision_history()
608
from bzrlib.log import show_changed_revisions
609
show_changed_revisions(br_to, old_rh, new_rh,
613
343
class cmd_branch(Command):
619
349
To retrieve the branch as of a particular revision, supply the --revision
620
350
parameter, as in "branch foo/bar -r 5".
622
--basis is to speed up branching from remote branches. When specified, it
623
copies all the file-contents, inventory and revision data from the basis
624
branch before copying anything from the remote branch.
626
352
takes_args = ['from_location', 'to_location?']
627
takes_options = ['revision', 'basis']
353
takes_options = ['revision']
628
354
aliases = ['get', 'clone']
630
def run(self, from_location, to_location=None, revision=None, basis=None):
633
elif len(revision) > 1:
634
raise BzrCommandError(
635
'bzr branch --revision takes exactly 1 revision value')
637
br_from = Branch.open(from_location)
639
if e.errno == errno.ENOENT:
640
raise BzrCommandError('Source location "%s" does not'
641
' exist.' % to_location)
646
if basis is not None:
647
basis_dir = bzrdir.BzrDir.open_containing(basis)[0]
650
if len(revision) == 1 and revision[0] is not None:
651
revision_id = revision[0].in_history(br_from)[1]
653
# FIXME - wt.last_revision, fallback to branch, fall back to
654
# None or perhaps NULL_REVISION to mean copy nothing
656
revision_id = br_from.last_revision()
356
def run(self, from_location, to_location=None, revision=None):
357
from bzrlib.branch import copy_branch, find_cached_branch
360
from shutil import rmtree
361
cache_root = tempfile.mkdtemp()
365
elif len(revision) > 1:
366
raise BzrCommandError(
367
'bzr branch --revision takes exactly 1 revision value')
369
br_from = find_cached_branch(from_location, cache_root)
371
if e.errno == errno.ENOENT:
372
raise BzrCommandError('Source location "%s" does not'
373
' exist.' % to_location)
657
376
if to_location is None:
658
377
to_location = os.path.basename(from_location.rstrip("/\\"))
661
name = os.path.basename(to_location) + '\n'
663
to_transport = transport.get_transport(to_location)
665
to_transport.mkdir('.')
666
except errors.FileExists:
667
raise BzrCommandError('Target directory "%s" already'
668
' exists.' % to_location)
669
except errors.NoSuchFile:
670
raise BzrCommandError('Parent of "%s" does not exist.' %
673
# preserve whatever source format we have.
674
dir = br_from.bzrdir.sprout(to_transport.base,
675
revision_id, basis_dir)
676
branch = dir.open_branch()
677
except errors.NoSuchRevision:
678
to_transport.delete_tree('.')
679
msg = "The branch %s has no revision %s." % (from_location, revision[0])
680
raise BzrCommandError(msg)
681
except errors.UnlistableBranch:
682
osutils.rmtree(to_location)
683
msg = "The branch %s cannot be used as a --basis" % (basis,)
684
raise BzrCommandError(msg)
686
branch.control_files.put_utf8('branch-name', name)
687
note('Branched %d revision(s).' % branch.revno())
692
class cmd_checkout(Command):
693
"""Create a new checkout of an existing branch.
695
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
696
the branch found in '.'. This is useful if you have removed the working tree
697
or if it was never created - i.e. if you pushed the branch to its current
700
If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION will
701
be used. In other words, "checkout ../foo/bar" will attempt to create ./bar.
703
To retrieve the branch as of a particular revision, supply the --revision
704
parameter, as in "checkout foo/bar -r 5". Note that this will be immediately
705
out of date [so you cannot commit] but it may be useful (i.e. to examine old
708
--basis is to speed up checking out from remote branches. When specified, it
709
uses the inventory and file contents from the basis branch in preference to the
710
branch being checked out.
712
takes_args = ['branch_location?', 'to_location?']
713
takes_options = ['revision', # , 'basis']
714
Option('lightweight',
715
help="perform a lightweight checkout. Lightweight "
716
"checkouts depend on access to the branch for "
717
"every operation. Normal checkouts can perform "
718
"common operations like diff and status without "
719
"such access, and also support local commits."
724
def run(self, branch_location=None, to_location=None, revision=None, basis=None,
728
elif len(revision) > 1:
729
raise BzrCommandError(
730
'bzr checkout --revision takes exactly 1 revision value')
731
if branch_location is None:
732
branch_location = osutils.getcwd()
733
to_location = branch_location
734
source = Branch.open(branch_location)
735
if len(revision) == 1 and revision[0] is not None:
736
revision_id = revision[0].in_history(source)[1]
739
if to_location is None:
740
to_location = os.path.basename(branch_location.rstrip("/\\"))
741
# if the source and to_location are the same,
742
# and there is no working tree,
743
# then reconstitute a branch
744
if (osutils.abspath(to_location) ==
745
osutils.abspath(branch_location)):
747
source.bzrdir.open_workingtree()
748
except errors.NoWorkingTree:
749
source.bzrdir.create_workingtree()
752
os.mkdir(to_location)
754
if e.errno == errno.EEXIST:
755
raise BzrCommandError('Target directory "%s" already'
756
' exists.' % to_location)
757
if e.errno == errno.ENOENT:
758
raise BzrCommandError('Parent of "%s" does not exist.' %
762
old_format = bzrdir.BzrDirFormat.get_default_format()
763
bzrdir.BzrDirFormat.set_default_format(bzrdir.BzrDirMetaFormat1())
765
source.create_checkout(to_location, revision_id, lightweight)
767
bzrdir.BzrDirFormat.set_default_format(old_format)
379
os.mkdir(to_location)
381
if e.errno == errno.EEXIST:
382
raise BzrCommandError('Target directory "%s" already'
383
' exists.' % to_location)
384
if e.errno == errno.ENOENT:
385
raise BzrCommandError('Parent of "%s" does not exist.' %
390
copy_branch(br_from, to_location, revision[0])
391
except bzrlib.errors.NoSuchRevision:
393
msg = "The branch %s has no revision %d." % (from_location, revision[0])
394
raise BzrCommandError(msg)
770
399
class cmd_renames(Command):
771
400
"""Show list of renamed files.
402
TODO: Option to show renames between two historical versions.
404
TODO: Only show renames under dir, rather than in the whole branch.
773
# TODO: Option to show renames between two historical versions.
775
# TODO: Only show renames under dir, rather than in the whole branch.
776
406
takes_args = ['dir?']
779
def run(self, dir=u'.'):
780
from bzrlib.tree import find_renames
781
tree = WorkingTree.open_containing(dir)[0]
782
old_inv = tree.basis_tree().inventory
783
new_inv = tree.read_working_inventory()
784
renames = list(find_renames(old_inv, new_inv))
408
def run(self, dir='.'):
410
old_inv = b.basis_tree().inventory
411
new_inv = b.read_working_inventory()
413
renames = list(bzrlib.tree.find_renames(old_inv, new_inv))
786
415
for old_name, new_name in renames:
787
self.outf.write("%s => %s\n" % (old_name, new_name))
790
class cmd_update(Command):
791
"""Update a tree to have the latest code committed to its branch.
793
This will perform a merge into the working tree, and may generate
794
conflicts. If you have any local changes, you will still
795
need to commit them after the update for the update to be complete.
797
If you want to discard your local changes, you can just do a
798
'bzr revert' instead of 'bzr commit' after the update.
800
takes_args = ['dir?']
803
def run(self, dir='.'):
804
tree = WorkingTree.open_containing(dir)[0]
806
existing_pending_merges = tree.pending_merges()
808
last_rev = tree.last_revision()
809
if last_rev == tree.branch.last_revision():
810
# may be up to date, check master too.
811
master = tree.branch.get_master_branch()
812
if master is None or last_rev == master.last_revision():
813
revno = tree.branch.revision_id_to_revno(last_rev)
814
note("Tree is up to date at revision %d." % (revno,))
816
conflicts = tree.update()
817
revno = tree.branch.revision_id_to_revno(tree.last_revision())
818
note('Updated to revision %d.' % (revno,))
819
if tree.pending_merges() != existing_pending_merges:
820
note('Your local commits will now show as pending merges with '
821
"'bzr status', and can be committed with 'bzr commit'.")
416
print "%s => %s" % (old_name, new_name)
830
419
class cmd_info(Command):
831
"""Show information about a working tree, branch or repository.
833
This command will show all known locations and formats associated to the
834
tree, branch or repository. Statistical information is included with
837
Branches and working trees will also report any missing revisions.
839
takes_args = ['location?']
840
takes_options = ['verbose']
843
def run(self, location=None, verbose=False):
844
from bzrlib.info import show_bzrdir_info
845
show_bzrdir_info(bzrdir.BzrDir.open_containing(location)[0],
420
"""Show statistical information about a branch."""
421
takes_args = ['branch?']
423
def run(self, branch=None):
426
b = find_branch(branch)
849
430
class cmd_remove(Command):
884
448
same through all revisions where the file exists, even when it is
885
449
moved or renamed.
889
452
takes_args = ['filename']
892
453
def run(self, filename):
893
tree, relpath = WorkingTree.open_containing(filename)
894
i = tree.inventory.path2id(relpath)
454
b = find_branch(filename)
455
i = b.inventory.path2id(b.relpath(filename))
896
457
raise BzrError("%r is not a versioned file" % filename)
898
self.outf.write(i + '\n')
901
462
class cmd_file_path(Command):
902
463
"""Print path of file_ids to a file or directory.
904
465
This prints one line for each directory down to the target,
905
starting at the branch root.
466
starting at the branch root."""
909
468
takes_args = ['filename']
912
469
def run(self, filename):
913
tree, relpath = WorkingTree.open_containing(filename)
915
fid = inv.path2id(relpath)
470
b = find_branch(filename)
472
fid = inv.path2id(b.relpath(filename))
917
474
raise BzrError("%r is not a versioned file" % filename)
918
475
for fip in inv.get_idpath(fid):
919
self.outf.write(fip + '\n')
922
class cmd_reconcile(Command):
923
"""Reconcile bzr metadata in a branch.
925
This can correct data mismatches that may have been caused by
926
previous ghost operations or bzr upgrades. You should only
927
need to run this command if 'bzr check' or a bzr developer
928
advises you to run it.
930
If a second branch is provided, cross-branch reconciliation is
931
also attempted, which will check that data like the tree root
932
id which was not present in very early bzr versions is represented
933
correctly in both branches.
935
At the same time it is run it may recompress data resulting in
936
a potential saving in disk space or performance gain.
938
The branch *MUST* be on a listable system such as local disk or sftp.
940
takes_args = ['branch?']
942
def run(self, branch="."):
943
from bzrlib.reconcile import reconcile
944
dir = bzrdir.BzrDir.open(branch)
948
479
class cmd_revision_history(Command):
949
"""Display the list of revision ids on a branch."""
950
takes_args = ['location?']
480
"""Display list of revision ids on this branch."""
955
def run(self, location="."):
956
branch = Branch.open_containing(location)[0]
957
for revid in branch.revision_history():
958
self.outf.write(revid)
959
self.outf.write('\n')
483
for patchid in find_branch('.').revision_history():
962
487
class cmd_ancestry(Command):
963
488
"""List all revisions merged into this branch."""
964
takes_args = ['location?']
969
def run(self, location="."):
971
wt = WorkingTree.open_containing(location)[0]
972
except errors.NoWorkingTree:
973
b = Branch.open(location)
974
last_revision = b.last_revision()
977
last_revision = wt.last_revision()
979
revision_ids = b.repository.get_ancestry(last_revision)
980
assert revision_ids[0] == None
982
for revision_id in revision_ids:
983
self.outf.write(revision_id + '\n')
492
for revision_id in b.get_ancestry(b.last_revision()):
496
class cmd_directories(Command):
497
"""Display list of versioned directories in this branch."""
499
for name, ie in find_branch('.').read_working_inventory().directories():
986
506
class cmd_init(Command):
989
509
Use this to create an empty branch, or before importing an
990
510
existing project.
992
If there is a repository in a parent directory of the location, then
993
the history of the branch will be stored in the repository. Otherwise
994
init creates a standalone branch which carries its own history in
997
If there is already a branch at the location but it has no working tree,
998
the tree can be populated with 'bzr checkout'.
1000
512
Recipe for importing a tree of files:
1005
517
bzr commit -m 'imported project'
1007
takes_args = ['location?']
1010
help='Specify a format for this branch. Current'
1011
' formats are: default, knit, metaweave and'
1012
' weave. Default is knit; metaweave and'
1013
' weave are deprecated',
1014
type=get_format_type),
1016
def run(self, location=None, format=None):
1018
format = get_format_type('default')
1019
if location is None:
1022
to_transport = transport.get_transport(location)
1024
# The path has to exist to initialize a
1025
# branch inside of it.
1026
# Just using os.mkdir, since I don't
1027
# believe that we want to create a bunch of
1028
# locations if the user supplies an extended path
1029
# TODO: create-prefix
1031
to_transport.mkdir('.')
1032
except errors.FileExists:
1036
existing_bzrdir = bzrdir.BzrDir.open(location)
1037
except NotBranchError:
1038
# really a NotBzrDir error...
1039
bzrdir.BzrDir.create_branch_convenience(location, format=format)
1041
if existing_bzrdir.has_branch():
1042
if (isinstance(to_transport, LocalTransport)
1043
and not existing_bzrdir.has_workingtree()):
1044
raise errors.BranchExistsWithoutWorkingTree(location)
1045
raise errors.AlreadyBranchError(location)
1047
existing_bzrdir.create_branch()
1048
existing_bzrdir.create_workingtree()
1051
class cmd_init_repository(Command):
1052
"""Create a shared repository to hold branches.
1054
New branches created under the repository directory will store their revisions
1055
in the repository, not in the branch directory, if the branch format supports
1061
bzr checkout --lightweight repo/trunk trunk-checkout
1065
takes_args = ["location"]
1066
takes_options = [Option('format',
1067
help='Specify a format for this repository.'
1068
' Current formats are: default, knit,'
1069
' metaweave and weave. Default is knit;'
1070
' metaweave and weave are deprecated',
1071
type=get_format_type),
1073
help='Allows branches in repository to have'
1075
aliases = ["init-repo"]
1076
def run(self, location, format=None, trees=False):
1078
format = get_format_type('default')
1080
if location is None:
1083
to_transport = transport.get_transport(location)
1085
to_transport.mkdir('.')
1086
except errors.FileExists:
1089
newdir = format.initialize_on_transport(to_transport)
1090
repo = newdir.create_repository(shared=True)
1091
repo.set_make_working_trees(trees)
520
from bzrlib.branch import Branch
521
Branch('.', init=True)
1094
524
class cmd_diff(Command):
1095
"""Show differences in the working tree or between revisions.
525
"""Show differences in working tree.
1097
527
If files are listed, only the changes in those files are listed.
1098
528
Otherwise, all changes for the tree are listed.
1100
"bzr diff -p1" is equivalent to "bzr diff --prefix old/:new/", and
1101
produces patches suitable for "patch -p1".
530
TODO: Allow diff across branches.
532
TODO: Option to use external diff command; could be GNU diff, wdiff,
535
TODO: Python difflib is not exactly the same as unidiff; should
536
either fix it up or prefer to use an external diff.
538
TODO: If a directory is given, diff everything under that.
540
TODO: Selected-file diff is inefficient and doesn't show you
543
TODO: This probably handles non-Unix newlines poorly.
1105
Shows the difference in the working tree versus the last commit
1107
Difference between the working tree and revision 1
1109
Difference between revision 2 and revision 1
1110
bzr diff --diff-prefix old/:new/
1111
Same as 'bzr diff' but prefix paths with old/ and new/
1112
bzr diff bzr.mine bzr.dev
1113
Show the differences between the two working trees
1115
Show just the differences for 'foo.c'
1117
# TODO: Option to use external diff command; could be GNU diff, wdiff,
1118
# or a graphical diff.
1120
# TODO: Python difflib is not exactly the same as unidiff; should
1121
# either fix it up or prefer to use an external diff.
1123
# TODO: Selected-file diff is inefficient and doesn't show you
1126
# TODO: This probably handles non-Unix newlines poorly.
1128
551
takes_args = ['file*']
1129
takes_options = ['revision', 'diff-options', 'prefix']
552
takes_options = ['revision', 'diff-options']
1130
553
aliases = ['di', 'dif']
1131
encoding_type = 'exact'
1134
def run(self, revision=None, file_list=None, diff_options=None,
1136
from bzrlib.diff import diff_cmd_helper, show_diff_trees
1138
if (prefix is None) or (prefix == '0'):
555
def run(self, revision=None, file_list=None, diff_options=None):
556
from bzrlib.diff import show_diff
559
b = find_branch(file_list[0])
560
file_list = [b.relpath(f) for f in file_list]
561
if file_list == ['']:
562
# just pointing to top-of-tree
1146
if not ':' in prefix:
1147
raise BzrError("--diff-prefix expects two values separated by a colon")
1148
old_label, new_label = prefix.split(":")
1151
tree1, file_list = internal_tree_files(file_list)
1155
except FileInWrongBranch:
1156
if len(file_list) != 2:
1157
raise BzrCommandError("Files are in different branches")
1159
tree1, file1 = WorkingTree.open_containing(file_list[0])
1160
tree2, file2 = WorkingTree.open_containing(file_list[1])
1161
if file1 != "" or file2 != "":
1162
# FIXME diff those two files. rbc 20051123
1163
raise BzrCommandError("Files are in different branches")
1165
except NotBranchError:
1166
if (revision is not None and len(revision) == 2
1167
and not revision[0].needs_branch()
1168
and not revision[1].needs_branch()):
1169
# If both revision specs include a branch, we can
1170
# diff them without needing a local working tree
1171
tree1, tree2 = None, None
1174
567
if revision is not None:
1175
if tree2 is not None:
1176
raise BzrCommandError("Can't specify -r with two branches")
1177
if (len(revision) == 1) or (revision[1].spec is None):
1178
return diff_cmd_helper(tree1, file_list, diff_options,
1180
old_label=old_label, new_label=new_label)
568
if len(revision) == 1:
569
show_diff(b, revision[0], specific_files=file_list,
570
external_diff_options=diff_options)
1181
571
elif len(revision) == 2:
1182
return diff_cmd_helper(tree1, file_list, diff_options,
1183
revision[0], revision[1],
1184
old_label=old_label, new_label=new_label)
572
show_diff(b, revision[0], specific_files=file_list,
573
external_diff_options=diff_options,
574
revision2=revision[1])
1186
576
raise BzrCommandError('bzr diff --revision takes exactly one or two revision identifiers')
1188
if tree2 is not None:
1189
return show_diff_trees(tree1, tree2, sys.stdout,
1190
specific_files=file_list,
1191
external_diff_options=diff_options,
1192
old_label=old_label, new_label=new_label)
1194
return diff_cmd_helper(tree1, file_list, diff_options,
1195
old_label=old_label, new_label=new_label)
578
show_diff(b, None, specific_files=file_list,
579
external_diff_options=diff_options)
1198
584
class cmd_deleted(Command):
1199
585
"""List files deleted in the working tree.
587
TODO: Show files deleted since a previous revision, or between two revisions.
1201
# TODO: Show files deleted since a previous revision, or
1202
# between two revisions.
1203
# TODO: Much more efficient way to do this: read in new
1204
# directories with readdir, rather than stating each one. Same
1205
# level of effort but possibly much less IO. (Or possibly not,
1206
# if the directories are very large...)
1207
takes_options = ['show-ids']
1210
589
def run(self, show_ids=False):
1211
tree = WorkingTree.open_containing(u'.')[0]
1212
old = tree.basis_tree()
592
new = b.working_tree()
594
## TODO: Much more efficient way to do this: read in new
595
## directories with readdir, rather than stating each one. Same
596
## level of effort but possibly much less IO. (Or possibly not,
597
## if the directories are very large...)
1213
599
for path, ie in old.inventory.iter_entries():
1214
if not tree.has_id(ie.file_id):
1215
self.outf.write(path)
600
if not new.has_id(ie.file_id):
1217
self.outf.write(' ')
1218
self.outf.write(ie.file_id)
1219
self.outf.write('\n')
602
print '%-50s %s' % (path, ie.file_id)
1222
607
class cmd_modified(Command):
1223
608
"""List files modified in working tree."""
1227
tree = WorkingTree.open_containing(u'.')[0]
1228
td = tree.changes_from(tree.basis_tree())
1229
for path, id, kind, text_modified, meta_modified in td.modified:
1230
self.outf.write(path + '\n')
611
from bzrlib.delta import compare_trees
614
td = compare_trees(b.basis_tree(), b.working_tree())
616
for path, id, kind in td.modified:
1233
621
class cmd_added(Command):
1234
622
"""List files added in working tree."""
1238
wt = WorkingTree.open_containing(u'.')[0]
1239
basis_inv = wt.basis_tree().inventory
626
wt = b.working_tree()
627
basis_inv = b.basis_tree().inventory
1240
628
inv = wt.inventory
1241
629
for file_id in inv:
1242
630
if file_id in basis_inv:
1244
632
path = inv.id2path(file_id)
1245
if not os.access(osutils.abspath(path), os.F_OK):
633
if not os.access(b.abspath(path), os.F_OK):
1247
self.outf.write(path + '\n')
1250
639
class cmd_root(Command):
1251
640
"""Show the tree root directory.
1253
642
The root is the nearest enclosing directory with a .bzr control
1255
644
takes_args = ['filename?']
1257
645
def run(self, filename=None):
1258
646
"""Print the branch root."""
1259
tree = WorkingTree.open_containing(filename)[0]
1260
self.outf.write(tree.basedir + '\n')
647
b = find_branch(filename)
648
print getattr(b, 'base', None) or getattr(b, 'baseurl')
1263
651
class cmd_log(Command):
1264
"""Show log of a branch, file, or directory.
1266
By default show the log of the branch containing the working directory.
1268
To request a range of logs, you can use the command -r begin..end
1269
-r revision requests a specific revision, -r ..end or -r begin.. are
652
"""Show log of this branch.
654
To request a range of logs, you can use the command -r begin:end
655
-r revision requests a specific revision, -r :end or -r begin: are
1275
bzr log -r -10.. http://server/branch
658
--message allows you to give a regular expression, which will be evaluated
659
so that only matching entries will be displayed.
661
TODO: Make --revision support uuid: and hash: [future tag:] notation.
1278
# TODO: Make --revision support uuid: and hash: [future tag:] notation.
1280
takes_args = ['location?']
1281
takes_options = [Option('forward',
1282
help='show from oldest to newest'),
1285
help='show files changed in each revision'),
1286
'show-ids', 'revision',
1290
help='show revisions whose message matches this regexp',
1294
encoding_type = 'replace'
1297
def run(self, location=None, timezone='original',
665
takes_args = ['filename?']
666
takes_options = ['forward', 'timezone', 'verbose', 'show-ids', 'revision',
667
'long', 'message', 'short',]
669
def run(self, filename=None, timezone='original',
1307
677
from bzrlib.log import log_formatter, show_log
1308
assert message is None or isinstance(message, basestring), \
1309
"invalid message argument %r" % message
1310
680
direction = (forward and 'forward') or 'reverse'
1315
# find the file id to log:
1317
dir, fp = bzrdir.BzrDir.open_containing(location)
1318
b = dir.open_branch()
1322
inv = dir.open_workingtree().inventory
1323
except (errors.NotBranchError, errors.NotLocalUrl):
1324
# either no tree, or is remote.
1325
inv = b.basis_tree().inventory
1326
file_id = inv.path2id(fp)
683
b = find_branch(filename)
684
fp = b.relpath(filename)
686
file_id = b.read_working_inventory().path2id(fp)
688
file_id = None # points to branch root
1329
# FIXME ? log the current subdir only RBC 20060203
1330
dir, relpath = bzrdir.BzrDir.open_containing('.')
1331
b = dir.open_branch()
1333
693
if revision is None:
1336
696
elif len(revision) == 1:
1337
rev1 = rev2 = revision[0].in_history(b).revno
697
rev1 = rev2 = b.get_revision_info(revision[0])[0]
1338
698
elif len(revision) == 2:
1339
if revision[0].spec is None:
1340
# missing begin-range means first revision
1343
rev1 = revision[0].in_history(b).revno
1345
if revision[1].spec is None:
1346
# missing end-range means last known revision
1349
rev2 = revision[1].in_history(b).revno
699
rev1 = b.get_revision_info(revision[0])[0]
700
rev2 = b.get_revision_info(revision[1])[0]
1351
702
raise BzrCommandError('bzr log --revision takes one or two values.')
1353
# By this point, the revision numbers are converted to the +ve
1354
# form if they were supplied in the -ve form, so we can do
1355
# this comparison in relative safety
1357
(rev2, rev1) = (rev1, rev2)
1359
if (log_format == None):
1360
default = b.get_config().log_format()
1361
log_format = get_log_format(long=long, short=short, line=line,
709
mutter('encoding log as %r' % bzrlib.user_encoding)
711
# use 'replace' so that we don't abort if trying to write out
712
# in e.g. the default C locale.
713
outf = codecs.getwriter(bzrlib.user_encoding)(sys.stdout, errors='replace')
1363
719
lf = log_formatter(log_format,
1364
720
show_ids=show_ids,
1366
722
show_timezone=timezone)
1378
def get_log_format(long=False, short=False, line=False, default='long'):
1379
log_format = default
1383
log_format = 'short'
1389
735
class cmd_touching_revisions(Command):
1390
736
"""Return revision-ids which affected a particular file.
1392
A more user-friendly interface is "bzr log FILE".
738
A more user-friendly interface is "bzr log FILE"."""
1396
740
takes_args = ["filename"]
1399
741
def run(self, filename):
1400
tree, relpath = WorkingTree.open_containing(filename)
1402
inv = tree.read_working_inventory()
1403
file_id = inv.path2id(relpath)
1404
for revno, revision_id, what in log.find_touching_revisions(b, file_id):
1405
self.outf.write("%6d %s\n" % (revno, what))
742
b = find_branch(filename)
743
inv = b.read_working_inventory()
744
file_id = inv.path2id(b.relpath(filename))
745
for revno, revision_id, what in bzrlib.log.find_touching_revisions(b, file_id):
746
print "%6d %s" % (revno, what)
1408
749
class cmd_ls(Command):
1409
750
"""List files in a tree.
752
TODO: Take a revision or remote path and list that tree instead.
1411
# TODO: Take a revision or remote path and list that tree instead.
1413
takes_options = ['verbose', 'revision',
1414
Option('non-recursive',
1415
help='don\'t recurse into sub-directories'),
1417
help='Print all paths from the root of the branch.'),
1418
Option('unknown', help='Print unknown files'),
1419
Option('versioned', help='Print versioned files'),
1420
Option('ignored', help='Print ignored files'),
1422
Option('null', help='Null separate the files'),
1425
def run(self, revision=None, verbose=False,
1426
non_recursive=False, from_root=False,
1427
unknown=False, versioned=False, ignored=False,
1430
if verbose and null:
1431
raise BzrCommandError('Cannot set both --verbose and --null')
1432
all = not (unknown or versioned or ignored)
1434
selection = {'I':ignored, '?':unknown, 'V':versioned}
1436
tree, relpath = WorkingTree.open_containing(u'.')
1441
if revision is not None:
1442
tree = tree.branch.repository.revision_tree(
1443
revision[0].in_history(tree.branch).rev_id)
1445
for fp, fc, kind, fid, entry in tree.list_files():
1446
if fp.startswith(relpath):
1447
fp = fp[len(relpath):]
1448
if non_recursive and '/' in fp:
1450
if not all and not selection[fc]:
1453
kindch = entry.kind_character()
1454
self.outf.write('%-8s %s%s\n' % (fc, fp, kindch))
1456
self.outf.write(fp + '\0')
755
def run(self, revision=None, verbose=False):
758
tree = b.working_tree()
760
tree = b.revision_tree(b.lookup_revision(revision))
762
for fp, fc, kind, fid in tree.list_files():
764
if kind == 'directory':
1459
self.outf.write(fp + '\n')
771
print '%-8s %s%s' % (fc, fp, kindch)
1462
777
class cmd_unknowns(Command):
1463
778
"""List unknown files."""
1466
for f in WorkingTree.open_containing(u'.')[0].unknowns():
1467
self.outf.write(osutils.quotefn(f) + '\n')
780
from bzrlib.osutils import quotefn
781
for f in find_branch('.').unknowns():
1470
786
class cmd_ignore(Command):
1657
945
A selected-file commit may fail in some cases where the committed
1658
946
tree would be invalid, such as trying to commit a file in a
1659
947
newly-added directory that is not itself committed.
949
TODO: Run hooks on tree to-be-committed, and after commit.
951
TODO: Strict commit that fails if there are unknown or deleted files.
1661
# TODO: Run hooks on tree to-be-committed, and after commit.
1663
# TODO: Strict commit that fails if there are deleted files.
1664
# (what does "deleted files" mean ??)
953
takes_args = ['selected*']
954
takes_options = ['message', 'file', 'verbose', 'unchanged']
955
aliases = ['ci', 'checkin']
1666
957
# TODO: Give better message for -s, --summary, used by tla people
1668
959
# XXX: verbose currently does nothing
1670
takes_args = ['selected*']
1671
takes_options = ['message', 'verbose',
1673
help='commit even if nothing has changed'),
1674
Option('file', type=str,
1676
help='file containing commit message'),
1678
help="refuse to commit if there are unknown "
1679
"files in the working tree."),
1681
help="perform a local only commit in a bound "
1682
"branch. Such commits are not pushed to "
1683
"the master branch until a normal commit "
1687
aliases = ['ci', 'checkin']
1689
961
def run(self, message=None, file=None, verbose=True, selected_list=None,
1690
unchanged=False, strict=False, local=False):
1691
from bzrlib.commit import (NullCommitReporter, ReportCommitToLog)
1692
from bzrlib.errors import (PointlessCommit, ConflictsInTree,
1694
from bzrlib.msgeditor import edit_commit_message, \
1695
make_commit_message_template
1696
from tempfile import TemporaryFile
1698
# TODO: Need a blackbox test for invoking the external editor; may be
1699
# slightly problematic to run this cross-platform.
1701
# TODO: do more checks that the commit will succeed before
1702
# spending the user's valuable time typing a commit message.
1704
# TODO: if the commit *does* happen to fail, then save the commit
1705
# message to a temporary file where it can be recovered
1706
tree, selected_list = tree_files(selected_list)
1707
if selected_list == ['']:
1708
# workaround - commit of root of tree should be exactly the same
1709
# as just default commit in that tree, and succeed even though
1710
# selected-file merge commit is not done yet
1713
if local and not tree.branch.get_bound_location():
1714
raise errors.LocalRequiresBoundBranch()
1715
if message is None and not file:
1716
template = make_commit_message_template(tree, selected_list)
1717
message = edit_commit_message(template)
963
from bzrlib.errors import PointlessCommit
964
from bzrlib.msgeditor import edit_commit_message
965
from bzrlib.status import show_status
966
from cStringIO import StringIO
970
selected_list = [b.relpath(s) for s in selected_list]
972
if not message and not file:
974
show_status(b, specific_files=selected_list,
976
message = edit_commit_message(catcher.getvalue())
1718
978
if message is None:
1719
979
raise BzrCommandError("please specify a commit message"
1720
980
" with either --message or --file")
1722
982
raise BzrCommandError("please specify either --message or --file")
1725
986
message = codecs.open(file, 'rt', bzrlib.user_encoding).read()
1728
raise BzrCommandError("empty commit message specified")
1731
reporter = ReportCommitToLog()
1733
reporter = NullCommitReporter()
1736
tree.commit(message, specific_files=selected_list,
1737
allow_pointless=unchanged, strict=strict, local=local,
990
specific_files=selected_list,
991
allow_pointless=unchanged)
1739
992
except PointlessCommit:
1740
993
# FIXME: This should really happen before the file is read in;
1741
994
# perhaps prepare the commit; get the message; then actually commit
1742
raise BzrCommandError("no changes to commit."
1743
" use --unchanged to commit anyhow")
1744
except ConflictsInTree:
1745
raise BzrCommandError("Conflicts detected in working tree. "
1746
'Use "bzr conflicts" to list, "bzr resolve FILE" to resolve.')
1747
except StrictCommitFailed:
1748
raise BzrCommandError("Commit refused because there are unknown "
1749
"files in the working tree.")
1750
except errors.BoundBranchOutOfDate, e:
1751
raise BzrCommandError(str(e) + "\n"
1752
'To commit to master branch, run update and then commit.\n'
1753
'You can also pass --local to commit to continue working '
995
raise BzrCommandError("no changes to commit",
996
["use --unchanged to commit anyhow"])
1756
999
class cmd_check(Command):
1757
1000
"""Validate consistency of branch history.
1759
1002
This command checks various invariants about the branch storage to
1760
1003
detect data corruption or bzr bugs.
1005
If given the --update flag, it will update some optional fields
1006
to help ensure data consistency.
1762
takes_args = ['branch?']
1763
takes_options = ['verbose']
1008
takes_args = ['dir?']
1765
def run(self, branch=None, verbose=False):
1010
def run(self, dir='.'):
1766
1011
from bzrlib.check import check
1768
tree = WorkingTree.open_containing()[0]
1769
branch = tree.branch
1771
branch = Branch.open(branch)
1772
check(branch, verbose)
1013
check(find_branch(dir))
1775
1016
class cmd_scan_cache(Command):
1790
1031
if c.needs_write:
1794
1036
class cmd_upgrade(Command):
1795
1037
"""Upgrade branch storage to current format.
1797
1039
The check command or bzr developers may sometimes advise you to run
1798
this command. When the default format has changed you may also be warned
1799
during other operations to upgrade.
1801
takes_args = ['url?']
1804
help='Upgrade to a specific format. Current formats'
1805
' are: default, knit, metaweave and weave.'
1806
' Default is knit; metaweave and weave are'
1808
type=get_format_type),
1812
def run(self, url='.', format=None):
1042
takes_args = ['dir?']
1044
def run(self, dir='.'):
1813
1045
from bzrlib.upgrade import upgrade
1815
format = get_format_type('default')
1816
upgrade(url, format)
1046
upgrade(find_branch(dir))
1819
1050
class cmd_whoami(Command):
1820
"""Show or set bzr user id.
1824
bzr whoami 'Frank Chu <fchu@example.com>'
1826
takes_options = [ Option('email',
1827
help='display email address only'),
1829
help='set identity for the current branch instead of '
1832
takes_args = ['name?']
1833
encoding_type = 'replace'
1836
def run(self, email=False, branch=False, name=None):
1838
# use branch if we're inside one; otherwise global config
1840
c = Branch.open_containing('.')[0].get_config()
1841
except NotBranchError:
1842
c = config.GlobalConfig()
1844
self.outf.write(c.user_email() + '\n')
1846
self.outf.write(c.username() + '\n')
1849
# display a warning if an email address isn't included in the given name.
1051
"""Show bzr user id."""
1052
takes_options = ['email']
1054
def run(self, email=False):
1851
config.extract_email_address(name)
1853
warning('"%s" does not seem to contain an email address. '
1854
'This is allowed, but not recommended.', name)
1056
b = bzrlib.branch.find_branch('.')
1856
# use global config unless --branch given
1858
c = Branch.open_containing('.')[0].get_config()
1860
c = config.GlobalConfig()
1861
c.set_user_option('email', name)
1864
class cmd_nick(Command):
1865
"""Print or set the branch nickname.
1867
If unset, the tree root directory name is used as the nickname
1868
To print the current nickname, execute with no argument.
1870
takes_args = ['nickname?']
1871
def run(self, nickname=None):
1872
branch = Branch.open_containing(u'.')[0]
1873
if nickname is None:
1874
self.printme(branch)
1876
branch.nick = nickname
1879
def printme(self, branch):
1061
print bzrlib.osutils.user_email(b)
1063
print bzrlib.osutils.username(b)
1883
1066
class cmd_selftest(Command):
1884
"""Run internal test suite.
1886
This creates temporary test directories in the working directory,
1887
but not existing data is affected. These directories are deleted
1888
if the tests pass, or left behind to help in debugging if they
1889
fail and --keep-output is specified.
1891
If arguments are given, they are regular expressions that say
1892
which tests should run.
1894
If the global option '--no-plugins' is given, plugins are not loaded
1895
before running the selftests. This has two effects: features provided or
1896
modified by plugins will not be tested, and tests provided by plugins will
1901
bzr --no-plugins selftest -v
1903
# TODO: --list should give a list of all available tests
1905
# NB: this is used from the class without creating an instance, which is
1906
# why it does not have a self parameter.
1907
def get_transport_type(typestring):
1908
"""Parse and return a transport specifier."""
1909
if typestring == "sftp":
1910
from bzrlib.transport.sftp import SFTPAbsoluteServer
1911
return SFTPAbsoluteServer
1912
if typestring == "memory":
1913
from bzrlib.transport.memory import MemoryServer
1915
if typestring == "fakenfs":
1916
from bzrlib.transport.fakenfs import FakeNFSServer
1917
return FakeNFSServer
1918
msg = "No known transport type %s. Supported types are: sftp\n" %\
1920
raise BzrCommandError(msg)
1067
"""Run internal test suite"""
1923
takes_args = ['testspecs*']
1924
takes_options = ['verbose',
1925
Option('one', help='stop when one test fails'),
1926
Option('keep-output',
1927
help='keep output directories when tests fail'),
1929
help='Use a different transport by default '
1930
'throughout the test suite.',
1931
type=get_transport_type),
1932
Option('benchmark', help='run the bzr bencharks.'),
1933
Option('lsprof-timed',
1934
help='generate lsprof output for benchmarked'
1935
' sections of code.'),
1938
def run(self, testspecs_list=None, verbose=None, one=False,
1939
keep_output=False, transport=None, benchmark=None,
1069
takes_options = ['verbose', 'pattern']
1070
def run(self, verbose=False, pattern=".*"):
1941
1071
import bzrlib.ui
1942
from bzrlib.tests import selftest
1943
import bzrlib.benchmarks as benchmarks
1072
from bzrlib.selftest import selftest
1944
1073
# we don't want progress meters from the tests to go to the
1945
1074
# real output; and we don't want log messages cluttering up
1946
1075
# the real logs.
1947
save_ui = ui.ui_factory
1948
print '%10s: %s' % ('bzr', osutils.realpath(sys.argv[0]))
1949
print '%10s: %s' % ('bzrlib', bzrlib.__path__[0])
1951
info('running tests...')
1076
save_ui = bzrlib.ui.ui_factory
1077
bzrlib.trace.info('running tests...')
1953
ui.ui_factory = ui.SilentUIFactory()
1954
if testspecs_list is not None:
1955
pattern = '|'.join(testspecs_list)
1959
test_suite_factory = benchmarks.test_suite
1963
test_suite_factory = None
1966
result = selftest(verbose=verbose,
1968
stop_on_failure=one,
1969
keep_output=keep_output,
1970
transport=transport,
1971
test_suite_factory=test_suite_factory,
1972
lsprof_timed=lsprof_timed)
1079
bzrlib.ui.ui_factory = bzrlib.ui.SilentUIFactory()
1080
result = selftest(verbose=verbose, pattern=pattern)
1974
info('tests passed')
1082
bzrlib.trace.info('tests passed')
1976
info('tests failed')
1084
bzrlib.trace.info('tests failed')
1977
1085
return int(not result)
1979
ui.ui_factory = save_ui
1982
def _get_bzr_branch():
1983
"""If bzr is run from a branch, return Branch or None"""
1984
from os.path import dirname
1987
branch = Branch.open(dirname(osutils.abspath(dirname(__file__))))
1989
except errors.BzrError:
1087
bzrlib.ui.ui_factory = save_ui
1993
1090
def show_version():
1995
print "Bazaar (bzr) %s" % bzrlib.__version__
1091
print "bzr (bazaar-ng) %s" % bzrlib.__version__
1996
1092
# is bzrlib itself in a branch?
1997
branch = _get_bzr_branch()
1999
rh = branch.revision_history()
2001
print " bzr checkout, revision %d" % (revno,)
2002
print " nick: %s" % (branch.nick,)
2004
print " revid: %s" % (rh[-1],)
2005
print "Using python interpreter:", sys.executable
2007
print "Using python standard library:", os.path.dirname(site.__file__)
2008
print "Using bzrlib:",
2009
if len(bzrlib.__path__) > 1:
2010
# print repr, which is a good enough way of making it clear it's
2011
# more than one element (eg ['/foo/bar', '/foo/bzr'])
2012
print repr(bzrlib.__path__)
2014
print bzrlib.__path__[0]
1093
bzrrev = bzrlib.get_bzr_revision()
1095
print " (bzr checkout, revision %d {%s})" % bzrrev
2017
1096
print bzrlib.__copyright__
2018
print "http://bazaar-vcs.org/"
1097
print "http://bazaar-ng.org/"
2020
1099
print "bzr comes with ABSOLUTELY NO WARRANTY. bzr is free software, and"
2021
1100
print "you may use, modify and redistribute it under the terms of the GNU"
2060
1134
last1 = branch1.last_revision()
2061
1135
last2 = branch2.last_revision()
2063
source = MultipleRevisionSources(branch1.repository,
1137
source = MultipleRevisionSources(branch1, branch2)
2066
1139
base_rev_id = common_ancestor(last1, last2, source)
2068
1141
print 'merge base is revision %s' % base_rev_id
1145
if base_revno is None:
1146
raise bzrlib.errors.UnrelatedBranches()
1148
print ' r%-6d in %s' % (base_revno, branch)
1150
other_revno = branch2.revision_id_to_revno(base_revid)
1152
print ' r%-6d in %s' % (other_revno, other)
2071
1156
class cmd_merge(Command):
2072
1157
"""Perform a three-way merge.
2074
The branch is the branch you will merge from. By default, it will merge
2075
the latest revision. If you specify a revision, that revision will be
2076
merged. If you specify two revisions, the first will be used as a BASE,
2077
and the second one as OTHER. Revision numbers are always relative to the
1159
The branch is the branch you will merge from. By default, it will
1160
merge the latest revision. If you specify a revision, that
1161
revision will be merged. If you specify two revisions, the first
1162
will be used as a BASE, and the second one as OTHER. Revision
1163
numbers are always relative to the specified branch.
2080
By default, bzr will try to merge in all new work from the other
1165
By default bzr will try to merge in all new work from the other
2081
1166
branch, automatically determining an appropriate base. If this
2082
1167
fails, you may need to give an explicit base.
2084
Merge will do its best to combine the changes in two branches, but there
2085
are some kinds of problems only a human can fix. When it encounters those,
2086
it will mark a conflict. A conflict means that you need to fix something,
2087
before you should commit.
2089
Use bzr resolve when you have fixed a problem. See also bzr conflicts.
2091
If there is no default branch set, the first merge will set it. After
2092
that, you can omit the branch to use the default. To change the
2093
default, use --remember. The value will only be saved if the remote
2094
location can be accessed.
2098
1171
To merge the latest revision from bzr.dev
2107
1180
merge refuses to run if there are any uncommitted changes, unless
2108
1181
--force is given.
2110
The following merge types are available:
2112
1183
takes_args = ['branch?']
2113
takes_options = ['revision', 'force', 'merge-type', 'reprocess', 'remember',
2114
Option('show-base', help="Show base revision text in "
2116
Option('uncommitted', help='Apply uncommitted changes'
2117
' from a working copy, instead of branch changes')]
2120
from merge import merge_type_help
2121
from inspect import getdoc
2122
return getdoc(self) + '\n' + merge_type_help()
2124
def run(self, branch=None, revision=None, force=False, merge_type=None,
2125
show_base=False, reprocess=False, remember=False,
1184
takes_options = ['revision', 'force', 'merge-type']
1186
def run(self, branch='.', revision=None, force=False,
1188
from bzrlib.merge import merge
1189
from bzrlib.merge_core import ApplyMerge3
2127
1190
if merge_type is None:
2128
merge_type = Merge3Merger
2130
tree = WorkingTree.open_containing(u'.')[0]
2132
if branch is not None:
2134
reader = bundle.read_bundle_from_url(branch)
2136
pass # Continue on considering this url a Branch
2138
conflicts = merge_bundle(reader, tree, not force, merge_type,
2139
reprocess, show_base)
2145
branch = self._get_remembered_parent(tree, branch, 'Merging from')
1191
merge_type = ApplyMerge3
2147
1193
if revision is None or len(revision) < 1:
2150
other = [branch, None]
2153
other = [branch, -1]
2154
other_branch, path = Branch.open_containing(branch)
1195
other = [branch, -1]
2157
raise BzrCommandError('Cannot use --uncommitted and --revision'
2158
' at the same time.')
2159
1197
if len(revision) == 1:
1198
other = [branch, revision[0]]
2160
1199
base = [None, None]
2161
other_branch, path = Branch.open_containing(branch)
2162
revno = revision[0].in_history(other_branch).revno
2163
other = [branch, revno]
2165
1201
assert len(revision) == 2
2166
1202
if None in revision:
2167
1203
raise BzrCommandError(
2168
1204
"Merge doesn't permit that revision specifier.")
2169
other_branch, path = Branch.open_containing(branch)
2171
base = [branch, revision[0].in_history(other_branch).revno]
2172
other = [branch, revision[1].in_history(other_branch).revno]
2174
if tree.branch.get_parent() is None or remember:
2175
tree.branch.set_parent(other_branch.base)
2178
interesting_files = [path]
2180
interesting_files = None
2181
pb = ui.ui_factory.nested_progress_bar()
1205
base = [branch, revision[0]]
1206
other = [branch, revision[1]]
2184
conflict_count = merge(other, base, check_clean=(not force),
2185
merge_type=merge_type,
2186
reprocess=reprocess,
2187
show_base=show_base,
2188
pb=pb, file_list=interesting_files)
2191
if conflict_count != 0:
2195
except errors.AmbiguousBase, e:
1209
merge(other, base, check_clean=(not force), merge_type=merge_type)
1210
except bzrlib.errors.AmbiguousBase, e:
2196
1211
m = ("sorry, bzr can't determine the right merge base yet\n"
2197
1212
"candidates are:\n "
2198
1213
+ "\n ".join(e.bases)
2201
1216
"and (if you want) report this to the bzr developers\n")
2204
# TODO: move up to common parent; this isn't merge-specific anymore.
2205
def _get_remembered_parent(self, tree, supplied_location, verb_string):
2206
"""Use tree.branch's parent if none was supplied.
2208
Report if the remembered location was used.
2210
if supplied_location is not None:
2211
return supplied_location
2212
stored_location = tree.branch.get_parent()
2213
mutter("%s", stored_location)
2214
if stored_location is None:
2215
raise BzrCommandError("No location specified or remembered")
2216
display_url = urlutils.unescape_for_display(stored_location, self.outf.encoding)
2217
self.outf.write("%s remembered location %s\n" % (verb_string, display_url))
2218
return stored_location
2221
class cmd_remerge(Command):
2224
Use this if you want to try a different merge technique while resolving
2225
conflicts. Some merge techniques are better than others, and remerge
2226
lets you try different ones on different files.
2228
The options for remerge have the same meaning and defaults as the ones for
2229
merge. The difference is that remerge can (only) be run when there is a
2230
pending merge, and it lets you specify particular files.
2233
$ bzr remerge --show-base
2234
Re-do the merge of all conflicted files, and show the base text in
2235
conflict regions, in addition to the usual THIS and OTHER texts.
2237
$ bzr remerge --merge-type weave --reprocess foobar
2238
Re-do the merge of "foobar", using the weave merge algorithm, with
2239
additional processing to reduce the size of conflict regions.
2241
The following merge types are available:"""
2242
takes_args = ['file*']
2243
takes_options = ['merge-type', 'reprocess',
2244
Option('show-base', help="Show base revision text in "
2248
from merge import merge_type_help
2249
from inspect import getdoc
2250
return getdoc(self) + '\n' + merge_type_help()
2252
def run(self, file_list=None, merge_type=None, show_base=False,
2254
from bzrlib.merge import merge_inner, transform_tree
2255
if merge_type is None:
2256
merge_type = Merge3Merger
2257
tree, file_list = tree_files(file_list)
2260
pending_merges = tree.pending_merges()
2261
if len(pending_merges) != 1:
2262
raise BzrCommandError("Sorry, remerge only works after normal"
2263
" merges. Not cherrypicking or"
2265
repository = tree.branch.repository
2266
base_revision = common_ancestor(tree.branch.last_revision(),
2267
pending_merges[0], repository)
2268
base_tree = repository.revision_tree(base_revision)
2269
other_tree = repository.revision_tree(pending_merges[0])
2270
interesting_ids = None
2272
conflicts = tree.conflicts()
2273
if file_list is not None:
2274
interesting_ids = set()
2275
for filename in file_list:
2276
file_id = tree.path2id(filename)
2278
raise NotVersionedError(filename)
2279
interesting_ids.add(file_id)
2280
if tree.kind(file_id) != "directory":
2283
for name, ie in tree.inventory.iter_entries(file_id):
2284
interesting_ids.add(ie.file_id)
2285
new_conflicts = conflicts.select_conflicts(tree, file_list)[0]
2286
transform_tree(tree, tree.basis_tree(), interesting_ids)
2287
tree.set_conflicts(ConflictList(new_conflicts))
2288
if file_list is None:
2289
restore_files = list(tree.iter_conflicts())
2291
restore_files = file_list
2292
for filename in restore_files:
2294
restore(tree.abspath(filename))
2295
except NotConflicted:
2297
conflicts = merge_inner(tree.branch, other_tree, base_tree,
2299
interesting_ids=interesting_ids,
2300
other_rev_id=pending_merges[0],
2301
merge_type=merge_type,
2302
show_base=show_base,
2303
reprocess=reprocess)
2311
1220
class cmd_revert(Command):
2312
1221
"""Reverse all changes since the last commit.
2389
1292
takes_args = ['from_branch', 'to_branch']
2390
1293
def run(self, from_branch, to_branch):
2391
1294
from bzrlib.fetch import Fetcher
2392
from_b = Branch.open(from_branch)
2393
to_b = Branch.open(to_branch)
1295
from bzrlib.branch import Branch
1296
from_b = Branch(from_branch)
1297
to_b = Branch(to_branch)
2394
1298
Fetcher(to_b, from_b)
2397
1302
class cmd_missing(Command):
2398
"""Show unmerged/unpulled revisions between two branches.
2400
OTHER_BRANCH may be local or remote."""
2401
takes_args = ['other_branch?']
2402
takes_options = [Option('reverse', 'Reverse the order of revisions'),
2404
'Display changes in the local branch only'),
2405
Option('theirs-only',
2406
'Display changes in the remote branch only'),
2414
encoding_type = 'replace'
2417
def run(self, other_branch=None, reverse=False, mine_only=False,
2418
theirs_only=False, log_format=None, long=False, short=False, line=False,
2419
show_ids=False, verbose=False):
2420
from bzrlib.missing import find_unmerged, iter_log_data
2421
from bzrlib.log import log_formatter
2422
local_branch = Branch.open_containing(u".")[0]
2423
parent = local_branch.get_parent()
2424
if other_branch is None:
2425
other_branch = parent
2426
if other_branch is None:
2427
raise BzrCommandError("No peer location known or specified.")
2428
print "Using last location: " + local_branch.get_parent()
2429
remote_branch = Branch.open(other_branch)
2430
if remote_branch.base == local_branch.base:
2431
remote_branch = local_branch
2432
local_branch.lock_read()
2434
remote_branch.lock_read()
2436
local_extra, remote_extra = find_unmerged(local_branch, remote_branch)
2437
if (log_format == None):
2438
default = local_branch.get_config().log_format()
2439
log_format = get_log_format(long=long, short=short,
2440
line=line, default=default)
2441
lf = log_formatter(log_format,
2444
show_timezone='original')
2445
if reverse is False:
2446
local_extra.reverse()
2447
remote_extra.reverse()
2448
if local_extra and not theirs_only:
2449
print "You have %d extra revision(s):" % len(local_extra)
2450
for data in iter_log_data(local_extra, local_branch.repository,
2453
printed_local = True
2455
printed_local = False
2456
if remote_extra and not mine_only:
2457
if printed_local is True:
2459
print "You are missing %d revision(s):" % len(remote_extra)
2460
for data in iter_log_data(remote_extra, remote_branch.repository,
2463
if not remote_extra and not local_extra:
2465
print "Branches are up to date."
2469
remote_branch.unlock()
2471
local_branch.unlock()
2472
if not status_code and parent is None and other_branch is not None:
2473
local_branch.lock_write()
2475
# handle race conditions - a parent might be set while we run.
2476
if local_branch.get_parent() is None:
2477
local_branch.set_parent(remote_branch.base)
2479
local_branch.unlock()
1303
"""What is missing in this branch relative to other branch.
1305
# TODO: rewrite this in terms of ancestry so that it shows only
1308
takes_args = ['remote?']
1309
aliases = ['mis', 'miss']
1310
# We don't have to add quiet to the list, because
1311
# unknown options are parsed as booleans
1312
takes_options = ['verbose', 'quiet']
1314
def run(self, remote=None, verbose=False, quiet=False):
1315
from bzrlib.errors import BzrCommandError
1316
from bzrlib.missing import show_missing
1318
if verbose and quiet:
1319
raise BzrCommandError('Cannot pass both quiet and verbose')
1321
b = find_branch('.')
1322
parent = b.get_parent()
1325
raise BzrCommandError("No missing location known or specified.")
1328
print "Using last location: %s" % parent
1330
elif parent is None:
1331
# We only update x-pull if it did not exist, missing should not change the parent
1332
b.controlfile('x-pull', 'wb').write(remote + '\n')
1333
br_remote = find_branch(remote)
1335
return show_missing(b, br_remote, verbose=verbose, quiet=quiet)
2483
1339
class cmd_plugins(Command):
2484
1340
"""List plugins"""
2488
1343
import bzrlib.plugin
2489
1344
from inspect import getdoc
2490
for name, plugin in bzrlib.plugin.all_plugins().items():
1345
for plugin in bzrlib.plugin.all_plugins:
2491
1346
if hasattr(plugin, '__path__'):
2492
1347
print plugin.__path__[0]
2493
1348
elif hasattr(plugin, '__file__'):
2500
1355
print '\t', d.split('\n')[0]
2503
class cmd_testament(Command):
2504
"""Show testament (signing-form) of a revision."""
2505
takes_options = ['revision', 'long',
2506
Option('strict', help='Produce a strict-format'
2508
takes_args = ['branch?']
2510
def run(self, branch=u'.', revision=None, long=False, strict=False):
2511
from bzrlib.testament import Testament, StrictTestament
2513
testament_class = StrictTestament
2515
testament_class = Testament
2516
b = WorkingTree.open_containing(branch)[0].branch
2519
if revision is None:
2520
rev_id = b.last_revision()
2522
rev_id = revision[0].in_history(b).rev_id
2523
t = testament_class.from_revision(b.repository, rev_id)
2525
sys.stdout.writelines(t.as_text_lines())
2527
sys.stdout.write(t.as_short_text())
2532
class cmd_annotate(Command):
2533
"""Show the origin of each line in a file.
2535
This prints out the given file with an annotation on the left side
2536
indicating which revision, author and date introduced the change.
2538
If the origin is the same for a run of consecutive lines, it is
2539
shown only at the top, unless the --all option is given.
2541
# TODO: annotate directories; showing when each file was last changed
2542
# TODO: if the working copy is modified, show annotations on that
2543
# with new uncommitted lines marked
2544
aliases = ['ann', 'blame', 'praise']
2545
takes_args = ['filename']
2546
takes_options = [Option('all', help='show annotations on all lines'),
2547
Option('long', help='show date in annotations'),
2552
def run(self, filename, all=False, long=False, revision=None):
2553
from bzrlib.annotate import annotate_file
2554
tree, relpath = WorkingTree.open_containing(filename)
2555
branch = tree.branch
2558
if revision is None:
2559
revision_id = branch.last_revision()
2560
elif len(revision) != 1:
2561
raise BzrCommandError('bzr annotate --revision takes exactly 1 argument')
2563
revision_id = revision[0].in_history(branch).rev_id
2564
file_id = tree.inventory.path2id(relpath)
2565
tree = branch.repository.revision_tree(revision_id)
2566
file_version = tree.inventory[file_id].revision
2567
annotate_file(branch, file_version, file_id, long, all, sys.stdout)
2572
class cmd_re_sign(Command):
2573
"""Create a digital signature for an existing revision."""
2574
# TODO be able to replace existing ones.
2576
hidden = True # is this right ?
2577
takes_args = ['revision_id*']
2578
takes_options = ['revision']
2580
def run(self, revision_id_list=None, revision=None):
2581
import bzrlib.gpg as gpg
2582
if revision_id_list is not None and revision is not None:
2583
raise BzrCommandError('You can only supply one of revision_id or --revision')
2584
if revision_id_list is None and revision is None:
2585
raise BzrCommandError('You must supply either --revision or a revision_id')
2586
b = WorkingTree.open_containing(u'.')[0].branch
2587
gpg_strategy = gpg.GPGStrategy(b.get_config())
2588
if revision_id_list is not None:
2589
for revision_id in revision_id_list:
2590
b.repository.sign_revision(revision_id, gpg_strategy)
2591
elif revision is not None:
2592
if len(revision) == 1:
2593
revno, rev_id = revision[0].in_history(b)
2594
b.repository.sign_revision(rev_id, gpg_strategy)
2595
elif len(revision) == 2:
2596
# are they both on rh- if so we can walk between them
2597
# might be nice to have a range helper for arbitrary
2598
# revision paths. hmm.
2599
from_revno, from_revid = revision[0].in_history(b)
2600
to_revno, to_revid = revision[1].in_history(b)
2601
if to_revid is None:
2602
to_revno = b.revno()
2603
if from_revno is None or to_revno is None:
2604
raise BzrCommandError('Cannot sign a range of non-revision-history revisions')
2605
for revno in range(from_revno, to_revno + 1):
2606
b.repository.sign_revision(b.get_rev_id(revno),
2609
raise BzrCommandError('Please supply either one revision, or a range.')
2612
class cmd_bind(Command):
2613
"""Bind the current branch to a master branch.
2615
After binding, commits must succeed on the master branch
2616
before they are executed on the local one.
2619
takes_args = ['location']
2622
def run(self, location=None):
2623
b, relpath = Branch.open_containing(u'.')
2624
b_other = Branch.open(location)
2627
except DivergedBranches:
2628
raise BzrCommandError('These branches have diverged.'
2629
' Try merging, and then bind again.')
2632
class cmd_unbind(Command):
2633
"""Unbind the current branch from its master branch.
2635
After unbinding, the local branch is considered independent.
2636
All subsequent commits will be local.
2643
b, relpath = Branch.open_containing(u'.')
2645
raise BzrCommandError('Local branch is not bound')
2648
class cmd_uncommit(Command):
2649
"""Remove the last committed revision.
2651
--verbose will print out what is being removed.
2652
--dry-run will go through all the motions, but not actually
2655
In the future, uncommit will create a revision bundle, which can then
2659
# TODO: jam 20060108 Add an option to allow uncommit to remove
2660
# unreferenced information in 'branch-as-repository' branches.
2661
# TODO: jam 20060108 Add the ability for uncommit to remove unreferenced
2662
# information in shared branches as well.
2663
takes_options = ['verbose', 'revision',
2664
Option('dry-run', help='Don\'t actually make changes'),
2665
Option('force', help='Say yes to all questions.')]
2666
takes_args = ['location?']
2669
def run(self, location=None,
2670
dry_run=False, verbose=False,
2671
revision=None, force=False):
2672
from bzrlib.log import log_formatter, show_log
2674
from bzrlib.uncommit import uncommit
2676
if location is None:
2678
control, relpath = bzrdir.BzrDir.open_containing(location)
2680
tree = control.open_workingtree()
2682
except (errors.NoWorkingTree, errors.NotLocalUrl):
2684
b = control.open_branch()
2687
if revision is None:
2690
# 'bzr uncommit -r 10' actually means uncommit
2691
# so that the final tree is at revno 10.
2692
# but bzrlib.uncommit.uncommit() actually uncommits
2693
# the revisions that are supplied.
2694
# So we need to offset it by one
2695
revno = revision[0].in_history(b).revno+1
2697
if revno <= b.revno():
2698
rev_id = b.get_rev_id(revno)
2700
self.outf.write('No revisions to uncommit.\n')
2703
lf = log_formatter('short',
2705
show_timezone='original')
2710
direction='forward',
2711
start_revision=revno,
2712
end_revision=b.revno())
2715
print 'Dry-run, pretending to remove the above revisions.'
2717
val = raw_input('Press <enter> to continue')
2719
print 'The above revision(s) will be removed.'
2721
val = raw_input('Are you sure [y/N]? ')
2722
if val.lower() not in ('y', 'yes'):
2726
uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
2730
class cmd_break_lock(Command):
2731
"""Break a dead lock on a repository, branch or working directory.
2733
CAUTION: Locks should only be broken when you are sure that the process
2734
holding the lock has been stopped.
2736
You can get information on what locks are open via the 'bzr info' command.
2741
takes_args = ['location?']
2743
def run(self, location=None, show=False):
2744
if location is None:
2746
control, relpath = bzrdir.BzrDir.open_containing(location)
2748
control.break_lock()
2749
except NotImplementedError:
2754
# command-line interpretation helper for merge-related commands
2755
def merge(other_revision, base_revision,
2756
check_clean=True, ignore_zero=False,
2757
this_dir=None, backup_files=False, merge_type=Merge3Merger,
2758
file_list=None, show_base=False, reprocess=False,
2759
pb=DummyProgress()):
2760
"""Merge changes into a tree.
2763
list(path, revno) Base for three-way merge.
2764
If [None, None] then a base will be automatically determined.
2766
list(path, revno) Other revision for three-way merge.
2768
Directory to merge changes into; '.' by default.
2770
If true, this_dir must have no uncommitted changes before the
2772
ignore_zero - If true, suppress the "zero conflicts" message when
2773
there are no conflicts; should be set when doing something we expect
2774
to complete perfectly.
2775
file_list - If supplied, merge only changes to selected files.
2777
All available ancestors of other_revision and base_revision are
2778
automatically pulled into the branch.
2780
The revno may be -1 to indicate the last revision on the branch, which is
2783
This function is intended for use from the command line; programmatic
2784
clients might prefer to call merge.merge_inner(), which has less magic
2787
from bzrlib.merge import Merger
2788
if this_dir is None:
2790
this_tree = WorkingTree.open_containing(this_dir)[0]
2791
if show_base and not merge_type is Merge3Merger:
2792
raise BzrCommandError("Show-base is not supported for this merge"
2793
" type. %s" % merge_type)
2794
if reprocess and not merge_type.supports_reprocess:
2795
raise BzrCommandError("Conflict reduction is not supported for merge"
2796
" type %s." % merge_type)
2797
if reprocess and show_base:
2798
raise BzrCommandError("Cannot do conflict reduction and show base.")
2800
merger = Merger(this_tree.branch, this_tree=this_tree, pb=pb)
2801
merger.pp = ProgressPhase("Merge phase", 5, pb)
2802
merger.pp.next_phase()
2803
merger.check_basis(check_clean)
2804
merger.set_other(other_revision)
2805
merger.pp.next_phase()
2806
merger.set_base(base_revision)
2807
if merger.base_rev_id == merger.other_rev_id:
2808
note('Nothing to do.')
2810
merger.backup_files = backup_files
2811
merger.merge_type = merge_type
2812
merger.set_interesting_files(file_list)
2813
merger.show_base = show_base
2814
merger.reprocess = reprocess
2815
conflicts = merger.do_merge()
2816
if file_list is None:
2817
merger.set_pending()
2823
# these get imported and then picked up by the scan for cmd_*
2824
# TODO: Some more consistent way to split command definitions across files;
2825
# we do need to load at least some information about them to know of
2826
# aliases. ideally we would avoid loading the implementation until the
2827
# details were needed.
2828
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore
2829
from bzrlib.bundle.commands import cmd_bundle_revisions
2830
from bzrlib.sign_my_commits import cmd_sign_my_commits
2831
from bzrlib.weave_commands import cmd_weave_list, cmd_weave_join, \
2832
cmd_weave_plan_merge, cmd_weave_merge_text