Конфигурация LogIt++ разделена на явные этапы:
JSON value или text
-> ConfigurationDocument
-> validation и materialization
-> разрешение programmatic bindings
-> создание runtime logger'ов
Основная semantic model и runtime-слои не зависят от JSON-библиотеки. JSON
frontend является optional и использует nlohmann::json только при включённой
опции LOGIT_WITH_JSON_CONFIG=ON.
Установите nlohmann_json либо разрешите fallback из дерева исходников:
cmake -S . -B build \
-DLOGIT_WITH_JSON_CONFIG=ON \
-DLOGIT_USE_SUBMODULES=ONУстановленный пакет с этой опцией использует
find_dependency(nlohmann_json 3.11 CONFIG). Установка сборки с bundled
fallback намеренно запрещена: для экспортируемого пакета установите
nlohmann_json отдельно.
При включённой опции <logit.hpp> предоставляет overload'ы для JSON-текста и
уже разобранного значения nlohmann::json:
#include <logit.hpp>
const std::string text = R"json({
"schema_version": 1,
"loggers": [{
"id": "application-file",
"type": "file",
"backend": {
"directory": "logs",
"async": true,
"use_dedicated_executor": true,
"queue_capacity": 8192,
"queue_policy": "block"
}
}]
})json";
logit::ConfigurationDocument document;
logit::ConfigurationDiagnostics diagnostics;
if (!logit::parse_configuration_json(text, document, diagnostics)) {
// Обработайте diagnostics.items().
}Разбор не создаёт logger'ы и заменяет document только после полного успеха.
Frontend возвращает path-aware diagnostics для JSON syntax и shape/conversion
ошибок; синтаксические ошибки используют категорию
configuration_parse_failed. Backend schema validation выполняется отдельной
core-фазой: unknown fields, backend types, enum/named values, defaults и
feature availability могут быть диагностированы materialize_configuration(),
а не JSON conversion. Floating-point значения JSON отклоняются, поскольку в
schema v1 предусмотрены только signed и unsigned integer значения.
Следующие этапы вызываются явно через materialize_configuration() и
instantiate_configuration(). Frontend не читает файлы, не вводит собственные
defaults, не разрешает callback'и и не создаёт logger'ы. instantiate_configuration()
остаётся compatibility API для backend-instantiation: factory сама владеет
level logger'а и не создаёт formatter из materialized strategy. Для атомарного
применения strategy используйте prepare_configuration(): он создаёт formatter
и назначает explicit level или default TRACE. Properties input и hot reload
пока не реализованы.
Для подготовки runtime-пар доступен prepare_configuration(). Он возвращает
ConfigurationPreparedSet: стабильный ID logger'а, конкретные ILogger,
ILogFormatter и применённый LogLevel. При отсутствии level используется
TRACE; formatter schema v1 имеет тип simple, defaults публичного
SimpleLogFormatter::Config, а затем применяет явные pattern и JSON overrides.
Prepared result использует shared ownership в соответствии с существующим
factory API. Logger::add_logger() пока принимает unique ownership, поэтому
регистрация остаётся отдельной границей; подготовка не изменяет глобальный
singleton поэлементно.