In this quickstart, you will use the Python provider for Azure App Configuration to centralize storage and management of application settings using theAzure App Configuration Python provider client library.

The Python App Configuration provider is a library running on top of theAzure SDK for Python, helping Python developers easily consume the App Configuration service. It enables configuration settings to be used like a dictionary.

Prerequisites

• An Azure account with an active subscription.Create one for free.
• An App Configuration store, as shown in thetutorial for creating a store.
• Python 3.8 or later - for information on setting up Python on Windows, see thePython on Windows documentation

Add key-values

Add the following key-values to the App Configuration store. For more information about how to add key-values to a store using the Azure portal or the CLI, go toCreate a key-value.

Console applications

In this section, you will create a console application and load data from your App Configuration store.

Connect to App Configuration

1. Create a new directory for the project namedapp-configuration-quickstart.

   mkdir app-configuration-quickstart

2. Switch to the newly createdapp-configuration-quickstart directory.

   cd app-configuration-quickstart

3. Install the Azure App Configuration provider by using thepip install command.

   pip install azure-appconfiguration-provider

4. Create a new file calledapp-configuration-quickstart.py in theapp-configuration-quickstart directory and add the following code:

   • Microsoft Entra ID (recommended)
   • Connection string

   You use theDefaultAzureCredential to authenticate to your App Configuration store. Follow theinstructions to assign your credential theApp Configuration Data Reader role. Be sure to allow sufficient time for the permission to propagate before running your application.

   from azure.appconfiguration.provider import (    load,    SettingSelector)from azure.identity import DefaultAzureCredentialimport osendpoint = os.environ.get("AZURE_APPCONFIG_ENDPOINT")# Connect to Azure App Configuration using Microsoft Entra ID.config = load(endpoint=endpoint, credential=credential)credential = DefaultAzureCredential()# Find the key "message" and print its value.print(config["message"])# Find the key "my_json" and print the value for "key" from the dictionary.print(config["my_json"]["key"])# Connect to Azure App Configuration using Entra ID and trimmed key prefixes.trimmed = {"test."}config = load(endpoint=endpoint, credential=credential, trim_prefixes=trimmed)# From the keys with trimmed prefixes, find a key with "message" and print its value.print(config["message"])# Connect to Azure App Configuration using SettingSelector.selects = {SettingSelector(key_filter="message*", label_filter="\0")}config = load(endpoint=endpoint, credential=credential, selects=selects)# Print True or False to indicate if "message" is found in Azure App Configuration.print("message found: " + str("message" in config))print("test.message found: " + str("test.message" in config))

Run the application

1. Set an environment variable.

   • Microsoft Entra ID (recommended)
   • Connection string

   Set the environment variable namedAZURE_APPCONFIG_ENDPOINT to the endpoint of your App Configuration store found under theOverview of your store in the Azure portal.

   If you use the Windows command prompt, run the following command and restart the command prompt to allow the change to take effect:

   setx AZURE_APPCONFIG_ENDPOINT "endpoint-of-your-app-configuration-store"

   If you use PowerShell, run the following command:

   $Env:AZURE_APPCONFIG_ENDPOINT = "endpoint-of-your-app-configuration-store"

   If you use macOS or Linux, run the following command:

   export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'

2. After the environment variable is properly set, run the following command to run the app locally:

   python app-configuration-quickstart.py

   You should see the following output:

   HellovalueHello testmessage found: Truetest.message found: False

Web applications

The App Configuration provider loads data into aMapping object, accessible as a dictionary, which can be used in combination with the existing configuration of various Python frameworks. This section shows how to use the App Configuration provider in popular web frameworks like Flask and Django.

azure_app_config = load(endpoint=os.environ.get("AZURE_APPCONFIG_ENDPOINT"), credential=credential)# NOTE: This will override all existing configuration settings with the same key name.app.config.update(azure_app_config)# Access a configuration setting directly from within Flask configurationmessage = app.config.get("message")

AZURE_APPCONFIGURATION = load(endpoint=os.environ.get("AZURE_APPCONFIG_ENDPOINT"), credential=credential)

# Import Django settingsfrom django.conf import settings# Access a configuration setting from Django settings instance.MESSAGE = settings.AZURE_APPCONFIGURATION.get("message")

Full code samples on how to use Azure App Configuration in Python web applications can be found in theAzure App Configuration GitHub repo.

Clean up resources

If you don't want to continue using the resources created in this article, delete the resource group you created here to avoid charges.

1. Sign in to theAzure portal, and selectResource groups.
2. In theFilter by name box, enter the name of your resource group.
3. In the result list, select the resource group name to see an overview.
4. SelectDelete resource group.
5. You're asked to confirm the deletion of the resource group. Enter the name of your resource group to confirm, and selectDelete.

After a few moments, the resource group and all its resources are deleted.

Next steps

In this quickstart, you created a new App Configuration store and learned how to access key-values from a Python app.

For additional code samples, visit: