Azure · chienyuanchang · Nov 17, 2025 · Nov 17, 2025 · Nov 17, 2025 · Nov 17, 2025
@@ -0,0 +1,28 @@
+# Sample and test output files (any directory starting with these names)
+**/test_output*/
+**/sample_output*/
+
+# Virtual environment
+.venv/
+
+# Python cache
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+
+# IDE
+.vscode/
+.idea/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+tests/recordings/
+
+# Environment variables
+.env
+
+.local_only/
@@ -0,0 +1,13 @@
+# Release History
+
+## 1.0.0b1 (Unreleased)
+
+### Features Added
+- Initial release of Azure AI Content Understanding client library for Python
+- Added `ContentUnderstandingClient` for analyzing documents, audio, and video content
+
+### Breaking Changes
+
+### Bugs Fixed
+
+### Other Changes
@@ -0,0 +1,21 @@
+Copyright (c) Microsoft Corporation.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
@@ -0,0 +1,7 @@
+include *.md
+include LICENSE
+include azure/ai/contentunderstanding/py.typed
+recursive-include tests *.py
+recursive-include samples *.py *.md
+include azure/__init__.py
+include azure/ai/__init__.py
@@ -0,0 +1,3 @@
+{
+  "apiVersion": "2025-11-01"
+}
@@ -0,0 +1,99 @@
+{
+    "CrossLanguagePackageId": "ContentUnderstanding",
+    "CrossLanguageDefinitionId": {
+        "azure.ai.contentunderstanding.models.AnalyzeInput": "ContentUnderstanding.AnalyzeInput",
+        "azure.ai.contentunderstanding.models.AnalyzeResult": "ContentUnderstanding.AnalyzeResult",
+        "azure.ai.contentunderstanding.models.ContentField": "ContentUnderstanding.ContentField",
+        "azure.ai.contentunderstanding.models.ArrayField": "ContentUnderstanding.ArrayField",
+        "azure.ai.contentunderstanding.models.MediaContent": "ContentUnderstanding.MediaContent",
+        "azure.ai.contentunderstanding.models.AudioVisualContent": "ContentUnderstanding.AudioVisualContent",
+        "azure.ai.contentunderstanding.models.AudioVisualContentSegment": "ContentUnderstanding.AudioVisualContentSegment",
+        "azure.ai.contentunderstanding.models.BooleanField": "ContentUnderstanding.BooleanField",
+        "azure.ai.contentunderstanding.models.ContentAnalyzer": "ContentUnderstanding.ContentAnalyzer",
+        "azure.ai.contentunderstanding.models.ContentAnalyzerAnalyzeOperationStatus": "ContentUnderstanding.ContentAnalyzerAnalyzeOperationStatus",
+        "azure.ai.contentunderstanding.models.ContentAnalyzerConfig": "ContentUnderstanding.ContentAnalyzerConfig",
+        "azure.ai.contentunderstanding.models.ContentAnalyzerOperationStatus": "ContentUnderstanding.ContentAnalyzerOperationStatus",
+        "azure.ai.contentunderstanding.models.ContentCategoryDefinition": "ContentUnderstanding.ContentCategoryDefinition",
+        "azure.ai.contentunderstanding.models.ContentFieldDefinition": "ContentUnderstanding.ContentFieldDefinition",
+        "azure.ai.contentunderstanding.models.ContentFieldSchema": "ContentUnderstanding.FieldSchema",
+        "azure.ai.contentunderstanding.models.ContentSpan": "ContentUnderstanding.ContentSpan",
+        "azure.ai.contentunderstanding.models.ContentUnderstandingDefaults": "ContentUnderstanding.ContentUnderstandingDefaults",
+        "azure.ai.contentunderstanding.models.CopyAuthorization": "ContentUnderstanding.CopyAuthorization",
+        "azure.ai.contentunderstanding.models.DateField": "ContentUnderstanding.DateField",
+        "azure.ai.contentunderstanding.models.DocumentAnnotation": "ContentUnderstanding.DocumentAnnotation",
+        "azure.ai.contentunderstanding.models.DocumentAnnotationComment": "ContentUnderstanding.DocumentAnnotationComment",
+        "azure.ai.contentunderstanding.models.DocumentBarcode": "ContentUnderstanding.DocumentBarcode",
+        "azure.ai.contentunderstanding.models.DocumentCaption": "ContentUnderstanding.DocumentCaption",
+        "azure.ai.contentunderstanding.models.DocumentFigure": "ContentUnderstanding.DocumentFigure",
+        "azure.ai.contentunderstanding.models.DocumentChartFigure": "ContentUnderstanding.DocumentChartFigure",
+        "azure.ai.contentunderstanding.models.DocumentContent": "ContentUnderstanding.DocumentContent",
+        "azure.ai.contentunderstanding.models.DocumentContentSegment": "ContentUnderstanding.DocumentContentSegment",
+        "azure.ai.contentunderstanding.models.DocumentFootnote": "ContentUnderstanding.DocumentFootnote",
+        "azure.ai.contentunderstanding.models.DocumentFormula": "ContentUnderstanding.DocumentFormula",
+        "azure.ai.contentunderstanding.models.DocumentHyperlink": "ContentUnderstanding.DocumentHyperlink",
+        "azure.ai.contentunderstanding.models.DocumentLine": "ContentUnderstanding.DocumentLine",
+        "azure.ai.contentunderstanding.models.DocumentMermaidFigure": "ContentUnderstanding.DocumentMermaidFigure",
+        "azure.ai.contentunderstanding.models.DocumentPage": "ContentUnderstanding.DocumentPage",
+        "azure.ai.contentunderstanding.models.DocumentParagraph": "ContentUnderstanding.DocumentParagraph",
+        "azure.ai.contentunderstanding.models.DocumentSection": "ContentUnderstanding.DocumentSection",
+        "azure.ai.contentunderstanding.models.DocumentTable": "ContentUnderstanding.DocumentTable",
+        "azure.ai.contentunderstanding.models.DocumentTableCell": "ContentUnderstanding.DocumentTableCell",
+        "azure.ai.contentunderstanding.models.DocumentWord": "ContentUnderstanding.DocumentWord",
+        "azure.ai.contentunderstanding.models.IntegerField": "ContentUnderstanding.IntegerField",
+        "azure.ai.contentunderstanding.models.JsonField": "ContentUnderstanding.JsonField",
+        "azure.ai.contentunderstanding.models.KnowledgeSource": "ContentUnderstanding.KnowledgeSource",
+        "azure.ai.contentunderstanding.models.LabeledDataKnowledgeSource": "ContentUnderstanding.LabeledDataKnowledgeSource",
+        "azure.ai.contentunderstanding.models.NumberField": "ContentUnderstanding.NumberField",
+        "azure.ai.contentunderstanding.models.ObjectField": "ContentUnderstanding.ObjectField",
+        "azure.ai.contentunderstanding.models.RecordMergePatchUpdate": "TypeSpec.RecordMergePatchUpdate",
+        "azure.ai.contentunderstanding.models.StringField": "ContentUnderstanding.StringField",
+        "azure.ai.contentunderstanding.models.SupportedModels": "ContentUnderstanding.SupportedModels",
+        "azure.ai.contentunderstanding.models.TimeField": "ContentUnderstanding.TimeField",
+        "azure.ai.contentunderstanding.models.TranscriptPhrase": "ContentUnderstanding.TranscriptPhrase",
+        "azure.ai.contentunderstanding.models.TranscriptWord": "ContentUnderstanding.TranscriptWord",
+        "azure.ai.contentunderstanding.models.UsageDetails": "ContentUnderstanding.UsageDetails",
+        "azure.ai.contentunderstanding.models.MediaContentKind": "ContentUnderstanding.MediaContentKind",
+        "azure.ai.contentunderstanding.models.ContentFieldType": "ContentUnderstanding.ContentFieldType",
+        "azure.ai.contentunderstanding.models.LengthUnit": "ContentUnderstanding.LengthUnit",
+        "azure.ai.contentunderstanding.models.DocumentBarcodeKind": "ContentUnderstanding.DocumentBarcodeKind",
+        "azure.ai.contentunderstanding.models.DocumentFormulaKind": "ContentUnderstanding.DocumentFormulaKind",
+        "azure.ai.contentunderstanding.models.SemanticRole": "ContentUnderstanding.SemanticRole",
+        "azure.ai.contentunderstanding.models.DocumentTableCellKind": "ContentUnderstanding.DocumentTableCellKind",
+        "azure.ai.contentunderstanding.models.DocumentFigureKind": "ContentUnderstanding.DocumentFigureKind",
+        "azure.ai.contentunderstanding.models.DocumentAnnotationKind": "ContentUnderstanding.DocumentAnnotationKind",
+        "azure.ai.contentunderstanding.models.ProcessingLocation": "ContentUnderstanding.ProcessingLocation",
+        "azure.ai.contentunderstanding.models.ContentAnalyzerStatus": "ContentUnderstanding.ContentAnalyzerStatus",
+        "azure.ai.contentunderstanding.models.TableFormat": "ContentUnderstanding.TableFormat",
+        "azure.ai.contentunderstanding.models.ChartFormat": "ContentUnderstanding.ChartFormat",
+        "azure.ai.contentunderstanding.models.AnnotationFormat": "ContentUnderstanding.AnnotationFormat",
+        "azure.ai.contentunderstanding.models.GenerationMethod": "ContentUnderstanding.GenerationMethod",
+        "azure.ai.contentunderstanding.models.KnowledgeSourceKind": "ContentUnderstanding.KnowledgeSourceKind",
+        "azure.ai.contentunderstanding.models.OperationState": "Azure.Core.Foundations.OperationState",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.begin_analyze": "ClientCustomizations.ContentUnderstandingClient.analyze",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.begin_analyze": "ClientCustomizations.ContentUnderstandingClient.analyze",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.begin_analyze_binary": "ClientCustomizations.ContentUnderstandingClient.analyzeBinary",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.begin_analyze_binary": "ClientCustomizations.ContentUnderstandingClient.analyzeBinary",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.begin_copy_analyzer": "ClientCustomizations.ContentUnderstandingClient.copyAnalyzer",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.begin_copy_analyzer": "ClientCustomizations.ContentUnderstandingClient.copyAnalyzer",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.begin_create_analyzer": "ClientCustomizations.ContentUnderstandingClient.createAnalyzer",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.begin_create_analyzer": "ClientCustomizations.ContentUnderstandingClient.createAnalyzer",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.delete_analyzer": "ClientCustomizations.ContentUnderstandingClient.deleteAnalyzer",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.delete_analyzer": "ClientCustomizations.ContentUnderstandingClient.deleteAnalyzer",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.delete_result": "ClientCustomizations.ContentUnderstandingClient.deleteResult",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.delete_result": "ClientCustomizations.ContentUnderstandingClient.deleteResult",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.get_analyzer": "ClientCustomizations.ContentUnderstandingClient.getAnalyzer",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.get_analyzer": "ClientCustomizations.ContentUnderstandingClient.getAnalyzer",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.get_defaults": "ClientCustomizations.ContentUnderstandingClient.getDefaults",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.get_defaults": "ClientCustomizations.ContentUnderstandingClient.getDefaults",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.get_result_file": "ClientCustomizations.ContentUnderstandingClient.getResultFile",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.get_result_file": "ClientCustomizations.ContentUnderstandingClient.getResultFile",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.grant_copy_authorization": "ClientCustomizations.ContentUnderstandingClient.grantCopyAuthorization",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.grant_copy_authorization": "ClientCustomizations.ContentUnderstandingClient.grantCopyAuthorization",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.list_analyzers": "ClientCustomizations.ContentUnderstandingClient.listAnalyzers",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.list_analyzers": "ClientCustomizations.ContentUnderstandingClient.listAnalyzers",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.update_analyzer": "ClientCustomizations.ContentUnderstandingClient.updateAnalyzer",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.update_analyzer": "ClientCustomizations.ContentUnderstandingClient.updateAnalyzer",
+        "azure.ai.contentunderstanding.ContentUnderstandingClient.update_defaults": "ClientCustomizations.ContentUnderstandingClient.updateDefaults",
+        "azure.ai.contentunderstanding.aio.ContentUnderstandingClient.update_defaults": "ClientCustomizations.ContentUnderstandingClient.updateDefaults"
+    }
+}
@@ -0,0 +1,6 @@
+{
+  "AssetsRepo": "Azure/azure-sdk-assets",
+  "AssetsRepoPrefixPath": "python",
+  "TagPrefix": "python/contentunderstanding/azure-ai-contentunderstanding",
+  "Tag": "python/contentunderstanding/azure-ai-contentunderstanding_2d9b35e90e"
+}
@@ -0,0 +1 @@
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)  # type: ignore
@@ -0,0 +1 @@
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)  # type: ignore
@@ -0,0 +1,32 @@
+# coding=utf-8
+# --------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# Code generated by Microsoft (R) Python Code Generator.
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------
+# pylint: disable=wrong-import-position
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ._patch import *  # pylint: disable=unused-wildcard-import
+
+from ._client import ContentUnderstandingClient  # type: ignore
+from ._version import VERSION
+
+__version__ = VERSION
+
+try:
+    from ._patch import __all__ as _patch_all
+    from ._patch import *
+except ImportError:
+    _patch_all = []
+from ._patch import patch_sdk as _patch_sdk
+
+__all__ = [
+    "ContentUnderstandingClient",
+]
+__all__.extend([p for p in _patch_all if p not in __all__])  # pyright: ignore
+
+_patch_sdk()
@@ -0,0 +1,103 @@
+# coding=utf-8
+# --------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# Code generated by Microsoft (R) Python Code Generator.
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------
+
+from copy import deepcopy
+from typing import Any, TYPE_CHECKING, Union
+from typing_extensions import Self
+
+from azure.core import PipelineClient
+from azure.core.credentials import AzureKeyCredential
+from azure.core.pipeline import policies
+from azure.core.rest import HttpRequest, HttpResponse
+
+from ._configuration import ContentUnderstandingClientConfiguration
+from ._operations import _ContentUnderstandingClientOperationsMixin
+from ._utils.serialization import Deserializer, Serializer
+
+if TYPE_CHECKING:
+    from azure.core.credentials import TokenCredential
+
+
+class ContentUnderstandingClient(_ContentUnderstandingClientOperationsMixin):
+    """ContentUnderstandingClient.
+
+    :param endpoint: Content Understanding service endpoint. Required.
+    :type endpoint: str
+    :param credential: Credential used to authenticate requests to the service. Is either a key
+     credential type or a token credential type. Required.
+    :type credential: ~azure.core.credentials.AzureKeyCredential or
+     ~azure.core.credentials.TokenCredential
+    :keyword api_version: The API version to use for this operation. Default value is "2025-11-01".
+     Note that overriding this default value may result in unsupported behavior.
+    :paramtype api_version: str
+    :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
+     Retry-After header is present.
+    """
+
+    def __init__(self, endpoint: str, credential: Union[AzureKeyCredential, "TokenCredential"], **kwargs: Any) -> None:
+        _endpoint = "{endpoint}/contentunderstanding"
+        self._config = ContentUnderstandingClientConfiguration(endpoint=endpoint, credential=credential, **kwargs)
+
+        _policies = kwargs.pop("policies", None)
+        if _policies is None:
+            _policies = [
+                policies.RequestIdPolicy(**kwargs),
+                self._config.headers_policy,
+                self._config.user_agent_policy,
+                self._config.proxy_policy,
+                policies.ContentDecodePolicy(**kwargs),
+                self._config.redirect_policy,
+                self._config.retry_policy,
+                self._config.authentication_policy,
+                self._config.custom_hook_policy,
+                self._config.logging_policy,
+                policies.DistributedTracingPolicy(**kwargs),
+                policies.SensitiveHeaderCleanupPolicy(**kwargs) if self._config.redirect_policy else None,
+                self._config.http_logging_policy,
+            ]
+        self._client: PipelineClient = PipelineClient(base_url=_endpoint, policies=_policies, **kwargs)
+
+        self._serialize = Serializer()
+        self._deserialize = Deserializer()
+        self._serialize.client_side_validation = False
+
+    def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: Any) -> HttpResponse:
+        """Runs the network request through the client's chained policies.
+
+        >>> from azure.core.rest import HttpRequest
+        >>> request = HttpRequest("GET", "https://www.example.org/")
+        <HttpRequest [GET], url: 'https://www.example.org/'>
+        >>> response = client.send_request(request)
+        <HttpResponse: 200 OK>
+
+        For more information on this code flow, see https://aka.ms/azsdk/dpcodegen/python/send_request
+
+        :param request: The network request you want to make. Required.
+        :type request: ~azure.core.rest.HttpRequest
+        :keyword bool stream: Whether the response payload will be streamed. Defaults to False.
+        :return: The response of your network call. Does not do error handling on your response.
+        :rtype: ~azure.core.rest.HttpResponse
+        """
+
+        request_copy = deepcopy(request)
+        path_format_arguments = {
+            "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str", skip_quote=True),
+        }
+
+        request_copy.url = self._client.format_url(request_copy.url, **path_format_arguments)
+        return self._client.send_request(request_copy, stream=stream, **kwargs)  # type: ignore
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self) -> Self:
+        self._client.__enter__()
+        return self
+
+    def __exit__(self, *exc_details: Any) -> None:
+        self._client.__exit__(*exc_details)
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		__path__ = __import__("pkgutil").extend_path(__path__, __name__) # type: ignore