~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/builtins.py

  • Committer: Jelmer Vernooij
  • Date: 2009-04-10 15:58:09 UTC
  • mto: This revision was merged to the branch mainline in revision 4284.
  • Revision ID: jelmer@samba.org-20090410155809-kdibzcjvp7pdb83f
Fix missing import.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005-2010 Canonical Ltd
 
1
# Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009 Canonical Ltd
2
2
#
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
31
31
    bundle,
32
32
    btree_index,
33
33
    bzrdir,
34
 
    directory_service,
35
34
    delta,
36
35
    config,
37
36
    errors,
44
43
    reconfigure,
45
44
    rename_map,
46
45
    revision as _mod_revision,
47
 
    static_tuple,
48
46
    symbol_versioning,
49
 
    timestamp,
50
47
    transport,
 
48
    tree as _mod_tree,
51
49
    ui,
52
50
    urlutils,
53
51
    views,
54
52
    )
55
53
from bzrlib.branch import Branch
56
54
from bzrlib.conflicts import ConflictList
57
 
from bzrlib.transport import memory
58
55
from bzrlib.revisionspec import RevisionSpec, RevisionInfo
59
56
from bzrlib.smtp_connection import SMTPConnection
60
57
from bzrlib.workingtree import WorkingTree
82
79
 
83
80
 
84
81
def tree_files_for_add(file_list):
85
 
    """
86
 
    Return a tree and list of absolute paths from a file list.
87
 
 
88
 
    Similar to tree_files, but add handles files a bit differently, so it a
89
 
    custom implementation.  In particular, MutableTreeTree.smart_add expects
90
 
    absolute paths, which it immediately converts to relative paths.
91
 
    """
92
 
    # FIXME Would be nice to just return the relative paths like
93
 
    # internal_tree_files does, but there are a large number of unit tests
94
 
    # that assume the current interface to mutabletree.smart_add
 
82
    """Add handles files a bit differently so it a custom implementation."""
95
83
    if file_list:
96
 
        tree, relpath = WorkingTree.open_containing(file_list[0])
 
84
        tree = WorkingTree.open_containing(file_list[0])[0]
97
85
        if tree.supports_views():
98
86
            view_files = tree.views.lookup_view()
99
87
            if view_files:
100
88
                for filename in file_list:
101
89
                    if not osutils.is_inside_any(view_files, filename):
102
90
                        raise errors.FileOutsideView(filename, view_files)
103
 
        file_list = file_list[:]
104
 
        file_list[0] = tree.abspath(relpath)
105
91
    else:
106
92
        tree = WorkingTree.open_containing(u'.')[0]
107
93
        if tree.supports_views():
124
110
 
125
111
 
126
112
def _get_one_revision_tree(command_name, revisions, branch=None, tree=None):
127
 
    """Get a revision tree. Not suitable for commands that change the tree.
128
 
    
129
 
    Specifically, the basis tree in dirstate trees is coupled to the dirstate
130
 
    and doing a commit/uncommit/pull will at best fail due to changing the
131
 
    basis revision data.
132
 
 
133
 
    If tree is passed in, it should be already locked, for lifetime management
134
 
    of the trees internal cached state.
135
 
    """
136
113
    if branch is None:
137
114
        branch = tree.branch
138
115
    if revisions is None:
261
238
    unknown
262
239
        Not versioned and not matching an ignore pattern.
263
240
 
264
 
    Additionally for directories, symlinks and files with an executable
265
 
    bit, Bazaar indicates their type using a trailing character: '/', '@'
266
 
    or '*' respectively.
267
 
 
268
241
    To see ignored files use 'bzr ignored'.  For details on the
269
242
    changes to file texts, use 'bzr diff'.
270
243
 
340
313
    # cat-revision is more for frontends so should be exact
341
314
    encoding = 'strict'
342
315
 
343
 
    def print_revision(self, revisions, revid):
344
 
        stream = revisions.get_record_stream([(revid,)], 'unordered', True)
345
 
        record = stream.next()
346
 
        if record.storage_kind == 'absent':
347
 
            raise errors.NoSuchRevision(revisions, revid)
348
 
        revtext = record.get_bytes_as('fulltext')
349
 
        self.outf.write(revtext.decode('utf-8'))
350
 
 
351
316
    @display_command
352
317
    def run(self, revision_id=None, revision=None):
353
318
        if revision_id is not None and revision is not None:
358
323
                                         ' --revision or a revision_id')
359
324
        b = WorkingTree.open_containing(u'.')[0].branch
360
325
 
361
 
        revisions = b.repository.revisions
362
 
        if revisions is None:
363
 
            raise errors.BzrCommandError('Repository %r does not support '
364
 
                'access to raw revision texts')
 
326
        # TODO: jam 20060112 should cat-revision always output utf-8?
 
327
        if revision_id is not None:
 
328
            revision_id = osutils.safe_revision_id(revision_id, warn=False)
 
329
            try:
 
330
                self.outf.write(b.repository.get_revision_xml(revision_id).decode('utf-8'))
 
331
            except errors.NoSuchRevision:
 
332
                msg = "The repository %s contains no revision %s." % (b.repository.base,
 
333
                    revision_id)
 
334
                raise errors.BzrCommandError(msg)
 
335
        elif revision is not None:
 
336
            for rev in revision:
 
337
                if rev is None:
 
338
                    raise errors.BzrCommandError('You cannot specify a NULL'
 
339
                                                 ' revision.')
 
340
                rev_id = rev.as_revision_id(b)
 
341
                self.outf.write(b.repository.get_revision_xml(rev_id).decode('utf-8'))
365
342
 
366
 
        b.repository.lock_read()
367
 
        try:
368
 
            # TODO: jam 20060112 should cat-revision always output utf-8?
369
 
            if revision_id is not None:
370
 
                revision_id = osutils.safe_revision_id(revision_id, warn=False)
371
 
                try:
372
 
                    self.print_revision(revisions, revision_id)
373
 
                except errors.NoSuchRevision:
374
 
                    msg = "The repository %s contains no revision %s." % (
375
 
                        b.repository.base, revision_id)
376
 
                    raise errors.BzrCommandError(msg)
377
 
            elif revision is not None:
378
 
                for rev in revision:
379
 
                    if rev is None:
380
 
                        raise errors.BzrCommandError(
381
 
                            'You cannot specify a NULL revision.')
382
 
                    rev_id = rev.as_revision_id(b)
383
 
                    self.print_revision(revisions, rev_id)
384
 
        finally:
385
 
            b.repository.unlock()
386
 
        
387
343
 
388
344
class cmd_dump_btree(Command):
389
345
    """Dump the contents of a btree index file to stdout.
456
412
        for node in bt.iter_all_entries():
457
413
            # Node is made up of:
458
414
            # (index, key, value, [references])
459
 
            refs_as_tuples = static_tuple.as_tuples(node[3])
460
 
            as_tuple = (tuple(node[1]), node[2], refs_as_tuples)
461
 
            self.outf.write('%s\n' % (as_tuple,))
 
415
            self.outf.write('%s\n' % (node[1:],))
462
416
 
463
417
 
464
418
class cmd_remove_tree(Command):
470
424
    To re-create the working tree, use "bzr checkout".
471
425
    """
472
426
    _see_also = ['checkout', 'working-trees']
473
 
    takes_args = ['location*']
 
427
    takes_args = ['location?']
474
428
    takes_options = [
475
429
        Option('force',
476
430
               help='Remove the working tree even if it has '
477
431
                    'uncommitted changes.'),
478
432
        ]
479
433
 
480
 
    def run(self, location_list, force=False):
481
 
        if not location_list:
482
 
            location_list=['.']
483
 
 
484
 
        for location in location_list:
485
 
            d = bzrdir.BzrDir.open(location)
486
 
            
487
 
            try:
488
 
                working = d.open_workingtree()
489
 
            except errors.NoWorkingTree:
490
 
                raise errors.BzrCommandError("No working tree to remove")
491
 
            except errors.NotLocalUrl:
492
 
                raise errors.BzrCommandError("You cannot remove the working tree"
493
 
                                             " of a remote path")
494
 
            if not force:
495
 
                if (working.has_changes()):
496
 
                    raise errors.UncommittedChanges(working)
497
 
 
498
 
            working_path = working.bzrdir.root_transport.base
499
 
            branch_path = working.branch.bzrdir.root_transport.base
500
 
            if working_path != branch_path:
501
 
                raise errors.BzrCommandError("You cannot remove the working tree"
502
 
                                             " from a lightweight checkout")
503
 
 
504
 
            d.destroy_workingtree()
 
434
    def run(self, location='.', force=False):
 
435
        d = bzrdir.BzrDir.open(location)
 
436
 
 
437
        try:
 
438
            working = d.open_workingtree()
 
439
        except errors.NoWorkingTree:
 
440
            raise errors.BzrCommandError("No working tree to remove")
 
441
        except errors.NotLocalUrl:
 
442
            raise errors.BzrCommandError("You cannot remove the working tree of a "
 
443
                                         "remote path")
 
444
        if not force:
 
445
            changes = working.changes_from(working.basis_tree())
 
446
            if changes.has_changed():
 
447
                raise errors.UncommittedChanges(working)
 
448
 
 
449
        working_path = working.bzrdir.root_transport.base
 
450
        branch_path = working.branch.bzrdir.root_transport.base
 
451
        if working_path != branch_path:
 
452
            raise errors.BzrCommandError("You cannot remove the working tree from "
 
453
                                         "a lightweight checkout")
 
454
 
 
455
        d.destroy_workingtree()
505
456
 
506
457
 
507
458
class cmd_revno(Command):
512
463
 
513
464
    _see_also = ['info']
514
465
    takes_args = ['location?']
515
 
    takes_options = [
516
 
        Option('tree', help='Show revno of working tree'),
517
 
        ]
518
466
 
519
467
    @display_command
520
 
    def run(self, tree=False, location=u'.'):
521
 
        if tree:
522
 
            try:
523
 
                wt = WorkingTree.open_containing(location)[0]
524
 
                wt.lock_read()
525
 
            except (errors.NoWorkingTree, errors.NotLocalUrl):
526
 
                raise errors.NoWorkingTree(location)
527
 
            self.add_cleanup(wt.unlock)
528
 
            revid = wt.last_revision()
529
 
            try:
530
 
                revno_t = wt.branch.revision_id_to_dotted_revno(revid)
531
 
            except errors.NoSuchRevision:
532
 
                revno_t = ('???',)
533
 
            revno = ".".join(str(n) for n in revno_t)
534
 
        else:
535
 
            b = Branch.open_containing(location)[0]
536
 
            b.lock_read()
537
 
            self.add_cleanup(b.unlock)
538
 
            revno = b.revno()
539
 
        self.cleanup_now()
540
 
        self.outf.write(str(revno) + '\n')
 
468
    def run(self, location=u'.'):
 
469
        self.outf.write(str(Branch.open_containing(location)[0].revno()))
 
470
        self.outf.write('\n')
541
471
 
542
472
 
543
473
class cmd_revision_info(Command):
553
483
            short_name='d',
554
484
            type=unicode,
555
485
            ),
556
 
        Option('tree', help='Show revno of working tree'),
557
486
        ]
558
487
 
559
488
    @display_command
560
 
    def run(self, revision=None, directory=u'.', tree=False,
561
 
            revision_info_list=[]):
 
489
    def run(self, revision=None, directory=u'.', revision_info_list=[]):
562
490
 
563
 
        try:
564
 
            wt = WorkingTree.open_containing(directory)[0]
565
 
            b = wt.branch
566
 
            wt.lock_read()
567
 
            self.add_cleanup(wt.unlock)
568
 
        except (errors.NoWorkingTree, errors.NotLocalUrl):
569
 
            wt = None
570
 
            b = Branch.open_containing(directory)[0]
571
 
            b.lock_read()
572
 
            self.add_cleanup(b.unlock)
573
 
        revision_ids = []
 
491
        revs = []
574
492
        if revision is not None:
575
 
            revision_ids.extend(rev.as_revision_id(b) for rev in revision)
 
493
            revs.extend(revision)
576
494
        if revision_info_list is not None:
577
 
            for rev_str in revision_info_list:
578
 
                rev_spec = RevisionSpec.from_string(rev_str)
579
 
                revision_ids.append(rev_spec.as_revision_id(b))
580
 
        # No arguments supplied, default to the last revision
581
 
        if len(revision_ids) == 0:
582
 
            if tree:
583
 
                if wt is None:
584
 
                    raise errors.NoWorkingTree(directory)
585
 
                revision_ids.append(wt.last_revision())
586
 
            else:
587
 
                revision_ids.append(b.last_revision())
588
 
 
589
 
        revinfos = []
590
 
        maxlen = 0
591
 
        for revision_id in revision_ids:
 
495
            for rev in revision_info_list:
 
496
                revs.append(RevisionSpec.from_string(rev))
 
497
 
 
498
        b = Branch.open_containing(directory)[0]
 
499
 
 
500
        if len(revs) == 0:
 
501
            revs.append(RevisionSpec.from_string('-1'))
 
502
 
 
503
        for rev in revs:
 
504
            revision_id = rev.as_revision_id(b)
592
505
            try:
593
 
                dotted_revno = b.revision_id_to_dotted_revno(revision_id)
594
 
                revno = '.'.join(str(i) for i in dotted_revno)
 
506
                revno = '%4d' % (b.revision_id_to_revno(revision_id))
595
507
            except errors.NoSuchRevision:
596
 
                revno = '???'
597
 
            maxlen = max(maxlen, len(revno))
598
 
            revinfos.append([revno, revision_id])
599
 
 
600
 
        self.cleanup_now()
601
 
        for ri in revinfos:
602
 
            self.outf.write('%*s %s\n' % (maxlen, ri[0], ri[1]))
 
508
                dotted_map = b.get_revision_id_to_revno_map()
 
509
                revno = '.'.join(str(i) for i in dotted_map[revision_id])
 
510
            print '%s %s' % (revno, revision_id)
603
511
 
604
512
 
605
513
class cmd_add(Command):
635
543
    branches that will be merged later (without showing the two different
636
544
    adds as a conflict). It is also useful when merging another project
637
545
    into a subdirectory of this one.
638
 
    
639
 
    Any files matching patterns in the ignore list will not be added
640
 
    unless they are explicitly mentioned.
641
546
    """
642
547
    takes_args = ['file*']
643
548
    takes_options = [
651
556
               help='Lookup file ids from this tree.'),
652
557
        ]
653
558
    encoding_type = 'replace'
654
 
    _see_also = ['remove', 'ignore']
 
559
    _see_also = ['remove']
655
560
 
656
561
    def run(self, file_list, no_recurse=False, dry_run=False, verbose=False,
657
562
            file_ids_from=None):
675
580
 
676
581
        if base_tree:
677
582
            base_tree.lock_read()
678
 
            self.add_cleanup(base_tree.unlock)
679
 
        tree, file_list = tree_files_for_add(file_list)
680
 
        added, ignored = tree.smart_add(file_list, not
681
 
            no_recurse, action=action, save=not dry_run)
682
 
        self.cleanup_now()
 
583
        try:
 
584
            file_list = self._maybe_expand_globs(file_list)
 
585
            tree, file_list = tree_files_for_add(file_list)
 
586
            added, ignored = tree.smart_add(file_list, not
 
587
                no_recurse, action=action, save=not dry_run)
 
588
        finally:
 
589
            if base_tree is not None:
 
590
                base_tree.unlock()
683
591
        if len(ignored) > 0:
684
592
            if verbose:
685
593
                for glob in sorted(ignored.keys()):
686
594
                    for path in ignored[glob]:
687
595
                        self.outf.write("ignored %s matching \"%s\"\n"
688
596
                                        % (path, glob))
 
597
            else:
 
598
                match_len = 0
 
599
                for glob, paths in ignored.items():
 
600
                    match_len += len(paths)
 
601
                self.outf.write("ignored %d file(s).\n" % match_len)
 
602
            self.outf.write("If you wish to add some of these files,"
 
603
                            " please add them by name.\n")
689
604
 
690
605
 
691
606
class cmd_mkdir(Command):
749
664
        revision = _get_one_revision('inventory', revision)
750
665
        work_tree, file_list = tree_files(file_list)
751
666
        work_tree.lock_read()
752
 
        self.add_cleanup(work_tree.unlock)
753
 
        if revision is not None:
754
 
            tree = revision.as_tree(work_tree.branch)
755
 
 
756
 
            extra_trees = [work_tree]
757
 
            tree.lock_read()
758
 
            self.add_cleanup(tree.unlock)
759
 
        else:
760
 
            tree = work_tree
761
 
            extra_trees = []
762
 
 
763
 
        if file_list is not None:
764
 
            file_ids = tree.paths2ids(file_list, trees=extra_trees,
765
 
                                      require_versioned=True)
766
 
            # find_ids_across_trees may include some paths that don't
767
 
            # exist in 'tree'.
768
 
            entries = sorted((tree.id2path(file_id), tree.inventory[file_id])
769
 
                             for file_id in file_ids if file_id in tree)
770
 
        else:
771
 
            entries = tree.inventory.entries()
772
 
 
773
 
        self.cleanup_now()
 
667
        try:
 
668
            if revision is not None:
 
669
                tree = revision.as_tree(work_tree.branch)
 
670
 
 
671
                extra_trees = [work_tree]
 
672
                tree.lock_read()
 
673
            else:
 
674
                tree = work_tree
 
675
                extra_trees = []
 
676
 
 
677
            if file_list is not None:
 
678
                file_ids = tree.paths2ids(file_list, trees=extra_trees,
 
679
                                          require_versioned=True)
 
680
                # find_ids_across_trees may include some paths that don't
 
681
                # exist in 'tree'.
 
682
                entries = sorted((tree.id2path(file_id), tree.inventory[file_id])
 
683
                                 for file_id in file_ids if file_id in tree)
 
684
            else:
 
685
                entries = tree.inventory.entries()
 
686
        finally:
 
687
            tree.unlock()
 
688
            if tree is not work_tree:
 
689
                work_tree.unlock()
 
690
 
774
691
        for path, entry in entries:
775
692
            if kind and kind != entry.kind:
776
693
                continue
821
738
        if len(names_list) < 2:
822
739
            raise errors.BzrCommandError("missing file argument")
823
740
        tree, rel_names = tree_files(names_list, canonicalize=False)
824
 
        tree.lock_tree_write()
825
 
        self.add_cleanup(tree.unlock)
826
 
        self._run(tree, names_list, rel_names, after)
 
741
        tree.lock_write()
 
742
        try:
 
743
            self._run(tree, names_list, rel_names, after)
 
744
        finally:
 
745
            tree.unlock()
827
746
 
828
747
    def run_auto(self, names_list, after, dry_run):
829
748
        if names_list is not None and len(names_list) > 1:
833
752
            raise errors.BzrCommandError('--after cannot be specified with'
834
753
                                         ' --auto.')
835
754
        work_tree, file_list = tree_files(names_list, default_branch='.')
836
 
        work_tree.lock_tree_write()
837
 
        self.add_cleanup(work_tree.unlock)
838
 
        rename_map.RenameMap.guess_renames(work_tree, dry_run)
 
755
        work_tree.lock_write()
 
756
        try:
 
757
            rename_map.RenameMap.guess_renames(work_tree, dry_run)
 
758
        finally:
 
759
            work_tree.unlock()
839
760
 
840
761
    def _run(self, tree, names_list, rel_names, after):
841
762
        into_existing = osutils.isdir(names_list[-1])
862
783
            # All entries reference existing inventory items, so fix them up
863
784
            # for cicp file-systems.
864
785
            rel_names = tree.get_canonical_inventory_paths(rel_names)
865
 
            for src, dest in tree.move(rel_names[:-1], rel_names[-1], after=after):
866
 
                if not is_quiet():
867
 
                    self.outf.write("%s => %s\n" % (src, dest))
 
786
            for pair in tree.move(rel_names[:-1], rel_names[-1], after=after):
 
787
                self.outf.write("%s => %s\n" % pair)
868
788
        else:
869
789
            if len(names_list) != 2:
870
790
                raise errors.BzrCommandError('to mv multiple files the'
914
834
            dest = osutils.pathjoin(dest_parent, dest_tail)
915
835
            mutter("attempting to move %s => %s", src, dest)
916
836
            tree.rename_one(src, dest, after=after)
917
 
            if not is_quiet():
918
 
                self.outf.write("%s => %s\n" % (src, dest))
 
837
            self.outf.write("%s => %s\n" % (src, dest))
919
838
 
920
839
 
921
840
class cmd_pull(Command):
922
841
    """Turn this branch into a mirror of another branch.
923
842
 
924
 
    By default, this command only works on branches that have not diverged.
925
 
    Branches are considered diverged if the destination branch's most recent 
926
 
    commit is one that has not been merged (directly or indirectly) into the 
927
 
    parent.
 
843
    This command only works on branches that have not diverged.  Branches are
 
