bindings/python/bt2/bt2/native_bt.i

   1 /*
   2  * The MIT License (MIT)
   3  *
   4  * Copyright (c) 2016 Philippe Proulx <pproulx@efficios.com>
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a copy
   7  * of this software and associated documentation files (the "Software"), to deal
   8  * in the Software without restriction, including without limitation the rights
   9  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10  * copies of the Software, and to permit persons to whom the Software is
  11  * furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice shall be included in
  14  * all copies or substantial portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  22  * THE SOFTWARE.
  23  */
  24
  25 #ifndef SWIGPYTHON
  26 # error Unsupported output language
  27 #endif
  28
  29 %module native_bt
  30
  31 %{
  32 #define BT_LOG_TAG "PY-NATIVE"
  33 #include "logging.h"
  34
  35 #include <babeltrace/babeltrace.h>
  36 #include <babeltrace/property.h>
  37 #include <babeltrace/assert-internal.h>
  38
  39 typedef const uint8_t *bt_uuid;
  40 %}
  41
  42 typedef int bt_bool;
  43
  44 /* For uint*_t/int*_t */
  45 %include "stdint.i"
  46
  47 /*
  48  * Remove `bt_` and `BT_` prefixes from function names, global variables and
  49  * enumeration items
  50  */
  51 %rename("%(strip:[bt_])s", %$isfunction) "";
  52 %rename("%(strip:[bt_])s", %$isvariable) "";
  53 %rename("%(strip:[BT_])s", %$isenumitem) "";
  54
  55 /* Output argument typemap for string output (always appends) */
  56 %typemap(in, numinputs=0) (const char **OUT) (char *temp_value) {
  57         $1 = &temp_value;
  58 }
  59
  60 %typemap(argout) (const char **OUT) {
  61         if (*$1) {
  62                 /* SWIG_Python_AppendOutput() steals the created object */
  63                 $result = SWIG_Python_AppendOutput($result, SWIG_Python_str_FromChar(*$1));
  64         } else {
  65                 /* SWIG_Python_AppendOutput() steals Py_None */
  66                 Py_INCREF(Py_None);
  67                 $result = SWIG_Python_AppendOutput($result, Py_None);
  68         }
  69 }
  70
  71 /* Output argument typemap for value output (always appends) */
  72 %typemap(in, numinputs=0) (bt_value **OUT) (struct bt_value *temp_value = NULL) {
  73         $1 = &temp_value;
  74 }
  75
  76 %typemap(argout) (bt_value **OUT) {
  77         if (*$1) {
  78                 /* SWIG_Python_AppendOutput() steals the created object */
  79                 $result = SWIG_Python_AppendOutput($result,
  80                                 SWIG_NewPointerObj(SWIG_as_voidptr(*$1),
  81                                         SWIGTYPE_p_bt_value, 0));
  82         } else {
  83                 /* SWIG_Python_AppendOutput() steals Py_None */
  84                 Py_INCREF(Py_None);
  85                 $result = SWIG_Python_AppendOutput($result, Py_None);
  86         }
  87 }
  88
  89 /* Output argument typemap for initialized uint64_t output parameter (always appends) */
  90 %typemap(in, numinputs=0) (uint64_t *OUT) (uint64_t temp) {
  91         $1 = &temp;
  92 }
  93
  94 %typemap(argout) uint64_t *OUT {
  95         $result = SWIG_Python_AppendOutput(resultobj,
  96                         SWIG_From_unsigned_SS_long_SS_long((*$1)));
  97 }
  98
  99 /* Output argument typemap for initialized int64_t output parameter (always appends) */
 100 %typemap(in, numinputs=0) (int64_t *OUT) (int64_t temp) {
 101         $1 = &temp;
 102 }
 103
 104 %typemap(argout) (int64_t *OUT) {
 105         $result = SWIG_Python_AppendOutput(resultobj, SWIG_From_long_SS_long((*$1)));
 106 }
 107
 108 /* Output argument typemap for initialized unsigned int output parameter (always appends) */
 109 %typemap(in, numinputs=0) (unsigned int *OUT) (unsigned int temp) {
 110         $1 = &temp;
 111 }
 112
 113 %typemap(argout) (unsigned int *OUT) {
 114         $result = SWIG_Python_AppendOutput(resultobj,
 115                         SWIG_From_unsigned_SS_long_SS_long((uint64_t) (*$1)));
 116 }
 117 /* Output argument typemap for initialized double output parameter (always appends) */
 118 %typemap(in, numinputs=0) (double *OUT) (double temp) {
 119         $1 = &temp;
 120 }
 121
 122 %typemap(argout) (double *OUT) {
 123         $result = SWIG_Python_AppendOutput(resultobj, SWIG_From_int((*$1)));
 124 }
 125
 126 /* Input argument typemap for UUID bytes */
 127 %typemap(in) bt_uuid {
 128         $1 = (unsigned char *) PyBytes_AsString($input);
 129 }
 130
 131 /* Output argument typemap for UUID bytes */
 132 %typemap(out) bt_uuid {
 133         if (!$1) {
 134                 Py_INCREF(Py_None);
 135                 $result = Py_None;
 136         } else {
 137                 $result = PyBytes_FromStringAndSize((const char *) $1, 16);
 138         }
 139 }
 140
 141 /* Input argument typemap for bt_bool */
 142 %typemap(in) bt_bool {
 143         $1 = PyObject_IsTrue($input);
 144 }
 145
 146 /* Output argument typemap for bt_bool */
 147 %typemap(out) bt_bool {
 148         if ($1 > 0) {
 149                 $result = Py_True;
 150         } else {
 151                 $result = Py_False;
 152         }
 153         Py_INCREF($result);
 154         return $result;
 155 }
 156
 157 /*
 158  * Input and output argument typemaps for raw Python objects (direct).
 159  *
 160  * Those typemaps honor the convention of Python C function calls with
 161  * respect to reference counting: parameters are passed as borrowed
 162  * references, and objects are returned as new references. The wrapped
 163  * C function must ensure that the return value is always a new
 164  * reference, and never steal parameter references.
 165  */
 166 %typemap(in) PyObject * {
 167         $1 = $input;
 168 }
 169
 170 %typemap(out) PyObject * {
 171         $result = $1;
 172 }
 173
 174 /* From property.h */
 175
 176 typedef enum bt_property_availability {
 177         BT_PROPERTY_AVAILABILITY_AVAILABLE,
 178         BT_PROPERTY_AVAILABILITY_NOT_AVAILABLE,
 179 } bt_property_availability;
 180
 181 /* Per-module interface files */
 182 %include "native_bt_clock_class.i"
 183 %include "native_bt_clock_snapshot.i"
 184 %include "native_bt_component.i"
 185 %include "native_bt_component_class.i"
 186 %include "native_bt_connection.i"
 187 %include "native_bt_event.i"
 188 %include "native_bt_event_class.i"
 189 %include "native_bt_field.i"
 190 %include "native_bt_field_class.i"
 191 %include "native_bt_field_path.i"
 192 %include "native_bt_graph.i"
 193 %include "native_bt_logging.i"
 194 %include "native_bt_message.i"
 195 %include "native_bt_notifier.i"
 196 %include "native_bt_packet.i"
 197 %include "native_bt_plugin.i"
 198 %include "native_bt_port.i"
 199 %include "native_bt_query_exec.i"
 200 %include "native_bt_stream.i"
 201 %include "native_bt_stream_class.i"
 202 %include "native_bt_trace.i"
 203 %include "native_bt_trace_class.i"
 204 %include "native_bt_value.i"
 205 %include "native_bt_version.i"