~bzr-pqm/bzr/bzr.dev

# Copyright (C) 2006-2010 Canonical Ltd

#

# This program is free software; you can redistribute it and/or modify

# it under the terms of the GNU General Public License as published by

# the Free Software Foundation; either version 2 of the License, or

# (at your option) any later version.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

"""Black-box tests for bzr log."""

from itertools import izip

import os

from bzrlib import (

    branchbuilder,

    errors,

    log,

    osutils,

    tests,

    )

from bzrlib.tests import (

    test_log,

    features,

    )

class TestLog(tests.TestCaseWithTransport, test_log.TestLogMixin):

    def make_minimal_branch(self, path='.', format=None):

        tree = self.make_branch_and_tree(path, format=format)

        self.build_tree([path + '/hello.txt'])

        tree.add('hello.txt')

        tree.commit(message='message1')

        return tree

    def make_linear_branch(self, path='.', format=None):

        tree = self.make_branch_and_tree(path, format=format)

        self.build_tree(

            [path + '/hello.txt', path + '/goodbye.txt', path + '/meep.txt'])

        tree.add('hello.txt')

        tree.commit(message='message1')

        tree.add('goodbye.txt')

        tree.commit(message='message2')

        tree.add('meep.txt')

        tree.commit(message='message3')

        return tree

    def make_merged_branch(self, path='.', format=None):

        tree = self.make_linear_branch(path, format)

        tree2 = tree.bzrdir.sprout('tree2',

            revision_id=tree.branch.get_rev_id(1)).open_workingtree()

        tree2.commit(message='tree2 message2')

        tree2.commit(message='tree2 message3')

        tree.merge_from_branch(tree2.branch)

        tree.commit(message='merge')

        return tree

class TestLogWithLogCatcher(TestLog):

    def setUp(self):

        super(TestLogWithLogCatcher, self).setUp()

        # Capture log formatter creations

        class MyLogFormatter(test_log.LogCatcher):

            def __new__(klass, *args, **kwargs):

                self.log_catcher = test_log.LogCatcher(*args, **kwargs)

                # Always return our own log formatter

                return self.log_catcher

        # Break cycle with closure over self on cleanup by removing method

        self.addCleanup(setattr, MyLogFormatter, "__new__", None)

        def getme(branch):

                # Always return our own log formatter class hijacking the

                # default behavior (which requires setting up a config

                # variable)

            return MyLogFormatter

        self.overrideAttr(log.log_formatter_registry, 'get_default', getme)

    def get_captured_revisions(self):

        return self.log_catcher.revisions

    def assertLogRevnos(self, args, expected_revnos, working_dir='.',

                        out='', err=''):

        actual_out, actual_err = self.run_bzr(['log'] + args,

                                              working_dir=working_dir)

        self.assertEqual(out, actual_out)

        self.assertEqual(err, actual_err)

        self.assertEqual(expected_revnos,

                         [r.revno for r in self.get_captured_revisions()])

    def assertLogRevnosAndDepths(self, args, expected_revnos_and_depths,

                                working_dir='.'):

        self.run_bzr(['log'] + args, working_dir=working_dir)

        self.assertEqual(expected_revnos_and_depths,

                         [(r.revno, r.merge_depth)

                           for r in self.get_captured_revisions()])

