build/android/symbolize_test.py

   1 #!/usr/bin/env python
   2 #
   3 # Copyright 2013 The Chromium Authors. All rights reserved.
   4 # Use of this source code is governed by a BSD-style license that can be
   5 # found in the LICENSE file.
   6
   7 """Unittest for symbolize.py.
   8
   9 This test uses test libraries generated by the Android g++ toolchain.
  10
  11 Should things break you can recreate the libraries and get the updated
  12 addresses and demangled names by running the following:
  13   cd test/symbolize/
  14   make
  15   nm -gC *.so
  16 """
  17
  18 import StringIO
  19 import unittest
  20
  21 import symbolize
  22
  23 LIB_A_PATH = '/build/android/tests/symbolize/liba.so'
  24 LIB_B_PATH = '/build/android/tests/symbolize/libb.so'
  25
  26 def RunSymbolizer(text):
  27   output = StringIO.StringIO()
  28   s = symbolize.Symbolizer(output)
  29   s.write(text)
  30   return output.getvalue()
  31
  32
  33 class SymbolizerUnittest(unittest.TestCase):
  34   def testSingleLineNoMatch(self):
  35     # Leading '#' is required.
  36     expected = '00 0x00000000 ' + LIB_A_PATH + '+0x00000254\n'
  37     self.assertEqual(expected, RunSymbolizer(expected))
  38
  39     # Whitespace should be exactly one space.
  40     expected = '#00  0x00000000 ' + LIB_A_PATH + '+0x00000254\n'
  41     self.assertEqual(expected, RunSymbolizer(expected))
  42     expected = '#00 0x00000000  ' + LIB_A_PATH + '+0x00000254\n'
  43     self.assertEqual(expected, RunSymbolizer(expected))
  44
  45     # Decimal stack frame numbers are required.
  46     expected = '#0a 0x00000000 ' + LIB_A_PATH + '+0x00000254\n'
  47     self.assertEqual(expected, RunSymbolizer(expected))
  48
  49     # Hexadecimal addresses are required.
  50     expected = '#00 0xghijklmn ' + LIB_A_PATH + '+0x00000254\n'
  51     self.assertEqual(expected, RunSymbolizer(expected))
  52     expected = '#00 0x00000000 ' + LIB_A_PATH + '+0xghijklmn\n'
  53     self.assertEqual(expected, RunSymbolizer(expected))
  54
  55     # Addresses must be exactly 8 characters.
  56     expected = '#00 0x0000000 ' + LIB_A_PATH + '+0x00000254\n'
  57     self.assertEqual(expected, RunSymbolizer(expected))
  58     expected = '#00 0x000000000 ' + LIB_A_PATH + '+0x00000254\n'
  59     self.assertEqual(expected, RunSymbolizer(expected))
  60
  61     expected = '#00 0x0000000 ' + LIB_A_PATH + '+0x0000254\n'
  62     self.assertEqual(expected, RunSymbolizer(expected))
  63     expected = '#00 0x000000000 ' + LIB_A_PATH + '+0x000000254\n'
  64     self.assertEqual(expected, RunSymbolizer(expected))
  65
  66     # Addresses must be prefixed with '0x'.
  67     expected = '#00 00000000 ' + LIB_A_PATH + '+0x00000254\n'
  68     self.assertEqual(expected, RunSymbolizer(expected))
  69     expected = '#00 0x00000000 ' + LIB_A_PATH + '+00000254\n'
  70     self.assertEqual(expected, RunSymbolizer(expected))
  71
  72     # Library name is required.
  73     expected = '#00 0x00000000\n'
  74     self.assertEqual(expected, RunSymbolizer(expected))
  75     expected = '#00 0x00000000 +0x00000254\n'
  76     self.assertEqual(expected, RunSymbolizer(expected))
  77
  78     # Library name must be followed by offset with no spaces around '+'.
  79     expected = '#00 0x00000000 ' + LIB_A_PATH + ' +0x00000254\n'
  80     self.assertEqual(expected, RunSymbolizer(expected))
  81     expected = '#00 0x00000000 ' + LIB_A_PATH + '+ 0x00000254\n'
  82     self.assertEqual(expected, RunSymbolizer(expected))
  83     expected = '#00 0x00000000 ' + LIB_A_PATH + ' 0x00000254\n'
  84     self.assertEqual(expected, RunSymbolizer(expected))
  85     expected = '#00 0x00000000 ' + LIB_A_PATH + '+\n'
  86     self.assertEqual(expected, RunSymbolizer(expected))
  87
  88   def testSingleLine(self):
  89     text = '#00 0x00000000 ' + LIB_A_PATH + '+0x00000254\n'
  90     expected = '#00 0x00000000 A::Bar(char const*)\n'
  91     actual = RunSymbolizer(text)
  92     self.assertEqual(expected, actual)
  93
  94   def testSingleLineWithSurroundingText(self):
  95     text = 'LEFT #00 0x00000000 ' + LIB_A_PATH + '+0x00000254 RIGHT\n'
  96     expected = 'LEFT #00 0x00000000 A::Bar(char const*) RIGHT\n'
  97     actual = RunSymbolizer(text)
  98     self.assertEqual(expected, actual)
  99
 100   def testMultipleLinesSameLibrary(self):
 101     text = '#00 0x00000000 ' + LIB_A_PATH + '+0x00000254\n'
 102     text += '#01 0x00000000 ' + LIB_A_PATH + '+0x00000234\n'
 103     expected = '#00 0x00000000 A::Bar(char const*)\n'
 104     expected += '#01 0x00000000 A::Foo(int)\n'
 105     actual = RunSymbolizer(text)
 106     self.assertEqual(expected, actual)
 107
 108   def testMultipleLinesDifferentLibrary(self):
 109     text = '#00 0x00000000 ' + LIB_A_PATH + '+0x00000254\n'
 110     text += '#01 0x00000000 ' + LIB_B_PATH + '+0x00000234\n'
 111     expected = '#00 0x00000000 A::Bar(char const*)\n'
 112     expected += '#01 0x00000000 B::Baz(float)\n'
 113     actual = RunSymbolizer(text)
 114     self.assertEqual(expected, actual)
 115
 116   def testMultipleLinesWithSurroundingTextEverywhere(self):
 117     text = 'TOP\n'
 118     text += 'LEFT #00 0x00000000 ' + LIB_A_PATH + '+0x00000254 RIGHT\n'
 119     text += 'LEFT #01 0x00000000 ' + LIB_B_PATH + '+0x00000234 RIGHT\n'
 120     text += 'BOTTOM\n'
 121     expected = 'TOP\n'
 122     expected += 'LEFT #00 0x00000000 A::Bar(char const*) RIGHT\n'
 123     expected += 'LEFT #01 0x00000000 B::Baz(float) RIGHT\n'
 124     expected += 'BOTTOM\n'
 125     actual = RunSymbolizer(text)
 126     self.assertEqual(expected, actual)
 127
 128
 129 if __name__ == '__main__':
 130   unittest.main()