llvm/lldb/test/API/functionalities/data-formatter/data-formatter-skip-summary/TestDataFormatterSkipSummary.py

"""
Test lldb data formatter subsystem.
"""

import os
import lldb
from lldbsuite.test.decorators import *
from lldbsuite.test.lldbtest import *
from lldbsuite.test import lldbutil


class SkipSummaryDataFormatterTestCase(TestBase):
    @expectedFailureAll(
        oslist=["windows"],
        bugnumber="llvm.org/pr24462, Data formatters have problems on Windows",
    )
    def test_with_run_command(self):
        """Test data formatter commands."""
        self.build()
        self.data_formatter_commands()

    def setUp(self):
        # Call super's setUp().
        TestBase.setUp(self)
        # Find the line number to break at.
        self.line = line_number("main.cpp", "// Set break point at this line.")

    def data_formatter_commands(self):
        """Test that that file and class static variables display correctly."""
        self.runCmd("file " + self.getBuildArtifact("a.out"), CURRENT_EXECUTABLE_SET)

        # import lldbsuite.test.lldbutil as lldbutil
        lldbutil.run_break_set_by_file_and_line(
            self, "main.cpp", self.line, num_expected_locations=1, loc_exact=True
        )

        self.runCmd("run", RUN_SUCCEEDED)

        # The stop reason of the thread should be breakpoint.
        self.expect(
            "thread list",
            STOPPED_DUE_TO_BREAKPOINT,
            substrs=["stopped", "stop reason = breakpoint"],
        )

        # This is the function to remove the custom formats in order to have a
        # clean slate for the next test case.
        def cleanup():
            self.runCmd("type format clear", check=False)
            self.runCmd("type summary clear", check=False)

        # Execute the cleanup function during test case tear down.
        self.addTearDownHook(cleanup)

        # Setup the summaries for this scenario
        # self.runCmd("type summary add --summary-string \"${var._M_dataplus._M_p}\" std::string")
        self.runCmd('type summary add --summary-string "Level 1" "DeepData_1"')
        self.runCmd('type summary add --summary-string "Level 2" "DeepData_2" -e')
        self.runCmd('type summary add --summary-string "Level 3" "DeepData_3"')
        self.runCmd('type summary add --summary-string "Level 4" "DeepData_4"')
        self.runCmd('type summary add --summary-string "Level 5" "DeepData_5"')

        # Default case, just print out summaries
        self.expect(
            "frame variable",
            substrs=[
                "(DeepData_1) data1 = Level 1",
                "(DeepData_2) data2 = Level 2 {",
                "m_child1 = Level 3",
                "m_child2 = Level 3",
                "m_child3 = Level 3",
                "m_child4 = Level 3",
                "}",
            ],
        )

        # Skip the default (should be 1) levels of summaries
        self.expect(
            "frame variable --no-summary-depth",
            substrs=[
                "(DeepData_1) data1 = {",
                "m_child1 = 0x",
                "}",
                "(DeepData_2) data2 = {",
                "m_child1 = Level 3",
                "m_child2 = Level 3",
                "m_child3 = Level 3",
                "m_child4 = Level 3",
                "}",
            ],
        )

        # Now skip 2 levels of summaries
        self.expect(
            "frame variable --no-summary-depth=2",
            substrs=[
                "(DeepData_1) data1 = {",
                "m_child1 = 0x",
                "}",
                "(DeepData_2) data2 = {",
                "m_child1 = {",
                "m_child1 = 0x",
                "Level 4",
                "m_child2 = {",
                "m_child3 = {",
                "}",
            ],
        )

        # Check that no "Level 3" comes out
        self.expect(
            "frame variable data1.m_child1 --no-summary-depth=2",
            matching=False,
            substrs=["Level 3"],
        )

        # Now expand a pointer with 2 level of skipped summaries
        self.expect(
            "frame variable data1.m_child1 --no-summary-depth=2",
            substrs=["(DeepData_2 *) data1.m_child1 = 0x"],
        )

        # Deref and expand said pointer
        self.expect(
            "frame variable *data1.m_child1 --no-summary-depth=2",
            substrs=[
                "(DeepData_2) *data1.m_child1 = {",
                "m_child2 = {",
                "m_child1 = 0x",
                "Level 4",
                "}",
            ],
        )

        # Expand an expression, skipping 2 layers of summaries
        self.expect(
            "frame variable data1.m_child1->m_child2 --no-summary-depth=2",
            substrs=[
                "(DeepData_3) data1.m_child1->m_child2 = {",
                "m_child2 = {",
                "m_child1 = Level 5",
                "m_child2 = Level 5",
                "m_child3 = Level 5",
                "}",
            ],
        )

        # Expand same expression, skipping only 1 layer of summaries
        self.expect(
            "frame variable data1.m_child1->m_child2 --no-summary-depth=1",
            substrs=[
                "(DeepData_3) data1.m_child1->m_child2 = {",
                "m_child1 = 0x",
                "Level 4",
                "m_child2 = Level 4",
                "}",
            ],
        )

        # Bad debugging info on SnowLeopard gcc (Apple Inc. build 5666).
        # Skip the following tests if the condition is met.
        if self.getCompiler().endswith("gcc") and not self.getCompiler().endswith(
            "llvm-gcc"
        ):
            import re

            gcc_version_output = system([[lldbutil.which(self.getCompiler()), "-v"]])
            self.trace("my output:", gcc_version_output)
            for line in gcc_version_output.split(os.linesep):
                m = re.search("\(Apple Inc\. build ([0-9]+)\)", line)
                self.trace("line:", line)
                if m:
                    gcc_build = int(m.group(1))
                    self.trace("gcc build:", gcc_build)
                    if gcc_build >= 5666:
                        # rdar://problem/9804600"
                        self.skipTest(
                            "rdar://problem/9804600 wrong namespace for std::string in debug info"
                        )

        # Expand same expression, skipping 3 layers of summaries
        self.expect(
            "frame variable data1.m_child1->m_child2 --show-types --no-summary-depth=3",
            substrs=[
                "(DeepData_3) data1.m_child1->m_child2 = {",
                'm_some_text = "Just a test"',
                "m_child2 = {",
                'm_some_text = "Just a test"',
            ],
        )

        # Change summary and expand, first without --no-summary-depth then with
        # --no-summary-depth
        self.runCmd('type summary add --summary-string "${var.m_some_text}" DeepData_5')

        self.expect(
            "fr var data2.m_child4.m_child2.m_child2",
            substrs=['(DeepData_5) data2.m_child4.m_child2.m_child2 = "Just a test"'],
        )

        self.expect(
            "fr var data2.m_child4.m_child2.m_child2 --no-summary-depth",
            substrs=[
                "(DeepData_5) data2.m_child4.m_child2.m_child2 = {",
                'm_some_text = "Just a test"',
                "}",
            ],
        )