b01e7f7fd6
This hides a particular symbol from the NDK stubs, while allowing the symbol to be exposed to the VNDK through the LLNDK stubs. This doesn't introduce any sort of versioning yet, this will need to change when we add a new symbol to a new version of the VNDK. Test: test_gen_stub_libs.py Test: With my LL-NDK patches, inspecting the generated map files Change-Id: Iee86aafda7985d6d7a016d0d5ff951505634913b
480 lines
16 KiB
Python
Executable File
480 lines
16 KiB
Python
Executable File
#!/usr/bin/env python
|
|
#
|
|
# Copyright (C) 2016 The Android Open Source Project
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
#
|
|
"""Tests for gen_stub_libs.py."""
|
|
import cStringIO
|
|
import textwrap
|
|
import unittest
|
|
|
|
import gen_stub_libs as gsl
|
|
|
|
|
|
# pylint: disable=missing-docstring
|
|
|
|
|
|
class TagsTest(unittest.TestCase):
|
|
def test_get_tags_no_tags(self):
|
|
self.assertEqual([], gsl.get_tags(''))
|
|
self.assertEqual([], gsl.get_tags('foo bar baz'))
|
|
|
|
def test_get_tags(self):
|
|
self.assertEqual(['foo', 'bar'], gsl.get_tags('# foo bar'))
|
|
self.assertEqual(['bar', 'baz'], gsl.get_tags('foo # bar baz'))
|
|
|
|
def test_get_tag_value(self):
|
|
self.assertEqual('bar', gsl.get_tag_value('foo=bar'))
|
|
self.assertEqual('bar=baz', gsl.get_tag_value('foo=bar=baz'))
|
|
with self.assertRaises(ValueError):
|
|
gsl.get_tag_value('foo')
|
|
|
|
|
|
class PrivateVersionTest(unittest.TestCase):
|
|
def test_version_is_private(self):
|
|
self.assertFalse(gsl.version_is_private('foo'))
|
|
self.assertFalse(gsl.version_is_private('PRIVATE'))
|
|
self.assertFalse(gsl.version_is_private('PLATFORM'))
|
|
self.assertFalse(gsl.version_is_private('foo_private'))
|
|
self.assertFalse(gsl.version_is_private('foo_platform'))
|
|
self.assertFalse(gsl.version_is_private('foo_PRIVATE_'))
|
|
self.assertFalse(gsl.version_is_private('foo_PLATFORM_'))
|
|
|
|
self.assertTrue(gsl.version_is_private('foo_PRIVATE'))
|
|
self.assertTrue(gsl.version_is_private('foo_PLATFORM'))
|
|
|
|
|
|
class SymbolPresenceTest(unittest.TestCase):
|
|
def test_symbol_in_arch(self):
|
|
self.assertTrue(gsl.symbol_in_arch([], 'arm'))
|
|
self.assertTrue(gsl.symbol_in_arch(['arm'], 'arm'))
|
|
|
|
self.assertFalse(gsl.symbol_in_arch(['x86'], 'arm'))
|
|
|
|
def test_symbol_in_api(self):
|
|
self.assertTrue(gsl.symbol_in_api([], 'arm', 9))
|
|
self.assertTrue(gsl.symbol_in_api(['introduced=9'], 'arm', 9))
|
|
self.assertTrue(gsl.symbol_in_api(['introduced=9'], 'arm', 14))
|
|
self.assertTrue(gsl.symbol_in_api(['introduced-arm=9'], 'arm', 14))
|
|
self.assertTrue(gsl.symbol_in_api(['introduced-arm=9'], 'arm', 14))
|
|
self.assertTrue(gsl.symbol_in_api(['introduced-x86=14'], 'arm', 9))
|
|
self.assertTrue(gsl.symbol_in_api(
|
|
['introduced-arm=9', 'introduced-x86=21'], 'arm', 14))
|
|
self.assertTrue(gsl.symbol_in_api(
|
|
['introduced=9', 'introduced-x86=21'], 'arm', 14))
|
|
self.assertTrue(gsl.symbol_in_api(
|
|
['introduced=21', 'introduced-arm=9'], 'arm', 14))
|
|
self.assertTrue(gsl.symbol_in_api(
|
|
['future'], 'arm', gsl.FUTURE_API_LEVEL))
|
|
|
|
self.assertFalse(gsl.symbol_in_api(['introduced=14'], 'arm', 9))
|
|
self.assertFalse(gsl.symbol_in_api(['introduced-arm=14'], 'arm', 9))
|
|
self.assertFalse(gsl.symbol_in_api(['future'], 'arm', 9))
|
|
self.assertFalse(gsl.symbol_in_api(
|
|
['introduced=9', 'future'], 'arm', 14))
|
|
self.assertFalse(gsl.symbol_in_api(
|
|
['introduced-arm=9', 'future'], 'arm', 14))
|
|
self.assertFalse(gsl.symbol_in_api(
|
|
['introduced-arm=21', 'introduced-x86=9'], 'arm', 14))
|
|
self.assertFalse(gsl.symbol_in_api(
|
|
['introduced=9', 'introduced-arm=21'], 'arm', 14))
|
|
self.assertFalse(gsl.symbol_in_api(
|
|
['introduced=21', 'introduced-x86=9'], 'arm', 14))
|
|
|
|
# Interesting edge case: this symbol should be omitted from the
|
|
# library, but this call should still return true because none of the
|
|
# tags indiciate that it's not present in this API level.
|
|
self.assertTrue(gsl.symbol_in_api(['x86'], 'arm', 9))
|
|
|
|
def test_verioned_in_api(self):
|
|
self.assertTrue(gsl.symbol_versioned_in_api([], 9))
|
|
self.assertTrue(gsl.symbol_versioned_in_api(['versioned=9'], 9))
|
|
self.assertTrue(gsl.symbol_versioned_in_api(['versioned=9'], 14))
|
|
|
|
self.assertFalse(gsl.symbol_versioned_in_api(['versioned=14'], 9))
|
|
|
|
|
|
class OmitVersionTest(unittest.TestCase):
|
|
def test_omit_private(self):
|
|
self.assertFalse(gsl.should_omit_version('foo', [], 'arm', 9, False))
|
|
|
|
self.assertTrue(gsl.should_omit_version(
|
|
'foo_PRIVATE', [], 'arm', 9, False))
|
|
self.assertTrue(gsl.should_omit_version(
|
|
'foo_PLATFORM', [], 'arm', 9, False))
|
|
|
|
self.assertTrue(gsl.should_omit_version(
|
|
'foo', ['platform-only'], 'arm', 9, False))
|
|
|
|
def test_omit_vndk(self):
|
|
self.assertTrue(gsl.should_omit_version(
|
|
'foo', ['vndk'], 'arm', 9, False))
|
|
|
|
self.assertFalse(gsl.should_omit_version('foo', [], 'arm', 9, True))
|
|
self.assertFalse(gsl.should_omit_version(
|
|
'foo', ['vndk'], 'arm', 9, True))
|
|
|
|
def test_omit_arch(self):
|
|
self.assertFalse(gsl.should_omit_version('foo', [], 'arm', 9, False))
|
|
self.assertFalse(gsl.should_omit_version(
|
|
'foo', ['arm'], 'arm', 9, False))
|
|
|
|
self.assertTrue(gsl.should_omit_version(
|
|
'foo', ['x86'], 'arm', 9, False))
|
|
|
|
def test_omit_api(self):
|
|
self.assertFalse(gsl.should_omit_version('foo', [], 'arm', 9, False))
|
|
self.assertFalse(
|
|
gsl.should_omit_version('foo', ['introduced=9'], 'arm', 9, False))
|
|
|
|
self.assertTrue(
|
|
gsl.should_omit_version('foo', ['introduced=14'], 'arm', 9, False))
|
|
|
|
|
|
class SymbolFileParseTest(unittest.TestCase):
|
|
def test_next_line(self):
|
|
input_file = cStringIO.StringIO(textwrap.dedent("""\
|
|
foo
|
|
|
|
bar
|
|
# baz
|
|
qux
|
|
"""))
|
|
parser = gsl.SymbolFileParser(input_file)
|
|
self.assertIsNone(parser.current_line)
|
|
|
|
self.assertEqual('foo', parser.next_line().strip())
|
|
self.assertEqual('foo', parser.current_line.strip())
|
|
|
|
self.assertEqual('bar', parser.next_line().strip())
|
|
self.assertEqual('bar', parser.current_line.strip())
|
|
|
|
self.assertEqual('qux', parser.next_line().strip())
|
|
self.assertEqual('qux', parser.current_line.strip())
|
|
|
|
self.assertEqual('', parser.next_line())
|
|
self.assertEqual('', parser.current_line)
|
|
|
|
def test_parse_version(self):
|
|
input_file = cStringIO.StringIO(textwrap.dedent("""\
|
|
VERSION_1 { # foo bar
|
|
baz;
|
|
qux; # woodly doodly
|
|
};
|
|
|
|
VERSION_2 {
|
|
} VERSION_1; # asdf
|
|
"""))
|
|
parser = gsl.SymbolFileParser(input_file)
|
|
|
|
parser.next_line()
|
|
version = parser.parse_version()
|
|
self.assertEqual('VERSION_1', version.name)
|
|
self.assertIsNone(version.base)
|
|
self.assertEqual(['foo', 'bar'], version.tags)
|
|
|
|
expected_symbols = [
|
|
gsl.Symbol('baz', []),
|
|
gsl.Symbol('qux', ['woodly', 'doodly']),
|
|
]
|
|
self.assertEqual(expected_symbols, version.symbols)
|
|
|
|
parser.next_line()
|
|
version = parser.parse_version()
|
|
self.assertEqual('VERSION_2', version.name)
|
|
self.assertEqual('VERSION_1', version.base)
|
|
self.assertEqual([], version.tags)
|
|
|
|
def test_parse_version_eof(self):
|
|
input_file = cStringIO.StringIO(textwrap.dedent("""\
|
|
VERSION_1 {
|
|
"""))
|
|
parser = gsl.SymbolFileParser(input_file)
|
|
parser.next_line()
|
|
with self.assertRaises(gsl.ParseError):
|
|
parser.parse_version()
|
|
|
|
def test_unknown_scope_label(self):
|
|
input_file = cStringIO.StringIO(textwrap.dedent("""\
|
|
VERSION_1 {
|
|
foo:
|
|
}
|
|
"""))
|
|
parser = gsl.SymbolFileParser(input_file)
|
|
parser.next_line()
|
|
with self.assertRaises(gsl.ParseError):
|
|
parser.parse_version()
|
|
|
|
def test_parse_symbol(self):
|
|
input_file = cStringIO.StringIO(textwrap.dedent("""\
|
|
foo;
|
|
bar; # baz qux
|
|
"""))
|
|
parser = gsl.SymbolFileParser(input_file)
|
|
|
|
parser.next_line()
|
|
symbol = parser.parse_symbol()
|
|
self.assertEqual('foo', symbol.name)
|
|
self.assertEqual([], symbol.tags)
|
|
|
|
parser.next_line()
|
|
symbol = parser.parse_symbol()
|
|
self.assertEqual('bar', symbol.name)
|
|
self.assertEqual(['baz', 'qux'], symbol.tags)
|
|
|
|
def test_wildcard_symbol_global(self):
|
|
input_file = cStringIO.StringIO(textwrap.dedent("""\
|
|
VERSION_1 {
|
|
*;
|
|
};
|
|
"""))
|
|
parser = gsl.SymbolFileParser(input_file)
|
|
parser.next_line()
|
|
with self.assertRaises(gsl.ParseError):
|
|
parser.parse_version()
|
|
|
|
def test_wildcard_symbol_local(self):
|
|
input_file = cStringIO.StringIO(textwrap.dedent("""\
|
|
VERSION_1 {
|
|
local:
|
|
*;
|
|
};
|
|
"""))
|
|
parser = gsl.SymbolFileParser(input_file)
|
|
parser.next_line()
|
|
version = parser.parse_version()
|
|
self.assertEqual([], version.symbols)
|
|
|
|
def test_missing_semicolon(self):
|
|
input_file = cStringIO.StringIO(textwrap.dedent("""\
|
|
VERSION_1 {
|
|
foo
|
|
};
|
|
"""))
|
|
parser = gsl.SymbolFileParser(input_file)
|
|
parser.next_line()
|
|
with self.assertRaises(gsl.ParseError):
|
|
parser.parse_version()
|
|
|
|
def test_parse_fails_invalid_input(self):
|
|
with self.assertRaises(gsl.ParseError):
|
|
input_file = cStringIO.StringIO('foo')
|
|
parser = gsl.SymbolFileParser(input_file)
|
|
parser.parse()
|
|
|
|
def test_parse(self):
|
|
input_file = cStringIO.StringIO(textwrap.dedent("""\
|
|
VERSION_1 {
|
|
local:
|
|
hidden1;
|
|
global:
|
|
foo;
|
|
bar; # baz
|
|
};
|
|
|
|
VERSION_2 { # wasd
|
|
# Implicit global scope.
|
|
woodly;
|
|
doodly; # asdf
|
|
local:
|
|
qwerty;
|
|
} VERSION_1;
|
|
"""))
|
|
parser = gsl.SymbolFileParser(input_file)
|
|
versions = parser.parse()
|
|
|
|
expected = [
|
|
gsl.Version('VERSION_1', None, [], [
|
|
gsl.Symbol('foo', []),
|
|
gsl.Symbol('bar', ['baz']),
|
|
]),
|
|
gsl.Version('VERSION_2', 'VERSION_1', ['wasd'], [
|
|
gsl.Symbol('woodly', []),
|
|
gsl.Symbol('doodly', ['asdf']),
|
|
]),
|
|
]
|
|
|
|
self.assertEqual(expected, versions)
|
|
|
|
|
|
class GeneratorTest(unittest.TestCase):
|
|
def test_omit_version(self):
|
|
# Thorough testing of the cases involved here is handled by
|
|
# OmitVersionTest, PrivateVersionTest, and SymbolPresenceTest.
|
|
src_file = cStringIO.StringIO()
|
|
version_file = cStringIO.StringIO()
|
|
generator = gsl.Generator(src_file, version_file, 'arm', 9, False)
|
|
|
|
version = gsl.Version('VERSION_PRIVATE', None, [], [
|
|
gsl.Symbol('foo', []),
|
|
])
|
|
generator.write_version(version)
|
|
self.assertEqual('', src_file.getvalue())
|
|
self.assertEqual('', version_file.getvalue())
|
|
|
|
version = gsl.Version('VERSION', None, ['x86'], [
|
|
gsl.Symbol('foo', []),
|
|
])
|
|
generator.write_version(version)
|
|
self.assertEqual('', src_file.getvalue())
|
|
self.assertEqual('', version_file.getvalue())
|
|
|
|
version = gsl.Version('VERSION', None, ['introduced=14'], [
|
|
gsl.Symbol('foo', []),
|
|
])
|
|
generator.write_version(version)
|
|
self.assertEqual('', src_file.getvalue())
|
|
self.assertEqual('', version_file.getvalue())
|
|
|
|
def test_omit_symbol(self):
|
|
# Thorough testing of the cases involved here is handled by
|
|
# SymbolPresenceTest.
|
|
src_file = cStringIO.StringIO()
|
|
version_file = cStringIO.StringIO()
|
|
generator = gsl.Generator(src_file, version_file, 'arm', 9, False)
|
|
|
|
version = gsl.Version('VERSION_1', None, [], [
|
|
gsl.Symbol('foo', ['x86']),
|
|
])
|
|
generator.write_version(version)
|
|
self.assertEqual('', src_file.getvalue())
|
|
self.assertEqual('', version_file.getvalue())
|
|
|
|
version = gsl.Version('VERSION_1', None, [], [
|
|
gsl.Symbol('foo', ['introduced=14']),
|
|
])
|
|
generator.write_version(version)
|
|
self.assertEqual('', src_file.getvalue())
|
|
self.assertEqual('', version_file.getvalue())
|
|
|
|
version = gsl.Version('VERSION_1', None, [], [
|
|
gsl.Symbol('foo', ['vndk']),
|
|
])
|
|
generator.write_version(version)
|
|
self.assertEqual('', src_file.getvalue())
|
|
self.assertEqual('', version_file.getvalue())
|
|
|
|
def test_write(self):
|
|
src_file = cStringIO.StringIO()
|
|
version_file = cStringIO.StringIO()
|
|
generator = gsl.Generator(src_file, version_file, 'arm', 9, False)
|
|
|
|
versions = [
|
|
gsl.Version('VERSION_1', None, [], [
|
|
gsl.Symbol('foo', []),
|
|
gsl.Symbol('bar', ['var']),
|
|
]),
|
|
gsl.Version('VERSION_2', 'VERSION_1', [], [
|
|
gsl.Symbol('baz', []),
|
|
]),
|
|
gsl.Version('VERSION_3', 'VERSION_1', [], [
|
|
gsl.Symbol('qux', ['versioned=14']),
|
|
]),
|
|
]
|
|
|
|
generator.write(versions)
|
|
expected_src = textwrap.dedent("""\
|
|
void foo() {}
|
|
int bar = 0;
|
|
void baz() {}
|
|
void qux() {}
|
|
""")
|
|
self.assertEqual(expected_src, src_file.getvalue())
|
|
|
|
expected_version = textwrap.dedent("""\
|
|
VERSION_1 {
|
|
global:
|
|
foo;
|
|
bar;
|
|
};
|
|
VERSION_2 {
|
|
global:
|
|
baz;
|
|
} VERSION_1;
|
|
""")
|
|
self.assertEqual(expected_version, version_file.getvalue())
|
|
|
|
|
|
class IntegrationTest(unittest.TestCase):
|
|
def test_integration(self):
|
|
input_file = cStringIO.StringIO(textwrap.dedent("""\
|
|
VERSION_1 {
|
|
global:
|
|
foo; # var
|
|
bar; # x86
|
|
local:
|
|
*;
|
|
};
|
|
|
|
VERSION_2 { # arm
|
|
baz; # introduced=9
|
|
qux; # versioned=14
|
|
} VERSION_1;
|
|
|
|
VERSION_3 { # introduced=14
|
|
woodly;
|
|
doodly; # var
|
|
} VERSION_2;
|
|
|
|
VERSION_4 { # versioned=9
|
|
wibble;
|
|
wizzes; # vndk
|
|
} VERSION_2;
|
|
|
|
VERSION_5 { # versioned=14
|
|
wobble;
|
|
} VERSION_4;
|
|
"""))
|
|
parser = gsl.SymbolFileParser(input_file)
|
|
versions = parser.parse()
|
|
|
|
src_file = cStringIO.StringIO()
|
|
version_file = cStringIO.StringIO()
|
|
generator = gsl.Generator(src_file, version_file, 'arm', 9, False)
|
|
generator.write(versions)
|
|
|
|
expected_src = textwrap.dedent("""\
|
|
int foo = 0;
|
|
void baz() {}
|
|
void qux() {}
|
|
void wibble() {}
|
|
void wobble() {}
|
|
""")
|
|
self.assertEqual(expected_src, src_file.getvalue())
|
|
|
|
expected_version = textwrap.dedent("""\
|
|
VERSION_1 {
|
|
global:
|
|
foo;
|
|
};
|
|
VERSION_2 {
|
|
global:
|
|
baz;
|
|
} VERSION_1;
|
|
VERSION_4 {
|
|
global:
|
|
wibble;
|
|
} VERSION_2;
|
|
""")
|
|
self.assertEqual(expected_version, version_file.getvalue())
|
|
|
|
|
|
def main():
|
|
suite = unittest.TestLoader().loadTestsFromName(__name__)
|
|
unittest.TextTestRunner(verbosity=3).run(suite)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|