aboutsummaryrefslogtreecommitdiff
path: root/packages/Python/lldbsuite/test/test_categories.py
blob: 0a85293109e7da0ecbe092642aa534c0e34ac1f4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
"""
Provides definitions for various lldb test categories
"""

from __future__ import absolute_import
from __future__ import print_function

# System modules
import sys

# Third-party modules

# LLDB modules
from lldbsuite.support import gmodules


debug_info_categories = [
    'dwarf', 'dwo', 'dsym', 'gmodules'
]

all_categories = {
    'dataformatters': 'Tests related to the type command and the data formatters subsystem',
    'dwarf'         : 'Tests that can be run with DWARF debug information',
    'dwo'           : 'Tests that can be run with DWO debug information',
    'dsym'          : 'Tests that can be run with DSYM debug information',
    'gmodules'      : 'Tests that can be run with -gmodules debug information',
    'expression'    : 'Tests related to the expression parser',
    'objc'          : 'Tests related to the Objective-C programming language support',
    'pyapi'         : 'Tests related to the Python API',
    'basic_process' : 'Basic process execution sniff tests.',
    'cmdline'       : 'Tests related to the LLDB command-line interface',
    'dyntype'       : 'Tests related to dynamic type support',
    'stresstest'    : 'Tests related to stressing lldb limits',
    'flakey'        : 'Flakey test cases, i.e. tests that do not reliably pass at each execution',
    'lldb-mi'       : 'lldb-mi tests'
}

def unique_string_match(yourentry, list):
    candidate = None
    for item in list:
        if not item.startswith(yourentry):
            continue
        if candidate:
            return None
        candidate = item
    return candidate


def is_supported_on_platform(category, platform, compiler_paths):
    if category == "dwo":
        # -gsplit-dwarf is not implemented by clang on Windows.
        return platform in ["linux", "freebsd"]
    elif category == "dsym":
        return platform in ["darwin", "macosx", "ios"]
    elif category == "gmodules":
        # First, check to see if the platform can even support gmodules.
        if platform not in ["linux", "freebsd", "darwin", "macosx", "ios"]:
            return False
        # If all compilers specified support gmodules, we'll enable it.
        for compiler_path in compiler_paths:
            if not gmodules.is_compiler_clang_with_gmodules(compiler_path):
                # Ideally in a multi-compiler scenario during a single test run, this would
                # allow gmodules on compilers that support it and not on ones that don't.
                # However, I didn't see an easy way for all the callers of this to know
                # the compiler being used for a test invocation.  As we tend to run with
                # a single compiler per test run, this shouldn't be a major issue.
                return False
        return True
    return True

def validate(categories, exact_match):
    """
    For each category in categories, ensure that it's a valid category (if exact_match is false,
    unique prefixes are also accepted). If a category is invalid, print a message and quit.
       If all categories are valid, return the list of categories. Prefixes are expanded in the
       returned list.
    """
    result = []
    for category in categories:
        origCategory = category
        if category not in all_categories and not exact_match:
            category = unique_string_match(category, all_categories)
        if (category not in all_categories) or category == None:
            print("fatal error: category '" + origCategory + "' is not a valid category")
            print("if you have added a new category, please edit test_categories.py, adding your new category to all_categories")
            print("else, please specify one or more of the following: " + str(list(all_categories.keys())))
            sys.exit(1)
        result.append(category)
    return result