844
    considered diverged if the destination branch's most recent commit is one
 
845
    that has not been merged (directly or indirectly) into the parent.
928
846
 
929
847
    If branches have diverged, you can use 'bzr merge' to integrate the changes
930
848
    from one into the other.  Once one branch has merged, the other should
931
849
    be able to pull it again.
932
850
 
933
 
    If you want to replace your local changes and just want your branch to
934
 
    match the remote one, use pull --overwrite. This will work even if the two
935
 
    branches have diverged.
 
851
    If you want to forget your local changes and just update your branch to
 
852
    match the remote one, use pull --overwrite.
936
853
 
937
854
    If there is no default location set, the first pull will set it.  After
938
855
    that, you can omit the location to use the default.  To change the
954
871
            short_name='d',
955
872
            type=unicode,
956
873
            ),
957
 
        Option('local',
958
 
            help="Perform a local pull in a bound "
959
 
                 "branch.  Local pulls are not applied to "
960
 
                 "the master branch."
961
 
            ),
962
874
        ]
963
875
    takes_args = ['location?']
964
876
    encoding_type = 'replace'
965
877
 
966
878
    def run(self, location=None, remember=False, overwrite=False,
967
879
            revision=None, verbose=False,
968
 
            directory=None, local=False):
 
880
            directory=None):
969
881
        # FIXME: too much stuff is in the command class
970
882
        revision_id = None
971
883
        mergeable = None
977
889
        except errors.NoWorkingTree:
978
890
            tree_to = None
979
891
            branch_to = Branch.open_containing(directory)[0]
980
 
        
981
 
        if local and not branch_to.get_bound_location():
982
 
            raise errors.LocalRequiresBoundBranch()
983
892
 
984
893
        possible_transports = []
985
894
        if location is not None:
1017
926
            if branch_to.get_parent() is None or remember:
1018
927
                branch_to.set_parent(branch_from.base)
1019
928
 
1020
 
        if branch_from is not branch_to:
1021
 
            branch_from.lock_read()
1022
 
            self.add_cleanup(branch_from.unlock)
1023
929
        if revision is not None:
1024
930
            revision_id = revision.as_revision_id(branch_from)
1025
931
 
1026
932
        branch_to.lock_write()
1027
 
        self.add_cleanup(branch_to.unlock)
1028
 
        if tree_to is not None:
1029
 
            view_info = _get_view_info_for_change_reporter(tree_to)
1030
 
            change_reporter = delta._ChangeReporter(
1031
 
                unversioned_filter=tree_to.is_ignored,
1032
 
                view_info=view_info)
1033
 
            result = tree_to.pull(
1034
 
                branch_from, overwrite, revision_id, change_reporter,
1035
 
                possible_transports=possible_transports, local=local)
1036
 
        else:
1037
 
            result = branch_to.pull(
1038
 
                branch_from, overwrite, revision_id, local=local)
 
933
        try:
 
934
            if tree_to is not None:
 
935
                view_info = _get_view_info_for_change_reporter(tree_to)
 
936
                change_reporter = delta._ChangeReporter(
 
937
                    unversioned_filter=tree_to.is_ignored, view_info=view_info)
 
938
                result = tree_to.pull(branch_from, overwrite, revision_id,
 
939
                                      change_reporter,
 
940
                                      possible_transports=possible_transports)
 
941
            else:
 
942
                result = branch_to.pull(branch_from, overwrite, revision_id)
1039
943
 
1040
 
        result.report(self.outf)
1041
 
        if verbose and result.old_revid != result.new_revid:
1042
 
            log.show_branch_change(
1043
 
                branch_to, self.outf, result.old_revno,
1044
 
                result.old_revid)
 
944
            result.report(self.outf)
 
945
            if verbose and result.old_revid != result.new_revid:
 
946
                log.show_branch_change(branch_to, self.outf, result.old_revno,
 
947
                                       result.old_revid)
 
948
        finally:
 
949
            branch_to.unlock()
1045
950
 
1046
951
 
1047
952
class cmd_push(Command):
1094
999
                'for the commit history. Only the work not present in the '
1095
1000
                'referenced branch is included in the branch created.',
1096
1001
            type=unicode),
1097
 
        Option('strict',
1098
 
               help='Refuse to push if there are uncommitted changes in'
1099
 
               ' the working tree, --no-strict disables the check.'),
1100
1002
        ]
1101
1003
    takes_args = ['location?']
1102
1004
    encoding_type = 'replace'
1104
1006
    def run(self, location=None, remember=False, overwrite=False,
1105
1007
        create_prefix=False, verbose=False, revision=None,
1106
1008
        use_existing_dir=False, directory=None, stacked_on=None,
1107
 
        stacked=False, strict=None):
 
1009
        stacked=False):
1108
1010
        from bzrlib.push import _show_push_branch
1109
1011
 
 
1012
        # Get the source branch and revision_id
1110
1013
        if directory is None:
1111
1014
            directory = '.'
1112
 
        # Get the source branch
1113
 
        (tree, br_from,
1114
 
         _unused) = bzrdir.BzrDir.open_containing_tree_or_branch(directory)
1115
 
        if strict is None:
1116
 
            strict = br_from.get_config().get_user_option_as_bool('push_strict')
1117
 
        if strict is None: strict = True # default value
1118
 
        # Get the tip's revision_id
 
1015
        br_from = Branch.open_containing(directory)[0]
1119
1016
        revision = _get_one_revision('push', revision)
1120
1017
        if revision is not None:
1121
1018
            revision_id = revision.in_history(br_from).rev_id
1122
1019
        else:
1123
 
            revision_id = None
1124
 
        if strict and tree is not None and revision_id is None:
1125
 
            if (tree.has_changes()):
1126
 
                raise errors.UncommittedChanges(
1127
 
                    tree, more='Use --no-strict to force the push.')
1128
 
            if tree.last_revision() != tree.branch.last_revision():
1129
 
                # The tree has lost sync with its branch, there is little
1130
 
                # chance that the user is aware of it but he can still force
1131
 
                # the push with --no-strict
1132
 
                raise errors.OutOfDateTree(
1133
 
                    tree, more='Use --no-strict to force the push.')
 
1020
            revision_id = br_from.last_revision()
1134
1021
 
1135
1022
        # Get the stacked_on branch, if any
1136
1023
        if stacked_on is not None:
1169
1056
 
1170
1057
 
1171
1058
class cmd_branch(Command):
1172
 
    """Create a new branch that is a copy of an existing branch.
 
1059
    """Create a new copy of a branch.
1173
1060
 
1174
1061
    If the TO_LOCATION is omitted, the last component of the FROM_LOCATION will
1175
1062
    be used.  In other words, "branch ../foo/bar" will attempt to create ./bar.
1188
1075
        help='Hard-link working tree files where possible.'),
1189
1076
        Option('no-tree',
1190
1077
            help="Create a branch without a working-tree."),
1191
 
        Option('switch',
1192
 
            help="Switch the checkout in the current directory "
1193
 
                 "to the new branch."),
1194
1078
        Option('stacked',
1195
1079
            help='Create a stacked branch referring to the source branch. '
1196
1080
                'The new branch will depend on the availability of the source '
1197
1081
                'branch for all operations.'),
1198
1082
        Option('standalone',
1199
1083
               help='Do not use a shared repository, even if available.'),
1200
 
        Option('use-existing-dir',
1201
 
               help='By default branch will fail if the target'
1202
 
                    ' directory exists, but does not already'
1203
 
                    ' have a control directory.  This flag will'
1204
 
                    ' allow branch to proceed.'),
1205
 
        Option('bind',
1206
 
            help="Bind new branch to from location."),
1207
1084
        ]
1208
1085
    aliases = ['get', 'clone']
1209
1086
 
1210
1087
    def run(self, from_location, to_location=None, revision=None,
1211
 
            hardlink=False, stacked=False, standalone=False, no_tree=False,
1212
 
            use_existing_dir=False, switch=False, bind=False):
1213
 
        from bzrlib import switch as _mod_switch
 
1088
            hardlink=False, stacked=False, standalone=False, no_tree=False):
1214
1089
        from bzrlib.tag import _merge_tags_if_possible
 
1090
 
1215
1091
        accelerator_tree, br_from = bzrdir.BzrDir.open_tree_or_branch(
1216
1092
            from_location)
1217
1093
        revision = _get_one_revision('branch', revision)
1218
1094
        br_from.lock_read()
1219
 
        self.add_cleanup(br_from.unlock)
1220
 
        if revision is not None:
1221
 
            revision_id = revision.as_revision_id(br_from)
1222
 
        else:
1223
 
            # FIXME - wt.last_revision, fallback to branch, fall back to
1224
 
            # None or perhaps NULL_REVISION to mean copy nothing
1225
 
            # RBC 20060209
1226
 
            revision_id = br_from.last_revision()
1227
 
        if to_location is None:
1228
 
            to_location = urlutils.derive_to_location(from_location)
1229
 
        to_transport = transport.get_transport(to_location)
1230
1095
        try:
1231
 
            to_transport.mkdir('.')
1232
 
        except errors.FileExists:
1233
 
            if not use_existing_dir:
1234
 
                raise errors.BzrCommandError('Target directory "%s" '
1235
 
                    'already exists.' % to_location)
 
1096
            if revision is not None:
 
1097
                revision_id = revision.as_revision_id(br_from)
1236
1098
            else:
1237
 
                try:
1238
 
                    bzrdir.BzrDir.open_from_transport(to_transport)
1239
 
                except errors.NotBranchError:
1240
 
                    pass
1241
 
                else:
1242
 
                    raise errors.AlreadyBranchError(to_location)
1243
 
        except errors.NoSuchFile:
1244
 
            raise errors.BzrCommandError('Parent of "%s" does not exist.'
1245
 
                                         % to_location)
1246
 
        try:
1247
 
            # preserve whatever source format we have.
1248
 
            dir = br_from.bzrdir.sprout(to_transport.base, revision_id,
1249
 
                                        possible_transports=[to_transport],
1250
 
                                        accelerator_tree=accelerator_tree,
1251
 
                                        hardlink=hardlink, stacked=stacked,
1252
 
                                        force_new_repo=standalone,
1253
 
                                        create_tree_if_local=not no_tree,
1254
 
                                        source_branch=br_from)
1255
 
            branch = dir.open_branch()
1256
 
        except errors.NoSuchRevision:
1257
 
            to_transport.delete_tree('.')
1258
 
            msg = "The branch %s has no revision %s." % (from_location,
1259
 
                revision)
1260
 
            raise errors.BzrCommandError(msg)
1261
 
        _merge_tags_if_possible(br_from, branch)
1262
 
        # If the source branch is stacked, the new branch may
1263
 
        # be stacked whether we asked for that explicitly or not.
1264
 
        # We therefore need a try/except here and not just 'if stacked:'
1265
 
        try:
1266
 
            note('Created new stacked branch referring to %s.' %
1267
 
                branch.get_stacked_on_url())
1268
 
        except (errors.NotStacked, errors.UnstackableBranchFormat,
1269
 
            errors.UnstackableRepositoryFormat), e:
1270
 
            note('Branched %d revision(s).' % branch.revno())
1271
 
        if bind:
1272
 
            # Bind to the parent
1273
 
            parent_branch = Branch.open(from_location)
1274
 
            branch.bind(parent_branch)
1275
 
            note('New branch bound to %s' % from_location)
1276
 
        if switch:
1277
 
            # Switch to the new branch
1278
 
            wt, _ = WorkingTree.open_containing('.')
1279
 
            _mod_switch.switch(wt.bzrdir, branch)
1280
 
            note('Switched to branch: %s',
1281
 
                urlutils.unescape_for_display(branch.base, 'utf-8'))
 
1099
                # FIXME - wt.last_revision, fallback to branch, fall back to
 
1100
                # None or perhaps NULL_REVISION to mean copy nothing
 
1101
                # RBC 20060209
 
1102
                revision_id = br_from.last_revision()
 
1103
            if to_location is None:
 
1104
                to_location = urlutils.derive_to_location(from_location)
 
1105
            to_transport = transport.get_transport(to_location)
 
1106
            try:
 
1107
                to_transport.mkdir('.')
 
1108
            except errors.FileExists:
 
1109
                raise errors.BzrCommandError('Target directory "%s" already'
 
1110
                                             ' exists.' % to_location)
 
1111
            except errors.NoSuchFile:
 
1112
                raise errors.BzrCommandError('Parent of "%s" does not exist.'
 
1113
                                             % to_location)
 
1114
            try:
 
1115
                # preserve whatever source format we have.
 
1116
                dir = br_from.bzrdir.sprout(to_transport.base, revision_id,
 
1117
                                            possible_transports=[to_transport],
 
1118
                                            accelerator_tree=accelerator_tree,
 
1119
                                            hardlink=hardlink, stacked=stacked,
 
1120
                                            force_new_repo=standalone,
 
1121
                                            create_tree_if_local=not no_tree,
 
1122
                                            source_branch=br_from)
 
1123
                branch = dir.open_branch()
 
1124
            except errors.NoSuchRevision:
 
1125
                to_transport.delete_tree('.')
 
1126
                msg = "The branch %s has no revision %s." % (from_location,
 
1127
                    revision)
 
1128
                raise errors.BzrCommandError(msg)
 
1129
            _merge_tags_if_possible(br_from, branch)
 
1130
            # If the source branch is stacked, the new branch may
 
1131
            # be stacked whether we asked for that explicitly or not.
 
1132
            # We therefore need a try/except here and not just 'if stacked:'
 
1133
            try:
 
1134
                note('Created new stacked branch referring to %s.' %
 
1135
                    branch.get_stacked_on_url())
 
1136
            except (errors.NotStacked, errors.UnstackableBranchFormat,
 
1137
                errors.UnstackableRepositoryFormat), e:
 
1138
                note('Branched %d revision(s).' % branch.revno())
 
1139
        finally:
 
1140
            br_from.unlock()
1282
1141
 
1283
1142
 
1284
1143
class cmd_checkout(Command):
1363
1222
    def run(self, dir=u'.'):
1364
1223
        tree = WorkingTree.open_containing(dir)[0]
1365
1224
        tree.lock_read()
1366
 
        self.add_cleanup(tree.unlock)
1367
 
        new_inv = tree.inventory
1368
 
        old_tree = tree.basis_tree()
1369
 
        old_tree.lock_read()
1370
 
        self.add_cleanup(old_tree.unlock)
1371
 
        old_inv = old_tree.inventory
1372
 
        renames = []
1373
 
        iterator = tree.iter_changes(old_tree, include_unchanged=True)
1374
 
        for f, paths, c, v, p, n, k, e in iterator:
1375
 
            if paths[0] == paths[1]:
1376
 
                continue
1377
 
            if None in (paths):
1378
 
                continue
1379
 
            renames.append(paths)
1380
 
        renames.sort()
1381
 
        for old_name, new_name in renames:
1382
 
            self.outf.write("%s => %s\n" % (old_name, new_name))
 
1225
        try:
 
1226
            new_inv = tree.inventory
 
1227
            old_tree = tree.basis_tree()
 
1228
            old_tree.lock_read()
 
1229
            try:
 
1230
                old_inv = old_tree.inventory
 
1231
                renames = []
 
1232
                iterator = tree.iter_changes(old_tree, include_unchanged=True)
 
1233
                for f, paths, c, v, p, n, k, e in iterator:
 
1234
                    if paths[0] == paths[1]:
 
1235
                        continue
 
1236
                    if None in (paths):
 
1237
                        continue
 
1238
                    renames.append(paths)
 
1239
                renames.sort()
 
1240
                for old_name, new_name in renames:
 
1241
                    self.outf.write("%s => %s\n" % (old_name, new_name))
 
1242
            finally:
 
1243
                old_tree.unlock()
 
1244
        finally:
 
1245
            tree.unlock()
1383
1246
 
1384
1247
 
1385
1248
class cmd_update(Command):
1391
1254
 
1392
1255
    If you want to discard your local changes, you can just do a
1393
1256
    'bzr revert' instead of 'bzr commit' after the update.
1394
 
 
1395
 
    If the tree's branch is bound to a master branch, it will also update
1396
 
    the branch from the master.
1397
1257
    """
1398
1258
 
1399
1259
    _see_also = ['pull', 'working-trees', 'status-flags']
1400
1260
    takes_args = ['dir?']
1401
 
    takes_options = ['revision']
1402
1261
    aliases = ['up']
1403
1262
 
1404
 
    def run(self, dir='.', revision=None):
1405
 
        if revision is not None and len(revision) != 1:
1406
 
            raise errors.BzrCommandError(
1407
 
                        "bzr update --revision takes exactly one revision")
 
1263
    def run(self, dir='.'):
1408
1264
        tree = WorkingTree.open_containing(dir)[0]
1409
 
        branch = tree.branch
1410
1265
        possible_transports = []
1411
 
        master = branch.get_master_branch(
 
1266
        master = tree.branch.get_master_branch(
1412
1267
            possible_transports=possible_transports)
1413
1268
        if master is not None:
1414
1269
            tree.lock_write()
1415
 
            branch_location = master.base
1416
1270
        else:
1417
1271
            tree.lock_tree_write()
1418
 
            branch_location = tree.branch.base
1419
 
        self.add_cleanup(tree.unlock)
1420
 
        # get rid of the final '/' and be ready for display
1421
 
        branch_location = urlutils.unescape_for_display(branch_location[:-1],
1422
 
                                                        self.outf.encoding)
1423
 
        existing_pending_merges = tree.get_parent_ids()[1:]
1424
 
        if master is None:
1425
 
            old_tip = None
1426
 
        else:
1427
 
            # may need to fetch data into a heavyweight checkout
1428
 
            # XXX: this may take some time, maybe we should display a
1429
 
            # message
1430
 
            old_tip = branch.update(possible_transports)
1431
 
        if revision is not None:
1432
 
            revision_id = revision[0].as_revision_id(branch)
1433
 
        else:
1434
 
            revision_id = branch.last_revision()
1435
 
        if revision_id == _mod_revision.ensure_null(tree.last_revision()):
1436
 
            revno = branch.revision_id_to_revno(revision_id)
1437
 
            note("Tree is up to date at revision %d of branch %s" %
1438
 
                (revno, branch_location))
1439
 
            return 0
1440
 
        view_info = _get_view_info_for_change_reporter(tree)
1441
 
        change_reporter = delta._ChangeReporter(
1442
 
            unversioned_filter=tree.is_ignored,
1443
 
            view_info=view_info)
1444
1272
        try:
 
1273
            existing_pending_merges = tree.get_parent_ids()[1:]
 
1274
            last_rev = _mod_revision.ensure_null(tree.last_revision())
 
1275
            if last_rev == _mod_revision.ensure_null(
 
1276
                tree.branch.last_revision()):
 
1277
                # may be up to date, check master too.
 
1278
                if master is None or last_rev == _mod_revision.ensure_null(
 
1279
                    master.last_revision()):
 
1280
                    revno = tree.branch.revision_id_to_revno(last_rev)
 
1281
                    note("Tree is up to date at revision %d." % (revno,))
 
1282
                    return 0
 
1283
            view_info = _get_view_info_for_change_reporter(tree)
1445
1284
            conflicts = tree.update(
1446
 
                change_reporter,
1447
 
                possible_transports=possible_transports,
1448
 
                revision=revision_id,
1449
 
                old_tip=old_tip)
1450
 
        except errors.NoSuchRevision, e:
1451
 
            raise errors.BzrCommandError(
1452
 
                                  "branch has no revision %s\n"
1453
 
                                  "bzr update --revision only works"
1454
 
                                  " for a revision in the branch history"
1455
 
                                  % (e.revision))
1456
 
        revno = tree.branch.revision_id_to_revno(
1457
 
            _mod_revision.ensure_null(tree.last_revision()))
1458
 
        note('Updated to revision %d of branch %s' %
1459
 
             (revno, branch_location))
1460
 
        if tree.get_parent_ids()[1:] != existing_pending_merges:
1461
 
            note('Your local commits will now show as pending merges with '
1462
 
                 "'bzr status', and can be committed with 'bzr commit'.")
1463
 
        if conflicts != 0:
1464
 
            return 1
1465
 
        else:
1466
 
            return 0
 
1285
                delta._ChangeReporter(unversioned_filter=tree.is_ignored,
 
1286
                view_info=view_info), possible_transports=possible_transports)
 
1287
            revno = tree.branch.revision_id_to_revno(
 
1288
                _mod_revision.ensure_null(tree.last_revision()))
 
1289
            note('Updated to revision %d.' % (revno,))
 
1290
            if tree.get_parent_ids()[1:] != existing_pending_merges:
 
1291
                note('Your local commits will now show as pending merges with '
 
1292
                     "'bzr status', and can be committed with 'bzr commit'.")
 
1293
            if conflicts != 0:
 
1294
                return 1
 
1295
            else:
 
1296
                return 0
 
1297
        finally:
 
1298
            tree.unlock()
1467
1299
 
1468
1300
 
1469
1301
class cmd_info(Command):
1526
1358
            title='Deletion Strategy', value_switches=True, enum_switch=False,
1527
1359
            safe='Only delete files if they can be'
1528
1360
                 ' safely recovered (default).',
1529
 
            keep='Delete from bzr but leave the working copy.',
 
1361
            keep="Don't delete any files.",
1530
1362
            force='Delete all the specified files, even if they can not be '
1531
1363
                'recovered and even if they are non-empty directories.')]
1532
1364
    aliases = ['rm', 'del']
1540
1372
            file_list = [f for f in file_list]
1541
1373
 
1542
1374
        tree.lock_write()
1543
 
        self.add_cleanup(tree.unlock)
1544
 
        # Heuristics should probably all move into tree.remove_smart or
1545
 
        # some such?
1546
 
        if new:
1547
 
            added = tree.changes_from(tree.basis_tree(),
1548
 
                specific_files=file_list).added
1549
 
            file_list = sorted([f[0] for f in added], reverse=True)
1550
 
            if len(file_list) == 0:
1551
 
                raise errors.BzrCommandError('No matching files.')
1552
 
        elif file_list is None:
1553
 
            # missing files show up in iter_changes(basis) as
1554
 
            # versioned-with-no-kind.
1555
 
            missing = []
1556
 
            for change in tree.iter_changes(tree.basis_tree()):
1557
 
                # Find paths in the working tree that have no kind:
1558
 
                if change[1][1] is not None and change[6][1] is None:
1559
 
                    missing.append(change[1][1])
1560
 
            file_list = sorted(missing, reverse=True)
1561
 
            file_deletion_strategy = 'keep'
1562
 
        tree.remove(file_list, verbose=verbose, to_file=self.outf,
1563
 
            keep_files=file_deletion_strategy=='keep',
1564
 
            force=file_deletion_strategy=='force')
 
1375
        try:
 
1376
            # Heuristics should probably all move into tree.remove_smart or
 
1377
            # some such?
 
1378
            if new:
 
1379
                added = tree.changes_from(tree.basis_tree(),
 
1380
                    specific_files=file_list).added
 
1381
                file_list = sorted([f[0] for f in added], reverse=True)
 
1382
                if len(file_list) == 0:
 
1383
                    raise errors.BzrCommandError('No matching files.')
 
1384
            elif file_list is None:
 
1385
                # missing files show up in iter_changes(basis) as
 
1386
                # versioned-with-no-kind.
 
1387
                missing = []
 
1388
                for change in tree.iter_changes(tree.basis_tree()):
 
1389
                    # Find paths in the working tree that have no kind:
 
1390
                    if change[1][1] is not None and change[6][1] is None:
 
1391
                        missing.append(change[1][1])
 
1392
                file_list = sorted(missing, reverse=True)
 
1393
                file_deletion_strategy = 'keep'
 
1394
            tree.remove(file_list, verbose=verbose, to_file=self.outf,
 
1395
                keep_files=file_deletion_strategy=='keep',
 
1396
                force=file_deletion_strategy=='force')
 
1397
        finally:
 
1398
            tree.unlock()
1565
1399
 
1566
1400
 
1567
1401
class cmd_file_id(Command):
1712
1546
                lazy_registry=('bzrlib.bzrdir', 'format_registry'),
1713
1547
                converter=lambda name: bzrdir.format_registry.make_bzrdir(name),
1714
1548
                value_switches=True,
1715
 
                title="Branch format",
 
1549
                title="Branch Format",
1716
1550
                ),
1717
1551
         Option('append-revisions-only',
1718
1552
                help='Never change revnos or the existing log.'
1741
1575
                    "\nYou may supply --create-prefix to create all"
1742
1576
                    " leading parent directories."
1743
1577
                    % location)
1744
 
            to_transport.create_prefix()
 
1578
            _create_prefix(to_transport)
1745
1579
 
1746
1580
        try:
1747
1581
            a_bzrdir = bzrdir.BzrDir.open_from_transport(to_transport)
1765
1599
                branch.set_append_revisions_only(True)
1766
1600
            except errors.UpgradeRequired:
1767
1601
                raise errors.BzrCommandError('This branch format cannot be set'
1768
 
                    ' to append-revisions-only.  Try --default.')
 
1602
                    ' to append-revisions-only.  Try --experimental-branch6')
1769
1603
        if not is_quiet():
1770
1604
            from bzrlib.info import describe_layout, describe_format
1771
1605
            try:
1787
1621
 
1788
1622
 
1789
1623
class cmd_init_repository(Command):
1790
 
    """Create a shared repository for branches to share storage space.
 
