test_key: add small helper for client-side key-input

We sometimes need to test what keys a client receives when specific keys
are pressed. This small helper simply runs in a terminal and receives raw
keyboard input and prints it to stdout with debugging information.

This can definitely be improved with the help of the TSM state-machine to
print more useful information and directly parse the input. However, this
is better than nothing.

Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>

diff --git a/Makefile.am b/Makefile.am
index ad97647..22eff77 100644 (file)
--- a/Makefile.am
+++ b/Makefile.am
@@ -28,10 +28,7 @@ pkgconfig_DATA =
 
 bin_PROGRAMS = \
        kmscon
-check_PROGRAMS = \
-       test_output \
-       test_vt \
-       test_input
+check_PROGRAMS =
 noinst_PROGRAMS = \
        genshader \
        genunifont
@@ -389,11 +386,17 @@ kmscon_LDADD = \
        libeloop.la \
        libkmscon-core.la
 
+check_PROGRAMS += test_output
 test_output_SOURCES = tests/test_output.c tests/test_include.h
 test_output_LDADD = libkmscon-core.la
 
+check_PROGRAMS += test_vt
 test_vt_SOURCES = tests/test_vt.c
 test_vt_LDADD = libkmscon-core.la
 
+check_PROGRAMS += test_input
 test_input_SOURCES = tests/test_input.c
 test_input_LDADD = libkmscon-core.la
+
+check_PROGRAMS += test_key
+test_key_SOURCES = tests/test_key.c

diff --git a/tests/test_key.c b/tests/test_key.c
new file mode 100644 (file)
index 0000000..f5e2446
--- /dev/null
+++ b/tests/test_key.c
@@ -0,0 +1,78 @@
+/*
+ * test_key - Test client key-input
+ *
+ * Copyright (c) 2012 David Herrmann <dh.herrmann@googlemail.com>
+ *
+ * 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 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.
+ */
+
+#include <errno.h>
+#include <stdbool.h>
+#include <stdio.h>
+#include <string.h>
+#include <termios.h>
+
+int main()
+{
+       int res;
+       unsigned char buf;
+       struct termios omode, nmode;
+       bool reset = false;
+
+       fprintf(stderr, "Quit with 'q' (maybe followed by 'enter'/'return')\r\n");
+       fprintf(stderr, "Maybe your terminal may be unusable after this, use 'reset' to fix it\r\n");
+
+       if (tcgetattr(0, &omode) < 0) {
+               fprintf(stderr, "cannot retrieve terminal attributes (%d): %m\r\n",
+                       errno);
+       } else {
+               memcpy(&nmode, &omode, sizeof(nmode));
+               cfmakeraw(&nmode);
+               if (tcsetattr(0, TCSANOW, &nmode) < 0)
+                       fprintf(stderr, "cannot set terminal attributes (%d): %m\r\n",
+                               errno);
+               else
+                       reset = true;
+       }
+
+       while (1) {
+               res = fread(&buf, 1, 1, stdin);
+               if (res != 1) {
+                       fprintf(stderr, "error on stdin: %d %d: %m\r\n",
+                               res, errno);
+                       break;
+               }
+
+               if (buf == '\n')
+                       fprintf(stderr, "key: <newline>\r\n");
+               else
+                       fprintf(stderr, "key: %x %u %o '%c'\r\n",
+                               (int)buf, buf, buf, buf);
+
+               if (buf == 'q')
+                       break;
+       }
+
+       if (reset && tcsetattr(0, TCSANOW, &omode) < 0)
+               fprintf(stderr, "cannot reset terminal attributes (%d): %m\r\n",
+                       errno);
+
+       return 0;
+}