pydantic-settings-azure-app-configuration

What it is and what it does

This package integrates Azure App Configuration and Azure Key Vault with pydantic-settings, allowing you to define application settings as pydantic models and populate them directly from Azure services. It acts as a custom settings source that plugs into pydantic-settings' `settings_customise_sources` hook, so configuration values flow into your BaseSettings classes alongside environment variables and other sources.

The package supports filtering configuration by key prefix, trimming that prefix from resulting field names, and transparently resolving references to secrets stored in Key Vault. It requires Azure credentials and supports nested models through a configurable delimiter.

Use it for:

• Centralize application configuration in Azure App Configuration while keeping pydantic validation and type safety.
• Retrieve database passwords and API keys from Azure Key Vault without hardcoding or managing separate secret files.
• Multi-tenant or multi-environment deployments where different instances load config by key prefix from a shared store.
• Migrate from environment-variable-based config to a managed Azure service while preserving pydantic's nested model patterns.
• Use Entra ID role-based access control to secure config access without shared credentials.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Loads application configuration and secrets from Azure App Configuration and Azure Key Vault into pydantic-settings models, with support for key filtering, prefix trimming, and nested configuration.

Yes, if you are already committed to Azure and pydantic-settings. The package has low install friction and no known vulnerabilities. However, the aging maintenance status and unclear license pose moderate risk for production use. Verify the license explicitly and assess whether the limited community support is acceptable for your deployment model.

Install

pydantic-settings-azure-app-configuration on PyPI

pip install pydantic-settings-azure-app-configuration

uv add pydantic-settings-azure-app-configuration

poetry add pydantic-settings-azure-app-configuration

Installing pydantic-settings-azure-app-configuration

Before you install

Low install friction with a pure-Python wheel. Maintenance status is aging—last commit was 2025-09-09 with only 3 stars, suggesting limited community adoption and uncertain long-term support.

License in practice

License treatment is unclear; no SPDX identifier or raw license text is declared in the package metadata. Verify the actual license before using in proprietary or GPL-sensitive contexts.

Quickstart

from azure.identity import DefaultAzureCredential
from pydantic_settings import BaseSettings
from pydantic_settings_azure_app_configuration.source import AzureAppConfigurationSettingsSource

class MySettings(BaseSettings):
    api_key: str
    @classmethod
    def settings_customise_sources(cls, settings_cls, init_settings, env_settings, dotenv_settings, file_secret_settings):
        credential = DefaultAzureCredential()
        azure_source = AzureAppConfigurationSettingsSource(settings_cls, lambda opts: opts.connect_with_url(os.environ["AZURE_APP_CONFIGURATION_URL"], credential))
        return (init_settings, env_settings, dotenv_settings, file_secret_settings, azure_source)

Requires Python >=3.11; Azure credentials and AZURE_APP_CONFIGURATION_URL environment variable must be configured.

Verify before relying

• Whether the package is actively maintained or in maintenance-only mode given the aging status and low star count.
• The actual license under which the package is distributed, since metadata declares none.

Package facts

Evidence: pydantic_settings_azure_app_configuration-1.1.0-py3-none-any.whl

Tags

More Application Frameworks packages