| """ |
| Tests for the lldb-server mock accelerator plugin. |
| |
| Verifies the accelerator-plugins+ feature in qSupported, |
| the jAcceleratorPluginInitialize packet response, and |
| the jAcceleratorPluginBreakpointHit round-trip. |
| """ |
| |
| import json |
| |
| import gdbremote_testcase |
| from lldbsuite.test.decorators import * |
| from lldbsuite.test.gdbclientutils import escape_binary |
| from lldbsuite.test.lldbtest import * |
| from lldbsuite.test import configuration |
| |
| |
| def get_accelerator_action(actions, plugin_name): |
| for action in actions: |
| if action["plugin_name"] == plugin_name: |
| return action |
| return None |
| |
| |
| class MockAcceleratorPluginTestCase(gdbremote_testcase.GdbRemoteTestCaseBase): |
| def setUp(self): |
| super().setUp() |
| if "mock-accelerator" not in configuration.enabled_plugins: |
| self.skipTest("mock-accelerator plugin is not enabled") |
| |
| def send_and_decode_json(self, packet): |
| """Send a packet and return the decoded JSON response.""" |
| self.test_sequence.add_log_lines( |
| [ |
| "read packet: $%s#00" % packet, |
| { |
| "direction": "send", |
| "regex": r"^\$(.+)#[0-9a-fA-F]{2}", |
| "capture": {1: "response"}, |
| }, |
| ], |
| True, |
| ) |
| context = self.expect_gdbremote_sequence() |
| raw = context.get("response") |
| self.assertIsNotNone(raw) |
| return json.loads(self.decode_gdbremote_binary(raw)) |
| |
| @add_test_categories(["llgs"]) |
| def test_qSupported_reports_accelerator_plugins(self): |
| self.build() |
| self.set_inferior_startup_launch() |
| self.prep_debug_monitor_and_inferior() |
| |
| self.add_qSupported_packets() |
| context = self.expect_gdbremote_sequence() |
| features = self.parse_qSupported_response(context) |
| |
| self.assertIn("accelerator-plugins", features) |
| self.assertEqual(features["accelerator-plugins"], "+") |
| |
| @add_test_categories(["llgs"]) |
| def test_jAcceleratorPluginInitialize_returns_breakpoints(self): |
| self.build() |
| self.set_inferior_startup_launch() |
| self.prep_debug_monitor_and_inferior() |
| |
| self.add_qSupported_packets() |
| self.expect_gdbremote_sequence() |
| |
| actions = self.send_and_decode_json("jAcceleratorPluginInitialize") |
| self.assertIsInstance(actions, list) |
| |
| mock_action = get_accelerator_action(actions, "mock") |
| self.assertIsNotNone(mock_action) |
| self.assertIn("breakpoints", mock_action) |
| |
| breakpoints = mock_action["breakpoints"] |
| self.assertGreater(len(breakpoints), 0) |
| |
| bp = breakpoints[0] |
| self.assertIn("identifier", bp) |
| self.assertIn("by_name", bp) |
| self.assertEqual(bp["by_name"]["function_name"], "main") |
| |
| @add_test_categories(["llgs"]) |
| def test_jAcceleratorPluginBreakpointHit_response(self): |
| self.build() |
| self.set_inferior_startup_launch() |
| self.prep_debug_monitor_and_inferior() |
| |
| self.add_qSupported_packets() |
| self.expect_gdbremote_sequence() |
| |
| hit_args = { |
| "plugin_name": "mock", |
| "breakpoint": { |
| "identifier": 1, |
| "symbol_names": [], |
| }, |
| "symbol_values": [], |
| } |
| hit_json = json.dumps(hit_args, separators=(",", ":")) |
| escaped_json = escape_binary(hit_json) |
| response = self.send_and_decode_json( |
| "jAcceleratorPluginBreakpointHit:" + escaped_json |
| ) |
| |
| self.assertIn("disable_bp", response) |
| self.assertTrue(response["disable_bp"]) |
| self.assertIn("auto_resume_native", response) |
| self.assertFalse(response["auto_resume_native"]) |
| |
| # Verify that the response includes new actions with a breakpoint. |
| self.assertIn("actions", response) |
| actions = response["actions"] |
| self.assertEqual(actions["plugin_name"], "mock") |
| self.assertIn("breakpoints", actions) |
| new_bps = actions["breakpoints"] |
| self.assertGreater(len(new_bps), 0) |
| self.assertEqual(new_bps[0]["identifier"], 2) |
| self.assertEqual(new_bps[0]["by_name"]["function_name"], "exit") |
