gstreamer_core/libs/gst/check/gstcheck.h
changeset 0 0e761a78d257
child 8 4a7fac7dd34a
child 29 567bb019e3e3
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/gstreamer_core/libs/gst/check/gstcheck.h	Thu Dec 17 08:53:32 2009 +0200
@@ -0,0 +1,607 @@
+/* GStreamer
+ *
+ * Common code for GStreamer unittests
+ *
+ * Copyright (C) <2004> Thomas Vander Stichele <thomas at apestaart dot org>
+ * Copyright (C) <2008> Thijs Vermeir <thijsvermeir@gmail.com>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+#ifndef __GST_CHECK_H__
+#define __GST_CHECK_H__
+
+#include <signal.h>
+#include <string.h>
+#include <stdlib.h>
+#include <math.h>
+
+#include "check.h"
+
+#include "libgstreamer_wsd_solution.h" 
+
+#include <gst/gst.h>
+
+G_BEGIN_DECLS
+
+GST_DEBUG_CATEGORY_EXTERN (check_debug);
+#define GST_CAT_DEFAULT check_debug
+
+/* logging function for tests
+ * a test uses g_message() to log a debug line
+ * a gst unit test can be run with GST_TEST_DEBUG env var set to see the
+ * messages
+ */
+// These below variable has been defined in gstcheck.c
+#if 0 
+extern gboolean _gst_check_threads_running;
+extern gboolean _gst_check_raised_critical;
+extern gboolean _gst_check_raised_warning;
+extern gboolean _gst_check_expecting_log;
+#endif
+
+//#if EMULATOR
+//GET_GLOBAL_VAR_FROM_TLS(_gst_check_raised_critical,gstcheck,gboolean)
+//#define _gst_check_raised_critical (*GET_GSTREAMER_WSD_VAR_NAME(_gst_check_raised_critical,gstcheck,g)())
+//#else 
+//extern gboolean _gst_check_raised_critical;
+//#endif
+//
+//#if EMULATOR
+//GET_GLOBAL_VAR_FROM_TLS(_gst_check_threads_running,gstcheck,gboolean)
+//#define _gst_check_threads_running (*GET_GSTREAMER_WSD_VAR_NAME(_gst_check_threads_running,gstcheck,g)())
+//#else 
+//extern gboolean _gst_check_threads_running;
+//#endif
+//
+//#if EMULATOR
+//GET_GLOBAL_VAR_FROM_TLS(_gst_check_expecting_log,gstcheck,gboolean)
+//#define _gst_check_expecting_log (*GET_GSTREAMER_WSD_VAR_NAME(_gst_check_expecting_log,gstcheck,g)())
+//#else 
+//extern gboolean _gst_check_expecting_log;
+//#endif
+
+
+/* global variables used in test methods */
+//extern GList * buffers;
+//#if EMULATOR
+//GET_GLOBAL_VAR_FROM_TLS(buffers,gstcheck,GList*)
+//#define buffers (*GET_GSTREAMER_WSD_VAR_NAME(buffers,gstcheck,g)())
+//#else 
+//extern GList *buffers = NULL;
+//#endif
+//
+//extern GMutex *check_mutex;
+//#if EMULATOR
+//GET_GLOBAL_VAR_FROM_TLS(check_mutex,gstcheck,GMutex *)
+//#define check_mutex (*GET_GSTREAMER_WSD_VAR_NAME(check_mutex,gstcheck,g)())
+//#else 
+//extern GMutex *check_mutex = NULL;
+//#endif
+//
+//extern GCond *check_cond;
+//#if EMULATOR
+//GET_GLOBAL_VAR_FROM_TLS(check_cond,gstcheck,GCond *)
+//#define check_cond (*GET_GSTREAMER_WSD_VAR_NAME(check_cond,gstcheck,g)())
+//#else 
+//extern GCond *check_cond = NULL;
+//#endif
+
+
+
+typedef struct
+{
+  char *name;
+  int size;
+  int abi_size;
+}
+GstCheckABIStruct;
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+
+void gst_check_init (int *argc, char **argv[]);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+
+GstFlowReturn gst_check_chain_func (GstPad * pad, GstBuffer * buffer);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+
+void gst_check_message_error (GstMessage * message, GstMessageType type,
+    GQuark domain, gint code);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+
+GstElement *gst_check_setup_element (const gchar * factory);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+void gst_check_teardown_element (GstElement * element);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+GstPad *gst_check_setup_src_pad (GstElement * element,
+    GstStaticPadTemplate * template, GstCaps * caps);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+void gst_check_teardown_src_pad (GstElement * element);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+void gst_check_drop_buffers ();
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+void gst_check_caps_equal (GstCaps * caps1, GstCaps * caps2);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+void gst_check_element_push_buffer_list (const gchar * element_name,
+    GList * buffer_in, GList * buffer_out, GstFlowReturn last_flow_return);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+void gst_check_element_push_buffer (const gchar * element_name,
+    GstBuffer * buffer_in, GstBuffer * buffer_out);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+GstPad *gst_check_setup_sink_pad (GstElement * element,
+    GstStaticPadTemplate * template, GstCaps * caps);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+void gst_check_teardown_sink_pad (GstElement * element);
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+void gst_check_abi_list (GstCheckABIStruct list[], gboolean have_abi_sizes);
+//gint gst_check_run_suite (Suite * suite, const gchar * name,
+//    const gchar * fname);
+
+#define fail_unless_message_error(msg, domain, code)		\
+gst_check_message_error (msg, GST_MESSAGE_ERROR,		\
+  GST_ ## domain ## _ERROR, GST_ ## domain ## _ERROR_ ## code)
+#define assert_message_error(m, d, c) fail_unless_message_error(m, d, c)
+
+/**
+ * GST_START_TEST:
+ * @__testname: test function name
+ *
+ * wrapper for checks START_TEST
+ */
+/**
+ * GST_END_TEST:
+ *
+ * wrapper for checks END_TEST
+ */
+
+/*
+#if CHECK_MAJOR_VERSION > 0 || \
+    (CHECK_MAJOR_VERSION == 0 && CHECK_MINOR_VERSION > 9) || \
+    (CHECK_MAJOR_VERSION == 0 && CHECK_MINOR_VERSION == 9 && CHECK_MICRO_VERSION > 3)
+#define GST_START_TEST(__testname) \
+static void __testname (int __i__)\
+{\
+  GST_DEBUG ("test start"); \
+  tcase_fn_start (""# __testname, __FILE__, __LINE__);
+
+#define GST_END_TEST END_TEST
+#else
+*/
+//#define GST_START_TEST(__testname)                      \
+//void __testname ()                 
+
+//  GST_DEBUG ("test start"); 
+////  tcase_fn_start (""# __testname, __FILE__, __LINE__);
+//
+//#define GST_END_TEST END_TEST
+//#endif
+
+//#define GST_END_TEST }
+
+/* additional fail macros */
+/**
+ * fail_unless_equals_int:
+ * @a: a #gint value or expression
+ * @b: a #gint value or expression
+ *
+ * This macro checks that @a and @b are equal and aborts if this is not the
+ * case, printing both expressions and the values they evaluated to. This
+ * macro is for use in unit tests.
+ */
+#define fail_unless_equals_int(a, b)					\
+G_STMT_START {								\
+  int first = a;							\
+  int second = b;							\
+  fail_unless(first == second,						\
+    "'" #a "' (%d) is not equal to '" #b"' (%d)", first, second);	\
+} G_STMT_END;
+/**
+ * assert_equals_int:
+ * @a: a #gint value or expression
+ * @b: a #gint value or expression
+ *
+ * This macro checks that @a and @b are equal and aborts if this is not the
+ * case, printing both expressions and the values they evaluated to. This
+ * macro is for use in unit tests.
+ */
+#define assert_equals_int(a, b) fail_unless_equals_int(a, b)
+
+/**
+ * fail_unless_equals_uint64:
+ * @a: a #guint64 value or expression
+ * @b: a #guint64 value or expression
+ *
+ * This macro checks that @a and @b are equal and aborts if this is not the
+ * case, printing both expressions and the values they evaluated to. This
+ * macro is for use in unit tests.
+ */
+#define fail_unless_equals_uint64(a, b)					\
+G_STMT_START {								\
+  guint64 first = a;							\
+  guint64 second = b;							\
+  fail_unless(first == second,						\
+    "'" #a "' (%" G_GUINT64_FORMAT ") is not equal to '" #b"' (%"	\
+    G_GUINT64_FORMAT ")", first, second);				\
+} G_STMT_END;
+/**
+ * assert_equals_uint64:
+ * @a: a #guint64 value or expression
+ * @b: a #guint64 value or expression
+ *
+ * This macro checks that @a and @b are equal and aborts if this is not the
+ * case, printing both expressions and the values they evaluated to. This
+ * macro is for use in unit tests.
+ */
+#define assert_equals_uint64(a, b) fail_unless_equals_uint64(a, b)
+
+/**
+ * fail_unless_equals_string:
+ * @a: a string literal or expression
+ * @b: a string literal or expression
+ *
+ * This macro checks that @a and @b are equal (as per strcmp) and aborts if
+ * this is not the case, printing both expressions and the values they
+ * evaluated to. This macro is for use in unit tests.
+ */
+#define fail_unless_equals_string(a, b)                             \
+G_STMT_START {                                                      \
+  const gchar * first = a;                                          \
+  const gchar * second = b;                                         \
+  fail_unless(strcmp (first, second) == 0,                          \
+    "'" #a "' (%s) is not equal to '" #b"' (%s)", first, second);   \
+} G_STMT_END;
+/**
+ * assert_equals_string:
+ * @a: a string literal or expression
+ * @b: a string literal or expression
+ *
+ * This macro checks that @a and @b are equal (as per strcmp) and aborts if
+ * this is not the case, printing both expressions and the values they
+ * evaluated to. This macro is for use in unit tests.
+ */
+#define assert_equals_string(a, b) fail_unless_equals_string(a, b)
+
+/**
+ * fail_unless_equals_float:
+ * @a: a #gdouble or #gfloat value or expression
+ * @b: a #gdouble or #gfloat value or expression
+ *
+ * This macro checks that @a and @b are (almost) equal and aborts if this
+ * is not the case, printing both expressions and the values they evaluated
+ * to. This macro is for use in unit tests.
+ *
+ * Since: 0.10.14
+ */
+#define fail_unless_equals_float(a, b)                            \
+G_STMT_START {                                                    \
+  double first = a;                                               \
+  double second = b;                                              \
+  /* This will only work for 'normal' values and values around 0, \
+   * which should be good enough for our purposes here */         \
+  fail_unless(fabs (first - second) < 0.0000001,                  \
+    "'" #a "' (%g) is not equal to '" #b "' (%g)", first, second);\
+} G_STMT_END;
+
+/**
+ * assert_equals_float:
+ * @a: a #gdouble or #gfloat value or expression
+ * @b: a #gdouble or #gfloat value or expression
+ *
+ * This macro checks that @a and @b are (almost) equal and aborts if this
+ * is not the case, printing both expressions and the values they evaluated
+ * to. This macro is for use in unit tests.
+ *
+ * Since: 0.10.14
+ */
+#define assert_equals_float(a, b) fail_unless_equals_float(a, b)
+
+
+/***
+ * thread test macros and variables
+ */
+//extern GList *thread_list;
+//extern GMutex *mutex;
+//extern GCond *start_cond;	/* used to notify main thread of thread startups */
+//extern GCond *sync_cond;	/* used to synchronize all threads and main thread */
+
+#define MAIN_START_THREADS(count, function, data)		\
+MAIN_INIT();							\
+MAIN_START_THREAD_FUNCTIONS(count, function, data);		\
+MAIN_SYNCHRONIZE();
+
+#define MAIN_INIT()			\
+G_STMT_START {				\
+  _gst_check_threads_running = TRUE;	\
+					\
+  mutex = g_mutex_new ();		\
+  start_cond = g_cond_new ();		\
+  sync_cond = g_cond_new ();		\
+} G_STMT_END;
+
+#define MAIN_START_THREAD_FUNCTIONS(count, function, data)	\
+G_STMT_START {							\
+  int i;							\
+  for (i = 0; i < count; ++i) {					\
+    MAIN_START_THREAD_FUNCTION (i, function, data);		\
+  }								\
+} G_STMT_END;
+
+#define MAIN_START_THREAD_FUNCTION(i, function, data)		\
+G_STMT_START {							\
+    GThread *thread = NULL;					\
+    GST_DEBUG ("MAIN: creating thread %d", i);			\
+    g_mutex_lock (mutex);					\
+    thread = g_thread_create ((GThreadFunc) function, data,	\
+	TRUE, NULL);						\
+    /* wait for thread to signal us that it's ready */		\
+    GST_DEBUG ("MAIN: waiting for thread %d", i);		\
+    g_cond_wait (start_cond, mutex);				\
+    g_mutex_unlock (mutex);					\
+								\
+    thread_list = g_list_append (thread_list, thread);		\
+} G_STMT_END;
+
+
+#define MAIN_SYNCHRONIZE()		\
+G_STMT_START {				\
+  GST_DEBUG ("MAIN: synchronizing");	\
+  g_cond_broadcast (sync_cond);		\
+  GST_DEBUG ("MAIN: synchronized");	\
+} G_STMT_END;
+
+#define MAIN_STOP_THREADS()					\
+G_STMT_START {							\
+  _gst_check_threads_running = FALSE;				\
+								\
+  /* join all threads */					\
+  GST_DEBUG ("MAIN: joining");					\
+  g_list_foreach (thread_list, (GFunc) g_thread_join, NULL);	\
+  GST_DEBUG ("MAIN: joined");					\
+} G_STMT_END;
+
+#define THREAD_START()						\
+THREAD_STARTED();						\
+THREAD_SYNCHRONIZE();
+
+#define THREAD_STARTED()					\
+G_STMT_START {							\
+  /* signal main thread that we started */			\
+  GST_DEBUG ("THREAD %p: started", g_thread_self ());		\
+  g_mutex_lock (mutex);						\
+  g_cond_signal (start_cond);					\
+} G_STMT_END;
+
+#define THREAD_SYNCHRONIZE()					\
+G_STMT_START {							\
+  /* synchronize everyone */					\
+  GST_DEBUG ("THREAD %p: syncing", g_thread_self ());		\
+  g_cond_wait (sync_cond, mutex);				\
+  GST_DEBUG ("THREAD %p: synced", g_thread_self ());		\
+  g_mutex_unlock (mutex);					\
+} G_STMT_END;
+
+#define THREAD_SWITCH()						\
+G_STMT_START {							\
+  /* a minimal sleep is a context switch */			\
+  g_usleep (1);							\
+} G_STMT_END;
+
+#define THREAD_TEST_RUNNING()	(_gst_check_threads_running == TRUE)
+
+/* additional assertions */
+#define ASSERT_CRITICAL(code)					\
+G_STMT_START {							\
+  _gst_check_expecting_log = TRUE;				\
+  _gst_check_raised_critical = FALSE;				\
+  code;								\
+  _fail_unless (_gst_check_raised_critical, __FILE__, __LINE__, \
+                "Expected g_critical, got nothing", NULL);      \
+  _gst_check_expecting_log = FALSE;				\
+} G_STMT_END
+
+#define ASSERT_WARNING(code)					\
+G_STMT_START {							\
+  _gst_check_expecting_log = TRUE;				\
+  _gst_check_raised_warning = FALSE;				\
+  code;								\
+  _fail_unless (_gst_check_raised_warning, __FILE__, __LINE__,  \
+                "Expected g_warning, got nothing", NULL);       \
+  _gst_check_expecting_log = FALSE;				\
+} G_STMT_END
+
+
+#define ASSERT_OBJECT_REFCOUNT(object, name, value)		\
+G_STMT_START {							\
+  int rc;							\
+  rc = GST_OBJECT_REFCOUNT_VALUE (object);			\
+  fail_unless (rc == value,					\
+      "%s (%p) refcount is %d instead of %d",			\
+      name, object, rc, value);					\
+} G_STMT_END
+
+#define ASSERT_OBJECT_REFCOUNT_BETWEEN(object, name, lower, upper)	\
+G_STMT_START {								\
+  int rc = GST_OBJECT_REFCOUNT_VALUE (object);				\
+  int lo = lower;							\
+  int hi = upper;							\
+									\
+  fail_unless (rc >= lo,						\
+      "%s (%p) refcount %d is smaller than %d",				\
+      name, object, rc, lo);						\
+  fail_unless (rc <= hi,						\
+      "%s (%p) refcount %d is bigger than %d",				\
+      name, object, rc, hi);						\
+} G_STMT_END
+
+
+#define ASSERT_CAPS_REFCOUNT(caps, name, value)			\
+	ASSERT_MINI_OBJECT_REFCOUNT(caps, name, value)
+
+#define ASSERT_BUFFER_REFCOUNT(buffer, name, value)		\
+	ASSERT_MINI_OBJECT_REFCOUNT(buffer, name, value)
+
+#define ASSERT_MINI_OBJECT_REFCOUNT(caps, name, value)		\
+G_STMT_START {							\
+  int rc;							\
+  rc = GST_MINI_OBJECT_REFCOUNT_VALUE (caps);			\
+  fail_unless (rc == value,					\
+               name " refcount is %d instead of %d", rc, value);\
+} G_STMT_END
+
+#define ASSERT_SET_STATE(element, state, ret)			\
+fail_unless (gst_element_set_state (element,			\
+  state) == ret,						\
+  "could not change state to " #state);
+
+/*
+#define GST_CHECK_MAIN(name)					\
+int main (int argc, char **argv)				\
+{								\
+    int i, num_fun;                  \
+gst_check_init (NULL, NULL);                    \
+i = sizeof(args);                           \
+ num_fun = i/sizeof(int);                   \
+  for(i=0;i<num_fun;i++)                    \
+      if (!strcmp(args[i], argv[1]))                    \
+      {                                     \
+          fn[i]();                                  \
+          break;                                        \
+          }                     \
+  if(i == num_fun)                      \
+      std_log(LOG_FILENAME_LINE, "%s is invalid args", argv[1]);                      \
+  return 0;                                         \
+}
+
+*/
+
+
+#define GST_CHECK_MAIN(name)                    \
+    int main (int argc, char **argv)        \
+    {                                   \
+        int i, num_fun;                  \
+        char filename[150];       \
+        char * pch;                     \
+        char* last[3];                  \
+        strcpy(filename,__FILE__);                  \
+        pch = strtok (filename,"\\.");           \
+        while (pch != NULL)               \
+        {                             \
+        last[2] = last[1];              \
+        last[1] = last[0];              \
+        last[0] = pch;                  \
+        pch = strtok (NULL, "\\.");             \
+        }                                 \
+        strcpy(filename, last[1]);              \
+        strcat(filename, "_");              \
+        strcat(filename, argv[1]);          \
+        xmlfile = filename;                 \
+    gst_check_init (NULL, NULL);            \
+     i = sizeof(args);                  \
+     num_fun = i/sizeof(int);               \
+      for(i=0;i<num_fun;i++)                     \
+          if (!strcmp(args[i], argv[1]))          \
+          {                                     \
+          fn[i]();                  \
+              break;                                        \
+              }                     \
+      if(i == num_fun)                      \
+          std_log(LOG_FILENAME_LINE, "%s is invalid args", argv[1]);    \
+      return 0;                 \
+    }
+
+
+
+
+/* Hack to allow run-time selection of unit tests to run via the
+ * GST_CHECKS environment variable (test function names, comma-separated) */
+#ifdef __SYMBIAN32__
+IMPORT_C
+#endif
+
+
+gboolean _gst_check_run_test_func (const gchar * func_name);
+
+/*
+#if CHECK_MAJOR_VERSION > 0 || \
+    (CHECK_MAJOR_VERSION == 0 && CHECK_MINOR_VERSION > 9) || \
+    (CHECK_MAJOR_VERSION == 0 && CHECK_MINOR_VERSION == 9 && CHECK_MICRO_VERSION > 3)
+static inline void
+__gst_tcase_add_test (TCase * tc, TFun tf, const char * fname, int signal,
+    int start, int end)
+{
+  if (_gst_check_run_test_func (fname)) {
+    _tcase_add_test (tc, tf, fname, signal, start, end);
+  }
+}
+#else
+*/
+/*
+static inline void
+__gst_tcase_add_test (TCase * tc, TFun tf, const char * fname, int signal)
+{
+  if (_gst_check_run_test_func (fname)) {
+    _tcase_add_test (tc, tf, fname, signal);
+  }
+}
+*/
+//#endif
+
+//#define _tcase_add_test __gst_tcase_add_test
+
+G_END_DECLS
+
+#endif /* __GST_CHECK_H__ */