lib.h

/*
 * @file lib.h
 */

#ifndef C_TOML_H
#define C_TOML_H
#include <stdint.h>
#include <stdbool.h>
#include <c-string/lib.h> // https://github.com/fabriciopashaj/c-string

// TOML data type ids
#ifdef DEBUG

/**
 * @enum TOMLKind
 * @brief The TOML value kinds.
 */
typedef enum TOMLKind {
#define K(k) TOML_##k
  K(INTEGER) = 1,
  K(FLOAT),
  K(BOOLEAN),
  K(STRING),
  K(DATE),
  K(TIME),
  K(DATETIME),
  K(ARRAY),
  K(TABLE),
  K(INLINE_TABLE),
  K(TABLE_ARRAY)
#undef K
} TOMLKind;

#else

#define TOML_INTEGER      1
#define TOML_FLOAT        2
#define TOML_BOOLEAN      3
#define TOML_STRING       4
#define TOML_DATE         5
#define TOML_TIME         6
#define TOML_DATETIME     7
#define TOML_ARRAY        8
#define TOML_TABLE        9
#define TOML_INLINE_TABLE 10
#define TOML_TABLE_ARRAY  11

typedef uint8_t TOMLKind;

#endif

// STATUSES BEGIN
#define TOML_E_OK                      0
#define TOML_E_OOM                     1
#define TOML_E_INT_OVERFLOW            2
#define TOML_E_FLOAT_OVERFLOW          3
#define TOML_E_UNTERMINATED_STRING     4
#define TOML_E_MISSING_BRACKET         5
#define TOML_E_INVALID_NUMBER          6
#define TOML_E_INVALID_KEY             7
#define TOML_E_INVALID_VALUE           8
#define TOML_E_ARRAY                   9
#define TOML_E_INLINE_TABLE            10
#define TOML_E_UNEXPECTED_CHAR         11
#define TOML_E_INVALID_ESCAPE          12
#define TOML_E_COMMA_OR_BRACKET        13
#define TOML_E_INVALID_DATE            14
#define TOML_E_INVALID_TIME            15
#define TOML_E_INVALID_DATETIME        16
#define TOML_E_INVALID_HEX_ESCAPE      17
#define TOML_E_EXPECTED_TABLE          18
#define TOML_E_EXPECTED_TABLE_ARRAY    19
#define TOML_E_DUPLICATE_KEY           20
#define TOML_E_ENTRY_EXPECTED          21
#define TOML_E_ENTRY_UNEXPECTED        22
#define TOML_E_ENTRY_INCOMPLETE        23
#define TOML_E_INVALID_HEADER          24
#define TOML_E_TABLE_HEADER            25
#define TOML_E_TABLE_ARRAY_HEADER      26
#define TOML_E_EOF                     27
// STATUSES END

// Typedefing the structs before defining their bodies
typedef struct TOMLDate         TOMLDate;
typedef struct TOMLTime         TOMLTime;
typedef struct TOMLDateTime     TOMLDateTime;
typedef struct TOMLValue        TOMLValue;
typedef struct TOMLCtx          TOMLCtx; // more like parsing state
typedef struct TOMLPosition     TOMLPosition; // position of the cursor
// Typedefing array types
typedef struct TOMLValue*   TOMLArray;
// The table
typedef struct TOMLTable_Bucket TOMLTable_Bucket;
typedef struct TOMLTable_Bucket *TOMLTable;
// and the status thing
typedef signed int TOMLStatus; // determines success or the error kind

void TOMLValue_print(TOMLValue const *, int);

/**
 * @struct TOMLTime
 * @brief A TOML time value.
 */
struct TOMLTime {
  uint16_t millisec;
  uint8_t  hour;
  uint8_t  min;
  uint8_t  sec;
  // [0] = ("+" | "-")
  // [1] = <hour>
  // [2] = <minutes>
  int8_t   z[3]; ///< The timezone offset. The first byte is either `+` or `-`
                 ///< and determines whether it is positive or negative offset.
                 ///< The second byte is the offset of hours and the third byte
                 ///< the offset of minutes.
}__attribute__((packed));

struct TOMLDate {
  uint16_t year;
  uint8_t  month;
  uint8_t  day;
}__attribute__((packed));

struct TOMLDateTime {
  TOMLDate date;
  TOMLTime time;
};

/**
 * @struct TOMLValue
 * @brief A tagged union wrapping the different TOML values.
 */
struct TOMLValue {
  union {
    String       string;
    signed long  integer;
    double       float_; // it's still a float, just double precision
    bool         boolean;
    TOMLArray    array;
    TOMLTable    table;
    TOMLDate     date;
    TOMLTime     time;
    TOMLDateTime datetime;
  }__attribute__((packed));
  TOMLKind kind; ///< The kind of the TOML value.
}__attribute__((packed));

#define CVECTOR_POINTERMODE
#define CVECTOR_NO_TYPEDEF
#include <c-vector/lib.h> // https://github.com/fabriciopashaj/c-vector
CVECTOR_WITH_NAME(TOMLValue, TOMLArray);
void TOMLArray_destroy(TOMLArray);

/**
 * @struct TOMLCtx
 * @brief The parsing context of the parser.
 *
 * Multiple contexts can be created with for different strings with
 * TOML data to parse without them interfering with each other.
 */
struct TOMLCtx {
  StringBuffer content; ///< The StringBuffer with the TOML data.
  char const   *end;    ///< The address of the end of the content.
  char const   *offset; ///< The pointer to the part of the content that will
                        ///< be used by the next call of a parsing function.
};

/**
 * @struct TOMLPosition
 * @brief The position of the cursor of a parsing context in the content.
 */
struct TOMLPosition {
  int offset; ///< The cursor's offset from the starting character.
  int line;   ///< The line position of the cursor.
  int column; ///< The column position of the cursor.
};

void        TOML_init              (TOMLCtx *, StringBuffer);
TOMLStatus  TOML_parse_value       (TOMLCtx *, TOMLValue *);
TOMLStatus  TOML_parse_number      (TOMLCtx *, TOMLValue *);
TOMLStatus  TOML_parse_sl_string   (TOMLCtx *, String *);
TOMLStatus  TOML_parse_ml_string   (TOMLCtx *, String *);
TOMLStatus  TOML_parse_time        (TOMLCtx *, TOMLTime *);
TOMLStatus  TOML_parse_datetime    (TOMLCtx *, TOMLValue *);
TOMLStatus  TOML_parse_array       (TOMLCtx *, TOMLArray *);
TOMLStatus  TOML_parse_entry       (TOMLCtx *, TOMLTable *);
TOMLStatus  TOML_parse_inline_table(TOMLCtx *, TOMLTable *);
TOMLStatus  TOML_parse_table_header(TOMLCtx *, TOMLTable *,
                                    TOMLTable **, int);
TOMLStatus  TOML_parse_table       (TOMLCtx *, TOMLTable *);
/**
 * @brief Parses a TOML buffer.
 */
TOMLStatus  TOML_parse             (TOMLCtx *, TOMLTable *);

/**
 * @fn TOMLValue_destroy(TOMLValue *value)
 * @brief Frees `value`.
 *
 * If it is a container, it frees all the @link TOMLValue @endlink s it
 * contains recursively.
 */
void TOMLValue_destroy(TOMLValue *);
/**
 * @fn TOML_position(TOMLCtx const *ctx)
 * @brief Get the position of the parsing context `ctx`.
 */
TOMLPosition TOML_position(TOMLCtx const *);

#include "table.h"

#endif /* C_TOML_H */