chromium/tools/lldb/lldb_viewg.py

# Copyright 2018 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.

"""
    Creates a SVG graph of the view hierarchy, when stopped in a
    method of an object that inherits from views::View. Requires
    graphviz.

    For more info see
    chromium/src/+/HEAD/docs/graphical_debugging_aid_chromium_views.md

    To make this command available, add the following to your ~/.lldbinit:
    command script import {Path to SRC Root}/tools/lldb/lldb_viewg.py

    Usage: type `viewg` at the LLDB prompt, given the conditions above.
"""

import lldb
import os

def view_graph(debugger, command, result, internal_dict):
  dot = os.path.expanduser("~/state.dot")
  svg = os.path.splitext(dot)[0] + ".svg"

  process = debugger.GetSelectedTarget().GetProcess()
  frame = process.GetSelectedThread().GetSelectedFrame()

  cstr_address = frame.EvaluateExpression("views::PrintViewGraph(this).c_str()")
  if not cstr_address.GetError().Success():
    return
  str_size = frame.EvaluateExpression("(size_t)strlen(%s)"
                                      % cstr_address.GetValue())
  if not str_size.GetError().Success():
    return
  error = lldb.SBError()
  dot_str = process.ReadCStringFromMemory(int(cstr_address.GetValue(), 16),
                                          str_size.GetValueAsUnsigned(), error)
  if not error.Success():
    return

  with open(dot, "w") as f:
    f.write(dot_str)
    os.system("dot -Tsvg -o %s %s" % (svg, dot))

def __lldb_init_module(debugger, internal_dict):
  debugger.HandleCommand('command script add -f lldb_viewg.view_graph viewg')