config.h

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright 2018, Olivier MATZ <zer0@droids-corp.org>
 */
 
#pragma once
 
#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#include <sys/queue.h>
 
struct ec_config;
struct ec_dict;
 
enum ec_config_type {
    EC_CONFIG_TYPE_NONE = 0,
    EC_CONFIG_TYPE_BOOL,
    EC_CONFIG_TYPE_INT64,
    EC_CONFIG_TYPE_UINT64,
    EC_CONFIG_TYPE_STRING,
    EC_CONFIG_TYPE_NODE,
    EC_CONFIG_TYPE_LIST,
    EC_CONFIG_TYPE_DICT,
};
 
struct ec_config_schema {
    const char *key; 
    const char *desc; 
    enum ec_config_type type; 
    /* XXX flags: mandatory */
    /* XXX default */
 
    const struct ec_config_schema *subschema;
};
 
TAILQ_HEAD(ec_config_list, ec_config);
 
struct ec_config {
    enum ec_config_type type;
 
    union {
        bool boolean; 
        int64_t i64; 
        uint64_t u64; 
        char *string; 
        struct ec_node *node; 
        struct ec_dict *dict; 
        struct ec_config_list list; 
    };
 
    TAILQ_ENTRY(ec_config) next;
};
 
/* schema */
 
int ec_config_schema_validate(const struct ec_config_schema *schema);
 
void ec_config_schema_dump(FILE *out, const struct ec_config_schema *schema);
 
const struct ec_config_schema *
ec_config_schema_lookup(const struct ec_config_schema *schema, const char *key);
 
enum ec_config_type ec_config_schema_type(const struct ec_config_schema *schema_elt);
 
const struct ec_config_schema *ec_config_schema_sub(const struct ec_config_schema *schema_elt);
 
bool ec_config_key_is_reserved(const char *name);
 
extern const char *ec_config_reserved_keys[];
 
/* config */
 
enum ec_config_type ec_config_get_type(const struct ec_config *config);
 
struct ec_config *ec_config_bool(bool boolean);
 
struct ec_config *ec_config_i64(int64_t i64);
 
struct ec_config *ec_config_u64(uint64_t u64);
 
struct ec_config *ec_config_string(const char *string);
 
struct ec_config *ec_config_node(struct ec_node *node);
 
struct ec_config *ec_config_dict(void);
 
struct ec_config *ec_config_list(void);
 
int ec_config_list_add(struct ec_config *list, struct ec_config *value);
 
int ec_config_list_del(struct ec_config *list, struct ec_config *config);
 
ssize_t ec_config_count(const struct ec_config *config);
 
int ec_config_validate(const struct ec_config *dict, const struct ec_config_schema *schema);
 
int ec_config_dict_set(struct ec_config *dict, const char *key, struct ec_config *value);
 
int ec_config_dict_del(struct ec_config *dict, const char *key);
 
int ec_config_cmp(const struct ec_config *config1, const struct ec_config *config2);
 
struct ec_config *ec_config_dict_get(const struct ec_config *config, const char *key);
 
struct ec_config *ec_config_list_first(struct ec_config *list);
 
struct ec_config *ec_config_list_next(struct ec_config *list, struct ec_config *config);
 
void ec_config_free(struct ec_config *config);
 
int ec_config_cmp(const struct ec_config *value1, const struct ec_config *value2);
 
struct ec_config *ec_config_dup(const struct ec_config *config);
 
void ec_config_dump(FILE *out, const struct ec_config *config);