Home | History | Annotate | Download | only in python-vim-lldb
      1 
      2 # LLDB UI state in the Vim user interface.
      3 
      4 import os, re, sys
      5 import lldb
      6 import vim
      7 from vim_panes import *
      8 from vim_signs import *
      9 
     10 def is_same_file(a, b):
     11   """ returns true if paths a and b are the same file """
     12   a = os.path.realpath(a)
     13   b = os.path.realpath(b)
     14   return a in b or b in a
     15 
     16 class UI:
     17   def __init__(self):
     18     """ Declare UI state variables """
     19 
     20     # Default panes to display
     21     self.defaultPanes = ['breakpoints', 'backtrace', 'locals', 'threads', 'registers', 'disassembly']
     22 
     23     # map of tuples (filename, line) --> SBBreakpoint
     24     self.markedBreakpoints = {}
     25 
     26     # Currently shown signs
     27     self.breakpointSigns = {}
     28     self.pcSigns = []
     29 
     30     # Container for panes
     31     self.paneCol = PaneLayout()
     32 
     33     # All possible LLDB panes
     34     self.backtracePane = BacktracePane(self.paneCol)
     35     self.threadPane = ThreadPane(self.paneCol)
     36     self.disassemblyPane = DisassemblyPane(self.paneCol)
     37     self.localsPane = LocalsPane(self.paneCol)
     38     self.registersPane = RegistersPane(self.paneCol)
     39     self.breakPane = BreakpointsPane(self.paneCol)
     40 
     41   def activate(self):
     42     """ Activate UI: display default set of panes """
     43     self.paneCol.prepare(self.defaultPanes)
     44 
     45   def get_user_buffers(self, filter_name=None):
     46     """ Returns a list of buffers that are not a part of the LLDB UI. That is, they
     47         are not contained in the PaneLayout object self.paneCol.
     48     """
     49     ret = []
     50     for w in vim.windows:
     51       b = w.buffer
     52       if not self.paneCol.contains(b.name):
     53         if filter_name is None or filter_name in b.name:
     54           ret.append(b) 
     55     return ret
     56 
     57   def update_pc(self, process, buffers, goto_file):
     58     """ Place the PC sign on the PC location of each thread's selected frame """
     59 
     60     def GetPCSourceLocation(thread):
     61       """ Returns a tuple (thread_index, file, line, column) that represents where
     62           the PC sign should be placed for a thread.
     63       """
     64 
     65       frame = thread.GetSelectedFrame()
     66       frame_num = frame.GetFrameID()
     67       le = frame.GetLineEntry()
     68       while not le.IsValid() and frame_num < thread.GetNumFrames():
     69         frame_num += 1
     70         le = thread.GetFrameAtIndex(frame_num).GetLineEntry()
     71 
     72       if le.IsValid():
     73         path = os.path.join(le.GetFileSpec().GetDirectory(), le.GetFileSpec().GetFilename())
     74         return (thread.GetIndexID(), path, le.GetLine(), le.GetColumn())
     75       return None
     76 
     77 
     78     # Clear all existing PC signs
     79     del_list = []
     80     for sign in self.pcSigns:
     81       sign.hide()
     82       del_list.append(sign)
     83     for sign in del_list:
     84       self.pcSigns.remove(sign)
     85       del sign
     86 
     87     # Select a user (non-lldb) window 
     88     if not self.paneCol.selectWindow(False):
     89       # No user window found; avoid clobbering by splitting
     90       vim.command(":vsp")
     91 
     92     # Show a PC marker for each thread
     93     for thread in process:
     94       loc = GetPCSourceLocation(thread)
     95       if not loc:
     96         # no valid source locations for PCs. hide all existing PC markers
     97         continue
     98 
     99       buf = None
    100       (tid, fname, line, col) = loc
    101       buffers = self.get_user_buffers(fname)
    102       is_selected = thread.GetIndexID() == process.GetSelectedThread().GetIndexID()
    103       if len(buffers) == 1:
    104         buf = buffers[0]
    105         if buf != vim.current.buffer:
    106           # Vim has an open buffer to the required file: select it
    107           vim.command('execute ":%db"' % buf.number)
    108       elif is_selected and vim.current.buffer.name not in fname and os.path.exists(fname) and goto_file:
    109         # FIXME: If current buffer is modified, vim will complain when we try to switch away.
    110         #        Find a way to detect if the current buffer is modified, and...warn instead?
    111         vim.command('execute ":e %s"' % fname)
    112         buf = vim.current.buffer
    113       elif len(buffers) > 1 and goto_file:
    114         #FIXME: multiple open buffers match PC location
    115         continue
    116       else:
    117         continue
    118 
    119       self.pcSigns.append(PCSign(buf, line, is_selected))
    120 
    121       if is_selected and goto_file:
    122         # if the selected file has a PC marker, move the cursor there too
    123         curname = vim.current.buffer.name
    124         if curname is not None and is_same_file(curname, fname):
    125           move_cursor(line, 0)
    126         elif move_cursor:
    127           print "FIXME: not sure where to move cursor because %s != %s " % (vim.current.buffer.name, fname)
    128 
    129   def update_breakpoints(self, target, buffers):
    130     """ Decorates buffer with signs corresponding to breakpoints in target. """
    131 
    132     def GetBreakpointLocations(bp):
    133       """ Returns a list of tuples (resolved, filename, line) where a breakpoint was resolved. """
    134       if not bp.IsValid():
    135         sys.stderr.write("breakpoint is invalid, no locations")
    136         return []
    137 
    138       ret = []
    139       numLocs = bp.GetNumLocations()
    140       for i in range(numLocs):
    141         loc = bp.GetLocationAtIndex(i)
    142         desc = get_description(loc, lldb.eDescriptionLevelFull)
    143         match = re.search('at\ ([^:]+):([\d]+)', desc)
    144         try:
    145           lineNum = int(match.group(2).strip())
    146           ret.append((loc.IsResolved(), match.group(1), lineNum))
    147         except ValueError as e:
    148           sys.stderr.write("unable to parse breakpoint location line number: '%s'" % match.group(2))
    149           sys.stderr.write(str(e))
    150 
    151       return ret
    152 
    153 
    154     if target is None or not target.IsValid():
    155       return
    156 
    157     needed_bps = {}
    158     for bp_index in range(target.GetNumBreakpoints()):
    159       bp = target.GetBreakpointAtIndex(bp_index)
    160       locations = GetBreakpointLocations(bp)
    161       for (is_resolved, file, line) in GetBreakpointLocations(bp):
    162         for buf in buffers:
    163           if file in buf.name:
    164             needed_bps[(buf, line, is_resolved)] = bp
    165 
    166     # Hide any signs that correspond with disabled breakpoints
    167     del_list = []
    168     for (b, l, r) in self.breakpointSigns:
    169       if (b, l, r) not in needed_bps:
    170         self.breakpointSigns[(b, l, r)].hide()
    171         del_list.append((b, l, r))
    172     for d in del_list:
    173       del self.breakpointSigns[d]
    174       
    175     # Show any signs for new breakpoints
    176     for (b, l, r) in needed_bps:
    177       bp = needed_bps[(b, l, r)]
    178       if self.haveBreakpoint(b.name, l):
    179         self.markedBreakpoints[(b.name, l)].append(bp)
    180       else:
    181         self.markedBreakpoints[(b.name, l)] = [bp]
    182 
    183       if (b, l, r) not in self.breakpointSigns:
    184         s = BreakpointSign(b, l, r)
    185         self.breakpointSigns[(b, l, r)] = s
    186 
    187   def update(self, target, status, controller, goto_file=False):
    188     """ Updates debugger info panels and breakpoint/pc marks and prints
    189         status to the vim status line. If goto_file is True, the user's
    190         cursor is moved to the source PC location in the selected frame.
    191     """
    192 
    193     self.paneCol.update(target, controller)
    194     self.update_breakpoints(target, self.get_user_buffers())
    195 
    196     if target is not None and target.IsValid():
    197       process = target.GetProcess()
    198       if process is not None and process.IsValid():
    199         self.update_pc(process, self.get_user_buffers, goto_file)
    200 
    201     if status is not None and len(status) > 0:
    202       print status 
    203 
    204   def haveBreakpoint(self, file, line):
    205     """ Returns True if we have a breakpoint at file:line, False otherwise  """
    206     return (file, line) in self.markedBreakpoints
    207 
    208   def getBreakpoints(self, fname, line):
    209     """ Returns the LLDB SBBreakpoint object at fname:line """
    210     if self.haveBreakpoint(fname, line):
    211       return self.markedBreakpoints[(fname, line)]
    212     else:
    213       return None
    214 
    215   def deleteBreakpoints(self, name, line):
    216     del self.markedBreakpoints[(name, line)]
    217 
    218   def showWindow(self, name):
    219     """ Shows (un-hides) window pane specified by name """
    220     if not self.paneCol.havePane(name):
    221       sys.stderr.write("unknown window: %s" % name)
    222       return False
    223     self.paneCol.prepare([name])
    224     return True
    225 
    226   def hideWindow(self, name):
    227     """ Hides window pane specified by name """
    228     if not self.paneCol.havePane(name):
    229       sys.stderr.write("unknown window: %s" % name)
    230       return False
    231     self.paneCol.hide([name])
    232     return True
    233 
    234 global ui
    235 ui = UI()
    236