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, GRPC, ...)."""

    def customize(self) -> None:
        """Apply service-specific defaults after sources load."""
        super().customize()
        self.FASTAPI.PROJECT_NAME = "my-service"
        self.FASTAPI.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, …

FastAPIConfig (config.FASTAPI)

Drives both AppUtils.create_fastapi_app and uvicorn in manage.py:

Area	Fields
Serve	SERVE_HOST, SERVE_PORT, RELOAD, WORKERS_COUNT
Proxy	PROXY_HEADERS, FORWARDED_ALLOW_IPS
App / docs	PROJECT_NAME, OPENAPI_URL, DOCS_URL, RE_DOC_URL, …
Middleware flags	GZIP_MIDDLEWARE_IS_ENABLED, TRUSTED_HOST_MIDDLEWARE_*, HTTPS_REDIRECT_MIDDLEWARE_IS_ENABLED, CORS fields

Set defaults in customize(); never hardcode host/port/reload for production paths.

gRPC bind (parallel): config.GRPC.SERVE_HOST, config.GRPC.SERVE_PORT.

Dependency Injection

uv add "archipy[dependency-injection]"

• Wire in configs/containers.py as providers: ports → adapters → repositories → logics → services.
• Depend on ports in business code; override providers in tests with mocks.
• Import app_config inside the container module so set_global runs before wiring.