config-and-di

Config and Dependency Injection

BaseConfig

import logging

from archipy.configs.base_config import BaseConfig
from archipy.configs.environment_type import EnvironmentType

logger = logging.getLogger(__name__)


class AppConfig(BaseConfig):
    """Application configuration. Inherits ArchiPy sections (REDIS, FASTAPI, UVICORN, GRPC, ...)."""

    def customize(self) -> None:
        """Apply service-specific defaults after sources load."""
        super().customize()
        self.FASTAPI.PROJECT_NAME = "my-service"
        self.UVICORN.RELOAD = self.ENVIRONMENT == EnvironmentType.LOCAL


config = AppConfig()
BaseConfig.set_global(config)
logger.info("Config loaded for environment: %s", config.ENVIRONMENT)

• Call BaseConfig.set_global(config) once at bootstrap (typically importing app_config from the DI container).
• Read elsewhere via BaseConfig.global_config().
• Document required env vars in .env.example; never commit secrets.
• Env overrides use nested delimiter: FASTAPI__PROJECT_NAME, FASTAPI__SERVE_PORT, UVICORN__RELOAD, …
• Preserve ArchiPy's settings-source priority: secret files → Vault → pyproject → TOML → environment → .env → defaults. Do not add scattered os.environ reads that bypass it.
• Raise ConfigurationError / InvalidArgumentError from archipy.models.errors for config validation failures; do not invent ad-hoc config exceptions.

FastAPIConfig (config.FASTAPI) and UvicornConfig (config.UVICORN)

config.FASTAPI drives AppUtils.create_fastapi_app and the bind address; config.UVICORN holds the server settings that AppUtils.uvicorn_config() turns into uvicorn.run arguments (archipy >= 5.25.0; the same names on FASTAPI are deprecated):