Commit | Line | Data |
---|---|---|
bc3b79fd TJB |
1 | /* Convenience functions implemented in Python. |
2 | ||
4c38e0a4 | 3 | Copyright (C) 2008, 2009, 2010 Free Software Foundation, Inc. |
bc3b79fd TJB |
4 | |
5 | This file is part of GDB. | |
6 | ||
7 | This program is free software; you can redistribute it and/or modify | |
8 | it under the terms of the GNU General Public License as published by | |
9 | the Free Software Foundation; either version 3 of the License, or | |
10 | (at your option) any later version. | |
11 | ||
12 | This program is distributed in the hope that it will be useful, | |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
16 | ||
17 | You should have received a copy of the GNU General Public License | |
18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ | |
19 | ||
20 | ||
21 | #include "defs.h" | |
22 | #include "value.h" | |
23 | #include "exceptions.h" | |
24 | #include "python-internal.h" | |
25 | #include "charset.h" | |
26 | #include "gdbcmd.h" | |
27 | #include "cli/cli-decode.h" | |
28 | #include "completer.h" | |
29 | #include "expression.h" | |
d452c4bc | 30 | #include "language.h" |
bc3b79fd TJB |
31 | |
32 | static PyTypeObject fnpy_object_type; | |
33 | ||
34 | \f | |
35 | ||
36 | static PyObject * | |
37 | convert_values_to_python (int argc, struct value **argv) | |
38 | { | |
39 | int i; | |
40 | PyObject *result = PyTuple_New (argc); | |
d59b6f6c | 41 | |
bc3b79fd TJB |
42 | for (i = 0; i < argc; ++i) |
43 | { | |
44 | PyObject *elt = value_to_value_object (argv[i]); | |
45 | if (! elt) | |
46 | { | |
47 | Py_DECREF (result); | |
48 | error (_("Could not convert value to Python object.")); | |
49 | } | |
50 | PyTuple_SetItem (result, i, elt); | |
51 | } | |
52 | return result; | |
53 | } | |
54 | ||
55 | /* Call a Python function object's invoke method. */ | |
56 | ||
57 | static struct value * | |
d452c4bc UW |
58 | fnpy_call (struct gdbarch *gdbarch, const struct language_defn *language, |
59 | void *cookie, int argc, struct value **argv) | |
bc3b79fd | 60 | { |
bc3b79fd TJB |
61 | struct value *value = NULL; |
62 | PyObject *result, *callable, *args; | |
63 | struct cleanup *cleanup; | |
bc3b79fd | 64 | |
d452c4bc | 65 | cleanup = ensure_python_env (gdbarch, language); |
bc3b79fd TJB |
66 | |
67 | args = convert_values_to_python (argc, argv); | |
68 | ||
69 | callable = PyObject_GetAttrString ((PyObject *) cookie, "invoke"); | |
70 | if (! callable) | |
71 | { | |
72 | Py_DECREF (args); | |
73 | error (_("No method named 'invoke' in object.")); | |
74 | } | |
75 | ||
76 | result = PyObject_Call (callable, args, NULL); | |
77 | Py_DECREF (callable); | |
78 | Py_DECREF (args); | |
79 | ||
80 | if (!result) | |
81 | { | |
82 | gdbpy_print_stack (); | |
83 | error (_("Error while executing Python code.")); | |
84 | } | |
85 | ||
86 | value = convert_value_from_python (result); | |
87 | if (value == NULL) | |
88 | { | |
89 | Py_DECREF (result); | |
90 | gdbpy_print_stack (); | |
91 | error (_("Error while executing Python code.")); | |
92 | } | |
93 | ||
94 | Py_DECREF (result); | |
95 | do_cleanups (cleanup); | |
96 | ||
97 | return value; | |
98 | } | |
99 | ||
100 | /* Initializer for a Function object. It takes one argument, the name | |
101 | of the function. */ | |
102 | ||
103 | static int | |
104 | fnpy_init (PyObject *self, PyObject *args, PyObject *kwds) | |
105 | { | |
106 | char *name, *docstring = NULL; | |
d59b6f6c | 107 | |
bc3b79fd TJB |
108 | if (! PyArg_ParseTuple (args, "s", &name)) |
109 | return -1; | |
110 | Py_INCREF (self); | |
111 | ||
112 | if (PyObject_HasAttrString (self, "__doc__")) | |
113 | { | |
114 | PyObject *ds_obj = PyObject_GetAttrString (self, "__doc__"); | |
115 | if (ds_obj && gdbpy_is_string (ds_obj)) | |
bc3b79fd TJB |
116 | docstring = python_string_to_host_string (ds_obj); |
117 | } | |
118 | if (! docstring) | |
ce0420dc | 119 | docstring = xstrdup (_("This function is not documented.")); |
bc3b79fd TJB |
120 | |
121 | add_internal_function (name, docstring, fnpy_call, self); | |
122 | return 0; | |
123 | } | |
124 | ||
125 | /* Initialize internal function support. */ | |
126 | ||
127 | void | |
128 | gdbpy_initialize_functions (void) | |
129 | { | |
130 | if (PyType_Ready (&fnpy_object_type) < 0) | |
131 | return; | |
132 | ||
133 | Py_INCREF (&fnpy_object_type); | |
134 | PyModule_AddObject (gdb_module, "Function", (PyObject *) &fnpy_object_type); | |
135 | } | |
136 | ||
137 | \f | |
138 | ||
139 | static PyTypeObject fnpy_object_type = | |
140 | { | |
141 | PyObject_HEAD_INIT (NULL) | |
142 | 0, /*ob_size*/ | |
143 | "gdb.Function", /*tp_name*/ | |
144 | sizeof (PyObject), /*tp_basicsize*/ | |
145 | 0, /*tp_itemsize*/ | |
146 | 0, /*tp_dealloc*/ | |
147 | 0, /*tp_print*/ | |
148 | 0, /*tp_getattr*/ | |
149 | 0, /*tp_setattr*/ | |
150 | 0, /*tp_compare*/ | |
151 | 0, /*tp_repr*/ | |
152 | 0, /*tp_as_number*/ | |
153 | 0, /*tp_as_sequence*/ | |
154 | 0, /*tp_as_mapping*/ | |
155 | 0, /*tp_hash */ | |
156 | 0, /*tp_call*/ | |
157 | 0, /*tp_str*/ | |
158 | 0, /*tp_getattro*/ | |
159 | 0, /*tp_setattro*/ | |
160 | 0, /*tp_as_buffer*/ | |
161 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /*tp_flags*/ | |
162 | "GDB function object", /* tp_doc */ | |
163 | 0, /* tp_traverse */ | |
164 | 0, /* tp_clear */ | |
165 | 0, /* tp_richcompare */ | |
166 | 0, /* tp_weaklistoffset */ | |
167 | 0, /* tp_iter */ | |
168 | 0, /* tp_iternext */ | |
169 | 0, /* tp_methods */ | |
170 | 0, /* tp_members */ | |
171 | 0, /* tp_getset */ | |
172 | 0, /* tp_base */ | |
173 | 0, /* tp_dict */ | |
174 | 0, /* tp_descr_get */ | |
175 | 0, /* tp_descr_set */ | |
176 | 0, /* tp_dictoffset */ | |
177 | fnpy_init, /* tp_init */ | |
178 | 0, /* tp_alloc */ | |
179 | PyType_GenericNew /* tp_new */ | |
180 | }; |