#!/usr/bin/env python3
# Copyright 2012 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
'''Unit tests for base.Node functionality (as used in various subclasses)'''
import io
import os
import sys
import unittest
if __name__ == '__main__':
sys.path.append(os.path.join(os.path.dirname(__file__), '../..'))
from grit import grd_reader
from grit import util
from grit.node import base
from grit.node import message
def MakePlaceholder(phname='BINGO'):
ph = message.PhNode()
ph.StartParsing('ph', None)
ph.HandleAttribute('name', phname)
ph.AppendContent('bongo')
ph.EndParsing()
return ph
class NodeUnittest(unittest.TestCase):
def testWhitespaceHandling(self):
# We test using the Message node type.
node = message.MessageNode()
node.StartParsing('hello', None)
node.HandleAttribute('name', 'bla')
node.AppendContent(" ''' two spaces ")
node.EndParsing()
self.assertTrue(node.GetCdata() == ' two spaces')
node = message.MessageNode()
node.StartParsing('message', None)
node.HandleAttribute('name', 'bla')
node.AppendContent(" two spaces ''' ")
node.EndParsing()
self.assertTrue(node.GetCdata() == 'two spaces ')
def testWhitespaceHandlingWithChildren(self):
# We test using the Message node type.
node = message.MessageNode()
node.StartParsing('message', None)
node.HandleAttribute('name', 'bla')
node.AppendContent(" ''' two spaces ")
node.AddChild(MakePlaceholder())
node.AppendContent(' space before and after ')
node.AddChild(MakePlaceholder('BONGO'))
node.AppendContent(" space before two after '''")
node.EndParsing()
self.assertTrue(node.mixed_content[0] == ' two spaces ')
self.assertTrue(node.mixed_content[2] == ' space before and after ')
self.assertTrue(node.mixed_content[-1] == ' space before two after ')
def testXmlFormatMixedContent(self):
# Again test using the Message node type, because it is the only mixed
# content node.
node = message.MessageNode()
node.StartParsing('message', None)
node.HandleAttribute('name', 'name')
node.AppendContent('Hello <young> ')
ph = message.PhNode()
ph.StartParsing('ph', None)
ph.HandleAttribute('name', 'USERNAME')
ph.AppendContent('$1')
ex = message.ExNode()
ex.StartParsing('ex', None)
ex.AppendContent('Joi')
ex.EndParsing()
ph.AddChild(ex)
ph.EndParsing()
node.AddChild(ph)
node.EndParsing()
non_indented_xml = node.FormatXml()
self.assertTrue(non_indented_xml == '<message name="name">\n Hello '
'<young> <ph name="USERNAME">$1<ex>Joi</ex></ph>'
'\n</message>')
indented_xml = node.FormatXml(' ')
self.assertTrue(indented_xml == ' <message name="name">\n Hello '
'<young> <ph name="USERNAME">$1<ex>Joi</ex></ph>'
'\n </message>')
def testXmlFormatMixedContentWithLeadingWhitespace(self):
# Again test using the Message node type, because it is the only mixed
# content node.
node = message.MessageNode()
node.StartParsing('message', None)
node.HandleAttribute('name', 'name')
node.AppendContent("''' Hello <young> ")
ph = message.PhNode()
ph.StartParsing('ph', None)
ph.HandleAttribute('name', 'USERNAME')
ph.AppendContent('$1')
ex = message.ExNode()
ex.StartParsing('ex', None)
ex.AppendContent('Joi')
ex.EndParsing()
ph.AddChild(ex)
ph.EndParsing()
node.AddChild(ph)
node.AppendContent(" yessiree '''")
node.EndParsing()
non_indented_xml = node.FormatXml()
self.assertTrue(non_indented_xml ==
"<message name=\"name\">\n ''' Hello"
' <young> <ph name="USERNAME">$1<ex>Joi</ex></ph>'
" yessiree '''\n</message>")
indented_xml = node.FormatXml(' ')
self.assertTrue(indented_xml ==
" <message name=\"name\">\n ''' Hello"
' <young> <ph name="USERNAME">$1<ex>Joi</ex></ph>'
" yessiree '''\n </message>")
self.assertTrue(node.GetNodeById('name'))
def testXmlFormatContentWithEntities(self):
'''Tests a bug where would not be escaped correctly.'''
from grit import tclib
msg_node = message.MessageNode.Construct(None, tclib.Message(
text = 'BEGIN_BOLDHelloWHITESPACEthere!END_BOLD Bingo!',
placeholders = [
tclib.Placeholder('BEGIN_BOLD', '<b>', 'bla'),
tclib.Placeholder('WHITESPACE', ' ', 'bla'),
tclib.Placeholder('END_BOLD', '</b>', 'bla')]),
'BINGOBONGO')
xml = msg_node.FormatXml()
self.assertTrue(xml.find(' ') == -1, 'should have no entities')
def testIter(self):
# First build a little tree of message and ph nodes.
node = message.MessageNode()
node.StartParsing('message', None)
node.HandleAttribute('name', 'bla')
node.AppendContent(" ''' two spaces ")
node.AppendContent(' space before and after ')
ph = message.PhNode()
ph.StartParsing('ph', None)
ph.AddChild(message.ExNode())
ph.HandleAttribute('name', 'BINGO')
ph.AppendContent('bongo')
node.AddChild(ph)
node.AddChild(message.PhNode())
node.AppendContent(" space before two after '''")
order = [
message.MessageNode, message.PhNode, message.ExNode, message.PhNode
]
for n in node:
self.assertTrue(type(n) == order[0])
order = order[1:]
self.assertTrue(len(order) == 0)
def testGetChildrenOfType(self):
xml = '''<?xml version="1.0" encoding="UTF-8"?>
<grit latest_public_release="2" source_lang_id="en-US"
current_release="3" base_dir=".">
<outputs>
<output filename="resource.h" type="rc_header" />
<output filename="en/generated_resources.rc" type="rc_all"
lang="en" />
<if expr="pp_if('NOT_TRUE')">
<output filename="de/generated_resources.rc" type="rc_all"
lang="de" />
</if>
</outputs>
<release seq="3">
<messages>
<message name="ID_HELLO">Hello!</message>
</messages>
</release>
</grit>'''
grd = grd_reader.Parse(io.StringIO(xml),
util.PathFromRoot('grit/test/data'))
from grit.node import node_io
output_nodes = grd.GetChildrenOfType(node_io.OutputNode)
self.assertEqual(len(output_nodes), 3)
self.assertEqual(output_nodes[2].attrs['filename'],
'de/generated_resources.rc')
def testEvaluateExpression(self):
def AssertExpr(expected_value, expr, defs, target_platform,
extra_variables):
self.assertEqual(expected_value, base.Node.EvaluateExpression(
expr, defs, target_platform, extra_variables))
AssertExpr(True, "True", {}, 'linux', {})
AssertExpr(False, "False", {}, 'linux', {})
AssertExpr(True, "True or False", {}, 'linux', {})
AssertExpr(False, "True and False", {}, 'linux', {})
AssertExpr(True, "os == 'linux'", {}, 'linux', {})
AssertExpr(False, "os == 'linux'", {}, 'ios', {})
AssertExpr(True, "'foo' in defs", {'foo': 'bar'}, 'ios', {})
AssertExpr(False, "'foo' in defs", {'baz': 'bar'}, 'ios', {})
AssertExpr(False, "'foo' in defs", {}, 'ios', {})
AssertExpr(True, "is_linux", {}, 'linux', {})
AssertExpr(False, "is_linux", {}, 'linux2', {}) # Python 2 used 'linux2'.
AssertExpr(False, "is_linux", {}, 'linux-foo', {}) # Must match exactly.
AssertExpr(False, "is_linux", {}, 'foollinux', {})
AssertExpr(False, "is_linux", {'chromeos_ash': True}, 'chromeos', {})
AssertExpr(False, "is_linux", {'chromeos_lacros': True}, 'chromeos', {})
# `is_chromeos` is not used with GRIT and is thus ignored.
AssertExpr(True, "is_linux", {'is_chromeos': True}, 'linux', {})
AssertExpr(True, "is_chromeos", {'chromeos_ash': True}, 'chromeos', {})
AssertExpr(True, "is_chromeos", {'chromeos_lacros': True}, 'chromeos', {})
AssertExpr(False, "is_chromeos", {}, 'linux', {})
AssertExpr(False, "is_fuchsia", {}, 'linux', {})
AssertExpr(False, "is_linux", {}, 'win32', {})
AssertExpr(True, "is_macosx", {}, 'darwin', {})
AssertExpr(False, "is_macosx", {}, 'ios', {})
AssertExpr(True, "is_win", {}, 'win32', {})
AssertExpr(False, "is_win", {}, 'darwin', {})
AssertExpr(True, "is_android", {}, 'android', {})
AssertExpr(False, "is_android", {}, 'linux3', {})
AssertExpr(True, "is_ios", {}, 'ios', {})
AssertExpr(False, "is_ios", {}, 'darwin', {})
AssertExpr(True, "is_posix", {}, 'linux', {})
AssertExpr(True, "is_posix", {'chromeos_ash': True}, 'chromeos', {})
AssertExpr(True, "is_posix", {'chromeos_lacros': True}, 'chromeos', {})
AssertExpr(True, "is_posix", {}, 'darwin', {})
AssertExpr(True, "is_posix", {}, 'android', {})
AssertExpr(True, "is_posix", {}, 'ios', {})
AssertExpr(True, "is_posix", {}, 'freebsd7', {})
AssertExpr(False, "is_posix", {}, 'fuchsia', {})
AssertExpr(False, "is_posix", {}, 'win32', {})
AssertExpr(True, "is_fuchsia", {}, 'fuchsia', {})
AssertExpr(True, "pp_ifdef('foo')", {'foo': True}, 'win32', {})
AssertExpr(True, "pp_ifdef('foo')", {'foo': False}, 'win32', {})
AssertExpr(False, "pp_ifdef('foo')", {'bar': True}, 'win32', {})
AssertExpr(True, "pp_if('foo')", {'foo': True}, 'win32', {})
AssertExpr(False, "pp_if('foo')", {'foo': False}, 'win32', {})
AssertExpr(False, "pp_if('foo')", {'bar': True}, 'win32', {})
AssertExpr(True, "foo", {'foo': True}, 'win32', {})
AssertExpr(False, "foo", {'foo': False}, 'win32', {})
AssertExpr(False, "foo", {'bar': True, 'foo': False}, 'win32', {})
AssertExpr(True, "foo == 'baz'", {'foo': 'baz'}, 'win32', {})
AssertExpr(False, "foo == 'baz'", {'foo': True}, 'win32', {})
AssertExpr(False, "foo == 'baz'", {'foo': True, 'baz': False}, 'win32', {})
AssertExpr(True, "lang == 'de'", {}, 'win32', {'lang': 'de'})
AssertExpr(False, "lang == 'de'", {}, 'win32', {'lang': 'fr'})
# Test a couple more complex expressions for good measure.
AssertExpr(True, "is_ios and (lang in ['de', 'fr'] or foo)",
{'foo': 'bar'}, 'ios', {'lang': 'fr', 'context': 'today'})
AssertExpr(False, "is_ios and (lang in ['de', 'fr'] or foo)",
{'foo': False}, 'linux', {
'lang': 'fr',
'context': 'today'
})
AssertExpr(False, "is_ios and (lang in ['de', 'fr'] or foo)", {
'baz': 'bar',
'is_ios': True,
'foo': False
}, 'ios', {
'lang': 'he',
'context': 'today'
})
AssertExpr(True, "foo == 'bar' or not baz", {
'foo': 'bar',
'baz': True
}, 'ios', {
'lang': 'en',
'context': 'java'
})
AssertExpr(False, "foo == 'bar' or not baz",
{'foo': 'ruz', 'baz': True}, 'ios', {'lang': 'en'})
def testEvaluateExpressionThrows(self):
def AssertThrows(expr, defs, target_platform, message):
with self.assertRaises(AssertionError) as cm:
base.Node.EvaluateExpression(expr, defs, target_platform, {})
self.assertTrue(str(cm.exception) == message)
# Test undefined variables.
AssertThrows("foo == 'baz'", {}, 'linux',
'undefined Grit variable found: foo')
AssertThrows("foo == 'bar' or not baz", {
'foo': 'bar',
'fun': True
}, 'linux', 'undefined Grit variable found: baz')
# Test invalid chromeos configurations.
AssertThrows("is_chromeos", {}, 'chromeos',
'The chromeos target must be either ash or lacros')
AssertThrows("is_chromeos", {
'chromeos_ash': True,
'chromeos_lacros': True
}, 'chromeos', 'The chromeos target must be either ash or lacros')
AssertThrows("is_linux", {'chromeos_ash': True}, 'linux',
'Non-chromeos targets cannot be ash or lacros')
AssertThrows("is_linux", {'chromeos_lacros': True}, 'linux',
'Non-chromeos targets cannot be ash or lacros')
AssertThrows("is_linux", {
'chromeos_ash': True,
'chromeos_lacros': True
}, 'linux', 'Non-chromeos targets cannot be ash or lacros')
if __name__ == '__main__':
unittest.main()