confy

A C++17 application configuration library which is:

Easy to use
Configurable
Extensible

Although usable for the most part, the library is still in development. It's close to version v1.0.0. The progress towards v1.0.0 can be followed here

The gist

A short example:

    struct app_configuration
    {
        std::string name;
        int age = 0;
        enum class role_t
        {
            ceo, employee, intern
        };
        role_t role = role_t::intern;
    };

    // ...

    app_configuration c;

    confy::config cfg;
    cfg.schema()
        .opt(c.name, "name", "n", "The name of the person")
        .opt(c.age, "age", "a", "The age of the person")
        .opt(c.role, "role", "r", "The role of the person");

    cfg.parse_cmd_line(argc, argv);

    std::cout
        << "Name: " << c.name
        << "\nAge: " << c.age
        << "\nRole: " << confy::magic_enum::enum_name(c.role)
        << "\n";

It might seem that confy is Yet Another™ command line argument parser, but although it can be used as such, that's not its main power. It's configuration. If some of the options are not provided from the command line, it will search environment variables with that name and try to load values from there. The library also supports parsing of .ini files.

Each option in the schema tries to get it's value from the following sources (top has the highest priority):

Manual user override
Command line
Config (.ini) file
Environment variable
User-provided default fallback

The library is highly configurable by its schema-definition EDSL and can be extended with various user-defined option types (ie a point) and value sources (ie a .json file).

Building

You can use CMake. There is no special configuration involved to simply build the library.

Contributing

All contributions in the form of issues and pull requests are welcome.

Development

In order to buld the tests, you have to fetch the doctest submodule.

License