# Azure App Configuration client library for Python
Azure App Configuration is a managed service that helps developers centralize their application configurations simply and securely.
Modern programs, especially programs running in a cloud, generally have many components that are distributed in nature. Spreading configuration settings across these components can lead to hard-to-troubleshoot errors during an application deployment. Use App Configuration to securely store all the settings for your application in one place.
Use the client library for App Configuration to create and manage application configuration settings.
[Source code](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration)
| [Package (Pypi)][package]
| [Package (Conda)](https://anaconda.org/microsoft/azure-appconfiguration/)
| [API reference documentation](https://learn.microsoft.com/python/api/azure-appconfiguration/azure.appconfiguration?view=azure-python)
| [Product documentation][appconfig_docs]
## Getting started
### Install the package
Install the Azure App Configuration client library for Python with pip:
```
pip install azure-appconfiguration
```
### Prerequisites
* Python 3.8 or later is required to use this package.
* You need an [Azure subscription][azure_sub], and a [Configuration Store][configuration_store] to use this package.
To create a Configuration Store, you can use the Azure Portal or [Azure CLI][azure_cli].
After that, create the Configuration Store:
```Powershell
az appconfig create --name <config-store-name> --resource-group <resource-group-name> --location eastus
```
### Authenticate the client
In order to interact with the App Configuration service, you'll need to create an instance of the
[AzureAppConfigurationClient][configuration_client_class] class. To make this possible,
you can either use the connection string of the Configuration Store or use an AAD token.
#### Use connection string
##### Get credentials
Use the [Azure CLI][azure_cli] snippet below to get the connection string from the Configuration Store.
```Powershell
az appconfig credential list --name <config-store-name>
```
Alternatively, get the connection string from the Azure Portal.
##### Create client
Once you have the value of the connection string, you can create the AzureAppConfigurationClient:
<!-- SNIPPET:hello_world_sample.create_app_config_client -->
```python
import os
from azure.appconfiguration import AzureAppConfigurationClient
CONNECTION_STRING = os.environ["APPCONFIGURATION_CONNECTION_STRING"]
# Create app config client
client = AzureAppConfigurationClient.from_connection_string(CONNECTION_STRING)
```
<!-- END SNIPPET -->
#### Use AAD token
Here we demonstrate using [DefaultAzureCredential][default_cred_ref]
to authenticate as a service principal. However, [AzureAppConfigurationClient][configuration_client_class]
accepts any [azure-identity][azure_identity] credential. See the
[azure-identity][azure_identity] documentation for more information about other
credentials.
##### Create a service principal (optional)
This [Azure CLI][azure_cli] snippet shows how to create a
new service principal. Before using it, replace "your-application-name" with
the appropriate name for your service principal.
Create a service principal:
```Bash
az ad sp create-for-rbac --name http://my-application --skip-assignment
```
> Output:
> ```json
> {
> "appId": "generated app id",
> "displayName": "my-application",
> "name": "http://my-application",
> "password": "random password",
> "tenant": "tenant id"
> }
> ```
Use the output to set **AZURE_CLIENT_ID** ("appId" above), **AZURE_CLIENT_SECRET**
("password" above) and **AZURE_TENANT_ID** ("tenant" above) environment variables.
The following example shows a way to do this in Bash:
```Bash
export AZURE_CLIENT_ID="generated app id"
export AZURE_CLIENT_SECRET="random password"
export AZURE_TENANT_ID="tenant id"
```
Assign one of the applicable [App Configuration roles](https://docs.microsoft.com/azure/azure-app-configuration/rest-api-authorization-azure-ad) to the service principal.
##### Create a client
Once the **AZURE_CLIENT_ID**, **AZURE_CLIENT_SECRET** and
**AZURE_TENANT_ID** environment variables are set,
[DefaultAzureCredential][default_cred_ref] will be able to authenticate the
[AzureAppConfigurationClient][configuration_client_class].
Constructing the client also requires your configuration store's URL, which you can
get from the Azure CLI or the Azure Portal. In the Azure Portal, the URL can be found listed as the service "Endpoint"
```python
from azure.identity import DefaultAzureCredential
from azure.appconfiguration import AzureAppConfigurationClient
credential = DefaultAzureCredential()
client = AzureAppConfigurationClient(base_url="your_endpoint_url", credential=credential)
```
## Key concepts
### Configuration Setting
A Configuration Setting is the fundamental resource within a Configuration Store. In its simplest form it is a key and a value. However, there are additional properties such as the modifiable content type and tags fields that allow the value to be interpreted or associated in different ways.
The [Label][label_concept] property of a Configuration Setting provides a way to separate Configuration Settings into different dimensions. These dimensions are user defined and can take any form. Some common examples of dimensions to use for a label include regions, semantic versions, or environments. Many applications have a required set of configuration keys that have varying values as the application exists across different dimensions.
For example, MaxRequests may be 100 in "NorthAmerica", and 200 in "WestEurope". By creating a Configuration Setting named MaxRequests with a label of "NorthAmerica" and another, only with a different value, in the "WestEurope" label, an application can seamlessly retrieve Configuration Settings as it runs in these two dimensions.
Properties of a Configuration Setting:
```python
key : str
label : str
content_type : str
value : str
last_modified : str
read_only : bool
tags : dict
etag : str
```
### Snapshot
Azure App Configuration allows users to create a point-in-time snapshot of their configuration store, providing them with the ability to treat settings as one consistent version. This feature enables applications to hold a consistent view of configuration, ensuring that there are no version mismatches to individual settings due to reading as updates were made. Snapshots are immutable, ensuring that configuration can confidently be rolled back to a last-known-good configuration in the event of a problem.
## Examples
The following sections provide several code snippets covering some of the most common Configuration Service tasks, including:
* [Create a Configuration Setting](#create-a-configuration-setting)
* [Get a Configuration Setting](#get-a-configuration-setting)
* [Delete a Configuration Setting](#delete-a-configuration-setting)
* [List Configuration Settings](#list-configuration-settings)
* [Create a Snapshot](#create-a-snapshot)
* [Get a Snapshot](#get-a-snapshot)
* [Archive a Snapshot](#archive-a-snapshot)
* [Recover a Snapshot](#recover-a-snapshot)
* [List Snapshots](#list-snapshots)
* [List Configuration Settings of a Snapshot](#list-configuration-settings-of-a-snapshot)
* [Async APIs](#async-apis)
### Create a Configuration Setting
Create a Configuration Setting to be stored in the Configuration Store.
There are two ways to store a Configuration Setting:
- add_configuration_setting creates a setting only if the setting does not already exist in the store.
<!-- SNIPPET:hello_world_sample.create_config_setting -->
```python
config_setting = ConfigurationSetting(
key="MyKey", label="MyLabel", value="my value", content_type="my content type", tags={"my tag": "my tag value"}
)
added_config_setting = client.add_configuration_setting(config_setting)
```
<!-- END SNIPPET -->
- set_configuration_setting creates a setting if it doesn't exist or overrides an existing setting.
<!-- SNIPPET:hello_world_sample.set_config_setting -->
```python
added_config_setting.value = "new value"
added_config_setting.content_type = "new content type"
updated_config_setting = client.set_configuration_setting(added_config_setting)
```
<!-- END SNIPPET -->
### Set and clear read-only for a configuration setting.
- Set a configuration setting to be read-only.
<!-- SNIPPET:read_only_sample.set_read_only -->
```python
read_only_config_setting = client.set_read_only(updated_config_setting)
```
<!-- END SNIPPET -->
- Clear read-only for a configuration setting.
<!-- SNIPPET:read_only_sample.clear_read_only -->
```python
read_write_config_setting = client.set_read_only(updated_config_setting, False)
```
<!-- END SNIPPET -->
### Get a Configuration Setting
Get a previously stored Configuration Setting.
<!-- SNIPPET:hello_world_sample.get_config_setting -->
```python
fetched_config_setting = client.get_configuration_setting(key="MyKey", label="MyLabel")
```
<!-- END SNIPPET -->
### Delete a Configuration Setting
Delete an existing Configuration Setting.
<!-- SNIPPET:hello_world_sample.delete_config_setting -->
```python
client.delete_configuration_setting(key="MyKey", label="MyLabel")
```
<!-- END SNIPPET -->
### List Configuration Settings
List all configuration settings filtered with label_filter and/or key_filter and/or tags_filter.
<!-- SNIPPET:list_configuration_settings_sample.list_configuration_settings -->
```python
config_settings = client.list_configuration_settings(key_filter="MyKey*", tags_filter=["my tag1=my tag1 value"])
for config_setting in config_settings:
print(config_setting)
```
<!-- END SNIPPET -->
### List revisions
List revision history of configuration settings filtered with label_filter and/or key_filter and/or tags_filter.
<!-- SNIPPET:list_revision_sample.list_revisions -->
```python
items = client.list_revisions(key_filter="MyKey", tags_filter=["my tag=my tag value"])
for item in items:
print(item)
```
<!-- END SNIPPET -->
### List labels
List labels of all configuration settings.
<!-- SNIPPET:list_labels_sample.list_labels -->
```python
print("List all labels in resource")
config_settings = client.list_labels()
for config_setting in config_settings:
print(config_setting)
print("List labels by exact match")
config_settings = client.list_labels(name="my label1")
for config_setting in config_settings:
print(config_setting)
print("List labels by wildcard")
config_settings = client.list_labels(name="my label*")
for config_setting in config_settings:
print(config_setting)
```
<!-- END SNIPPET -->
### Create a Snapshot
<!-- SNIPPET:snapshot_sample.create_snapshot -->
```python
from azure.appconfiguration import ConfigurationSettingsFilter
filters = [ConfigurationSettingsFilter(key="my_key1", label="my_label1")]
response = client.begin_create_snapshot(name=snapshot_name, filters=filters)
created_snapshot = response.result()
```
<!-- END SNIPPET -->
### Get a Snapshot
<!-- SNIPPET:snapshot_sample.get_snapshot -->
```python
received_snapshot = client.get_snapshot(name=snapshot_name)
```
<!-- END SNIPPET -->
### Archive a Snapshot
<!-- SNIPPET:snapshot_sample.archive_snapshot -->
```python
archived_snapshot = client.archive_snapshot(name=snapshot_name)
```
<!-- END SNIPPET -->
### Recover a Snapshot
<!-- SNIPPET:snapshot_sample.recover_snapshot -->
```python
recovered_snapshot = client.recover_snapshot(name=snapshot_name)
```
<!-- END SNIPPET -->
### List Snapshots
<!-- SNIPPET:snapshot_sample.list_snapshots -->
```python
for snapshot in client.list_snapshots():
print(snapshot)
```
<!-- END SNIPPET -->
### List Configuration Settings of a Snapshot
<!-- SNIPPET:snapshot_sample.list_configuration_settings_for_snapshot -->
```python
for config_setting in client.list_configuration_settings(snapshot_name=snapshot_name):
print(config_setting)
```
<!-- END SNIPPET -->
### Async APIs
Async client is supported.
To use the async client library, import the AzureAppConfigurationClient from package azure.appconfiguration.aio instead of azure.appconfiguration.
<!-- SNIPPET:hello_world_sample_async.create_app_config_client -->
```python
import os
from azure.appconfiguration.aio import AzureAppConfigurationClient
CONNECTION_STRING = os.environ["APPCONFIGURATION_CONNECTION_STRING"]
# Create an app config client
client = AzureAppConfigurationClient.from_connection_string(CONNECTION_STRING)
```
<!-- END SNIPPET -->
This async AzureAppConfigurationClient has the same method signatures as the sync ones except that they're async.\
For instance, retrieve a Configuration Setting asynchronously:
<!-- SNIPPET:hello_world_sample_async.get_config_setting -->
```python
fetched_config_setting = await client.get_configuration_setting(key="MyKey", label="MyLabel")
```
<!-- END SNIPPET -->
To list configuration settings, call `list_configuration_settings` operation synchronously and iterate over the returned async iterator asynchronously:
<!-- SNIPPET:list_configuration_settings_sample_async.list_configuration_settings -->
```python
config_settings = client.list_configuration_settings(key_filter="MyKey*", tags_filter=["my tag1=my tag1 value"])
async for config_setting in config_settings:
print(config_setting)
```
<!-- END SNIPPET -->
## Troubleshooting
See the [troubleshooting guide][troubleshooting_guide] for details on how to diagnose various failure scenarios.
## Next steps
### More sample code
Several App Configuration client library samples are available to you in this GitHub repository. These include:
- [Hello world](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/hello_world_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/hello_world_sample_async.py)
- [List configuration settings](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/list_configuration_settings_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/list_configuration_settings_sample_async.py)
- [Make a configuration setting readonly](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/read_only_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/hello_world_sample_async.py)
- [Read revision history](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/list_revision_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/list_revision_sample_async.py)
- [Get a setting if changed](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/conditional_operation_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/conditional_operation_sample_async.py)
- [Create, retrieve and update status of a configuration settings snapshot](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/snapshot_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/snapshot_sample_async.py)
- [Send custom HTTP requests](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/send_request_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/send_request_sample_async.py)
- [Update AzureAppConfigurationClient sync_token](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/sync_token_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/sync_token_sample_async.py)
For more details see the [samples README](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/README.md).
## Contributing
This project welcomes contributions and suggestions. Most contributions require
you to agree to a Contributor License Agreement (CLA) declaring that you have
the right to, and actually do, grant us the rights to use your contribution.
For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether
you need to provide a CLA and decorate the PR appropriately (e.g., label,
comment). Simply follow the instructions provided by the bot. You will only
need to do this once across all repos using our CLA.
This project has adopted the
[Microsoft Open Source Code of Conduct][code_of_conduct]. For more information,
see the [Code of Conduct FAQ][coc_faq] or contact [opencode@microsoft.com][coc_contact] with any
additional questions or comments.
<!-- LINKS -->
[appconfig_docs]: https://docs.microsoft.com/azure/azure-app-configuration/
[appconfig_rest]: https://github.com/Azure/AppConfiguration#rest-api-reference
[azure_cli]: https://docs.microsoft.com/cli/azure
[azure_sub]: https://azure.microsoft.com/free/
[configuration_client_class]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_azure_appconfiguration_client.py
[package]: https://pypi.org/project/azure-appconfiguration/
[configuration_store]: https://azure.microsoft.com/services/app-configuration/
[default_cred_ref]: https://aka.ms/azsdk-python-identity-default-cred-ref
[azure_identity]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity
[cla]: https://cla.microsoft.com
[code_of_conduct]: https://opensource.microsoft.com/codeofconduct/
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
[coc_contact]: mailto:opencode@microsoft.com
[troubleshooting_guide]: https://aka.ms/azsdk/python/appconfiguration/troubleshoot
[label_concept]: https://docs.microsoft.com/azure/azure-app-configuration/concept-key-value#label-keys
# Release History
## 1.7.1 (2024-08-22)
### Bugs Fixed
- Fixed a bug in serializing/deserializing tags filter in `ConfigurationSnapshot`.
## 1.7.0 (2024-08-15)
### Features Added
- Added operation `list_labels()` for listing configuration setting labels.
- Supported filtering by configuration setting tags in `list_configuration_settings()` and `list_revisions()`.
- Added a new property tags to ConfigurationSettingsFilter to support filtering settings with tags filter for snapshot.
### Bugs Fixed
- Fixed a bug where the `feature_id` of `FeatureFlagConfigurationSetting` will be different from `id` customer field, and may overwrite the original customer-defined value if different from the `FeatureFlagConfigurationSetting` key suffix.
### Other Changes
- Updated the default `api_version` to "2023-11-01".
- Published enum `LabelFields` and model `ConfigurationSettingLabel`.
- Published enum `SnapshotFields`, and accepted the type for `fields` parameter in `get_snapshot()` and `list_snapshots()`.
- Published enum `ConfigurationSettingFields`, and accepted the type for `fields` parameter in `list_configuration_settings()` and `list_revisions()`.
- Published enum `SnapshotComposition`, and accepted the type for `ConfigurationSnapshot` property `composition_type` and `begion_create_snapshot()` kwarg `composition_type`.
## 1.6.0 (2024-04-09)
### Features Added
- Exposed `send_request()` method in each client to send custom requests using the client's existing pipeline.
- Supported to get page ETag while iterating `list_configuration_setting()` result by page.
### Bugs Fixed
- Fixed a bug in consuming "etag" value in sync operation `set_configuration_setting()`.
- Changed invalid default value `None` to `False` for property `enabled` in `FeatureFlagConfigurationSetting`.
- Fixed the issue that `description`, `display_name` and other customer fields are missing when de/serializing `FeatureFlagConfigurationSetting` objects.
## 1.6.0b2 (2024-03-21)
### Bugs Fixed
- Changed invalid default value `None` to `False` for property `enabled` in `FeatureFlagConfigurationSetting`.
- Fixed the issue that `description`, `display_name` and other customer fields are missing when de/serializing `FeatureFlagConfigurationSetting` objects.
## 1.6.0b1 (2024-03-14)
### Features Added
- Exposed `send_request()` method in each client to send custom requests using the client's existing pipeline.
- Supported to get page ETag while iterating `list_configuration_setting()` result by page.
### Bugs Fixed
- Fixed a bug in consuming "etag" value in sync operation `set_configuration_setting()`.
## 1.5.0 (2023-11-09)
### Other Changes
- Supported datetime type for keyword argument `accept_datetime` in `get_snapshot_configuration_settings()`, `list_snapshot_configuration_settings()` and `list_revisions()`.
- Bumped minimum dependency on `azure-core` to `>=1.28.0`.
- Updated the default `api_version` to "2023-10-01".
- Removed `etag` keyword documentation in `set_read_only()` as it's not in use.
- Added support for Python 3.12.
- Python 3.7 is no longer supported. Please use Python version 3.8 or later.
## 1.5.0b3 (2023-10-10)
### Breaking Changes
- Renamed parameter `name` in `list_snapshot_configuration_settings()` to `snapshot_name`.
- Removed keyword argument `accept_datetime` in `list_snapshot_configuration_settings()`.
- Moved operation `list_snapshot_configuration_settings()` to an overload of `list_configuration_settings()`, and moved the parameter `snapshot_name` to keyword.
- Published enum `SnapshotStatus`, and accepted the type for `status` parameter in `list_snapshots()` and `status` property in `Snapshot` model.
- Renamed model `Snapshot` to `ConfigurationSnapshot`.
- Renamed model `ConfigurationSettingFilter` to `ConfigurationSettingsFilter`.
## 1.5.0b2 (2023-08-02)
### Bugs Fixed
- Fixed a bug in deserializing and serializing Snapshot when `filters` property is `None`.
- Fixed a bug when creating `FeatureFlagConfigurationSetting` from SDK but having an error in portal.([#31326](https://github.com/Azure/azure-sdk-for-python/issues/31326))
## 1.5.0b1 (2023-07-11)
### Features Added
- Added support for `Snapshot` CRUD operations.
### Bugs Fixed
- Fixed async `update_sync_token()` to use async/await keywords.
### Other Changes
- Bumped minimum dependency on `azure-core` to `>=1.25.0`.
- Updated the default `api_version` to "2022-11-01-preview".
## 1.4.0 (2022-02-13)
### Other Changes
- Python 2.7 is no longer supported. Please use Python version 3.7 or later.
- Bumped minimum dependency on `azure-core` to `>=1.24.0`.
- Changed the default async transport from `AsyncioRequestsTransport` to the one used in current `azure-core` (`AioHttpTransport`). ([#26427](https://github.com/Azure/azure-sdk-for-python/issues/26427))
- Dropped `msrest` requirement.
- Added dependency `isodate` with version range `>=0.6.0`.
## 1.3.0 (2021-11-10)
### Bugs Fixed
- Fixed the issue that data was persisted according to an incorrect schema/in an incorrect format ([#20518](https://github.com/Azure/azure-sdk-for-python/issues/20518))
`SecretReferenceConfigurationSetting` in 1.2.0 used "secret_uri" rather than "uri" as the schema keywords which
broken inter-operation of `SecretReferenceConfigurationSetting` between SDK and the portal.
Please:
- Use 1.3.0+ for any `SecretReferenceConfigurationSetting` uses.
- Call a get method for existing `SecretReferenceConfigurationSetting`s and set them back to correct the format.
## 1.2.0 (2021-07-06)
### Features Added
* Added `FeatureFlagConfigurationSetting` and `SecretReferenceConfigurationSetting` models
* `AzureAppConfigurationClient` can now be used as a context manager.
* Added `update_sync_token()` to update sync tokens from Event Grid notifications.
## 1.2.0b2 (2021-06-08)
### Features
- Added context manager functionality to the sync and async `AzureAppConfigurationClient`s.
### Fixes
- Fixed a deserialization bug for `FeatureFlagConfigurationSetting` and `SecretReferenceConfigurationSetting`.
## 1.2.0b1 (2021-04-06)
### Features
- Added method `update_sync_token()` to include sync tokens from EventGrid notifications.
- Added `SecretReferenceConfigurationSetting` type to represent a configuration setting that references a KeyVault Secret.
- Added `FeatureFlagConfigurationSetting` type to represent a configuration setting that controls a feature flag.
## 1.1.1 (2020-10-05)
### Features
- Improved error message if Connection string secret has incorrect padding. ([#14140](https://github.com/Azure/azure-sdk-for-python/issues/14140))
## 1.1.0 (2020-09-08)
### Features
- Added match condition support for `set_read_only()` method. ([#13276](https://github.com/Azure/azure-sdk-for-python/issues/13276))
## 1.0.1 (2020-08-10)
### Fixes
- Doc & Sample fixes
## 1.0.0 (2020-01-06)
### Features
- Added AAD auth support. ([#8924](https://github.com/Azure/azure-sdk-for-python/issues/8924))
### Breaking changes
- `list_configuration_settings()` & `list_revisions()` now take string key/label filter instead of keys/labels list. ([#9066](https://github.com/Azure/azure-sdk-for-python/issues/9066))
## 1.0.0b6 (2019-12-03)
### Features
- Added sync-token support. ([#8418](https://github.com/Azure/azure-sdk-for-python/issues/8418))
### Breaking changes
- Combined set_read_only & clear_read_only to be set_read_only(True/False). ([#8453](https://github.com/Azure/azure-sdk-for-python/issues/8453))
## 1.0.0b5 (2019-10-30)
### Breaking changes
- `etag` and `match_condition` of `delete_configuration_setting()` are now keyword argument only. ([#8161](https://github.com/Azure/azure-sdk-for-python/issues/8161))
## 1.0.0b4 (2019-10-07)
- Added conditional operation support
- Added `set_read_only()` and `clear_read_only()` methods
## 1.0.0b3 (2019-09-09)
- New azure app configuration
Raw data
{
"_id": null,
"home_page": "https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/appconfiguration/azure-appconfiguration",
"name": "azure-appconfiguration",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "azure, azure sdk",
"author": "Microsoft Corporation",
"author_email": "azpysdkhelp@microsoft.com",
"download_url": "https://files.pythonhosted.org/packages/2c/ff/cd3804d1aa1789f393a3174ca2b701edf7f0092c615ab384fd065afd4433/azure-appconfiguration-1.7.1.tar.gz",
"platform": null,
"description": "# Azure App Configuration client library for Python\n\nAzure App Configuration is a managed service that helps developers centralize their application configurations simply and securely.\n\nModern programs, especially programs running in a cloud, generally have many components that are distributed in nature. Spreading configuration settings across these components can lead to hard-to-troubleshoot errors during an application deployment. Use App Configuration to securely store all the settings for your application in one place.\n\nUse the client library for App Configuration to create and manage application configuration settings.\n\n[Source code](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration)\n| [Package (Pypi)][package]\n| [Package (Conda)](https://anaconda.org/microsoft/azure-appconfiguration/)\n| [API reference documentation](https://learn.microsoft.com/python/api/azure-appconfiguration/azure.appconfiguration?view=azure-python)\n| [Product documentation][appconfig_docs]\n\n## Getting started\n\n### Install the package\n\nInstall the Azure App Configuration client library for Python with pip:\n\n```\npip install azure-appconfiguration\n```\n\n### Prerequisites\n\n* Python 3.8 or later is required to use this package.\n* You need an [Azure subscription][azure_sub], and a [Configuration Store][configuration_store] to use this package.\n\nTo create a Configuration Store, you can use the Azure Portal or [Azure CLI][azure_cli].\n\nAfter that, create the Configuration Store:\n\n```Powershell\naz appconfig create --name <config-store-name> --resource-group <resource-group-name> --location eastus\n```\n\n### Authenticate the client\n\nIn order to interact with the App Configuration service, you'll need to create an instance of the\n[AzureAppConfigurationClient][configuration_client_class] class. To make this possible,\nyou can either use the connection string of the Configuration Store or use an AAD token.\n\n#### Use connection string\n\n##### Get credentials\n\nUse the [Azure CLI][azure_cli] snippet below to get the connection string from the Configuration Store.\n\n```Powershell\naz appconfig credential list --name <config-store-name>\n```\n\nAlternatively, get the connection string from the Azure Portal.\n\n##### Create client\n\nOnce you have the value of the connection string, you can create the AzureAppConfigurationClient:\n\n<!-- SNIPPET:hello_world_sample.create_app_config_client -->\n\n```python\nimport os\nfrom azure.appconfiguration import AzureAppConfigurationClient\n\nCONNECTION_STRING = os.environ[\"APPCONFIGURATION_CONNECTION_STRING\"]\n\n# Create app config client\nclient = AzureAppConfigurationClient.from_connection_string(CONNECTION_STRING)\n```\n\n<!-- END SNIPPET -->\n\n#### Use AAD token\n\nHere we demonstrate using [DefaultAzureCredential][default_cred_ref]\nto authenticate as a service principal. However, [AzureAppConfigurationClient][configuration_client_class]\naccepts any [azure-identity][azure_identity] credential. See the\n[azure-identity][azure_identity] documentation for more information about other\ncredentials.\n\n##### Create a service principal (optional)\nThis [Azure CLI][azure_cli] snippet shows how to create a\nnew service principal. Before using it, replace \"your-application-name\" with\nthe appropriate name for your service principal.\n\nCreate a service principal:\n```Bash\naz ad sp create-for-rbac --name http://my-application --skip-assignment\n```\n\n> Output:\n> ```json\n> {\n> \"appId\": \"generated app id\",\n> \"displayName\": \"my-application\",\n> \"name\": \"http://my-application\",\n> \"password\": \"random password\",\n> \"tenant\": \"tenant id\"\n> }\n> ```\n\nUse the output to set **AZURE_CLIENT_ID** (\"appId\" above), **AZURE_CLIENT_SECRET**\n(\"password\" above) and **AZURE_TENANT_ID** (\"tenant\" above) environment variables.\nThe following example shows a way to do this in Bash:\n```Bash\nexport AZURE_CLIENT_ID=\"generated app id\"\nexport AZURE_CLIENT_SECRET=\"random password\"\nexport AZURE_TENANT_ID=\"tenant id\"\n```\n\nAssign one of the applicable [App Configuration roles](https://docs.microsoft.com/azure/azure-app-configuration/rest-api-authorization-azure-ad) to the service principal.\n\n##### Create a client\nOnce the **AZURE_CLIENT_ID**, **AZURE_CLIENT_SECRET** and\n**AZURE_TENANT_ID** environment variables are set,\n[DefaultAzureCredential][default_cred_ref] will be able to authenticate the\n[AzureAppConfigurationClient][configuration_client_class].\n\nConstructing the client also requires your configuration store's URL, which you can\nget from the Azure CLI or the Azure Portal. In the Azure Portal, the URL can be found listed as the service \"Endpoint\"\n\n```python\nfrom azure.identity import DefaultAzureCredential\nfrom azure.appconfiguration import AzureAppConfigurationClient\n\ncredential = DefaultAzureCredential()\n\nclient = AzureAppConfigurationClient(base_url=\"your_endpoint_url\", credential=credential)\n```\n\n## Key concepts\n\n### Configuration Setting\n\nA Configuration Setting is the fundamental resource within a Configuration Store. In its simplest form it is a key and a value. However, there are additional properties such as the modifiable content type and tags fields that allow the value to be interpreted or associated in different ways.\n\nThe [Label][label_concept] property of a Configuration Setting provides a way to separate Configuration Settings into different dimensions. These dimensions are user defined and can take any form. Some common examples of dimensions to use for a label include regions, semantic versions, or environments. Many applications have a required set of configuration keys that have varying values as the application exists across different dimensions.\n\nFor example, MaxRequests may be 100 in \"NorthAmerica\", and 200 in \"WestEurope\". By creating a Configuration Setting named MaxRequests with a label of \"NorthAmerica\" and another, only with a different value, in the \"WestEurope\" label, an application can seamlessly retrieve Configuration Settings as it runs in these two dimensions.\n\nProperties of a Configuration Setting:\n\n```python\nkey : str\nlabel : str\ncontent_type : str\nvalue : str\nlast_modified : str\nread_only : bool\ntags : dict\netag : str\n```\n\n### Snapshot\n\nAzure App Configuration allows users to create a point-in-time snapshot of their configuration store, providing them with the ability to treat settings as one consistent version. This feature enables applications to hold a consistent view of configuration, ensuring that there are no version mismatches to individual settings due to reading as updates were made. Snapshots are immutable, ensuring that configuration can confidently be rolled back to a last-known-good configuration in the event of a problem.\n\n## Examples\n\nThe following sections provide several code snippets covering some of the most common Configuration Service tasks, including:\n\n* [Create a Configuration Setting](#create-a-configuration-setting)\n* [Get a Configuration Setting](#get-a-configuration-setting)\n* [Delete a Configuration Setting](#delete-a-configuration-setting)\n* [List Configuration Settings](#list-configuration-settings)\n* [Create a Snapshot](#create-a-snapshot)\n* [Get a Snapshot](#get-a-snapshot)\n* [Archive a Snapshot](#archive-a-snapshot)\n* [Recover a Snapshot](#recover-a-snapshot)\n* [List Snapshots](#list-snapshots)\n* [List Configuration Settings of a Snapshot](#list-configuration-settings-of-a-snapshot)\n* [Async APIs](#async-apis)\n\n### Create a Configuration Setting\n\nCreate a Configuration Setting to be stored in the Configuration Store.\nThere are two ways to store a Configuration Setting:\n\n- add_configuration_setting creates a setting only if the setting does not already exist in the store.\n\n<!-- SNIPPET:hello_world_sample.create_config_setting -->\n\n```python\nconfig_setting = ConfigurationSetting(\n key=\"MyKey\", label=\"MyLabel\", value=\"my value\", content_type=\"my content type\", tags={\"my tag\": \"my tag value\"}\n)\nadded_config_setting = client.add_configuration_setting(config_setting)\n```\n\n<!-- END SNIPPET -->\n\n- set_configuration_setting creates a setting if it doesn't exist or overrides an existing setting.\n\n<!-- SNIPPET:hello_world_sample.set_config_setting -->\n\n```python\nadded_config_setting.value = \"new value\"\nadded_config_setting.content_type = \"new content type\"\nupdated_config_setting = client.set_configuration_setting(added_config_setting)\n```\n\n<!-- END SNIPPET -->\n\n### Set and clear read-only for a configuration setting.\n\n- Set a configuration setting to be read-only.\n\n<!-- SNIPPET:read_only_sample.set_read_only -->\n\n```python\nread_only_config_setting = client.set_read_only(updated_config_setting)\n```\n\n<!-- END SNIPPET -->\n\n- Clear read-only for a configuration setting.\n\n<!-- SNIPPET:read_only_sample.clear_read_only -->\n\n```python\nread_write_config_setting = client.set_read_only(updated_config_setting, False)\n```\n\n<!-- END SNIPPET -->\n\n### Get a Configuration Setting\n\nGet a previously stored Configuration Setting.\n\n<!-- SNIPPET:hello_world_sample.get_config_setting -->\n\n```python\nfetched_config_setting = client.get_configuration_setting(key=\"MyKey\", label=\"MyLabel\")\n```\n\n<!-- END SNIPPET -->\n\n### Delete a Configuration Setting\n\nDelete an existing Configuration Setting.\n\n<!-- SNIPPET:hello_world_sample.delete_config_setting -->\n\n```python\nclient.delete_configuration_setting(key=\"MyKey\", label=\"MyLabel\")\n```\n\n<!-- END SNIPPET -->\n\n### List Configuration Settings\n\nList all configuration settings filtered with label_filter and/or key_filter and/or tags_filter.\n\n<!-- SNIPPET:list_configuration_settings_sample.list_configuration_settings -->\n\n```python\nconfig_settings = client.list_configuration_settings(key_filter=\"MyKey*\", tags_filter=[\"my tag1=my tag1 value\"])\nfor config_setting in config_settings:\n print(config_setting)\n```\n\n<!-- END SNIPPET -->\n\n### List revisions\n\nList revision history of configuration settings filtered with label_filter and/or key_filter and/or tags_filter.\n\n<!-- SNIPPET:list_revision_sample.list_revisions -->\n\n```python\nitems = client.list_revisions(key_filter=\"MyKey\", tags_filter=[\"my tag=my tag value\"])\nfor item in items:\n print(item)\n```\n\n<!-- END SNIPPET -->\n\n### List labels\n\nList labels of all configuration settings.\n\n<!-- SNIPPET:list_labels_sample.list_labels -->\n\n```python\nprint(\"List all labels in resource\")\nconfig_settings = client.list_labels()\nfor config_setting in config_settings:\n print(config_setting)\n\nprint(\"List labels by exact match\")\nconfig_settings = client.list_labels(name=\"my label1\")\nfor config_setting in config_settings:\n print(config_setting)\n\nprint(\"List labels by wildcard\")\nconfig_settings = client.list_labels(name=\"my label*\")\nfor config_setting in config_settings:\n print(config_setting)\n```\n\n<!-- END SNIPPET -->\n\n### Create a Snapshot\n\n<!-- SNIPPET:snapshot_sample.create_snapshot -->\n\n```python\nfrom azure.appconfiguration import ConfigurationSettingsFilter\n\nfilters = [ConfigurationSettingsFilter(key=\"my_key1\", label=\"my_label1\")]\nresponse = client.begin_create_snapshot(name=snapshot_name, filters=filters)\ncreated_snapshot = response.result()\n```\n\n<!-- END SNIPPET -->\n\n### Get a Snapshot\n\n<!-- SNIPPET:snapshot_sample.get_snapshot -->\n\n```python\nreceived_snapshot = client.get_snapshot(name=snapshot_name)\n```\n\n<!-- END SNIPPET -->\n\n### Archive a Snapshot\n\n<!-- SNIPPET:snapshot_sample.archive_snapshot -->\n\n```python\narchived_snapshot = client.archive_snapshot(name=snapshot_name)\n```\n\n<!-- END SNIPPET -->\n\n### Recover a Snapshot\n\n<!-- SNIPPET:snapshot_sample.recover_snapshot -->\n\n```python\nrecovered_snapshot = client.recover_snapshot(name=snapshot_name)\n```\n\n<!-- END SNIPPET -->\n\n### List Snapshots\n\n<!-- SNIPPET:snapshot_sample.list_snapshots -->\n\n```python\nfor snapshot in client.list_snapshots():\n print(snapshot)\n```\n\n<!-- END SNIPPET -->\n\n### List Configuration Settings of a Snapshot\n\n<!-- SNIPPET:snapshot_sample.list_configuration_settings_for_snapshot -->\n\n```python\nfor config_setting in client.list_configuration_settings(snapshot_name=snapshot_name):\n print(config_setting)\n```\n\n<!-- END SNIPPET -->\n\n### Async APIs\n\nAsync client is supported.\nTo use the async client library, import the AzureAppConfigurationClient from package azure.appconfiguration.aio instead of azure.appconfiguration.\n\n<!-- SNIPPET:hello_world_sample_async.create_app_config_client -->\n\n```python\nimport os\nfrom azure.appconfiguration.aio import AzureAppConfigurationClient\n\nCONNECTION_STRING = os.environ[\"APPCONFIGURATION_CONNECTION_STRING\"]\n\n# Create an app config client\nclient = AzureAppConfigurationClient.from_connection_string(CONNECTION_STRING)\n```\n\n<!-- END SNIPPET -->\n\nThis async AzureAppConfigurationClient has the same method signatures as the sync ones except that they're async.\\\nFor instance, retrieve a Configuration Setting asynchronously:\n\n<!-- SNIPPET:hello_world_sample_async.get_config_setting -->\n\n```python\nfetched_config_setting = await client.get_configuration_setting(key=\"MyKey\", label=\"MyLabel\")\n```\n\n<!-- END SNIPPET -->\n\nTo list configuration settings, call `list_configuration_settings` operation synchronously and iterate over the returned async iterator asynchronously:\n\n<!-- SNIPPET:list_configuration_settings_sample_async.list_configuration_settings -->\n\n```python\nconfig_settings = client.list_configuration_settings(key_filter=\"MyKey*\", tags_filter=[\"my tag1=my tag1 value\"])\nasync for config_setting in config_settings:\n print(config_setting)\n```\n\n<!-- END SNIPPET -->\n\n## Troubleshooting\n\nSee the [troubleshooting guide][troubleshooting_guide] for details on how to diagnose various failure scenarios.\n\n## Next steps\n\n### More sample code\n\nSeveral App Configuration client library samples are available to you in this GitHub repository. These include:\n- [Hello world](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/hello_world_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/hello_world_sample_async.py)\n- [List configuration settings](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/list_configuration_settings_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/list_configuration_settings_sample_async.py)\n- [Make a configuration setting readonly](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/read_only_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/hello_world_sample_async.py)\n- [Read revision history](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/list_revision_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/list_revision_sample_async.py)\n- [Get a setting if changed](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/conditional_operation_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/conditional_operation_sample_async.py)\n- [Create, retrieve and update status of a configuration settings snapshot](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/snapshot_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/snapshot_sample_async.py)\n- [Send custom HTTP requests](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/send_request_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/send_request_sample_async.py)\n- [Update AzureAppConfigurationClient sync_token](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/sync_token_sample.py) / [Async version](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/sync_token_sample_async.py)\n\n For more details see the [samples README](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/samples/README.md).\n\n## Contributing\n\nThis project welcomes contributions and suggestions. Most contributions require\nyou to agree to a Contributor License Agreement (CLA) declaring that you have\nthe right to, and actually do, grant us the rights to use your contribution.\nFor details, visit https://cla.microsoft.com.\n\nWhen you submit a pull request, a CLA-bot will automatically determine whether\nyou need to provide a CLA and decorate the PR appropriately (e.g., label,\ncomment). Simply follow the instructions provided by the bot. You will only\nneed to do this once across all repos using our CLA.\n\nThis project has adopted the\n[Microsoft Open Source Code of Conduct][code_of_conduct]. For more information,\nsee the [Code of Conduct FAQ][coc_faq] or contact [opencode@microsoft.com][coc_contact] with any\nadditional questions or comments.\n\n<!-- LINKS -->\n[appconfig_docs]: https://docs.microsoft.com/azure/azure-app-configuration/\n[appconfig_rest]: https://github.com/Azure/AppConfiguration#rest-api-reference\n[azure_cli]: https://docs.microsoft.com/cli/azure\n[azure_sub]: https://azure.microsoft.com/free/\n[configuration_client_class]: https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_azure_appconfiguration_client.py\n[package]: https://pypi.org/project/azure-appconfiguration/\n[configuration_store]: https://azure.microsoft.com/services/app-configuration/\n[default_cred_ref]: https://aka.ms/azsdk-python-identity-default-cred-ref\n[azure_identity]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity\n[cla]: https://cla.microsoft.com\n[code_of_conduct]: https://opensource.microsoft.com/codeofconduct/\n[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/\n[coc_contact]: mailto:opencode@microsoft.com\n[troubleshooting_guide]: https://aka.ms/azsdk/python/appconfiguration/troubleshoot\n[label_concept]: https://docs.microsoft.com/azure/azure-app-configuration/concept-key-value#label-keys\n\n\n# Release History\n\n## 1.7.1 (2024-08-22)\n\n### Bugs Fixed\n- Fixed a bug in serializing/deserializing tags filter in `ConfigurationSnapshot`.\n\n## 1.7.0 (2024-08-15)\n\n### Features Added\n- Added operation `list_labels()` for listing configuration setting labels.\n- Supported filtering by configuration setting tags in `list_configuration_settings()` and `list_revisions()`.\n- Added a new property tags to ConfigurationSettingsFilter to support filtering settings with tags filter for snapshot.\n\n### Bugs Fixed\n- Fixed a bug where the `feature_id` of `FeatureFlagConfigurationSetting` will be different from `id` customer field, and may overwrite the original customer-defined value if different from the `FeatureFlagConfigurationSetting` key suffix.\n\n### Other Changes\n- Updated the default `api_version` to \"2023-11-01\".\n- Published enum `LabelFields` and model `ConfigurationSettingLabel`.\n- Published enum `SnapshotFields`, and accepted the type for `fields` parameter in `get_snapshot()` and `list_snapshots()`.\n- Published enum `ConfigurationSettingFields`, and accepted the type for `fields` parameter in `list_configuration_settings()` and `list_revisions()`.\n- Published enum `SnapshotComposition`, and accepted the type for `ConfigurationSnapshot` property `composition_type` and `begion_create_snapshot()` kwarg `composition_type`.\n\n## 1.6.0 (2024-04-09)\n\n### Features Added\n- Exposed `send_request()` method in each client to send custom requests using the client's existing pipeline.\n- Supported to get page ETag while iterating `list_configuration_setting()` result by page.\n\n### Bugs Fixed\n- Fixed a bug in consuming \"etag\" value in sync operation `set_configuration_setting()`.\n- Changed invalid default value `None` to `False` for property `enabled` in `FeatureFlagConfigurationSetting`.\n- Fixed the issue that `description`, `display_name` and other customer fields are missing when de/serializing `FeatureFlagConfigurationSetting` objects.\n\n## 1.6.0b2 (2024-03-21)\n\n### Bugs Fixed\n- Changed invalid default value `None` to `False` for property `enabled` in `FeatureFlagConfigurationSetting`.\n- Fixed the issue that `description`, `display_name` and other customer fields are missing when de/serializing `FeatureFlagConfigurationSetting` objects.\n\n## 1.6.0b1 (2024-03-14)\n\n### Features Added\n- Exposed `send_request()` method in each client to send custom requests using the client's existing pipeline.\n- Supported to get page ETag while iterating `list_configuration_setting()` result by page.\n\n### Bugs Fixed\n- Fixed a bug in consuming \"etag\" value in sync operation `set_configuration_setting()`.\n\n## 1.5.0 (2023-11-09)\n\n### Other Changes\n- Supported datetime type for keyword argument `accept_datetime` in `get_snapshot_configuration_settings()`, `list_snapshot_configuration_settings()` and `list_revisions()`.\n- Bumped minimum dependency on `azure-core` to `>=1.28.0`.\n- Updated the default `api_version` to \"2023-10-01\".\n- Removed `etag` keyword documentation in `set_read_only()` as it's not in use.\n- Added support for Python 3.12.\n- Python 3.7 is no longer supported. Please use Python version 3.8 or later.\n\n## 1.5.0b3 (2023-10-10)\n\n### Breaking Changes\n- Renamed parameter `name` in `list_snapshot_configuration_settings()` to `snapshot_name`.\n- Removed keyword argument `accept_datetime` in `list_snapshot_configuration_settings()`.\n- Moved operation `list_snapshot_configuration_settings()` to an overload of `list_configuration_settings()`, and moved the parameter `snapshot_name` to keyword.\n- Published enum `SnapshotStatus`, and accepted the type for `status` parameter in `list_snapshots()` and `status` property in `Snapshot` model.\n- Renamed model `Snapshot` to `ConfigurationSnapshot`.\n- Renamed model `ConfigurationSettingFilter` to `ConfigurationSettingsFilter`.\n\n## 1.5.0b2 (2023-08-02)\n\n### Bugs Fixed\n- Fixed a bug in deserializing and serializing Snapshot when `filters` property is `None`.\n- Fixed a bug when creating `FeatureFlagConfigurationSetting` from SDK but having an error in portal.([#31326](https://github.com/Azure/azure-sdk-for-python/issues/31326))\n\n## 1.5.0b1 (2023-07-11)\n\n### Features Added\n- Added support for `Snapshot` CRUD operations.\n\n### Bugs Fixed\n- Fixed async `update_sync_token()` to use async/await keywords.\n\n### Other Changes\n- Bumped minimum dependency on `azure-core` to `>=1.25.0`.\n- Updated the default `api_version` to \"2022-11-01-preview\".\n\n## 1.4.0 (2022-02-13)\n\n### Other Changes\n- Python 2.7 is no longer supported. Please use Python version 3.7 or later.\n- Bumped minimum dependency on `azure-core` to `>=1.24.0`.\n- Changed the default async transport from `AsyncioRequestsTransport` to the one used in current `azure-core` (`AioHttpTransport`). ([#26427](https://github.com/Azure/azure-sdk-for-python/issues/26427))\n- Dropped `msrest` requirement.\n- Added dependency `isodate` with version range `>=0.6.0`.\n\n## 1.3.0 (2021-11-10)\n\n### Bugs Fixed\n- Fixed the issue that data was persisted according to an incorrect schema/in an incorrect format ([#20518](https://github.com/Azure/azure-sdk-for-python/issues/20518))\n\n `SecretReferenceConfigurationSetting` in 1.2.0 used \"secret_uri\" rather than \"uri\" as the schema keywords which \n broken inter-operation of `SecretReferenceConfigurationSetting` between SDK and the portal. \n \n Please:\n - Use 1.3.0+ for any `SecretReferenceConfigurationSetting` uses.\n - Call a get method for existing `SecretReferenceConfigurationSetting`s and set them back to correct the format.\n\n## 1.2.0 (2021-07-06)\n### Features Added\n* Added `FeatureFlagConfigurationSetting` and `SecretReferenceConfigurationSetting` models\n* `AzureAppConfigurationClient` can now be used as a context manager.\n* Added `update_sync_token()` to update sync tokens from Event Grid notifications.\n\n## 1.2.0b2 (2021-06-08)\n\n### Features\n- Added context manager functionality to the sync and async `AzureAppConfigurationClient`s.\n\n### Fixes\n- Fixed a deserialization bug for `FeatureFlagConfigurationSetting` and `SecretReferenceConfigurationSetting`.\n\n## 1.2.0b1 (2021-04-06)\n\n### Features\n\n- Added method `update_sync_token()` to include sync tokens from EventGrid notifications.\n- Added `SecretReferenceConfigurationSetting` type to represent a configuration setting that references a KeyVault Secret.\n- Added `FeatureFlagConfigurationSetting` type to represent a configuration setting that controls a feature flag.\n\n## 1.1.1 (2020-10-05)\n\n### Features\n\n- Improved error message if Connection string secret has incorrect padding. ([#14140](https://github.com/Azure/azure-sdk-for-python/issues/14140))\n\n## 1.1.0 (2020-09-08)\n\n### Features\n\n- Added match condition support for `set_read_only()` method. ([#13276](https://github.com/Azure/azure-sdk-for-python/issues/13276))\n\n## 1.0.1 (2020-08-10)\n\n### Fixes\n\n- Doc & Sample fixes\n\n## 1.0.0 (2020-01-06)\n\n### Features\n\n- Added AAD auth support. ([#8924](https://github.com/Azure/azure-sdk-for-python/issues/8924))\n\n### Breaking changes\n\n- `list_configuration_settings()` & `list_revisions()` now take string key/label filter instead of keys/labels list. ([#9066](https://github.com/Azure/azure-sdk-for-python/issues/9066))\n\n## 1.0.0b6 (2019-12-03)\n\n### Features\n\n- Added sync-token support. ([#8418](https://github.com/Azure/azure-sdk-for-python/issues/8418))\n\n### Breaking changes\n\n- Combined set_read_only & clear_read_only to be set_read_only(True/False). ([#8453](https://github.com/Azure/azure-sdk-for-python/issues/8453))\n\n## 1.0.0b5 (2019-10-30)\n\n### Breaking changes\n\n- `etag` and `match_condition` of `delete_configuration_setting()` are now keyword argument only. ([#8161](https://github.com/Azure/azure-sdk-for-python/issues/8161))\n\n## 1.0.0b4 (2019-10-07)\n\n- Added conditional operation support\n- Added `set_read_only()` and `clear_read_only()` methods\n\n## 1.0.0b3 (2019-09-09)\n\n- New azure app configuration\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Microsoft App Configuration Data Library for Python",
"version": "1.7.1",
"project_urls": {
"Homepage": "https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/appconfiguration/azure-appconfiguration"
},
"split_keywords": [
"azure",
" azure sdk"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "fa6fe4d2645a70a2e19c23e47350737e7f6d44bc883666c9099c79fb775a4e10",
"md5": "1a1bbca417147d4c6bd5926ea7806d2a",
"sha256": "6e62b040a0210071be4423aafbdca3b053884c0d412855e3f8eff8e8d0b1a02b"
},
"downloads": -1,
"filename": "azure_appconfiguration-1.7.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1a1bbca417147d4c6bd5926ea7806d2a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 90971,
"upload_time": "2024-08-23T02:50:39",
"upload_time_iso_8601": "2024-08-23T02:50:39.495654Z",
"url": "https://files.pythonhosted.org/packages/fa/6f/e4d2645a70a2e19c23e47350737e7f6d44bc883666c9099c79fb775a4e10/azure_appconfiguration-1.7.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2cffcd3804d1aa1789f393a3174ca2b701edf7f0092c615ab384fd065afd4433",
"md5": "f9054e3e3d9361b36ec46af66489a6cd",
"sha256": "3ebe41e9be3f4ae6ca61e5dbc42c4b7cc007a01054a8506501a26dfc199fd3ec"
},
"downloads": -1,
"filename": "azure-appconfiguration-1.7.1.tar.gz",
"has_sig": false,
"md5_digest": "f9054e3e3d9361b36ec46af66489a6cd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 113698,
"upload_time": "2024-08-23T02:50:37",
"upload_time_iso_8601": "2024-08-23T02:50:37.192581Z",
"url": "https://files.pythonhosted.org/packages/2c/ff/cd3804d1aa1789f393a3174ca2b701edf7f0092c615ab384fd065afd4433/azure-appconfiguration-1.7.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-23 02:50:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Azure",
"github_project": "azure-sdk-for-python",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "azure-appconfiguration"
}
JSON
