lib: make public reference count functions have strict types
[babeltrace.git] / python-plugin-provider / python-plugin-provider.c
index 025da46d3762e53a3f63db0b7ee779bac2b66597..1eb1fa34182d95c539b06797c7e8da39c7f1e053 100644 (file)
  */
 
 #define BT_LOG_TAG "PLUGIN-PY"
-#include <babeltrace/lib-logging-internal.h>
+#include "logging.h"
 
 #include <babeltrace/babeltrace-internal.h>
 #include <babeltrace/compiler-internal.h>
-#include <babeltrace/ref.h>
+#include <babeltrace/plugin/plugin-const.h>
 #include <babeltrace/plugin/plugin-internal.h>
+#include <babeltrace/graph/component-class.h>
+#include <babeltrace/graph/component-class-internal.h>
 #include <stdlib.h>
 #include <signal.h>
 #include <Python.h>
@@ -54,11 +56,13 @@ enum python_state {
 } python_state = PYTHON_STATE_NOT_INITED;
 
 static PyObject *py_try_load_plugin_module_func = NULL;
+static bool python_was_initialized_by_us;
 
 static
-void print_python_traceback_verbose(void)
+void print_python_traceback_warn(void)
 {
-       if (Py_IsInitialized() && PyErr_Occurred() && babeltrace_verbose) {
+       if (BT_LOG_ON_WARN && Py_IsInitialized() && PyErr_Occurred()) {
+               BT_LOGW_STR("Exception occured: traceback: ");
                PyErr_Print();
        }
 }
@@ -76,7 +80,9 @@ void init_python(void)
 {
        PyObject *py_bt2_py_plugin_mod = NULL;
        const char *dis_python_env;
+#ifndef __MINGW32__
        sighandler_t old_sigint = signal(SIGINT, SIG_DFL);
+#endif
 
        if (python_state != PYTHON_STATE_NOT_INITED) {
                goto end;
@@ -88,21 +94,26 @@ void init_python(void)
         * 1.
         */
        dis_python_env = getenv("BABELTRACE_DISABLE_PYTHON_PLUGINS");
-       if (dis_python_env && dis_python_env[0] == '1' &&
-                       dis_python_env[1] == '\0') {
-               printf_verbose("Python plugin support is disabled by BABELTRACE_DISABLE_PYTHON_PLUGINS environment variable\n");
+       if (dis_python_env && strcmp(dis_python_env, "1") == 0) {
+               BT_LOGI_STR("Python plugin support is disabled because `BABELTRACE_DISABLE_PYTHON_PLUGINS=1`.");
                python_state = PYTHON_STATE_CANNOT_INITIALIZE;
                goto end;
        }
 
        if (!Py_IsInitialized()) {
+               BT_LOGI_STR("Python interpreter is not initialized: initializing Python interpreter.");
                Py_InitializeEx(0);
-               printf_verbose("Initialized Python:\n%s\n", Py_GetVersion());
+               python_was_initialized_by_us = true;
+               BT_LOGI("Initialized Python interpreter: version=\"%s\"",
+                       Py_GetVersion());
+       } else {
+               BT_LOGI("Python interpreter is already initialized: version=\"%s\"",
+                       Py_GetVersion());
        }
 
        py_bt2_py_plugin_mod = PyImport_ImportModule("bt2.py_plugin");
        if (!py_bt2_py_plugin_mod) {
-               printf_verbose("Cannot import bt2.py_plugin Python module\n");
+               BT_LOGI_STR("Cannot import bt2.py_plugin Python module: Python plugin support is disabled.");
                python_state = PYTHON_STATE_CANNOT_INITIALIZE;
                goto end;
        }
@@ -110,7 +121,7 @@ void init_python(void)
        py_try_load_plugin_module_func =
                PyObject_GetAttrString(py_bt2_py_plugin_mod, "_try_load_plugin_module");
        if (!py_try_load_plugin_module_func) {
-               printf_verbose("Cannot get _try_load_plugin_module attribute from bt2.py_plugin Python module\n");
+               BT_LOGI_STR("Cannot get _try_load_plugin_module attribute from bt2.py_plugin Python module: Python plugin support is disabled.");
                python_state = PYTHON_STATE_CANNOT_INITIALIZE;
                goto end;
        }
@@ -118,11 +129,13 @@ void init_python(void)
        python_state = PYTHON_STATE_FULLY_INITIALIZED;
 
 end:
+#ifndef __MINGW32__
        if (old_sigint != SIG_ERR) {
                (void) signal(SIGINT, old_sigint);
        }
+#endif
 
-       print_python_traceback_verbose();
+       print_python_traceback_warn();
        pyerr_clear();
        Py_XDECREF(py_bt2_py_plugin_mod);
        return;
@@ -130,22 +143,23 @@ end:
 
 __attribute__((destructor)) static
 void fini_python(void) {
-       if (Py_IsInitialized()) {
+       if (Py_IsInitialized() && python_was_initialized_by_us) {
                if (py_try_load_plugin_module_func) {
                        Py_DECREF(py_try_load_plugin_module_func);
                        py_try_load_plugin_module_func = NULL;
                }
 
                Py_Finalize();
+               BT_LOGI_STR("Finalized Python interpreter.");
        }
 
        python_state = PYTHON_STATE_NOT_INITED;
 }
 
 static
-struct bt_plugin *bt_plugin_from_python_plugin_info(PyObject *plugin_info)
+const struct bt_plugin *bt_plugin_from_python_plugin_info(PyObject *plugin_info)
 {
-       struct bt_plugin *plugin = NULL;
+       const struct bt_plugin *plugin = NULL;
        PyObject *py_name = NULL;
        PyObject *py_author = NULL;
        PyObject *py_description = NULL;
@@ -160,61 +174,70 @@ struct bt_plugin *bt_plugin_from_python_plugin_info(PyObject *plugin_info)
        const char *version_extra = NULL;
        int ret;
 
-       assert(plugin_info);
-       assert(python_state == PYTHON_STATE_FULLY_INITIALIZED);
+       BT_ASSERT(plugin_info);
+       BT_ASSERT(python_state == PYTHON_STATE_FULLY_INITIALIZED);
        py_name = PyObject_GetAttrString(plugin_info, "name");
        if (!py_name) {
-               printf_verbose("Cannot find `name` attribute in plugin info\n");
+               BT_LOGW("Cannot find `name` attribute in Python plugin info object: "
+                       "py-plugin-info-addr=%p", plugin_info);
                goto error;
        }
 
        py_author = PyObject_GetAttrString(plugin_info, "author");
        if (!py_author) {
-               printf_verbose("Cannot find `author` attribute in plugin info\n");
+               BT_LOGW("Cannot find `author` attribute in Python plugin info object: "
+                       "py-plugin-info-addr=%p", plugin_info);
                goto error;
        }
 
        py_description = PyObject_GetAttrString(plugin_info, "description");
        if (!py_description) {
-               printf_verbose("Cannot find `description` attribute in plugin info\n");
+               BT_LOGW("Cannot find `desciption` attribute in Python plugin info object: "
+                       "py-plugin-info-addr=%p", plugin_info);
                goto error;
        }
 
        py_license = PyObject_GetAttrString(plugin_info, "license");
        if (!py_license) {
-               printf_verbose("Cannot find `license` attribute in plugin info\n");
+               BT_LOGW("Cannot find `license` attribute in Python plugin info object: "
+                       "py-plugin-info-addr=%p", plugin_info);
                goto error;
        }
 
        py_version = PyObject_GetAttrString(plugin_info, "version");
        if (!py_version) {
-               printf_verbose("Cannot find `version` attribute in plugin info\n");
+               BT_LOGW("Cannot find `version` attribute in Python plugin info object: "
+                       "py-plugin-info-addr=%p", plugin_info);
                goto error;
        }
 
        py_comp_class_addrs = PyObject_GetAttrString(plugin_info,
                "comp_class_addrs");
        if (!py_comp_class_addrs) {
-               printf_verbose("Cannot find `comp_class_addrs` attribute in plugin info\n");
+               BT_LOGW("Cannot find `comp_class_addrs` attribute in Python plugin info object: "
+                       "py-plugin-info-addr=%p", plugin_info);
                goto error;
        }
 
        if (PyUnicode_Check(py_name)) {
                name = PyUnicode_AsUTF8(py_name);
                if (!name) {
-                       printf_verbose("Cannot decode plugin name string\n");
+                       BT_LOGW("Cannot decode Python plugin name string: "
+                               "py-plugin-info-addr=%p", plugin_info);
                        goto error;
                }
        } else {
                /* Plugin name is mandatory */
-               printf_verbose("Plugin name is not a string\n");
+               BT_LOGW("Plugin name is not a string: "
+                       "py-plugin-info-addr=%p", plugin_info);
                goto error;
        }
 
        if (PyUnicode_Check(py_author)) {
                author = PyUnicode_AsUTF8(py_author);
                if (!author) {
-                       printf_verbose("Cannot decode plugin author string\n");
+                       BT_LOGW("Cannot decode Python plugin author string: "
+                               "py-plugin-info-addr=%p", plugin_info);
                        goto error;
                }
        }
@@ -222,7 +245,8 @@ struct bt_plugin *bt_plugin_from_python_plugin_info(PyObject *plugin_info)
        if (PyUnicode_Check(py_description)) {
                description = PyUnicode_AsUTF8(py_description);
                if (!description) {
-                       printf_verbose("Cannot decode plugin description string\n");
+                       BT_LOGW("Cannot decode Python plugin description string: "
+                               "py-plugin-info-addr=%p", plugin_info);
                        goto error;
                }
        }
@@ -230,7 +254,8 @@ struct bt_plugin *bt_plugin_from_python_plugin_info(PyObject *plugin_info)
        if (PyUnicode_Check(py_license)) {
                license = PyUnicode_AsUTF8(py_license);
                if (!license) {
-                       printf_verbose("Cannot decode plugin license string\n");
+                       BT_LOGW("Cannot decode Python plugin license string: "
+                               "py-plugin-info-addr=%p", plugin_info);
                        goto error;
                }
        }
@@ -241,9 +266,9 @@ struct bt_plugin *bt_plugin_from_python_plugin_info(PyObject *plugin_info)
                        PyObject *py_minor = PyTuple_GetItem(py_version, 1);
                        PyObject *py_patch = PyTuple_GetItem(py_version, 2);
 
-                       assert(py_major);
-                       assert(py_minor);
-                       assert(py_patch);
+                       BT_ASSERT(py_major);
+                       BT_ASSERT(py_minor);
+                       BT_ASSERT(py_patch);
 
                        if (PyLong_Check(py_major)) {
                                major = PyLong_AsUnsignedLong(py_major);
@@ -259,7 +284,8 @@ struct bt_plugin *bt_plugin_from_python_plugin_info(PyObject *plugin_info)
 
                        if (PyErr_Occurred()) {
                                /* Overflow error, most probably */
-                               printf_verbose("Invalid plugin version format\n");
+                               BT_LOGW("Invalid Python plugin version format: "
+                                       "py-plugin-info-addr=%p", plugin_info);
                                goto error;
                        }
                }
@@ -267,12 +293,13 @@ struct bt_plugin *bt_plugin_from_python_plugin_info(PyObject *plugin_info)
                if (PyTuple_Size(py_version) >= 4) {
                        PyObject *py_extra = PyTuple_GetItem(py_version, 3);
 
-                       assert(py_extra);
+                       BT_ASSERT(py_extra);
 
                        if (PyUnicode_Check(py_extra)) {
                                version_extra = PyUnicode_AsUTF8(py_extra);
                                if (!version_extra) {
-                                       printf_verbose("Cannot decode plugin version's extra string\n");
+                               BT_LOGW("Cannot decode Python plugin version's extra string: "
+                                       "py-plugin-info-addr=%p", plugin_info);
                                        goto error;
                                }
                        }
@@ -281,6 +308,7 @@ struct bt_plugin *bt_plugin_from_python_plugin_info(PyObject *plugin_info)
 
        plugin = bt_plugin_create_empty(BT_PLUGIN_TYPE_PYTHON);
        if (!plugin) {
+               BT_LOGE_STR("Cannot create empty plugin object.");
                goto error;
        }
 
@@ -309,20 +337,31 @@ struct bt_plugin *bt_plugin_from_python_plugin_info(PyObject *plugin_info)
 
                        py_comp_class_addr =
                                PyList_GetItem(py_comp_class_addrs, i);
-                       assert(py_comp_class_addr);
+                       BT_ASSERT(py_comp_class_addr);
                        if (PyLong_Check(py_comp_class_addr)) {
                                comp_class = (struct bt_component_class *)
                                        PyLong_AsUnsignedLongLong(py_comp_class_addr);
                        } else {
-                               printf_verbose("Component class address #%zu: not an integer\n",
-                                       i);
+                               BT_LOGW("Component class address is not an integer in Python plugin info object: "
+                                       "py-plugin-info-addr=%p, index=%zu",
+                                       plugin_info, i);
                                continue;
                        }
 
                        ret = bt_plugin_add_component_class(plugin, comp_class);
                        if (ret < 0) {
-                               printf_verbose("Cannot add component class #%zu\n",
-                                       i);
+                               BT_LOGE("Cannot add component class to plugin: "
+                                       "py-plugin-info-addr=%p, "
+                                       "plugin-addr=%p, plugin-name=\"%s\", "
+                                       "comp-class-addr=%p, "
+                                       "comp-class-name=\"%s\", "
+                                       "comp-class-type=%s",
+                                       plugin_info,
+                                       plugin, bt_plugin_get_name(plugin),
+                                       comp_class,
+                                       bt_component_class_get_name(comp_class),
+                                       bt_component_class_type_string(
+                                               bt_component_class_get_type(comp_class)));
                                continue;
                        }
                }
@@ -333,9 +372,9 @@ struct bt_plugin *bt_plugin_from_python_plugin_info(PyObject *plugin_info)
        goto end;
 
 error:
-       print_python_traceback_verbose();
+       print_python_traceback_warn();
        pyerr_clear();
-       BT_PUT(plugin);
+       BT_OBJECT_PUT_REF_AND_RESET(plugin);
 
 end:
        Py_XDECREF(py_name);
@@ -351,12 +390,12 @@ G_MODULE_EXPORT
 struct bt_plugin_set *bt_plugin_python_create_all_from_file(const char *path)
 {
        struct bt_plugin_set *plugin_set = NULL;
-       struct bt_plugin *plugin = NULL;
+       const struct bt_plugin *plugin = NULL;
        PyObject *py_plugin_info = NULL;
        gchar *basename = NULL;
        size_t path_len;
 
-       assert(path);
+       BT_ASSERT(path);
 
        if (python_state == PYTHON_STATE_CANNOT_INITIALIZE) {
                /*
@@ -367,27 +406,28 @@ struct bt_plugin_set *bt_plugin_python_create_all_from_file(const char *path)
                goto error;
        }
 
+       BT_LOGD("Creating all Python plugins from file: path=\"%s\"", path);
        path_len = strlen(path);
 
        /* File name ends with `.py` */
        if (strncmp(path + path_len - PYTHON_PLUGIN_FILE_EXT_LEN,
                        PYTHON_PLUGIN_FILE_EXT,
                        PYTHON_PLUGIN_FILE_EXT_LEN) != 0) {
-               printf_verbose("Skipping non-Python file: `%s`\n",
-                       path);
+               BT_LOGD("Skipping non-Python file: path=\"%s\"", path);
                goto error;
        }
 
        /* File name starts with `bt_plugin_` */
        basename = g_path_get_basename(path);
        if (!basename) {
+               BT_LOGW("Cannot get path's basename: path=\"%s\"", path);
                goto error;
        }
 
        if (strncmp(basename, PYTHON_PLUGIN_FILE_PREFIX,
                        PYTHON_PLUGIN_FILE_PREFIX_LEN) != 0) {
-               printf_verbose("Skipping Python file not starting with `%s`: `%s`\n",
-                       PYTHON_PLUGIN_FILE_PREFIX, path);
+               BT_LOGD("Skipping Python file not starting with `%s`: "
+                       "path=\"%s\"", PYTHON_PLUGIN_FILE_PREFIX, path);
                goto error;
        }
 
@@ -406,6 +446,7 @@ struct bt_plugin_set *bt_plugin_python_create_all_from_file(const char *path)
                 * import the required modules, and get the required
                 * attributes from them.
                 */
+               BT_LOGI("Failed to initialize Python interpreter.");
                goto error;
        }
 
@@ -415,11 +456,12 @@ struct bt_plugin_set *bt_plugin_python_create_all_from_file(const char *path)
         * This function returns None when there's an error, but just in
         * case we also manually clear the last Python error state.
         */
+       BT_LOGD_STR("Getting Python plugin info object from Python module.");
        py_plugin_info = PyObject_CallFunction(py_try_load_plugin_module_func,
                "(s)", path);
        if (!py_plugin_info || py_plugin_info == Py_None) {
-               printf_verbose("Cannot load Python plugin `%s`:\n", path);
-               print_python_traceback_verbose();
+               BT_LOGW("Cannot load Python plugin: path=\"%s\"", path);
+               print_python_traceback_warn();
                PyErr_Clear();
                goto error;
        }
@@ -429,23 +471,30 @@ struct bt_plugin_set *bt_plugin_python_create_all_from_file(const char *path)
         */
        plugin = bt_plugin_from_python_plugin_info(py_plugin_info);
        if (!plugin) {
+               BT_LOGW("Cannot create plugin object from Python plugin info object: "
+                       "path=\"%s\", py-plugin-info-addr=%p",
+                       path, py_plugin_info);
                goto error;
        }
 
        bt_plugin_set_path(plugin, path);
        plugin_set = bt_plugin_set_create();
        if (!plugin_set) {
+               BT_LOGE_STR("Cannot create empty plugin set.");
                goto error;
        }
 
        bt_plugin_set_add_plugin(plugin_set, plugin);
+       BT_LOGD("Created all Python plugins from file: path=\"%s\", "
+               "plugin-addr=%p, plugin-name=\"%s\"",
+               path, plugin, bt_plugin_get_name(plugin));
        goto end;
 
 error:
-       BT_PUT(plugin_set);
+       BT_OBJECT_PUT_REF_AND_RESET(plugin_set);
 
 end:
-       bt_put(plugin);
+       bt_plugin_put_ref(plugin);
        Py_XDECREF(py_plugin_info);
        g_free(basename);
        return plugin_set;
This page took 0.028243 seconds and 4 git commands to generate.