[Document] Py sdk 2026-05-15-preview#46405
Draft
amber-Chen-86 wants to merge 9 commits into
Draft
Conversation
…nalyzeDocuments/tspconfig.yaml', API Version: 2026-05-15-preview, SDK Release Type: beta, and CommitSHA: '0295acbed05cf1cb9f92f7307e2a049e8d7058cd' in SpecRepo: 'https://github.com/Azure/azure-rest-api-specs' Pipeline run: https://dev.azure.com/azure-sdk/internal/_build/results?buildId=6179116 Refer to https://eng.ms/docs/products/azure-developer-experience/develop/sdk-release/sdk-release-prerequisites to prepare for SDK release.
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new azure-ai-language-documents Python SDK package under sdk/cognitivelanguage (targeting the 2026-05-15-preview API), and wires it into the service directory CI.
Changes:
- Registers
azure-ai-language-documentsas a CI artifact forsdk/cognitivelanguage. - Introduces a new generated client library (sync + async) with models, operations, and packaging metadata.
- Adds generated samples and a generated (currently skipped) test scaffold.
Reviewed changes
Copilot reviewed 43 out of 43 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| sdk/cognitivelanguage/ci.yml | Adds azure-ai-language-documents to CI artifacts list. |
| sdk/cognitivelanguage/azure-ai-language-documents/tsp-location.yaml | Tracks the TypeSpec source location and commit. |
| sdk/cognitivelanguage/azure-ai-language-documents/pyproject.toml | Defines package metadata, dependencies, and packaging discovery config. |
| sdk/cognitivelanguage/azure-ai-language-documents/dev_requirements.txt | Dev-time requirements for local development/testing. |
| sdk/cognitivelanguage/azure-ai-language-documents/README.md | Package README with auth guidance and usage examples. |
| sdk/cognitivelanguage/azure-ai-language-documents/CHANGELOG.md | Initial changelog entry for 1.0.0b1. |
| sdk/cognitivelanguage/azure-ai-language-documents/LICENSE | MIT license text. |
| sdk/cognitivelanguage/azure-ai-language-documents/MANIFEST.in | Packaging manifest for sdist contents. |
| sdk/cognitivelanguage/azure-ai-language-documents/_metadata.json | Generator metadata (api version, spec commit, emitter version). |
| sdk/cognitivelanguage/azure-ai-language-documents/apiview-properties.json | APIView cross-language mapping metadata. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/init.py | Namespace package root. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/init.py | Namespace package root. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/init.py | Namespace package root for azure.ai.language. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/init.py | Public package entrypoint exporting the client + version. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/_version.py | Defines package version constant. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/_client.py | Sync client implementation. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/_configuration.py | Sync client configuration (policies, auth policy inference). |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/_patch.py | Customization hook for generated code. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/_operations/init.py | Operations package init and patch hook wiring. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/_operations/_patch.py | Customization hook for operations. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/_operations/_operations.py | Sync operations and request builders. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/aio/init.py | Async package entrypoint exporting async client. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/aio/_client.py | Async client implementation. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/aio/_configuration.py | Async client configuration (policies, auth policy inference). |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/aio/_patch.py | Customization hook for async generated code. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/aio/_operations/init.py | Async operations package init and patch hook wiring. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/aio/_operations/_patch.py | Customization hook for async operations. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/aio/_operations/_operations.py | Async operations and request builders. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/models/init.py | Models package init exporting generated models/enums. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/models/_patch.py | Customization hook for models. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/models/_enums.py | Generated enums. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/models/_models.py | Generated models used by the client/operations. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/_utils/init.py | Internal utils package marker. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/_utils/utils.py | Internal typing mixin used by generated client/ops. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/_utils/model_base.py | Generated serialization/deserialization + base Model implementation. |
| sdk/cognitivelanguage/azure-ai-language-documents/azure/ai/language/documents/py.typed | PEP 561 typing marker. |
| sdk/cognitivelanguage/azure-ai-language-documents/generated_tests/conftest.py | Test-proxy sanitizers and environment handling for generated tests. |
| sdk/cognitivelanguage/azure-ai-language-documents/generated_tests/testpreparer.py | Sync test base + PowerShell preparer wrapper. |
| sdk/cognitivelanguage/azure-ai-language-documents/generated_tests/testpreparer_async.py | Async test base. |
| sdk/cognitivelanguage/azure-ai-language-documents/generated_tests/test_analyze_documents.py | Generated sync tests (currently skipped). |
| sdk/cognitivelanguage/azure-ai-language-documents/generated_tests/test_analyze_documents_async.py | Generated async tests (currently skipped). |
| sdk/cognitivelanguage/azure-ai-language-documents/generated_samples/successful_analyze_documents_jobs_task_submit_request.py | Generated sample for submitting an analyze-documents job. |
| sdk/cognitivelanguage/azure-ai-language-documents/generated_samples/successful_analyze_documents_jobs_cancel_request.py | Generated sample for cancelling a job. |
| sdk/cognitivelanguage/azure-ai-language-documents/generated_samples/successful_analyze_documents_job_status_task_status_request.py | Generated sample for getting job status. |
Member
Author
|
All the check failures are caused by other packages in cognitive service, not related to this PR. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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:
General Guidelines and Best Practices
Testing Guidelines