https://github.com/battlegrounds/minjson

Minimalistic JSON library for modern C++20
https://github.com/battlegrounds/minjson

cpp20 json minimal modern-cpp

Last synced: about 1 year ago
JSON representation

Minimalistic JSON library for modern C++20

• Host: GitHub
• URL: https://github.com/battlegrounds/minjson
• Owner: BattleGrounds
• License: other
• Created: 2025-06-20T12:53:02.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-20T13:56:39.000Z (about 1 year ago)
• Last Synced: 2025-06-20T14:41:14.361Z (about 1 year ago)
• Topics: cpp20, json, minimal, modern-cpp
• Language: C++
• Homepage: https://battlegrounds.github.io/MinJSON/
• Size: 19.5 KB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# 🧩 MinJSON – минималистичная JSON-библиотека для C++20

**MinJSON** — это легковесная, высокопроизводительная JSON-библиотека с поддержкой:

- ✅ C++20-концептов (`MinJSONValueType`)

- ✅ Полноценного парсинга и сериализации

- ✅ Типобезопасного доступа через пути (`"user.name[0].value"`)

- ✅ Макросной рефлексии (в стиле `nlohmann::json`)

- ✅ Кэширования путей (`thread_local`)

- ✅ Совместима с STL: `std::string`, `std::vector`, `std::optional`

## 🚀 Пример использования

### 📌 Парсинг и доступ

```cpp

#include "MinJSON.hpp"

int main() {

    MinJSON json;

    auto result = json.parse(R"({"user":{"name":"Alice","age":30}})");

    if (std::holds_alternative(result)) {

        std::cerr << "Error: " << std::get(result) << "\n";

        return 1;

    }

    const auto& data = std::get(result);

    std::string name = json.get(data, "user.name");

    int age = json.get(data, "user.age");

    std::cout << name << " is " << age << " years old\n";

}

```

### 📌 Макросная рефлексия

```cpp

#include "MinJSON.hpp"

struct User {

    int id;

    std::string name;

};

MINJSON_REGISTER_TYPE(User,

    MINJSON_FIELD(id)

    MINJSON_FIELD(name)

)

int main() {

    MinJSON json;

    MinJSON_register_User(json);

    User user{42, "Bob"};

    auto value = json.to_json(user);

    std::cout << json.stringify(value, true) << "\n";

    auto user2 = json.from_json(value);

    std::cout << user2.name << "\n";

}

```

## 🔧 Сборка через CMake

```bash

mkdir build && cd build

cmake ..

make

```

## 📄 Лицензия

MIT License. Свободно для использования в любых целях.