Skip to content

App Configuration - Description API#47332

Open
mrm9084 wants to merge 3 commits into
Azure:mainfrom
mrm9084:Description
Open

App Configuration - Description API#47332
mrm9084 wants to merge 3 commits into
Azure:mainfrom
mrm9084:Description

Conversation

@mrm9084
Copy link
Copy Markdown
Member

@mrm9084 mrm9084 commented Jun 3, 2026

Description

  • Adds support for the new API version that adds description to ConfigurationSettings and Snapshots
  • Fixes a flaxy Snapshot test.

All SDK Contribution checklist:

  • The pull request does not introduce [breaking changes]
  • CHANGELOG is updated for new features, bug fixes or other significant changes.
  • I have read the contribution guidelines.

General Guidelines and Best Practices

  • Title of the pull request is clear and informative.
  • There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, see this page.

Testing Guidelines

  • Pull request includes test coverage for the included changes.

Copilot AI review requested due to automatic review settings June 3, 2026 23:45
@github-actions github-actions Bot added the App Configuration Azure.ApplicationModel.Configuration label Jun 3, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds support for the App Configuration 2026-04-01 API surface that introduces description on key-values and snapshots, and updates tests to validate round-tripping and reduce snapshot-list flakiness.

Changes:

  • Introduces description on ConfigurationSetting, SecretReferenceConfigurationSetting, and ConfigurationSnapshot, and wires description into snapshot creation.
  • Regenerates the generated client/models for API version 2026-04-01 and updates metadata/assets/apiview properties accordingly.
  • Updates tests to validate description behavior and makes snapshot listing tests less flaky by asserting presence vs absolute counts.

Reviewed changes

Copilot reviewed 22 out of 22 changed files in this pull request and generated 7 comments.

Show a summary per file
File Description
sdk/appconfiguration/azure-appconfiguration/tsp-location.yaml Updates the swagger/spec commit reference used for generation.
sdk/appconfiguration/azure-appconfiguration/tests/testcase.py Extends test assertions to include description for settings and snapshots.
sdk/appconfiguration/azure-appconfiguration/tests/test_consistency.py Adds unit tests covering default/round-trip behavior of description and FF/SR edge behavior.
sdk/appconfiguration/azure-appconfiguration/tests/test_azure_appconfiguration_client.py Reduces flakiness by asserting created snapshots appear in results rather than asserting absolute counts.
sdk/appconfiguration/azure-appconfiguration/tests/test_azure_appconfiguration_client_async.py Async equivalent of snapshot listing flakiness fix.
sdk/appconfiguration/azure-appconfiguration/pyproject.toml Updates package classifiers (currently marking package as Beta).
sdk/appconfiguration/azure-appconfiguration/CHANGELOG.md Documents new description support on settings and snapshots.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/aio/_azure_appconfiguration_client_async.py Adds description argument to async begin_create_snapshot; adds pylint disable header.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_models.py Adds description to public models and maps to/from generated models.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_generated/models/_patch.py Updates patched generated model typing/docs to include description on KeyValue.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_generated/models/_models.py Updates generated models/envelopes to include description on KeyValue and Snapshot.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_generated/models/_enums.py Adds DESCRIPTION field selectors for settings and snapshots.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_generated/aio/_operations/_operations.py Extends supported API versions list to include 2026-04-01 for relevant ops.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_generated/aio/_configuration.py Updates generated async config default API version/documentation to 2026-04-01.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_generated/aio/_client.py Updates generated async client documentation to reference 2026-04-01.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_generated/_operations/_operations.py Updates default api-version used by request builders to 2026-04-01 and extends supported versions list.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_generated/_configuration.py Updates generated config default API version/documentation to 2026-04-01.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_generated/_client.py Updates generated client documentation to reference 2026-04-01.
sdk/appconfiguration/azure-appconfiguration/azure/appconfiguration/_azure_appconfiguration_client.py Adds description argument to sync begin_create_snapshot; adds pylint disable header.
sdk/appconfiguration/azure-appconfiguration/assets.json Updates the recorded assets tag.
sdk/appconfiguration/azure-appconfiguration/apiview-properties.json Updates CrossLanguageVersion.
sdk/appconfiguration/azure-appconfiguration/_metadata.json Updates tracked API version metadata to 2026-04-01.

Comment thread sdk/appconfiguration/azure-appconfiguration/pyproject.toml
Comment thread sdk/appconfiguration/azure-appconfiguration/pyproject.toml
- Added `check_configuration_settings()` method to efficiently check for configuration changes using HEAD requests, returning only headers (ETags) without response bodies.
- `list_configuration_settings()` and `check_configuration_settings()` now return `ConfigurationSettingPaged` (sync) / `ConfigurationSettingPagedAsync` (async) to expose the `by_page(match_conditions=...)` API and per-page `etag` attribute for change detection.
- `ConfigurationSettingPaged` and `ConfigurationSettingPagedAsync` are now publicly exported from `azure.appconfiguration`.
- Added a `description` property to `ConfigurationSetting` and `SecretReferenceConfigurationSetting` representing the description of the key-value (requires API version `2026-04-01` or later).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does python SDK have default SDK version like .NET?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All of them do, it's a kwarg that you can pass in and defaults to the latest one if not provided.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

App Configuration Azure.ApplicationModel.Configuration

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants