include/dbus-python.h

   1 /* C API for _dbus_bindings, used by _dbus_glib_bindings and any third-party
   2  * main loop integration which might happen in future.
   3  *
   4  * This file is currently Python-version-independent - please keep it that way.
   5  *
   6  * Copyright (C) 2006 Collabora Ltd. <http://www.collabora.co.uk/>
   7  *
   8  * Permission is hereby granted, free of charge, to any person
   9  * obtaining a copy of this software and associated documentation
  10  * files (the "Software"), to deal in the Software without
  11  * restriction, including without limitation the rights to use, copy,
  12  * modify, merge, publish, distribute, sublicense, and/or sell copies
  13  * of the Software, and to permit persons to whom the Software is
  14  * furnished to do so, subject to the following conditions:
  15  *
  16  * The above copyright notice and this permission notice shall be
  17  * included in all copies or substantial portions of the Software.
  18  *
  19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  20  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  21  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  22  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
  23  * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  24  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  25  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  26  * DEALINGS IN THE SOFTWARE.
  27  */
  28
  29 #ifndef DBUS_PYTHON_H
  30 #define DBUS_PYTHON_H
  31
  32 #include <Python.h>
  33 #define DBUS_API_SUBJECT_TO_CHANGE 1
  34 #include <dbus/dbus.h>
  35
  36 DBUS_BEGIN_DECLS
  37
  38 typedef void (*_dbus_py_func_ptr)(void);
  39
  40 typedef dbus_bool_t (*_dbus_py_conn_setup_func)(DBusConnection *, void *);
  41 typedef dbus_bool_t (*_dbus_py_srv_setup_func)(DBusServer *, void *);
  42 typedef void (*_dbus_py_free_func)(void *);
  43
  44 #define DBUS_BINDINGS_API_COUNT 3
  45
  46 #ifdef INSIDE_DBUS_PYTHON_BINDINGS
  47
  48 extern DBusConnection *DBusPyConnection_BorrowDBusConnection(PyObject *);
  49 extern DBusServer *DBusPyServer_BorrowDBusServer(PyObject *);
  50 extern PyObject *DBusPyNativeMainLoop_New4(_dbus_py_conn_setup_func,
  51                                            _dbus_py_srv_setup_func,
  52                                            _dbus_py_free_func,
  53                                            void *);
  54
  55 #else
  56
  57 static PyObject *_dbus_bindings_module = NULL;
  58 static _dbus_py_func_ptr *dbus_bindings_API;
  59
  60 #define DBusPyConnection_BorrowDBusConnection \
  61         (*(DBusConnection *(*)(PyObject *))dbus_bindings_API[1])
  62 #define DBusPyNativeMainLoop_New4 \
  63     ((PyObject *(*)(_dbus_py_conn_setup_func, _dbus_py_srv_setup_func, \
  64                     _dbus_py_free_func, void *))dbus_bindings_API[2])
  65
  66 static int
  67 import_dbus_bindings(const char *this_module_name)
  68 {
  69     PyObject *c_api;
  70     int count;
  71
  72     _dbus_bindings_module = PyImport_ImportModule("_dbus_bindings");
  73     if (!_dbus_bindings_module) {
  74         return -1;
  75     }
  76     c_api = PyObject_GetAttrString(_dbus_bindings_module, "_C_API");
  77     if (c_api == NULL) return -1;
  78     if (PyCObject_Check(c_api)) {
  79         dbus_bindings_API = (_dbus_py_func_ptr *)PyCObject_AsVoidPtr(c_api);
  80     }
  81     else {
  82         Py_DECREF(c_api);
  83         PyErr_SetString(PyExc_RuntimeError, "C API is not a PyCObject");
  84         return -1;
  85     }
  86     Py_DECREF (c_api);
  87     count = *(int *)dbus_bindings_API[0];
  88     if (count < DBUS_BINDINGS_API_COUNT) {
  89         PyErr_Format(PyExc_RuntimeError,
  90                      "_dbus_bindings has API version %d but %s needs "
  91                      "_dbus_bindings API version at least %d",
  92                      count, this_module_name,
  93                      DBUS_BINDINGS_API_COUNT);
  94         return -1;
  95     }
  96     return 0;
  97 }
  98
  99 #endif
 100
 101 DBUS_END_DECLS
 102
 103 #endif