1624
    """Create a shared repository to hold branches.
1791
1625
 
1792
1626
    New branches created under the repository directory will store their
1793
 
    revisions in the repository, not in the branch directory.  For branches
1794
 
    with shared history, this reduces the amount of storage needed and 
1795
 
    speeds up the creation of new branches.
 
1627
    revisions in the repository, not in the branch directory.
1796
1628
 
1797
 
    If the --no-trees option is given then the branches in the repository
1798
 
    will not have working trees by default.  They will still exist as 
1799
 
    directories on disk, but they will not have separate copies of the 
1800
 
    files at a certain revision.  This can be useful for repositories that
1801
 
    store branches which are interacted with through checkouts or remote
1802
 
    branches, such as on a server.
 
1629
    If the --no-trees option is used then the branches in the repository
 
1630
    will not have working trees by default.
1803
1631
 
1804
1632
    :Examples:
1805
 
        Create a shared repository holding just branches::
 
1633
        Create a shared repositories holding just branches::
1806
1634
 
1807
1635
            bzr init-repo --no-trees repo
1808
1636
            bzr init repo/trunk
1874
1702
 
1875
1703
            bzr diff -r1
1876
1704
 
1877
 
        Difference between revision 3 and revision 1::
1878
 
 
1879
 
            bzr diff -r1..3
1880
 
 
1881
 
        Difference between revision 3 and revision 1 for branch xxx::
1882
 
 
1883
 
            bzr diff -r1..3 xxx
1884
 
 
1885
 
        To see the changes introduced in revision X::
1886
 
        
1887
 
            bzr diff -cX
1888
 
 
1889
 
        Note that in the case of a merge, the -c option shows the changes
1890
 
        compared to the left hand parent. To see the changes against
1891
 
        another parent, use::
1892
 
 
1893
 
            bzr diff -r<chosen_parent>..X
1894
 
 
1895
 
        The changes introduced by revision 2 (equivalent to -r1..2)::
1896
 
 
1897
 
            bzr diff -c2
 
1705
        Difference between revision 2 and revision 1::
 
1706
 
 
1707
            bzr diff -r1..2
 
1708
 
 
1709
        Difference between revision 2 and revision 1 for branch xxx::
 
1710
 
 
1711
            bzr diff -r1..2 xxx
1898
1712
 
1899
1713
        Show just the differences for file NEWS::
1900
1714
 
1946
1760
    @display_command
1947
1761
    def run(self, revision=None, file_list=None, diff_options=None,
1948
1762
            prefix=None, old=None, new=None, using=None):
1949
 
        from bzrlib.diff import get_trees_and_branches_to_diff, show_diff_trees
 
1763
        from bzrlib.diff import _get_trees_to_diff, show_diff_trees
1950
1764
 
1951
1765
        if (prefix is None) or (prefix == '0'):
1952
1766
            # diff -p0 format
1966
1780
            raise errors.BzrCommandError('bzr diff --revision takes exactly'
1967
1781
                                         ' one or two revision specifiers')
1968
1782
 
1969
 
        (old_tree, new_tree,
1970
 
         old_branch, new_branch,
1971
 
         specific_files, extra_trees) = get_trees_and_branches_to_diff(
1972
 
            file_list, revision, old, new, apply_view=True)
 
1783
        old_tree, new_tree, specific_files, extra_trees = \
 
1784
                _get_trees_to_diff(file_list, revision, old, new,
 
1785
                apply_view=True)
1973
1786
        return show_diff_trees(old_tree, new_tree, sys.stdout,
1974
1787
                               specific_files=specific_files,
1975
1788
                               external_diff_options=diff_options,
1993
1806
    def run(self, show_ids=False):
1994
1807
        tree = WorkingTree.open_containing(u'.')[0]
1995
1808
        tree.lock_read()
1996
 
        self.add_cleanup(tree.unlock)
1997
 
        old = tree.basis_tree()
1998
 
        old.lock_read()
1999
 
        self.add_cleanup(old.unlock)
2000
 
        for path, ie in old.inventory.iter_entries():
2001
 
            if not tree.has_id(ie.file_id):
2002
 
                self.outf.write(path)
2003
 
                if show_ids:
2004
 
                    self.outf.write(' ')
2005
 
                    self.outf.write(ie.file_id)
2006
 
                self.outf.write('\n')
 
1809
        try:
 
1810
            old = tree.basis_tree()
 
1811
            old.lock_read()
 
1812
            try:
 
1813
                for path, ie in old.inventory.iter_entries():
 
1814
                    if not tree.has_id(ie.file_id):
 
1815
                        self.outf.write(path)
 
1816
                        if show_ids:
 
1817
                            self.outf.write(' ')
 
1818
                            self.outf.write(ie.file_id)
 
1819
                        self.outf.write('\n')
 
1820
            finally:
 
1821
                old.unlock()
 
1822
        finally:
 
1823
            tree.unlock()
2007
1824
 
2008
1825
 
2009
1826
class cmd_modified(Command):
2045
1862
    def run(self, null=False):
2046
1863
        wt = WorkingTree.open_containing(u'.')[0]
2047
1864
        wt.lock_read()
2048
 
        self.add_cleanup(wt.unlock)
2049
 
        basis = wt.basis_tree()
2050
 
        basis.lock_read()
2051
 
        self.add_cleanup(basis.unlock)
2052
 
        basis_inv = basis.inventory
2053
 
        inv = wt.inventory
2054
 
        for file_id in inv:
2055
 
            if file_id in basis_inv:
2056
 
                continue
2057
 
            if inv.is_root(file_id) and len(basis_inv) == 0:
2058
 
                continue
2059
 
            path = inv.id2path(file_id)
2060
 
            if not os.access(osutils.abspath(path), os.F_OK):
2061
 
                continue
2062
 
            if null:
2063
 
                self.outf.write(path + '\0')
2064
 
            else:
2065
 
                self.outf.write(osutils.quotefn(path) + '\n')
 
1865
        try:
 
1866
            basis = wt.basis_tree()
 
1867
            basis.lock_read()
 
1868
            try:
 
1869
                basis_inv = basis.inventory
 
1870
                inv = wt.inventory
 
1871
                for file_id in inv:
 
1872
                    if file_id in basis_inv:
 
1873
                        continue
 
1874
                    if inv.is_root(file_id) and len(basis_inv) == 0:
 
1875
                        continue
 
1876
                    path = inv.id2path(file_id)
 
1877
                    if not os.access(osutils.abspath(path), os.F_OK):
 
1878
                        continue
 
1879
                    if null:
 
1880
                        self.outf.write(path + '\0')
 
1881
                    else:
 
1882
                        self.outf.write(osutils.quotefn(path) + '\n')
 
1883
            finally:
 
1884
                basis.unlock()
 
1885
        finally:
 
1886
            wt.unlock()
2066
1887
 
2067
1888
 
2068
1889
class cmd_root(Command):
2213
2034
    :Tips & tricks:
2214
2035
 
2215
2036
      GUI tools and IDEs are often better at exploring history than command
2216
 
      line tools: you may prefer qlog or viz from qbzr or bzr-gtk, the
2217
 
      bzr-explorer shell, or the Loggerhead web interface.  See the Plugin
2218
 
      Guide <http://doc.bazaar.canonical.com/plugins/en/> and
2219
 
      <http://wiki.bazaar.canonical.com/IDEIntegration>.  
 
2037
      line tools. You may prefer qlog or glog from the QBzr and Bzr-Gtk packages
 
2038
      respectively for example. (TortoiseBzr uses qlog for displaying logs.) See
 
2039
      http://bazaar-vcs.org/BzrPlugins and http://bazaar-vcs.org/IDEIntegration.
 
2040
 
 
2041
      Web interfaces are often better at exploring history than command line
 
2042
      tools, particularly for branches on servers. You may prefer Loggerhead
 
2043
      or one of its alternatives. See http://bazaar-vcs.org/WebInterface.
2220
2044
 
2221
2045
      You may find it useful to add the aliases below to ``bazaar.conf``::
2222
2046
 
2244
2068
 
2245
2069
      When exploring non-mainline history on large projects with deep
2246
2070
      history, the performance of log can be greatly improved by installing
2247
 
      the historycache plugin. This plugin buffers historical information
 
2071
      the revnocache plugin. This plugin buffers historical information
2248
2072
      trading disk space for faster speed.
2249
2073
    """
2250
2074
    takes_args = ['file*']
2281
2105
            Option('show-diff',
2282
2106
                   short_name='p',
2283
2107
                   help='Show changes made in each revision as a patch.'),
2284
 
            Option('include-merges',
2285
 
                   help='Show merged revisions like --levels 0 does.'),
2286
2108
            ]
2287
2109
    encoding_type = 'replace'
2288
2110
 
2297
2119
            levels=None,
2298
2120
            message=None,
2299
2121
            limit=None,
2300
 
            show_diff=False,
2301
 
            include_merges=False):
 
2122
            show_diff=False):
2302
2123
        from bzrlib.log import (
2303
2124
            Logger,
2304
2125
            make_log_request_dict,
2305
2126
            _get_info_for_log_files,
2306
2127
            )
2307
2128
        direction = (forward and 'forward') or 'reverse'
2308
 
        if include_merges:
2309
 
            if levels is None:
2310
 
                levels = 0
2311
 
            else:
2312
 
                raise errors.BzrCommandError(
2313
 
                    '--levels and --include-merges are mutually exclusive')
2314
2129
 
2315
2130
        if change is not None:
2316
2131
            if len(change) > 1:
2325
2140
        filter_by_dir = False
2326
2141
        if file_list:
2327
2142
            # find the file ids to log and check for directory filtering
2328
 
            b, file_info_list, rev1, rev2 = _get_info_for_log_files(
2329
 
                revision, file_list)
2330
 
            self.add_cleanup(b.unlock)
 
2143
            b, file_info_list, rev1, rev2 = _get_info_for_log_files(revision,
 
2144
                file_list)
2331
2145
            for relpath, file_id, kind in file_info_list:
2332
2146
                if file_id is None:
