Merge branch 'addmainunit3-altlink-sharedstmt-dieref-dwz3' into addmainunit3-altlink...
[lldb.git] / lldb / packages / Python / lldbsuite / test / test_categories.py
1 """
2 Provides definitions for various lldb test categories
3 """
4
5 from __future__ import absolute_import
6 from __future__ import print_function
7
8 # System modules
9 import sys
10
11 # Third-party modules
12
13 # LLDB modules
14 from lldbsuite.support import gmodules
15
16
17 debug_info_categories = [
18     'dwarf', 'dwo', 'dsym', 'gmodules', 'dwz'
19 ]
20
21 all_categories = {
22     'basic_process': 'Basic process execution sniff tests.',
23     'cmdline': 'Tests related to the LLDB command-line interface',
24     'darwin-log': 'Darwin log tests',
25     'dataformatters': 'Tests related to the type command and the data formatters subsystem',
26     'debugserver': 'Debugserver tests',
27     'dsym': 'Tests that can be run with DSYM debug information',
28     'dwarf': 'Tests that can be run with DWARF debug information',
29     'dwo': 'Tests that can be run with DWO debug information',
30     'dwz': 'Tests using DWZ and its DWARF partial units',
31     'dyntype': 'Tests related to dynamic type support',
32     'expression': 'Tests related to the expression parser',
33     'flakey': 'Flakey test cases, i.e. tests that do not reliably pass at each execution',
34     'gmodules': 'Tests that can be run with -gmodules debug information',
35     'instrumentation-runtime': 'Tests for the instrumentation runtime plugins',
36     'libc++': 'Test for libc++ data formatters',
37     'libstdcxx': 'Test for libstdcxx data formatters',
38     'lldb-server': 'Tests related to lldb-server',
39     'lldb-vscode': 'Visual Studio Code debug adaptor tests',
40     'llgs': 'Tests for the gdb-server functionality of lldb-server',
41     'objc': 'Tests related to the Objective-C programming language support',
42     'pyapi': 'Tests related to the Python API',
43     'std-module': 'Tests related to importing the std module',
44     'stresstest': 'Tests related to stressing lldb limits',
45     'watchpoint': 'Watchpoint-related tests',
46 }
47
48
49 def unique_string_match(yourentry, list):
50     candidate = None
51     for item in list:
52         if not item.startswith(yourentry):
53             continue
54         if candidate:
55             return None
56         candidate = item
57     return candidate
58
59
60 def is_supported_on_platform(category, platform, compiler_path):
61     if category == "dwo":
62         # -gsplit-dwarf is not implemented by clang on Windows.
63         return platform in ["linux", "freebsd"]
64     elif category == "dsym":
65         return platform in ["darwin", "macosx", "ios", "watchos", "tvos", "bridgeos"]
66     elif category == "gmodules":
67         # First, check to see if the platform can even support gmodules.
68         if platform not in ["freebsd", "darwin", "macosx", "ios", "watchos", "tvos", "bridgeos"]:
69             return False
70         return gmodules.is_compiler_clang_with_gmodules(compiler_path)
71     elif category == "dwz":
72         return platform in ["linux"]
73     return True
74
75
76 def validate(categories, exact_match):
77     """
78     For each category in categories, ensure that it's a valid category (if exact_match is false,
79     unique prefixes are also accepted). If a category is invalid, print a message and quit.
80        If all categories are valid, return the list of categories. Prefixes are expanded in the
81        returned list.
82     """
83     result = []
84     for category in categories:
85         origCategory = category
86         if category not in all_categories and not exact_match:
87             category = unique_string_match(category, all_categories)
88         if (category not in all_categories) or category is None:
89             print(
90                 "fatal error: category '" +
91                 origCategory +
92                 "' is not a valid category")
93             print("if you have added a new category, please edit test_categories.py, adding your new category to all_categories")
94             print("else, please specify one or more of the following: " +
95                   str(list(all_categories.keys())))
96             sys.exit(1)
97         result.append(category)
98     return result