Configuration — Aquilia Documentation
Comprehensive guide and documentation for Configuration in the Aquilia framework. View API reference, examples, and implementation patterns.
i18n / Configuration i18n Configuration i18n settings can be declared through workspace builders, typed integration objects, or raw runtime config. At server boot, all paths are normalized into I18nConfig . Configuration Entry Points from aquilia.config_builders import Workspace, Integration from aquilia.integrations.i18n import I18nIntegration workspace = ( Workspace("myapp") # Builder API .integrate( Integration.i18n( enabled=True, default_locale="en", available_locales=["en", "fr", "de", "ja"], fallback_locale="en", catalog_dirs=["locales"], catalog_format="surp", ) ) # Typed integration object .integrate( I18nIntegration( enabled=True, default_locale="en", available_locales=["en", "fr"], catalog_dirs=["locales"], ) ) ) Runtime Precedence # Effective flow # 1) user config in i18n or integrations.i18n # 2) merged with ConfigLoader.get_i18n_config defaults # 3) converted by I18nConfig.from_dict # 4) consumed by create_i18n_service If enabled is false after merge, server setup skips I18nService creation, resolver chain construction, and middleware insertion. Key Reference Key Type Description ))} Default Value Matrix Key ConfigLoader Integration.i18n I18nConfig dataclass from_dict fallback ))} Missing-Key Strategies return_key # returns the dotted key return_empty # returns "" return_default # returns default argument if present, else key raise # raises MissingTranslationFault log_and_key # logs warning and returns key )
Go to Homepage