llvm-project

1
#!/usr/bin/env python
2

3
import lldb
4

5

6
class value(object):
7
    """A class that wraps an lldb.SBValue object and returns an object that
8
    can be used as an object with attribytes:\n
9
    argv = a.value(lldb.frame.FindVariable('argv'))\n
10
    argv.name - return the name of the value that this object contains\n
11
    argv.type - return the lldb.SBType for this value
12
    argv.type_name - return the name of the type
13
    argv.size - return the byte size of this value
14
    argv.is_in_scope - return true if this value is currently in scope
15
    argv.is_pointer - return true if this value is a pointer
16
    argv.format - return the current format for this value
17
    argv.value - return the value's value as a string
18
    argv.summary - return a summary of this value's value
19
    argv.description - return the runtime description for this value
20
    argv.location - return a string that represents the values location (address, register, etc)
21
    argv.target - return the lldb.SBTarget for this value
22
    argv.process - return the lldb.SBProcess for this value
23
    argv.thread - return the lldb.SBThread for this value
24
    argv.frame - return the lldb.SBFrame for this value
25
    argv.num_children - return the number of children this value has
26
    argv.children - return a list of sbvalue objects that represents all of the children of this value
27
    """
28

29
    def __init__(self, sbvalue):
30
        self.sbvalue = sbvalue
31

32
    def __nonzero__(self):
33
        return self.sbvalue.__nonzero__()
34

35
    def __repr__(self):
36
        return self.sbvalue.__repr__()
37

38
    def __str__(self):
39
        return self.sbvalue.__str__()
40

41
    def __getitem__(self, key):
42
        if isinstance(key, int):
43
            return value(self.sbvalue.GetChildAtIndex(key, lldb.eNoDynamicValues, True))
44
        raise TypeError
45

46
    def __getattr__(self, name):
47
        if name == "name":
48
            return self.sbvalue.GetName()
49
        if name == "type":
50
            return self.sbvalue.GetType()
51
        if name == "type_name":
52
            return self.sbvalue.GetTypeName()
53
        if name == "size":
54
            return self.sbvalue.GetByteSize()
55
        if name == "is_in_scope":
56
            return self.sbvalue.IsInScope()
57
        if name == "is_pointer":
58
            return self.sbvalue.TypeIsPointerType()
59
        if name == "format":
60
            return self.sbvalue.GetFormat()
61
        if name == "value":
62
            return self.sbvalue.GetValue()
63
        if name == "summary":
64
            return self.sbvalue.GetSummary()
65
        if name == "description":
66
            return self.sbvalue.GetObjectDescription()
67
        if name == "location":
68
            return self.sbvalue.GetLocation()
69
        if name == "target":
70
            return self.sbvalue.GetTarget()
71
        if name == "process":
72
            return self.sbvalue.GetProcess()
73
        if name == "thread":
74
            return self.sbvalue.GetThread()
75
        if name == "frame":
76
            return self.sbvalue.GetFrame()
77
        if name == "num_children":
78
            return self.sbvalue.GetNumChildren()
79
        if name == "children":
80
            # Returns an array of sbvalue objects, one for each child of
81
            # the value for the lldb.SBValue
82
            children = []
83
            for i in range(self.sbvalue.GetNumChildren()):
84
                children.append(
85
                    value(self.sbvalue.GetChildAtIndex(i, lldb.eNoDynamicValues, True))
86
                )
87
            return children
88
        raise AttributeError
89

90

91
class variable(object):
92
    '''A class that treats a lldb.SBValue and allows it to be used just as
93
    a variable would be in code. So if you have a Point structure variable
94
    in your code, you would be able to do: "pt.x + pt.y"'''
95

96
    def __init__(self, sbvalue):
97
        self.sbvalue = sbvalue
98

99
    def __nonzero__(self):
100
        return self.sbvalue.__nonzero__()
101

102
    def __repr__(self):
103
        return self.sbvalue.__repr__()
104

105
    def __str__(self):
106
        return self.sbvalue.__str__()
107

108
    def __getitem__(self, key):
109
        # Allow array access if this value has children...
110
        if isinstance(key, int):
111
            return variable(self.sbvalue.GetValueForExpressionPath("[%i]" % key))
112
        raise TypeError
113

114
    def __getattr__(self, name):