2333
2147
                    raise errors.BzrCommandError(
2351
2165
                location = '.'
2352
2166
            dir, relpath = bzrdir.BzrDir.open_containing(location)
2353
2167
            b = dir.open_branch()
2354
 
            b.lock_read()
2355
 
            self.add_cleanup(b.unlock)
2356
2168
            rev1, rev2 = _get_revision_range(revision, b, self.name())
2357
2169
 
2358
2170
        # Decide on the type of delta & diff filtering to use
2368
2180
        else:
2369
2181
            diff_type = 'full'
2370
2182
 
2371
 
        # Build the log formatter
2372
 
        if log_format is None:
2373
 
            log_format = log.log_formatter_registry.get_default(b)
2374
 
        # Make a non-encoding output to include the diffs - bug 328007
2375
 
        unencoded_output = ui.ui_factory.make_output_stream(encoding_type='exact')
2376
 
        lf = log_format(show_ids=show_ids, to_file=self.outf,
2377
 
                        to_exact_file=unencoded_output,
2378
 
                        show_timezone=timezone,
2379
 
                        delta_format=get_verbosity_level(),
2380
 
                        levels=levels,
2381
 
                        show_advice=levels is None)
2382
 
 
2383
 
        # Choose the algorithm for doing the logging. It's annoying
2384
 
        # having multiple code paths like this but necessary until
2385
 
        # the underlying repository format is faster at generating
2386
 
        # deltas or can provide everything we need from the indices.
2387
 
        # The default algorithm - match-using-deltas - works for
2388
 
        # multiple files and directories and is faster for small
2389
 
        # amounts of history (200 revisions say). However, it's too
2390
 
        # slow for logging a single file in a repository with deep
2391
 
        # history, i.e. > 10K revisions. In the spirit of "do no
2392
 
        # evil when adding features", we continue to use the
2393
 
        # original algorithm - per-file-graph - for the "single
2394
 
        # file that isn't a directory without showing a delta" case.
2395
 
        partial_history = revision and b.repository._format.supports_chks
2396
 
        match_using_deltas = (len(file_ids) != 1 or filter_by_dir
2397
 
            or delta_type or partial_history)
2398
 
 
2399
 
        # Build the LogRequest and execute it
2400
 
        if len(file_ids) == 0:
2401
 
            file_ids = None
2402
 
        rqst = make_log_request_dict(
2403
 
            direction=direction, specific_fileids=file_ids,
2404
 
            start_revision=rev1, end_revision=rev2, limit=limit,
2405
 
            message_search=message, delta_type=delta_type,
2406
 
            diff_type=diff_type, _match_using_deltas=match_using_deltas)
2407
 
        Logger(b, rqst).show(lf)
 
2183
        b.lock_read()
 
2184
        try:
 
2185
            # Build the log formatter
 
2186
            if log_format is None:
 
2187
                log_format = log.log_formatter_registry.get_default(b)
 
2188
            lf = log_format(show_ids=show_ids, to_file=self.outf,
 
2189
                            show_timezone=timezone,
 
2190
                            delta_format=get_verbosity_level(),
 
2191
                            levels=levels)
 
2192
 
 
2193
            # Choose the algorithm for doing the logging. It's annoying
 
2194
            # having multiple code paths like this but necessary until
 
2195
            # the underlying repository format is faster at generating
 
2196
            # deltas or can provide everything we need from the indices.
 
2197
            # The default algorithm - match-using-deltas - works for
 
2198
            # multiple files and directories and is faster for small
 
2199
            # amounts of history (200 revisions say). However, it's too
 
2200
            # slow for logging a single file in a repository with deep
 
2201
            # history, i.e. > 10K revisions. In the spirit of "do no
 
2202
            # evil when adding features", we continue to use the
 
2203
            # original algorithm - per-file-graph - for the "single
 
2204
            # file that isn't a directory without showing a delta" case.
 
2205
            partial_history = revision and b.repository._format.supports_chks
 
2206
            match_using_deltas = (len(file_ids) != 1 or filter_by_dir
 
2207
                or delta_type or partial_history)
 
2208
 
 
2209
            # Build the LogRequest and execute it
 
2210
            if len(file_ids) == 0:
 
2211
                file_ids = None
 
2212
            rqst = make_log_request_dict(
 
2213
                direction=direction, specific_fileids=file_ids,
 
2214
                start_revision=rev1, end_revision=rev2, limit=limit,
 
2215
                message_search=message, delta_type=delta_type,
 
2216
                diff_type=diff_type, _match_using_deltas=match_using_deltas)
 
2217
            Logger(b, rqst).show(lf)
 
2218
        finally:
 
2219
            b.unlock()
2408
2220
 
2409
2221
 
2410
2222
def _get_revision_range(revisionspec_list, branch, command_name):
2474
2286
    @display_command
2475
2287
    def run(self, filename):
2476
2288
        tree, relpath = WorkingTree.open_containing(filename)
 
2289
        b = tree.branch
2477
2290
        file_id = tree.path2id(relpath)
2478
 
        b = tree.branch
2479
 
        b.lock_read()
2480
 
        self.add_cleanup(b.unlock)
2481
 
        touching_revs = log.find_touching_revisions(b, file_id)
2482
 
        for revno, revision_id, what in touching_revs:
 
2291
        for revno, revision_id, what in log.find_touching_revisions(b, file_id):
2483
2292
            self.outf.write("%6d %s\n" % (revno, what))
2484
2293
 
2485
2294
 
2489
2298
 
2490
2299
    _see_also = ['status', 'cat']
2491
2300
    takes_args = ['path?']
 
2301
    # TODO: Take a revision or remote path and list that tree instead.
2492
2302
    takes_options = [
2493
2303
            'verbose',
2494
2304
            'revision',
2495
 
            Option('recursive', short_name='R',
2496
 
                   help='Recurse into subdirectories.'),
 
2305
            Option('non-recursive',
 
2306
                   help='Don\'t recurse into subdirectories.'),
2497
2307
            Option('from-root',
2498
2308
                   help='Print paths relative to the root of the branch.'),
2499
2309
            Option('unknown', help='Print unknown files.'),
2510
2320
            ]
2511
2321
    @display_command
2512
2322
    def run(self, revision=None, verbose=False,
2513
 
            recursive=False, from_root=False,
 
2323
            non_recursive=False, from_root=False,
2514
2324
            unknown=False, versioned=False, ignored=False,
2515
2325
            null=False, kind=None, show_ids=False, path=None):
2516
2326
 
2525
2335
 
2526
2336
        if path is None:
2527
2337
            fs_path = '.'
 
2338
            prefix = ''
2528
2339
        else:
2529
2340
            if from_root:
2530
2341
                raise errors.BzrCommandError('cannot specify both --from-root'
2531
2342
                                             ' and PATH')
2532
2343
            fs_path = path
 
2344
            prefix = path
2533
2345
        tree, branch, relpath = bzrdir.BzrDir.open_containing_tree_or_branch(
2534
2346
            fs_path)
2535
 
 
2536
 
        # Calculate the prefix to use
2537
 
        prefix = None
2538
2347
        if from_root:
2539
 
            if relpath:
2540
 
                prefix = relpath + '/'
2541
 
        elif fs_path != '.' and not fs_path.endswith('/'):
2542
 
            prefix = fs_path + '/'
2543
 
 
 
2348
            relpath = u''
 
2349
        elif relpath:
 
2350
            relpath += '/'
2544
2351
        if revision is not None or tree is None:
2545
2352
            tree = _get_one_revision_tree('ls', revision, branch=branch)
2546
2353
 
2553
2360
                note("Ignoring files outside view. View is %s" % view_str)
2554
2361
 
2555
2362
        tree.lock_read()
2556
 
        self.add_cleanup(tree.unlock)
2557
 
        for fp, fc, fkind, fid, entry in tree.list_files(include_root=False,
2558
 
            from_dir=relpath, recursive=recursive):
2559
 
            # Apply additional masking
2560
 
            if not all and not selection[fc]:
2561
 
                continue
2562
 
            if kind is not None and fkind != kind:
2563
 
                continue
2564
 
            if apply_view:
2565
 
                try:
2566
 
                    if relpath:
2567
 
                        fullpath = osutils.pathjoin(relpath, fp)
2568
 
                    else:
2569
 
                        fullpath = fp
2570
 
                    views.check_path_in_view(tree, fullpath)
2571
 
                except errors.FileOutsideView:
2572
 
                    continue
2573
 
 
2574
 
            # Output the entry
2575
 
            if prefix:
2576
 
                fp = osutils.pathjoin(prefix, fp)
2577
 
            kindch = entry.kind_character()
2578
 
            outstring = fp + kindch
2579
 
            ui.ui_factory.clear_term()
2580
 
            if verbose:
2581
 
                outstring = '%-8s %s' % (fc, outstring)
2582
 
                if show_ids and fid is not None:
2583
 
                    outstring = "%-50s %s" % (outstring, fid)
2584
 
                self.outf.write(outstring + '\n')
2585
 
            elif null:
2586
 
                self.outf.write(fp + '\0')
2587
 
                if show_ids:
2588
 
                    if fid is not None:
2589
 
                        self.outf.write(fid)
2590
 
                    self.outf.write('\0')
2591
 
                self.outf.flush()
2592
 
            else:
2593
 
                if show_ids:
2594
 
                    if fid is not None:
2595
 
                        my_id = fid
2596
 
                    else:
2597
 
                        my_id = ''
2598
 
                    self.outf.write('%-50s %s\n' % (outstring, my_id))
2599
 
                else:
2600
 
                    self.outf.write(outstring + '\n')
 
2363
        try:
 
2364
            for fp, fc, fkind, fid, entry in tree.list_files(include_root=False):
 
2365
                if fp.startswith(relpath):
 
2366
                    fp = osutils.pathjoin(prefix, fp[len(relpath):])
 
2367
                    if non_recursive and '/' in fp:
 
2368
                        continue
 
2369
                    if not all and not selection[fc]:
 
2370
                        continue
 
2371
                    if kind is not None and fkind != kind:
 
2372
                        continue
 
2373
                    if apply_view:
 
2374
                        try:
 
2375
                            views.check_path_in_view(tree, fp)
 
2376
                        except errors.FileOutsideView:
 
2377
                            continue
 
2378
                    kindch = entry.kind_character()
 
2379
                    outstring = fp + kindch
 
2380
                    if verbose:
 
2381
                        outstring = '%-8s %s' % (fc, outstring)
 
2382
                        if show_ids and fid is not None:
 
2383
                            outstring = "%-50s %s" % (outstring, fid)
 
2384
                        self.outf.write(outstring + '\n')
 
2385
                    elif null:
 
2386
                        self.outf.write(fp + '\0')
 
2387
                        if show_ids:
 
2388
                            if fid is not None:
 
2389
                                self.outf.write(fid)
 
2390
                            self.outf.write('\0')
 
2391
                        self.outf.flush()
 
2392
                    else:
 
2393
                        if fid is not None:
 
2394
                            my_id = fid
 
2395
                        else:
 
2396
                            my_id = ''
 
2397
                        if show_ids:
 
2398
                            self.outf.write('%-50s %s\n' % (outstring, my_id))
 
2399
                        else:
 
2400
                            self.outf.write(outstring + '\n')
 
2401
        finally:
 
2402
            tree.unlock()
2601
2403
 
2602
2404
 
2603
2405
class cmd_unknowns(Command):
2618
2420
 
2619
2421
    See ``bzr help patterns`` for details on the syntax of patterns.
2620
2422
 
2621
 
    If a .bzrignore file does not exist, the ignore command
2622
 
    will create one and add the specified files or patterns to the newly
2623
 
    created file. The ignore command will also automatically add the 
2624
 
    .bzrignore file to be versioned. Creating a .bzrignore file without
2625
 
    the use of the ignore command will require an explicit add command.
2626
 
 
2627
2423
    To remove patterns from the ignore list, edit the .bzrignore file.
2628
2424
    After adding, editing or deleting that file either indirectly by
2629
2425
    using this command or directly by using an editor, be sure to commit
2630
2426
    it.
2631
 
    
2632
 
    Patterns prefixed with '!' are exceptions to ignore patterns and take
2633
 
    precedence over regular ignores.  Such exceptions are used to specify
2634
 
    files that should be versioned which would otherwise be ignored.
2635
 
    
2636
 
    Patterns prefixed with '!!' act as regular ignore patterns, but have
2637
 
    precedence over the '!' exception patterns.
2638
2427
 
2639
2428
    Note: ignore patterns containing shell wildcards must be quoted from
2640
2429
    the shell on Unix.
2644
2433
 
2645
2434
            bzr ignore ./Makefile
2646
2435
 
2647
 
        Ignore .class files in all directories...::
 
2436
        Ignore class files in all directories::
2648
2437
 
2649
2438
            bzr ignore "*.class"
2650
2439
 
2651
 
        ...but do not ignore "special.class"::
2652
 
 
2653
 
            bzr ignore "!special.class"
2654
 
 
2655
2440
        Ignore .o files under the lib directory::
2656
2441
 
2657
2442
            bzr ignore "lib/**/*.o"
2663
2448
        Ignore everything but the "debian" toplevel directory::
2664
2449
 
2665
2450
            bzr ignore "RE:(?!debian/).*"
2666
 
        
2667
 
        Ignore everything except the "local" toplevel directory,
2668
 
        but always ignore "*~" autosave files, even under local/::
2669
 
        
2670
 
            bzr ignore "*"
2671
 
            bzr ignore "!./local"
2672
 
            bzr ignore "!!*~"
2673
2451
    """
2674
2452
 
2675
2453
    _see_also = ['status', 'ignored', 'patterns']
2733
2511
    def run(self):
2734
2512
        tree = WorkingTree.open_containing(u'.')[0]
2735
2513
        tree.lock_read()
2736
 
        self.add_cleanup(tree.unlock)
2737
 
        for path, file_class, kind, file_id, entry in tree.list_files():
2738
 
            if file_class != 'I':
2739
 
                continue
2740
 
            ## XXX: Slightly inefficient since this was already calculated
2741
 
            pat = tree.is_ignored(path)
2742
 
            self.outf.write('%-50s %s\n' % (path, pat))
 
2514
        try:
 
2515
            for path, file_class, kind, file_id, entry in tree.list_files():
 
2516
                if file_class != 'I':
 
2517
                    continue
 
2518
                ## XXX: Slightly inefficient since this was already calculated
 
2519
                pat = tree.is_ignored(path)
 
2520
                self.outf.write('%-50s %s\n' % (path, pat))
 
2521
        finally:
 
2522
            tree.unlock()
2743
2523
 
2744
2524
 
2745
2525
class cmd_lookup_revision(Command):
2848
2628
        tree, branch, relpath = \
2849
2629
            bzrdir.BzrDir.open_containing_tree_or_branch(filename)
2850
2630
        branch.lock_read()
2851
 
        self.add_cleanup(branch.unlock)
2852
 
        return self._run(tree, branch, relpath, filename, revision,
2853
 
                         name_from_revision, filters)
 
2631
        try:
 
2632
            return self._run(tree, branch, relpath, filename, revision,
 
2633
                             name_from_revision, filters)
 
2634
        finally:
 
2635
            branch.unlock()
2854
2636
 
2855
2637
    def _run(self, tree, b, relpath, filename, revision, name_from_revision,
2856
2638
        filtered):
2857
2639
        if tree is None:
2858
2640
            tree = b.basis_tree()
2859
2641
        rev_tree = _get_one_revision_tree('cat', revision, branch=b)
2860
 
        rev_tree.lock_read()
2861
 
        self.add_cleanup(rev_tree.unlock)
2862
2642
 
2863
2643
        old_file_id = rev_tree.path2id(relpath)
2864
2644
 
2899
2679
            chunks = content.splitlines(True)
2900
2680
            content = filtered_output_bytes(chunks, filters,
2901
2681
                ContentFilterContext(relpath, rev_tree))
2902
 
            self.cleanup_now()
2903
2682
            self.outf.writelines(content)
2904
2683
        else:
2905
 
            self.cleanup_now()
2906
2684
            self.outf.write(content)
2907
2685
 
2908
2686
 
2918
2696
class cmd_commit(Command):
2919
2697
    """Commit changes into a new revision.
2920
2698
 
2921
 
    An explanatory message needs to be given for each commit. This is
2922
 
    often done by using the --message option (getting the message from the
2923
 
    command line) or by using the --file option (getting the message from
2924
 
    a file). If neither of these options is given, an editor is opened for
2925
 
    the user to enter the message. To see the changed files in the
2926
 
    boilerplate text loaded into the editor, use the --show-diff option.
2927
 
 
2928
 
    By default, the entire tree is committed and the person doing the
2929
 
    commit is assumed to be the author. These defaults can be overridden
2930
 
    as explained below.
2931
 
 
2932
 
    :Selective commits:
2933
 
 
2934
 
      If selected files are specified, only changes to those files are
2935
 
      committed.  If a directory is specified then the directory and
2936
 
      everything within it is committed.
2937
 
  
2938
 
      When excludes are given, they take precedence over selected files.
2939
 
      For example, to commit only changes within foo, but not changes
2940
 
      within foo/bar::
2941
 
  
2942
 
        bzr commit foo -x foo/bar
2943
 
  
2944
 
      A selective commit after a merge is not yet supported.
2945
 
 
2946
 
    :Custom authors:
2947
 
 
2948
 
      If the author of the change is not the same person as the committer,
2949
 
      you can specify the author's name using the --author option. The
2950
 
      name should be in the same format as a committer-id, e.g.
2951
 
      "John Doe <jdoe@example.com>". If there is more than one author of
2952
 
      the change you can specify the option multiple times, once for each
2953
 
      author.
2954
 
  
2955
 
    :Checks:
2956
 
 
2957
 
      A common mistake is to forget to add a new file or directory before
2958
 
      running the commit command. The --strict option checks for unknown
2959
 
      files and aborts the commit if any are found. More advanced pre-commit
2960
 
      checks can be implemented by defining hooks. See ``bzr help hooks``
2961
 
      for details.
2962
 
 
2963
 
    :Things to note:
2964
 
 
2965
 
      If you accidentially commit the wrong changes or make a spelling
2966
 
      mistake in the commit message say, you can use the uncommit command
2967
 
      to undo it. See ``bzr help uncommit`` for details.
2968
 
 
2969
 
      Hooks can also be configured to run after a commit. This allows you
2970
 
      to trigger updates to external systems like bug trackers. The --fixes
2971
 
      option can be used to record the association between a revision and
2972
 
      one or more bugs. See ``bzr help bugs`` for details.
2973
 
 
2974
 
      A selective commit may fail in some cases where the committed
2975
 
      tree would be invalid. Consider::
2976
 
  
2977
 
        bzr init foo
2978
 
        mkdir foo/bar
2979
 
        bzr add foo/bar
2980
 
        bzr commit foo -m "committing foo"
2981
 
        bzr mv foo/bar foo/baz
2982
 
        mkdir foo/bar
2983
 
        bzr add foo/bar
2984
 
        bzr commit foo/bar -m "committing bar but not baz"
2985
 
  
2986
 
      In the example above, the last commit will fail by design. This gives
2987
 
      the user the opportunity to decide whether they want to commit the
2988
 
      rename at the same time, separately first, or not at all. (As a general
2989
 
      rule, when in doubt, Bazaar has a policy of Doing the Safe Thing.)
 
2699
    If no arguments are given, the entire tree is committed.
 
2700
 
 
2701
    If selected files are specified, only changes to those files are
 
2702
    committed.  If a directory is specified then the directory and everything
 
2703
    within it is committed.
 
2704
 
 
2705
    When excludes are given, they take precedence over selected files.
 
2706
    For example, too commit only changes within foo, but not changes within
 
2707
    foo/bar::
 
2708
 
 
2709
      bzr commit foo -x foo/bar
 
2710
 
 
2711
    If author of the change is not the same person as the committer, you can
 
2712
    specify the author's name using the --author option. The name should be
 
2713
    in the same format as a committer-id, e.g. "John Doe <jdoe@example.com>".
 
2714
    If there is more than one author of the change you can specify the option
 
2715
    multiple times, once for each author.
 
2716
 
 
2717
    A selected-file commit may fail in some cases where the committed
 
2718
    tree would be invalid. Consider::
 
2719
 
 
2720
      bzr init foo
 
2721
      mkdir foo/bar
 
2722
      bzr add foo/bar
 
2723
      bzr commit foo -m "committing foo"
 
2724
      bzr mv foo/bar foo/baz
 
2725
      mkdir foo/bar
 
2726
      bzr add foo/bar
 
2727
      bzr commit foo/bar -m "committing bar but not baz"
 
2728
 
 
2729
    In the example above, the last commit will fail by design. This gives
 
2730
    the user the opportunity to decide whether they want to commit the
 
2731
    rename at the same time, separately first, or not at all. (As a general
 
2732
    rule, when in doubt, Bazaar has a policy of Doing the Safe Thing.)
 
2733
 
 
2734
    Note: A selected-file commit after a merge is not yet supported.
2990
2735
    """
2991
2736
    # TODO: Run hooks on tree to-be-committed, and after commit.
2992
2737
 
2997
2742
 
2998
2743
    # XXX: verbose currently does nothing
2999
2744
 
3000
 
    _see_also = ['add', 'bugs', 'hooks', 'uncommit']
 
2745
    _see_also = ['bugs', 'uncommit']
3001
2746
    takes_args = ['selected*']
3002
2747
    takes_options = [
3003
2748
            ListOption('exclude', type=str, short_name='x',
3015
2760
             Option('strict',
3016
2761
                    help="Refuse to commit if there are unknown "
3017
2762
                    "files in the working tree."),
3018
 
             Option('commit-time', type=str,
3019
 
                    help="Manually set a commit time using commit date "
3020
 
                    "format, e.g. '2009-10-10 08:00:00 +0100'."),
3021
2763
             ListOption('fixes', type=str,
3022
2764
                    help="Mark a bug as being fixed by this revision "
3023
2765
                         "(see \"bzr help bugs\")."),
3030
2772
                         "the master branch until a normal commit "
3031
2773
                         "is performed."
3032
2774
                    ),
3033
 
             Option('show-diff',
3034
 
                    help='When no message is supplied, show the diff along'
3035
 
                    ' with the status summary in the message editor.'),
 
2775
              Option('show-diff',
 
2776
                     help='When no message is supplied, show the diff along'
 
2777
                     ' with the status summary in the message editor.'),
3036
2778
             ]
3037
2779
    aliases = ['ci', 'checkin']
3038
2780
 
3057
2799
 
3058
2800
    def run(self, message=None, file=None, verbose=False, selected_list=None,
3059
2801
            unchanged=False, strict=False, local=False, fixes=None,
3060
 
            author=None, show_diff=False, exclude=None, commit_time=None):
 
2802
            author=None, show_diff=False, exclude=None):
3061
2803
        from bzrlib.errors import (
3062
2804
            PointlessCommit,
3063
2805
            ConflictsInTree,
3069
2811
            make_commit_message_template_encoded
3070
2812
        )
3071
2813
 
3072
 
        commit_stamp = offset = None
3073
 
        if commit_time is not None:
3074
 
            try:
3075
 
                commit_stamp, offset = timestamp.parse_patch_date(commit_time)
3076
 
            except ValueError, e:
3077
 
                raise errors.BzrCommandError(
3078
 
                    "Could not parse --commit-time: " + str(e))
3079
 
 
3080
2814
        # TODO: Need a blackbox test for invoking the external editor; may be
3081
2815
        # slightly problematic to run this cross-platform.
3082
2816
 
3102
2836
        if local and not tree.branch.get_bound_location():
3103
2837
            raise errors.LocalRequiresBoundBranch()
3104
2838
 
3105
 
        if message is not None:
3106
 
            try:
3107
 
                file_exists = osutils.lexists(message)
3108
 
            except UnicodeError:
3109
 
                # The commit message contains unicode characters that can't be
3110
 
                # represented in the filesystem encoding, so that can't be a
3111
 
                # file.
3112
 
                file_exists = False
3113
 
            if file_exists:
3114
 
                warning_msg = (
3115
 
                    'The commit message is a file name: "%(f)s".\n'
3116
 
                    '(use --file "%(f)s" to take commit message from that file)'
3117
 
                    % { 'f': message })
3118
 
                ui.ui_factory.show_warning(warning_msg)
3119
 
 
3120
2839
        def get_message(commit_obj):
3121
2840
            """Callback to get commit message"""
3122
2841
            my_message = message
3123
 
            if my_message is not None and '\r' in my_message:
3124
 
                my_message = my_message.replace('\r\n', '\n')
3125
 
                my_message = my_message.replace('\r', '\n')
3126
2842
            if my_message is None and not file:
3127
2843
                t = make_commit_message_template_encoded(tree,
3128
2844
                        selected_list, diff=show_diff,
3143
2859
                raise errors.BzrCommandError("empty commit message specified")
3144
2860
            return my_message
3145
2861
 
3146
 
        # The API permits a commit with a filter of [] to mean 'select nothing'
3147
 
        # but the command line should not do that.
3148
 
        if not selected_list:
3149
 
            selected_list = None
3150
2862
        try:
3151
2863
            tree.commit(message_callback=get_message,
3152
2864
                        specific_files=selected_list,
3153
2865
                        allow_pointless=unchanged, strict=strict, local=local,
3154
2866
                        reporter=None, verbose=verbose, revprops=properties,
3155
 
                        authors=author, timestamp=commit_stamp,
3156
 
                        timezone=offset,
 
2867
                        authors=author,
3157
2868
                        exclude=safe_relpath_files(tree, exclude))
3158
2869
        except PointlessCommit:
3159
2870
            # FIXME: This should really happen before the file is read in;
3160
2871
            # perhaps prepare the commit; get the message; then actually commit
3161
 
            raise errors.BzrCommandError("No changes to commit."
3162
 
                              " Use --unchanged to commit anyhow.")
 
2872
            raise errors.BzrCommandError("no changes to commit."
 
2873
                              " use --unchanged to commit anyhow")
3163
2874
        except ConflictsInTree:
3164
2875
            raise errors.BzrCommandError('Conflicts detected in working '
3165
2876
                'tree.  Use "bzr conflicts" to list, "bzr resolve FILE" to'
3183
2894
    The working tree and branch checks will only give output if a problem is
3184
2895
    detected. The output fields of the repository check are:
3185
2896
 
3186
 
    revisions
3187
 
        This is just the number of revisions checked.  It doesn't
3188
 
        indicate a problem.
3189
 
 
3190
 
    versionedfiles
3191
 
        This is just the number of versionedfiles checked.  It
3192
 
        doesn't indicate a problem.
3193
 
 
3194
 
    unreferenced ancestors
3195
 
        Texts that are ancestors of other texts, but
3196
 
        are not properly referenced by the revision ancestry.  This is a
3197
 
        subtle problem that Bazaar can work around.
3198
 
 
3199
 
    unique file texts
3200
 
        This is the total number of unique file contents
3201
 
        seen in the checked revisions.  It does not indicate a problem.
3202
 
 
3203
 
    repeated file texts
3204
 
        This is the total number of repeated texts seen
3205
 
        in the checked revisions.  Texts can be repeated when their file
3206
 
        entries are modified, but the file contents are not.  It does not
3207
 
        indicate a problem.
 
2897
        revisions: This is just the number of revisions checked.  It doesn't
 
2898
            indicate a problem.
 
2899
        versionedfiles: This is just the number of versionedfiles checked.  It
 
2900
            doesn't indicate a problem.
 
2901
        unreferenced ancestors: Texts that are ancestors of other texts, but
 
2902
            are not properly referenced by the revision ancestry.  This is a
 
2903
            subtle problem that Bazaar can work around.
 
2904
        unique file texts: This is the total number of unique file contents
 
2905
            seen in the checked revisions.  It does not indicate a problem.
 
2906
        repeated file texts: This is the total number of repeated texts seen
 
2907
            in the checked revisions.  Texts can be repeated when their file
 
2908
            entries are modified, but the file contents are not.  It does not
 
2909
            indicate a problem.
3208
2910
 
3209
2911
    If no restrictions are specified, all Bazaar data that is found at the given
3210
2912
    location will be checked.
3446
3148
    Tests that need working space on disk use a common temporary directory,
3447
3149
    typically inside $TMPDIR or /tmp.
3448
3150
 
3449
 
    If you set BZR_TEST_PDB=1 when running selftest, failing tests will drop
3450
 
    into a pdb postmortem session.
3451
 
 
3452
3151
    :Examples:
3453
3152
        Run only tests relating to 'ignore'::
3454
3153
 
3463
3162
    def get_transport_type(typestring):
3464
3163
        """Parse and return a transport specifier."""
3465
3164
        if typestring == "sftp":
3466
 
            from bzrlib.tests import stub_sftp
3467
 
            return stub_sftp.SFTPAbsoluteServer
 
3165
            from bzrlib.transport.sftp import SFTPAbsoluteServer
 
3166
            return SFTPAbsoluteServer
3468
3167
        if typestring == "memory":
3469
 
            from bzrlib.tests import test_server
3470
 
            return memory.MemoryServer
 
3168
            from bzrlib.transport.memory import MemoryServer
 
3169
            return MemoryServer
3471
3170
        if typestring == "fakenfs":
3472
 
            from bzrlib.tests import test_server
3473
 
            return test_server.FakeNFSServer
 
3171
            from bzrlib.transport.fakenfs import FakeNFSServer
 
3172
            return FakeNFSServer
3474
3173
        msg = "No known transport type %s. Supported types are: sftp\n" %\
3475
3174
            (typestring)
3476
3175
        raise errors.BzrCommandError(msg)
3491
3190
                     Option('lsprof-timed',
3492
3191
                            help='Generate lsprof output for benchmarked'
3493
3192
                                 ' sections of code.'),
3494
 
                     Option('lsprof-tests',
3495
 
                            help='Generate lsprof output for each test.'),
3496
3193
                     Option('cache-dir', type=str,
3497
3194
                            help='Cache intermediate benchmark output in this '
3498
3195
                                 'directory.'),
3539
3236
            first=False, list_only=False,
3540
3237
            randomize=None, exclude=None, strict=False,
3541
3238
            load_list=None, debugflag=None, starting_with=None, subunit=False,
3542
 
            parallel=None, lsprof_tests=False):
 
3239
            parallel=None):
3543
3240
        from bzrlib.tests import selftest
3544
3241
        import bzrlib.benchmarks as benchmarks
3545
3242
        from bzrlib.benchmarks import tree_creator
3549
3246
 
3550
3247
        if cache_dir is not None:
3551
3248
            tree_creator.TreeCreator.CACHE_ROOT = osutils.abspath(cache_dir)
 
3249
        if not list_only:
 
3250
            print 'testing: %s' % (osutils.realpath(sys.argv[0]),)
 
3251
            print '   %s (%s python%s)' % (
 
3252
                    bzrlib.__path__[0],
 
3253
                    bzrlib.version_string,
 
3254
                    bzrlib._format_version_tuple(sys.version_info),
 
3255
                    )
 
3256
        print
3552
3257
        if testspecs_list is not None:
3553
3258
            pattern = '|'.join(testspecs_list)
3554
3259
        else:
3569
3274
            verbose = not is_quiet()
3570
3275
            # TODO: should possibly lock the history file...
3571
3276
            benchfile = open(".perf_history", "at", buffering=1)
3572
 
            self.add_cleanup(benchfile.close)
3573
3277
        else:
3574
3278
            test_suite_factory = None
3575
3279
            benchfile = None
3576
 
        selftest_kwargs = {"verbose": verbose,
3577
 
                          "pattern": pattern,
3578
 
                          "stop_on_failure": one,
3579
 
                          "transport": transport,
3580
 
                          "test_suite_factory": test_suite_factory,
3581
 
                          "lsprof_timed": lsprof_timed,
3582
 
                          "lsprof_tests": lsprof_tests,
3583
 
                          "bench_history": benchfile,
3584
 
                          "matching_tests_first": first,
3585
 
                          "list_only": list_only,
3586
 
                          "random_seed": randomize,
3587
 
                          "exclude_pattern": exclude,
3588
 
                          "strict": strict,
3589
 
                          "load_list": load_list,
3590
 
                          "debug_flags": debugflag,
3591
 
                          "starting_with": starting_with
3592
 
                          }
3593
 
        selftest_kwargs.update(self.additional_selftest_args)
3594
 
        result = selftest(**selftest_kwargs)
 
3280
        try:
 
3281
            selftest_kwargs = {"verbose": verbose,
 
3282
                              "pattern": pattern,
 
3283
                              "stop_on_failure": one,
 
3284
                              "transport": transport,
 
3285
                              "test_suite_factory": test_suite_factory,
 
3286
                              "lsprof_timed": lsprof_timed,
 
3287
                              "bench_history": benchfile,
 
3288
                              "matching_tests_first": first,
 
3289
                              "list_only": list_only,
 
3290
                              "random_seed": randomize,
 
3291
                              "exclude_pattern": exclude,
 
3292
                              "strict": strict,
 
3293
                              "load_list": load_list,
 
3294
                              "debug_flags": debugflag,
 
3295
                              "starting_with": starting_with
 
3296
                              }
 
3297
            selftest_kwargs.update(self.additional_selftest_args)
 
3298
            result = selftest(**selftest_kwargs)
 
3299
        finally:
 
3300
            if benchfile is not None:
 
3301
                benchfile.close()
 
3302
        if result:
 
3303
            note('tests passed')
 
3304
        else:
 
3305
            note('tests failed')
3595
3306
        return int(not result)
3596
3307
 
3597
3308
 
3636
3347
        branch1 = Branch.open_containing(branch)[0]
3637
3348
        branch2 = Branch.open_containing(other)[0]
3638
3349
        branch1.lock_read()
3639
 
        self.add_cleanup(branch1.unlock)
3640
 
        branch2.lock_read()
3641
 
        self.add_cleanup(branch2.unlock)
3642
 
        last1 = ensure_null(branch1.last_revision())
3643
 
        last2 = ensure_null(branch2.last_revision())
3644
 
 
3645
 
        graph = branch1.repository.get_graph(branch2.repository)
3646
 
        base_rev_id = graph.find_unique_lca(last1, last2)
3647
 
 
3648
 
        print 'merge base is revision %s' % base_rev_id
 
3350
        try:
 
3351
            branch2.lock_read()
 
3352
            try:
 
3353
                last1 = ensure_null(branch1.last_revision())
 
3354
                last2 = ensure_null(branch2.last_revision())
 
3355
 
 
3356
                graph = branch1.repository.get_graph(branch2.repository)
 
3357
                base_rev_id = graph.find_unique_lca(last1, last2)
 
3358
 
 
3359
                print 'merge base is revision %s' % base_rev_id
 
3360
            finally:
 
3361
                branch2.unlock()
 
3362
        finally:
 
3363
            branch1.unlock()
3649
3364
 
3650
3365
 
3651
3366
class cmd_merge(Command):
3684
3399
    committed to record the result of the merge.
3685
3400
 
3686
3401
    merge refuses to run if there are any uncommitted changes, unless
3687
 
    --force is given. The --force option can also be used to create a
3688
 
    merge revision which has more than two parents.
3689
 
 
3690
 
    If one would like to merge changes from the working tree of the other
3691
 
    branch without merging any committed revisions, the --uncommitted option
3692
 
    can be given.
3693
 
 
3694
 
    To select only some changes to merge, use "merge -i", which will prompt
3695
 
    you to apply each diff hunk and file change, similar to "shelve".
 
3402
    --force is given.
3696
3403
 
3697
3404
    :Examples:
3698
3405
        To merge the latest revision from bzr.dev::
3707
3414
 
3708
3415
            bzr merge -r 81..82 ../bzr.dev
3709
3416
 
3710
 
        To apply a merge directive contained in /tmp/merge::
 
3417
        To apply a merge directive contained in /tmp/merge:
3711
3418
 
3712
3419
            bzr merge /tmp/merge
3713
 
 
3714
 
        To create a merge revision with three parents from two branches
3715
 
        feature1a and feature1b:
3716
 
 
3717
 
            bzr merge ../feature1a
3718
 
            bzr merge ../feature1b --force
3719
 
            bzr commit -m 'revision with three parents'
3720
3420
    """
3721
3421
 
3722
3422
    encoding_type = 'exact'
3744
3444
               short_name='d',
3745
3445
               type=unicode,
3746
3446
               ),