class TestLogRevSpecs(TestLogWithLogCatcher):

    def test_log_no_revspec(self):

        self.make_linear_branch()

        self.assertLogRevnos([], ['3', '2', '1'])

    def test_log_null_end_revspec(self):

        self.make_linear_branch()

        self.assertLogRevnos(['-r1..'], ['3', '2', '1'])

    def test_log_null_begin_revspec(self):

        self.make_linear_branch()

        self.assertLogRevnos(['-r..3'], ['3', '2', '1'])

    def test_log_null_both_revspecs(self):

        self.make_linear_branch()

        self.assertLogRevnos(['-r..'], ['3', '2', '1'])

    def test_log_negative_begin_revspec_full_log(self):

        self.make_linear_branch()

        self.assertLogRevnos(['-r-3..'], ['3', '2', '1'])

    def test_log_negative_both_revspec_full_log(self):

        self.make_linear_branch()

        self.assertLogRevnos(['-r-3..-1'], ['3', '2', '1'])

    def test_log_negative_both_revspec_partial(self):

        self.make_linear_branch()

        self.assertLogRevnos(['-r-3..-2'], ['2', '1'])

    def test_log_negative_begin_revspec(self):

        self.make_linear_branch()

        self.assertLogRevnos(['-r-2..'], ['3', '2'])

    def test_log_positive_revspecs(self):

        self.make_linear_branch()

        self.assertLogRevnos(['-r1..3'], ['3', '2', '1'])

    def test_log_dotted_revspecs(self):

        self.make_merged_branch()

        self.assertLogRevnos(['-n0', '-r1..1.1.1'], ['1.1.1', '1'])

    def test_log_limit(self):

        tree = self.make_branch_and_tree('.')

        # We want more commits than our batch size starts at

        for pos in range(10):

            tree.commit("%s" % pos)

        self.assertLogRevnos(['--limit', '2'], ['10', '9'])

    def test_log_limit_short(self):

        self.make_linear_branch()

        self.assertLogRevnos(['-l', '2'], ['3', '2'])

    def test_log_change_revno(self):

        self.make_linear_branch()

        self.assertLogRevnos(['-c1'], ['1'])

    def test_branch_revspec(self):

        foo = self.make_branch_and_tree('foo')

        bar = self.make_branch_and_tree('bar')

        self.build_tree(['foo/foo.txt', 'bar/bar.txt'])

        foo.add('foo.txt')

        bar.add('bar.txt')

        foo.commit(message='foo')

        bar.commit(message='bar')

        self.run_bzr('log -r branch:../bar', working_dir='foo')

        self.assertEqual([bar.branch.get_rev_id(1)],

                         [r.rev.revision_id

                          for r in self.get_captured_revisions()])

class TestLogExcludeCommonAncestry(TestLogWithLogCatcher):

    def test_exclude_common_ancestry_simple_revnos(self):

        self.make_linear_branch()

        self.assertLogRevnos(['-r1..3', '--exclude-common-ancestry'],

                             ['3', '2'])

class TestLogMergedLinearAncestry(TestLogWithLogCatcher):

    def setUp(self):

        super(TestLogMergedLinearAncestry, self).setUp()

        # FIXME: Using a MemoryTree would be even better here (but until we

        # stop calling run_bzr, there is no point) --vila 100118.

        builder = branchbuilder.BranchBuilder(self.get_transport())

        builder.start_series()

        # 1

        # | \

        # 2  1.1.1

        # | / |

        # 3  1.1.2

        # |   |

        # |  1.1.3

        # | / |

        # 4  1.1.4

        # | /

        # 5

        # mainline

        builder.build_snapshot('1', None, [

            ('add', ('', 'root-id', 'directory', ''))])

        builder.build_snapshot('2', ['1'], [])

        # branch

        builder.build_snapshot('1.1.1', ['1'], [])

        # merge branch into mainline

        builder.build_snapshot('3', ['2', '1.1.1'], [])

        # new commits in branch

        builder.build_snapshot('1.1.2', ['1.1.1'], [])

        builder.build_snapshot('1.1.3', ['1.1.2'], [])

        # merge branch into mainline

        builder.build_snapshot('4', ['3', '1.1.3'], [])

        # merge mainline into branch

        builder.build_snapshot('1.1.4', ['1.1.3', '4'], [])

        # merge branch into mainline

        builder.build_snapshot('5', ['4', '1.1.4'], [])

        builder.finish_series()

    def test_n0(self):

        self.assertLogRevnos(['-n0', '-r1.1.1..1.1.4'],

                             ['1.1.4', '4', '1.1.3', '1.1.2', '3', '1.1.1'])

    def test_n0_forward(self):

        self.assertLogRevnos(['-n0', '-r1.1.1..1.1.4', '--forward'],

                             ['3', '1.1.1', '4', '1.1.2', '1.1.3', '1.1.4'])

    def test_n1(self):

        # starting from 1.1.4 we follow the left-hand ancestry

        self.assertLogRevnos(['-n1', '-r1.1.1..1.1.4'],

                             ['1.1.4', '1.1.3', '1.1.2', '1.1.1'])

    def test_n1_forward(self):

        self.assertLogRevnos(['-n1', '-r1.1.1..1.1.4', '--forward'],

                             ['1.1.1', '1.1.2', '1.1.3', '1.1.4'])

