Pydantic settings

What you’ll learn

  • Use the pydantic-settings integration for settings models.

Run locally

uv run python examples/ex_13_pydantic_settings/01_pydantic_settings.py

Example

"""Pydantic settings auto-registration.

``BaseSettings`` subclasses are auto-registered by diwire as root-scope
singleton factories. Resolving the same settings type repeatedly returns the
same object instance.
"""

from __future__ import annotations

from pydantic_settings import BaseSettings

from diwire import Container, MissingPolicy


class AppSettings(BaseSettings):
    value: str = "settings"


def main() -> None:
    container = Container(missing_policy=MissingPolicy.REGISTER_ROOT)

    first = container.resolve(AppSettings)
    second = container.resolve(AppSettings)

    print(f"settings_singleton={first is second}")  # => settings_singleton=True
    print(f"settings_value={first.value}")  # => settings_value=settings


if __name__ == "__main__":
    main()