3747
 
        Option('preview', help='Instead of merging, show a diff of the'
3748
 
               ' merge.'),
3749
 
        Option('interactive', help='Select changes interactively.',
3750
 
            short_name='i')
 
3447
        Option('preview', help='Instead of merging, show a diff of the merge.')
3751
3448
    ]
3752
3449
 
3753
3450
    def run(self, location=None, revision=None, force=False,
3755
3452
            uncommitted=False, pull=False,
3756
3453
            directory=None,
3757
3454
            preview=False,
3758
 
            interactive=False,
3759
3455
            ):
3760
3456
        if merge_type is None:
3761
3457
            merge_type = _mod_merge.Merge3Merger
3767
3463
        verified = 'inapplicable'
3768
3464
        tree = WorkingTree.open_containing(directory)[0]
3769
3465
 
 
3466
        # die as quickly as possible if there are uncommitted changes
3770
3467
        try:
3771
3468
            basis_tree = tree.revision_tree(tree.last_revision())
3772
3469
        except errors.NoSuchRevision:
3773
3470
            basis_tree = tree.basis_tree()
3774
 
 
3775
 
        # die as quickly as possible if there are uncommitted changes
3776
3471
        if not force:
3777
 
            if tree.has_changes():
 
3472
            changes = tree.changes_from(basis_tree)
 
3473
            if changes.has_changed():
3778
3474
                raise errors.UncommittedChanges(tree)
3779
3475
 
3780
3476
        view_info = _get_view_info_for_change_reporter(tree)
3781
3477
        change_reporter = delta._ChangeReporter(
3782
3478
            unversioned_filter=tree.is_ignored, view_info=view_info)
3783
 
        pb = ui.ui_factory.nested_progress_bar()
3784
 
        self.add_cleanup(pb.finished)
3785
 
        tree.lock_write()
3786
 
        self.add_cleanup(tree.unlock)
3787
 
        if location is not None:
3788
 
            try:
3789
 
                mergeable = bundle.read_mergeable_from_url(location,
3790
 
                    possible_transports=possible_transports)
3791
 
            except errors.NotABundle:
3792
 
                mergeable = None
 
3479
        cleanups = []
 
3480
        try:
 
3481
            pb = ui.ui_factory.nested_progress_bar()
 
3482
            cleanups.append(pb.finished)
 
3483
            tree.lock_write()
 
3484
            cleanups.append(tree.unlock)
 
3485
            if location is not None:
 
3486
                try:
 
3487
                    mergeable = bundle.read_mergeable_from_url(location,
 
3488
                        possible_transports=possible_transports)
 
3489
                except errors.NotABundle:
 
3490
                    mergeable = None
 
3491
                else:
 
3492
                    if uncommitted:
 
3493
                        raise errors.BzrCommandError('Cannot use --uncommitted'
 
3494
                            ' with bundles or merge directives.')
 
3495
 
 
3496
                    if revision is not None:
 
3497
                        raise errors.BzrCommandError(
 
3498
                            'Cannot use -r with merge directives or bundles')
 
3499
                    merger, verified = _mod_merge.Merger.from_mergeable(tree,
 
3500
                       mergeable, pb)
 
3501
 
 
3502
            if merger is None and uncommitted:
 
3503
                if revision is not None and len(revision) > 0:
 
3504
                    raise errors.BzrCommandError('Cannot use --uncommitted and'
 
3505
                        ' --revision at the same time.')
 
3506
                location = self._select_branch_location(tree, location)[0]
 
3507
                other_tree, other_path = WorkingTree.open_containing(location)
 
3508
                merger = _mod_merge.Merger.from_uncommitted(tree, other_tree,
 
3509
                    pb)
 
3510
                allow_pending = False
 
3511
                if other_path != '':
 
3512
                    merger.interesting_files = [other_path]
 
3513
 
 
3514
            if merger is None:
 
3515
                merger, allow_pending = self._get_merger_from_branch(tree,
 
3516
                    location, revision, remember, possible_transports, pb)
 
3517
 
 
3518
            merger.merge_type = merge_type
 
3519
            merger.reprocess = reprocess
 
3520
            merger.show_base = show_base
 
3521
            self.sanity_check_merger(merger)
 
3522
            if (merger.base_rev_id == merger.other_rev_id and
 
3523
                merger.other_rev_id is not None):
 
3524
                note('Nothing to do.')
 
3525
                return 0
 
3526
            if pull:
 
3527
                if merger.interesting_files is not None:
 
3528
                    raise errors.BzrCommandError('Cannot pull individual files')
 
3529
                if (merger.base_rev_id == tree.last_revision()):
 
3530
                    result = tree.pull(merger.other_branch, False,
 
3531
                                       merger.other_rev_id)
 
3532
                    result.report(self.outf)
 
3533
                    return 0
 
3534
            merger.check_basis(False)
 
3535
            if preview:
 
3536
                return self._do_preview(merger)
3793
3537
            else:
3794
 
                if uncommitted:
3795
 
                    raise errors.BzrCommandError('Cannot use --uncommitted'
3796
 
                        ' with bundles or merge directives.')
3797
 
 
3798
 
                if revision is not None:
3799
 
                    raise errors.BzrCommandError(
3800
 
                        'Cannot use -r with merge directives or bundles')
3801
 
                merger, verified = _mod_merge.Merger.from_mergeable(tree,
3802
 
                   mergeable, None)
3803
 
 
3804
 
        if merger is None and uncommitted:
3805
 
            if revision is not None and len(revision) > 0:
3806
 
                raise errors.BzrCommandError('Cannot use --uncommitted and'
3807
 
                    ' --revision at the same time.')
3808
 
            merger = self.get_merger_from_uncommitted(tree, location, None)
3809
 
            allow_pending = False
3810
 
 
3811
 
        if merger is None:
3812
 
            merger, allow_pending = self._get_merger_from_branch(tree,
3813
 
                location, revision, remember, possible_transports, None)
3814
 
 
3815
 
        merger.merge_type = merge_type
3816
 
        merger.reprocess = reprocess
3817
 
        merger.show_base = show_base
3818
 
        self.sanity_check_merger(merger)
3819
 
        if (merger.base_rev_id == merger.other_rev_id and
3820
 
            merger.other_rev_id is not None):
3821
 
            note('Nothing to do.')
3822
 
            return 0
3823
 
        if pull:
3824
 
            if merger.interesting_files is not None:
3825
 
                raise errors.BzrCommandError('Cannot pull individual files')
3826
 
            if (merger.base_rev_id == tree.last_revision()):
3827
 
                result = tree.pull(merger.other_branch, False,
3828
 
                                   merger.other_rev_id)
3829
 
                result.report(self.outf)
3830
 
                return 0
3831
 
        if merger.this_basis is None:
3832
 
            raise errors.BzrCommandError(
3833
 
                "This branch has no commits."
3834
 
                " (perhaps you would prefer 'bzr pull')")
3835
 
        if preview:
3836
 
            return self._do_preview(merger)
3837
 
        elif interactive:
3838
 
            return self._do_interactive(merger)
3839
 
        else:
3840
 
            return self._do_merge(merger, change_reporter, allow_pending,
3841
 
                                  verified)
3842
 
 
3843
 
    def _get_preview(self, merger):
 
3538
                return self._do_merge(merger, change_reporter, allow_pending,
 
3539
                                      verified)
 
3540
        finally:
 
3541
            for cleanup in reversed(cleanups):
 
3542
                cleanup()
 
3543
 
 
3544
    def _do_preview(self, merger):
 
3545
        from bzrlib.diff import show_diff_trees
3844
3546
        tree_merger = merger.make_merger()
3845
3547
        tt = tree_merger.make_preview_transform()
3846
 
        self.add_cleanup(tt.finalize)
3847
 
        result_tree = tt.get_preview_tree()
3848
 
        return result_tree
3849
 
 
3850
 
    def _do_preview(self, merger):
3851
 
        from bzrlib.diff import show_diff_trees
3852
 
        result_tree = self._get_preview(merger)
3853
 
        show_diff_trees(merger.this_tree, result_tree, self.outf,
3854
 
                        old_label='', new_label='')
 
3548
        try:
 
3549
            result_tree = tt.get_preview_tree()
 
3550
            show_diff_trees(merger.this_tree, result_tree, self.outf,
 
3551
                            old_label='', new_label='')
 
3552
        finally:
 
3553
            tt.finalize()
3855
3554
 
3856
3555
    def _do_merge(self, merger, change_reporter, allow_pending, verified):
3857
3556
        merger.change_reporter = change_reporter
3865
3564
        else:
3866
3565
            return 0
3867
3566
 
3868
 
    def _do_interactive(self, merger):
3869
 
        """Perform an interactive merge.
3870
 
 
3871
 
        This works by generating a preview tree of the merge, then using
3872
 
        Shelver to selectively remove the differences between the working tree
3873
 
        and the preview tree.
3874
 
        """
3875
 
        from bzrlib import shelf_ui
3876
 
        result_tree = self._get_preview(merger)
3877
 
        writer = bzrlib.option.diff_writer_registry.get()
3878
 
        shelver = shelf_ui.Shelver(merger.this_tree, result_tree, destroy=True,
3879
 
                                   reporter=shelf_ui.ApplyReporter(),
3880
 
                                   diff_writer=writer(sys.stdout))
3881
 
        try:
3882
 
            shelver.run()
3883
 
        finally:
3884
 
            shelver.finalize()
3885
 
 
3886
3567
    def sanity_check_merger(self, merger):
3887
3568
        if (merger.show_base and
3888
3569
            not merger.merge_type is _mod_merge.Merge3Merger):
3923
3604
            base_branch, base_path = Branch.open_containing(base_loc,
3924
3605
                possible_transports)
3925
3606
        # Find the revision ids
3926
 
        other_revision_id = None
3927
 
        base_revision_id = None
3928
 
        if revision is not None:
3929
 
            if len(revision) >= 1:
3930
 
                other_revision_id = revision[-1].as_revision_id(other_branch)
3931
 
            if len(revision) == 2:
3932
 
                base_revision_id = revision[0].as_revision_id(base_branch)
3933
 
        if other_revision_id is None:
 
3607
        if revision is None or len(revision) < 1 or revision[-1] is None:
3934
3608
            other_revision_id = _mod_revision.ensure_null(
3935
3609
                other_branch.last_revision())
 
3610
        else:
 
3611
            other_revision_id = revision[-1].as_revision_id(other_branch)
 
3612
        if (revision is not None and len(revision) == 2
 
3613
            and revision[0] is not None):
 
3614
            base_revision_id = revision[0].as_revision_id(base_branch)
 
3615
        else:
 
3616
            base_revision_id = None
3936
3617
        # Remember where we merge from
3937
3618
        if ((remember or tree.branch.get_submit_branch() is None) and
3938
3619
             user_location is not None):
3947
3628
            allow_pending = True
3948
3629
        return merger, allow_pending
3949
3630
 
3950
 
    def get_merger_from_uncommitted(self, tree, location, pb):
3951
 
        """Get a merger for uncommitted changes.
3952
 
 
3953
 
        :param tree: The tree the merger should apply to.
3954
 
        :param location: The location containing uncommitted changes.
3955
 
        :param pb: The progress bar to use for showing progress.
3956
 
        """
3957
 
        location = self._select_branch_location(tree, location)[0]
3958
 
        other_tree, other_path = WorkingTree.open_containing(location)
3959
 
        merger = _mod_merge.Merger.from_uncommitted(tree, other_tree, pb)
3960
 
        if other_path != '':
3961
 
            merger.interesting_files = [other_path]
3962
 
        return merger
3963
 
 
3964
3631
    def _select_branch_location(self, tree, user_location, revision=None,
3965
3632
                                index=None):
