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