class Test_GenerateAllRevisions(TestLogWithLogCatcher):

    def setUp(self):

        super(Test_GenerateAllRevisions, self).setUp()

        builder = self.make_branch_with_many_merges()

        b = builder.get_branch()

        b.lock_read()

        self.addCleanup(b.unlock)

        self.branch = b

    def make_branch_with_many_merges(self, path='.', format=None):

        builder = branchbuilder.BranchBuilder(self.get_transport())

        builder.start_series()

        # The graph below may look a bit complicated (and it may be but I've

        # banged my head enough on it) but the bug requires at least dotted

        # revnos *and* merged revisions below that.

        builder.build_snapshot('1', None, [

            ('add', ('', 'root-id', 'directory', ''))])

        builder.build_snapshot('2', ['1'], [])

        builder.build_snapshot('1.1.1', ['1'], [])

        builder.build_snapshot('2.1.1', ['2'], [])

        builder.build_snapshot('3', ['2', '1.1.1'], [])

        builder.build_snapshot('2.1.2', ['2.1.1'], [])

        builder.build_snapshot('2.2.1', ['2.1.1'], [])

        builder.build_snapshot('2.1.3', ['2.1.2', '2.2.1'], [])

        builder.build_snapshot('4', ['3', '2.1.3'], [])

        builder.build_snapshot('5', ['4', '2.1.2'], [])

        builder.finish_series()

        return builder

    def test_not_an_ancestor(self):

        self.assertRaises(errors.BzrCommandError,

                          log._generate_all_revisions,

                          self.branch, '1.1.1', '2.1.3', 'reverse',

                          delayed_graph_generation=True)

    def test_wrong_order(self):

        self.assertRaises(errors.BzrCommandError,

                          log._generate_all_revisions,

                          self.branch, '5', '2.1.3', 'reverse',

                          delayed_graph_generation=True)

    def test_no_start_rev_id_with_end_rev_id_being_a_merge(self):

        revs = log._generate_all_revisions(

            self.branch, None, '2.1.3',

            'reverse', delayed_graph_generation=True)

class TestLogRevSpecsWithPaths(TestLogWithLogCatcher):

    def test_log_revno_n_path_wrong_namespace(self):

        self.make_linear_branch('branch1')

        self.make_linear_branch('branch2')

        # There is no guarantee that a path exist between two arbitrary

        # revisions.

        self.run_bzr("log -r revno:2:branch1..revno:3:branch2", retcode=3)

    def test_log_revno_n_path_correct_order(self):

        self.make_linear_branch('branch2')

        self.assertLogRevnos(['-rrevno:1:branch2..revno:3:branch2'],

                             ['3', '2','1'])

    def test_log_revno_n_path(self):

        self.make_linear_branch('branch2')

        self.assertLogRevnos(['-rrevno:1:branch2'],

                             ['1'])

        rev_props = self.log_catcher.revisions[0].rev.properties

        self.assertEqual('branch2', rev_props['branch-nick'])

class TestLogErrors(TestLog):

    def test_log_zero_revspec(self):

        self.make_minimal_branch()

        self.run_bzr_error(['bzr: ERROR: Logging revision 0 is invalid.'],

                           ['log', '-r0'])

    def test_log_zero_begin_revspec(self):

        self.make_linear_branch()

        self.run_bzr_error(['bzr: ERROR: Logging revision 0 is invalid.'],

                           ['log', '-r0..2'])

    def test_log_zero_end_revspec(self):

        self.make_linear_branch()

        self.run_bzr_error(['bzr: ERROR: Logging revision 0 is invalid.'],

                           ['log', '-r-2..0'])

    def test_log_nonexistent_revno(self):

        self.make_minimal_branch()

        self.run_bzr_error(["bzr: ERROR: Requested revision: '1234' "

                            "does not exist in branch:"],

                           ['log', '-r1234'])

    def test_log_nonexistent_dotted_revno(self):

        self.make_minimal_branch()

        self.run_bzr_error(["bzr: ERROR: Requested revision: '123.123' "

                            "does not exist in branch:"],

                           ['log',  '-r123.123'])

    def test_log_change_nonexistent_revno(self):

        self.make_minimal_branch()

        self.run_bzr_error(["bzr: ERROR: Requested revision: '1234' "

                            "does not exist in branch:"],

                           ['log',  '-c1234'])

    def test_log_change_nonexistent_dotted_revno(self):

        self.make_minimal_branch()

        self.run_bzr_error(["bzr: ERROR: Requested revision: '123.123' "

                            "does not exist in branch:"],

                           ['log', '-c123.123'])

    def test_log_change_single_revno_only(self):

        self.make_minimal_branch()

        self.run_bzr_error(['bzr: ERROR: Option --change does not'

                           ' accept revision ranges'],

                           ['log', '--change', '2..3'])

    def test_log_change_incompatible_with_revision(self):

        self.run_bzr_error(['bzr: ERROR: --revision and --change'

                           ' are mutually exclusive'],

                           ['log', '--change', '2', '--revision', '3'])

    def test_log_nonexistent_file(self):

        self.make_minimal_branch()

        # files that don't exist in either the basis tree or working tree

        # should give an error

        out, err = self.run_bzr('log does-not-exist', retcode=3)

        self.assertContainsRe(err,

                              'Path unknown at end or start of revision range: '

                              'does-not-exist')

    def test_log_reversed_revspecs(self):

        self.make_linear_branch()

        self.run_bzr_error(('bzr: ERROR: Start revision must be older than '

                            'the end revision.\n',),

                           ['log', '-r3..1'])

    def test_log_reversed_dotted_revspecs(self):

        self.make_merged_branch()

        self.run_bzr_error(('bzr: ERROR: Start revision not found in '

                            'left-hand history of end revision.\n',),

                           "log -r 1.1.1..1")

    def test_log_bad_message_re(self):

        """Bad --message argument gives a sensible message

        See https://bugs.launchpad.net/bzr/+bug/251352

        """

        self.make_minimal_branch()

        out, err = self.run_bzr(['log', '-m', '*'], retcode=3)

        self.assertContainsRe(err, "ERROR.*Invalid pattern.*nothing to repeat")

        self.assertNotContainsRe(err, "Unprintable exception")

        self.assertEqual(out, '')

    def test_log_unsupported_timezone(self):

        self.make_linear_branch()

        self.run_bzr_error(['bzr: ERROR: Unsupported timezone format "foo", '

                            'options are "utc", "original", "local".'],

                           ['log', '--timezone', 'foo'])

    def test_log_exclude_ancestry_no_range(self):

        self.make_linear_branch()

        self.run_bzr_error(['bzr: ERROR: --exclude-common-ancestry'

                            ' requires -r with two revisions'],

                           ['log', '--exclude-common-ancestry'])

    def test_log_exclude_ancestry_single_revision(self):

        self.make_merged_branch()

        self.run_bzr_error(['bzr: ERROR: --exclude-common-ancestry'

                            ' requires two different revisions'],

                           ['log', '--exclude-common-ancestry',

                            '-r1.1.1..1.1.1'])

class TestLogTags(TestLog):

    def test_log_with_tags(self):

        tree = self.make_linear_branch(format='dirstate-tags')

        branch = tree.branch

        branch.tags.set_tag('tag1', branch.get_rev_id(1))

        branch.tags.set_tag('tag1.1', branch.get_rev_id(1))

        branch.tags.set_tag('tag3', branch.last_revision())

        log = self.run_bzr("log -r-1")[0]

        self.assertTrue('tags: tag3' in log)

        log = self.run_bzr("log -r1")[0]

        # I guess that we can't know the order of tags in the output

        # since dicts are unordered, need to check both possibilities

        self.assertContainsRe(log, r'tags: (tag1, tag1\.1|tag1\.1, tag1)')

    def test_merged_log_with_tags(self):

        branch1_tree = self.make_linear_branch('branch1',

                                               format='dirstate-tags')

        branch1 = branch1_tree.branch

        branch2_tree = branch1_tree.bzrdir.sprout('branch2').open_workingtree()

        branch1_tree.commit(message='foobar', allow_pointless=True)

        branch1.tags.set_tag('tag1', branch1.last_revision())

        # tags don't propagate if we don't merge

        self.run_bzr('merge ../branch1', working_dir='branch2')

        branch2_tree.commit(message='merge branch 1')

        log = self.run_bzr("log -n0 -r-1", working_dir='branch2')[0]

        self.assertContainsRe(log, r'    tags: tag1')

        log = self.run_bzr("log -n0 -r3.1.1", working_dir='branch2')[0]

        self.assertContainsRe(log, r'tags: tag1')

class TestLogSignatures(TestLog):

    def test_log_with_signatures(self):

        self.requireFeature(features.gpgme)

        tree = self.make_linear_branch(format='dirstate-tags')

        log = self.run_bzr("log --signatures")[0]

        self.assertTrue('signature: no signature' in log)

    def test_log_without_signatures(self):

        self.requireFeature(features.gpgme)

        tree = self.make_linear_branch(format='dirstate-tags')

        log = self.run_bzr("log")[0]

        self.assertFalse('signature: no signature' in log)

class TestLogVerbose(TestLog):

    def setUp(self):

        super(TestLogVerbose, self).setUp()

        self.make_minimal_branch()

    def assertUseShortDeltaFormat(self, cmd):

        log = self.run_bzr(cmd)[0]

        # Check that we use the short status format

        self.assertContainsRe(log, '(?m)^\s*A  hello.txt$')

        self.assertNotContainsRe(log, '(?m)^\s*added:$')

    def assertUseLongDeltaFormat(self, cmd):

        log = self.run_bzr(cmd)[0]

        # Check that we use the long status format

        self.assertNotContainsRe(log, '(?m)^\s*A  hello.txt$')

        self.assertContainsRe(log, '(?m)^\s*added:$')

    def test_log_short_verbose(self):

        self.assertUseShortDeltaFormat(['log', '--short', '-v'])

    def test_log_s_verbose(self):

        self.assertUseShortDeltaFormat(['log', '-S', '-v'])

    def test_log_short_verbose_verbose(self):

        self.assertUseLongDeltaFormat(['log', '--short', '-vv'])

    def test_log_long_verbose(self):

        # Check that we use the long status format, ignoring the verbosity

        # level

        self.assertUseLongDeltaFormat(['log', '--long', '-v'])

    def test_log_long_verbose_verbose(self):

        # Check that we use the long status format, ignoring the verbosity

        # level

        self.assertUseLongDeltaFormat(['log', '--long', '-vv'])