3966
3633
        """Select a branch location, according to possible inputs.
4045
3712
            merge_type = _mod_merge.Merge3Merger
4046
3713
        tree, file_list = tree_files(file_list)
4047
3714
        tree.lock_write()
4048
 
        self.add_cleanup(tree.unlock)
4049
 
        parents = tree.get_parent_ids()
4050
 
        if len(parents) != 2:
4051
 
            raise errors.BzrCommandError("Sorry, remerge only works after normal"
4052
 
                                         " merges.  Not cherrypicking or"
4053
 
                                         " multi-merges.")
4054
 
        repository = tree.branch.repository
4055
 
        interesting_ids = None
4056
 
        new_conflicts = []
4057
 
        conflicts = tree.conflicts()
4058
 
        if file_list is not None:
4059
 
            interesting_ids = set()
4060
 
            for filename in file_list:
4061
 
                file_id = tree.path2id(filename)
4062
 
                if file_id is None:
4063
 
                    raise errors.NotVersionedError(filename)
4064
 
                interesting_ids.add(file_id)
4065
 
                if tree.kind(file_id) != "directory":
4066
 
                    continue
 
3715
        try:
 
3716
            parents = tree.get_parent_ids()
 
3717
            if len(parents) != 2:
 
3718
                raise errors.BzrCommandError("Sorry, remerge only works after normal"
 
3719
                                             " merges.  Not cherrypicking or"
 
3720
                                             " multi-merges.")
 
3721
            repository = tree.branch.repository
 
3722
            interesting_ids = None
 
3723
            new_conflicts = []
 
3724
            conflicts = tree.conflicts()
 
3725
            if file_list is not None:
 
3726
                interesting_ids = set()
 
3727
                for filename in file_list:
 
3728
                    file_id = tree.path2id(filename)
 
3729
                    if file_id is None:
 
3730
                        raise errors.NotVersionedError(filename)
 
3731
                    interesting_ids.add(file_id)
 
3732
                    if tree.kind(file_id) != "directory":
 
3733
                        continue
4067
3734
 
4068
 
                for name, ie in tree.inventory.iter_entries(file_id):
4069
 
                    interesting_ids.add(ie.file_id)
4070
 
            new_conflicts = conflicts.select_conflicts(tree, file_list)[0]
4071
 
        else:
4072
 
            # Remerge only supports resolving contents conflicts
4073
 
            allowed_conflicts = ('text conflict', 'contents conflict')
4074
 
            restore_files = [c.path for c in conflicts
4075
 
                             if c.typestring in allowed_conflicts]
4076
 
        _mod_merge.transform_tree(tree, tree.basis_tree(), interesting_ids)
4077
 
        tree.set_conflicts(ConflictList(new_conflicts))
4078
 
        if file_list is not None:
4079
 
            restore_files = file_list
4080
 
        for filename in restore_files:
 
3735
                    for name, ie in tree.inventory.iter_entries(file_id):
 
3736
                        interesting_ids.add(ie.file_id)
 
3737
                new_conflicts = conflicts.select_conflicts(tree, file_list)[0]
 
3738
            else:
 
3739
                # Remerge only supports resolving contents conflicts
 
3740
                allowed_conflicts = ('text conflict', 'contents conflict')
 
3741
                restore_files = [c.path for c in conflicts
 
3742
                                 if c.typestring in allowed_conflicts]
 
3743
            _mod_merge.transform_tree(tree, tree.basis_tree(), interesting_ids)
 
3744
            tree.set_conflicts(ConflictList(new_conflicts))
 
3745
            if file_list is not None:
 
3746
                restore_files = file_list
 
3747
            for filename in restore_files:
 
3748
                try:
 
3749
                    restore(tree.abspath(filename))
 
3750
                except errors.NotConflicted:
 
3751
                    pass
 
3752
            # Disable pending merges, because the file texts we are remerging
 
3753
            # have not had those merges performed.  If we use the wrong parents
 
3754
            # list, we imply that the working tree text has seen and rejected
 
3755
            # all the changes from the other tree, when in fact those changes
 
3756
            # have not yet been seen.
 
3757
            pb = ui.ui_factory.nested_progress_bar()
 
3758
            tree.set_parent_ids(parents[:1])
4081
3759
            try:
4082
 
                restore(tree.abspath(filename))
4083
 
            except errors.NotConflicted:
4084
 
                pass
4085
 
        # Disable pending merges, because the file texts we are remerging
4086
 
        # have not had those merges performed.  If we use the wrong parents
4087
 
        # list, we imply that the working tree text has seen and rejected
4088
 
        # all the changes from the other tree, when in fact those changes
4089
 
        # have not yet been seen.
4090
 
        tree.set_parent_ids(parents[:1])
4091
 
        try:
4092
 
            merger = _mod_merge.Merger.from_revision_ids(None, tree, parents[1])
4093
 
            merger.interesting_ids = interesting_ids
4094
 
            merger.merge_type = merge_type
4095
 
            merger.show_base = show_base
4096
 
            merger.reprocess = reprocess
4097
 
            conflicts = merger.do_merge()
 
3760
                merger = _mod_merge.Merger.from_revision_ids(pb,
 
3761
                                                             tree, parents[1])
 
3762
                merger.interesting_ids = interesting_ids
 
3763
                merger.merge_type = merge_type
 
3764
                merger.show_base = show_base
 
3765
                merger.reprocess = reprocess
 
3766
                conflicts = merger.do_merge()
 
3767
            finally:
 
3768
                tree.set_parent_ids(parents)
 
3769
                pb.finished()
4098
3770
        finally:
4099
 
            tree.set_parent_ids(parents)
 
3771
            tree.unlock()
4100
3772
        if conflicts > 0:
4101
3773
            return 1
4102
3774
        else:
4124
3796
    name.  If you name a directory, all the contents of that directory will be
4125
3797
    reverted.
4126
3798
 
4127
 
    If you have newly added files since the target revision, they will be
4128
 
    removed.  If the files to be removed have been changed, backups will be
4129
 
    created as above.  Directories containing unknown files will not be
4130
 
    deleted.
 
3799
    Any files that have been newly added since that revision will be deleted,
 
3800
    with a backup kept if appropriate.  Directories containing unknown files
 
3801
    will not be deleted.
4131
3802
 
4132
 
    The working tree contains a list of revisions that have been merged but
4133
 
    not yet committed. These revisions will be included as additional parents
4134
 
    of the next commit.  Normally, using revert clears that list as well as
4135
 
    reverting the files.  If any files are specified, revert leaves the list
4136
 
    of uncommitted merges alone and reverts only the files.  Use ``bzr revert
4137
 
    .`` in the tree root to revert all files but keep the recorded merges,
4138
 
    and ``bzr revert --forget-merges`` to clear the pending merge list without
 
3803
    The working tree contains a list of pending merged revisions, which will
 
3804
    be included as parents in the next commit.  Normally, revert clears that
 
3805
    list as well as reverting the files.  If any files are specified, revert
 
3806
    leaves the pending merge list alone and reverts only the files.  Use "bzr
 
3807
    revert ." in the tree root to revert all files but keep the merge record,
 
3808
    and "bzr revert --forget-merges" to clear the pending merge list without
4139
3809
    reverting any files.
4140
 
 
4141
 
    Using "bzr revert --forget-merges", it is possible to apply all of the
4142
 
    changes from a branch in a single revision.  To do this, perform the merge
4143
 
    as desired.  Then doing revert with the "--forget-merges" option will keep
4144
 
    the content of the tree as it was, but it will clear the list of pending
4145
 
    merges.  The next commit will then contain all of the changes that are
4146
 
    present in the other branch, but without any other parent revisions.
4147
 
    Because this technique forgets where these changes originated, it may
4148
 
    cause additional conflicts on later merges involving the same source and
4149
 
    target branches.
4150
3810
    """
4151
3811
 
4152
3812
    _see_also = ['cat', 'export']
4162
3822
            forget_merges=None):
4163
3823
        tree, file_list = tree_files(file_list)
4164
3824
        tree.lock_write()
4165
 
        self.add_cleanup(tree.unlock)
4166
 
        if forget_merges:
4167
 
            tree.set_parent_ids(tree.get_parent_ids()[:1])
4168
 
        else:
4169
 
            self._revert_tree_to_revision(tree, revision, file_list, no_backup)
 
3825
        try:
 
3826
            if forget_merges:
 
3827
                tree.set_parent_ids(tree.get_parent_ids()[:1])
 
3828
            else:
 
3829
                self._revert_tree_to_revision(tree, revision, file_list, no_backup)
 
3830
        finally:
 
3831
            tree.unlock()
4170
3832
 
4171
3833
    @staticmethod
4172
3834
    def _revert_tree_to_revision(tree, revision, file_list, no_backup):
4173
3835
        rev_tree = _get_one_revision_tree('revert', revision, tree=tree)
4174
 
        tree.revert(file_list, rev_tree, not no_backup, None,
4175
 
            report_changes=True)
 
3836
        pb = ui.ui_factory.nested_progress_bar()
 
3837
        try:
 
3838
            tree.revert(file_list, rev_tree, not no_backup, pb,
 
3839
                report_changes=True)
 
3840
        finally:
 
3841
            pb.finished()
4176
3842
 
4177
3843
 
4178
3844
class cmd_assert_fail(Command):
4227
3893
    To filter on a range of revisions, you can use the command -r begin..end
4228
3894
    -r revision requests a specific revision, -r ..end or -r begin.. are
4229
3895
    also valid.
4230
 
            
4231
 
    :Exit values:
4232
 
        1 - some missing revisions
4233
 
        0 - no missing revisions
4234
3896
 
4235
3897
    :Examples:
4236
3898
 
4319
3981
        if remote_branch.base == local_branch.base:
4320
3982
            remote_branch = local_branch
4321
3983
 
4322
 
        local_branch.lock_read()
4323
 
        self.add_cleanup(local_branch.unlock)
4324
3984
        local_revid_range = _revision_range_to_revid_range(
4325
3985
            _get_revision_range(my_revision, local_branch,
4326
3986
                self.name()))
4327
3987
 
4328
 
        remote_branch.lock_read()
4329
 
        self.add_cleanup(remote_branch.unlock)
4330
3988
        remote_revid_range = _revision_range_to_revid_range(
4331
3989
            _get_revision_range(revision,
4332
3990
                remote_branch, self.name()))
4333
3991
 
4334
 
        local_extra, remote_extra = find_unmerged(
4335
 
            local_branch, remote_branch, restrict,
4336
 
            backward=not reverse,
4337
 
            include_merges=include_merges,
4338
 
            local_revid_range=local_revid_range,
4339
 
            remote_revid_range=remote_revid_range)
4340
 
 
4341
 
        if log_format is None:
4342
 
            registry = log.log_formatter_registry
4343
 
            log_format = registry.get_default(local_branch)
4344
 
        lf = log_format(to_file=self.outf,
4345
 
                        show_ids=show_ids,
4346
 
                        show_timezone='original')
4347
 
 
4348
 
        status_code = 0
4349
 
        if local_extra and not theirs_only:
4350
 
            message("You have %d extra revision(s):\n" %
4351
 
                len(local_extra))
4352
 
            for revision in iter_log_revisions(local_extra,
4353
 
                                local_branch.repository,
4354
 
                                verbose):
4355
 
                lf.log_revision(revision)
4356
 
            printed_local = True
4357
 
            status_code = 1
4358
 
        else:
4359
 
            printed_local = False
4360
 
 
4361
 
        if remote_extra and not mine_only:
4362
 
            if printed_local is True:
4363
 
                message("\n\n\n")
4364
 
            message("You are missing %d revision(s):\n" %
4365
 
                len(remote_extra))
4366
 
            for revision in iter_log_revisions(remote_extra,
4367
 
                                remote_branch.repository,
4368
 
                                verbose):
4369
 
                lf.log_revision(revision)
4370
 
            status_code = 1
4371
 
 
4372
 
        if mine_only and not local_extra:
4373
 
            # We checked local, and found nothing extra
4374
 
            message('This branch is up to date.\n')
4375
 
        elif theirs_only and not remote_extra:
4376
 
            # We checked remote, and found nothing extra
4377
 
            message('Other branch is up to date.\n')
4378
 
        elif not (mine_only or theirs_only or local_extra or
4379
 
                  remote_extra):
4380
 
            # We checked both branches, and neither one had extra
4381
 
            # revisions
4382
 
            message("Branches are up to date.\n")
4383
 
        self.cleanup_now()
 
3992
        local_branch.lock_read()
 
3993
        try:
 
3994
            remote_branch.lock_read()
 
3995
            try:
 
3996
                local_extra, remote_extra = find_unmerged(
 
3997
                    local_branch, remote_branch, restrict,
 
3998
                    backward=not reverse,
 
3999
                    include_merges=include_merges,
 
4000
                    local_revid_range=local_revid_range,
 
4001
                    remote_revid_range=remote_revid_range)
 
4002
 
 
4003
                if log_format is None:
 
4004
                    registry = log.log_formatter_registry
 
4005
                    log_format = registry.get_default(local_branch)
 
4006
                lf = log_format(to_file=self.outf,
 
4007
                                show_ids=show_ids,
 
4008
                                show_timezone='original')
 
4009
 
 
4010
                status_code = 0
 
4011
                if local_extra and not theirs_only:
 
4012
                    message("You have %d extra revision(s):\n" %
 
4013
                        len(local_extra))
 
4014
                    for revision in iter_log_revisions(local_extra,
 
4015
                                        local_branch.repository,
 
4016
                                        verbose):
 
4017
                        lf.log_revision(revision)
 
4018
                    printed_local = True
 
4019
                    status_code = 1
 
4020
                else:
 
4021
                    printed_local = False
 
4022
 
 
4023
                if remote_extra and not mine_only:
 
4024
                    if printed_local is True:
 
4025
                        message("\n\n\n")
 
4026
                    message("You are missing %d revision(s):\n" %
 
4027
                        len(remote_extra))
 
4028
                    for revision in iter_log_revisions(remote_extra,
 
4029
                                        remote_branch.repository,
 
4030
                                        verbose):
 
4031
                        lf.log_revision(revision)
 
4032
                    status_code = 1
 
4033
 
 
4034
                if mine_only and not local_extra:
 
4035
                    # We checked local, and found nothing extra
 
4036
                    message('This branch is up to date.\n')
 
4037
                elif theirs_only and not remote_extra:
 
4038
                    # We checked remote, and found nothing extra
 
4039
                    message('Other branch is up to date.\n')
 
4040
                elif not (mine_only or theirs_only or local_extra or
 
4041
                          remote_extra):
 
4042
                    # We checked both branches, and neither one had extra
 
4043
                    # revisions
 
4044
                    message("Branches are up to date.\n")
 
4045
            finally:
 
4046
                remote_branch.unlock()
 
4047
        finally:
 
4048
            local_branch.unlock()
4384
4049
        if not status_code and parent is None and other_branch is not None:
4385
4050
            local_branch.lock_write()
4386
 
            self.add_cleanup(local_branch.unlock)
4387
 
            # handle race conditions - a parent might be set while we run.
4388
 
            if local_branch.get_parent() is None:
4389
 
                local_branch.set_parent(remote_branch.base)
 
4051
            try:
 
4052
                # handle race conditions - a parent might be set while we run.
 
4053
                if local_branch.get_parent() is None:
 
4054
                    local_branch.set_parent(remote_branch.base)
 
4055
            finally:
 
4056
                local_branch.unlock()
4390
4057
        return status_code
4391
4058
 
4392
4059
 
4420
4087
    adding new commands, providing additional network transports and
4421
4088
    customizing log output.
4422
4089
 
4423
 
    See the Bazaar Plugin Guide <http://doc.bazaar.canonical.com/plugins/en/>
4424
 
    for further information on plugins including where to find them and how to
4425
 
    install them. Instructions are also provided there on how to write new
4426
 
    plugins using the Python programming language.
 
4090
    See the Bazaar web site, http://bazaar-vcs.org, for further
 
4091
    information on plugins including where to find them and how to
 
4092
    install them. Instructions are also provided there on how to
 
4093
    write new plugins using the Python programming language.
4427
4094
    """
4428
4095
    takes_options = ['verbose']
4429
4096
 
4471
4138
        else:
4472
4139
            b = Branch.open(branch)
4473
4140
        b.lock_read()
4474
 
        self.add_cleanup(b.unlock)
4475
 
        if revision is None:
4476
 
            rev_id = b.last_revision()
4477
 
        else:
4478
 
            rev_id = revision[0].as_revision_id(b)
4479
 
        t = testament_class.from_revision(b.repository, rev_id)
4480
 
        if long:
4481
 
            sys.stdout.writelines(t.as_text_lines())
4482
 
        else:
4483
 
            sys.stdout.write(t.as_short_text())
 
4141
        try:
 
4142
            if revision is None:
 
4143
                rev_id = b.last_revision()
 
4144
            else:
 
4145
                rev_id = revision[0].as_revision_id(b)
 
4146
            t = testament_class.from_revision(b.repository, rev_id)
 
4147
            if long:
 
4148
                sys.stdout.writelines(t.as_text_lines())
 
4149
            else:
 
4150
                sys.stdout.write(t.as_short_text())
 
4151
        finally:
 
4152
            b.unlock()
4484
4153
 
4485
4154
 
4486
4155
class cmd_annotate(Command):
4512
4181
            bzrdir.BzrDir.open_containing_tree_or_branch(filename)
4513
4182
        if wt is not None:
4514
4183
            wt.lock_read()
4515
 
            self.add_cleanup(wt.unlock)
4516
4184
        else:
4517
4185
            branch.lock_read()
4518
 
            self.add_cleanup(branch.unlock)
4519
 
        tree = _get_one_revision_tree('annotate', revision, branch=branch)
4520
 
        tree.lock_read()
4521
 
        self.add_cleanup(tree.unlock)
4522
 
        if wt is not None:
4523
 
            file_id = wt.path2id(relpath)
4524
 
        else:
4525
 
            file_id = tree.path2id(relpath)
4526
 
        if file_id is None:
4527
 
            raise errors.NotVersionedError(filename)
4528
 
        file_version = tree.inventory[file_id].revision
4529
 
        if wt is not None and revision is None:
4530
 
            # If there is a tree and we're not annotating historical
4531
 
            # versions, annotate the working tree's content.
4532
 
            annotate_file_tree(wt, file_id, self.outf, long, all,
4533
 
                show_ids=show_ids)
4534
 
        else:
4535
 
            annotate_file(branch, file_version, file_id, long, all, self.outf,
4536
 
                          show_ids=show_ids)
 
4186
        try:
 
4187
            tree = _get_one_revision_tree('annotate', revision, branch=branch)
 
4188
            if wt is not None:
 
4189
                file_id = wt.path2id(relpath)
 
4190
            else:
 
4191
                file_id = tree.path2id(relpath)
 
4192
            if file_id is None:
 
4193
                raise errors.NotVersionedError(filename)
 
4194
            file_version = tree.inventory[file_id].revision
 
4195
            if wt is not None and revision is None:
 
4196
                # If there is a tree and we're not annotating historical
 
4197
                # versions, annotate the working tree's content.
 
4198
                annotate_file_tree(wt, file_id, self.outf, long, all,
 
4199
                    show_ids=show_ids)
 
4200
            else:
 
4201
                annotate_file(branch, file_version, file_id, long, all, self.outf,
 
4202
                              show_ids=show_ids)
 
4203
        finally:
 
4204
            if wt is not None:
 
4205
                wt.unlock()
 
4206
            else:
 
4207
                branch.unlock()
4537
4208
 
4538
4209
 
4539
4210
class cmd_re_sign(Command):
4551
4222
            raise errors.BzrCommandError('You must supply either --revision or a revision_id')
4552
4223
        b = WorkingTree.open_containing(u'.')[0].branch
4553
4224
        b.lock_write()
4554
 
        self.add_cleanup(b.unlock)
4555
 
        return self._run(b, revision_id_list, revision)
 
4225
        try:
 
4226
            return self._run(b, revision_id_list, revision)
 
4227
        finally:
 
4228
            b.unlock()
4556
4229
 
4557
4230
    def _run(self, b, revision_id_list, revision):
4558
4231
        import bzrlib.gpg as gpg
4609
4282
    before they will be applied to the local branch.
4610
4283
 
4611
4284
    Bound branches use the nickname of its master branch unless it is set
4612
 
    locally, in which case binding will update the local nickname to be
 
4285
    locally, in which case binding will update the the local nickname to be
4613
4286
    that of the master.
4614
4287
    """
4615
4288
 
4627
4300
                    'This format does not remember old locations.')
4628
4301
            else:
4629
4302
                if location is None:
4630
 
                    if b.get_bound_location() is not None:
4631
 
                        raise errors.BzrCommandError('Branch is already bound')
4632
 
                    else:
4633
 
                        raise errors.BzrCommandError('No location supplied '
4634
 
                            'and no previous location known')
 
4303
                    raise errors.BzrCommandError('No location supplied and no '
 
4304
                        'previous location known')