115
        child_sbvalue = self.sbvalue.GetChildMemberWithName(name)
116
        if child_sbvalue:
117
            return variable(child_sbvalue)
118
        raise AttributeError
119

120
    def __add__(self, other):
121
        return int(self) + int(other)
122

123
    def __sub__(self, other):
124
        return int(self) - int(other)
125

126
    def __mul__(self, other):
127
        return int(self) * int(other)
128

129
    def __floordiv__(self, other):
130
        return int(self) // int(other)
131

132
    def __mod__(self, other):
133
        return int(self) % int(other)
134

135
    def __divmod__(self, other):
136
        return int(self) % int(other)
137

138
    def __pow__(self, other):
139
        return int(self) ** int(other)
140

141
    def __lshift__(self, other):
142
        return int(self) << int(other)
143

144
    def __rshift__(self, other):
145
        return int(self) >> int(other)
146

147
    def __and__(self, other):
148
        return int(self) & int(other)
149

150
    def __xor__(self, other):
151
        return int(self) ^ int(other)
152

153
    def __or__(self, other):
154
        return int(self) | int(other)
155

156
    def __div__(self, other):
157
        return int(self) / int(other)
158

159
    def __truediv__(self, other):
160
        return int(self) / int(other)
161

162
    def __iadd__(self, other):
163
        result = self.__add__(other)
164
        self.sbvalue.SetValueFromCString(str(result))
165
        return result
166

167
    def __isub__(self, other):
168
        result = self.__sub__(other)
169
        self.sbvalue.SetValueFromCString(str(result))
170
        return result
171

172
    def __imul__(self, other):
173
        result = self.__mul__(other)
174
        self.sbvalue.SetValueFromCString(str(result))
175
        return result
176

177
    def __idiv__(self, other):
178
        result = self.__div__(other)
179
        self.sbvalue.SetValueFromCString(str(result))
180
        return result
181

182
    def __itruediv__(self, other):
183
        result = self.__truediv__(other)
184
        self.sbvalue.SetValueFromCString(str(result))
185
        return result
186

187
    def __ifloordiv__(self, other):
188
        result = self.__floordiv__(self, other)
189
        self.sbvalue.SetValueFromCString(str(result))
190
        return result
191

192
    def __imod__(self, other):
193
        result = self.__and__(self, other)
194
        self.sbvalue.SetValueFromCString(str(result))
195
        return result
196

197
    def __ipow__(self, other):
198
        result = self.__pow__(self, other)
199
        self.sbvalue.SetValueFromCString(str(result))
200
        return result
201

202
    def __ipow__(self, other, modulo):
203
        result = self.__pow__(self, other, modulo)
204
        self.sbvalue.SetValueFromCString(str(result))
205
        return result
206

207
    def __ilshift__(self, other):
208
        result = self.__lshift__(self, other)
209
        self.sbvalue.SetValueFromCString(str(result))
210
        return result
211

212
    def __irshift__(self, other):
213
        result = self.__rshift__(self, other)
214
        self.sbvalue.SetValueFromCString(str(result))
215
        return result
216

217
    def __iand__(self, other):
218
        result = self.__and__(self, other)
219
        self.sbvalue.SetValueFromCString(str(result))
220
        return result
221

222
    def __ixor__(self, other):
223
        result = self.__xor__(self, other)
224
        self.sbvalue.SetValueFromCString(str(result))
225
        return result
226

227
    def __ior__(self, other):
228
        result = self.__ior__(self, other)
229
        self.sbvalue.SetValueFromCString(str(result))
230
        return result
231

232
    def __neg__(self):
233
        return -int(self)
234

235
    def __pos__(self):
236
        return +int(self)
237

238
    def __abs__(self):
239
        return abs(int(self))
240

241
    def __invert__(self):
242
        return ~int(self)
243

244
    def __complex__(self):
245
        return complex(int(self))
246

247
    def __int__(self):
248
        return self.sbvalue.GetValueAsSigned()
249

250
    def __long__(self):
251
        return self.sbvalue.GetValueAsSigned()
252

253
    def __float__(self):
254
        return float(self.sbvalue.GetValueAsSigned())
255

256
    def __oct__(self):
257
        return "0%o" % self.sbvalue.GetValueAsSigned()
258

259
    def __hex__(self):
260
        return "0x%x" % self.sbvalue.GetValueAsSigned()
261