test: Add simple test cases for functions in src/StrToBS.c

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>

2 files changed, 173 insertions, 1 deletions

diff --git a/test/Makefile.am b/test/Makefile.am
index b4d9172..2daa571 100644
--- a/test/Makefile.am
+++ b/test/Makefile.am
@@ -30,7 +30,12 @@ AM_CFLAGS = $(CWARNFLAGS) $(XMU_CFLAGS) $(GLIB_CFLAGS)
 XMU_TEST_LIBS  = ${top_builddir}/src/libXmu.la $(XMU_LIBS) $(GLIB_LIBS)
 XMUU_TEST_LIBS = ${top_builddir}/src/libXmuu.la $(XMUU_LIBS) $(GLIB_LIBS)
 
-check_PROGRAMS = CursorName EditResStream Lower ReadBitmapData
+check_PROGRAMS = \
+        CursorName \
+        EditResStream \
+        Lower \
+        ReadBitmapData \
+        StrToBS
 TESTS = $(check_PROGRAMS)
 
 TESTS_ENVIRONMENT = $(MALLOC_DEBUG_ENV)
@@ -53,6 +58,9 @@ Lower_LDADD = $(XMUU_TEST_LIBS)
 ReadBitmapData_SOURCES = ReadBitmapData.c
 ReadBitmapData_LDADD = $(XMU_TEST_LIBS)
 
+StrToBS_SOURCES = StrToBS.c
+StrToBS_LDADD = $(XMU_TEST_LIBS)
+
 endif HAVE_GLIB
 endif ENABLE_UNIT_TESTS
 
diff --git a/test/StrToBS.c b/test/StrToBS.c
new file mode 100644
index 0000000..d2e0a43
--- /dev/null
+++ b/test/StrToBS.c
@@ -0,0 +1,164 @@
+/*
+ * Copyright (c) 2023, Oracle and/or its affiliates.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a
+ * copy of this software and associated documentation files (the "Software"),
+ * to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+ * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ */
+
+/* Test code for functions in src/StrToBS.c */
+#include "config.h"
+#include <X11/Xmu/Converters.h>
+#include <X11/Xmu/CharSet.h>
+#include <glib.h>
+
+struct TestData {
+    const char *name;
+    int value;
+};
+
+static const struct TestData data[] = {
+    { XtEnotUseful, NotUseful },
+    { XtEwhenMapped, WhenMapped },
+    { XtEalways, Always },
+    { XtEdefault, Always + WhenMapped + NotUseful}
+};
+#define DATA_ENTRIES (sizeof(data) / sizeof(data[0]))
+
+static int warning_count;
+
+static void
+xt_warning_handler(String message)
+{
+    g_test_message("Caught warning: %s", message ? message : "<NULL>");
+    warning_count++;
+}
+
+
+
+static void
+test_XmuCvtStringToBackingStore(void)
+{
+    XrmValue from, to, args;
+    Cardinal nargs = 0;
+
+    char namebuf[16];
+
+    for (unsigned int i = 0; i < DATA_ENTRIES; i++) {
+        g_test_message("StringToBackingStore(%s)", data[i].name);
+
+        strncpy(namebuf, data[i].name, sizeof(namebuf) - 1);
+        namebuf[sizeof(namebuf) - 1] = 0;
+        from.addr = namebuf;
+        from.size = sizeof(char *);
+        XmuCvtStringToBackingStore(NULL, &nargs, &from, &to);
+        g_assert_cmpint(*(int *)to.addr, ==, data[i].value);
+        g_assert_cmpint(to.size, ==, sizeof(int));
+
+
+        XmuNCopyISOLatin1Uppered(namebuf, data[i].name, sizeof(namebuf));
+        from.addr = namebuf;
+        from.size = sizeof(char *);
+        XmuCvtStringToBackingStore(NULL, &nargs, &from, &to);
+        g_assert_cmpint(*(int *)to.addr, ==, data[i].value);
+        g_assert_cmpint(to.size, ==, sizeof(int));
+    }
+
+    /* Verify warning issued for unused args */
+    warning_count = 0;
+    nargs = 1;
+    g_test_message("StringToBackingStore with extra args");
+    XmuCvtStringToBackingStore(&args, &nargs, &from, &to);
+    g_assert_cmpint(warning_count, >, 0);
+
+    /* Verify warning issued for unknown string */
+    warning_count = 0;
+    from.addr = (char *) "DoesNotExist";
+    nargs = 0;
+    g_test_message("StringToBackingStore(%s)", from.addr);
+    XmuCvtStringToBackingStore(NULL, &nargs, &from, &to);
+    g_assert_cmpint(warning_count, >, 0);
+}
+
+static void
+test_XmuCvtBackingStoreToString(void)
+{
+    XrmValue from, to;
+    int value;
+    Cardinal nargs = 0;
+    Boolean ret;
+    char namebuf[16];
+
+
+    for (unsigned int i = 0; i < DATA_ENTRIES; i++) {
+        g_test_message("BackingStoreToString(%d)", data[i].value);
+
+        value = data[i].value;
+        from.addr = (XPointer) &value;
+        from.size = sizeof(int *);
+
+        /* First test without providing a buffer to copy the string into */
+        to.addr = NULL;
+        to.size = 0;
+        ret = XmuCvtBackingStoreToString(NULL, NULL, &nargs, &from, &to, NULL);
+        g_assert_cmpint(ret, ==, True);
+        g_assert_cmpstr(to.addr, ==, data[i].name);
+        g_assert_cmpint(to.size, ==, sizeof(char *));
+
+        /* Then test with a buffer that's too small to copy the string into */
+        to.addr = namebuf;
+        to.size = 4;
+        ret = XmuCvtBackingStoreToString(NULL, NULL, &nargs, &from, &to, NULL);
+        g_assert_cmpint(ret, ==, False);
+        g_assert_cmpint(to.size, ==, strlen(data[i].name) + 1);
+
+        /* Then test with a buffer that's big enough to copy the string into */
+        to.addr = namebuf;
+        to.size = sizeof(namebuf);
+        ret = XmuCvtBackingStoreToString(NULL, NULL, &nargs, &from, &to, NULL);
+        g_assert_cmpint(ret, ==, True);
+        g_assert_cmpstr(to.addr, ==, data[i].name);
+        g_assert_cmpint(to.size, ==, sizeof(char *));
+    }
+
+    /* Verify warning and return of False for invalid value */
+    warning_count = 0;
+    value = 1984;
+    from.addr = (XPointer) &value;
+    g_test_message("BackingStoreToString(%d)", value);
+    ret = XmuCvtBackingStoreToString(NULL, NULL, &nargs, &from, &to, NULL);
+    g_assert_cmpint(ret, ==, False);
+    g_assert_cmpint(warning_count, >, 0);
+}
+
+int
+main(int argc, char** argv)
+{
+    g_test_init(&argc, &argv, NULL);
+    g_test_bug_base(PACKAGE_BUGREPORT);
+
+    XtSetWarningHandler(xt_warning_handler);
+
+    g_test_add_func("/StrToBS/XmuCvtStringToBackingStore",
+                    test_XmuCvtStringToBackingStore);
+    g_test_add_func("/StrToBS/XmuCvtBackingStoreToString",
+                    test_XmuCvtBackingStoreToString);
+
+
+    return g_test_run();
+}