4635
4305
        b_other = Branch.open(location)
4636
4306
        try:
4637
4307
            b.bind(b_other)
4707
4377
 
4708
4378
        if tree is not None:
4709
4379
            tree.lock_write()
4710
 
            self.add_cleanup(tree.unlock)
4711
4380
        else:
4712
4381
            b.lock_write()
4713
 
            self.add_cleanup(b.unlock)
4714
 
        return self._run(b, tree, dry_run, verbose, revision, force, local=local)
 
4382
        try:
 
4383
            return self._run(b, tree, dry_run, verbose, revision, force,
 
4384
                             local=local)
 
4385
        finally:
 
4386
            if tree is not None:
 
4387
                tree.unlock()
 
4388
            else:
 
4389
                b.unlock()
4715
4390
 
4716
4391
    def _run(self, b, tree, dry_run, verbose, revision, force, local=False):
4717
4392
        from bzrlib.log import log_formatter, show_log
4734
4409
                rev_id = b.get_rev_id(revno)
4735
4410
 
4736
4411
        if rev_id is None or _mod_revision.is_null(rev_id):
4737
 
            ui.ui_factory.note('No revisions to uncommit.')
 
4412
            self.outf.write('No revisions to uncommit.\n')
4738
4413
            return 1
4739
4414
 
4740
 
        log_collector = ui.ui_factory.make_output_stream()
4741
4415
        lf = log_formatter('short',
4742
 
                           to_file=log_collector,
 
4416
                           to_file=self.outf,
4743
4417
                           show_timezone='original')
4744
4418
 
4745
4419
        show_log(b,
4750
4424
                 end_revision=last_revno)
4751
4425
 
4752
4426
        if dry_run:
4753
 
            ui.ui_factory.note('Dry-run, pretending to remove the above revisions.')
 
4427
            print 'Dry-run, pretending to remove the above revisions.'
 
4428
            if not force:
 
4429
                val = raw_input('Press <enter> to continue')
4754
4430
        else:
4755
 
            ui.ui_factory.note('The above revision(s) will be removed.')
4756
 
 
4757
 
        if not force:
4758
 
            if not ui.ui_factory.get_boolean('Are you sure [y/N]? '):
4759
 
                ui.ui_factory.note('Canceled')
4760
 
                return 0
 
4431
            print 'The above revision(s) will be removed.'
 
4432
            if not force:
 
4433
                val = raw_input('Are you sure [y/N]? ')
 
4434
                if val.lower() not in ('y', 'yes'):
 
4435
                    print 'Canceled'
 
4436
                    return 0
4761
4437
 
4762
4438
        mutter('Uncommitting from {%s} to {%s}',
4763
4439
               last_rev_id, rev_id)
4764
4440
        uncommit(b, tree=tree, dry_run=dry_run, verbose=verbose,
4765
4441
                 revno=revno, local=local)
4766
 
        ui.ui_factory.note('You can restore the old tip by running:\n'
4767
 
             '  bzr pull . -r revid:%s' % last_rev_id)
 
4442
        note('You can restore the old tip by running:\n'
 
4443
             '  bzr pull . -r revid:%s', last_rev_id)
4768
4444
 
4769
4445
 
4770
4446
class cmd_break_lock(Command):
4773
4449
    CAUTION: Locks should only be broken when you are sure that the process
4774
4450
    holding the lock has been stopped.
4775
4451
 
4776
 
    You can get information on what locks are open via the 'bzr info
4777
 
    [location]' command.
 
4452
    You can get information on what locks are open via the 'bzr info' command.
4778
4453
 
4779
4454
    :Examples:
4780
4455
        bzr break-lock
4781
 
        bzr break-lock bzr+ssh://example.com/bzr/foo
4782
4456
    """
4783
4457
    takes_args = ['location?']
4784
4458
 
4814
4488
    takes_options = [
4815
4489
        Option('inet',
4816
4490
               help='Serve on stdin/out for use from inetd or sshd.'),
4817
 
        RegistryOption('protocol',
4818
 
               help="Protocol to serve.",
4819
 
               lazy_registry=('bzrlib.transport', 'transport_server_registry'),
4820
 
               value_switches=True),
4821
4491
        Option('port',
4822
4492
               help='Listen for connections on nominated port of the form '
4823
4493
                    '[hostname:]portnumber.  Passing 0 as the port number will '
4824
 
                    'result in a dynamically allocated port.  The default port '
4825
 
                    'depends on the protocol.',
 
4494
                    'result in a dynamically allocated port.  The default port is '
 
4495
                    '4155.',
4826
4496
               type=str),
4827
4497
        Option('directory',
4828
4498
               help='Serve contents of this directory.',
4830
4500
        Option('allow-writes',
4831
4501
               help='By default the server is a readonly server.  Supplying '
4832
4502
                    '--allow-writes enables write access to the contents of '
4833
 
                    'the served directory and below.  Note that ``bzr serve`` '
4834
 
                    'does not perform authentication, so unless some form of '
4835
 
                    'external authentication is arranged supplying this '
4836
 
                    'option leads to global uncontrolled write access to your '
4837
 
                    'file system.'
 
4503
                    'the served directory and below.'
4838
4504
                ),
4839
4505
        ]
4840
4506
 
 
4507
    def run_smart_server(self, smart_server):
 
4508
        """Run 'smart_server' forever, with no UI output at all."""
 
4509
        # For the duration of this server, no UI output is permitted. note
 
4510
        # that this may cause problems with blackbox tests. This should be
 
4511
        # changed with care though, as we dont want to use bandwidth sending
 
4512
        # progress over stderr to smart server clients!
 
4513
        from bzrlib import lockdir
 
4514
        old_factory = ui.ui_factory
 
4515
        old_lockdir_timeout = lockdir._DEFAULT_TIMEOUT_SECONDS
 
4516
        try:
 
4517
            ui.ui_factory = ui.SilentUIFactory()
 
4518
            lockdir._DEFAULT_TIMEOUT_SECONDS = 0
 
4519
            smart_server.serve()
 
4520
        finally:
 
4521
            ui.ui_factory = old_factory
 
4522
            lockdir._DEFAULT_TIMEOUT_SECONDS = old_lockdir_timeout
 
4523
 
4841
4524
    def get_host_and_port(self, port):
4842
4525
        """Return the host and port to run the smart server on.
4843
4526
 
4844
 
        If 'port' is None, None will be returned for the host and port.
 
4527
        If 'port' is None, the default host (`medium.BZR_DEFAULT_INTERFACE`)
 
4528
        and port (`medium.BZR_DEFAULT_PORT`) will be used.
4845
4529
 
4846
4530
        If 'port' has a colon in it, the string before the colon will be
4847
4531
        interpreted as the host.
4850
4534
        :return: A tuple of (host, port), where 'host' is a host name or IP,
4851
4535
            and port is an integer TCP/IP port.
4852
4536
        """
4853
 
        host = None
4854
 
        if port is not None:
 
4537
        from bzrlib.smart import medium
 
4538
        host = medium.BZR_DEFAULT_INTERFACE
 
4539
        if port is None:
 
4540
            port = medium.BZR_DEFAULT_PORT
 
4541
        else:
4855
4542
            if ':' in port:
4856
4543
                host, port = port.split(':')
4857
4544
            port = int(port)
4858
4545
        return host, port
4859
4546
 
4860
 
    def run(self, port=None, inet=False, directory=None, allow_writes=False,
4861
 
            protocol=None):
4862
 
        from bzrlib.transport import get_transport, transport_server_registry
 
4547
    def get_smart_server(self, transport, inet, port):
 
4548
        """Construct a smart server.
 
4549
 
 
4550
        :param transport: The base transport from which branches will be
 
4551
            served.
 
4552
        :param inet: If True, serve over stdin and stdout. Used for running
 
4553
            from inet.
 
4554
        :param port: The port to listen on. By default, it's `
 
