def test_parse(self) -> None: input_file = io.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 = symbolfile.SymbolFileParser(input_file, {}, Arch('arm'), 16, False, False) versions = parser.parse() expected = [ symbolfile.Version('VERSION_1', None, [], [ symbolfile.Symbol('foo', []), symbolfile.Symbol('bar', [Tag('baz')]), ]), symbolfile.Version('VERSION_2', 'VERSION_1', [Tag('wasd')], [ symbolfile.Symbol('woodly', []), symbolfile.Symbol('doodly', [Tag('asdf')]), ]), ] self.assertEqual(expected, versions)
def main() -> None: """Program entry point.""" args = parse_args() with args.api_map.open() as map_file: api_map = json.load(map_file) api = symbolfile.decode_api_level(args.api, api_map) verbose_map = (logging.WARNING, logging.INFO, logging.DEBUG) verbosity = args.verbose if verbosity > 2: verbosity = 2 logging.basicConfig(level=verbose_map[verbosity]) with args.symbol_file.open() as symbol_file: try: versions = symbolfile.SymbolFileParser(symbol_file, api_map, args.arch, api, args.llndk, args.apex).parse() except symbolfile.MultiplyDefinedSymbolError as ex: sys.exit(f'{args.symbol_file}: error: {ex}') with args.stub_src.open('w') as src_file: with args.version_script.open('w') as version_script: with args.symbol_list.open('w') as symbol_list: generator = Generator(src_file, version_script, symbol_list, args.arch, api, args.llndk, args.apex) generator.write(versions)
def test_parse_version(self) -> None: input_file = io.StringIO(textwrap.dedent("""\ VERSION_1 { # foo bar baz; qux; # woodly doodly }; VERSION_2 { } VERSION_1; # asdf """)) parser = symbolfile.SymbolFileParser(input_file, {}, Arch('arm'), 16, False, False) 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 = [ symbolfile.Symbol('baz', []), symbolfile.Symbol('qux', [Tag('woodly'), Tag('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_multiple_definition(self) -> None: input_file = io.StringIO( textwrap.dedent("""\ VERSION_1 { global: foo; foo; bar; baz; qux; # arm local: *; }; VERSION_2 { global: bar; qux; # arm64 } VERSION_1; VERSION_PRIVATE { global: baz; } VERSION_2; """)) parser = symbolfile.SymbolFileParser(input_file, {}, Arch('arm'), 16, False, False) with self.assertRaises( symbolfile.MultiplyDefinedSymbolError) as ex_context: parser.parse() self.assertEqual(['bar', 'foo'], ex_context.exception.multiply_defined_symbols)
def test_empty_stub(self) -> None: """Tests that empty stubs can be generated. This is not a common case, but libraries whose only behavior is to interpose symbols to alter existing behavior do not need to expose their interposing symbols as API, so it's possible for the stub to be empty while still needing a stub to link against. libsigchain is an example of this. """ input_file = io.StringIO(textwrap.dedent("""\ VERSION_1 { local: *; }; """)) parser = symbolfile.SymbolFileParser(input_file, {}, Arch('arm'), 9, llndk=False, apex=True) versions = parser.parse() src_file = io.StringIO() version_file = io.StringIO() symbol_list_file = io.StringIO() generator = ndkstubgen.Generator(src_file, version_file, symbol_list_file, Arch('arm'), 9, llndk=False, apex=True) generator.write(versions) self.assertEqual('', src_file.getvalue()) self.assertEqual('', version_file.getvalue())
def test_parse_version_eof(self) -> None: input_file = io.StringIO(textwrap.dedent("""\ VERSION_1 { """)) parser = symbolfile.SymbolFileParser(input_file, {}, Arch('arm'), 16, False, False) parser.next_line() with self.assertRaises(symbolfile.ParseError): parser.parse_version()
def test_wildcard_symbol_local(self) -> None: input_file = io.StringIO(textwrap.dedent("""\ VERSION_1 { local: *; }; """)) parser = symbolfile.SymbolFileParser(input_file, {}, Arch('arm'), 16, False, False) parser.next_line() version = parser.parse_version() self.assertEqual([], version.symbols)
def test_integration_future_api(self) -> None: api_map = { 'O': 9000, 'P': 9001, 'Q': 9002, } input_file = io.StringIO(textwrap.dedent("""\ VERSION_1 { global: foo; # introduced=O bar; # introduced=P baz; # introduced=Q local: *; }; """)) parser = symbolfile.SymbolFileParser(input_file, api_map, Arch('arm'), 9001, False, False) versions = parser.parse() src_file = io.StringIO() version_file = io.StringIO() symbol_list_file = io.StringIO() generator = ndkstubgen.Generator(src_file, version_file, symbol_list_file, Arch('arm'), 9001, False, False) generator.write(versions) expected_src = textwrap.dedent("""\ void foo() {} void bar() {} """) self.assertEqual(expected_src, src_file.getvalue()) expected_version = textwrap.dedent("""\ VERSION_1 { global: foo; bar; }; """) self.assertEqual(expected_version, version_file.getvalue()) expected_allowlist = textwrap.dedent("""\ [abi_symbol_list] foo bar """) self.assertEqual(expected_allowlist, symbol_list_file.getvalue())
def test_parse_symbol(self) -> None: input_file = io.StringIO(textwrap.dedent("""\ foo; bar; # baz qux """)) parser = symbolfile.SymbolFileParser(input_file, {}, Arch('arm'), 16, False, False) 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_parse_llndk_apex_symbol(self) -> None: input_file = io.StringIO(textwrap.dedent("""\ VERSION_1 { foo; bar; # llndk baz; # llndk apex qux; # apex }; """)) parser = symbolfile.SymbolFileParser(input_file, {}, Arch('arm'), 16, False, True) parser.next_line() version = parser.parse_version() self.assertEqual('VERSION_1', version.name) self.assertIsNone(version.base) expected_symbols = [ symbolfile.Symbol('foo', []), symbolfile.Symbol('bar', [Tag('llndk')]), symbolfile.Symbol('baz', [Tag('llndk'), Tag('apex')]), symbolfile.Symbol('qux', [Tag('apex')]), ] self.assertEqual(expected_symbols, version.symbols)
def test_next_line(self) -> None: input_file = io.StringIO(textwrap.dedent("""\ foo bar # baz qux """)) parser = symbolfile.SymbolFileParser(input_file, {}, Arch('arm'), 16, False, False) self.assertIsNone(parser.current_line) self.assertEqual('foo', parser.next_line().strip()) assert parser.current_line is not None 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_fails_invalid_input(self) -> None: with self.assertRaises(symbolfile.ParseError): input_file = io.StringIO('foo') parser = symbolfile.SymbolFileParser(input_file, {}, Arch('arm'), 16, False, False) parser.parse()
def test_integration_with_apex(self) -> None: api_map = { 'O': 9000, 'P': 9001, } input_file = io.StringIO( textwrap.dedent("""\ VERSION_1 { global: foo; # var bar; # x86 fizz; # introduced=O buzz; # introduced=P 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; # llndk waggle; # apex bubble; # apex llndk duddle; # llndk apex } VERSION_2; VERSION_5 { # versioned=14 wobble; } VERSION_4; """)) parser = symbolfile.SymbolFileParser(input_file, api_map, Arch('arm'), 9, False, True) versions = parser.parse() src_file = io.StringIO() version_file = io.StringIO() generator = ndkstubgen.Generator(src_file, version_file, Arch('arm'), 9, False, True) generator.write(versions) expected_src = textwrap.dedent("""\ int foo = 0; void baz() {} void qux() {} void wibble() {} void waggle() {} void bubble() {} void duddle() {} 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; waggle; bubble; duddle; } VERSION_2; """) self.assertEqual(expected_version, version_file.getvalue())