[SDK Release] (Python) CQA authoring 2025-05-15-preview #43117

Amichelangelo · 2025-09-24T14:23:17Z

Description

Please add an informative description that covers that changes made by the pull request and link all relevant issues.

If an SDK is being regenerated based on a new API spec, a link to the pull request containing these API spec changes should be included above.

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.

…ering-authoring package (packaging, samples, tests, migration guide) Summary: Packaging & metadata: Added sdk_packaging.toml (python_min=3.9; deps: azure-core, isodate, conditional typing-extensions) Added setup.py aligned with sdk_packaging.toml Preserved/added pyproject.toml (generator structure) Added initial CHANGELOG.md (1.0.0b1 draft) Rewrote README.md to focus exclusively on authoring features Added migration_guide_authoring.md (split rationale & upgrade steps) Added dev_requirements.txt (devtools_testutils, pytest, pytest-asyncio, aiohttp) Samples: Added sync samples: sample_create_and_deploy_project.py, sample_export_import_project.py, sample_update_knowledge_sources.py Added async counterparts under samples/authoring/async_samples/ Added README.md (authoring-only guidance) Tests: Added trimmed conftest.py (reduced env vars + essential sanitizers) Added testcase.py (QuestionAnsweringAuthoringTestCase with playback polling_interval=0) Added helpers.py (AuthoringTestHelper + AuthoringAsyncTestHelper) Added sync tests: test_create_and_deploy_project.py, test_export_import_project.py, test_update_knowledge_sources.py Added async tests: test_create_and_deploy_project_async.py, test_export_import_project_async.py, test_update_knowledge_sources_async.py Consistency & cleanup: Client renamed to QuestionAnsweringAuthoringClient (+ aio variant) Unified project name spelling to IsaacNewton Removed runtime query samples/tests (authoring-only scope) Simplified helper logic and removed unused parameters Deferred assets.json (not required until live resource orchestration is needed) Future follow-ups (not included in this commit): TypeSpec recompile & regeneration validation Optional AAD TokenCredential test coverage Potential runtime package split / publication Live test infra (assets.json) if/when enabled BREAKING CHANGE: Users of authoring functionality must install the new package and replace AuthoringClient with QuestionAnsweringAuthoringClient (import namespace remains in the authoring subtree).

github-actions · 2025-09-24T16:02:19Z

API Change Check

APIView identified API level changes in this PR and created the following API reviews

azure-ai-language-questionanswering-authoring

Amichelangelo · 2025-09-25T15:37:14Z

/azp run python - cognitivelanguage

azure-pipelines · 2025-09-25T15:37:48Z

Azure Pipelines successfully started running 1 pipeline(s).

…azure-sdk-for-python into qiyin/sdk-cqa-python-beta

Copilot

Pull Request Overview

This PR introduces a new Python SDK for Azure AI Language Question Answering Authoring, implementing the 2025-05-15-preview API version. This is a new authoring-only package that splits from the previous combined package to provide focused functionality for project management operations.

Key Changes

New SDK package: azure-ai-language-questionanswering-authoring
Complete client implementation with sync/async support for authoring operations
Comprehensive test coverage for project creation, deployment, export/import, and knowledge source management

Reviewed Changes

Copilot reviewed 57 out of 59 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tsp-location.yaml	API specification reference configuration
setup.py	Package setup and dependency configuration
_client.py & aio/_client.py	Main client implementations for sync/async operations
models/	Generated model classes and enums for API data structures
tests/	Comprehensive test suite covering all major operations
samples/	Example code demonstrating SDK usage patterns

...e-questionanswering-authoring/azure/ai/language/questionanswering/authoring/models/_enums.py

...questionanswering-authoring/azure/ai/language/questionanswering/authoring/models/__init__.py

sarkar-rajarshi

looking good. few small comments

...stionanswering-authoring/azure/ai/language/questionanswering/authoring/_operations/_patch.py

...cognitivelanguage/azure-ai-language-questionanswering-authoring/migration_guide_authoring.md

...answering-authoring/azure/ai/language/questionanswering/authoring/_operations/_operations.py

sdk/cognitivelanguage/azure-ai-language-questionanswering-authoring/README.md

...nguage-questionanswering-authoring/azure/ai/language/questionanswering/authoring/__init__.py

...cognitivelanguage/azure-ai-language-questionanswering-authoring/migration_guide_authoring.md

2. import -> begin_import_assets 3. format -> file_format

Amichelangelo · 2025-11-06T05:57:14Z

