Skip to content

[Document] Py sdk 2026-05-15-preview#46405

Draft
amber-Chen-86 wants to merge 9 commits into
Azure:mainfrom
amber-Chen-86:v-amber/document-pysdk-2026-05-15-preview
Draft

[Document] Py sdk 2026-05-15-preview#46405
amber-Chen-86 wants to merge 9 commits into
Azure:mainfrom
amber-Chen-86:v-amber/document-pysdk-2026-05-15-preview

Conversation

@amber-Chen-86
Copy link
Copy Markdown
Member

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.

azure-sdk and others added 2 commits April 20, 2026 06:37
…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.
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 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-documents as a CI artifact for sdk/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.

Comment thread sdk/cognitivelanguage/azure-ai-language-documents/dev_requirements.txt Outdated
Comment thread sdk/cognitivelanguage/azure-ai-language-documents/pyproject.toml
Comment thread sdk/cognitivelanguage/azure-ai-language-documents/README.md Outdated
@amber-Chen-86
Copy link
Copy Markdown
Member Author

All the check failures are caused by other packages in cognitive service, not related to this PR.

@amber-Chen-86 amber-Chen-86 marked this pull request as draft April 21, 2026 07:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants