~bzr-pqm/bzr/bzr.dev

# Copyright (C) 2005, 2006 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

"""Tests for version_info"""

from cStringIO import StringIO

import imp

import os

import sys

from bzrlib import (

    errors,

    registry,

    symbol_versioning,

    tests,

    version_info_formats,

    )

from bzrlib.tests import TestCaseWithTransport

from bzrlib.rio import read_stanzas

from bzrlib.version_info_formats.format_custom import CustomVersionInfoBuilder

from bzrlib.version_info_formats.format_rio import RioVersionInfoBuilder

from bzrlib.version_info_formats.format_python import PythonVersionInfoBuilder

class TestVersionInfo(TestCaseWithTransport):

    def create_branch(self):

        wt = self.make_branch_and_tree('branch')

        self.build_tree(['branch/a'])

        wt.add('a')

        wt.commit('a', rev_id='r1')

        self.build_tree(['branch/b'])

        wt.add('b')

        wt.commit('b', rev_id='r2')

        self.build_tree_contents([('branch/a', 'new contents\n')])

        wt.commit(u'\xe52', rev_id='r3')

        return wt

    def test_rio_null(self):

        wt = self.make_branch_and_tree('branch')

        sio = StringIO()

        builder = RioVersionInfoBuilder(wt.branch, working_tree=wt)

        builder.generate(sio)

        val = sio.getvalue()

        self.assertContainsRe(val, 'build-date:')

        self.assertContainsRe(val, 'revno: 0')

    def test_rio_version_text(self):

        wt = self.create_branch()

        def regen(**kwargs):

            sio = StringIO()

            builder = RioVersionInfoBuilder(wt.branch, working_tree=wt,

                                            **kwargs)

            builder.generate(sio)

            val = sio.getvalue()

            return val

        val = regen()

        self.assertContainsRe(val, 'build-date:')

        self.assertContainsRe(val, 'date:')

        self.assertContainsRe(val, 'revno: 3')

        self.assertContainsRe(val, 'revision-id: r3')

        val = regen(check_for_clean=True)

        self.assertContainsRe(val, 'clean: True')

        self.build_tree(['branch/c'])

        val = regen(check_for_clean=True)

        self.assertContainsRe(val, 'clean: False')

        os.remove('branch/c')

        val = regen(include_revision_history=True)

        self.assertContainsRe(val, 'id: r1')

        self.assertContainsRe(val, 'message: a')

        self.assertContainsRe(val, 'id: r2')

        self.assertContainsRe(val, 'message: b')

        self.assertContainsRe(val, 'id: r3')

        self.assertContainsRe(val, 'message: \xc3\xa52') # utf8 encoding '\xe5'

    def test_rio_version_hook(self):

        def update_stanza(rev, stanza):

            stanza.add('bla', 'bloe')

        RioVersionInfoBuilder.hooks.install_named_hook(

            'revision', update_stanza, None)

        wt = self.create_branch()

        def regen(**kwargs):

            sio = StringIO()

            builder = RioVersionInfoBuilder(wt.branch, working_tree=wt,

                                            **kwargs)

            builder.generate(sio)

            sio.seek(0)

            stanzas = list(read_stanzas(sio))

            self.assertEqual(1, len(stanzas))

            return stanzas[0]

        stanza = regen()

        self.assertEqual(['bloe'], stanza.get_all('bla'))

    def test_rio_version(self):

        wt = self.create_branch()

        def regen(**kwargs):

            sio = StringIO()

            builder = RioVersionInfoBuilder(wt.branch, working_tree=wt,

                                            **kwargs)

            builder.generate(sio)

            sio.seek(0)

            stanzas = list(read_stanzas(sio))

            self.assertEqual(1, len(stanzas))

            return stanzas[0]

        def get_one_stanza(stanza, key):

            new_stanzas = list(read_stanzas(

                                StringIO(stanza[key].encode('utf8'))))

            self.assertEqual(1, len(new_stanzas))

            return new_stanzas[0]

        stanza = regen()

        self.failUnless('date' in stanza)

        self.failUnless('build-date' in stanza)

        self.assertEqual(['3'], stanza.get_all('revno'))

        self.assertEqual(['r3'], stanza.get_all('revision-id'))

        stanza = regen(check_for_clean=True)

        self.assertEqual(['True'], stanza.get_all('clean'))

        self.build_tree(['branch/c'])

        stanza = regen(check_for_clean=True, include_file_revisions=True)

        self.assertEqual(['False'], stanza.get_all('clean'))

        # This assumes it's being run against a tree that does not update the

        # root revision on every commit.

        file_rev_stanza = get_one_stanza(stanza, 'file-revisions')

        self.assertEqual(['', 'a', 'b', 'c'], file_rev_stanza.get_all('path'))

        self.assertEqual(['r1', 'r3', 'r2', 'unversioned'],

            file_rev_stanza.get_all('revision'))

        os.remove('branch/c')

        stanza = regen(include_revision_history=True)

        revision_stanza = get_one_stanza(stanza, 'revisions')

        self.assertEqual(['r1', 'r2', 'r3'], revision_stanza.get_all('id'))

        self.assertEqual(['a', 'b', u'\xe52'], revision_stanza.get_all('message'))

        self.assertEqual(3, len(revision_stanza.get_all('date')))

        # a was modified, so it should show up modified again

        self.build_tree(['branch/a', 'branch/c'])

        wt.add('c')

        wt.rename_one('b', 'd')

        stanza = regen(check_for_clean=True, include_file_revisions=True)

        file_rev_stanza = get_one_stanza(stanza, 'file-revisions')

        self.assertEqual(['', 'a', 'b', 'c', 'd'],

                          file_rev_stanza.get_all('path'))

        self.assertEqual(['r1', 'modified', 'renamed to d', 'new',

                          'renamed from b'],

                         file_rev_stanza.get_all('revision'))

        wt.commit('modified', rev_id='r4')

        wt.remove(['c', 'd'])

        os.remove('branch/d')

        stanza = regen(check_for_clean=True, include_file_revisions=True)

        file_rev_stanza = get_one_stanza(stanza, 'file-revisions')

        self.assertEqual(['', 'a', 'c', 'd'], file_rev_stanza.get_all('path'))

        self.assertEqual(['r1', 'r4', 'unversioned', 'removed'],

                         file_rev_stanza.get_all('revision'))

    def test_python_null(self):

        wt = self.make_branch_and_tree('branch')

        sio = StringIO()

        builder = PythonVersionInfoBuilder(wt.branch, working_tree=wt)

        builder.generate(sio)

        val = sio.getvalue()

        self.assertContainsRe(val, "'revision_id': None")

        self.assertContainsRe(val, "'revno': 0")

    def test_python_version(self):

        wt = self.create_branch()

        def regen(**kwargs):

            """Create a test module, import and return it"""

            outf = open('test_version_information.py', 'wb')

            try:

                builder = PythonVersionInfoBuilder(wt.branch, working_tree=wt,

                                                   **kwargs)

                builder.generate(outf)

            finally:

                outf.close()

            module_info = imp.find_module('test_version_information',

                                          [os.getcwdu()])

            tvi = imp.load_module('tvi', *module_info)

            # Make sure the module isn't cached

            sys.modules.pop('tvi', None)

            sys.modules.pop('test_version_information', None)

            # Delete the compiled versions, because we are generating

            # a new file fast enough that python doesn't detect it

            # needs to recompile, and using sleep() just makes the

            # test slow

            if os.path.exists('test_version_information.pyc'):

                os.remove('test_version_information.pyc')

            if os.path.exists('test_version_information.pyo'):

                os.remove('test_version_information.pyo')

            return tvi

        tvi = regen()

        self.assertEqual(3, tvi.version_info['revno'])

        self.assertEqual('r3', tvi.version_info['revision_id'])

        self.failUnless(tvi.version_info.has_key('date'))

        self.assertEqual(None, tvi.version_info['clean'])

        tvi = regen(check_for_clean=True)

        self.assertEqual(True, tvi.version_info['clean'])

        self.build_tree(['branch/c'])

        tvi = regen(check_for_clean=True, include_file_revisions=True)

        self.assertEqual(False, tvi.version_info['clean'])

        self.assertEqual(['', 'a', 'b', 'c'],

                         sorted(tvi.file_revisions.keys()))

        self.assertEqual('r3', tvi.file_revisions['a'])

        self.assertEqual('r2', tvi.file_revisions['b'])

        self.assertEqual('unversioned', tvi.file_revisions['c'])

        os.remove('branch/c')

        tvi = regen(include_revision_history=True)

        rev_info = [(rev, message) for rev, message, timestamp, timezone

                                   in tvi.revisions]

        self.assertEqual([('r1', 'a'), ('r2', 'b'), ('r3', u'\xe52')], rev_info)

        # a was modified, so it should show up modified again

        self.build_tree(['branch/a', 'branch/c'])

        wt.add('c')

        wt.rename_one('b', 'd')

        tvi = regen(check_for_clean=True, include_file_revisions=True)

        self.assertEqual(['', 'a', 'b', 'c', 'd'],

                          sorted(tvi.file_revisions.keys()))

        self.assertEqual('modified', tvi.file_revisions['a'])

        self.assertEqual('renamed to d', tvi.file_revisions['b'])

        self.assertEqual('new', tvi.file_revisions['c'])

        self.assertEqual('renamed from b', tvi.file_revisions['d'])

        wt.commit('modified', rev_id='r4')

        wt.remove(['c', 'd'])

        os.remove('branch/d')

        tvi = regen(check_for_clean=True, include_file_revisions=True)

        self.assertEqual(['', 'a', 'c', 'd'],

                          sorted(tvi.file_revisions.keys()))

        self.assertEqual('r4', tvi.file_revisions['a'])

        self.assertEqual('unversioned', tvi.file_revisions['c'])

        self.assertEqual('removed', tvi.file_revisions['d'])

    def test_custom_null(self):

        sio = StringIO()

        wt = self.make_branch_and_tree('branch')

        builder = CustomVersionInfoBuilder(wt.branch, working_tree=wt,

            template='revno: {revno}')

        builder.generate(sio)

        self.assertEquals("revno: 0", sio.getvalue())

        builder = CustomVersionInfoBuilder(wt.branch, working_tree=wt, 

            template='{revno} revid: {revision_id}')

        # revision_id is not available yet

        self.assertRaises(errors.MissingTemplateVariable, 

            builder.generate, sio)

    def test_custom_version_text(self):

        wt = self.create_branch()

        def regen(tpl, **kwargs):

            sio = StringIO()

            builder = CustomVersionInfoBuilder(wt.branch, working_tree=wt,

                                               template=tpl, **kwargs)

            builder.generate(sio)

            val = sio.getvalue()

            return val

        val = regen('build-date: "{build_date}"\ndate: "{date}"')

        self.assertContainsRe(val, 'build-date: "[0-9-+: ]+"')

        self.assertContainsRe(val, 'date: "[0-9-+: ]+"')

        val = regen('revno: {revno}')

        self.assertEqual(val, 'revno: 3')

        val = regen('revision-id: {revision_id}')

        self.assertEqual(val, 'revision-id: r3')

        val = regen('clean: {clean}', check_for_clean=True)

        self.assertEqual(val, 'clean: 1')

        self.build_tree(['branch/c'])

        val = regen('clean: {clean}', check_for_clean=True)

        self.assertEqual(val, 'clean: 0')

        os.remove('branch/c')

    def test_custom_without_template(self):

        builder = CustomVersionInfoBuilder(None)

        sio = StringIO()

        self.assertRaises(errors.NoTemplate, builder.generate, sio)

class TestBuilder(version_info_formats.VersionInfoBuilder):

    pass

class TestVersionInfoFormatRegistry(tests.TestCase):

    def setUp(self):

        super(TestVersionInfoFormatRegistry, self).setUp()

        self.overrideAttr(version_info_formats,

                          'format_registry', registry.Registry())

    def test_register_remove(self):

        registry = version_info_formats.format_registry

        registry.register('testbuilder',

            TestBuilder, 'a simple test builder')

        self.assertIs(TestBuilder, registry.get('testbuilder'))

        self.assertEqual('a simple test builder',

                         registry.get_help('testbuilder'))

        registry.remove('testbuilder')

        self.assertRaises(KeyError, registry.get, 'testbuilder')