diff options
author | Jiri Moskovcak <jmoskovc@redhat.com> | 2011-06-08 17:27:42 +0200 |
---|---|---|
committer | Jiri Moskovcak <jmoskovc@redhat.com> | 2011-06-08 17:27:42 +0200 |
commit | 0e74f780545b1aa8f6a5277b3cfdc9887c37ed5e (patch) | |
tree | b1249b7b96c908931f2c29f48f016da8be450429 /libreport/src/report-python/README | |
parent | 7ac32c68dea1fe0c6efa6ac9bb0e8ad8716d7f7d (diff) | |
download | abrt-0e74f780545b1aa8f6a5277b3cfdc9887c37ed5e.tar.gz abrt-0e74f780545b1aa8f6a5277b3cfdc9887c37ed5e.tar.xz abrt-0e74f780545b1aa8f6a5277b3cfdc9887c37ed5e.zip |
split libreport to a separate package
Diffstat (limited to 'libreport/src/report-python/README')
-rw-r--r-- | libreport/src/report-python/README | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/libreport/src/report-python/README b/libreport/src/report-python/README new file mode 100644 index 00000000..1c9c3a27 --- /dev/null +++ b/libreport/src/report-python/README @@ -0,0 +1,44 @@ +Currently (2011-05), include/report/*.h are: + +dump_dir.h +event_config.h +problem_data.h +report.h +run_event.h + +and we wrap all of them except event_config.h. + +Python wrappers for C types and functions declared in include/report/FOO.h +should be implemented in corresponding FOO.c file in this directory. + +Their (C-level) declarations should go to common.h. + +Note that methods don't have to be declared in common.h: +they can be static functions inside FOO.c, and exposed to the rest +of the world via PyTypeObject instance. In FOO.c: + +static PyObject *p_method_name(PyObject *pself, PyObject *args) +... +static PyMethodDef p_FOO_methods[] = { +{ "method_name", p_method_name, METH_VARARGS, NULL } +... +}; +PyTypeObject p_FOO_type = { + .tp_methods = p_FOO_methods, +... +}; + +and only p_FOO_type needs to be declared in common.h. + +Similarly, (de)allocators, attr getters/setters also can be static functions +and be hooked into p_FOO_type. + +However, non-method functions can't be static. + + +File reportmodule.c contains the initialization function which should +initialize types (p_FOO_type objects) and hook up finctions from every +FOO.c so that they are usable from python code. + +Python wrappers for C constants (enums, defines) are created directly +by reportmodule.c. |