Skip to content

Validus-Risk-Management/aws-appconfig-pydantic

Repository files navigation

Pydantic AWS AppConfig

image

image

image

image

Ever wanted to use AWS AppConfig for your Python app, but can't bear configs without pydantic?

Well, your days of using evil .env or .ini files, ENVIRONMENT variables or even custom providers is over!

With just a simple

pip install pydantic-appconfig

With a lot of inspiration from this AWS sample.

Introducing pydantic_appconfig.

  1. Set yourself up with your favourite `pydantic.BaseModel`:

    class MyAppConfig(pydantic.BaseModel):
        """My app config."""
    
        test_field_string: str
        test_field_int: int
    
        class Config:
            """The pydantic config, including title for the JSON schema."""
    
            title = "MyAppConfig"
  2. Set up the config helper using your shiny config class:

    from pydantic_appconfig import AppConfigHelper
    
    my_config: AppConfigHelper[MyAppConfig] = AppConfigHelper(
        appconfig_application="AppConfig-App",
        appconfig_environment="AppConfig-Env",
        appconfig_profile="AppConfig-Profile",
        max_config_age=15,
        fetch_on_init=True,
        config_schema_model=MyAppConfig,
    )
  3. Use it:

    my_val = my_config.config.test_field_string

AWS AppConfig also has support for validators.

Pydantic is able to generate a JSON schema for you to upload:

print(MyAppConfig.schema_json(indent=2))
{
  "title": "MyAppConfig",
  "description": "My app config.",
  "type": "object",
  "properties": {
    "test_field_string": {
      "title": "Test Field String",
      "type": "string"
    },
    "test_field_int": {
      "title": "Test Field Int",
      "type": "integer"
    }
  },
  "required": [
    "test_field_string",
    "test_field_int"
  ]
}