4555
            medium.BZR_DEFAULT_PORT`. See `get_host_and_port` for more
 
4556
            information.
 
4557
        :return: A smart server.
 
4558
        """
 
4559
        from bzrlib.smart import medium, server
 
4560
        if inet:
 
4561
            smart_server = medium.SmartServerPipeStreamMedium(
 
4562
                sys.stdin, sys.stdout, transport)
 
4563
        else:
 
4564
            host, port = self.get_host_and_port(port)
 
4565
            smart_server = server.SmartTCPServer(
 
4566
                transport, host=host, port=port)
 
4567
            note('listening on port: %s' % smart_server.port)
 
4568
        return smart_server
 
4569
 
 
4570
    def run(self, port=None, inet=False, directory=None, allow_writes=False):
 
4571
        from bzrlib.transport import get_transport
 
4572
        from bzrlib.transport.chroot import ChrootServer
4863
4573
        if directory is None:
4864
4574
            directory = os.getcwd()
4865
 
        if protocol is None:
4866
 
            protocol = transport_server_registry.get()
4867
 
        host, port = self.get_host_and_port(port)
4868
4575
        url = urlutils.local_path_to_url(directory)
4869
4576
        if not allow_writes:
4870
4577
            url = 'readonly+' + url
4871
 
        transport = get_transport(url)
4872
 
        protocol(transport, host, port, inet)
 
4578
        chroot_server = ChrootServer(get_transport(url))
 
4579
        chroot_server.setUp()
 
4580
        t = get_transport(chroot_server.get_url())
 
4581
        smart_server = self.get_smart_server(t, inet, port)
 
4582
        self.run_smart_server(smart_server)
4873
4583
 
4874
4584
 
4875
4585
class cmd_join(Command):
4876
 
    """Combine a tree into its containing tree.
 
4586
    """Combine a subtree into its containing tree.
4877
4587
 
4878
 
    This command requires the target tree to be in a rich-root format.
 
4588
    This command is for experimental use only.  It requires the target tree
 
4589
    to be in dirstate-with-subtree format, which cannot be converted into
 
4590
    earlier formats.
4879
4591
 
4880
4592
    The TREE argument should be an independent tree, inside another tree, but
4881
4593
    not part of it.  (Such trees can be produced by "bzr split", but also by
4884
4596
    The result is a combined tree, with the subtree no longer an independant
4885
4597
    part.  This is marked as a merge of the subtree into the containing tree,
4886
4598
    and all history is preserved.
 
4599
 
 
4600
    If --reference is specified, the subtree retains its independence.  It can
 
4601
    be branched by itself, and can be part of multiple projects at the same
 
4602
    time.  But operations performed in the containing tree, such as commit
 
4603
    and merge, will recurse into the subtree.
4887
4604
    """
4888
4605
 
4889
4606
    _see_also = ['split']
4890
4607
    takes_args = ['tree']
4891
4608
    takes_options = [
4892
 
            Option('reference', help='Join by reference.', hidden=True),
 
4609
            Option('reference', help='Join by reference.'),
4893
4610
            ]
 
4611
    hidden = True
4894
4612
 
4895
4613
    def run(self, tree, reference=False):
4896
4614
        sub_tree = WorkingTree.open(tree)
4930
4648
    branch.  Commits in the top-level tree will not apply to the new subtree.
4931
4649
    """
4932
4650
 
4933
 
    _see_also = ['join']
 
4651
    # join is not un-hidden yet
 
4652
    #_see_also = ['join']
4934
4653
    takes_args = ['tree']
4935
4654
 
4936
4655
    def run(self, tree):
4941
4660
        try:
4942
4661
            containing_tree.extract(sub_id)
4943
4662
        except errors.RootNotRich:
4944
 
            raise errors.RichRootUpgradeRequired(containing_tree.branch.base)
 
4663
            raise errors.UpgradeRequired(containing_tree.branch.base)
4945
4664
 
4946
4665
 
4947
4666
class cmd_merge_directive(Command):
5056
4775
      directly from the merge directive, without retrieving data from a
5057
4776
      branch.
5058
4777
 
5059
 
    `bzr send` creates a compact data set that, when applied using bzr
5060
 
    merge, has the same effect as merging from the source branch.  
5061
 
    
5062
 
    By default the merge directive is self-contained and can be applied to any
5063
 
    branch containing submit_branch in its ancestory without needing access to
5064
 
    the source branch.
5065
 
    
5066
 
    If --no-bundle is specified, then Bazaar doesn't send the contents of the
5067
 
    revisions, but only a structured request to merge from the
5068
 
    public_location.  In that case the public_branch is needed and it must be
5069
 
    up-to-date and accessible to the recipient.  The public_branch is always
5070
 
    included if known, so that people can check it later.
5071
 
 
5072
 
    The submit branch defaults to the parent of the source branch, but can be
5073
 
    overridden.  Both submit branch and public branch will be remembered in
5074
 
    branch.conf the first time they are used for a particular branch.  The
5075
 
    source branch defaults to that containing the working directory, but can
5076
 
    be changed using --from.
5077
 
 
5078
 
    In order to calculate those changes, bzr must analyse the submit branch.
5079
 
    Therefore it is most efficient for the submit branch to be a local mirror.
5080
 
    If a public location is known for the submit_branch, that location is used
5081
 
    in the merge directive.
5082
 
 
5083
 
    The default behaviour is to send the merge directive by mail, unless -o is
5084
 
    given, in which case it is sent to a file.
 
4778
    If --no-bundle is specified, then public_branch is needed (and must be
 
4779
    up-to-date), so that the receiver can perform the merge using the
 
4780
    public_branch.  The public_branch is always included if known, so that
 
4781
    people can check it later.
 
4782
 
 
4783
    The submit branch defaults to the parent, but can be overridden.  Both
 
4784
    submit branch and public branch will be remembered if supplied.
 
4785
 
 
4786
    If a public_branch is known for the submit_branch, that public submit
 
4787
    branch is used in the merge instructions.  This means that a local mirror
 
4788
    can be used as your actual submit branch, once you have set public_branch
 
4789
    for that mirror.
5085
4790
 
5086
4791
    Mail is sent using your preferred mail program.  This should be transparent
5087
4792
    on Windows (it uses MAPI).  On Linux, it requires the xdg-email utility.
5089
4794
 
5090
4795
    To use a specific mail program, set the mail_client configuration option.
5091
4796
    (For Thunderbird 1.5, this works around some bugs.)  Supported values for
5092
 
    specific clients are "claws", "evolution", "kmail", "mail.app" (MacOS X's
5093
 
    Mail.app), "mutt", and "thunderbird"; generic options are "default",
5094
 
    "editor", "emacsclient", "mapi", and "xdg-email".  Plugins may also add
5095
 
    supported clients.
 
4797
    specific clients are "claws", "evolution", "kmail", "mutt", and
 
4798
    "thunderbird"; generic options are "default", "editor", "emacsclient",
 
4799
    "mapi", and "xdg-email".  Plugins may also add supported clients.
5096
4800
 
5097
4801
    If mail is being sent, a to address is required.  This can be supplied
5098
4802
    either on the commandline, by setting the submit_to configuration
5107
4811
 
5108
4812
    The merge directives created by bzr send may be applied using bzr merge or
5109
4813
    bzr pull by specifying a file containing a merge directive as the location.
5110
 
 
5111
 
    bzr send makes extensive use of public locations to map local locations into
5112
 
    URLs that can be used by other people.  See `bzr help configuration` to
5113
 
    set them, and use `bzr info` to display them.
5114
4814
    """
5115
4815
 
5116
4816
    encoding_type = 'exact'
5135
4835
               help='Write merge directive to this file; '
5136
4836
                    'use - for stdout.',
5137
4837
               type=unicode),
5138
 
        Option('strict',
5139
 
               help='Refuse to send if there are uncommitted changes in'
5140
 
               ' the working tree, --no-strict disables the check.'),
5141
4838
        Option('mail-to', help='Mail the request to this address.',
5142
4839
               type=unicode),
5143
4840
        'revision',
5144
4841
        'message',
5145
4842
        Option('body', help='Body for the email.', type=unicode),
5146
 
        RegistryOption('format',
5147
 
                       help='Use the specified output format.',
5148
 
                       lazy_registry=('bzrlib.send', 'format_registry')),
 
4843
        RegistryOption.from_kwargs('format',
 
4844
        'Use the specified output format.',
 
4845
        **{'4': 'Bundle format 4, Merge Directive 2 (default)',
 
4846
           '0.9': 'Bundle format 0.9, Merge Directive 1',})
5149
4847
        ]
5150
4848
 
5151
4849
    def run(self, submit_branch=None, public_branch=None, no_bundle=False,
5152
4850
            no_patch=False, revision=None, remember=False, output=None,
5153
 
            format=None, mail_to=None, message=None, body=None,
5154
 
            strict=None, **kwargs):
5155
 
        from bzrlib.send import send
5156
 
        return send(submit_branch, revision, public_branch, remember,
5157
 
                    format, no_bundle, no_patch, output,
5158
 
                    kwargs.get('from', '.'), mail_to, message, body,
5159
 
                    self.outf,
5160
 
                    strict=strict)
 
4851
            format='4', mail_to=None, message=None, body=None, **kwargs):
 
4852
        return self._run(submit_branch, revision, public_branch, remember,
 
4853
                         format, no_bundle, no_patch, output,
 
4854
                         kwargs.get('from', '.'), mail_to, message, body)
 
4855
 
 
4856
    def _run(self, submit_branch, revision, public_branch, remember, format,
 
4857
             no_bundle, no_patch, output, from_, mail_to, message, body):
 
4858
        from bzrlib.revision import NULL_REVISION
 
4859
        branch = Branch.open_containing(from_)[0]
 
4860
        if output is None:
 
4861
            outfile = cStringIO.StringIO()
 
4862
        elif output == '-':
 
4863
            outfile = self.outf
 
4864
        else:
 
4865
            outfile = open(output, 'wb')
 
4866
        # we may need to write data into branch's repository to calculate
 
4867
        # the data to send.
 
4868
        branch.lock_write()
 
4869
        try:
 
4870
            if output is None:
 
4871
                config = branch.get_config()
 
4872
                if mail_to is None:
 
4873
                    mail_to = config.get_user_option('submit_to')
 
4874
                mail_client = config.get_mail_client()
 
4875
                if (not getattr(mail_client, 'supports_body', False)
 
4876
                    and body is not None):
 
4877
                    raise errors.BzrCommandError(
 
4878
                        'Mail client "%s" does not support specifying body' %
 
4879
                        mail_client.__class__.__name__)
 
4880
            if remember and submit_branch is None:
 
4881
                raise errors.BzrCommandError(
 
4882
                    '--remember requires a branch to be specified.')
 
4883
            stored_submit_branch = branch.get_submit_branch()
 
4884
            remembered_submit_branch = None
 
4885
            if submit_branch is None:
 
4886
                submit_branch = stored_submit_branch
 
4887
                remembered_submit_branch = "submit"
 
4888
            else:
 
4889
                if stored_submit_branch is None or remember:
 
4890
                    branch.set_submit_branch(submit_branch)
 
4891
            if submit_branch is None:
 
4892
                submit_branch = branch.get_parent()
 
4893
                remembered_submit_branch = "parent"
 
4894
            if submit_branch is None:
 
4895
                raise errors.BzrCommandError('No submit branch known or'
 
4896
                                             ' specified')
 
4897
            if remembered_submit_branch is not None:
 
4898
                note('Using saved %s location "%s" to determine what '
 
4899
                        'changes to submit.', remembered_submit_branch,
 
4900
                        submit_branch)
 
4901
 
 
4902
            if mail_to is None:
 
4903
                submit_config = Branch.open(submit_branch).get_config()
 
4904
                mail_to = submit_config.get_user_option("child_submit_to")
 
4905
 
 
4906
            stored_public_branch = branch.get_public_branch()
 
4907
            if public_branch is None:
 
4908
                public_branch = stored_public_branch
 
4909
            elif stored_public_branch is None or remember:
 
4910
                branch.set_public_branch(public_branch)
 
4911
            if no_bundle and public_branch is None:
 
4912
                raise errors.BzrCommandError('No public branch specified or'
 
4913
                                             ' known')
 
4914
            base_revision_id = None
 
4915
            revision_id = None
 
4916
            if revision is not None:
 
4917
                if len(revision) > 2:
 
4918
                    raise errors.BzrCommandError('bzr send takes '
 
4919
                        'at most two one revision identifiers')
 
4920
                revision_id = revision[-1].as_revision_id(branch)
 
4921
                if len(revision) == 2:
 
4922
                    base_revision_id = revision[0].as_revision_id(branch)
 
4923
            if revision_id is None:
 
4924
                revision_id = branch.last_revision()
 
4925
            if revision_id == NULL_REVISION:
 
4926
                raise errors.BzrCommandError('No revisions to submit.')
 
4927
            if format == '4':
 
4928
                directive = merge_directive.MergeDirective2.from_objects(
 
4929
                    branch.repository, revision_id, time.time(),
 
4930
                    osutils.local_time_offset(), submit_branch,
 
4931
                    public_branch=public_branch, include_patch=not no_patch,
 
4932
                    include_bundle=not no_bundle, message=message,
 
4933
                    base_revision_id=base_revision_id)
 
4934
            elif format == '0.9':
 
4935
                if not no_bundle:
 
4936
                    if not no_patch:
 
4937
                        patch_type = 'bundle'
 
4938
                    else:
 
4939
                        raise errors.BzrCommandError('Format 0.9 does not'
 
4940
                            ' permit bundle with no patch')
 
4941
                else:
 
4942
                    if not no_patch:
 
4943
                        patch_type = 'diff'
 
4944
                    else:
 
4945
                        patch_type = None
 
4946
                directive = merge_directive.MergeDirective.from_objects(
 
4947
                    branch.repository, revision_id, time.time(),
 
4948
                    osutils.local_time_offset(), submit_branch,
 
4949
                    public_branch=public_branch, patch_type=patch_type,
 
4950
                    message=message)
 
4951
 
 
4952
            outfile.writelines(directive.to_lines())
 
4953
            if output is None:
 
4954
                subject = '[MERGE] '
 
4955
                if message is not None:
 
4956
                    subject += message
 
4957
                else:
 
4958
                    revision = branch.repository.get_revision(revision_id)
 
4959
                    subject += revision.get_summary()
 
4960
                basename = directive.get_disk_name(branch)
 
4961
                mail_client.compose_merge_request(mail_to, subject,
 
4962
                                                  outfile.getvalue(),
 
4963
                                                  basename, body)
 
4964
        finally:
 
4965
            if output != '-':
 
4966
                outfile.close()
 
4967
            branch.unlock()
5161
4968
 
5162
4969
 
5163
4970
class cmd_bundle_revisions(cmd_send):
 
4971
 
5164
4972
    """Create a merge-directive for submitting changes.
5165
4973
 
5166
4974
    A merge directive provides many things needed for requesting merges:
5207
5015
               type=unicode),
5208
5016
        Option('output', short_name='o', help='Write directive to this file.',
5209
5017
               type=unicode),
5210
 
        Option('strict',
5211
 
               help='Refuse to bundle revisions if there are uncommitted'
5212
 
               ' changes in the working tree, --no-strict disables the check.'),
5213
5018
        'revision',
5214
 
        RegistryOption('format',
5215
 
                       help='Use the specified output format.',
5216
 
                       lazy_registry=('bzrlib.send', 'format_registry')),
 
5019
        RegistryOption.from_kwargs('format',
 
5020
        'Use the specified output format.',
 
5021
        **{'4': 'Bundle format 4, Merge Directive 2 (default)',
 
5022
           '0.9': 'Bundle format 0.9, Merge Directive 1',})
5217
5023
        ]
5218
5024
    aliases = ['bundle']
5219
5025
 
5223
5029
 
5224
5030
    def run(self, submit_branch=None, public_branch=None, no_bundle=False,
5225
5031
            no_patch=False, revision=None, remember=False, output=None,
5226
 
            format=None, strict=None, **kwargs):
 
5032
            format='4', **kwargs):
5227
5033
        if output is None:
5228
5034
            output = '-'
5229
 
        from bzrlib.send import send
5230
 
        return send(submit_branch, revision, public_branch, remember,
 
5035
        return self._run(submit_branch, revision, public_branch, remember,
5231
5036
                         format, no_bundle, no_patch, output,
5232
 
                         kwargs.get('from', '.'), None, None, None,
5233
 
                         self.outf, strict=strict)
 
5037
                         kwargs.get('from', '.'), None, None, None)
5234
5038
 
5235
5039
 
5236
5040
class cmd_tag(Command):
5275
5079
            ):
5276
5080
        branch, relpath = Branch.open_containing(directory)
5277
5081
        branch.lock_write()
5278
 
        self.add_cleanup(branch.unlock)
5279
 
        if delete:
5280
 
            branch.tags.delete_tag(tag_name)
5281
 
            self.outf.write('Deleted tag %s.\n' % tag_name)
5282
 
        else:
5283
 
            if revision:
5284
 
                if len(revision) != 1:
5285
 
                    raise errors.BzrCommandError(
5286
 
                        "Tags can only be placed on a single revision, "
5287
 
                        "not on a range")
5288
 
                revision_id = revision[0].as_revision_id(branch)
 
5082
        try:
 
5083
            if delete:
 
5084
                branch.tags.delete_tag(tag_name)
 
5085
                self.outf.write('Deleted tag %s.\n' % tag_name)
5289
5086
            else:
5290
 
                revision_id = branch.last_revision()
5291
 
            if (not force) and branch.tags.has_tag(tag_name):
5292
 
                raise errors.TagAlreadyExists(tag_name)
5293
 
            branch.tags.set_tag(tag_name, revision_id)
5294
 
            self.outf.write('Created tag %s.\n' % tag_name)
 
5087
                if revision:
 
5088
                    if len(revision) != 1:
 
5089
                        raise errors.BzrCommandError(
 
5090
                            "Tags can only be placed on a single revision, "
 
5091
                            "not on a range")
 
5092
                    revision_id = revision[0].as_revision_id(branch)
 
5093
                else:
 
5094
                    revision_id = branch.last_revision()
 
5095
                if (not force) and branch.tags.has_tag(tag_name):
 
5096
                    raise errors.TagAlreadyExists(tag_name)
 
5097
                branch.tags.set_tag(tag_name, revision_id)
 
5098
                self.outf.write('Created tag %s.\n' % tag_name)
 
5099
        finally:
 
5100
            branch.unlock()
5295
5101
 
5296
5102
 
5297
5103
class cmd_tags(Command):
5329
5135
        if not tags:
5330
5136
            return
5331
5137
 
5332
 
        branch.lock_read()
5333
 
        self.add_cleanup(branch.unlock)
5334
5138
        if revision:
5335
 
            graph = branch.repository.get_graph()
5336
 
            rev1, rev2 = _get_revision_range(revision, branch, self.name())
5337
 
            revid1, revid2 = rev1.rev_id, rev2.rev_id
5338
 
            # only show revisions between revid1 and revid2 (inclusive)
5339
 
            tags = [(tag, revid) for tag, revid in tags if
5340
 
                graph.is_between(revid, revid1, revid2)]
 
5139
            branch.lock_read()
 
5140
            try:
 
5141
                graph = branch.repository.get_graph()
 
5142
                rev1, rev2 = _get_revision_range(revision, branch, self.name())
 
5143
                revid1, revid2 = rev1.rev_id, rev2.rev_id
 
5144
                # only show revisions between revid1 and revid2 (inclusive)
 
5145
                tags = [(tag, revid) for tag, revid in tags if
 
5146
                    graph.is_between(revid, revid1, revid2)]
 
5147
            finally:
 
5148
                branch.unlock()
5341
5149
        if sort == 'alpha':
5342
5150
            tags.sort()
5343
5151
        elif sort == 'time':
5353
5161
            tags.sort(key=lambda x: timestamps[x[1]])
5354
5162
        if not show_ids:
5355
5163
            # [ (tag, revid), ... ] -> [ (tag, dotted_revno), ... ]
5356
 
            for index, (tag, revid) in enumerate(tags):
5357
 
                try:
5358
 
                    revno = branch.revision_id_to_dotted_revno(revid)
5359
 
                    if isinstance(revno, tuple):
5360
 
                        revno = '.'.join(map(str, revno))
5361
 
                except errors.NoSuchRevision:
5362
 
                    # Bad tag data/merges can lead to tagged revisions
5363
 
                    # which are not in this branch. Fail gracefully ...
5364
 
                    revno = '?'
5365
 
                tags[index] = (tag, revno)
5366
 
        self.cleanup_now()
 
5164
            revno_map = branch.get_revision_id_to_revno_map()
 
5165
            tags = [ (tag, '.'.join(map(str, revno_map.get(revid, ('?',)))))
 
5166
                        for tag, revid in tags ]
5367
5167
        for tag, revspec in tags:
5368
5168
            self.outf.write('%-20s %s\n' % (tag, revspec))
5369
5169
 
5405
5205
            ),
5406
5206
        Option('bind-to', help='Branch to bind checkout to.', type=str),
5407
5207
        Option('force',
5408
 
            help='Perform reconfiguration even if local changes'
5409
 
            ' will be lost.'),
5410
 
        Option('stacked-on',
5411
 
            help='Reconfigure a branch to be stacked on another branch.',
5412
 
            type=unicode,
5413
 
            ),
5414
 
        Option('unstacked',
5415
 
            help='Reconfigure a branch to be unstacked.  This '
5416
 
                'may require copying substantial data into it.',
5417
 
            ),
 
5208
               help='Perform reconfiguration even if local changes'
 
5209
               ' will be lost.')
5418
5210
        ]
5419
5211
 
5420
 
    def run(self, location=None, target_type=None, bind_to=None, force=False,
5421
 
            stacked_on=None,
5422
 
            unstacked=None):
 
5212
    def run(self, location=None, target_type=None, bind_to=None, force=False):
5423
5213
        directory = bzrdir.BzrDir.open(location)
5424
 
        if stacked_on and unstacked:
5425
 
            raise BzrCommandError("Can't use both --stacked-on and --unstacked")
5426
 
        elif stacked_on is not None:
5427
 
            reconfigure.ReconfigureStackedOn().apply(directory, stacked_on)
5428
 
        elif unstacked:
5429
 
            reconfigure.ReconfigureUnstacked().apply(directory)
5430
 
        # At the moment you can use --stacked-on and a different
5431
 
        # reconfiguration shape at the same time; there seems no good reason
5432
 
        # to ban it.
5433
5214
        if target_type is None:
5434
 
            if stacked_on or unstacked:
5435
 
                return
5436
 
            else:
5437
 
                raise errors.BzrCommandError('No target configuration '
5438
 
                    'specified')
 
5215
            raise errors.BzrCommandError('No target configuration specified')
5439
5216
        elif target_type == 'branch':
5440
5217
            reconfiguration = reconfigure.Reconfigure.to_branch(directory)
5441
5218
        elif target_type == 'tree':
5478
5255
    /path/to/newbranch.
5479
5256
 
5480
5257
    Bound branches use the nickname of its master branch unless it is set
5481
 
    locally, in which case switching will update the local nickname to be
 
5258
    locally, in which case switching will update the the local nickname to be
5482
5259
    that of the master.
5483
5260
    """
5484
5261
 
5485
 
    takes_args = ['to_location?']
 
5262
    takes_args = ['to_location']
5486
5263
    takes_options = [Option('force',
5487
 
                        help='Switch even if local commits will be lost.'),
5488
 
                     'revision',
5489
 
                     Option('create-branch', short_name='b',
5490
 
                        help='Create the target branch from this one before'
5491
 
                             ' switching to it.'),
5492
 
                    ]
 
5264
                        help='Switch even if local commits will be lost.')
 
5265
                     ]
5493
5266
 
5494
 
    def run(self, to_location=None, force=False, create_branch=False,
5495
 
            revision=None):
 
5267
    def run(self, to_location, force=False):
5496
5268
        from bzrlib import switch
5497
5269
        tree_location = '.'
5498
 
        revision = _get_one_revision('switch', revision)
5499
5270
        control_dir = bzrdir.BzrDir.open_containing(tree_location)[0]
5500
 
        if to_location is None:
5501
 
            if revision is None:
5502
 
                raise errors.BzrCommandError('You must supply either a'
5503
 
                                             ' revision or a location')
5504
 
            to_location = '.'
 
5271
        branch = control_dir.open_branch()
5505
5272
        try:
5506
 
            branch = control_dir.open_branch()
5507
 
            had_explicit_nick = branch.get_config().has_explicit_nickname()
 
5273
            to_branch = Branch.open(to_location)
5508
5274
        except errors.NotBranchError:
5509
 
            branch = None
5510
 
            had_explicit_nick = False
5511
 
        if create_branch:
5512
 
            if branch is None:
5513
 
                raise errors.BzrCommandError('cannot create branch without'
5514
 
                                             ' source branch')
5515
 
            to_location = directory_service.directories.dereference(
5516
 
                              to_location)
5517
 
            if '/' not in to_location and '\\' not in to_location:
5518
 
                # This path is meant to be relative to the existing branch
5519
 
                this_url = self._get_branch_location(control_dir)
5520
 
                to_location = urlutils.join(this_url, '..', to_location)
5521
 
            to_branch = branch.bzrdir.sprout(to_location,
5522
 
                                 possible_transports=[branch.bzrdir.root_transport],
5523
 
                                 source_branch=branch).open_branch()
5524
 
        else:
5525
 
            try:
5526
 
                to_branch = Branch.open(to_location)
5527
 
            except errors.NotBranchError:
5528
 
                this_url = self._get_branch_location(control_dir)
5529
 
                to_branch = Branch.open(
5530
 
                    urlutils.join(this_url, '..', to_location))
5531
 
        if revision is not None:
5532
 
            revision = revision.as_revision_id(to_branch)
5533
 
        switch.switch(control_dir, to_branch, force, revision_id=revision)
5534
 
        if had_explicit_nick:
 
5275
            this_branch = control_dir.open_branch()
 
5276
            # This may be a heavy checkout, where we want the master branch
 
5277
            this_url = this_branch.get_bound_location()
 
5278
            # If not, use a local sibling
 
5279
            if this_url is None:
 
5280
                this_url = this_branch.base
 
5281
            to_branch = Branch.open(
 
5282
                urlutils.join(this_url, '..', to_location))
 
5283
        switch.switch(control_dir, to_branch, force)
 
5284
        if branch.get_config().has_explicit_nickname():
5535
5285
            branch = control_dir.open_branch() #get the new branch!
5536
5286
            branch.nick = to_branch.nick
5537
5287
        note('Switched to branch: %s',
5538
5288
            urlutils.unescape_for_display(to_branch.base, 'utf-8'))
5539
5289
 
5540
 
    def _get_branch_location(self, control_dir):
5541
 
        """Return location of branch for this control dir."""
5542
 
        try:
5543
 
            this_branch = control_dir.open_branch()
5544
 
            # This may be a heavy checkout, where we want the master branch
5545
 
            master_location = this_branch.get_bound_location()
5546
 
            if master_location is not None:
5547
 
                return master_location
5548
 
            # If not, use a local sibling
5549
 
            return this_branch.base
5550
 
        except errors.NotBranchError:
5551
 
            format = control_dir.find_branch_format()
5552
 
            if getattr(format, 'get_reference', None) is not None:
5553
 
                return format.get_reference(control_dir)
5554
 
            else:
5555
 
                return control_dir.root_transport.base
5556
 
 
5557
5290
 
5558
5291
class cmd_view(Command):
5559
5292
    """Manage filtered views.
5778
5511
        if writer is None:
5779
5512
            writer = bzrlib.option.diff_writer_registry.get()
5780
5513
        try:
5781
 
            shelver = Shelver.from_args(writer(sys.stdout), revision, all,
5782
 
                file_list, message, destroy=destroy)
5783
 
            try:
5784
 
                shelver.run()
5785
 
            finally:
5786
 
                shelver.finalize()
 
5514
            Shelver.from_args(writer(sys.stdout), revision, all, file_list,
 
5515
                              message, destroy=destroy).run()
5787
5516
        except errors.UserAbort:
5788
5517
            return 0
5789
5518
 
5790
5519
    def run_for_list(self):
5791
5520
        tree = WorkingTree.open_containing('.')[0]
5792
5521
        tree.lock_read()
5793
 
        self.add_cleanup(tree.unlock)
5794
 
        manager = tree.get_shelf_manager()
5795
 
        shelves = manager.active_shelves()
5796
 
        if len(shelves) == 0:
5797
 
            note('No shelved changes.')
5798
 
            return 0
5799
 
        for shelf_id in reversed(shelves):
5800
 
            message = manager.get_metadata(shelf_id).get('message')
5801
 
            if message is None:
5802
 
                message = '<no message>'
5803
 
            self.outf.write('%3d: %s\n' % (shelf_id, message))
5804
 
        return 1
 
5522
        try:
 
5523
            manager = tree.get_shelf_manager()
 
5524
            shelves = manager.active_shelves()
 
5525
            if len(shelves) == 0:
 
5526
                note('No shelved changes.')
 
5527
                return 0
 
5528
            for shelf_id in reversed(shelves):
 
5529
                message = manager.get_metadata(shelf_id).get('message')
 
5530
                if message is None:
 
5531
                    message = '<no message>'
 
5532
                self.outf.write('%3d: %s\n' % (shelf_id, message))
 
5533
            return 1
 
5534
        finally:
 
5535
            tree.unlock()
5805
5536
 
5806
5537
 
5807
5538
class cmd_unshelve(Command):
5819
5550
            enum_switch=False, value_switches=True,
5820
5551
            apply="Apply changes and remove from the shelf.",
5821
5552
            dry_run="Show changes, but do not apply or remove them.",
5822
 
            preview="Instead of unshelving the changes, show the diff that "
5823
 
                    "would result from unshelving.",
5824
 
            delete_only="Delete changes without applying them.",
5825
 
            keep="Apply changes but don't delete them.",
 
5553
            delete_only="Delete changes without applying them."
5826
5554
        )
5827
5555
    ]
5828
5556
    _see_also = ['shelve']
5829
5557
 
5830
5558
    def run(self, shelf_id=None, action='apply'):
5831
5559
        from bzrlib.shelf_ui import Unshelver
5832
 
        unshelver = Unshelver.from_args(shelf_id, action)
5833
 
        try:
5834
 
            unshelver.run()
5835
 
        finally:
5836
 
            unshelver.tree.unlock()
 
5560
        Unshelver.from_args(shelf_id, action).run()
5837
5561
 
5838
5562
 
5839
5563
class cmd_clean_tree(Command):
5870
5594
                   dry_run=dry_run, no_prompt=force)
5871
5595
 
5872
5596
 
5873
 
class cmd_reference(Command):
5874
 
    """list, view and set branch locations for nested trees.
5875
 
 
5876
 
    If no arguments are provided, lists the branch locations for nested trees.
5877
 
    If one argument is provided, display the branch location for that tree.
5878
 
    If two arguments are provided, set the branch location for that tree.
5879
 
    """
5880
 
 
5881
 
    hidden = True
5882
 
 
5883
 
    takes_args = ['path?', 'location?']
5884
 
 
5885
 
    def run(self, path=None, location=None):
5886
 
        branchdir = '.'
5887
 
        if path is not None:
5888
 
            branchdir = path
5889
 
        tree, branch, relpath =(
5890
 
            bzrdir.BzrDir.open_containing_tree_or_branch(branchdir))
5891
 
        if path is not None:
5892
 
            path = relpath
5893
 
        if tree is None:
5894
 
            tree = branch.basis_tree()
5895
 
        if path is None:
5896
 
            info = branch._get_all_reference_info().iteritems()
5897
 
            self._display_reference_info(tree, branch, info)
 
5597
def _create_prefix(cur_transport):
 
5598
    needed = [cur_transport]
 
5599
    # Recurse upwards until we can create a directory successfully
 
5600
    while True:
 
5601
        new_transport = cur_transport.clone('..')
 
5602
        if new_transport.base == cur_transport.base:
 
5603
            raise errors.BzrCommandError(
 
5604
                "Failed to create path prefix for %s."
 
5605
                % cur_transport.base)
 
5606
        try:
 
5607
            new_transport.mkdir('.')
 
5608
        except errors.NoSuchFile:
 
5609
            needed.append(new_transport)
 
5610
            cur_transport = new_transport
5898
5611
        else:
5899
 
            file_id = tree.path2id(path)
5900
 
            if file_id is None:
5901
 
                raise errors.NotVersionedError(path)
5902
 
            if location is None:
5903
 
                info = [(file_id, branch.get_reference_info(file_id))]
5904
 
                self._display_reference_info(tree, branch, info)
5905
 
            else:
5906
 
                branch.set_reference_info(file_id, path, location)
5907
 
 
5908
 
    def _display_reference_info(self, tree, branch, info):
5909
 
        ref_list = []
5910
 
        for file_id, (path, location) in info:
5911
 
            try:
5912
 
                path = tree.id2path(file_id)
5913
 
            except errors.NoSuchId:
5914
 
                pass
5915
 
            ref_list.append((path, location))
5916
 
        for path, location in sorted(ref_list):
5917
 
            self.outf.write('%s %s\n' % (path, location))
 
5612
            break
 
5613
    # Now we only need to create child directories
 
5614
    while needed:
 
5615
        cur_transport = needed.pop()
 
5616
        cur_transport.ensure_base()
5918
5617
 
5919
5618
 
5920
5619
# these get imported and then picked up by the scan for cmd_*
5927
5626
from bzrlib.bundle.commands import (
5928
5627
    cmd_bundle_info,
5929
5628
    )
5930
 
from bzrlib.foreign import cmd_dpush
5931
5629
from bzrlib.sign_my_commits import cmd_sign_my_commits
 
5630
from bzrlib.weave_commands import cmd_versionedfile_list, \
 
5631
        cmd_weave_plan_merge, cmd_weave_merge_text