/azp run python - cognitivelanguage

azure-pipelines · 2025-11-06T05:57:42Z

Azure Pipelines successfully started running 1 pipeline(s).

...cognitivelanguage/azure-ai-language-questionanswering-authoring/migration_guide_authoring.md

...stionanswering-authoring/azure/ai/language/questionanswering/authoring/_operations/_patch.py

sdk/cognitivelanguage/azure-ai-language-questionanswering-authoring/pyproject.toml

Amichelangelo · 2025-11-13T12:26:18Z

/azp run python - cognitivelanguage

azure-pipelines · 2025-11-13T12:26:56Z

Azure Pipelines will not run the associated pipelines, because the pull request was updated after the run command was issued. Review the pull request again and issue a new run command.

…into qiyin/sdk-cqa-python-beta

Amichelangelo · 2025-11-13T12:31:09Z

/azp run python - cognitivelanguage

azure-pipelines · 2025-11-13T12:32:27Z

Azure Pipelines successfully started running 1 pipeline(s).

…into qiyin/sdk-cqa-python-beta

sarkar-rajarshi · 2025-11-13T18:13:07Z

/azp run python - cognitivelanguage

azure-pipelines · 2025-11-13T18:13:39Z

Azure Pipelines successfully started running 1 pipeline(s).

* generated code * feat(authoring): initialize standalone azure-ai-language-questionanswering-authoring package (packaging, samples, tests, migration guide) Summary: Packaging & metadata: Added sdk_packaging.toml (python_min=3.9; deps: azure-core, isodate, conditional typing-extensions) Added setup.py aligned with sdk_packaging.toml Preserved/added pyproject.toml (generator structure) Added initial CHANGELOG.md (1.0.0b1 draft) Rewrote README.md to focus exclusively on authoring features Added migration_guide_authoring.md (split rationale & upgrade steps) Added dev_requirements.txt (devtools_testutils, pytest, pytest-asyncio, aiohttp) Samples: Added sync samples: sample_create_and_deploy_project.py, sample_export_import_project.py, sample_update_knowledge_sources.py Added async counterparts under samples/authoring/async_samples/ Added README.md (authoring-only guidance) Tests: Added trimmed conftest.py (reduced env vars + essential sanitizers) Added testcase.py (QuestionAnsweringAuthoringTestCase with playback polling_interval=0) Added helpers.py (AuthoringTestHelper + AuthoringAsyncTestHelper) Added sync tests: test_create_and_deploy_project.py, test_export_import_project.py, test_update_knowledge_sources.py Added async tests: test_create_and_deploy_project_async.py, test_export_import_project_async.py, test_update_knowledge_sources_async.py Consistency & cleanup: Client renamed to QuestionAnsweringAuthoringClient (+ aio variant) Unified project name spelling to IsaacNewton Removed runtime query samples/tests (authoring-only scope) Simplified helper logic and removed unused parameters Deferred assets.json (not required until live resource orchestration is needed) Future follow-ups (not included in this commit): TypeSpec recompile & regeneration validation Optional AAD TokenCredential test coverage Potential runtime package split / publication Live test infra (assets.json) if/when enabled BREAKING CHANGE: Users of authoring functionality must install the new package and replace AuthoringClient with QuestionAnsweringAuthoringClient (import namespace remains in the authoring subtree). * update setup file * update import path in test files * update tests, samples, readme * migrating test recordings out of the azure-sdk-for-python repository * update cspell * fix host mismatch * update readme and remove generated code * update sample readme * 1. QuestionAnsweringProjectMetadate -> QuestionAnsweringProject 2. import -> begin_import_assets 3. format -> file_format * rename begin_import_method in samples * update * fix comments, get-> list, add overload * apiview changes * fix circle import issue * fix broken link * add type ignore * analyze iuuse * update get_[operation]_status to private add dependency on azure-ai-language-questionanswering * update * update * update assest * update the dependencies * fix cspell * add azure-ai-language-questionanswering to shared_requirements.txt * move down the pylint tag * move down the pylint tag --------- Co-authored-by: Qi Yin <v-qiyin1@microsoft.com> Co-authored-by: Rajarshi Sarkar <73562869+sarkar-rajarshi@users.noreply.github.com>

Qi-2077 added 2 commits September 24, 2025 18:22

generated code

ed0994b

github-actions bot added the Cognitive - Language label Sep 24, 2025

Qi-2077 added 2 commits September 24, 2025 23:27

update setup file

eafd591

update import path in test files

