initial commit

8 files changed, 992 insertions, 0 deletions

diff --git a/src/honeysuckle/honeysuckle.h b/src/honeysuckle/honeysuckle.h
new file mode 100644
index 0000000..96243ba
--- /dev/null
+++ b/src/honeysuckle/honeysuckle.h
@@ -0,0 +1,523 @@
+#ifndef HONEYSUCKLE_H
+#define HONEYSUCKLE_H
+
+#include <stdbool.h>
+
+#include <lua.h>
+#include <lualib.h>
+#include <lauxlib.h>
+
+/* variadic macro argument counting */
+#ifndef VA_NARGS
+
+#define VA_NARGS(...) VA_NARGS_SHIFT_COUNT(__VA_ARGS__, VA_NARGS_COUNTS)
+
+#define VA_NARGS_COUNTS				\
+  255, 254, 253, 252, 251, 250, 249, 248,	\
+    247, 246, 245, 244, 243, 242, 241, 240,	\
+    239, 238, 237, 236, 235, 234, 233, 232,	\
+    231, 230, 229, 228, 227, 226, 225, 224,	\
+    223, 222, 221, 220, 219, 218, 217, 216,	\
+    215, 214, 213, 212, 211, 210, 209, 208,	\
+    207, 206, 205, 204, 203, 202, 201, 200,	\
+    199, 198, 197, 196, 195, 194, 193, 192,	\
+    191, 190, 189, 188, 187, 186, 185, 184,	\
+    183, 182, 181, 180, 179, 178, 177, 176,	\
+    175, 174, 173, 172, 171, 170, 169, 168,	\
+    167, 166, 165, 164, 163, 162, 161, 160,	\
+    159, 158, 157, 156, 155, 154, 153, 152,	\
+    151, 150, 149, 148, 147, 146, 145, 144,	\
+    143, 142, 141, 140, 139, 138, 137, 136,	\
+    135, 134, 133, 132, 131, 130, 129, 128,	\
+    127, 126, 125, 124, 123, 122, 121, 120,	\
+    119, 118, 117, 116, 115, 114, 113, 112,	\
+    111, 110, 109, 108, 107, 106, 105, 104,	\
+    103, 102, 101, 100, 99, 98, 97, 96,		\
+    95, 94, 93, 92, 91, 90, 89, 88,		\
+    87, 86, 85, 84, 83, 82, 81, 80,		\
+    79, 78, 77, 76, 75, 74, 73, 72,		\
+    71, 70, 69, 68, 67, 66, 65, 64,		\
+    63, 62, 61, 60, 59, 58, 57, 56,		\
+    55, 54, 53, 52, 51, 50, 49, 48,		\
+    47, 46, 45, 44, 43, 42, 41, 40,		\
+    39, 38, 37, 36, 35, 34, 33, 32,		\
+    31, 30, 29, 28, 27, 26, 25, 24,		\
+    23, 22, 21, 20, 19, 18, 17, 16,		\
+    15, 14, 13, 12, 11, 10, 9, 8,		\
+    7, 6, 5, 4, 3, 2, 1, 0
+
+#define VA_NARGS_GET_COUNT(					\
+		       _255, _254, _253, _252, _251, _250, _249, _248,	\
+		       _247, _246, _245, _244, _243, _242, _241, _240,	\
+		       _239, _238, _237, _236, _235, _234, _233, _232,	\
+		       _231, _230, _229, _228, _227, _226, _225, _224,	\
+		       _223, _222, _221, _220, _219, _218, _217, _216,	\
+		       _215, _214, _213, _212, _211, _210, _209, _208,	\
+		       _207, _206, _205, _204, _203, _202, _201, _200,	\
+		       _199, _198, _197, _196, _195, _194, _193, _192,	\
+		       _191, _190, _189, _188, _187, _186, _185, _184,	\
+		       _183, _182, _181, _180, _179, _178, _177, _176,	\
+		       _175, _174, _173, _172, _171, _170, _169, _168,	\
+		       _167, _166, _165, _164, _163, _162, _161, _160,	\
+		       _159, _158, _157, _156, _155, _154, _153, _152,	\
+		       _151, _150, _149, _148, _147, _146, _145, _144,	\
+		       _143, _142, _141, _140, _139, _138, _137, _136,	\
+		       _135, _134, _133, _132, _131, _130, _129, _128,	\
+		       _127, _126, _125, _124, _123, _122, _121, _120,	\
+		       _119, _118, _117, _116, _115, _114, _113, _112,	\
+		       _111, _110, _109, _108, _107, _106, _105, _104,	\
+		       _103, _102, _101, _100, _99, _98, _97, _96,	\
+		       _95, _94, _93, _92, _91, _90, _89, _88,		\
+		       _87, _86, _85, _84, _83, _82, _81, _80,		\
+		       _79, _78, _77, _76, _75, _74, _73, _72,		\
+		       _71, _70, _69, _68, _67, _66, _65, _64,		\
+		       _63, _62, _61, _60, _59, _58, _57, _56,		\
+		       _55, _54, _53, _52, _51, _50, _49, _48,		\
+		       _47, _46, _45, _44, _43, _42, _41, _40,		\
+		       _39, _38, _37, _36, _35, _34, _33, _32,		\
+		       _31, _30, _29, _28, _27, _26, _25, _24,		\
+		       _23, _22, _21, _20, _19, _18, _17, _16,		\
+		       _15, _14, _13, _12, _11, _10, _9, _8,		\
+		       _7, _6, _5, _4, _3, _2, _1, N, ...) N
+
+#define VA_NARGS_SHIFT_COUNT(...) VA_NARGS_GET_COUNT(__VA_ARGS__)
+
+#endif
+
+
+/* type constants */
+typedef enum
+  { HS_BOOL,
+    HS_INT,
+    HS_NUM,
+    HS_STR,
+    HS_TBL,
+    HS_FUNC,
+    HS_CFUNC,
+    HS_USER,
+    HS_LIGHT,
+    HS_NIL,
+    HS_ANY,
+  } hs_type;
+
+const char* hs_type_to_string(hs_type type);
+
+/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ *
+ * hs_parse_args and hs_parse_overloaded
+ *
+ * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ */
+
+struct hs_arg {
+  hs_type type;
+  union {
+    bool *boolean;
+    lua_Integer *integer;
+    lua_Number *number;
+    char **string;
+    int *stack_index;
+    lua_CFunction *function;
+    void **userdata;
+  } ptr;
+};
+
+#define hs_bool(x)  { .type=HS_BOOL,  .ptr.boolean = &(x) }
+#define hs_int(x)   { .type=HS_INT,   .ptr.integer = &(x) }
+#define hs_num(x)   { .type=HS_NUM,   .ptr.number = &(x) }
+#define hs_str(x)   { .type=HS_STR,   .ptr.string = &(x) }
+#define hs_tbl(x)   { .type=HS_TBL,   .ptr.stack_index = &(x) }
+#define hs_func(x)  { .type=HS_FUNC,  .ptr.stack_index = &(x) }
+#define hs_cfunc(x) { .type=HS_CFUNC, .ptr.function = &(x) }
+#define hs_user(x)  { .type=HS_USER,  .ptr.userdata = &(x) }
+#define hs_light(x) { .type=HS_LIGHT, .ptr.userdata = &(x) }
+#define hs_nil(x)   { .type=HS_NIL,   .ptr.stack_index = &(x) }
+#define hs_any(x)   { .type=HS_ANY,   .ptr.stack_index = &(x) }
+
+void hs_parse_args_(lua_State *L, int n_args, struct hs_arg *arguments);
+
+#define hs_parse_args(L, ...)				\
+   hs_parse_args_(L,					\
+		  VA_NARGS(__VA_ARGS__)/2,		\
+		 (struct hs_arg[]) { __VA_ARGS__ })
+
+
+#define hs_overload(...) VA_NARGS(__VA_ARGS__)/2, (struct hs_arg[]) { __VA_ARGS__ }
+
+int hs_parse_overloaded_(lua_State *L, ...);
+
+#define hs_parse_overloaded(L, ...)		\
+   hs_parse_overloaded_(L, __VA_ARGS__, -1)
+
+/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ *
+ * hs_create_table
+ *
+ * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ */
+
+typedef union {
+   bool boolean;
+   lua_Integer integer;
+   lua_Number number;
+   char *string;
+   int stack_index;
+   lua_CFunction function;
+   void *userdata;
+} hs_value;
+
+struct hs_tbl_entry {
+   hs_type key_type;
+   hs_value key;
+   hs_type value_type;
+   hs_value value;
+};
+
+#define hs_bool_bool(k, v)				\
+   { .key_type=HS_BOOL, .key.boolean=k,			\
+	 .value_type=HS_BOOL, .value.boolean=v }
+#define hs_bool_int(k, v)			\
+   { .key_type=HS_BOOL, .key.boolean=k,		\
+	 .value_type=HS_INT, .value.integer=v }
+#define hs_bool_num(k, v)			\
+   { .key_type=HS_BOOL, .key.boolean=k,		\
+	 .value_type=HS_NUM, .value.number=v }
+#define hs_bool_str(k, v)			\
+   { .key_type=HS_BOOL, .key.boolean=k,		\
+	 .value_type=HS_STR, .value.string=v }
+#define hs_bool_tbl(k, v)				\
+   { .key_type=HS_BOOL, .key.boolean=k,			\
+	 .value_type=HS_TBL, .value.stack_index=v }
+#define hs_bool_func(k, v)				\
+   { .key_type=HS_BOOL, .key.boolean=k,			\
+	 .value_type=HS_FUNC, .value.stack_index=v }
+#define hs_bool_cfunc(k, v)				\
+   { .key_type=HS_BOOL, .key.boolean=k,			\
+	 .value_type=HS_CFUNC, .value.function=v }
+#define hs_bool_user(k, v)				\
+   { .key_type=HS_BOOL, .key.boolean=k,			\
+	 .value_type=HS_USER, .value.stack_index=v }
+#define hs_bool_light(k, v)				\
+   { .key_type=HS_BOOL, .key.boolean=k,			\
+	 .value_type=HS_LIGHT, .value.userdata=v }
+
+#define hs_int_bool(k, v)				\
+   { .key_type=HS_INT, .key.integer=k,			\
+	 .value_type=HS_BOOL, .value.boolean=v }
+#define hs_int_int(k, v)			\
+   { .key_type=HS_INT, .key.integer=k,		\
+	 .value_type=HS_INT, .value.integer=v }
+#define hs_int_num(k, v)			\
+   { .key_type=HS_INT, .key.integer=k,		\
+	 .value_type=HS_NUM, .value.number=v }
+#define hs_int_str(k, v)			\
+   { .key_type=HS_INT, .key.integer=k,		\
+	 .value_type=HS_STR, .value.string=v }
+#define hs_int_tbl(k, v)			\
+   { .key_type=HS_INT, .key.integer=k,		\
+	 .value_type=HS_TBL, .value.stack_index=v }
+#define hs_int_func(k, v)			\
+   { .key_type=HS_INT, .key.integer=k,		\
+	 .value_type=HS_FUNC, .value.stack_index=v }
+#define hs_int_cfunc(k, v)			\
+   { .key_type=HS_INT, .key.integer=k,		\
+	 .value_type=HS_CFUNC, .value.function=v }
+#define hs_int_user(k, v)			\
+   { .key_type=HS_INT, .key.integer=k,		\
+	 .value_type=HS_USER, .value.stack_index=v }
+#define hs_int_light(k, v)			\
+   { .key_type=HS_INT, .key.integer=k,		\
+	 .value_type=HS_LIGHT, .value.userdata=v }
+   
+#define hs_num_bool(k, v)			\
+   { .key_type=HS_NUM, .key.number=k,		\
+	 .value_type=HS_BOOL, .value.boolean=v }
+#define hs_num_int(k, v)			\
+   { .key_type=HS_NUM, .key.number=k,		\
+	 .value_type=HS_INT, .value.integer=v }
+#define hs_num_num(k, v)			\
+   { .key_type=HS_NUM, .key.number=k,		\
+	 .value_type=HS_NUM, .value.number=v }
+#define hs_num_str(k, v)			\
+   { .key_type=HS_NUM, .key.number=k,		\
+	 .value_type=HS_STR, .value.string=v }
+#define hs_num_tbl(k, v)			\
+   { .key_type=HS_NUM, .key.number=k,		\
+	 .value_type=HS_TBL, .value.stack_index=v }
+#define hs_num_func(k, v)			\
+   { .key_type=HS_NUM, .key.number=k,		\
+	 .value_type=HS_FUNC, .value.stack_index=v }
+#define hs_num_cfunc(k, v)			\
+   { .key_type=HS_NUM, .key.number=k,		\
+	 .value_type=HS_CFUNC, .value.function=v }
+#define hs_num_user(k, v)			\
+   { .key_type=HS_NUM, .key.number=k,		\
+	 .value_type=HS_USER, .value.stack_index=v }
+#define hs_num_light(k, v)			\
+   { .key_type=HS_NUM, .key.number=k,		\
+	 .value_type=HS_LIGHT, .value.userdata=v }
+
+#define hs_str_bool(k, v)			\
+   { .key_type=HS_STR, .key.string=k,		\
+	 .value_type=HS_BOOL, .value.boolean=v }
+#define hs_str_int(k, v)			\
+   { .key_type=HS_STR, .key.string=k,		\
+	 .value_type=HS_INT, .value.integer=v }
+#define hs_str_num(k, v)			\
+   { .key_type=HS_STR, .key.string=k,		\
+	 .value_type=HS_NUM, .value.number=v }
+#define hs_str_str(k, v)			\
+   { .key_type=HS_STR, .key.string=k,		\
+	 .value_type=HS_STR, .value.string=v }
+#define hs_str_tbl(k, v)			\
+   { .key_type=HS_STR, .key.string=k,		\
+	 .value_type=HS_TBL, .value.stack_index=v }
+#define hs_str_func(k, v)			\
+   { .key_type=HS_STR, .key.string=k,		\
+	 .value_type=HS_FUNC, .value.stack_index=v }
+#define hs_str_cfunc(k, v)			\
+   { .key_type=HS_STR, .key.string=k,		\
+	 .value_type=HS_CFUNC, .value.function=v }
+#define hs_str_user(k, v)			\
+   { .key_type=HS_STR, .key.string=k,		\
+	 .value_type=HS_USER, .value.stack_index=v }
+#define hs_str_light(k, v)			\
+   { .key_type=HS_STR, .key.string=k,		\
+	 .value_type=HS_LIGHT, .value.userdata=v }
+
+
+#define hs_tbl_bool(k, v)			\
+   { .key_type=HS_TBL, .key.stack_index=k,	\
+	 .value_type=HS_BOOL, .value.boolean=v }
+#define hs_tbl_int(k, v)			\
+   { .key_type=HS_TBL, .key.stack_index=k,	\
+	 .value_type=HS_INT, .value.integer=v }
+#define hs_tbl_num(k, v)			\
+   { .key_type=HS_TBL, .key.stack_index=k,	\
+	 .value_type=HS_NUM, .value.number=v }
+#define hs_tbl_str(k, v)			\
+   { .key_type=HS_TBL, .key.stack_index=k,	\
+	 .value_type=HS_STR, .value.string=v }
+#define hs_tbl_tbl(k, v)			\
+   { .key_type=HS_TBL, .key.stack_index=k,	\
+	 .value_type=HS_TBL, .value.stack_index=v }
+#define hs_tbl_func(k, v)			\
+   { .key_type=HS_TBL, .key.stack_index=k,	\
+	 .value_type=HS_FUNC, .value.stack_index=v }
+#define hs_tbl_cfunc(k, v)			\
+   { .key_type=HS_TBL, .key.stack_index=k,	\
+	 .value_type=HS_CFUNC, .value.function=v }
+#define hs_tbl_user(k, v)			\
+   { .key_type=HS_TBL, .key.stack_index=k,	\
+	 .value_type=HS_USER, .value.stack_index=v }
+#define hs_tbl_light(k, v)			\
+   { .key_type=HS_TBL, .key.stack_index=k,	\
+	 .value_type=HS_LIGHT, .value.userdata=v }
+
+#define hs_func_bool(k, v)			\
+   { .key_type=HS_FUNC, .key.stack_index=k,	\
+	 .value_type=HS_BOOL, .value.boolean=v }
+#define hs_func_int(k, v)			\
+   { .key_type=HS_FUNC, .key.stack_index=k,	\
+	 .value_type=HS_INT, .value.integer=v }
+#define hs_func_num(k, v)			\
+   { .key_type=HS_FUNC, .key.stack_index=k,	\
+	 .value_type=HS_NUM, .value.number=v }
+#define hs_func_str(k, v)			\
+   { .key_type=HS_FUNC, .key.stack_index=k,	\
+	 .value_type=HS_STR, .value.string=v }
+#define hs_func_tbl(k, v)			\
+   { .key_type=HS_FUNC, .key.stack_index=k,	\
+	 .value_type=HS_TBL, .value.stack_index=v }
+#define hs_func_func(k, v)			\
+   { .key_type=HS_FUNC, .key.stack_index=k,	\
+	 .value_type=HS_FUNC, .value.stack_index=v }
+#define hs_func_cfunc(k, v)			\
+   { .key_type=HS_FUNC, .key.stack_index=k,	\
+	 .value_type=HS_CFUNC, .value.function=v }
+#define hs_func_user(k, v)			\
+   { .key_type=HS_FUNC, .key.stack_index=k,	\
+	 .value_type=HS_USER, .value.stack_index=v }
+#define hs_func_light(k, v)			\
+   { .key_type=HS_FUNC, .key.stack_index=k,	\
+	 .value_type=HS_LIGHT, .value.userdata=v }
+
+#define hs_cfunc_bool(k, v)			\
+   { .key_type=HS_CFUNC, .key.function=k,	\
+	 .value_type=HS_BOOL, .value.boolean=v }
+#define hs_cfunc_int(k, v)			\
+   { .key_type=HS_CFUNC, .key.function=k,	\
+	 .value_type=HS_INT, .value.integer=v }
+#define hs_cfunc_num(k, v)			\
+   { .key_type=HS_CFUNC, .key.function=k,	\
+	 .value_type=HS_NUM, .value.number=v }
+#define hs_cfunc_str(k, v)			\
+   { .key_type=HS_CFUNC, .key.function=k,	\
+	 .value_type=HS_STR, .value.string=v }
+#define hs_cfunc_tbl(k, v)			\
+   { .key_type=HS_CFUNC, .key.function=k,	\
+	 .value_type=HS_TBL, .value.stack_index=v }
+#define hs_cfunc_func(k, v)			\
+   { .key_type=HS_CFUNC, .key.function=k,	\
+	 .value_type=HS_FUNC, .value.stack_index=v }
+#define hs_cfunc_cfunc(k, v)			\
+   { .key_type=HS_CFUNC, .key.function=k,	\
+	 .value_type=HS_CFUNC, .value.function=v }
+#define hs_cfunc_user(k, v)			\
+   { .key_type=HS_CFUNC, .key.function=k,	\
+	 .value_type=HS_USER, .value.stack_index=v }
+#define hs_cfunc_light(k, v)			\
+   { .key_type=HS_CFUNC, .key.function=k,	\
+	 .value_type=HS_LIGHT, .value.userdata=v }
+   
+#define hs_user_bool(k, v)			\
+   { .key_type=HS_USER, .key.stack_index=k,	\
+	 .value_type=HS_BOOL, .value.boolean=v }
+#define hs_user_int(k, v)			\
+   { .key_type=HS_USER, .key.stack_index=k,	\
+	 .value_type=HS_INT, .value.integer=v }
+#define hs_user_num(k, v)			\
+   { .key_type=HS_USER, .key.stack_index=k,	\
+	 .value_type=HS_NUM, .value.number=v }
+#define hs_user_str(k, v)			\
+   { .key_type=HS_USER, .key.stack_index=k,	\
+	 .value_type=HS_STR, .value.string=v }
+#define hs_user_tbl(k, v)			\
+   { .key_type=HS_USER, .key.stack_index=k,	\
+	 .value_type=HS_TBL, .value.stack_index=v }
+#define hs_user_func(k, v)			\
+   { .key_type=HS_USER, .key.stack_index=k,	\
+	 .value_type=HS_FUNC, .value.stack_index=v }
+#define hs_user_cfunc(k, v)			\
+   { .key_type=HS_USER, .key.stack_index=k,	\
+	 .value_type=HS_CFUNC, .value.function=v }
+#define hs_user_user(k, v)			\
+   { .key_type=HS_USER, .key.stack_index=k,	\
+	 .value_type=HS_USER, .value.stack_index=v }
+#define hs_user_light(k, v)			\
+   { .key_type=HS_USER, .key.stack_index=k,	\
+	 .value_type=HS_LIGHT, .value.userdata=v }
+
+#define hs_light_bool(k, v)			\
+   { .key_type=HS_LIGHT, .key.userdata=k,	\
+	 .value_type=HS_BOOL, .value.boolean=v }
+#define hs_light_int(k, v)			\
+   { .key_type=HS_LIGHT, .key.userdata=k,	\
+	 .value_type=HS_INT, .value.integer=v }
+#define hs_light_num(k, v)			\
+   { .key_type=HS_LIGHT, .key.userdata=k,	\
+	 .value_type=HS_NUM, .value.number=v }
+#define hs_light_str(k, v)			\
+   { .key_type=HS_LIGHT, .key.userdata=k,	\
+	 .value_type=HS_STR, .value.string=v }
+#define hs_light_tbl(k, v)			\
+   { .key_type=HS_LIGHT, .key.userdata=k,	\
+	 .value_type=HS_TBL, .value.stack_index=v }
+#define hs_light_func(k, v)			\
+   { .key_type=HS_LIGHT, .key.userdata=k,	\
+	 .value_type=HS_FUNC, .value.stack_index=v }
+#define hs_light_cfunc(k, v)			\
+   { .key_type=HS_LIGHT, .key.userdata=k,	\
+	 .value_type=HS_CFUNC, .value.function=v }
+#define hs_light_user(k, v)			\
+   { .key_type=HS_LIGHT, .key.userdata=k,	\
+	 .value_type=HS_USER, .value.stack_index=v }
+#define hs_light_light(k, v)			\
+   { .key_type=HS_LIGHT, .key.userdata=k,	\
+	 .value_type=HS_LIGHT, .value.userdata=v }
+   
+int hs_create_table_(lua_State *L, int n_elements, struct hs_tbl_entry *elements);
+
+#define hs_create_table(L, ...)					\
+   hs_create_table_(L,						\
+		    VA_NARGS(__VA_ARGS__)/4,			\
+		    (struct hs_tbl_entry[]) { __VA_ARGS__ })
+
+
+/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ *
+ * hs_process_table
+ *
+ * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ */
+
+typedef void (*hs_pt_bool_callback)(bool, void *);
+typedef void (*hs_pt_int_callback)(lua_Integer, void *);
+typedef void (*hs_pt_num_callback)(lua_Number, void *);
+typedef void (*hs_pt_str_callback)(const char *, void *);
+
+
+// default processors
+void hs_pt_set_boolean(bool value, void *data);
+void hs_pt_set_integer(lua_Integer value, void *data);
+void hs_pt_set_number(lua_Number value, void *data);
+void hs_pt_set_string(const char *value, void *data);
+
+
+struct hs_table_processor {
+   const char *key;
+   hs_type type;
+   union {
+      hs_pt_bool_callback boolean;
+      hs_pt_int_callback integer;
+      hs_pt_num_callback number;
+      hs_pt_str_callback string;
+   } func;
+   void *data;
+};
+
+#define hs_process_bool(str, f, d)				\
+   { .key=(str), .type=HS_BOOL, .func.boolean=(f), .data=(d) }
+#define hs_process_int(str, f, d)				\
+   { .key=(str), .type=HS_INT, .func.integer=(f), .data=(d) }
+#define hs_process_num(str, f, d)				\
+   { .key=(str), .type=HS_NUM, .func.number=(f), .data=(d) }
+#define hs_process_str(str, f, d)				\
+   { .key=(str), .type=HS_STR, .func.string=(f), .data=(d) }
+
+void hs_process_table_(lua_State *L,
+		       int table_index,
+		       int n_processors,
+		       struct hs_table_processor *processors);
+
+#define hs_process_table(L, table_index, ...)	\
+   hs_process_table_(L, table_index, \
+		     VA_NARGS(__VA_ARGS__)/4, \
+		     (struct hs_table_processor[]) {__VA_ARGS__})
+
+
+/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ *
+ * hs_pushstring
+ *
+ * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ */
+
+void hs_vpushstring(lua_State *L, const char *format_string, va_list args);
+void hs_pushstring(lua_State *L, const char *format_string, ...);
+
+
+/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ *
+ * error creation and handling
+ *
+ * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ */
+
+void hs_throw_error(lua_State *L, const char *format_string, ...);
+int hs_traceback(lua_State *L);
+int hs_call(lua_State *L, int nargs, int nret);
+
+
+/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ *
+ * registry operations
+ *
+ * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ */
+
+#define hs_rstore(L) luaL_ref(L, LUA_REGISTRYINDEX);
+#define hs_rload(L, ref) lua_rawgeti(L, LUA_REGISTRYINDEX, ref)
+#define hs_rdel(L, ref) luaL_unref(L, LUA_REGISTRYINDEX, ref)
+
+#endif
diff --git a/src/honeysuckle/hs_create_table.c b/src/honeysuckle/hs_create_table.c
new file mode 100644
index 0000000..422a480
--- /dev/null
+++ b/src/honeysuckle/hs_create_table.c
@@ -0,0 +1,123 @@
+#include <stdlib.h>
+
+#include "honeysuckle.h"
+
+static void push_value(lua_State *L, hs_type type, hs_value value)
+{
+   switch (type) {
+   case HS_BOOL:
+      lua_pushboolean(L, value.boolean);
+      break;
+
+   case HS_INT:
+      lua_pushinteger(L, value.integer);
+      break;
+
+   case HS_NUM:
+      lua_pushnumber(L, value.number);
+      break;
+
+   case HS_STR:
+      lua_pushstring(L, value.string);
+      break;
+
+   case HS_TBL:
+      lua_pushvalue(L, value.stack_index);
+      break;
+
+   case HS_FUNC:
+      lua_pushvalue(L, value.stack_index);
+      break;
+
+   case HS_CFUNC:
+      lua_pushcfunction(L, value.function);
+      break;
+
+   case HS_USER:
+      lua_pushvalue(L, value.stack_index);
+      break;
+
+   case HS_LIGHT:
+      lua_pushlightuserdata(L, value.userdata);
+      break;
+
+   default:
+      hs_throw_error(L, "attempted to push data of invalid type %d", type);
+      break;
+   }
+}
+
+
+static inline bool poppable(hs_type type)
+{
+   if (type == HS_TBL ||
+       type == HS_FUNC ||
+       type == HS_USER) {
+      return true;
+   }
+   return false;
+}
+
+
+static void print_stack(lua_State *L)
+{
+   printf("stack: %d [", lua_gettop(L));
+   for (int i=0; i<lua_gettop(L); i++) {
+      printf(" %s, ", lua_typename(L, lua_type(L, i+1)));
+   }
+   printf("]\n");
+}
+
+
+int descending(const void *a, const void *b)
+{
+   return (*(int*)b - *(int*)a);
+}
+
+int hs_create_table_(lua_State *L,
+		     int n_elements,
+		     struct hs_tbl_entry *elements)
+{
+   // printf("start\n");
+   
+   // print_stack(L);
+   lua_createtable(L, 0, n_elements);
+   int index = lua_gettop(L);
+   // print_stack(L);
+
+   for (int i=0; i<n_elements; i++) {
+      // printf("pushing element %d...\n", i);
+      struct hs_tbl_entry *e = elements + i;
+      push_value(L, e->key_type, e->key);
+      // print_stack(L);
+      push_value(L, e->value_type, e->value);
+      // print_stack(L);
+      lua_rawset(L, index);
+      // print_stack(L);
+   }
+
+   int n_poppable = 0;
+   int pop_indices[n_elements];
+   
+   for (int i=0; i<n_elements; i++) {
+      struct hs_tbl_entry *e = elements + i;
+      if (poppable(e->key_type))
+	 pop_indices[n_poppable++] = e->key.stack_index;
+      if (poppable(e->value_type))
+	 pop_indices[n_poppable++] = e->value.stack_index;
+   }
+
+   // printf("cleaning up\n");
+   
+   qsort(pop_indices, n_poppable, sizeof(int), descending);
+   for (int i=0; i<n_poppable; i++) {
+      lua_remove(L, pop_indices[i]);
+      index -= 1;
+      // print_stack(L);
+   }
+   
+
+   // printf("exit\n");
+   
+   return index;
+}
diff --git a/src/honeysuckle/hs_parse_args.c b/src/honeysuckle/hs_parse_args.c
new file mode 100644
index 0000000..d6d3b3c
--- /dev/null
+++ b/src/honeysuckle/hs_parse_args.c
@@ -0,0 +1,149 @@
+#include <stdio.h>
+
+#include "honeysuckle.h"
+
+static bool check_parse(lua_State *L, int index, struct hs_arg *expected)
+{
+   switch(expected->type) {
+   case HS_BOOL:
+      if (!lua_isboolean(L, index))
+	 return false;
+      *(expected->ptr.boolean) = lua_toboolean(L, index);
+      return true;
+
+   case HS_INT:
+      if (!lua_isnumber(L, index))
+	 return false;
+      *(expected->ptr.integer) = lua_tointeger(L, index);
+      return true;
+
+   case HS_NUM:
+      if (!lua_isnumber(L, index))
+	 return false;
+      *(expected->ptr.number) = lua_tonumber(L, index);
+      return true;
+
+   case HS_STR:
+      if (!lua_isstring(L, index) || lua_isnumber(L, index))
+	 return false;
+      *(expected->ptr.string) = (char *) lua_tostring(L, index);
+      return true;
+
+   case HS_TBL:
+      if (!lua_istable(L, index))
+	 return false;
+      *(expected->ptr.stack_index) = index;
+      return true;
+
+   case HS_FUNC:
+      if (!lua_isfunction(L, index))
+	 return false;
+      *(expected->ptr.stack_index) = index;
+      return true;
+
+   case HS_CFUNC:
+      if (!lua_iscfunction(L, index))
+	 return false;
+      *(expected->ptr.function) = lua_tocfunction(L, index);
+      return true;
+
+   case HS_USER:
+      if (!lua_isuserdata(L, index))
+	 return false;
+      *(expected->ptr.userdata) = lua_touserdata(L, index);
+      return true;
+
+   case HS_LIGHT:
+      if (!lua_islightuserdata(L, index))
+	 return false;
+      *(expected->ptr.userdata) = lua_touserdata(L, index);
+      return true;
+
+   case HS_NIL:
+      if (!lua_isnil(L, index))
+	 return false;
+      *(expected->ptr.stack_index) = index;
+
+   case HS_ANY:
+      *(expected->ptr.stack_index) = index;
+      return true;
+
+   default:
+      return false;
+   }
+}
+
+
+static bool try_parse_args(lua_State *L, int n_args, struct hs_arg *arguments)
+{
+   int args_provided = lua_gettop(L);
+   if (args_provided != n_args)
+      return false;
+
+   for (int i=0; i<n_args; i++) {
+      bool success = check_parse(L, i+1, arguments + i);
+      if (!success)
+	 return false;
+   }
+   return true;
+}
+
+
+void hs_parse_args_(lua_State *L, int n_args, struct hs_arg *arguments)
+{
+   bool success = try_parse_args(L, n_args, arguments);
+   if (!success) {
+      lua_pushstring(L, "expected arguments of the form (");
+      for (int i=0; i<n_args; i++) {
+	 lua_pushstring(L, hs_type_to_string(arguments[i].type));
+	 lua_pushstring(L, ", ");
+      }
+      lua_pop(L, 1);
+      lua_pushstring(L, "); received (");
+      const int n_provided = lua_gettop(L);
+      for (int i=0; i<n_provided; i++) {
+	 lua_pushstring(L, lua_typename(L, lua_type(L, i+1)));
+	 lua_pushstring(L, ", ");
+      }
+      lua_pop(L, 1);
+      lua_pushstring(L, ") instead");
+      lua_concat(L, 1 + (2*n_args) + (2*n_provided));
+      lua_error(L);
+   }
+}
+
+
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+static void hs_overloaded_error(lua_State *L, va_list args)
+{
+   lua_pushstring(L, "hs_overloaded failed");
+   lua_error(L);
+}
+
+
+int hs_parse_overloaded_(lua_State *L, ...)
+{
+   va_list args, args_error;
+   va_start(args, L);
+   va_copy(args_error, args);
+
+   int choice = 0;
+
+   while(true) {
+      int n_args = va_arg(args, int);
+      if (n_args == -1)
+	 break;
+      else {
+	 struct hs_arg *arguments = va_arg(args, struct hs_arg *);
+	 if (try_parse_args(L, n_args, arguments))
+	    return choice;
+      }
+      choice++;
+   }
+
+   hs_overloaded_error(L, args_error);
+   
+   va_end(args);
+   va_end(args_error);
+}
diff --git a/src/honeysuckle/hs_process_table.c b/src/honeysuckle/hs_process_table.c
new file mode 100644
index 0000000..d07d815
--- /dev/null
+++ b/src/honeysuckle/hs_process_table.c
@@ -0,0 +1,86 @@
+#include "honeysuckle.h"
+
+void hs_pt_set_boolean(bool value, void *data)
+{
+   *(bool *) data = value;
+}
+
+void hs_pt_set_integer(lua_Integer value, void *data)
+{
+   *(lua_Integer *) data = value;
+}
+
+void hs_pt_set_number(lua_Number value, void *data)
+{
+   *(lua_Number *) data = value;
+}
+
+void hs_pt_set_string(const char *value, void *data)
+{
+   *(const char **) data = value;
+}
+
+
+static bool process_key(lua_State *L, struct hs_table_processor *p)
+{
+   switch (p->type) {
+   case HS_BOOL:
+      if (!lua_isboolean(L, -1))
+	 hs_throw_error(L,
+			"expected key '%s' to be of type boolean, "\
+			"but got type %s instead",
+			p->key,
+			lua_typename(L, lua_type(L, -1)));
+      p->func.boolean(lua_toboolean(L, -1), p->data);
+      break;
+
+   case HS_INT:
+      if (!lua_isnumber(L, -1))
+	 hs_throw_error(L,
+			"expected key '%s' to be of type integer, "\
+			"but got type %s instead",
+			p->key,
+			lua_typename(L, lua_type(L, -1)));
+      p->func.integer(lua_tointeger(L, -1), p->data);
+      break;
+
+   case HS_NUM:
+      if (!lua_isnumber(L, -1))
+	 hs_throw_error(L,
+			"expected key '%s' to be of type number, "\
+			"but got type %s instead",
+			p->key,
+			lua_typename(L, lua_type(L, -1)));
+      p->func.number(lua_tonumber(L, -1), p->data);
+      break;
+
+   case HS_STR:
+      if (!lua_isstring(L, -1))
+	 hs_throw_error(L,
+			"expected key '%s' to be of type string, "\
+			"but got type %s instead",
+			p->key,
+			lua_typename(L, lua_type(L, -1)));
+      p->func.string(lua_tostring(L, -1), p->data);
+      break;
+
+   default:
+      // bad type value, throw error
+      hs_throw_error(L, "bad expected type '%d' for key '%s'",
+		     p->type, p->key);
+      break;
+   }
+}
+
+void hs_process_table_(lua_State *L,
+		       int table_index,
+		       int n_processors,
+		       struct hs_table_processor *processors)
+{
+   for (int i=0; i<n_processors; i++) {
+      lua_getfield(L, table_index, processors[i].key);
+      if (!lua_isnil(L, -1))
+	 process_key(L, processors+i);
+      lua_pop(L, 1);
+   }
+}
diff --git a/src/honeysuckle/hs_pushstring.c b/src/honeysuckle/hs_pushstring.c
new file mode 100644
index 0000000..f7da0d0
--- /dev/null
+++ b/src/honeysuckle/hs_pushstring.c
@@ -0,0 +1,31 @@
+#include <stdlib.h>
+
+#include "honeysuckle.h"
+
+void hs_vpushstring(lua_State *L, const char *format_string, va_list args)
+{
+   va_list args_;
+   va_copy(args_, args);
+
+   int string_size = vsnprintf(NULL, 0, format_string, args_);
+   va_end(args_);
+
+   char *string = malloc((string_size+1) * sizeof(char));
+   if (string == NULL) {
+      lua_pushstring(L, "there was an error allocating memory for a string");
+      lua_error(L);
+   }
+
+   vsnprintf(string, string_size+1, format_string, args);
+   lua_pushstring(L, string);
+   free(string);
+}
+
+
+void hs_pushstring(lua_State *L, const char *format_string, ...)
+{
+   va_list args;
+   va_start(args, format_string);
+   hs_vpushstring(L, format_string, args);
+   va_end(args);
+}
diff --git a/src/honeysuckle/hs_throw_error.c b/src/honeysuckle/hs_throw_error.c
new file mode 100644
index 0000000..20a4c6d
--- /dev/null
+++ b/src/honeysuckle/hs_throw_error.c
@@ -0,0 +1,12 @@
+#include <stdlib.h>
+
+#include "honeysuckle.h"
+
+void hs_throw_error(lua_State *L, const char *format_string, ...)
+{
+   va_list args;
+   va_start(args, format_string);
+   hs_vpushstring(L, format_string, args);
+   va_end(args);
+   lua_error(L);
+}
diff --git a/src/honeysuckle/hs_traceback.c b/src/honeysuckle/hs_traceback.c
new file mode 100644
index 0000000..1830721
--- /dev/null
+++ b/src/honeysuckle/hs_traceback.c
@@ -0,0 +1,37 @@
+#include "honeysuckle.h"
+
+int hs_traceback(lua_State *L)
+{
+   if (!lua_isstring(L, 1))
+      /* 'message' is not a string, keep intact */
+      return 1;
+
+   lua_getglobal(L, "debug");
+   if (!lua_istable(L, -1)) {
+      lua_pop(L, 1);
+      return 1;
+   }
+
+   lua_getfield(L, -1, "traceback");
+   if (!lua_isfunction(L, -1)) {
+      lua_pop(L, 2);
+      return 1;
+   }
+
+   lua_pushvalue(L, 1);
+   lua_pushinteger(L, 2);
+   lua_call(L, 2, 1);
+   return 1;
+}
+
+
+int hs_call(lua_State *L, int nargs, int nret)
+{
+   int traceback_pos = lua_gettop(L) - nargs;
+   lua_pushcfunction(L, hs_traceback);
+   lua_insert(L, traceback_pos);
+
+   int result = lua_pcall(L, nargs, nret, traceback_pos);
+   lua_remove(L, traceback_pos);
+   return result;
+}
diff --git a/src/honeysuckle/hs_type_to_string.c b/src/honeysuckle/hs_type_to_string.c
new file mode 100644
index 0000000..d0a580c
--- /dev/null
+++ b/src/honeysuckle/hs_type_to_string.c
@@ -0,0 +1,31 @@
+#include "honeysuckle.h"
+
+const char * hs_type_to_string(hs_type type)
+{
+   switch(type) {
+   case HS_BOOL:
+      return "boolean";
+   case HS_INT:
+      return "integer";
+   case HS_NUM:
+      return "number";
+   case HS_STR:
+      return "string";
+   case HS_TBL:
+      return "table";
+   case HS_FUNC:
+      return "function";
+   case HS_CFUNC:
+      return "C function";
+   case HS_USER:
+      return "userdata";
+   case HS_LIGHT:
+      return "light userdata";
+   case HS_NIL:
+      return "nil";
+   case HS_ANY:
+      return "any";
+   default:
+      return "(unknown)";
+   }
+}