1
# Copyright (C) 2004, 2005 by Canonical Ltd
1
# Copyright (C) 2004, 2005, 2006 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
# DO NOT change this to cStringIO - it results in control files
19
# FIXIT! (Only deal with byte streams OR unicode at any one layer.)
21
from StringIO import StringIO
17
"""builtin bzr commands"""
26
from bzrlib import BZRDIR
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
27
45
from bzrlib.commands import Command, display_command
28
from bzrlib.branch import Branch
29
from bzrlib.revision import common_ancestor
30
import bzrlib.errors as errors
31
46
from bzrlib.errors import (BzrError, BzrCheckError, BzrCommandError,
32
47
NotBranchError, DivergedBranches, NotConflicted,
33
NoSuchFile, NoWorkingTree, FileInWrongBranch)
48
NoSuchFile, NoWorkingTree, FileInWrongBranch,
49
NotVersionedError, NotABundle)
50
from bzrlib.merge import Merge3Merger
34
51
from bzrlib.option import Option
52
from bzrlib.progress import DummyProgress, ProgressPhase
53
from bzrlib.revision import common_ancestor
35
54
from bzrlib.revisionspec import RevisionSpec
37
from bzrlib.trace import mutter, note, log_error, warning, is_quiet
55
from bzrlib.trace import mutter, note, log_error, warning, is_quiet, info
56
from bzrlib.transport.local import LocalTransport
38
58
from bzrlib.workingtree import WorkingTree
212
275
Adding a file whose parent directory is not versioned will
213
276
implicitly add the parent, and so on up to the root. This means
214
you should never need to explictly add a directory, they'll just
277
you should never need to explicitly add a directory, they'll just
215
278
get added when you add a file in the directory.
280
--dry-run will show which files would be added, but not actually
283
--file-ids-from will try to use the file ids from the supplied path.
284
It looks up ids trying to find a matching parent directory with the
285
same filename, and then by pure path.
217
287
takes_args = ['file*']
218
takes_options = ['no-recurse']
220
def run(self, file_list, no_recurse=False):
221
from bzrlib.add import smart_add, add_reporter_print, add_reporter_null
223
reporter = add_reporter_null
288
takes_options = ['no-recurse', 'dry-run', 'verbose',
289
Option('file-ids-from', type=unicode,
290
help='Lookup file ids from here')]
291
encoding_type = 'replace'
293
def run(self, file_list, no_recurse=False, dry_run=False, verbose=False,
297
if file_ids_from is not None:
299
base_tree, base_path = WorkingTree.open_containing(
301
except errors.NoWorkingTree:
302
base_branch, base_path = branch.Branch.open_containing(
304
base_tree = base_branch.basis_tree()
306
action = bzrlib.add.AddFromBaseAction(base_tree, base_path,
307
to_file=self.outf, should_print=(not is_quiet()))
225
reporter = add_reporter_print
226
smart_add(file_list, not no_recurse, reporter)
309
action = bzrlib.add.AddAction(to_file=self.outf,
310
should_print=(not is_quiet()))
312
added, ignored = bzrlib.add.smart_add(file_list, not no_recurse,
313
action=action, save=not dry_run)
316
for glob in sorted(ignored.keys()):
317
for path in ignored[glob]:
318
self.outf.write("ignored %s matching \"%s\"\n"
322
for glob, paths in ignored.items():
323
match_len += len(paths)
324
self.outf.write("ignored %d file(s).\n" % match_len)
325
self.outf.write("If you wish to add some of these files,"
326
" please add them by name.\n")
229
329
class cmd_mkdir(Command):
232
332
This is equivalent to creating the directory and then adding it.
234
335
takes_args = ['dir+']
336
encoding_type = 'replace'
236
338
def run(self, dir_list):
237
339
for d in dir_list:
239
341
wt, dd = WorkingTree.open_containing(d)
343
self.outf.write('added %s\n' % d)
244
346
class cmd_relpath(Command):
245
347
"""Show path of a file relative to root"""
246
349
takes_args = ['filename']
250
353
def run(self, filename):
354
# TODO: jam 20050106 Can relpath return a munged path if
355
# sys.stdout encoding cannot represent it?
251
356
tree, relpath = WorkingTree.open_containing(filename)
357
self.outf.write(relpath)
358
self.outf.write('\n')
255
361
class cmd_inventory(Command):
256
362
"""Show inventory of the current working copy or a revision.
258
364
It is possible to limit the output to a particular entry
259
type using the --kind option. For example; --kind file.
365
type using the --kind option. For example: --kind file.
367
It is also possible to restrict the list of files to a specific
368
set. For example: bzr inventory --show-ids this/file
261
371
takes_options = ['revision', 'show-ids', 'kind']
372
takes_args = ['file*']
264
def run(self, revision=None, show_ids=False, kind=None):
375
def run(self, revision=None, show_ids=False, kind=None, file_list=None):
265
376
if kind and kind not in ['file', 'directory', 'symlink']:
266
377
raise BzrCommandError('invalid kind specified')
267
tree = WorkingTree.open_containing(u'.')[0]
269
inv = tree.read_working_inventory()
379
work_tree, file_list = tree_files(file_list)
381
if revision is not None:
271
382
if len(revision) > 1:
272
383
raise BzrCommandError('bzr inventory --revision takes'
273
' exactly one revision identifier')
274
inv = tree.branch.get_revision_inventory(
275
revision[0].in_history(tree.branch).rev_id)
277
for path, entry in inv.entries():
384
' exactly one revision identifier')
385
revision_id = revision[0].in_history(work_tree.branch).rev_id
386
tree = work_tree.branch.repository.revision_tree(revision_id)
388
# We include work_tree as well as 'tree' here
389
# So that doing '-r 10 path/foo' will lookup whatever file
390
# exists now at 'path/foo' even if it has been renamed, as
391
# well as whatever files existed in revision 10 at path/foo
392
trees = [tree, work_tree]
397
if file_list is not None:
398
file_ids = bzrlib.tree.find_ids_across_trees(file_list, trees,
399
require_versioned=True)
400
# find_ids_across_trees may include some paths that don't
402
entries = sorted((tree.id2path(file_id), tree.inventory[file_id])
403
for file_id in file_ids if file_id in tree)
405
entries = tree.inventory.entries()
407
for path, entry in entries:
278
408
if kind and kind != entry.kind:
281
print '%-50s %s' % (path, entry.file_id)
411
self.outf.write('%-50s %s\n' % (path, entry.file_id))
286
class cmd_move(Command):
287
"""Move files to a different directory.
292
The destination must be a versioned directory in the same branch.
294
takes_args = ['source$', 'dest']
295
def run(self, source_list, dest):
296
tree, source_list = tree_files(source_list)
297
# TODO: glob expansion on windows?
298
tree.move(source_list, tree.relpath(dest))
301
class cmd_rename(Command):
302
"""Change the name of an entry.
305
bzr rename frob.c frobber.c
306
bzr rename src/frob.c lib/frob.c
308
It is an error if the destination name exists.
310
See also the 'move' command, which moves files into a different
311
directory without changing their name.
313
# TODO: Some way to rename multiple files without invoking
314
# bzr for each one?"""
315
takes_args = ['from_name', 'to_name']
317
def run(self, from_name, to_name):
318
tree, (from_name, to_name) = tree_files((from_name, to_name))
319
tree.rename_one(from_name, to_name)
413
self.outf.write(path)
414
self.outf.write('\n')
322
417
class cmd_mv(Command):
341
443
if os.path.isdir(names_list[-1]):
342
444
# move into existing directory
343
445
for pair in tree.move(rel_names[:-1], rel_names[-1]):
344
print "%s => %s" % pair
446
self.outf.write("%s => %s\n" % pair)
346
448
if len(names_list) != 2:
347
449
raise BzrCommandError('to mv multiple files the destination '
348
450
'must be a versioned directory')
349
451
tree.rename_one(rel_names[0], rel_names[1])
350
print "%s => %s" % (rel_names[0], rel_names[1])
452
self.outf.write("%s => %s\n" % (rel_names[0], rel_names[1]))
353
455
class cmd_pull(Command):
354
"""Pull any changes from another branch into the current one.
356
If there is no default location set, the first pull will set it. After
357
that, you can omit the location to use the default. To change the
358
default, use --remember.
456
"""Turn this branch into a mirror of another branch.
360
458
This command only works on branches that have not diverged. Branches are
361
considered diverged if both branches have had commits without first
362
pulling from the other.
459
considered diverged if the destination branch's most recent commit is one
460
that has not been merged (directly or indirectly) into the parent.
364
If branches have diverged, you can use 'bzr merge' to pull the text changes
462
If branches have diverged, you can use 'bzr merge' to integrate the changes
365
463
from one into the other. Once one branch has merged, the other should
366
464
be able to pull it again.
368
466
If you want to forget your local changes and just update your branch to
369
match the remote one, use --overwrite.
467
match the remote one, use pull --overwrite.
469
If there is no default location set, the first pull will set it. After
470
that, you can omit the location to use the default. To change the
471
default, use --remember. The value will only be saved if the remote
472
location can be accessed.
371
takes_options = ['remember', 'overwrite', 'verbose']
475
takes_options = ['remember', 'overwrite', 'revision', 'verbose']
372
476
takes_args = ['location?']
374
def run(self, location=None, remember=False, overwrite=False, verbose=False):
375
from bzrlib.merge import merge
376
from shutil import rmtree
378
# FIXME: too much stuff is in the command class
379
tree_to = WorkingTree.open_containing(u'.')[0]
380
stored_loc = tree_to.branch.get_parent()
477
encoding_type = 'replace'
479
def run(self, location=None, remember=False, overwrite=False, revision=None, verbose=False):
480
# FIXME: too much stuff is in the command class
482
tree_to = WorkingTree.open_containing(u'.')[0]
483
branch_to = tree_to.branch
484
except NoWorkingTree:
486
branch_to = Branch.open_containing(u'.')[0]
489
if location is not None:
491
reader = bundle.read_bundle_from_url(location)
493
pass # Continue on considering this url a Branch
495
stored_loc = branch_to.get_parent()
381
496
if location is None:
382
497
if stored_loc is None:
383
498
raise BzrCommandError("No pull location known or specified.")
385
print "Using saved location: %s" % stored_loc
500
display_url = urlutils.unescape_for_display(stored_loc,
502
self.outf.write("Using saved location: %s\n" % display_url)
386
503
location = stored_loc
388
br_from = Branch.open(location)
389
br_to = tree_to.branch
391
old_rh = br_to.revision_history()
392
count = tree_to.pull(br_from, overwrite)
394
if br_to.get_parent() is None or remember:
395
br_to.set_parent(location)
506
if reader is not None:
507
install_bundle(branch_to.repository, reader)
508
branch_from = branch_to
510
branch_from = Branch.open(location)
512
if branch_to.get_parent() is None or remember:
513
branch_to.set_parent(branch_from.base)
517
if reader is not None:
518
rev_id = reader.target
519
elif len(revision) == 1:
520
rev_id = revision[0].in_history(branch_from).rev_id
522
raise BzrCommandError('bzr pull --revision takes one value.')
524
old_rh = branch_to.revision_history()
525
if tree_to is not None:
526
count = tree_to.pull(branch_from, overwrite, rev_id)
528
count = branch_to.pull(branch_from, overwrite, rev_id)
396
529
note('%d revision(s) pulled.' % (count,))
399
new_rh = tree_to.branch.revision_history()
532
new_rh = branch_to.revision_history()
400
533
if old_rh != new_rh:
401
534
# Something changed
402
535
from bzrlib.log import show_changed_revisions
403
show_changed_revisions(tree_to.branch, old_rh, new_rh)
536
show_changed_revisions(branch_to, old_rh, new_rh,
406
540
class cmd_push(Command):
407
"""Push this branch into another branch.
409
The remote branch will not have its working tree populated because this
410
is both expensive, and may not be supported on the remote file system.
412
Some smart servers or protocols *may* put the working tree in place.
541
"""Update a mirror of this branch.
543
The target branch will not have its working tree populated because this
544
is both expensive, and is not supported on remote file systems.
546
Some smart servers or protocols *may* put the working tree in place in
549
This command only works on branches that have not diverged. Branches are
550
considered diverged if the destination branch's most recent commit is one
551
that has not been merged (directly or indirectly) by the source branch.
553
If branches have diverged, you can use 'bzr push --overwrite' to replace
554
the other branch completely, discarding its unmerged changes.
556
If you want to ensure you have the different changes in the other branch,
557
do a merge (see bzr help merge) from the other branch, and commit that.
558
After that you will be able to do a push without '--overwrite'.
414
560
If there is no default push location set, the first push will set it.
415
561
After that, you can omit the location to use the default. To change the
416
default, use --remember.
418
This command only works on branches that have not diverged. Branches are
419
considered diverged if the branch being pushed to is not an older version
422
If branches have diverged, you can use 'bzr push --overwrite' to replace
423
the other branch completely.
425
If you want to ensure you have the different changes in the other branch,
426
do a merge (see bzr help merge) from the other branch, and commit that
427
before doing a 'push --overwrite'.
562
default, use --remember. The value will only be saved if the remote
563
location can be accessed.
429
takes_options = ['remember', 'overwrite',
566
takes_options = ['remember', 'overwrite', 'verbose',
430
567
Option('create-prefix',
431
568
help='Create the path leading up to the branch '
432
569
'if it does not already exist')]
433
570
takes_args = ['location?']
571
encoding_type = 'replace'
435
573
def run(self, location=None, remember=False, overwrite=False,
436
574
create_prefix=False, verbose=False):
437
575
# FIXME: Way too big! Put this into a function called from the
440
from shutil import rmtree
441
from bzrlib.transport import get_transport
443
tree_from = WorkingTree.open_containing(u'.')[0]
444
br_from = tree_from.branch
445
stored_loc = tree_from.branch.get_push_location()
578
br_from = Branch.open_containing('.')[0]
579
stored_loc = br_from.get_push_location()
446
580
if location is None:
447
581
if stored_loc is None:
448
582
raise BzrCommandError("No push location known or specified.")
450
print "Using saved location: %s" % stored_loc
584
display_url = urlutils.unescape_for_display(stored_loc,
586
self.outf.write("Using saved location: %s\n" % display_url)
451
587
location = stored_loc
589
to_transport = transport.get_transport(location)
590
location_url = to_transport.base
453
br_to = Branch.open(location)
594
dir_to = bzrdir.BzrDir.open(location_url)
595
br_to = dir_to.open_branch()
454
596
except NotBranchError:
455
597
# create a branch.
456
transport = get_transport(location).clone('..')
598
to_transport = to_transport.clone('..')
457
599
if not create_prefix:
459
transport.mkdir(transport.relpath(location))
601
relurl = to_transport.relpath(location_url)
602
mutter('creating directory %s => %s', location_url, relurl)
603
to_transport.mkdir(relurl)
460
604
except NoSuchFile:
461
605
raise BzrCommandError("Parent directory of %s "
462
606
"does not exist." % location)
464
current = transport.base
465
needed = [(transport, transport.relpath(location))]
608
current = to_transport.base
609
needed = [(to_transport, to_transport.relpath(location_url))]
468
transport, relpath = needed[-1]
469
transport.mkdir(relpath)
612
to_transport, relpath = needed[-1]
613
to_transport.mkdir(relpath)
471
615
except NoSuchFile:
472
new_transport = transport.clone('..')
616
new_transport = to_transport.clone('..')
473
617
needed.append((new_transport,
474
new_transport.relpath(transport.base)))
475
if new_transport.base == transport.base:
476
raise BzrCommandError("Could not creeate "
618
new_transport.relpath(to_transport.base)))
619
if new_transport.base == to_transport.base:
620
raise BzrCommandError("Could not create "
478
br_to = Branch.initialize(location)
479
old_rh = br_to.revision_history()
622
dir_to = br_from.bzrdir.clone(location_url,
623
revision_id=br_from.last_revision())
624
br_to = dir_to.open_branch()
625
count = len(br_to.revision_history())
626
# We successfully created the target, remember it
627
if br_from.get_push_location() is None or remember:
628
br_from.set_push_location(br_to.base)
630
# We were able to connect to the remote location, so remember it
631
# we don't need to successfully push because of possible divergence.
632
if br_from.get_push_location() is None or remember:
633
br_from.set_push_location(br_to.base)
634
old_rh = br_to.revision_history()
482
tree_to = br_to.working_tree()
483
except NoWorkingTree:
484
# TODO: This should be updated for branches which don't have a
485
# working tree, as opposed to ones where we just couldn't
487
warning('Unable to update the working tree of: %s' % (br_to.base,))
488
count = br_to.pull(br_from, overwrite)
490
count = tree_to.pull(br_from, overwrite)
491
except DivergedBranches:
492
raise BzrCommandError("These branches have diverged."
493
" Try a merge then push with overwrite.")
494
if br_from.get_push_location() is None or remember:
495
br_from.set_push_location(location)
637
tree_to = dir_to.open_workingtree()
638
except errors.NotLocalUrl:
639
warning('This transport does not update the working '
640
'tree of: %s' % (br_to.base,))
641
count = br_to.pull(br_from, overwrite)
642
except NoWorkingTree:
643
count = br_to.pull(br_from, overwrite)
645
count = tree_to.pull(br_from, overwrite)
646
except DivergedBranches:
647
raise BzrCommandError("These branches have diverged."
648
" Try a merge then push with overwrite.")
496
649
note('%d revision(s) pushed.' % (count,))
540
691
br_from.lock_read()
542
693
if basis is not None:
543
basis_branch = WorkingTree.open_containing(basis)[0].branch
694
basis_dir = bzrdir.BzrDir.open_containing(basis)[0]
546
697
if len(revision) == 1 and revision[0] is not None:
547
698
revision_id = revision[0].in_history(br_from)[1]
700
# FIXME - wt.last_revision, fallback to branch, fall back to
701
# None or perhaps NULL_REVISION to mean copy nothing
703
revision_id = br_from.last_revision()
550
704
if to_location is None:
551
705
to_location = os.path.basename(from_location.rstrip("/\\"))
554
708
name = os.path.basename(to_location) + '\n'
556
os.mkdir(to_location)
558
if e.errno == errno.EEXIST:
559
raise BzrCommandError('Target directory "%s" already'
560
' exists.' % to_location)
561
if e.errno == errno.ENOENT:
562
raise BzrCommandError('Parent of "%s" does not exist.' %
567
copy_branch(br_from, to_location, revision_id, basis_branch)
568
except bzrlib.errors.NoSuchRevision:
710
to_transport = transport.get_transport(to_location)
712
to_transport.mkdir('.')
713
except errors.FileExists:
714
raise BzrCommandError('Target directory "%s" already'
715
' exists.' % to_location)
716
except errors.NoSuchFile:
717
raise BzrCommandError('Parent of "%s" does not exist.' %
720
# preserve whatever source format we have.
721
dir = br_from.bzrdir.sprout(to_transport.base,
722
revision_id, basis_dir)
723
branch = dir.open_branch()
724
except errors.NoSuchRevision:
725
to_transport.delete_tree('.')
570
726
msg = "The branch %s has no revision %s." % (from_location, revision[0])
571
727
raise BzrCommandError(msg)
572
except bzrlib.errors.UnlistableBranch:
574
msg = "The branch %s cannot be used as a --basis"
728
except errors.UnlistableBranch:
729
osutils.rmtree(to_location)
730
msg = "The branch %s cannot be used as a --basis" % (basis,)
575
731
raise BzrCommandError(msg)
576
branch = Branch.open(to_location)
578
name = StringIO(name)
579
branch.put_controlfile('branch-name', name)
733
branch.control_files.put_utf8('branch-name', name)
580
734
note('Branched %d revision(s).' % branch.revno())
739
class cmd_checkout(Command):
740
"""Create a new checkout of an existing branch.
742
If BRANCH_LOCATION is omitted, checkout will reconstitute a working tree for
743
the branch found in '.'. This is useful if you have removed the working tree
744
or if it was never created - i.e. if you pushed the branch to its current
747
If the TO_LOCATION is omitted, the last component of the BRANCH_LOCATION will
748
be used. In other words, "checkout ../foo/bar" will attempt to create ./bar.
750
To retrieve the branch as of a particular revision, supply the --revision
751
parameter, as in "checkout foo/bar -r 5". Note that this will be immediately
752
out of date [so you cannot commit] but it may be useful (i.e. to examine old
755
--basis is to speed up checking out from remote branches. When specified, it
756
uses the inventory and file contents from the basis branch in preference to the
757
branch being checked out.
759
takes_args = ['branch_location?', 'to_location?']
760
takes_options = ['revision', # , 'basis']
761
Option('lightweight',
762
help="perform a lightweight checkout. Lightweight "
763
"checkouts depend on access to the branch for "
764
"every operation. Normal checkouts can perform "
765
"common operations like diff and status without "
766
"such access, and also support local commits."
771
def run(self, branch_location=None, to_location=None, revision=None, basis=None,
775
elif len(revision) > 1:
776
raise BzrCommandError(
777
'bzr checkout --revision takes exactly 1 revision value')
778
if branch_location is None:
779
branch_location = osutils.getcwd()
780
to_location = branch_location
781
source = Branch.open(branch_location)
782
if len(revision) == 1 and revision[0] is not None:
783
revision_id = revision[0].in_history(source)[1]
786
if to_location is None:
787
to_location = os.path.basename(branch_location.rstrip("/\\"))
788
# if the source and to_location are the same,
789
# and there is no working tree,
790
# then reconstitute a branch
791
if (osutils.abspath(to_location) ==
792
osutils.abspath(branch_location)):
794
source.bzrdir.open_workingtree()
795
except errors.NoWorkingTree:
796
source.bzrdir.create_workingtree()
799
os.mkdir(to_location)
801
if e.errno == errno.EEXIST:
802
raise BzrCommandError('Target directory "%s" already'
803
' exists.' % to_location)
804
if e.errno == errno.ENOENT:
805
raise BzrCommandError('Parent of "%s" does not exist.' %
809
old_format = bzrdir.BzrDirFormat.get_default_format()
810
bzrdir.BzrDirFormat.set_default_format(bzrdir.BzrDirMetaFormat1())
812
source.create_checkout(to_location, revision_id, lightweight)
814
bzrdir.BzrDirFormat.set_default_format(old_format)
585
817
class cmd_renames(Command):
586
818
"""Show list of renamed files.
594
826
def run(self, dir=u'.'):
827
from bzrlib.tree import find_renames
595
828
tree = WorkingTree.open_containing(dir)[0]
596
old_inv = tree.branch.basis_tree().inventory
829
old_inv = tree.basis_tree().inventory
597
830
new_inv = tree.read_working_inventory()
599
renames = list(bzrlib.tree.find_renames(old_inv, new_inv))
831
renames = list(find_renames(old_inv, new_inv))
601
833
for old_name, new_name in renames:
602
print "%s => %s" % (old_name, new_name)
834
self.outf.write("%s => %s\n" % (old_name, new_name))
837
class cmd_update(Command):
838
"""Update a tree to have the latest code committed to its branch.
840
This will perform a merge into the working tree, and may generate
841
conflicts. If you have any local changes, you will still
842
need to commit them after the update for the update to be complete.
844
If you want to discard your local changes, you can just do a
845
'bzr revert' instead of 'bzr commit' after the update.
847
takes_args = ['dir?']
850
def run(self, dir='.'):
851
tree = WorkingTree.open_containing(dir)[0]
854
existing_pending_merges = tree.get_parent_ids()[1:]
855
last_rev = tree.last_revision()
856
if last_rev == tree.branch.last_revision():
857
# may be up to date, check master too.
858
master = tree.branch.get_master_branch()
859
if master is None or last_rev == master.last_revision():
860
revno = tree.branch.revision_id_to_revno(last_rev)
861
note("Tree is up to date at revision %d." % (revno,))
863
conflicts = tree.update()
864
revno = tree.branch.revision_id_to_revno(tree.last_revision())
865
note('Updated to revision %d.' % (revno,))
866
if tree.get_parent_ids()[1:] != existing_pending_merges:
867
note('Your local commits will now show as pending merges with '
868
"'bzr status', and can be committed with 'bzr commit'.")
605
877
class cmd_info(Command):
606
"""Show statistical information about a branch."""
607
takes_args = ['branch?']
878
"""Show information about a working tree, branch or repository.
880
This command will show all known locations and formats associated to the
881
tree, branch or repository. Statistical information is included with
884
Branches and working trees will also report any missing revisions.
886
takes_args = ['location?']
887
takes_options = ['verbose']
610
def run(self, branch=None):
612
b = WorkingTree.open_containing(branch)[0].branch
890
def run(self, location=None, verbose=False):
891
from bzrlib.info import show_bzrdir_info
892
show_bzrdir_info(bzrdir.BzrDir.open_containing(location)[0],
616
896
class cmd_remove(Command):
635
931
same through all revisions where the file exists, even when it is
636
932
moved or renamed.
639
936
takes_args = ['filename']
641
939
def run(self, filename):
642
940
tree, relpath = WorkingTree.open_containing(filename)
643
941
i = tree.inventory.path2id(relpath)
645
943
raise BzrError("%r is not a versioned file" % filename)
945
self.outf.write(i + '\n')
650
948
class cmd_file_path(Command):
651
949
"""Print path of file_ids to a file or directory.
653
951
This prints one line for each directory down to the target,
654
starting at the branch root."""
952
starting at the branch root.
656
956
takes_args = ['filename']
658
959
def run(self, filename):
659
960
tree, relpath = WorkingTree.open_containing(filename)
660
961
inv = tree.inventory
661
962
fid = inv.path2id(relpath)
663
964
raise BzrError("%r is not a versioned file" % filename)
664
965
for fip in inv.get_idpath(fid):
966
self.outf.write(fip + '\n')
969
class cmd_reconcile(Command):
970
"""Reconcile bzr metadata in a branch.
972
This can correct data mismatches that may have been caused by
973
previous ghost operations or bzr upgrades. You should only
974
need to run this command if 'bzr check' or a bzr developer
975
advises you to run it.
977
If a second branch is provided, cross-branch reconciliation is
978
also attempted, which will check that data like the tree root
979
id which was not present in very early bzr versions is represented
980
correctly in both branches.
982
At the same time it is run it may recompress data resulting in
983
a potential saving in disk space or performance gain.
985
The branch *MUST* be on a listable system such as local disk or sftp.
987
takes_args = ['branch?']
989
def run(self, branch="."):
990
from bzrlib.reconcile import reconcile
991
dir = bzrdir.BzrDir.open(branch)
668
995
class cmd_revision_history(Command):
669
"""Display list of revision ids on this branch."""
996
"""Display the list of revision ids on a branch."""
997
takes_args = ['location?']
671
1001
@display_command
673
branch = WorkingTree.open_containing(u'.')[0].branch
674
for patchid in branch.revision_history():
1002
def run(self, location="."):
1003
branch = Branch.open_containing(location)[0]
1004
for revid in branch.revision_history():
1005
self.outf.write(revid)
1006
self.outf.write('\n')
678
1009
class cmd_ancestry(Command):
679
1010
"""List all revisions merged into this branch."""
1011
takes_args = ['location?']
681
1015
@display_command
683
tree = WorkingTree.open_containing(u'.')[0]
685
# FIXME. should be tree.last_revision
686
for revision_id in b.get_ancestry(b.last_revision()):
1016
def run(self, location="."):
1018
wt = WorkingTree.open_containing(location)[0]
1019
except errors.NoWorkingTree:
1020
b = Branch.open(location)
1021
last_revision = b.last_revision()
1024
last_revision = wt.last_revision()
1026
revision_ids = b.repository.get_ancestry(last_revision)
1027
assert revision_ids[0] is None
1029
for revision_id in revision_ids:
1030
self.outf.write(revision_id + '\n')
690
1033
class cmd_init(Command):
701
1052
bzr commit -m 'imported project'
703
1054
takes_args = ['location?']
704
def run(self, location=None):
705
from bzrlib.branch import Branch
1057
help='Specify a format for this branch. Current'
1058
' formats are: default, knit, metaweave and'
1059
' weave. Default is knit; metaweave and'
1060
' weave are deprecated',
1061
type=get_format_type),
1063
def run(self, location=None, format=None):
1065
format = get_format_type('default')
706
1066
if location is None:
1069
to_transport = transport.get_transport(location)
1071
# The path has to exist to initialize a
1072
# branch inside of it.
1073
# Just using os.mkdir, since I don't
1074
# believe that we want to create a bunch of
1075
# locations if the user supplies an extended path
1076
# TODO: create-prefix
1078
to_transport.mkdir('.')
1079
except errors.FileExists:
1083
existing_bzrdir = bzrdir.BzrDir.open(location)
1084
except NotBranchError:
1085
# really a NotBzrDir error...
1086
bzrdir.BzrDir.create_branch_convenience(location, format=format)
709
# The path has to exist to initialize a
710
# branch inside of it.
711
# Just using os.mkdir, since I don't
712
# believe that we want to create a bunch of
713
# locations if the user supplies an extended path
714
if not os.path.exists(location):
716
Branch.initialize(location)
1088
if existing_bzrdir.has_branch():
1089
if (isinstance(to_transport, LocalTransport)
1090
and not existing_bzrdir.has_workingtree()):
1091
raise errors.BranchExistsWithoutWorkingTree(location)
1092
raise errors.AlreadyBranchError(location)
1094
existing_bzrdir.create_branch()
1095
existing_bzrdir.create_workingtree()
1098
class cmd_init_repository(Command):
1099
"""Create a shared repository to hold branches.
1101
New branches created under the repository directory will store their revisions
1102
in the repository, not in the branch directory, if the branch format supports
1108
bzr checkout --lightweight repo/trunk trunk-checkout
1112
takes_args = ["location"]
1113
takes_options = [Option('format',
1114
help='Specify a format for this repository.'
1115
' Current formats are: default, knit,'
1116
' metaweave and weave. Default is knit;'
1117
' metaweave and weave are deprecated',
1118
type=get_format_type),
1120
help='Allows branches in repository to have'
1122
aliases = ["init-repo"]
1123
def run(self, location, format=None, trees=False):
1125
format = get_format_type('default')
1127
if location is None:
1130
to_transport = transport.get_transport(location)
1132
to_transport.mkdir('.')
1133
except errors.FileExists:
1136
newdir = format.initialize_on_transport(to_transport)
1137
repo = newdir.create_repository(shared=True)
1138
repo.set_make_working_trees(trees)
719
1141
class cmd_diff(Command):
720
"""Show differences in working tree.
1142
"""Show differences in the working tree or between revisions.
722
1144
If files are listed, only the changes in those files are listed.
723
1145
Otherwise, all changes for the tree are listed.
1147
"bzr diff -p1" is equivalent to "bzr diff --prefix old/:new/", and
1148
produces patches suitable for "patch -p1".
1152
Shows the difference in the working tree versus the last commit
1154
Difference between the working tree and revision 1
1156
Difference between revision 2 and revision 1
1157
bzr diff --diff-prefix old/:new/
1158
Same as 'bzr diff' but prefix paths with old/ and new/
1159
bzr diff bzr.mine bzr.dev
1160
Show the differences between the two working trees
1162
Show just the differences for 'foo.c'
730
# TODO: Allow diff across branches.
731
1164
# TODO: Option to use external diff command; could be GNU diff, wdiff,
732
1165
# or a graphical diff.
734
1167
# TODO: Python difflib is not exactly the same as unidiff; should
735
1168
# either fix it up or prefer to use an external diff.
737
# TODO: If a directory is given, diff everything under that.
739
1170
# TODO: Selected-file diff is inefficient and doesn't show you
740
1171
# deleted files.
742
1173
# TODO: This probably handles non-Unix newlines poorly.
744
1175
takes_args = ['file*']
745
takes_options = ['revision', 'diff-options']
1176
takes_options = ['revision', 'diff-options', 'prefix']
746
1177
aliases = ['di', 'dif']
1178
encoding_type = 'exact'
748
1180
@display_command
749
def run(self, revision=None, file_list=None, diff_options=None):
750
from bzrlib.diff import show_diff
1181
def run(self, revision=None, file_list=None, diff_options=None,
1183
from bzrlib.diff import diff_cmd_helper, show_diff_trees
1185
if (prefix is None) or (prefix == '0'):
1193
if not ':' in prefix:
1194
raise BzrError("--diff-prefix expects two values separated by a colon")
1195
old_label, new_label = prefix.split(":")
752
tree, file_list = internal_tree_files(file_list)
1198
tree1, file_list = internal_tree_files(file_list)
755
1202
except FileInWrongBranch:
756
1203
if len(file_list) != 2:
757
1204
raise BzrCommandError("Files are in different branches")
759
b, file1 = Branch.open_containing(file_list[0])
760
b2, file2 = Branch.open_containing(file_list[1])
1206
tree1, file1 = WorkingTree.open_containing(file_list[0])
1207
tree2, file2 = WorkingTree.open_containing(file_list[1])
761
1208
if file1 != "" or file2 != "":
762
1209
# FIXME diff those two files. rbc 20051123
763
1210
raise BzrCommandError("Files are in different branches")
764
1211
file_list = None
1212
except NotBranchError:
1213
if (revision is not None and len(revision) == 2
1214
and not revision[0].needs_branch()
1215
and not revision[1].needs_branch()):
1216
# If both revision specs include a branch, we can
1217
# diff them without needing a local working tree
1218
tree1, tree2 = None, None
765
1221
if revision is not None:
1222
if tree2 is not None:
767
1223
raise BzrCommandError("Can't specify -r with two branches")
768
if len(revision) == 1:
769
return show_diff(tree.branch, revision[0], specific_files=file_list,
770
external_diff_options=diff_options)
1224
if (len(revision) == 1) or (revision[1].spec is None):
1225
return diff_cmd_helper(tree1, file_list, diff_options,
1227
old_label=old_label, new_label=new_label)
771
1228
elif len(revision) == 2:
772
return show_diff(tree.branch, revision[0], specific_files=file_list,
773
external_diff_options=diff_options,
774
revision2=revision[1])
1229
return diff_cmd_helper(tree1, file_list, diff_options,
1230
revision[0], revision[1],
1231
old_label=old_label, new_label=new_label)
776
1233
raise BzrCommandError('bzr diff --revision takes exactly one or two revision identifiers')
779
return show_diff(b, None, specific_files=file_list,
780
external_diff_options=diff_options, b2=b2)
1235
if tree2 is not None:
1236
return show_diff_trees(tree1, tree2, sys.stdout,
1237
specific_files=file_list,
1238
external_diff_options=diff_options,
1239
old_label=old_label, new_label=new_label)
782
return show_diff(tree.branch, None, specific_files=file_list,
783
external_diff_options=diff_options)
1241
return diff_cmd_helper(tree1, file_list, diff_options,
1242
old_label=old_label, new_label=new_label)
786
1245
class cmd_deleted(Command):
847
1304
def run(self, filename=None):
848
1305
"""Print the branch root."""
849
1306
tree = WorkingTree.open_containing(filename)[0]
1307
self.outf.write(tree.basedir + '\n')
853
1310
class cmd_log(Command):
854
"""Show log of this branch.
1311
"""Show log of a branch, file, or directory.
1313
By default show the log of the branch containing the working directory.
856
1315
To request a range of logs, you can use the command -r begin..end
857
1316
-r revision requests a specific revision, -r ..end or -r begin.. are
1322
bzr log -r -10.. http://server/branch
861
1325
# TODO: Make --revision support uuid: and hash: [future tag:] notation.
863
takes_args = ['filename?']
1327
takes_args = ['location?']
864
1328
takes_options = [Option('forward',
865
1329
help='show from oldest to newest'),
866
'timezone', 'verbose',
1332
help='show files changed in each revision'),
867
1333
'show-ids', 'revision',
868
Option('line', help='format with one line per revision'),
870
1336
Option('message',
871
1337
help='show revisions whose message matches this regexp',
873
Option('short', help='use moderately short format'),
1341
encoding_type = 'replace'
875
1343
@display_command
876
def run(self, filename=None, timezone='original',
1344
def run(self, location=None, timezone='original',
885
1354
from bzrlib.log import log_formatter, show_log
887
1355
assert message is None or isinstance(message, basestring), \
888
1356
"invalid message argument %r" % message
889
1357
direction = (forward and 'forward') or 'reverse'
895
tree, fp = WorkingTree.open_containing(filename)
898
inv = tree.read_working_inventory()
899
except NotBranchError:
902
b, fp = Branch.open_containing(filename)
904
inv = b.get_inventory(b.last_revision())
1362
# find the file id to log:
1364
dir, fp = bzrdir.BzrDir.open_containing(location)
1365
b = dir.open_branch()
1369
inv = dir.open_workingtree().inventory
1370
except (errors.NotBranchError, errors.NotLocalUrl):
1371
# either no tree, or is remote.
1372
inv = b.basis_tree().inventory
906
1373
file_id = inv.path2id(fp)
1376
# FIXME ? log the current subdir only RBC 20060203
1377
if revision is not None \
1378
and len(revision) > 0 and revision[0].get_branch():
1379
location = revision[0].get_branch()
908
file_id = None # points to branch root
910
tree, relpath = WorkingTree.open_containing(u'.')
1382
dir, relpath = bzrdir.BzrDir.open_containing(location)
1383
b = dir.open_branch()
914
1385
if revision is None:
1329
1850
if c.needs_write:
1334
1854
class cmd_upgrade(Command):
1335
1855
"""Upgrade branch storage to current format.
1337
1857
The check command or bzr developers may sometimes advise you to run
1340
This version of this command upgrades from the full-text storage
1341
used by bzr 0.0.8 and earlier to the weave format (v5).
1858
this command. When the default format has changed you may also be warned
1859
during other operations to upgrade.
1343
takes_args = ['dir?']
1345
def run(self, dir=u'.'):
1861
takes_args = ['url?']
1864
help='Upgrade to a specific format. Current formats'
1865
' are: default, knit, metaweave and weave.'
1866
' Default is knit; metaweave and weave are'
1868
type=get_format_type),
1872
def run(self, url='.', format=None):
1346
1873
from bzrlib.upgrade import upgrade
1875
format = get_format_type('default')
1876
upgrade(url, format)
1350
1879
class cmd_whoami(Command):
1351
"""Show bzr user id."""
1352
takes_options = ['email']
1880
"""Show or set bzr user id.
1884
bzr whoami 'Frank Chu <fchu@example.com>'
1886
takes_options = [ Option('email',
1887
help='display email address only'),
1889
help='set identity for the current branch instead of '
1892
takes_args = ['name?']
1893
encoding_type = 'replace'
1354
1895
@display_command
1355
def run(self, email=False):
1896
def run(self, email=False, branch=False, name=None):
1898
# use branch if we're inside one; otherwise global config
1900
c = Branch.open_containing('.')[0].get_config()
1901
except NotBranchError:
1902
c = config.GlobalConfig()
1904
self.outf.write(c.user_email() + '\n')
1906
self.outf.write(c.username() + '\n')
1909
# display a warning if an email address isn't included in the given name.
1357
b = WorkingTree.open_containing(u'.')[0].branch
1358
config = bzrlib.config.BranchConfig(b)
1359
except NotBranchError:
1360
config = bzrlib.config.GlobalConfig()
1911
config.extract_email_address(name)
1913
warning('"%s" does not seem to contain an email address. '
1914
'This is allowed, but not recommended.', name)
1363
print config.user_email()
1916
# use global config unless --branch given
1918
c = Branch.open_containing('.')[0].get_config()
1365
print config.username()
1920
c = config.GlobalConfig()
1921
c.set_user_option('email', name)
1367
1924
class cmd_nick(Command):
1369
Print or set the branch nickname.
1925
"""Print or set the branch nickname.
1370
1927
If unset, the tree root directory name is used as the nickname
1371
1928
To print the current nickname, execute with no argument.
1393
1951
If arguments are given, they are regular expressions that say
1394
1952
which tests should run.
1954
If the global option '--no-plugins' is given, plugins are not loaded
1955
before running the selftests. This has two effects: features provided or
1956
modified by plugins will not be tested, and tests provided by plugins will
1961
bzr --no-plugins selftest -v
1396
1963
# TODO: --list should give a list of all available tests
1965
# NB: this is used from the class without creating an instance, which is
1966
# why it does not have a self parameter.
1967
def get_transport_type(typestring):
1968
"""Parse and return a transport specifier."""
1969
if typestring == "sftp":
1970
from bzrlib.transport.sftp import SFTPAbsoluteServer
1971
return SFTPAbsoluteServer
1972
if typestring == "memory":
1973
from bzrlib.transport.memory import MemoryServer
1975
if typestring == "fakenfs":
1976
from bzrlib.transport.fakenfs import FakeNFSServer
1977
return FakeNFSServer
1978
msg = "No known transport type %s. Supported types are: sftp\n" %\
1980
raise BzrCommandError(msg)
1398
1983
takes_args = ['testspecs*']
1399
takes_options = ['verbose',
1984
takes_options = ['verbose',
1400
1985
Option('one', help='stop when one test fails'),
1401
1986
Option('keep-output',
1402
help='keep output directories when tests fail')
1987
help='keep output directories when tests fail'),
1989
help='Use a different transport by default '
1990
'throughout the test suite.',
1991
type=get_transport_type),
1992
Option('benchmark', help='run the bzr bencharks.'),
1993
Option('lsprof-timed',
1994
help='generate lsprof output for benchmarked'
1995
' sections of code.'),
1996
Option('cache-dir', type=str,
1997
help='a directory to cache intermediate'
1998
' benchmark steps'),
1405
def run(self, testspecs_list=None, verbose=False, one=False,
2001
def run(self, testspecs_list=None, verbose=None, one=False,
2002
keep_output=False, transport=None, benchmark=None,
2003
lsprof_timed=None, cache_dir=None):
1407
2004
import bzrlib.ui
1408
2005
from bzrlib.tests import selftest
2006
import bzrlib.benchmarks as benchmarks
2007
from bzrlib.benchmarks import tree_creator
2009
if cache_dir is not None:
2010
tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
1409
2011
# we don't want progress meters from the tests to go to the
1410
2012
# real output; and we don't want log messages cluttering up
1411
2013
# the real logs.
1412
save_ui = bzrlib.ui.ui_factory
1413
bzrlib.trace.info('running tests...')
2014
save_ui = ui.ui_factory
2015
print '%10s: %s' % ('bzr', osutils.realpath(sys.argv[0]))
2016
print '%10s: %s' % ('bzrlib', bzrlib.__path__[0])
2018
info('running tests...')
1415
bzrlib.ui.ui_factory = bzrlib.ui.SilentUIFactory()
2020
ui.ui_factory = ui.SilentUIFactory()
1416
2021
if testspecs_list is not None:
1417
2022
pattern = '|'.join(testspecs_list)
1420
result = selftest(verbose=verbose,
1422
stop_on_failure=one,
1423
keep_output=keep_output)
2026
test_suite_factory = benchmarks.test_suite
2029
# TODO: should possibly lock the history file...
2030
benchfile = open(".perf_history", "at")
2032
test_suite_factory = None
2037
result = selftest(verbose=verbose,
2039
stop_on_failure=one,
2040
keep_output=keep_output,
2041
transport=transport,
2042
test_suite_factory=test_suite_factory,
2043
lsprof_timed=lsprof_timed,
2044
bench_history=benchfile)
2046
if benchfile is not None:
1425
bzrlib.trace.info('tests passed')
2049
info('tests passed')
1427
bzrlib.trace.info('tests failed')
2051
info('tests failed')
1428
2052
return int(not result)
1430
bzrlib.ui.ui_factory = save_ui
1434
print "bzr (bazaar-ng) %s" % bzrlib.__version__
1435
# is bzrlib itself in a branch?
1436
bzrrev = bzrlib.get_bzr_revision()
1438
print " (bzr checkout, revision %d {%s})" % bzrrev
1439
print bzrlib.__copyright__
1440
print "http://bazaar-ng.org/"
1442
print "bzr comes with ABSOLUTELY NO WARRANTY. bzr is free software, and"
1443
print "you may use, modify and redistribute it under the terms of the GNU"
1444
print "General Public License version 2 or later."
2054
ui.ui_factory = save_ui
1447
2057
class cmd_version(Command):
1448
2058
"""Show version of bzr."""
1449
2060
@display_command
2062
from bzrlib.version import show_version
1453
2066
class cmd_rocks(Command):
1454
2067
"""Statement of optimism."""
1456
2071
@display_command
1458
2073
print "it sure does!"
1461
2076
class cmd_find_merge_base(Command):
1462
"""Find and print a base revision for merging two branches.
2077
"""Find and print a base revision for merging two branches."""
1464
2078
# TODO: Options to specify revisions on either side, as if
1465
2079
# merging only part of the history.
1466
2080
takes_args = ['branch', 'other']
1479
2093
last1 = branch1.last_revision()
1480
2094
last2 = branch2.last_revision()
1482
source = MultipleRevisionSources(branch1, branch2)
2096
source = MultipleRevisionSources(branch1.repository,
1484
2099
base_rev_id = common_ancestor(last1, last2, source)
1486
2101
print 'merge base is revision %s' % base_rev_id
1490
if base_revno is None:
1491
raise bzrlib.errors.UnrelatedBranches()
1493
print ' r%-6d in %s' % (base_revno, branch)
1495
other_revno = branch2.revision_id_to_revno(base_revid)
1497
print ' r%-6d in %s' % (other_revno, other)
1501
2104
class cmd_merge(Command):
1502
2105
"""Perform a three-way merge.
1504
The branch is the branch you will merge from. By default, it will
1505
merge the latest revision. If you specify a revision, that
1506
revision will be merged. If you specify two revisions, the first
1507
will be used as a BASE, and the second one as OTHER. Revision
1508
numbers are always relative to the specified branch.
2107
The branch is the branch you will merge from. By default, it will merge
2108
the latest revision. If you specify a revision, that revision will be
2109
merged. If you specify two revisions, the first will be used as a BASE,
2110
and the second one as OTHER. Revision numbers are always relative to the
1510
By default bzr will try to merge in all new work from the other
2113
By default, bzr will try to merge in all new work from the other
1511
2114
branch, automatically determining an appropriate base. If this
1512
2115
fails, you may need to give an explicit base.
2117
Merge will do its best to combine the changes in two branches, but there
2118
are some kinds of problems only a human can fix. When it encounters those,
2119
it will mark a conflict. A conflict means that you need to fix something,
2120
before you should commit.
2122
Use bzr resolve when you have fixed a problem. See also bzr conflicts.
2124
If there is no default branch set, the first merge will set it. After
2125
that, you can omit the branch to use the default. To change the
2126
default, use --remember. The value will only be saved if the remote
2127
location can be accessed.
1516
2131
To merge the latest revision from bzr.dev
1525
2140
merge refuses to run if there are any uncommitted changes, unless
1526
2141
--force is given.
2143
The following merge types are available:
1528
2145
takes_args = ['branch?']
1529
takes_options = ['revision', 'force', 'merge-type', 'reprocess',
2146
takes_options = ['revision', 'force', 'merge-type', 'reprocess', 'remember',
1530
2147
Option('show-base', help="Show base revision text in "
2149
Option('uncommitted', help='Apply uncommitted changes'
2150
' from a working copy, instead of branch changes')]
2153
from merge import merge_type_help
2154
from inspect import getdoc
2155
return getdoc(self) + '\n' + merge_type_help()
1533
2157
def run(self, branch=None, revision=None, force=False, merge_type=None,
1534
show_base=False, reprocess=False):
1535
from bzrlib.merge import merge
1536
from bzrlib.merge_core import ApplyMerge3
2158
show_base=False, reprocess=False, remember=False,
1537
2160
if merge_type is None:
1538
merge_type = ApplyMerge3
1540
branch = WorkingTree.open_containing(u'.')[0].branch.get_parent()
1542
raise BzrCommandError("No merge location known or specified.")
2161
merge_type = Merge3Merger
2163
tree = WorkingTree.open_containing(u'.')[0]
2165
if branch is not None:
2167
reader = bundle.read_bundle_from_url(branch)
2169
pass # Continue on considering this url a Branch
1544
print "Using saved location: %s" % branch
2171
conflicts = merge_bundle(reader, tree, not force, merge_type,
2172
reprocess, show_base)
2178
if revision is None \
2179
or len(revision) < 1 or revision[0].needs_branch():
2180
branch = self._get_remembered_parent(tree, branch, 'Merging from')
1545
2182
if revision is None or len(revision) < 1:
1547
other = [branch, -1]
2185
other = [branch, None]
2188
other = [branch, -1]
2189
other_branch, path = Branch.open_containing(branch)
2192
raise BzrCommandError('Cannot use --uncommitted and --revision'
2193
' at the same time.')
2194
branch = revision[0].get_branch() or branch
1549
2195
if len(revision) == 1:
1550
2196
base = [None, None]
1551
other_branch = Branch.open_containing(branch)[0]
2197
other_branch, path = Branch.open_containing(branch)
1552
2198
revno = revision[0].in_history(other_branch).revno
1553
2199
other = [branch, revno]
1555
2201
assert len(revision) == 2
1556
2202
if None in revision:
1557
2203
raise BzrCommandError(
1558
"Merge doesn't permit that revision specifier.")
1559
b = Branch.open_containing(branch)[0]
1561
base = [branch, revision[0].in_history(b).revno]
1562
other = [branch, revision[1].in_history(b).revno]
2204
"Merge doesn't permit empty revision specifier.")
2205
base_branch, path = Branch.open_containing(branch)
2206
branch1 = revision[1].get_branch() or branch
2207
other_branch, path1 = Branch.open_containing(branch1)
2208
if revision[0].get_branch() is not None:
2209
# then path was obtained from it, and is None.
2212
base = [branch, revision[0].in_history(base_branch).revno]
2213
other = [branch1, revision[1].in_history(other_branch).revno]
2215
if tree.branch.get_parent() is None or remember:
2216
tree.branch.set_parent(other_branch.base)
2219
interesting_files = [path]
2221
interesting_files = None
2222
pb = ui.ui_factory.nested_progress_bar()
1565
conflict_count = merge(other, base, check_clean=(not force),
1566
merge_type=merge_type, reprocess=reprocess,
1567
show_base=show_base)
2225
conflict_count = merge(other, base, check_clean=(not force),
2226
merge_type=merge_type,
2227
reprocess=reprocess,
2228
show_base=show_base,
2229
pb=pb, file_list=interesting_files)
1568
2232
if conflict_count != 0:
1572
except bzrlib.errors.AmbiguousBase, e:
2236
except errors.AmbiguousBase, e:
1573
2237
m = ("sorry, bzr can't determine the right merge base yet\n"
1574
2238
"candidates are:\n "
1575
2239
+ "\n ".join(e.bases)
1578
2242
"and (if you want) report this to the bzr developers\n")
2245
# TODO: move up to common parent; this isn't merge-specific anymore.
2246
def _get_remembered_parent(self, tree, supplied_location, verb_string):
2247
"""Use tree.branch's parent if none was supplied.
2249
Report if the remembered location was used.
2251
if supplied_location is not None:
2252
return supplied_location
2253
stored_location = tree.branch.get_parent()
2254
mutter("%s", stored_location)
2255
if stored_location is None:
2256
raise BzrCommandError("No location specified or remembered")
2257
display_url = urlutils.unescape_for_display(stored_location, self.outf.encoding)
2258
self.outf.write("%s remembered location %s\n" % (verb_string, display_url))
2259
return stored_location
1582
2262
class cmd_remerge(Command):
1583
2263
"""Redo a merge.
2265
Use this if you want to try a different merge technique while resolving
2266
conflicts. Some merge techniques are better than others, and remerge
2267
lets you try different ones on different files.
2269
The options for remerge have the same meaning and defaults as the ones for
2270
merge. The difference is that remerge can (only) be run when there is a
2271
pending merge, and it lets you specify particular files.
2274
$ bzr remerge --show-base
2275
Re-do the merge of all conflicted files, and show the base text in
2276
conflict regions, in addition to the usual THIS and OTHER texts.
2278
$ bzr remerge --merge-type weave --reprocess foobar
2279
Re-do the merge of "foobar", using the weave merge algorithm, with
2280
additional processing to reduce the size of conflict regions.
2282
The following merge types are available:"""
1585
2283
takes_args = ['file*']
1586
2284
takes_options = ['merge-type', 'reprocess',
1587
2285
Option('show-base', help="Show base revision text in "
2289
from merge import merge_type_help
2290
from inspect import getdoc
2291
return getdoc(self) + '\n' + merge_type_help()
1590
2293
def run(self, file_list=None, merge_type=None, show_base=False,
1591
2294
reprocess=False):
1592
2295
from bzrlib.merge import merge_inner, transform_tree
1593
from bzrlib.merge_core import ApplyMerge3
1594
2296
if merge_type is None:
1595
merge_type = ApplyMerge3
2297
merge_type = Merge3Merger
1596
2298
tree, file_list = tree_files(file_list)
1597
2299
tree.lock_write()
1599
pending_merges = tree.pending_merges()
1600
if len(pending_merges) != 1:
2301
parents = tree.get_parent_ids()
2302
if len(parents) != 2:
1601
2303
raise BzrCommandError("Sorry, remerge only works after normal"
1602
+ " merges. Not cherrypicking or"
1604
base_revision = common_ancestor(tree.branch.last_revision(),
1605
pending_merges[0], tree.branch)
1606
base_tree = tree.branch.revision_tree(base_revision)
1607
other_tree = tree.branch.revision_tree(pending_merges[0])
2304
" merges. Not cherrypicking or"
2306
repository = tree.branch.repository
2307
base_revision = common_ancestor(parents[0],
2308
parents[1], repository)
2309
base_tree = repository.revision_tree(base_revision)
2310
other_tree = repository.revision_tree(parents[1])
1608
2311
interesting_ids = None
2313
conflicts = tree.conflicts()
1609
2314
if file_list is not None:
1610
2315
interesting_ids = set()
1611
2316
for filename in file_list:
1612
2317
file_id = tree.path2id(filename)
2319
raise NotVersionedError(filename)
1613
2320
interesting_ids.add(file_id)
1614
2321
if tree.kind(file_id) != "directory":
1617
2324
for name, ie in tree.inventory.iter_entries(file_id):
1618
2325
interesting_ids.add(ie.file_id)
1619
transform_tree(tree, tree.branch.basis_tree(), interesting_ids)
2326
new_conflicts = conflicts.select_conflicts(tree, file_list)[0]
2327
transform_tree(tree, tree.basis_tree(), interesting_ids)
2328
tree.set_conflicts(ConflictList(new_conflicts))
1620
2329
if file_list is None:
1621
2330
restore_files = list(tree.iter_conflicts())
1642
2352
class cmd_revert(Command):
1643
"""Reverse all changes since the last commit.
1645
Only versioned files are affected. Specify filenames to revert only
1646
those files. By default, any files that are changed will be backed up
1647
first. Backup files have a '~' appended to their name.
2353
"""Revert files to a previous revision.
2355
Giving a list of files will revert only those files. Otherwise, all files
2356
will be reverted. If the revision is not specified with '--revision', the
2357
last committed revision is used.
2359
To remove only some changes, without reverting to a prior version, use
2360
merge instead. For example, "merge . --r-2..-3" will remove the changes
2361
introduced by -2, without affecting the changes introduced by -1. Or
2362
to remove certain changes on a hunk-by-hunk basis, see the Shelf plugin.
2364
By default, any files that have been manually changed will be backed up
2365
first. (Files changed only by merge are not backed up.) Backup files have
2366
'.~#~' appended to their name, where # is a number.
2368
When you provide files, you can use their current pathname or the pathname
2369
from the target revision. So you can use revert to "undelete" a file by
2370
name. If you name a directory, all the contents of that directory will be
1649
2373
takes_options = ['revision', 'no-backup']
1650
2374
takes_args = ['file*']
1651
2375
aliases = ['merge-revert']
1653
2377
def run(self, revision=None, no_backup=False, file_list=None):
1654
from bzrlib.merge import merge_inner
1655
2378
from bzrlib.commands import parse_spec
1656
2379
if file_list is not None:
1657
2380
if len(file_list) == 0:
1658
2381
raise BzrCommandError("No files specified")
2385
tree, file_list = tree_files(file_list)
1661
2386
if revision is None:
1663
tree = WorkingTree.open_containing(u'.')[0]
1664
2387
# FIXME should be tree.last_revision
1665
rev_id = tree.branch.last_revision()
2388
rev_id = tree.last_revision()
1666
2389
elif len(revision) != 1:
1667
2390
raise BzrCommandError('bzr revert --revision takes exactly 1 argument')
1669
tree, file_list = tree_files(file_list)
1670
2392
rev_id = revision[0].in_history(tree.branch).rev_id
1671
tree.revert(file_list, tree.branch.revision_tree(rev_id),
2393
pb = ui.ui_factory.nested_progress_bar()
2395
tree.revert(file_list,
2396
tree.branch.repository.revision_tree(rev_id),
1675
2402
class cmd_assert_fail(Command):
1717
2444
takes_args = ['from_branch', 'to_branch']
1718
2445
def run(self, from_branch, to_branch):
1719
2446
from bzrlib.fetch import Fetcher
1720
from bzrlib.branch import Branch
1721
2447
from_b = Branch.open(from_branch)
1722
2448
to_b = Branch.open(to_branch)
1727
Fetcher(to_b, from_b)
2449
Fetcher(to_b, from_b)
1734
2452
class cmd_missing(Command):
1735
"""What is missing in this branch relative to other branch.
1737
# TODO: rewrite this in terms of ancestry so that it shows only
1740
takes_args = ['remote?']
1741
aliases = ['mis', 'miss']
1742
takes_options = ['verbose']
2453
"""Show unmerged/unpulled revisions between two branches.
2455
OTHER_BRANCH may be local or remote."""
2456
takes_args = ['other_branch?']
2457
takes_options = [Option('reverse', 'Reverse the order of revisions'),
2459
'Display changes in the local branch only'),
2460
Option('theirs-only',
2461
'Display changes in the remote branch only'),
2469
encoding_type = 'replace'
1744
2471
@display_command
1745
def run(self, remote=None, verbose=False):
1746
from bzrlib.errors import BzrCommandError
1747
from bzrlib.missing import show_missing
1749
if verbose and is_quiet():
1750
raise BzrCommandError('Cannot pass both quiet and verbose')
1752
tree = WorkingTree.open_containing(u'.')[0]
1753
parent = tree.branch.get_parent()
1756
raise BzrCommandError("No missing location known or specified.")
1759
print "Using last location: %s" % parent
1761
elif parent is None:
1762
# We only update parent if it did not exist, missing
1763
# should not change the parent
1764
tree.branch.set_parent(remote)
1765
br_remote = Branch.open_containing(remote)[0]
1766
return show_missing(tree.branch, br_remote, verbose=verbose,
2472
def run(self, other_branch=None, reverse=False, mine_only=False,
2473
theirs_only=False, log_format=None, long=False, short=False, line=False,
2474
show_ids=False, verbose=False):
2475
from bzrlib.missing import find_unmerged, iter_log_data
2476
from bzrlib.log import log_formatter
2477
local_branch = Branch.open_containing(u".")[0]
2478
parent = local_branch.get_parent()
2479
if other_branch is None:
2480
other_branch = parent
2481
if other_branch is None:
2482
raise BzrCommandError("No peer location known or specified.")
2483
print "Using last location: " + local_branch.get_parent()
2484
remote_branch = Branch.open(other_branch)
2485
if remote_branch.base == local_branch.base:
2486
remote_branch = local_branch
2487
local_branch.lock_read()
2489
remote_branch.lock_read()
2491
local_extra, remote_extra = find_unmerged(local_branch, remote_branch)
2492
if (log_format is None):
2493
default = local_branch.get_config().log_format()
2494
log_format = get_log_format(long=long, short=short,
2495
line=line, default=default)
2496
lf = log_formatter(log_format,
2499
show_timezone='original')
2500
if reverse is False:
2501
local_extra.reverse()
2502
remote_extra.reverse()
2503
if local_extra and not theirs_only:
2504
print "You have %d extra revision(s):" % len(local_extra)
2505
for data in iter_log_data(local_extra, local_branch.repository,
2508
printed_local = True
2510
printed_local = False
2511
if remote_extra and not mine_only:
2512
if printed_local is True:
2514
print "You are missing %d revision(s):" % len(remote_extra)
2515
for data in iter_log_data(remote_extra, remote_branch.repository,
2518
if not remote_extra and not local_extra:
2520
print "Branches are up to date."
2524
remote_branch.unlock()
2526
local_branch.unlock()
2527
if not status_code and parent is None and other_branch is not None:
2528
local_branch.lock_write()
2530
# handle race conditions - a parent might be set while we run.
2531
if local_branch.get_parent() is None:
2532
local_branch.set_parent(remote_branch.base)
2534
local_branch.unlock()
1770
2538
class cmd_plugins(Command):
1878
2659
if from_revno is None or to_revno is None:
1879
2660
raise BzrCommandError('Cannot sign a range of non-revision-history revisions')
1880
2661
for revno in range(from_revno, to_revno + 1):
1881
b.sign_revision(b.get_rev_id(revno), gpg_strategy)
2662
b.repository.sign_revision(b.get_rev_id(revno),
1883
2665
raise BzrCommandError('Please supply either one revision, or a range.')
1886
class cmd_uncommit(bzrlib.commands.Command):
2668
class cmd_bind(Command):
2669
"""Bind the current branch to a master branch.
2671
After binding, commits must succeed on the master branch
2672
before they are executed on the local one.
2675
takes_args = ['location']
2678
def run(self, location=None):
2679
b, relpath = Branch.open_containing(u'.')
2680
b_other = Branch.open(location)
2683
except DivergedBranches:
2684
raise BzrCommandError('These branches have diverged.'
2685
' Try merging, and then bind again.')
2688
class cmd_unbind(Command):
2689
"""Unbind the current branch from its master branch.
2691
After unbinding, the local branch is considered independent.
2692
All subsequent commits will be local.
2699
b, relpath = Branch.open_containing(u'.')
2701
raise BzrCommandError('Local branch is not bound')
2704
class cmd_uncommit(Command):
1887
2705
"""Remove the last committed revision.
1889
By supplying the --all flag, it will not only remove the entry
1890
from revision_history, but also remove all of the entries in the
1893
2707
--verbose will print out what is being removed.
1894
2708
--dry-run will go through all the motions, but not actually
1895
2709
remove anything.
1897
In the future, uncommit will create a changeset, which can then
2711
In the future, uncommit will create a revision bundle, which can then
1900
takes_options = ['all', 'verbose', 'revision',
2715
# TODO: jam 20060108 Add an option to allow uncommit to remove
2716
# unreferenced information in 'branch-as-repository' branches.
2717
# TODO: jam 20060108 Add the ability for uncommit to remove unreferenced
2718
# information in shared branches as well.
2719
takes_options = ['verbose', 'revision',
1901
2720
Option('dry-run', help='Don\'t actually make changes'),
1902
2721
Option('force', help='Say yes to all questions.')]
1903
2722
takes_args = ['location?']
1906
def run(self, location=None, all=False,
2725
def run(self, location=None,
1907
2726
dry_run=False, verbose=False,
1908
2727
revision=None, force=False):
1909
from bzrlib.branch import Branch
1910
from bzrlib.log import log_formatter
2728
from bzrlib.log import log_formatter, show_log
1912
2730
from bzrlib.uncommit import uncommit
1914
2732
if location is None:
1915
2733
location = u'.'
1916
b, relpath = Branch.open_containing(location)
2734
control, relpath = bzrdir.BzrDir.open_containing(location)
2736
tree = control.open_workingtree()
2738
except (errors.NoWorkingTree, errors.NotLocalUrl):
2740
b = control.open_branch()
1918
2743
if revision is None:
1919
2744
revno = b.revno()
1920
rev_id = b.last_revision()
1922
revno, rev_id = revision[0].in_history(b)
2746
# 'bzr uncommit -r 10' actually means uncommit
2747
# so that the final tree is at revno 10.
2748
# but bzrlib.uncommit.uncommit() actually uncommits
2749
# the revisions that are supplied.
2750
# So we need to offset it by one
2751
revno = revision[0].in_history(b).revno+1
2753
if revno <= b.revno():
2754
rev_id = b.get_rev_id(revno)
1923
2755
if rev_id is None:
1924
print 'No revisions to uncommit.'
1926
for r in range(revno, b.revno()+1):
1927
rev_id = b.get_rev_id(r)
1928
lf = log_formatter('short', to_file=sys.stdout,show_timezone='original')
1929
lf.show(r, b.get_revision(rev_id), None)
2756
self.outf.write('No revisions to uncommit.\n')
2759
lf = log_formatter('short',
2761
show_timezone='original')
2766
direction='forward',
2767
start_revision=revno,
2768
end_revision=b.revno())
1932
2771
print 'Dry-run, pretending to remove the above revisions.'
1940
2779
print 'Canceled'
1943
uncommit(b, remove_files=all,
1944
dry_run=dry_run, verbose=verbose,
2782
uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
2786
class cmd_break_lock(Command):
2787
"""Break a dead lock on a repository, branch or working directory.
2789
CAUTION: Locks should only be broken when you are sure that the process
2790
holding the lock has been stopped.
2792
You can get information on what locks are open via the 'bzr info' command.
2797
takes_args = ['location?']
2799
def run(self, location=None, show=False):
2800
if location is None:
2802
control, relpath = bzrdir.BzrDir.open_containing(location)
2804
control.break_lock()
2805
except NotImplementedError:
2809
class cmd_wait_until_signalled(Command):
2810
"""Test helper for test_start_and_stop_bzr_subprocess_send_signal.
2812
This just prints a line to signal when it is ready, then blocks on stdin.
2818
sys.stdout.write("running\n")
2820
sys.stdin.readline()
2823
class cmd_serve(Command):
2824
"""Run the bzr server."""
2826
aliases = ['server']
2830
help='serve on stdin/out for use from inetd or sshd'),
2832
help='listen for connections on nominated port of the form '
2833
'[hostname:]portnumber. Passing 0 as the port number will '
2834
'result in a dynamically allocated port.',
2837
help='serve contents of directory',
2839
Option('allow-writes',
2840
help='By default the server is a readonly server. Supplying '
2841
'--allow-writes enables write access to the contents of '
2842
'the served directory and below. '
2846
def run(self, port=None, inet=False, directory=None, allow_writes=False):
2847
from bzrlib.transport import smart
2848
from bzrlib.transport import get_transport
2849
if directory is None:
2850
directory = os.getcwd()
2851
url = urlutils.local_path_to_url(directory)
2852
if not allow_writes:
2853
url = 'readonly+' + url
2854
t = get_transport(url)
2856
server = smart.SmartStreamServer(sys.stdin, sys.stdout, t)
2857
elif port is not None:
2859
host, port = port.split(':')
2862
server = smart.SmartTCPServer(t, host=host, port=int(port))
2863
print 'listening on port: ', server.port
2866
raise BzrCommandError("bzr serve requires one of --inet or --port")
2870
# command-line interpretation helper for merge-related commands
2871
def merge(other_revision, base_revision,
2872
check_clean=True, ignore_zero=False,
2873
this_dir=None, backup_files=False, merge_type=Merge3Merger,
2874
file_list=None, show_base=False, reprocess=False,
2875
pb=DummyProgress()):
2876
"""Merge changes into a tree.
2879
list(path, revno) Base for three-way merge.
2880
If [None, None] then a base will be automatically determined.
2882
list(path, revno) Other revision for three-way merge.
2884
Directory to merge changes into; '.' by default.
2886
If true, this_dir must have no uncommitted changes before the
2888
ignore_zero - If true, suppress the "zero conflicts" message when
2889
there are no conflicts; should be set when doing something we expect
2890
to complete perfectly.
2891
file_list - If supplied, merge only changes to selected files.
2893
All available ancestors of other_revision and base_revision are
2894
automatically pulled into the branch.
2896
The revno may be -1 to indicate the last revision on the branch, which is
2899
This function is intended for use from the command line; programmatic
2900
clients might prefer to call merge.merge_inner(), which has less magic
2903
from bzrlib.merge import Merger
2904
if this_dir is None:
2906
this_tree = WorkingTree.open_containing(this_dir)[0]
2907
if show_base and not merge_type is Merge3Merger:
2908
raise BzrCommandError("Show-base is not supported for this merge"
2909
" type. %s" % merge_type)
2910
if reprocess and not merge_type.supports_reprocess:
2911
raise BzrCommandError("Conflict reduction is not supported for merge"
2912
" type %s." % merge_type)
2913
if reprocess and show_base:
2914
raise BzrCommandError("Cannot do conflict reduction and show base.")
2916
merger = Merger(this_tree.branch, this_tree=this_tree, pb=pb)
2917
merger.pp = ProgressPhase("Merge phase", 5, pb)
2918
merger.pp.next_phase()
2919
merger.check_basis(check_clean)
2920
merger.set_other(other_revision)
2921
merger.pp.next_phase()
2922
merger.set_base(base_revision)
2923
if merger.base_rev_id == merger.other_rev_id:
2924
note('Nothing to do.')
2926
merger.backup_files = backup_files
2927
merger.merge_type = merge_type
2928
merger.set_interesting_files(file_list)
2929
merger.show_base = show_base
2930
merger.reprocess = reprocess
2931
conflicts = merger.do_merge()
2932
if file_list is None:
2933
merger.set_pending()
1948
2939
# these get imported and then picked up by the scan for cmd_*
1949
2940
# TODO: Some more consistent way to split command definitions across files;
1950
2941
# we do need to load at least some information about them to know of
2942
# aliases. ideally we would avoid loading the implementation until the
2943
# details were needed.
2944
from bzrlib.cmd_version_info import cmd_version_info
1952
2945
from bzrlib.conflicts import cmd_resolve, cmd_conflicts, restore
2946
from bzrlib.bundle.commands import cmd_bundle_revisions
2947
from bzrlib.sign_my_commits import cmd_sign_my_commits
2948
from bzrlib.weave_commands import cmd_weave_list, cmd_weave_join, \
2949
cmd_weave_plan_merge, cmd_weave_merge_text