e360f73

Qi-2077 added 2 commits September 25, 2025 23:20

update tests, samples, readme

d02b409

migrating test recordings out of the azure-sdk-for-python repository

fcb634e

Qi-2077 added 4 commits September 26, 2025 18:12

update cspell

e4c2f0f

fix host mismatch

862631d

Merge branch 'qiyin/sdk-cqa-python-beta' of https://github.com/Azure/…

3949428

…azure-sdk-for-python into qiyin/sdk-cqa-python-beta

update readme and remove generated code

f482e37

Amichelangelo marked this pull request as ready for review September 28, 2025 09:54

Amichelangelo requested review from benbp, mccoyp, quentinRobinson, scbedd and weshaggard as code owners September 28, 2025 09:54

Copilot AI review requested due to automatic review settings September 28, 2025 09:54

Copilot AI reviewed Sep 28, 2025

View reviewed changes

update sample readme

2661b06

sarkar-rajarshi reviewed Sep 29, 2025

View reviewed changes

Qi-2077 and others added 6 commits October 13, 2025 12:30

1. QuestionAnsweringProjectMetadate -> QuestionAnsweringProject

34b9cab

2. import -> begin_import_assets 3. format -> file_format

rename begin_import_method in samples

ba9bdf6

update

4d7592f

fix comments, get-> list, add overload

afb0270

apiview changes

27f46d1

fix circle import issue

89f1e33

Qi-2077 added 2 commits November 3, 2025 16:49

update

bf0e0ea

update

1e80bff

annatisch approved these changes Nov 7, 2025

View reviewed changes

...cognitivelanguage/azure-ai-language-questionanswering-authoring/migration_guide_authoring.md Show resolved Hide resolved

...stionanswering-authoring/azure/ai/language/questionanswering/authoring/_operations/_patch.py Show resolved Hide resolved

update assest

d262c9c

sarkar-rajarshi reviewed Nov 13, 2025

View reviewed changes

sdk/cognitivelanguage/azure-ai-language-questionanswering-authoring/pyproject.toml Outdated Show resolved Hide resolved

update the dependencies

6f496f6

Amichelangelo requested review from ahmedaashour, bidisha-c and mikaelsitruk as code owners November 13, 2025 10:00

Merge branch 'main' of https://github.com/Azure/azure-sdk-for-python …

29bd056

…into qiyin/sdk-cqa-python-beta

Qi-2077 added 6 commits November 13, 2025 20:49

fix cspell

3f36d8a

Merge branch 'main' of https://github.com/Azure/azure-sdk-for-python …

40bcfe4

…into qiyin/sdk-cqa-python-beta

Merge branch 'main' of https://github.com/Azure/azure-sdk-for-python …

edec273

…into qiyin/sdk-cqa-python-beta

add azure-ai-language-questionanswering to shared_requirements.txt

19097b4

move down the pylint tag

1d832b8

move down the pylint tag

122ede7

sarkar-rajarshi approved these changes Nov 14, 2025

View reviewed changes

Merge branch 'main' into qiyin/sdk-cqa-python-beta

0cf9df5

weshaggard approved these changes Nov 14, 2025

View reviewed changes

Amichelangelo merged commit acbf01f into main Nov 14, 2025
23 checks passed

Amichelangelo deleted the qiyin/sdk-cqa-python-beta branch November 14, 2025 16:57

[SDK Release] (Python) CQA authoring 2025-05-15-preview #43117

[SDK Release] (Python) CQA authoring 2025-05-15-preview #43117

Uh oh!

Conversation

Amichelangelo commented Sep 24, 2025

Description

All SDK Contribution checklist:

General Guidelines and Best Practices

Testing Guidelines

Uh oh!

github-actions bot commented Sep 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

API Change Check

Uh oh!

Amichelangelo commented Sep 25, 2025

Uh oh!

azure-pipelines bot commented Sep 25, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Key Changes

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

sarkar-rajarshi left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Amichelangelo commented Nov 6, 2025

Uh oh!

azure-pipelines bot commented Nov 6, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Amichelangelo commented Nov 13, 2025

Uh oh!

azure-pipelines bot commented Nov 13, 2025

Uh oh!

Amichelangelo commented Nov 13, 2025

Uh oh!

azure-pipelines bot commented Nov 13, 2025

Uh oh!

sarkar-rajarshi commented Nov 13, 2025

Uh oh!

azure-pipelines bot commented Nov 13, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

github-actions bot commented Sep 24, 2025 •

edited

Loading