Trace internal libnomp function calls

docs/internal-api.rst

@@ -8,59 +8,54 @@ Internal API
 
 Internal Types
 ^^^^^^^^^^^^^^
-
-Below is a list of internal types (structures and enums) used internally by
-libnomp.
-
 .. doxygengroup:: nomp_internal_types
    :project: libnomp
-   :content-only:
    :members:
 
-Helper Macros
-^^^^^^^^^^^^^
+Internal Macros
+^^^^^^^^^^^^^^^
 .. doxygengroup:: nomp_internal_macros
    :project: libnomp
-   :content-only:
+   :members:
 
 Memory Management Functions and Macros
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 .. doxygengroup:: nomp_mem_utils
    :project: libnomp
-   :content-only:
+   :members:
 
 Backend Initialization Functions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 .. doxygengroup:: nomp_backend_init
    :project: libnomp
-   :content-only:
+   :members:
 
 Python Helper Functions
 ^^^^^^^^^^^^^^^^^^^^^^^^
 .. doxygengroup:: nomp_py_utils
    :project: libnomp
-   :content-only:
+   :members:
 
 Reductions and Related Functions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 .. doxygengroup:: nomp_reduction_utils
    :project: libnomp
-   :content-only:
+   :members:
 
 Logging Functions
 ^^^^^^^^^^^^^^^^^
 .. doxygengroup:: nomp_log_utils
    :project: libnomp
-   :content-only:
+   :members:
 
 Profiling Functions
 ^^^^^^^^^^^^^^^^^^^
 .. doxygengroup:: nomp_profiler_utils
    :project: libnomp
-   :content-only:
+   :members:
 
 Other helper Functions
 ^^^^^^^^^^^^^^^^^^^^^^
 .. doxygengroup:: nomp_other_utils
    :project: libnomp
-   :content-only:
+   :members:

docs/user-api.rst

@@ -8,21 +8,15 @@ User API
 
 Data Types
 ^^^^^^^^^^
-
-Below is a list of data types that are used in the user API.
-
 .. doxygengroup:: nomp_user_types
    :project: libnomp
-   :content-only:
 
 Functions
 ^^^^^^^^^
 .. doxygengroup:: nomp_user_api
    :project: libnomp
-   :content-only:
 
 Error Codes
 ^^^^^^^^^^^
 .. doxygengroup:: nomp_error_codes
    :project: libnomp
-   :content-only:

include/nomp-impl.h

@@ -16,7 +16,7 @@
 /**
  * @defgroup nomp_internal_types Internal types
  *
- * @brief Internal types used in libnomp.
+ * @brief Internal types (structures and enums) used by libnomp.
  */
 
 /**
@@ -295,6 +295,7 @@ extern "C" {
     int err_ = (err);                                                          \
     if (err_ > 0)                                                              \
       return err_;                                                             \
+    nomp_log(NOMP_SUCCESS, NOMP_INFO, "OK. Function: %s", __func__);           \
   }
 
 #define NOMP_MEM_OFFSET(start, usize) ((start) * (usize))

include/nomp-loopy.h

@@ -26,23 +26,22 @@ int nomp_py_realize_reduction(PyObject **knl, const char *var,
 
 int nomp_py_set_annotate_func(PyObject **func, const char *path);
 
-int nomp_py_apply_annotations(PyObject **kernel, PyObject *function,
-                              const PyObject *annotations,
-                              const PyObject *context);
+int nomp_py_annotate(PyObject **kernel, PyObject *function,
+                     const PyObject *annotations, const PyObject *context);
 
-int nomp_py_apply_transform(PyObject **knl, const char *file, const char *func,
-                            const PyObject *context);
+int nomp_py_transform(PyObject **knl, const char *file, const char *func,
+                      const PyObject *context);
 
 int nomp_py_get_knl_name_and_src(char **name, char **src, const PyObject *knl);
 
 int nomp_py_get_grid_size(nomp_prog_t *prg, PyObject *knl);
 
+void nomp_py_get_str(const char *msg, PyObject *obj);
+
 int nomp_symengine_eval_grid_size(nomp_prog_t *prg);
 
 int nomp_symengine_update(CMapBasicBasic *map, const char *key, const long val);
 
-void nomp_py_print(const char *msg, PyObject *obj);
-
 #ifdef __cplusplus
 }
 #endif

include/nomp.h

@@ -9,7 +9,8 @@ extern "C" {
 
 /**
  * @defgroup nomp_user_types User types
- * @brief Data types used in libnomp user API.
+ *
+ * @brief Below is a list of data types that are used in the user API.
  */
 
 /**

src/loopy.c

@@ -20,7 +20,7 @@ static char backend[NOMP_MAX_BUFFER_SIZE + 1];
  * @param obj Python object to be printed.
  * @return void
  */
-void nomp_py_print(const char *const message, PyObject *const obj) {
+void nomp_py_get_str(const char *const message, PyObject *const obj) {
   PyObject *py_repr = PyObject_Repr(obj);
   PyObject *py_str = PyUnicode_AsEncodedString(py_repr, "utf-8", "~E~");
   const char *str = PyBytes_AS_STRING(py_str);
@@ -305,9 +305,9 @@ int nomp_py_get_knl_name_and_src(char **name, char **src,
  * as backend, device details, etc.
  * @return int
  */
-int nomp_py_apply_annotations(PyObject **kernel, PyObject *const function,
-                              const PyObject *const annotations,
-                              const PyObject *const context) {
+int nomp_py_annotate(PyObject **kernel, PyObject *const function,
+                     const PyObject *const annotations,
+                     const PyObject *const context) {
   if (!kernel || !*kernel || !function)
     return 0;
 
@@ -341,9 +341,8 @@ int nomp_py_apply_annotations(PyObject **kernel, PyObject *const function,
  * information such as backend, device details, etc.
  * @return int
  */
-int nomp_py_apply_transform(PyObject **kernel, const char *const file,
-                            const char *function,
-                            const PyObject *const context) {
+int nomp_py_transform(PyObject **kernel, const char *const file,
+                      const char *function, const PyObject *const context) {
   // If either kernel, file, or function are NULL, we don't have to do anything:
   if (kernel == NULL || *kernel == NULL || file == NULL || function == NULL)
     return 0;