class TestLogMerges(TestLogWithLogCatcher):

    def setUp(self):

        super(TestLogMerges, self).setUp()

        self.make_branches_with_merges()

    def make_branches_with_merges(self):

        level0 = self.make_branch_and_tree('level0')

        self.wt_commit(level0, 'in branch level0')

        level1 = level0.bzrdir.sprout('level1').open_workingtree()

        self.wt_commit(level1, 'in branch level1')

        level2 = level1.bzrdir.sprout('level2').open_workingtree()

        self.wt_commit(level2, 'in branch level2')

        level1.merge_from_branch(level2.branch)

        self.wt_commit(level1, 'merge branch level2')

        level0.merge_from_branch(level1.branch)

        self.wt_commit(level0, 'merge branch level1')

    def test_merges_are_indented_by_level(self):

        self.run_bzr(['log', '-n0'], working_dir='level0')

        revnos_and_depth = [(r.revno, r.merge_depth)

                            for r in self.get_captured_revisions()]

        self.assertEqual([('2', 0), ('1.1.2', 1), ('1.2.1', 2), ('1.1.1', 1),

                          ('1', 0)],

                         [(r.revno, r.merge_depth)

                            for r in self.get_captured_revisions()])

    def test_force_merge_revisions_off(self):

        self.assertLogRevnos(['-n1'], ['2', '1'], working_dir='level0')

    def test_force_merge_revisions_on(self):

        self.assertLogRevnos(['-n0'], ['2', '1.1.2', '1.2.1', '1.1.1', '1'],

                             working_dir='level0')

    def test_include_merges(self):

        # Confirm --include-merges gives the same output as -n0

        msg = ("The option '--include-merges' to 'bzr log' "

               "has been deprecated in bzr 2.5. "

               "Please use '--include-merged' instead.\n")

        self.assertLogRevnos(['--include-merges'],

                             ['2', '1.1.2', '1.2.1', '1.1.1', '1'],

                             working_dir='level0', err=msg)

        self.assertLogRevnos(['--include-merges'],

                             ['2', '1.1.2', '1.2.1', '1.1.1', '1'],

                             working_dir='level0', err=msg)

        out_im, err_im = self.run_bzr('log --include-merges',

                                      working_dir='level0')

        out_n0, err_n0 = self.run_bzr('log -n0', working_dir='level0')

        self.assertEqual(msg, err_im)

        self.assertEqual('', err_n0)

        self.assertEqual(out_im, out_n0)

    def test_include_merged(self):

        # Confirm --include-merged gives the same output as -n0

        expected = ['2', '1.1.2', '1.2.1', '1.1.1', '1']

        self.assertLogRevnos(['--include-merged'],

                             expected, working_dir='level0')

        self.assertLogRevnos(['--include-merged'],

                             expected, working_dir='level0')

    def test_force_merge_revisions_N(self):

        self.assertLogRevnos(['-n2'],

                             ['2', '1.1.2', '1.1.1', '1'],

                             working_dir='level0')

    def test_merges_single_merge_rev(self):

        self.assertLogRevnosAndDepths(['-n0', '-r1.1.2'],

                                      [('1.1.2', 0), ('1.2.1', 1)],

                                      working_dir='level0')

    def test_merges_partial_range(self):

        self.assertLogRevnosAndDepths(

                ['-n0', '-r1.1.1..1.1.2'],

                [('1.1.2', 0), ('1.2.1', 1), ('1.1.1', 0)],

                working_dir='level0')

    def test_merges_partial_range_ignore_before_lower_bound(self):

        """Dont show revisions before the lower bound's merged revs"""

        self.assertLogRevnosAndDepths(

                ['-n0', '-r1.1.2..2'],

                [('2', 0), ('1.1.2', 1), ('1.2.1', 2)],

                working_dir='level0')

    def test_omit_merges_with_sidelines(self):

        self.assertLogRevnos(['--omit-merges', '-n0'], ['1.2.1', '1.1.1', '1'],

                             working_dir='level0')

    def test_omit_merges_without_sidelines(self):

        self.assertLogRevnos(['--omit-merges', '-n1'], ['1'],

                             working_dir='level0')

class TestLogDiff(TestLogWithLogCatcher):

    # FIXME: We need specific tests for each LogFormatter about how the diffs

    # are displayed: --long indent them by depth, --short use a fixed

    # indent and --line does't display them. -- vila 10019

    def setUp(self):

        super(TestLogDiff, self).setUp()

        self.make_branch_with_diffs()

    def make_branch_with_diffs(self):

        level0 = self.make_branch_and_tree('level0')

        self.build_tree(['level0/file1', 'level0/file2'])

        level0.add('file1')

        level0.add('file2')