Skip to content

Validus-Risk-Management/aws-appconfig-pydantic

Repository files navigation

Pydantic AWS AppConfig

https://img.shields.io/pypi/pyversions/pydantic-appconfig https://app.codacy.com/project/badge/Grade/7394b3a36fca46b38df857c415b3da3d https://app.codacy.com/project/badge/Coverage/7394b3a36fca46b38df857c415b3da3d

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"
  ]
}

Releases

No releases published

Packages

No packages published

Languages