Первые шаги

Установка

Для playcloud нужен Python 3.10+. Добавьте библиотеку в проект:

uv add playcloud

Использование

В примере ниже создаётся Loader с парой настроек и сразу используется.

from playcloud import Loader

loader = Loader(
    env_prefix="APP",
    files="config.toml",
)

loader.load()

n = loader.get_int("server.port")
print(n)

Источники и приоритет

playcloud читает источники по порядку: встроенные значения по умолчанию, конфиг-файлы, переменные окружения и, наконец, явные переопределения. Ключ из более позднего источника заменяет прежнее значение.

Файлы необязательны, если вы не пометили их как обязательные. Отсутствие необязательного файла — не ошибка.

Переменные окружения

Ключи отображаются в переменные склейкой сегментов пути через подчёркивание в верхнем регистре с выбранным префиксом. server.port с префиксом APP превращается в APP_SERVER_PORT.

Проверка значений

После слияния результат проверяется. Все ошибки собираются и возвращаются вместе — вы исправляете их за один проход, а не по одной за перезапуск.

Перезагрузка

Включите слежение, чтобы получать новую конфигурацию при каждом изменении файла. Некорректные изменения отклоняются, и продолжает действовать прежняя конфигурация.