1 /* Python interface to inferior events.
3 Copyright (C) 2009-2024 Free Software Foundation, Inc.
5 This file is part of GDB.
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.
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.
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/>. */
23 evpy_dealloc (PyObject
*self
)
25 Py_XDECREF (((event_object
*) self
)->dict
);
26 Py_TYPE (self
)->tp_free (self
);
30 create_event_object (PyTypeObject
*py_type
)
32 gdbpy_ref
<event_object
> event_obj (PyObject_New (event_object
, py_type
));
33 if (event_obj
== NULL
)
36 event_obj
->dict
= PyDict_New ();
40 return gdbpy_ref
<> ((PyObject
*) event_obj
.release ());
43 /* Add the attribute ATTR to the event object EVENT. In
44 python this attribute will be accessible by the name NAME.
45 returns 0 if the operation succeeds and -1 otherwise. This
46 function acquires a new reference to ATTR. */
49 evpy_add_attribute (PyObject
*event
, const char *name
, PyObject
*attr
)
51 return PyObject_SetAttrString (event
, name
, attr
);
54 /* Initialize the Python event code. */
56 static int CPYCHECKER_NEGATIVE_RESULT_SETS_EXCEPTION
57 gdbpy_initialize_event (void)
59 return gdbpy_initialize_event_generic (&event_object_type
,
63 /* Initialize the given event type. If BASE is not NULL it will
64 be set as the types base.
65 Returns 0 if initialization was successful -1 otherwise. */
68 gdbpy_initialize_event_generic (PyTypeObject
*type
,
71 if (PyType_Ready (type
) < 0)
74 return gdb_pymodule_addobject (gdb_module
, name
, (PyObject
*) type
);
78 /* Notify the list of listens that the given EVENT has occurred.
79 returns 0 if emit is successful -1 otherwise. */
82 evpy_emit_event (PyObject
*event
,
83 eventregistry_object
*registry
)
87 /* Create a copy of call back list and use that for
88 notifying listeners to avoid skipping callbacks
89 in the case of a callback being disconnected during
91 gdbpy_ref
<> callback_list_copy (PySequence_List (registry
->callbacks
));
92 if (callback_list_copy
== NULL
)
95 for (i
= 0; i
< PyList_Size (callback_list_copy
.get ()); i
++)
97 PyObject
*func
= PyList_GetItem (callback_list_copy
.get (), i
);
102 gdbpy_ref
<> func_result (PyObject_CallFunctionObjArgs (func
, event
,
105 if (func_result
== NULL
)
107 /* Print the trace here, but keep going -- we want to try to
108 call all of the callbacks even if one is broken. */
109 gdbpy_print_stack ();
116 GDBPY_INITIALIZE_FILE (gdbpy_initialize_event
);
118 static gdb_PyGetSetDef event_object_getset
[] =
120 { "__dict__", gdb_py_generic_dict
, NULL
,
121 "The __dict__ for this event.", &event_object_type
},
125 PyTypeObject event_object_type
=
127 PyVarObject_HEAD_INIT (NULL
, 0)
128 "gdb.Event", /* tp_name */
129 sizeof (event_object
), /* tp_basicsize */
131 evpy_dealloc
, /* tp_dealloc */
137 0, /* tp_as_number */
138 0, /* tp_as_sequence */
139 0, /* tp_as_mapping */
145 0, /* tp_as_buffer */
146 Py_TPFLAGS_DEFAULT
| Py_TPFLAGS_BASETYPE
, /* tp_flags */
147 "GDB event object", /* tp_doc */
150 0, /* tp_richcompare */
151 0, /* tp_weaklistoffset */
156 event_object_getset
, /* tp_getset */
159 0, /* tp_descr_get */
160 0, /* tp_descr_set */
161 offsetof (event_object
, dict
), /* tp_dictoffset */