f98ee40f4b
This is an ongoing series of commits that are reformatting our Python code. This catches the last of the python files to reformat. Since they where so few I bunched them together. Reformatting is done with `black`. If you end up having problems merging this commit because you have made changes to a python file, the best way to handle that is to run git checkout --ours <yourfile> and then reformat it with black. If you run into any problems, post to discourse about it and we will try to help. RFC Thread below: https://discourse.llvm.org/t/rfc-document-and-standardize-python-code-style Reviewed By: jhenderson, #libc, Mordante, sivachandra Differential Revision: https://reviews.llvm.org/D150784
111 lines
2.7 KiB
Python
111 lines
2.7 KiB
Python
# DExTer : Debugging Experience Tester
|
|
# ~~~~~~ ~ ~~ ~ ~~
|
|
#
|
|
# Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
# See https://llvm.org/LICENSE.txt for license information.
|
|
# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
"""Classes which are used to represent debugger steps."""
|
|
|
|
import json
|
|
|
|
from collections import OrderedDict
|
|
from typing import List
|
|
from enum import Enum
|
|
from dex.dextIR.FrameIR import FrameIR
|
|
from dex.dextIR.LocIR import LocIR
|
|
from dex.dextIR.ProgramState import ProgramState
|
|
|
|
|
|
class StopReason(Enum):
|
|
BREAKPOINT = 0
|
|
STEP = 1
|
|
PROGRAM_EXIT = 2
|
|
ERROR = 3
|
|
OTHER = 4
|
|
|
|
|
|
class StepKind(Enum):
|
|
FUNC = 0
|
|
FUNC_EXTERNAL = 1
|
|
FUNC_UNKNOWN = 2
|
|
VERTICAL_FORWARD = 3
|
|
SAME = 4
|
|
VERTICAL_BACKWARD = 5
|
|
UNKNOWN = 6
|
|
HORIZONTAL_FORWARD = 7
|
|
HORIZONTAL_BACKWARD = 8
|
|
|
|
|
|
class StepIR:
|
|
"""A debugger step.
|
|
|
|
Args:
|
|
watches (OrderedDict): { expression (str), result (ValueIR) }
|
|
"""
|
|
|
|
def __init__(
|
|
self,
|
|
step_index: int,
|
|
stop_reason: StopReason,
|
|
frames: List[FrameIR],
|
|
step_kind: StepKind = None,
|
|
watches: OrderedDict = None,
|
|
program_state: ProgramState = None,
|
|
):
|
|
self.step_index = step_index
|
|
self.step_kind = step_kind
|
|
self.stop_reason = stop_reason
|
|
self.program_state = program_state
|
|
|
|
if frames is None:
|
|
frames = []
|
|
self.frames = frames
|
|
|
|
if watches is None:
|
|
watches = {}
|
|
self.watches = watches
|
|
|
|
def __str__(self):
|
|
try:
|
|
frame = self.current_frame
|
|
frame_info = (
|
|
frame.function,
|
|
frame.loc.path,
|
|
frame.loc.lineno,
|
|
frame.loc.column,
|
|
)
|
|
except AttributeError:
|
|
frame_info = (None, None, None, None)
|
|
|
|
step_info = (
|
|
(self.step_index,)
|
|
+ frame_info
|
|
+ (str(self.stop_reason), str(self.step_kind), [w for w in self.watches])
|
|
)
|
|
|
|
return "{}{}".format(". " * (self.num_frames - 1), json.dumps(step_info))
|
|
|
|
@property
|
|
def num_frames(self):
|
|
return len(self.frames)
|
|
|
|
@property
|
|
def current_frame(self):
|
|
if not len(self.frames):
|
|
return None
|
|
return self.frames[0]
|
|
|
|
@property
|
|
def current_function(self):
|
|
try:
|
|
return self.current_frame.function
|
|
except AttributeError:
|
|
return None
|
|
|
|
@property
|
|
def current_location(self):
|
|
try:
|
|
return self.current_frame.loc
|
|
except AttributeError:
|
|
return LocIR(path=None, lineno=None, column=None)
|