configor

Light weight configuration library for C++

294
36
C++

logo

Open in VSCode
Github status
Codacy Badge
codecov
GitHub release
GitHub license

A light weight configuration library for C++11.

EN | 中文

Features

  • Header-only & STL-like
  • Custom type conversion & serialization
  • Complete Unicode support
  • ASCII & Wide-character support

Quick start

Create JSON objects:

json::value j;
j["integer"] = 1;
j["float"] = 1.5;
j["string"] = "something";
j["boolean"] = true;
j["user"]["id"] = 10;
j["user"]["name"] = "Nomango";

json::value j2 = json::object{
    { "null", nullptr },
    { "integer", 1 },
    { "float", 1.3 },
    { "boolean", true },
    { "string", "something" },
    { "array", json::array{ 1, 2 } },
    { "object", json::object{
        { "key", "value" },
        { "key2", "value2" },
    }},
};

Conversion & Serialization:

struct User
{
    std::string name;
    int age;

    // bind custom type to configor
    CONFIGOR_BIND(json::value, User, REQUIRED(name), OPTIONAL(age))
};

// User -> json
json::value j = User{"John", 18};
// json -> User
User u = json::object{{"name", "John"}, {"age", 18}};

// User -> string
std::string str = json::dump(User{"John", 18});
// string -> User
User u = json::parse("{\"name\": \"John\", \"age\": 18}");

// User -> stream
std::cout << json::wrap(User{"John", 18});
// stream -> User
User u;
std::cin >> json::wrap(u);

Learn more from the wiki.

Plan

  • [x] Custom type conversion
  • [x] Unicode support
  • [x] Unit test coverage above 85%
  • [ ] Improve error message
  • [ ] YAML support
  • [ ] ini support
  • [ ] json5 support
  • [ ] SAX tool