2 * UCW Library -- Table printer
4 * (c) 2014 Robert Kessl <robert.kessl@economia.cz>
8 #include <ucw/string.h>
9 #include <ucw/stkstring.h>
11 #include <ucw/table.h>
15 /*** Management of tables ***/
17 void table_init(struct table *tbl)
19 int col_count = 0; // count the number of columns in the struct table
22 if(tbl->columns[col_count].name == NULL &&
23 tbl->columns[col_count].fmt == NULL &&
24 tbl->columns[col_count].width == 0 &&
25 tbl->columns[col_count].type == COL_TYPE_LAST)
27 ASSERT(tbl->columns[col_count].name != NULL);
28 ASSERT(tbl->columns[col_count].type == COL_TYPE_ANY || tbl->columns[col_count].fmt != NULL);
29 ASSERT(tbl->columns[col_count].width != 0);
30 ASSERT(tbl->columns[col_count].type < COL_TYPE_LAST);
33 tbl->pool = mp_new(4096);
35 tbl->column_count = col_count;
38 tbl->formatter = &table_fmt_human_readable;
41 tbl->print_header = 1; // by default, print header
44 void table_cleanup(struct table *tbl)
47 memset(tbl, 0, sizeof(struct table));
50 // TODO: test default column order
51 static void table_make_default_column_order(struct table *tbl)
53 int *col_order_int = mp_alloc_zero(tbl->pool, sizeof(int) * tbl->column_count);
54 for(int i = 0; i < tbl->column_count; i++) {
57 table_col_order(tbl, col_order_int, tbl->column_count);
60 void table_start(struct table *tbl, struct fastbuf *out)
62 tbl->last_printed_col = -1;
63 tbl->row_printing_started = 0;
66 ASSERT_MSG(tbl->out, "Output fastbuf not specified.");
68 if(!tbl->col_str_ptrs) {
69 tbl->col_str_ptrs = mp_alloc_zero(tbl->pool, sizeof(char *) * tbl->column_count);
72 if(tbl->column_order == NULL) table_make_default_column_order(tbl);
74 if(tbl->formatter->table_start != NULL) tbl->formatter->table_start(tbl);
76 mp_save(tbl->pool, &tbl->pool_state);
78 ASSERT_MSG(tbl->col_delimiter, "In-between column delimiter not specified.");
79 ASSERT_MSG(tbl->append_delimiter, "Append delimiter not specified.");
82 void table_end(struct table *tbl)
84 tbl->last_printed_col = -1;
85 tbl->row_printing_started = 0;
87 mp_restore(tbl->pool, &tbl->pool_state);
89 if(tbl->formatter->table_end) tbl->formatter->table_end(tbl);
92 /*** Configuration ***/
94 void table_set_formatter(struct table *tbl, struct table_formatter *fmt)
99 int table_get_col_idx(struct table *tbl, const char *col_name)
101 for(int i = 0; i < tbl->column_count; i++) {
102 if(strcmp(tbl->columns[i].name, col_name) == 0) return i;
107 const char * table_get_col_list(struct table *tbl)
109 if(tbl->column_count == 0) return "";
111 char *tmp = mp_strdup(tbl->pool, tbl->columns[0].name);
113 for(int i = 1; i < tbl->column_count; i++) {
114 tmp = mp_printf_append(tbl->pool, tmp, ", %s", tbl->columns[i].name);
120 // FIXME: Shouldn't this be table_SET_col_order() ?
121 void table_col_order(struct table *tbl, int *col_order, int cols_to_output)
123 for(int i = 0; i < cols_to_output; i++) {
124 ASSERT_MSG(col_order[i] >= 0 && col_order[i] < tbl->column_count, "Column %d does not exist (column number should be between 0 and %d)", col_order[i], tbl->column_count - 1);
127 tbl->column_order = col_order;
128 tbl->cols_to_output = cols_to_output;
132 * TODO: This function deliberately leaks memory. When it is called multiple times,
133 * previous column orders still remain allocated in the table's memory pool.
135 const char * table_col_order_by_name(struct table *tbl, const char *col_order_str)
137 if(!col_order_str[0]) {
138 tbl->column_order = mp_alloc(tbl->pool, 0);
139 tbl->cols_to_output = 0;
143 char *tmp_col_order = stk_strdup(col_order_str);
146 for(int i = 0; col_order_str[i] != 0; i++) {
147 if(col_order_str[i] == ',') {
152 int *col_order_int = mp_alloc_zero(tbl->pool, sizeof(int) * col_count);
153 int curr_col_order_int = 0;
154 const char *name_start = tmp_col_order;
156 char *next = strchr(name_start, ',');
161 int idx = table_get_col_idx(tbl, name_start);
163 return mp_printf(tbl->pool, "Unknown table column '%s'", name_start);
165 col_order_int[curr_col_order_int++] = idx;
170 tbl->column_order = col_order_int;
171 tbl->cols_to_output = curr_col_order_int;
175 /*** Table cells ***/
177 void table_col_printf(struct table *tbl, int col, const char *fmt, ...)
179 ASSERT_MSG(col < tbl->column_count && col >= 0, "Table column %d does not exist.", col);
180 tbl->last_printed_col = col;
181 tbl->row_printing_started = 1;
184 tbl->col_str_ptrs[col] = mp_vprintf(tbl->pool, fmt, args);
188 static const char *table_col_default_fmts[] = {
189 [COL_TYPE_STR] = "%s",
190 [COL_TYPE_INT] = "%d",
191 [COL_TYPE_INTMAX] = "%jd",
192 [COL_TYPE_UINT] = "%u",
193 [COL_TYPE_UINTMAX] = "%ju",
194 [COL_TYPE_BOOL] = "%d",
195 [COL_TYPE_DOUBLE] = "%.2lf",
196 [COL_TYPE_ANY] = NULL,
197 [COL_TYPE_LAST] = NULL
200 #define TABLE_COL(_name_, _type_, _typeconst_) void table_col_##_name_(struct table *tbl, int col, _type_ val) \
202 const char *fmt = tbl->columns[col].fmt;\
203 if(tbl->columns[col].type == COL_TYPE_ANY) {\
204 fmt = table_col_default_fmts[_typeconst_];\
206 table_col_##_name_##_fmt(tbl, col, fmt, val);\
209 #define TABLE_COL_STR(_name_, _type_, _typeconst_) void table_col_##_name_##_name(struct table *tbl, const char *col_name, _type_ val) \
211 int col = table_get_col_idx(tbl, col_name);\
212 table_col_##_name_(tbl, col, val);\
215 #define TABLE_COL_FMT(_name_, _type_, _typeconst_) void table_col_##_name_##_fmt(struct table *tbl, int col, const char *fmt, _type_ val)\
217 ASSERT_MSG(col < tbl->column_count && col >= 0, "Table column %d does not exist.", col);\
218 ASSERT(tbl->columns[col].type == COL_TYPE_ANY || _typeconst_ == tbl->columns[col].type);\
219 ASSERT(fmt != NULL);\
220 tbl->last_printed_col = col;\
221 tbl->row_printing_started = 1;\
222 tbl->col_str_ptrs[col] = mp_printf(tbl->pool, fmt, val);\
225 #define TABLE_COL_BODIES(_name_, _type_, _typeconst_) TABLE_COL(_name_, _type_, _typeconst_);\
226 TABLE_COL_STR(_name_, _type_, _typeconst_);\
227 TABLE_COL_FMT(_name_, _type_, _typeconst_);
229 TABLE_COL_BODIES(int, int, COL_TYPE_INT)
230 TABLE_COL_BODIES(uint, uint, COL_TYPE_UINT)
231 TABLE_COL_BODIES(double, double, COL_TYPE_DOUBLE)
232 TABLE_COL_BODIES(str, const char *, COL_TYPE_STR)
233 TABLE_COL_BODIES(intmax, intmax_t, COL_TYPE_INTMAX)
234 TABLE_COL_BODIES(uintmax, uintmax_t, COL_TYPE_UINTMAX)
238 #undef TABLE_COL_BODIES
240 void table_col_bool(struct table *tbl, int col, uint val)
242 table_col_bool_fmt(tbl, col, tbl->columns[col].fmt, val);
245 void table_col_bool_name(struct table *tbl, const char *col_name, uint val)
247 int col = table_get_col_idx(tbl, col_name);
248 table_col_bool(tbl, col, val);
251 void table_col_bool_fmt(struct table *tbl, int col, const char *fmt, uint val)
253 ASSERT_MSG(col < tbl->column_count && col >= 0, "Table column %d does not exist.", col);
254 ASSERT(COL_TYPE_BOOL == tbl->columns[col].type);
256 tbl->last_printed_col = col;
257 tbl->row_printing_started = 1;
258 tbl->col_str_ptrs[col] = mp_printf(tbl->pool, fmt, val ? "true" : "false");
261 #define TABLE_APPEND(_name_, _type_, _typeconst_) void table_append_##_name_(struct table *tbl, _type_ val) \
263 ASSERT(tbl->last_printed_col != -1 || tbl->row_printing_started != 0);\
264 ASSERT(_typeconst_ == tbl->columns[tbl->last_printed_col].type);\
265 int col = tbl->last_printed_col;\
266 mp_printf_append(tbl->pool, tbl->col_str_ptrs[col], "%s", tbl->append_delimiter);\
267 tbl->col_str_ptrs[col] = mp_printf_append(tbl->pool, tbl->col_str_ptrs[col], tbl->columns[col].fmt, val);\
270 TABLE_APPEND(int, int, COL_TYPE_INT)
271 TABLE_APPEND(uint, uint, COL_TYPE_UINT)
272 TABLE_APPEND(double, double, COL_TYPE_DOUBLE)
273 TABLE_APPEND(str, const char *, COL_TYPE_STR)
274 TABLE_APPEND(intmax, intmax_t, COL_TYPE_INTMAX)
275 TABLE_APPEND(uintmax, uintmax_t, COL_TYPE_UINTMAX)
278 void table_append_bool(struct table *tbl, int val)
280 ASSERT(tbl->last_printed_col != -1 || tbl->row_printing_started != 0);
281 ASSERT(COL_TYPE_BOOL == tbl->columns[tbl->last_printed_col].type);
283 int col = tbl->last_printed_col;
285 mp_printf_append(tbl->pool, tbl->col_str_ptrs[col], "%s", tbl->append_delimiter);
287 tbl->col_str_ptrs[col] = mp_printf_append(tbl->pool, tbl->col_str_ptrs[col], tbl->columns[col].fmt, val ? "true" : "false");
290 void table_append_printf(struct table *tbl, const char *fmt, ...)
292 ASSERT(tbl->last_printed_col != -1 || tbl->row_printing_started != 0);
293 int col = tbl->last_printed_col;
298 mp_printf_append(tbl->pool, tbl->col_str_ptrs[col], "%s", tbl->append_delimiter);
299 tbl->col_str_ptrs[col] = mp_vprintf_append(tbl->pool, tbl->col_str_ptrs[col], fmt, args);
304 void table_end_row(struct table *tbl)
306 ASSERT(tbl->formatter->row_output);
307 tbl->formatter->row_output(tbl);
308 memset(tbl->col_str_ptrs, 0, sizeof(char *) * tbl->column_count);
309 mp_restore(tbl->pool, &tbl->pool_state);
310 tbl->last_printed_col = -1;
311 tbl->row_printing_started = 0;
314 /* Construction of a cell using a fastbuf */
316 struct fastbuf *table_col_fbstart(struct table *tbl, int col)
318 fbpool_init(&tbl->fb_col_out);
319 fbpool_start(&tbl->fb_col_out, tbl->pool, 1);
321 return &tbl->fb_col_out.fb;
324 void table_col_fbend(struct table *tbl)
326 tbl->col_str_ptrs[tbl->col_out] = fbpool_end(&tbl->fb_col_out);
330 /*** Option parsing ***/
332 const char *table_set_option_value(struct table *tbl, const char *key, const char *value)
334 // Options with no value
335 if(value == NULL || (value != NULL && strlen(value) == 0)) {
336 if(strcmp(key, "noheader") == 0) {
337 tbl->print_header = 0;
342 // Options with a value
344 if(strcmp(key, "header") == 0) {
345 // FIXME: Check syntax of value.
346 //tbl->print_header = strtol(value, NULL, 10); //atoi(value);
347 //if(errno != 0) tbl->print_header
349 return mp_printf(tbl->pool, "Tableprinter: invalid option: '%s' has invalid value: '%s'.", key, value);
350 uint tmp = value[0] - '0';
352 return mp_printf(tbl->pool, "Tableprinter: invalid option: '%s' has invalid value: '%s'.", key, value);
353 tbl->print_header = tmp;
355 } else if(strcmp(key, "cols") == 0) {
356 const char *err = table_col_order_by_name(tbl, value);
358 return mp_printf(tbl->pool, "%s, possible column names are: %s.", err, table_get_col_list(tbl));
361 } else if(strcmp(key, "fmt") == 0) {
362 if(strcmp(value, "human") == 0) table_set_formatter(tbl, &table_fmt_human_readable);
363 else if(strcmp(value, "machine") == 0) table_set_formatter(tbl, &table_fmt_machine_readable);
365 return "Tableprinter: invalid argument to output-type option.";
368 } else if(strcmp(key, "col-delim") == 0) {
369 char * d = mp_printf(tbl->pool, "%s", value);
370 tbl->col_delimiter = d;
376 if(tbl->formatter && tbl->formatter->process_option) {
377 const char *err = NULL;
378 if (tbl->formatter->process_option(tbl, key, value, &err)) {
383 // Unrecognized option
384 return mp_printf(tbl->pool, "Tableprinter: invalid option: '%s%s%s'.", key, (value ? ":" : ""), (value ? : ""));
387 const char *table_set_option(struct table *tbl, const char *opt)
389 char *key = stk_strdup(opt);
390 char *value = strchr(key, ':');
394 return table_set_option_value(tbl, key, value);
397 const char *table_set_gary_options(struct table *tbl, char **gary_table_opts)
399 for (uint i = 0; i < GARY_SIZE(gary_table_opts); i++) {
400 const char *rv = table_set_option(tbl, gary_table_opts[i]);
408 /*** Default formatter for human-readable output ***/
410 static void table_row_human_readable(struct table *tbl)
412 for(uint i = 0; i < tbl->cols_to_output; i++) {
413 int col_idx = tbl->column_order[i];
414 int col_width = tbl->columns[col_idx].width;
416 bputs(tbl->out, tbl->col_delimiter);
418 bprintf(tbl->out, "%*s", col_width, tbl->col_str_ptrs[col_idx]);
420 bputc(tbl->out, '\n');
423 static void table_write_header(struct table *tbl)
425 for(uint i = 0; i < tbl->cols_to_output; i++) {
426 int col_idx = tbl->column_order[i];
428 bputs(tbl->out, tbl->col_delimiter);
430 bprintf(tbl->out, "%*s", tbl->columns[col_idx].width, tbl->columns[col_idx].name);
432 bputc(tbl->out, '\n');
435 static void table_start_human_readable(struct table *tbl)
437 if(tbl->col_delimiter == NULL) {
438 tbl->col_delimiter = " ";
441 if(tbl->append_delimiter == NULL) {
442 tbl->append_delimiter = ",";
445 if(tbl->print_header != 0) {
446 table_write_header(tbl);
450 struct table_formatter table_fmt_human_readable = {
451 .row_output = table_row_human_readable,
452 .table_start = table_start_human_readable,
455 /*** Default formatter for machine-readable output ***/
457 static void table_row_machine_readable(struct table *tbl)
459 for(uint i = 0; i < tbl->cols_to_output; i++) {
460 int col_idx = tbl->column_order[i];
462 bputs(tbl->out, tbl->col_delimiter);
464 bputs(tbl->out, tbl->col_str_ptrs[col_idx]);
466 bputc(tbl->out, '\n');
469 static void table_start_machine_readable(struct table *tbl)
471 if(tbl->col_delimiter == NULL) {
472 tbl->col_delimiter = ";";
475 if(tbl->append_delimiter == NULL) {
476 tbl->append_delimiter = ",";
479 if(tbl->print_header != 0) {
480 uint col_idx = tbl->column_order[0];
481 bputs(tbl->out, tbl->columns[col_idx].name);
482 for(uint i = 1; i < tbl->cols_to_output; i++) {
483 col_idx = tbl->column_order[i];
484 bputs(tbl->out, tbl->col_delimiter);
485 bputs(tbl->out, tbl->columns[col_idx].name);
487 bputc(tbl->out, '\n');
491 struct table_formatter table_fmt_machine_readable = {
492 .row_output = table_row_machine_readable,
493 .table_start = table_start_machine_readable,
502 enum test_table_cols {
503 test_col0_str, test_col1_int, test_col2_uint, test_col3_bool, test_col4_double
506 static uint test_column_order[] = {test_col3_bool, test_col4_double, test_col2_uint,test_col1_int, test_col0_str};
508 static struct table test_tbl = {
510 [test_col0_str] = TBL_COL_STR("col0_str", 20),
511 [test_col1_int] = TBL_COL_INT("col1_int", 8),
512 [test_col2_uint] = TBL_COL_UINT("col2_uint", 9),
513 [test_col3_bool] = TBL_COL_BOOL("col3_bool", 9),
514 [test_col4_double] = TBL_COL_DOUBLE("col4_double", 11, 2),
517 TBL_COL_ORDER(test_column_order),
518 TBL_OUTPUT_HUMAN_READABLE,
519 TBL_COL_DELIMITER("\t"),
520 TBL_APPEND_DELIMITER(",")
524 * tests: table_set_nt, table_set_uint, table_set_bool, table_set_double, table_set_printf
526 static void do_print1(struct table *test_tbl)
528 table_col_str(test_tbl, test_col0_str, "sdsdf");
529 table_append_str(test_tbl, "aaaaa");
530 table_col_int(test_tbl, test_col1_int, -10);
531 table_col_int(test_tbl, test_col1_int, 10000);
532 table_col_uint(test_tbl, test_col2_uint, 10);
533 table_col_printf(test_tbl, test_col2_uint, "XXX-%u", 22222);
534 table_col_bool(test_tbl, test_col3_bool, 1);
535 table_col_double(test_tbl, test_col4_double, 1.5);
536 table_col_printf(test_tbl, test_col4_double, "AAA");
537 table_end_row(test_tbl);
539 table_col_str(test_tbl, test_col0_str, "test");
540 table_append_str(test_tbl, "bbbbb");
541 table_col_int(test_tbl, test_col1_int, -100);
542 table_col_uint(test_tbl, test_col2_uint, 100);
543 table_col_bool(test_tbl, test_col3_bool, 0);
544 table_col_printf(test_tbl, test_col4_double, "%.2lf", 1.5);
545 table_end_row(test_tbl);
548 static void test_simple1(struct fastbuf *out)
550 table_init(&test_tbl);
552 // print table with header
553 table_col_order_by_name(&test_tbl, "col3_bool");
554 table_start(&test_tbl, out);
555 do_print1(&test_tbl);
556 table_end(&test_tbl);
558 // print the same table as in the previous case without header
559 table_col_order_by_name(&test_tbl, "col0_str,col2_uint,col1_int,col3_bool");
560 table_start(&test_tbl, out);
561 do_print1(&test_tbl);
562 table_end(&test_tbl);
564 // this also tests whether there is need to call table_col_order_by_name after table_end was called
565 test_tbl.print_header = 0;
566 table_start(&test_tbl, out);
567 do_print1(&test_tbl);
568 table_end(&test_tbl);
569 test_tbl.print_header = 1;
571 table_col_order_by_name(&test_tbl, "col3_bool");
572 table_start(&test_tbl, out);
573 do_print1(&test_tbl);
574 table_end(&test_tbl);
576 table_col_order_by_name(&test_tbl, "col3_bool,col0_str");
577 table_start(&test_tbl, out);
578 do_print1(&test_tbl);
579 table_end(&test_tbl);
581 table_col_order_by_name(&test_tbl, "col0_str,col3_bool,col2_uint");
582 table_start(&test_tbl, out);
583 do_print1(&test_tbl);
584 table_end(&test_tbl);
586 table_col_order_by_name(&test_tbl, "col0_str,col3_bool,col2_uint,col0_str,col3_bool,col2_uint,col0_str,col3_bool,col2_uint");
587 table_start(&test_tbl, out);
588 do_print1(&test_tbl);
589 table_end(&test_tbl);
591 table_col_order_by_name(&test_tbl, "col0_str,col1_int,col2_uint,col3_bool,col4_double");
592 table_start(&test_tbl, out);
593 do_print1(&test_tbl);
594 table_end(&test_tbl);
596 table_cleanup(&test_tbl);
599 enum test_any_table_cols {
600 test_any_col0_int, test_any_col1_any
603 static uint test_any_column_order[] = { test_any_col0_int, test_any_col1_any };
605 static struct table test_any_tbl = {
607 [test_any_col0_int] = TBL_COL_INT("col0_int", 8),
608 [test_any_col1_any] = TBL_COL_ANY("col1_any", 9),
611 TBL_COL_ORDER(test_any_column_order),
612 TBL_OUTPUT_HUMAN_READABLE,
613 TBL_COL_DELIMITER("\t"),
614 TBL_APPEND_DELIMITER(",")
617 static void test_any_type(struct fastbuf *out)
619 table_init(&test_any_tbl);
621 table_start(&test_any_tbl, out);
623 table_col_int(&test_any_tbl, test_any_col0_int, -10);
624 table_col_int(&test_any_tbl, test_any_col1_any, 10000);
625 table_end_row(&test_any_tbl);
627 table_col_int(&test_any_tbl, test_any_col0_int, -10);
628 table_col_double(&test_any_tbl, test_any_col1_any, 1.4);
629 table_end_row(&test_any_tbl);
631 table_col_printf(&test_any_tbl, test_any_col0_int, "%d", 10);
632 table_append_printf(&test_any_tbl, "%d", 20);
633 table_append_printf(&test_any_tbl, "%d", 30);
634 table_col_double(&test_any_tbl, test_any_col1_any, 1.4);
635 table_append_printf(&test_any_tbl, "%.2lf", 1.5);
636 table_append_printf(&test_any_tbl, "%.2lf", 1.6);
637 table_end_row(&test_any_tbl);
639 table_end(&test_any_tbl);
640 table_cleanup(&test_any_tbl);
643 int main(int argc UNUSED, char **argv UNUSED)
646 out = bfdopen_shared(1, 4096);