"""Base class for all debugger interface implementations."""
import abc
+import os
import sys
import traceback
+import unittest
-from dex.dextIR import DebuggerIR, ValueIR
+from types import SimpleNamespace
+from dex.dextIR import DebuggerIR, FrameIR, LocIR, StepIR, ValueIR
from dex.utils.Exceptions import DebuggerException
from dex.utils.Exceptions import NotYetLoadedDebuggerException
from dex.utils.ReturnCode import ReturnCode
class DebuggerBase(object, metaclass=abc.ABCMeta):
def __init__(self, context):
self.context = context
+ # Note: We can't already read values from options
+ # as DebuggerBase is created before we initialize options
+ # to read potential_debuggers.
+ self.options = self.context.options
+
self._interface = None
self.has_loaded = False
self._loading_error = NotYetLoadedDebuggerException()
def clear_breakpoints(self):
pass
- @abc.abstractmethod
def add_breakpoint(self, file_, line):
- pass
+ return self._add_breakpoint(self._external_to_debug_path(file_), line)
@abc.abstractmethod
- def add_conditional_breakpoint(self, file_, line, condition):
+ def _add_breakpoint(self, file_, line):
pass
+ def add_conditional_breakpoint(self, file_, line, condition):
+ return self._add_conditional_breakpoint(
+ self._external_to_debug_path(file_), line, condition)
+
@abc.abstractmethod
+ def _add_conditional_breakpoint(self, file_, line, condition):
+ pass
+
def delete_conditional_breakpoint(self, file_, line, condition):
+ return self._delete_conditional_breakpoint(
+ self._external_to_debug_path(file_), line, condition)
+
+ @abc.abstractmethod
+ def _delete_conditional_breakpoint(self, file_, line, condition):
pass
@abc.abstractmethod
def go(self) -> ReturnCode:
pass
- @abc.abstractmethod
def get_step_info(self, watches, step_index):
+ step_info = self._get_step_info(watches, step_index)
+ for frame in step_info.frames:
+ frame.loc.path = self._debug_to_external_path(frame.loc.path)
+ return step_info
+
+ @abc.abstractmethod
+ def _get_step_info(self, watches, step_index):
pass
@abc.abstractproperty
@abc.abstractmethod
def evaluate_expression(self, expression, frame_idx=0) -> ValueIR:
pass
+
+ def _external_to_debug_path(self, path):
+ root_dir = self.options.source_root_dir
+ if not root_dir or not path:
+ return path
+ assert path.startswith(root_dir)
+ return path[len(root_dir):].lstrip(os.path.sep)
+
+ def _debug_to_external_path(self, path):
+ if not path or not self.options.source_root_dir:
+ return path
+ for file in self.options.source_files:
+ if path.endswith(self._external_to_debug_path(file)):
+ return file
+ return path
+
+class TestDebuggerBase(unittest.TestCase):
+
+ class MockDebugger(DebuggerBase):
+
+ def __init__(self, context, *args):
+ super().__init__(context, *args)
+ self.step_info = None
+ self.breakpoint_file = None
+
+ def _add_breakpoint(self, file, line):
+ self.breakpoint_file = file
+
+ def _get_step_info(self, watches, step_index):
+ return self.step_info
+
+ def __init__(self, *args):
+ super().__init__(*args)
+ TestDebuggerBase.MockDebugger.__abstractmethods__ = set()
+ self.options = SimpleNamespace(source_root_dir = '', source_files = [])
+ context = SimpleNamespace(options = self.options)
+ self.dbg = TestDebuggerBase.MockDebugger(context)
+
+ def _new_step(self, paths):
+ frames = [
+ FrameIR(
+ function=None,
+ is_inlined=False,
+ loc=LocIR(path=path, lineno=0, column=0)) for path in paths
+ ]
+ return StepIR(step_index=0, stop_reason=None, frames=frames)
+
+ def _step_paths(self, step):
+ return [frame.loc.path for frame in step.frames]
+
+ def test_add_breakpoint_no_source_root_dir(self):
+ self.options.source_root_dir = ''
+ self.dbg.add_breakpoint('/root/some_file', 12)
+ self.assertEqual('/root/some_file', self.dbg.breakpoint_file)
+
+ def test_add_breakpoint_with_source_root_dir(self):
+ self.options.source_root_dir = '/my_root'
+ self.dbg.add_breakpoint('/my_root/some_file', 12)
+ self.assertEqual('some_file', self.dbg.breakpoint_file)
+
+ def test_add_breakpoint_with_source_root_dir_slash_suffix(self):
+ self.options.source_root_dir = '/my_root/'
+ self.dbg.add_breakpoint('/my_root/some_file', 12)
+ self.assertEqual('some_file', self.dbg.breakpoint_file)
+
+ def test_get_step_info_no_source_root_dir(self):
+ self.dbg.step_info = self._new_step(['/root/some_file'])
+ self.assertEqual(['/root/some_file'],
+ self._step_paths(self.dbg.get_step_info([], 0)))
+
+ def test_get_step_info_no_frames(self):
+ self.options.source_root_dir = '/my_root'
+ self.dbg.step_info = self._new_step([])
+ self.assertEqual([],
+ self._step_paths(self.dbg.get_step_info([], 0)))
+
+ def test_get_step_info(self):
+ self.options.source_root_dir = '/my_root'
+ self.options.source_files = ['/my_root/some_file']
+ self.dbg.step_info = self._new_step(
+ [None, '/other/file', '/dbg/some_file'])
+ self.assertEqual([None, '/other/file', '/my_root/some_file'],
+ self._step_paths(self.dbg.get_step_info([], 0)))
x.RemoveFlags(breakpoint.BreakpointFlags.DEBUG_BREAKPOINT_ENABLED)
self.client.Control.RemoveBreakpoint(x)
- def add_breakpoint(self, file_, line):
+ def _add_breakpoint(self, file_, line):
# Breakpoint setting/deleting is not supported by dbgeng at this moment
# but is something that should be considered in the future.
# TODO: this method is called in the DefaultController but has no effect.
pass
- def add_conditional_breakpoint(self, file_, line, condition):
+ def _add_conditional_breakpoint(self, file_, line, condition):
# breakpoint setting/deleting is not supported by dbgeng at this moment
# but is something that should be considered in the future.
raise NotImplementedError('add_conditional_breakpoint is not yet implemented by dbgeng')
- def delete_conditional_breakpoint(self, file_, line, condition):
+ def _delete_conditional_breakpoint(self, file_, line, condition):
# breakpoint setting/deleting is not supported by dbgeng at this moment
# but is something that should be considered in the future.
raise NotImplementedError('delete_conditional_breakpoint is not yet implemented by dbgeng')
# We never go -- we always single step.
pass
- def get_step_info(self, watches, step_index):
+ def _get_step_info(self, watches, step_index):
frames = self.step_info
state_frames = []
def clear_breakpoints(self):
self._target.DeleteAllBreakpoints()
- def add_breakpoint(self, file_, line):
+ def _add_breakpoint(self, file_, line):
if not self._target.BreakpointCreateByLocation(file_, line):
raise DebuggerException(
'could not add breakpoint [{}:{}]'.format(file_, line))
- def add_conditional_breakpoint(self, file_, line, condition):
+ def _add_conditional_breakpoint(self, file_, line, condition):
bp = self._target.BreakpointCreateByLocation(file_, line)
if bp:
bp.SetCondition(condition)
raise DebuggerException(
'could not add breakpoint [{}:{}]'.format(file_, line))
- def delete_conditional_breakpoint(self, file_, line, condition):
+ def _delete_conditional_breakpoint(self, file_, line, condition):
bp_count = self._target.GetNumBreakpoints()
bps = [self._target.GetBreakpointAtIndex(ix) for ix in range(0, bp_count)]
self._process.Continue()
return ReturnCode.OK
- def get_step_info(self, watches, step_index):
+ def _get_step_info(self, watches, step_index):
frames = []
state_frames = []
for bp in self._debugger.Breakpoints:
bp.Delete()
- def add_breakpoint(self, file_, line):
+ def _add_breakpoint(self, file_, line):
self._debugger.Breakpoints.Add('', file_, line)
- def add_conditional_breakpoint(self, file_, line, condition):
+ def _add_conditional_breakpoint(self, file_, line, condition):
column = 1
self._debugger.Breakpoints.Add('', file_, line, column, condition)
- def delete_conditional_breakpoint(self, file_, line, condition):
+ def _delete_conditional_breakpoint(self, file_, line, condition):
for bp in self._debugger.Breakpoints:
for bound_bp in bp.Children:
if (bound_bp.File == file_ and bound_bp.FileLine == line and
raise Error('attempted to access stack frame {} out of {}'
.format(idx, len(stack_frames)))
- def get_step_info(self, watches, step_index):
+ def _get_step_info(self, watches, step_index):
thread = self._debugger.CurrentThread
stackframes = thread.StackFrames