From 061da546b983eb767bad15e67af1174fb0bcf31c Mon Sep 17 00:00:00 2001 From: patrick Date: Mon, 3 Aug 2020 14:33:06 +0000 Subject: Import LLVM 10.0.0 release including clang, lld and lldb. ok hackroom tested by plenty --- .../lldbsuite/test/commands/help/TestHelp.py | 265 +++++++++++++++++++++ 1 file changed, 265 insertions(+) create mode 100644 gnu/llvm/lldb/packages/Python/lldbsuite/test/commands/help/TestHelp.py (limited to 'gnu/llvm/lldb/packages/Python/lldbsuite/test/commands/help/TestHelp.py') diff --git a/gnu/llvm/lldb/packages/Python/lldbsuite/test/commands/help/TestHelp.py b/gnu/llvm/lldb/packages/Python/lldbsuite/test/commands/help/TestHelp.py new file mode 100644 index 00000000000..31656af633c --- /dev/null +++ b/gnu/llvm/lldb/packages/Python/lldbsuite/test/commands/help/TestHelp.py @@ -0,0 +1,265 @@ +""" +Test some lldb help commands. + +See also CommandInterpreter::OutputFormattedHelpText(). +""" + + + +import os +import lldb +from lldbsuite.test.decorators import * +from lldbsuite.test.lldbtest import * +from lldbsuite.test import lldbutil + + +class HelpCommandTestCase(TestBase): + + mydir = TestBase.compute_mydir(__file__) + + @no_debug_info_test + def test_simplehelp(self): + """A simple test of 'help' command and its output.""" + self.expect("help", + startstr='Debugger commands:') + + self.expect("help -a", matching=False, + substrs=['next']) + + self.expect("help", matching=True, + substrs=['next']) + + @no_debug_info_test + def test_help_on_help(self): + """Testing the help on the help facility.""" + self.expect("help help", matching=True, + substrs=['--hide-aliases', + '--hide-user-commands']) + + @no_debug_info_test + def version_number_string(self): + """Helper function to find the version number string of lldb.""" + plist = os.path.join( + os.environ["LLDB_SRC"], + "resources", + "LLDB-Info.plist") + try: + CFBundleVersionSegFound = False + with open(plist, 'r') as f: + for line in f: + if CFBundleVersionSegFound: + version_line = line.strip() + import re + m = re.match("(.*)", version_line) + if m: + version = m.group(1) + return version + else: + # Unsuccessful, let's juts break out of the for + # loop. + break + + if line.find("CFBundleVersion") != -1: + # Found our match. The next line contains our version + # string, for example: + # + # 38 + CFBundleVersionSegFound = True + + except: + # Just fallthrough... + import traceback + traceback.print_exc() + + # Use None to signify that we are not able to grok the version number. + return None + + @no_debug_info_test + def test_help_arch(self): + """Test 'help arch' which should list of supported architectures.""" + self.expect("help arch", + substrs=['arm', 'x86_64', 'i386']) + + @no_debug_info_test + def test_help_version(self): + """Test 'help version' and 'version' commands.""" + self.expect("help version", + substrs=['Show the LLDB debugger version.']) + import re + version_str = self.version_number_string() + match = re.match('[0-9]+', version_str) + search_regexp = ['lldb( version|-' + (version_str if match else '[0-9]+') + ').*\n'] + + self.expect("version", + patterns=search_regexp) + + @no_debug_info_test + def test_help_should_not_crash_lldb(self): + """Command 'help disasm' should not crash lldb.""" + self.runCmd("help disasm", check=False) + self.runCmd("help unsigned-integer") + + @no_debug_info_test + def test_help_should_not_hang_emacsshell(self): + """Command 'settings set term-width 0' should not hang the help command.""" + self.expect( + "settings set term-width 0", + COMMAND_FAILED_AS_EXPECTED, + error=True, + substrs=['error: 0 is out of range, valid values must be between']) + # self.runCmd("settings set term-width 0") + self.expect("help", + startstr='Debugger commands:') + + @no_debug_info_test + def test_help_breakpoint_set(self): + """Test that 'help breakpoint set' does not print out redundant lines of: + 'breakpoint set [-s ] ...'.""" + self.expect("help breakpoint set", matching=False, + substrs=['breakpoint set [-s ]']) + + @no_debug_info_test + def test_help_image_dump_symtab_should_not_crash(self): + """Command 'help image dump symtab' should not crash lldb.""" + # 'image' is an alias for 'target modules'. + self.expect("help image dump symtab", + substrs=['dump symtab', + 'sort-order']) + + @no_debug_info_test + def test_help_image_du_sym_is_ambiguous(self): + """Command 'help image du sym' is ambiguous and spits out the list of candidates.""" + self.expect("help image du sym", + COMMAND_FAILED_AS_EXPECTED, error=True, + substrs=['error: ambiguous command image du sym', + 'symfile', + 'symtab']) + + @no_debug_info_test + def test_help_image_du_line_should_work(self): + """Command 'help image du line-table' is not ambiguous and should work.""" + # 'image' is an alias for 'target modules'. + self.expect("help image du line", substrs=[ + 'Dump the line table for one or more compilation units']) + + @no_debug_info_test + def test_help_target_variable_syntax(self): + """Command 'help target variable' should display ...""" + self.expect("help target variable", + substrs=[' [ [...]]']) + + @no_debug_info_test + def test_help_watchpoint_and_its_args(self): + """Command 'help watchpoint', 'help watchpt-id', and 'help watchpt-id-list' should work.""" + self.expect("help watchpoint", + substrs=['delete', 'disable', 'enable', 'list']) + self.expect("help watchpt-id", + substrs=['']) + self.expect("help watchpt-id-list", + substrs=['']) + + @no_debug_info_test + def test_help_watchpoint_set(self): + """Test that 'help watchpoint set' prints out 'expression' and 'variable' + as the possible subcommands.""" + self.expect("help watchpoint set", + substrs=['The following subcommands are supported:'], + patterns=['expression +--', + 'variable +--']) + + @no_debug_info_test + def test_help_po_hides_options(self): + """Test that 'help po' does not show all the options for expression""" + self.expect( + "help po", + substrs=[ + '--show-all-children', + '--object-description'], + matching=False) + + @no_debug_info_test + def test_help_run_hides_options(self): + """Test that 'help run' does not show all the options for process launch""" + self.expect("help run", + substrs=['--arch', '--environment'], matching=False) + + @no_debug_info_test + def test_help_next_shows_options(self): + """Test that 'help next' shows all the options for thread step-over""" + self.expect("help next", + substrs=['--step-out-avoids-no-debug', '--run-mode'], matching=True) + + @no_debug_info_test + def test_help_provides_alternatives(self): + """Test that help on commands that don't exist provides information on additional help avenues""" + self.expect( + "help thisisnotadebuggercommand", + substrs=[ + "'thisisnotadebuggercommand' is not a known command.", + "Try 'help' to see a current list of commands.", + "Try 'apropos thisisnotadebuggercommand' for a list of related commands.", + "Try 'type lookup thisisnotadebuggercommand' for information on types, methods, functions, modules, etc."], + error=True) + + self.expect( + "help process thisisnotadebuggercommand", + substrs=[ + "'process thisisnotadebuggercommand' is not a known command.", + "Try 'help' to see a current list of commands.", + "Try 'apropos thisisnotadebuggercommand' for a list of related commands.", + "Try 'type lookup thisisnotadebuggercommand' for information on types, methods, functions, modules, etc."]) + + @no_debug_info_test + def test_custom_help_alias(self): + """Test that aliases pick up custom help text.""" + def cleanup(): + self.runCmd('command unalias afriendlyalias', check=False) + self.runCmd('command unalias averyfriendlyalias', check=False) + + self.addTearDownHook(cleanup) + self.runCmd( + 'command alias --help "I am a friendly alias" -- afriendlyalias help') + self.expect( + "help afriendlyalias", + matching=True, + substrs=['I am a friendly alias']) + self.runCmd( + 'command alias --long-help "I am a very friendly alias" -- averyfriendlyalias help') + self.expect("help averyfriendlyalias", matching=True, + substrs=['I am a very friendly alias']) + @no_debug_info_test + def test_alias_prints_origin(self): + """Test that 'help ' prints the alias origin.""" + def cleanup(): + self.runCmd('command unalias alongaliasname', check=False) + + self.addTearDownHook(cleanup) + self.runCmd('command alias alongaliasname help') + self.expect("help alongaliasna", matching=True, + substrs=["'alongaliasna' is an abbreviation for 'help'"]) + + @no_debug_info_test + def test_hidden_help(self): + self.expect("help -h", + substrs=["_regexp-bt"]) + + @no_debug_info_test + def test_help_ambiguous(self): + self.expect("help g", + substrs=["Help requested with ambiguous command name, possible completions:", + "gdb-remote", "gui"]) + + @no_debug_info_test + def test_help_unknown_flag(self): + self.expect("help -z", error=True, + substrs=["unknown or ambiguous option"]) + + @no_debug_info_test + def test_help_format_output(self): + """Test that help output reaches TerminalWidth.""" + self.runCmd( + 'settings set term-width 108') + self.expect( + "help format", + matching=True, + substrs=[' -- One of the format names']) -- cgit v1.2.3-59-g8ed1b