lib/ecoli_node.c

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright 2016, Olivier MATZ <zer0@droids-corp.org>
   3  */
   4
   5 #include <stdio.h>
   6 #include <stdlib.h>
   7 #include <stdint.h>
   8 #include <string.h>
   9 #include <assert.h>
  10 #include <errno.h>
  11
  12 #include <ecoli_malloc.h>
  13 #include <ecoli_string.h>
  14 #include <ecoli_strvec.h>
  15 #include <ecoli_keyval.h>
  16 #include <ecoli_log.h>
  17 #include <ecoli_config.h>
  18 #include <ecoli_test.h>
  19 #include <ecoli_node.h>
  20
  21 #include <ecoli_node_str.h>
  22 #include <ecoli_node_seq.h>
  23
  24 EC_LOG_TYPE_REGISTER(node);
  25
  26 static struct ec_node_type_list node_type_list =
  27         TAILQ_HEAD_INITIALIZER(node_type_list);
  28
  29 const struct ec_node_type *
  30 ec_node_type_lookup(const char *name)
  31 {
  32         struct ec_node_type *type;
  33
  34         TAILQ_FOREACH(type, &node_type_list, next) {
  35                 if (!strcmp(name, type->name))
  36                         return type;
  37         }
  38
  39         errno = ENOENT;
  40         return NULL;
  41 }
  42
  43 int ec_node_type_register(struct ec_node_type *type)
  44 {
  45         EC_CHECK_ARG(type->size >= sizeof(struct ec_node), -1, EINVAL);
  46
  47         if (ec_node_type_lookup(type->name) != NULL) {
  48                 errno = EEXIST;
  49                 return -1;
  50         }
  51
  52         TAILQ_INSERT_TAIL(&node_type_list, type, next);
  53
  54         return 0;
  55 }
  56
  57 void ec_node_type_dump(FILE *out)
  58 {
  59         struct ec_node_type *type;
  60
  61         TAILQ_FOREACH(type, &node_type_list, next)
  62                 fprintf(out, "%s\n", type->name);
  63 }
  64
  65 struct ec_node *__ec_node(const struct ec_node_type *type, const char *id)
  66 {
  67         struct ec_node *node = NULL;
  68
  69         EC_LOG(EC_LOG_DEBUG, "create node type=%s id=%s\n",
  70                 type->name, id);
  71         if (id == NULL) {
  72                 errno = EINVAL;
  73                 goto fail;
  74         }
  75
  76         node = ec_calloc(1, type->size);
  77         if (node == NULL)
  78                 goto fail;
  79
  80         node->type = type;
  81         node->refcnt = 1;
  82
  83         node->id = ec_strdup(id);
  84         if (node->id == NULL)
  85                 goto fail;
  86
  87         if (ec_asprintf(&node->desc, "<%s>", type->name) < 0)
  88                 goto fail;
  89
  90         node->attrs = ec_keyval();
  91         if (node->attrs == NULL)
  92                 goto fail;
  93
  94         if (type->init_priv != NULL) {
  95                 if (type->init_priv(node) < 0)
  96                         goto fail;
  97         }
  98
  99         return node;
 100
 101  fail:
 102         if (node != NULL) {
 103                 ec_keyval_free(node->attrs);
 104                 ec_free(node->desc);
 105                 ec_free(node->id);
 106         }
 107         ec_free(node);
 108
 109         return NULL;
 110 }
 111
 112 struct ec_node *ec_node(const char *typename, const char *id)
 113 {
 114         const struct ec_node_type *type;
 115
 116         type = ec_node_type_lookup(typename);
 117         if (type == NULL) {
 118                 EC_LOG(EC_LOG_ERR, "type=%s does not exist\n",
 119                         typename);
 120                 return NULL;
 121         }
 122
 123         return __ec_node(type, id);
 124 }
 125
 126 void ec_node_free(struct ec_node *node)
 127 {
 128         if (node == NULL)
 129                 return;
 130
 131         assert(node->refcnt > 0);
 132
 133         if (--node->refcnt > 0)
 134                 return;
 135
 136         if (node->type != NULL && node->type->free_priv != NULL)
 137                 node->type->free_priv(node);
 138         ec_free(node->children);
 139         ec_free(node->id);
 140         ec_free(node->desc);
 141         ec_keyval_free(node->attrs);
 142         ec_config_free(node->config);
 143         ec_free(node);
 144 }
 145
 146 struct ec_node *ec_node_clone(struct ec_node *node)
 147 {
 148         if (node != NULL)
 149                 node->refcnt++;
 150         return node;
 151 }
 152
 153 size_t ec_node_get_children_count(const struct ec_node *node)
 154 {
 155         return node->n_children;
 156 }
 157
 158 struct ec_node *
 159 ec_node_get_child(const struct ec_node *node, size_t i)
 160 {
 161         if (i >= ec_node_get_children_count(node))
 162                 return NULL;
 163         return node->children[i];
 164 }
 165
 166 int ec_node_add_child(struct ec_node *node, struct ec_node *child)
 167 {
 168         struct ec_node **children = NULL;
 169         size_t n;
 170
 171         if (node == NULL || child == NULL) {
 172                 errno = EINVAL;
 173                 goto fail;
 174         }
 175
 176         n = node->n_children;
 177         children = ec_realloc(node->children,
 178                         (n + 1) * sizeof(child));
 179         if (children == NULL)
 180                 goto fail;
 181
 182         children[n] = child;
 183         node->children = children;
 184         node->n_children = n + 1;
 185
 186         return 0;
 187
 188 fail:
 189         ec_free(children);
 190         assert(errno != 0);
 191         return -1;
 192 }
 193
 194 int
 195 ec_node_set_config(struct ec_node *node, struct ec_config *config)
 196 {
 197         if (node->type->schema == NULL) {
 198                 errno = EINVAL;
 199                 goto fail;
 200         }
 201         if (ec_config_validate(config, node->type->schema,
 202                                 node->type->schema_len) < 0)
 203                 goto fail;
 204         if (node->type->set_config != NULL) {
 205                 if (node->type->set_config(node, config) < 0)
 206                         goto fail;
 207         }
 208
 209         ec_config_free(node->config);
 210         node->config = config;
 211
 212         return 0;
 213
 214 fail:
 215         ec_config_free(config);
 216         return -1;
 217 }
 218
 219 const struct ec_config *ec_node_get_config(struct ec_node *node)
 220 {
 221         return node->config;
 222 }
 223
 224 #if 0 /* later */
 225 int ec_node_del_child(struct ec_node *node, struct ec_node *child)
 226 {
 227         size_t i, n;
 228
 229         if (node == NULL || child == NULL)
 230                 goto fail;
 231
 232         n = node->n_children;
 233         for (i = 0; i < n; i++) {
 234                 if (node->children[i] != child)
 235                         continue;
 236                 memcpy(&node->children[i], &node->children[i+1],
 237                         (n - i - 1) * sizeof(child));
 238                 return 0;
 239         }
 240
 241 fail:
 242         errno = EINVAL;
 243         return -1;
 244 }
 245 #endif
 246
 247 struct ec_node *ec_node_find(struct ec_node *node, const char *id)
 248 {
 249         struct ec_node *child, *ret;
 250         const char *node_id = ec_node_id(node);
 251         size_t i, n;
 252
 253         if (id != NULL && node_id != NULL && !strcmp(node_id, id))
 254                 return node;
 255
 256         n = node->n_children;
 257         for (i = 0; i < n; i++) {
 258                 child = node->children[i];
 259                 ret = ec_node_find(child, id);
 260                 if (ret != NULL)
 261                         return ret;
 262         }
 263
 264         return NULL;
 265 }
 266
 267 const struct ec_node_type *ec_node_type(const struct ec_node *node)
 268 {
 269         return node->type;
 270 }
 271
 272 struct ec_keyval *ec_node_attrs(const struct ec_node *node)
 273 {
 274         return node->attrs;
 275 }
 276
 277 const char *ec_node_id(const struct ec_node *node)
 278 {
 279         return node->id;
 280 }
 281
 282 static void __ec_node_dump(FILE *out,
 283         const struct ec_node *node, size_t indent)
 284 {
 285         const char *id, *typename;
 286         struct ec_node *child;
 287         size_t i, n;
 288
 289         id = ec_node_id(node);
 290         typename = node->type->name;
 291
 292         fprintf(out, "%*s" "type=%s id=%s %p\n",
 293                 (int)indent * 4, "", typename, id, node);
 294         n = node->n_children;
 295         for (i = 0; i < n; i++) {
 296                 child = node->children[i];
 297                 __ec_node_dump(out, child, indent + 1);
 298         }
 299 }
 300
 301 void ec_node_dump(FILE *out, const struct ec_node *node)
 302 {
 303         fprintf(out, "------------------- node dump:\n");
 304
 305         if (node == NULL) {
 306                 fprintf(out, "node is NULL\n");
 307                 return;
 308         }
 309
 310         __ec_node_dump(out, node, 0);
 311 }
 312
 313 const char *ec_node_desc(const struct ec_node *node)
 314 {
 315         if (node->type->desc != NULL)
 316                 return node->type->desc(node);
 317
 318         return node->desc;
 319 }
 320
 321 int ec_node_check_type(const struct ec_node *node,
 322                 const struct ec_node_type *type)
 323 {
 324         if (strcmp(node->type->name, type->name)) {
 325                 errno = EINVAL;
 326                 return -1;
 327         }
 328
 329         return 0;
 330 }
 331
 332 /* LCOV_EXCL_START */
 333 static int ec_node_testcase(void)
 334 {
 335         struct ec_node *node = NULL;
 336         const struct ec_node *child;
 337         const struct ec_node_type *type;
 338         FILE *f = NULL;
 339         char *buf = NULL;
 340         size_t buflen = 0;
 341         int testres = 0;
 342         int ret;
 343
 344         node = EC_NODE_SEQ(EC_NO_ID,
 345                         ec_node_str("id_x", "x"),
 346                         ec_node_str("id_y", "y"));
 347         if (node == NULL)
 348                 goto fail;
 349
 350         ec_node_clone(node);
 351         ec_node_free(node);
 352
 353         f = open_memstream(&buf, &buflen);
 354         if (f == NULL)
 355                 goto fail;
 356         ec_node_dump(f, node);
 357         ec_node_type_dump(f);
 358         ec_node_dump(f, NULL);
 359         fclose(f);
 360         f = NULL;
 361
 362         testres |= EC_TEST_CHECK(
 363                 strstr(buf, "type=seq id=no-id"), "bad dump\n");
 364         testres |= EC_TEST_CHECK(
 365                 strstr(buf, "type=str id=id_x") &&
 366                 strstr(strstr(buf, "type=str id=id_x") + 1,
 367                         "type=str id=id_y"),
 368                 "bad dump\n");
 369         free(buf);
 370         buf = NULL;
 371
 372         testres |= EC_TEST_CHECK(
 373                 !strcmp(ec_node_type(node)->name, "seq") &&
 374                 !strcmp(ec_node_id(node), EC_NO_ID) &&
 375                 !strcmp(ec_node_desc(node), "<seq>"),
 376                 "bad child 0");
 377
 378         testres |= EC_TEST_CHECK(
 379                 ec_node_get_children_count(node) == 2,
 380                 "bad children count\n");
 381         child = ec_node_get_child(node, 0);
 382         testres |= EC_TEST_CHECK(child != NULL &&
 383                 !strcmp(ec_node_type(child)->name, "str") &&
 384                 !strcmp(ec_node_id(child), "id_x"),
 385                 "bad child 0");
 386         child = ec_node_get_child(node, 1);
 387         testres |= EC_TEST_CHECK(child != NULL &&
 388                 !strcmp(ec_node_type(child)->name, "str") &&
 389                 !strcmp(ec_node_id(child), "id_y"),
 390                 "bad child 1");
 391         child = ec_node_get_child(node, 2);
 392         testres |= EC_TEST_CHECK(child == NULL,
 393                 "child 2 should be NULL");
 394
 395         child = ec_node_find(node, "id_x");
 396         testres |= EC_TEST_CHECK(child != NULL &&
 397                 !strcmp(ec_node_type(child)->name, "str") &&
 398                 !strcmp(ec_node_id(child), "id_x") &&
 399                 !strcmp(ec_node_desc(child), "x"),
 400                 "bad child id_x");
 401         child = ec_node_find(node, "id_dezdex");
 402         testres |= EC_TEST_CHECK(child == NULL,
 403                 "child with wrong id should be NULL");
 404
 405         ret = ec_keyval_set(ec_node_attrs(node), "key", "val", NULL);
 406         testres |= EC_TEST_CHECK(ret == 0,
 407                 "cannot set node attribute\n");
 408
 409         type = ec_node_type_lookup("seq");
 410         testres |= EC_TEST_CHECK(type != NULL &&
 411                 ec_node_check_type(node, type) == 0,
 412                 "cannot get seq node type");
 413         type = ec_node_type_lookup("str");
 414         testres |= EC_TEST_CHECK(type != NULL &&
 415                 ec_node_check_type(node, type) < 0,
 416                 "node type should not be str");
 417
 418         ec_node_free(node);
 419         node = NULL;
 420
 421         node = ec_node("deznuindez", EC_NO_ID);
 422         testres |= EC_TEST_CHECK(node == NULL,
 423                         "should not be able to create node\n");
 424
 425         return testres;
 426
 427 fail:
 428         ec_node_free(node);
 429         if (f != NULL)
 430                 fclose(f);
 431         free(buf);
 432
 433         assert(errno != 0);
 434         return -1;
 435 }
 436 /* LCOV_EXCL_STOP */
 437
 438 static struct ec_test ec_node_test = {
 439         .name = "node",
 440         .test = ec_node_testcase,
 441 };
 442
 443 EC_TEST_REGISTER(ec_node_test);