libtoml

Very tiny TOML parser and encoder in C.

Build and Install

To build this library, compiler with C99 support is required.

On Linux and macOS:

mkdir build
cd build
cmake ..
make
sudo make install

On Windows:

mkdir build
cd build
cmake ..
cmake --build .

CMake Support

Use FetchContent:

include(FetchContent)
FetchContent_Declare(libtoml
    GIT_REPOSITORY    "https://github.com/brglng/libtoml.git" 
    GIT_SHALLOW       ON
    )
FetchContent_MakeAvailable(libtoml)
add_executable(yourprogram yourprogram.c)
target_link_libraries(yourprogram toml::toml)

Use add_subdirectory:

add_subdirectory(libtoml)
add_executable(yourprogram yourprogram.c)
target_link_libraries(yourprogram toml::toml)

Use find_package:

find_package(toml)
add_executable(yourprogram yourprogram.c)
target_link_libraries(yourprogram toml::toml)

Usage

Load from a file using a filename:

TomlTable *table = toml_load_filename("path/to/my/file.toml");
if (toml_err()->code == TOML_OK) {
    TomlTableIter it = toml_table_iter_new(table);
    while (toml_table_iter_has_next(&it)) {
        TomlKeyValue *keyval = toml_table_iter_get(&it);

        /* do something */

        toml_table_iter_next(&it);
    }
    toml_table_free(table);
} else {
    fprintf(stderr, "toml: %d: %s\n", toml_err()->code, toml_err()->message);

    /*
     * If error occurred, toml_clear_err() must be called before the next call
     * which can produce an error, or there can be an assertion failure.
     */
    toml_err_clear();
}

TODO

• Update to TOML v1.0 spec
• Array invariance checking
• Date-time support
• Support parsing while reading
• Travis CI support
• Encoding
• Encoding to JSON
• Documentation